@cloud-ru/ds-fields 1.0.8-preview-61ab169d.0 → 1.0.8-preview-4074f7f8.0

package/README.md

@@ -216,24 +216,6 @@ export function Affixes() {
 | `variant` | `"after"` \| `"before"` | — | Положение относительно поля |
 | `withDropdownList` | `boolean \| undefined` | — | Показать шеврон раскрытия |
 
-**FieldElementDroplistProps**
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `closeDroplistOnItemClick` | `boolean \| undefined` | — | Закрывать выпадающий список после клика на базовый айтем. <br/> Работает в режимах selection: 'none' \| 'single' |
-| `items` | `BaseItemWithoutNonGroup` \| `CommonGroupItem` \| `Item` \| `ScrollProps` | — | Основные элементы списка |
-| `onOpenChange` | `((open: boolean) => void) \| undefined` | — | Колбек смены состояния раскрытия |
-| `open` | `boolean \| undefined` | — | Контролируемое состояние раскрытия |
-| `pinBottom` | `BaseItemWithoutNonGroup` \| `CommonGroupItem` \| `Item` \| `ScrollProps` | — | Элементы списка, закрепленные снизу |
-| `pinTop` | `BaseItemWithoutNonGroup` \| `CommonGroupItem` \| `Item` \| `ScrollProps` | — | Элементы списка, закрепленные сверху |
-| `placement` | `"bottom"` \| `"bottom-end"` \| `"bottom-start"` \| `"left"` \| `"left-end"` \| `"left-start"` \| `"right"` \| `"right-end"` \| `"right-start"` \| `"top"` \| `"top-end"` \| `"top-start"` | — | Положение поповера относительно своего триггера (children). |
-| `scroll` | `boolean \| undefined` | — | Включить ли скролл для основной части списка |
-| `scrollToSelectedItem` | `boolean \| undefined` | — | Флаг, отвечающий за прокручивание до выбранного элемента |
-| `search` | `SearchState` | — | Настройки поисковой строки |
-| `selection` | `SelectionMultipleState` \| `SelectionSingleState` | — | Настройки выбора элементов. `mode: 'single'` — один выбранный элемент (`value: ItemId`), <br/> `mode: 'multiple'` — множественный выбор (`value: ItemId[]`). Без `selection` выбора нет — <br/> клик вызывает только `onClick` элемента. |
-| `virtualized` | `boolean \| undefined` | — | Включить виртуализацию элементов списка. Рекомендуется при количестве элементов от 1000. |
-| `widthStrategy` | `"auto"` \| `"eq"` \| `"gte"` | — | Стратегия управления шириной контейнера поповера <br/> - `auto` - соответствует ширине контента, <br/> - `gte` - Great Than or Equal, равен ширине таргета или больше ее, если контент в поповере шире, <br/> - `eq` - Equal, строго равен ширине таргета. |
-
 **FieldElementSlot**
 
 | Prop | Type | Default | Description |
@@ -249,6 +231,15 @@ export function Affixes() {
 | `tabIndex` | `number \| undefined` | — | HTML tabIndex (`-1` — исключить кнопку из tab-order, фокус по Tab уходит в поле) |
 | `withDropdownList` | `boolean \| undefined` | — | Показать шеврон раскрытия |
 
+**FieldLayoutPresets**
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `desktop` | `any` | — |  |
+| `desktopSmall` | `any` | — |  |
+| `mobile` | `any` | — |  |
+| `tablet` | `any` | — |  |
+
 - `Variant` = `"after"` \| `"before"`
 
 ## FieldDate
@@ -456,7 +447,7 @@ export function Select() {
 | `data-test-id` | `string` | — | Тестовый id корня |
 | `dataError` | `DroplistProps` | — | Флаг «ошибка загрузки данных» — при `true` дроплист рендерит `errorDataState` <br/> вместо списка (для асинхронной подгрузки с провалившимся запросом). |
 | `dataFiltered` | `DroplistProps` | — | Флаг «список отфильтрован» — при `true` и пустом результате дроплист рендерит <br/> `noResultsState`. По умолчанию выводится из строки поиска (`searchable` + ввод). |
-| `defaultValue` | `ItemId` | — | Неуправляемое значение по умолчанию <br/> Неуправляемые значения по умолчанию |
+| `defaultValue` | `ItemId` | — | Неуправляемое значение по умолчанию. Пустая строка трактуется как «значение не выбрано». <br/> Неуправляемые значения по умолчанию |
 | `disabled` | `boolean` | — | Поле выключено <br/> Деактивировано |
 | `enableFuzzySearch` | `boolean` | `true` | Включить нечёткий поиск: символы запроса должны встречаться в лейбле в том же порядке <br/> (например, `lge` найдёт `Large`). Если `false` — простой substring-match. |
 | `error` | `string` | — | Ошибка (приоритетнее `hint`; форсит `validationState=error`) |
@@ -508,10 +499,21 @@ export function Select() {
 | `size` | `"l"` \| `"m"` \| `"s"` | — | Размер |
 | `untouchableScrollbars` | `boolean` | — | Отключает возможность взаимодействовать со скролбарами мышью. |
 | `validationState` | `"default"` \| `"error"` \| `"success"` \| `"warning"` | — | Состояние валидации |
-| `value` | `ItemId` | — | Управляемое значение <br/> Управляемые значения |
+| `value` | `ItemId` | — | Управляемое значение. Пустая строка трактуется как «значение не выбрано». <br/> Управляемые значения |
 | `virtualized` | `boolean` | — | Включить виртуализацию элементов списка. Рекомендуется при количестве элементов от 1000. |
 | `widthStrategy` | `"auto"` \| `"eq"` \| `"gte"` | `'eq' — равна ширине триггера` | Стратегия ширины дроплиста. |
 
+#### Related types
+
+**FieldLayoutPresets**
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `desktop` | `any` | — |  |
+| `desktopSmall` | `any` | — |  |
+| `mobile` | `any` | — |  |
+| `tablet` | `any` | — |  |
+
 ## FieldSlider
 
 ```tsx
@@ -802,7 +804,8 @@ export function TextArea() {
 | `required` | `boolean` | — | Показать знак обязательности `*` |
 | `resizable` | `boolean` | `false` | Можно ли менять высоту мышкой за нижний угол. Игнорируется при `disabled` или `readonly`. |
 | `showClearButton` | `boolean` | `true` | Кнопка очистки (видна при value && !readonly) |
-| `showCopyButton` | `boolean` | `true` | Кнопка копирования (видна при value && !disabled, независимо от readonly) |
+| `showCopyButton` | `boolean` | `true` | Кнопка копирования (видна при непустом value в режиме readonly, как у остальных полей) |
+| `showCopyButtonInEditMode` | `boolean` | `false` | Показывать кнопку копирования и в обычном (не readonly) режиме — рядом с кнопкой очистки. <br/> Опция только для textarea: в многострочном поле копирование значения осмысленно и при вводе. |
 | `showHintIcon` | `boolean` | — | Отображение статус-иконки у подсказки (по умолчанию `true`) |
 | `size` | `"l"` \| `"m"` \| `"s"` | `m` | Размер |
 | `spellCheck` | `boolean` | — | Проверка орфографии |

package/dist/cjs/components/FieldSelect/FieldSelect.js

@@ -52,12 +52,33 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
     // но «расхлябанный» вызов (например, Storybook-spread, где single-default остаётся
     // строкой при переключении selection) не должен ронять компонент на `.map` строки.
     multiple && Array.isArray(props.defaultValue) ? props.defaultValue : []);
-    const singleValue = (0, react_1.useMemo)(() => (!multiple ? (props.value ?? singleLocal) : undefined), [multiple, props.value, singleLocal]);
+    // Controlled-режим «залипает»: как только потребитель прислал `value`, локальный стейт больше
+    // не читается. Иначе очистка (потребитель ставит `undefined`) откатывалась бы на устаревший
+    // локальный выбор и воскрешала прошлое значение.
+    const singleControlled = (0, react_1.useRef)(false);
+    const multipleControlled = (0, react_1.useRef)(false);
+    if (!multiple && props.value !== undefined) {
+        singleControlled.current = true;
+    }
+    if (multiple && Array.isArray(props.value)) {
+        multipleControlled.current = true;
+    }
+    const singleValue = (0, react_1.useMemo)(() => {
+        if (multiple) {
+            return undefined;
+        }
+        const raw = singleControlled.current ? props.value : singleLocal;
+        // `''` = «значение не выбрано»: формы отдают пустое значение строкой.
+        return raw === '' ? undefined : raw;
+    }, [multiple, props.value, singleLocal]);
     const multipleValue = (0, react_1.useMemo)(() => {
         if (!multiple) {
             return [];
         }
-        return Array.isArray(props.value) ? props.value : multipleLocal;
+        if (multipleControlled.current) {
+            return Array.isArray(props.value) ? props.value : [];
+        }
+        return multipleLocal;
     }, [multiple, props.value, multipleLocal]);
     const effectiveValidationState = (0, react_1.useMemo)(() => (error ? field_decorator_1.VALIDATION_STATE.Error : validationState), [error, validationState]);
     const allItems = (0, react_1.useMemo)(() => [...(pinTop ?? []), ...items, ...(pinBottom ?? [])], [items, pinTop, pinBottom]);

package/dist/cjs/components/FieldSelect/types.d.ts

@@ -146,9 +146,9 @@ type CommonSelectProps = FieldSelectDecoratorProps & DroplistPassthrough & {
 export type FieldSelectSingleProps = CommonSelectProps & {
     /** Режим выбора. По умолчанию `'single'`. */
     selection?: typeof SELECTION_MODE.Single;
-    /** Управляемое значение */
+    /** Управляемое значение. Пустая строка трактуется как «значение не выбрано». */
     value?: ItemId;
-    /** Неуправляемое значение по умолчанию */
+    /** Неуправляемое значение по умолчанию. Пустая строка трактуется как «значение не выбрано». */
     defaultValue?: ItemId;
     /** Колбек смены значения */
     onChange?(value: ItemId | undefined): void;

package/dist/esm/components/FieldSelect/FieldSelect.js

@@ -46,12 +46,33 @@ export const FieldSelect = forwardRef(function FieldSelect(props, ref) {
     // но «расхлябанный» вызов (например, Storybook-spread, где single-default остаётся
     // строкой при переключении selection) не должен ронять компонент на `.map` строки.
     multiple && Array.isArray(props.defaultValue) ? props.defaultValue : []);
-    const singleValue = useMemo(() => (!multiple ? (props.value ?? singleLocal) : undefined), [multiple, props.value, singleLocal]);
+    // Controlled-режим «залипает»: как только потребитель прислал `value`, локальный стейт больше
+    // не читается. Иначе очистка (потребитель ставит `undefined`) откатывалась бы на устаревший
+    // локальный выбор и воскрешала прошлое значение.
+    const singleControlled = useRef(false);
+    const multipleControlled = useRef(false);
+    if (!multiple && props.value !== undefined) {
+        singleControlled.current = true;
+    }
+    if (multiple && Array.isArray(props.value)) {
+        multipleControlled.current = true;
+    }
+    const singleValue = useMemo(() => {
+        if (multiple) {
+            return undefined;
+        }
+        const raw = singleControlled.current ? props.value : singleLocal;
+        // `''` = «значение не выбрано»: формы отдают пустое значение строкой.
+        return raw === '' ? undefined : raw;
+    }, [multiple, props.value, singleLocal]);
     const multipleValue = useMemo(() => {
         if (!multiple) {
             return [];
         }
-        return Array.isArray(props.value) ? props.value : multipleLocal;
+        if (multipleControlled.current) {
+            return Array.isArray(props.value) ? props.value : [];
+        }
+        return multipleLocal;
     }, [multiple, props.value, multipleLocal]);
     const effectiveValidationState = useMemo(() => (error ? VALIDATION_STATE.Error : validationState), [error, validationState]);
     const allItems = useMemo(() => [...(pinTop ?? []), ...items, ...(pinBottom ?? [])], [items, pinTop, pinBottom]);

package/dist/esm/components/FieldSelect/types.d.ts

@@ -146,9 +146,9 @@ type CommonSelectProps = FieldSelectDecoratorProps & DroplistPassthrough & {
 export type FieldSelectSingleProps = CommonSelectProps & {
     /** Режим выбора. По умолчанию `'single'`. */
     selection?: typeof SELECTION_MODE.Single;
-    /** Управляемое значение */
+    /** Управляемое значение. Пустая строка трактуется как «значение не выбрано». */
     value?: ItemId;
-    /** Неуправляемое значение по умолчанию */
+    /** Неуправляемое значение по умолчанию. Пустая строка трактуется как «значение не выбрано». */
     defaultValue?: ItemId;
     /** Колбек смены значения */
     onChange?(value: ItemId | undefined): void;