@cloud-ru/ds-fields 1.0.8-preview-04507fc5.0 → 2.0.0

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 2.0.0 (2026-08-27)
+
+### Bug Fixes
+
+- **FF-8948:** keep FieldSelect cleared when value is controlled ([6637026](https://github.com/cloud-ru-tech/snack-v2/commit/66370266294b3d7043c1458a7ba2f4eb629c11dc))
+- **FF-8948:** show textarea copy button only in readonly by default ([a81d9bd](https://github.com/cloud-ru-tech/snack-v2/commit/a81d9bda8a13cdaff5f68a6e9f51b41c58dd1fd9))
+- **FF-8948:** treat empty string as no value in FieldSelect single ([338dbef](https://github.com/cloud-ru-tech/snack-v2/commit/338dbefcbbd3832956ca23f3c5838c46d4fdb7d5))
+
+### BREAKING CHANGES
+
+- **FF-8680:** rename AiFieldBanner children to bottomContent and type axis to variant ([79a6b2c](https://github.com/cloud-ru-tech/snack-v2/commit/79a6b2c55cca8c4dc3dad23031f7fd4cfe0a311a))
+
 ## 1.0.7 (2026-08-25)
 
 **Note:** Version bump only for package @ds/fields

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' — равна ширине триггера` | Стратегия ширины дроплиста. |
 
@@ -804,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]);
@@ -350,7 +371,7 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
         const plug = inputPlugRef.current?.clientWidth ?? SEARCH_INPUT_PLUG_MIN_WIDTH;
         setChipInputMinWidth(Math.min(content, Math.max(plug, SEARCH_INPUT_PLUG_MIN_WIDTH)));
     }, [hasChips, inputValue, selectedPairs.length]);
-    const searchInputField = ((0, jsx_runtime_1.jsx)(input_private_1.InputPrivate, { ref: (0, merge_refs_1.default)(ref, inputRef, inputElementRef), className: (0, classnames_1.default)(styles_module_scss_1.default.fieldInput, !searchable && styles_module_scss_2.default.readonlyCursor), value: inputValue, onChange: searchable ? handleInputChange : undefined, placeholder: selectedLabel ? '' : placeholder, disabled: disabled, readonly: !searchable || readOnly, id: id, name: name, autoFocus: resolvedAutoFocus, tabIndex: inputTabIndex, onFocus: handleInputFocus, onBlur: handleInputBlur, onKeyDown: handleTriggerKeyDown, "data-test-id": constants_1.TEST_IDS.fieldSelectInput }));
+    const searchInputField = ((0, jsx_runtime_1.jsx)(input_private_1.InputPrivate, { ref: (0, merge_refs_1.default)(ref, inputRef, inputElementRef), className: (0, classnames_1.default)(styles_module_scss_1.default.fieldInput, !searchable && styles_module_scss_2.default.readonlyCursor), value: inputValue, onChange: searchable ? handleInputChange : undefined, placeholder: selectedLabel || hasChips ? '' : placeholder, disabled: disabled, readonly: !searchable || readOnly, id: id, name: name, autoFocus: resolvedAutoFocus, tabIndex: inputTabIndex, onFocus: handleInputFocus, onBlur: handleInputBlur, onKeyDown: handleTriggerKeyDown, "data-test-id": constants_1.TEST_IDS.fieldSelectInput }));
     // В режиме чипов input заворачивается в `.inputWrapper` с динамической minWidth (флоу за чипами);
     // без чипов — обычный `inputArea` на всю строку.
     const searchInput = hasChips ? ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_2.default.inputWrapper, style: { minWidth: chipInputMinWidth }, children: searchInputField })) : ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.inputArea, children: searchInputField }));

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/cjs/components/FieldTextArea/FieldTextArea.d.ts

