feat: warn about unsupported dots in spec property keys

[i-doshechnikow]

What and why

Spec property keys containing dots (a.b) are not supported: the library follows the final-form field name convention, where a dot is a path separator. Such specs are currently accepted silently and their values are lost during rendering (titles render, data does not) — hard to diagnose when the keys come from an external data source (e.g. Helm values).

Change

• DynamicView emits a dev-only console.warn listing the offending property keys, collected recursively (nested objects and array items included).
• New "Dotted property keys" docs section documents dots in keys as not supported and tells consumers to transform specs and values beforehand.
• Rendering behavior is unchanged.

Tests

• The warning lists all dotted keys, including nested object properties and array item specs.
• No warning for specs without dots.

Note: the branch history contains an earlier rendering fix and its revert — the approach was changed after discussion with maintainers in favor of an explicit warning; commits squash on merge.

---

🇷🇺 Описание на русском

Что и зачем

Ключи spec.properties с точками (a.b) не поддерживаются: библиотека следует конвенции именования полей final-form, где точка — разделитель пути. Сейчас такие спеки принимаются молча, а значения теряются при рендере (заголовки рисуются, данные — нет) — это трудно диагностировать, когда ключи приходят из внешнего источника (например, Helm values).

Изменение

• DynamicView выводит dev-only console.warn со списком проблемных ключей, собранных рекурсивно (включая вложенные объекты и элементы массивов).
• Новый раздел документации «Dotted property keys» фиксирует, что точки в ключах не поддерживаются, и советует потребителям преобразовывать спеки и значения заранее.
• Поведение рендера не меняется.

Тесты

• Ворнинг перечисляет все точечные ключи, включая свойства вложенных объектов и спеки элементов массивов.
• Для спек без точек ворнинга нет.

Примечание: в истории ветки есть более ранний фикс рендера и его revert — после обсуждения с мейнтейнерами подход заменён на явный ворнинг; при мерже коммиты схлопнутся squash'ем.

🤖 Generated with Claude Code

[gravity-ui-bot]

Preview is ready.

[gravity-ui-bot]

Playwright Test Component is ready.

[bocembocem]

This rule applies to both modes, so this log also needs to be added for DynamicField

[i-doshechnikow]

fixed