@cloud-ru/ds-fields 1.0.8-preview-13225cc1.0 → 1.0.8-preview-4074f7f8.0

package/README.md

@@ -447,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`) |
@@ -499,7 +499,7 @@ 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' — равна ширине триггера` | Стратегия ширины дроплиста. |
 

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;