@@ -77,10 +77,16 @@ type FieldTextAreaOwnProps = {
      */
     showClearButton?: boolean;
     /**
-     * Кнопка копирования (видна при value && !disabled, независимо от readonly)
+     * Кнопка копирования (видна при непустом value в режиме readonly, как у остальных полей)
      * @default true
      */
     showCopyButton?: boolean;
+    /**
+     * Показывать кнопку копирования и в обычном (не readonly) режиме — рядом с кнопкой очистки.
+     * Опция только для textarea: в многострочном поле копирование значения осмысленно и при вводе.
+     * @default false
+     */
+    showCopyButtonInEditMode?: boolean;
     /** Колбек после копирования */
     onCopyButtonClick?(): void;
     /** Колбек фокуса */

package/dist/cjs/components/FieldTextArea/FieldTextArea.js

@@ -18,7 +18,7 @@ const hooks_1 = require("../../hooks");
 const shared_1 = require("../shared");
 const styles_module_scss_1 = __importDefault(require('../shared/styles.module.css'));
 const styles_module_scss_2 = __importDefault(require('./styles.module.css'));
-exports.FieldTextArea = (0, react_1.forwardRef)(function FieldTextArea({ label = '', labelTooltip, caption, hint, error, validationState = field_decorator_1.VALIDATION_STATE.Default, showHintIcon, length, required, size = field_decorator_1.SIZE.M, className, fieldClassName, background = true, value: valueProp, defaultValue = '', onChange, placeholder, id, name, maxLength, disabled, readonly: readOnly, autoFocus, layoutPresets, inputMode, spellCheck, minRows = 3, maxRows = 1000, resizable = false, allowMoreThanMaxLength = true, header, footer, showClearButton: showClearButtonProp = true, showCopyButton: showCopyButtonProp = true, onCopyButtonClick, onFocus: onFocusProp, onBlur: onBlurProp, onKeyDown: onKeyDownProp, 'data-test-id': dataTestId, ...rest }, ref) {
+exports.FieldTextArea = (0, react_1.forwardRef)(function FieldTextArea({ label = '', labelTooltip, caption, hint, error, validationState = field_decorator_1.VALIDATION_STATE.Default, showHintIcon, length, required, size = field_decorator_1.SIZE.M, className, fieldClassName, background = true, value: valueProp, defaultValue = '', onChange, placeholder, id, name, maxLength, disabled, readonly: readOnly, autoFocus, layoutPresets, inputMode, spellCheck, minRows = 3, maxRows = 1000, resizable = false, allowMoreThanMaxLength = true, header, footer, showClearButton: showClearButtonProp = true, showCopyButton: showCopyButtonProp = true, showCopyButtonInEditMode = false, onCopyButtonClick, onFocus: onFocusProp, onBlur: onBlurProp, onKeyDown: onKeyDownProp, 'data-test-id': dataTestId, ...rest }, ref) {
     const localRef = (0, react_1.useRef)(null);
     const clearButtonRef = (0, react_1.useRef)(null);
     const copyButtonRef = (0, react_1.useRef)(null);
@@ -37,9 +37,9 @@ exports.FieldTextArea = (0, react_1.forwardRef)(function FieldTextArea({ label =
     const stringValue = String(value ?? '');
     const isResizable = resizable && !disabled && !readOnly;
     const showClearUi = Boolean(showClearButtonProp && stringValue && !readOnly && !disabled);
-    // Copy не завязан на readonly (паритет с snack-uikit master): виден при любом непустом значении.
-    // В editable-режиме показываются обе кнопки (clear + copy), в readonly — только copy.
-    const showCopyUi = Boolean(showCopyButtonProp && stringValue && !disabled);
+    // По умолчанию copy — только в readonly, как у остальных полей. В editable-режиме кнопка
+    // появляется лишь по явному `showCopyButtonInEditMode`; тогда видны обе (clear + copy).
+    const showCopyUi = Boolean(showCopyButtonProp && stringValue && !disabled && (readOnly || showCopyButtonInEditMode));
     const onClear = (0, react_1.useCallback)(() => {
         setValue('');
         onChange?.('');

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]);
@@ -344,7 +365,7 @@ export const FieldSelect = forwardRef(function FieldSelect(props, ref) {
         const plug = inputPlugRef.current?.clientWidth ?? SEARCH_INPUT_PLUG_MIN_WIDTH;
         setChipInputMinWidth(Math.min(content, Math.max(plug, SEARCH_INPUT_PLUG_MIN_WIDTH)));
     }, [hasChips, inputValue, selectedPairs.length]);
-    const searchInputField = (_jsx(InputPrivate, { ref: mergeRefs(ref, inputRef, inputElementRef), className: cn(fieldStyles.fieldInput, !searchable && styles.readonlyCursor), value: inputValue, onChange: searchable ? handleInputChange : undefined, placeholder: selectedLabel ? '' : placeholder, disabled: disabled, readonly: !searchable || readOnly, id: id, name: name, autoFocus: resolvedAutoFocus, tabIndex: inputTabIndex, onFocus: handleInputFocus, onBlur: handleInputBlur, onKeyDown: handleTriggerKeyDown, "data-test-id": TEST_IDS.fieldSelectInput }));
+    const searchInputField = (_jsx(InputPrivate, { ref: mergeRefs(ref, inputRef, inputElementRef), className: cn(fieldStyles.fieldInput, !searchable && styles.readonlyCursor), value: inputValue, onChange: searchable ? handleInputChange : undefined, placeholder: selectedLabel || hasChips ? '' : placeholder, disabled: disabled, readonly: !searchable || readOnly, id: id, name: name, autoFocus: resolvedAutoFocus, tabIndex: inputTabIndex, onFocus: handleInputFocus, onBlur: handleInputBlur, onKeyDown: handleTriggerKeyDown, "data-test-id": TEST_IDS.fieldSelectInput }));
     // В режиме чипов input заворачивается в `.inputWrapper` с динамической minWidth (флоу за чипами);
     // без чипов — обычный `inputArea` на всю строку.
     const searchInput = hasChips ? (_jsx("div", { className: styles.inputWrapper, style: { minWidth: chipInputMinWidth }, children: searchInputField })) : (_jsx("div", { className: fieldStyles.inputArea, children: searchInputField }));

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;

package/dist/esm/components/FieldTextArea/FieldTextArea.d.ts

@@ -77,10 +77,16 @@ type FieldTextAreaOwnProps = {
      */
     showClearButton?: boolean;
     /**
-     * Кнопка копирования (видна при value && !disabled, независимо от readonly)
+     * Кнопка копирования (видна при непустом value в режиме readonly, как у остальных полей)
      * @default true
      */
     showCopyButton?: boolean;
+    /**
+     * Показывать кнопку копирования и в обычном (не readonly) режиме — рядом с кнопкой очистки.
+     * Опция только для textarea: в многострочном поле копирование значения осмысленно и при вводе.
+     * @default false
+     */
+    showCopyButtonInEditMode?: boolean;
     /** Колбек после копирования */
     onCopyButtonClick?(): void;
     /** Колбек фокуса */

package/dist/esm/components/FieldTextArea/FieldTextArea.js

@@ -12,7 +12,7 @@ import { useAdaptiveAutoFocus } from '../../hooks/index.js';
 import { copyTextToClipboard, FieldShell, toInputSize, useCopyButton } from '../shared/index.js';
 import fieldStyles from '../shared/styles.module.css';
 import styles from './styles.module.css';
-export const FieldTextArea = forwardRef(function FieldTextArea({ label = '', labelTooltip, caption, hint, error, validationState = VALIDATION_STATE.Default, showHintIcon, length, required, size = SIZE.M, className, fieldClassName, background = true, value: valueProp, defaultValue = '', onChange, placeholder, id, name, maxLength, disabled, readonly: readOnly, autoFocus, layoutPresets, inputMode, spellCheck, minRows = 3, maxRows = 1000, resizable = false, allowMoreThanMaxLength = true, header, footer, showClearButton: showClearButtonProp = true, showCopyButton: showCopyButtonProp = true, onCopyButtonClick, onFocus: onFocusProp, onBlur: onBlurProp, onKeyDown: onKeyDownProp, 'data-test-id': dataTestId, ...rest }, ref) {
+export const FieldTextArea = forwardRef(function FieldTextArea({ label = '', labelTooltip, caption, hint, error, validationState = VALIDATION_STATE.Default, showHintIcon, length, required, size = SIZE.M, className, fieldClassName, background = true, value: valueProp, defaultValue = '', onChange, placeholder, id, name, maxLength, disabled, readonly: readOnly, autoFocus, layoutPresets, inputMode, spellCheck, minRows = 3, maxRows = 1000, resizable = false, allowMoreThanMaxLength = true, header, footer, showClearButton: showClearButtonProp = true, showCopyButton: showCopyButtonProp = true, showCopyButtonInEditMode = false, onCopyButtonClick, onFocus: onFocusProp, onBlur: onBlurProp, onKeyDown: onKeyDownProp, 'data-test-id': dataTestId, ...rest }, ref) {
     const localRef = useRef(null);
     const clearButtonRef = useRef(null);
     const copyButtonRef = useRef(null);
@@ -31,9 +31,9 @@ export const FieldTextArea = forwardRef(function FieldTextArea({ label = '', lab
     const stringValue = String(value ?? '');
     const isResizable = resizable && !disabled && !readOnly;
     const showClearUi = Boolean(showClearButtonProp && stringValue && !readOnly && !disabled);
-    // Copy не завязан на readonly (паритет с snack-uikit master): виден при любом непустом значении.
-    // В editable-режиме показываются обе кнопки (clear + copy), в readonly — только copy.
-    const showCopyUi = Boolean(showCopyButtonProp && stringValue && !disabled);
+    // По умолчанию copy — только в readonly, как у остальных полей. В editable-режиме кнопка
+    // появляется лишь по явному `showCopyButtonInEditMode`; тогда видны обе (clear + copy).
+    const showCopyUi = Boolean(showCopyButtonProp && stringValue && !disabled && (readOnly || showCopyButtonInEditMode));
     const onClear = useCallback(() => {
         setValue('');
         onChange?.('');