@cloud-ru/ds-fields 2.2.3-preview-8025692f.0 → 2.2.3-preview-a0540d7f.0

package/README.md

@@ -435,7 +435,9 @@ export function Select() {
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `addOptionByEnter` | `boolean` | `false` | Зафиксировать введённый текст как новый выбор по `Enter` (создание опции «на лету»). |
+| `addCustomOptionTriggers` | `("enter" \| "blur")[] \| ("enter" \| "blur" \| "space" \| "comma")[]` | — | События, по которым произвольный ввод фиксируется как выбранная опция. <br/> Учитывается только при `allowCustomOption={true}`. <br/> Если не задан — используются все триггеры режима (`single`: enter, blur; `multiple`: enter, blur, space, comma). <br/> Триггеры, недоступные в текущем `selection`, игнорируются. |
+| `addOptionByEnter` | `boolean` | `false` | Зафиксировать введённый текст как новый выбор по `Enter` (создание опции «на лету»). <br/> @deprecated Используйте `allowCustomOption`. `true` эквивалентен `allowCustomOption` с триггером `enter`. |
+| `allowCustomOption` | `boolean` | `false` | Разрешить фиксировать произвольный ввод из строки поиска как выбранную опцию <br/> (значение, которого нет в `items`). |
 | `autoFocus` | `boolean` | — | Автофокус input при монтировании. На mobile выключается адаптивно (см. `layoutPresets`) |
 | `autocomplete` | `boolean` | `false` | Не фильтровать список на клиенте — фильтрацию обеспечивает потребитель (серверный поиск). <br/> Введённый текст уходит в `search.onChange`, список берётся из `items` как есть. |
 | `background` | `boolean` | `true` | Фон поля (acrylic) |
@@ -514,7 +516,7 @@ export function Select() {
 | `mobile` | `any` | — |  |
 | `tablet` | `any` | — |  |
 
-- `FieldSelectItem` = `(Omit<GroupItem, "items"> & { appearance?: TagAppearance; items: WithTagAppearance<ItemProps>[]; }) | (Omit<GroupSelectItem, "items"> & { appearance?: TagAppearance; items: WithTagAppearance<ItemProps>[]; }) | (Omit<NextListItem, "items"> & { appearance?: TagAppearance; items: WithTagAppearance<ItemProps>[]; }) | ({ 'data-test-id'?: string; } & AriaAttributes & { beforeContent?: ReactNode; afterContent?: ReactNode; content?: ItemContentProps | ReactNode; onClick?(e: MouseEvent<HTMLElement>): void; onMouseDown?(e: MouseEvent<HTMLElement>): void; onKeyDown?(e: KeyboardEvent<HTMLElement>): void; onFocus?(e: FocusEvent<HTMLElement>): void; onBlur?(e: FocusEvent<HTMLElement>): void; id?: ItemId; disabled?: boolean; hidden?: boolean; itemRef?: RefObject<HTMLElement>; className?: string; inactive?: boolean; switch?: boolean; showSwitchIcon?: boolean; itemWrapRender?(item: ReactNode): ReactNode; checked?: boolean; } & { type?: undefined; } & { appearance?: TagAppearance; }) | (Omit<AccordionItem, "items"> & { appearance?: TagAppearance; items: WithTagAppearance<ItemProps>[]; })`
+- `FieldSelectItem` = `({ 'data-test-id'?: string; } & AriaAttributes & { beforeContent?: ReactNode; afterContent?: ReactNode; content?: ItemContentProps | ReactNode; onClick?(e: MouseEvent<HTMLElement>): void; onMouseDown?(e: MouseEvent<HTMLElement>): void; onKeyDown?(e: KeyboardEvent<HTMLElement>): void; onFocus?(e: FocusEvent<HTMLElement>): void; onBlur?(e: FocusEvent<HTMLElement>): void; id?: ItemId; disabled?: boolean; hidden?: boolean; itemRef?: RefObject<HTMLElement>; className?: string; inactive?: boolean; switch?: boolean; showSwitchIcon?: boolean; itemWrapRender?(item: ReactNode): ReactNode; checked?: boolean; } & { appearance?: TagAppearance; }) | (Omit<GroupItem, "items"> & { appearance?: TagAppearance; items: WithTagAppearance<ItemProps>[]; }) | (Omit<GroupSelectItem, "items"> & { appearance?: TagAppearance; items: WithTagAppearance<ItemProps>[]; }) | (Omit<NextListItem, "items"> & { appearance?: TagAppearance; items: WithTagAppearance<ItemProps>[]; }) | (Omit<AccordionItem, "items"> & { appearance?: TagAppearance; items: WithTagAppearance<ItemProps>[]; })`
 
 ## FieldSlider
 

package/dist/cjs/components/FieldDate/FieldDate.js

@@ -327,9 +327,9 @@ exports.FieldDate = (0, react_1.forwardRef)(function FieldDate(props, ref) {
                                     (0, jsx_runtime_1.jsxs)("span", { className: styles_module_scss_2.default.rangeInputs, style: { '--field-date-mask-ch': placeholderMask.length }, children: [(0, jsx_runtime_1.jsx)(input_private_1.InputPrivate, { ...inputCommon, ref: (0, merge_refs_1.default)(ref, fromInputRef), className: (0, classnames_1.default)(styles_module_scss_1.default.fieldInput, styles_module_scss_2.default.rangeInputFrom), value: rangeInputValue[0], placeholder: placeholderMask, onChange: handleRangeInput(0), id: id, name: name, autoFocus: resolvedAutoFocus, "aria-label": labelFrom, "data-test-id": constants_1.TEST_IDS.fieldDateInputFrom }), (0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_2.default.rangeSeparator, "aria-hidden": true, children: "\u2013" }), (0, jsx_runtime_1.jsx)(input_private_1.InputPrivate, { ...inputCommon, ref: toInputRef, className: styles_module_scss_1.default.fieldInput, value: rangeInputValue[1], placeholder: placeholderMask, onChange: handleRangeInput(1), 
                                                 // «to» — последний инпут перед кнопками: на нём живёт roving-композит
                                                 // (ArrowRight в конце → clear/copy), keydown-цепочка с nav-handler'ом.
-                                                onKeyDown: handleToInputKeyDown, tabIndex: inputTabIndex, "aria-label": labelTo, "data-test-id": constants_1.TEST_IDS.fieldDateInputTo })] })) : ((0, jsx_runtime_1.jsx)(input_private_1.InputPrivate, { ref: (0, merge_refs_1.default)(ref, fromInputRef, singleSeg.nativeInputRef), className: styles_module_scss_1.default.fieldInput, value: singleInputValue, placeholder: placeholderMask, 
-                                        // Single/date-time ведёт сегментный движок (useSegmentedMask), нативный onChange
-                                        // игнорируется. Range — обычный ввод-по-маске (formatMask в handleRangeInput).
+                                                onKeyDown: handleToInputKeyDown, tabIndex: inputTabIndex, "aria-label": labelTo, "data-test-id": constants_1.TEST_IDS.fieldDateInputTo })] })) : ((0, jsx_runtime_1.jsx)(input_private_1.InputPrivate, { ref: (0, merge_refs_1.default)(ref, fromInputRef), className: styles_module_scss_1.default.fieldInput, value: singleInputValue, placeholder: placeholderMask, 
+                                        // Single/date-time ведёт сегментный движок (keydown, useSegmentedMask), нативный
+                                        // onChange игнорируется. Range — обычный ввод-по-маске (formatMask в handleRangeInput).
                                         onChange: () => { }, onKeyDown: handleSingleKeyDown, onClick: singleSeg.handleClick, onPaste: singleSeg.handlePaste, onFocus: handleSingleFocus, onBlur: handleSingleBlur, disabled: disabled, readonly: readOnly, inputMode: 'numeric', tabIndex: inputTabIndex, id: id, name: name, autoFocus: resolvedAutoFocus, "aria-haspopup": 'dialog', "aria-expanded": open, "data-test-id": constants_1.TEST_IDS.fieldDateInput })) }), postfixButtons && (
                                 // eslint-disable-next-line jsx-a11y/no-static-element-interactions
                                 (0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_1.default.postfixButtonsSlot, onMouseDown: shared_1.preventSlotMouseDown, onClick: shared_1.stopSlotClickPropagation, children: postfixButtons }))] }), (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.iconSlot, "data-test-id": constants_1.TEST_IDS.fieldDateCalendar, "aria-hidden": true, children: (0, jsx_runtime_1.jsx)(system_1.CalendarSVG, {}) })] }) })] }));

package/dist/cjs/components/FieldDate/mask.d.ts

@@ -10,9 +10,8 @@ export declare function getMaskString(mode: MaskMode, showSeconds?: boolean): st
  *    «десятку» (`day` → > 3, `month` → > 1, `hour` → > 2, `minute`/`second` → > 5), цифра трактуется
  *    как «единицы» и в начало сегмента добавляется ноль. Пример: `5` для day → `05.`,
  *    фокус автоматически уезжает на следующий сегмент.
- * 2. **Переполнение полной двойки**: если набрано две цифры и значение превышает `max` сегмента —
- *    сегмент начинается заново с последней цифры (как посегментный ввод в `useSegmentedMask`).
- *    Пример: `39` для day → `09`, `13` для month → `03`.
+ * 2. **Clamp полной двойки**: если набрано две цифры и значение превышает `max` сегмента —
+ *    значение прижимается к верхней границе. Пример: `55` для day → `31`, `99` для month → `12`.
  */
 export declare function formatMask(input: string, mode: MaskMode, showSeconds?: boolean): string;
 /** Парсит `DD.MM.YYYY` или `DD.MM.YYYY, HH:mm[:ss]` в `Date`. Возвращает `undefined` при невалидной/неполной строке. */

package/dist/cjs/components/FieldDate/mask.js

@@ -48,9 +48,8 @@ function buildSegments(mode, showSeconds) {
  *    «десятку» (`day` → > 3, `month` → > 1, `hour` → > 2, `minute`/`second` → > 5), цифра трактуется
  *    как «единицы» и в начало сегмента добавляется ноль. Пример: `5` для day → `05.`,
  *    фокус автоматически уезжает на следующий сегмент.
- * 2. **Переполнение полной двойки**: если набрано две цифры и значение превышает `max` сегмента —
- *    сегмент начинается заново с последней цифры (как посегментный ввод в `useSegmentedMask`).
- *    Пример: `39` для day → `09`, `13` для month → `03`.
+ * 2. **Clamp полной двойки**: если набрано две цифры и значение превышает `max` сегмента —
+ *    значение прижимается к верхней границе. Пример: `55` для day → `31`, `99` для month → `12`.
  */
 function formatMask(input, mode, showSeconds = true) {
     const maxLen = totalLen(mode, showSeconds);
@@ -76,7 +75,7 @@ function formatMask(input, mode, showSeconds = true) {
         stream = stream.slice(seg.len);
         if (raw.length === seg.len) {
             const n = Number(raw);
-            out += n > seg.max ? raw.slice(-1).padStart(seg.len, '0') : raw;
+            out += n > seg.max ? String(seg.max).padStart(seg.len, '0') : raw;
         }
         else {
             out += raw;

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

@@ -20,6 +20,7 @@ const constants_1 = require("../../constants");
 const hooks_1 = require("../../hooks");
 const shared_1 = require("../shared");
 const styles_module_scss_1 = __importDefault(require('../shared/styles.module.css'));
+const hooks_2 = require("./hooks");
 const styles_module_scss_2 = __importDefault(require('./styles.module.css'));
 const utils_2 = require("./utils");
 exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
@@ -28,10 +29,13 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
     const chips = multiple ? (props.chips ?? true) : false;
     const removeByBackspace = multiple ? (props.removeByBackspace ?? true) : false;
     const closeDroplistOnItemClick = props.closeDroplistOnItemClick ?? !multiple;
+    const allowCustomOption = props.allowCustomOption === true;
+    const addCustomOptionTriggers = allowCustomOption ? props.addCustomOptionTriggers : undefined;
     const resolvedAutoFocus = (0, hooks_1.useAdaptiveAutoFocus)(autoFocus, layoutPresets);
     const inputRef = (0, react_1.useRef)(null);
     // Отдельный ref на реальный <input>: `inputRef.current` перезаписывается span-обёрткой PopoverPrivate.
     const inputElementRef = (0, react_1.useRef)(null);
+    const restoreInputFocusRef = (0, react_1.useRef)(false);
     const clearButtonRef = (0, react_1.useRef)(null);
     const copyButtonRef = (0, react_1.useRef)(null);
     const contentRef = (0, react_1.useRef)(null);
@@ -73,16 +77,20 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
     }, [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]);
+    const selectedIds = (0, react_1.useMemo)(() => (0, utils_2.getSelectedIds)({ multiple, multipleValue, singleValue }), [multiple, multipleValue, singleValue]);
+    // Выбранное, которого нет в `items` (кастом по allowCustomOption, ленивая подгрузка) — в список, не только в чип.
+    const missingSelectedItems = (0, react_1.useMemo)(() => (0, utils_2.getMissingSelectedItems)(selectedIds, allItems), [selectedIds, allItems]);
+    const itemsWithPlaceholders = (0, react_1.useMemo)(() => (missingSelectedItems.length > 0 ? [...missingSelectedItems, ...items] : items), [missingSelectedItems, items]);
     // Выбранное значение переживает смену `items` (серверный поиск, ленивая подгрузка).
     const seenItems = (0, react_1.useRef)(new Map());
     const resolveItem = (0, react_1.useMemo)(() => {
-        for (const item of (0, utils_2.flatten)(allItems)) {
+        for (const item of (0, utils_2.flatten)([...missingSelectedItems, ...allItems])) {
             if (item.id !== undefined) {
                 seenItems.current.set(item.id, item);
             }
         }
-        return (id) => (0, utils_2.findItem)(allItems, id) ?? seenItems.current.get(id);
-    }, [allItems]);
+        return (id) => (0, utils_2.findItem)(allItems, id) ?? (0, utils_2.findItem)(missingSelectedItems, id) ?? seenItems.current.get(id);
+    }, [allItems, missingSelectedItems]);
     const selectedPairs = (0, react_1.useMemo)(() => {
         if (!multiple || multipleValue.length === 0) {
             return [];
@@ -137,13 +145,13 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
         syncedLabelRef.current = selectedLabel;
         setInputValue(selectedLabel);
     }, [selectedLabel, typing, resetSearchOnOptionSelection, setInputValue]);
-    // При autocomplete фильтрует сервер — items берутся как есть.
+    // При autocomplete фильтрует сервер — items берутся как есть, плюс выбранное вне списка.
     const filteredItems = (0, react_1.useMemo)(() => {
         if (!searchable || autocomplete || !typing) {
-            return items;
+            return itemsWithPlaceholders;
         }
-        return (0, utils_2.filterItems)(items, inputValue, enableFuzzySearch);
-    }, [searchable, autocomplete, typing, items, inputValue, enableFuzzySearch]);
+        return (0, utils_2.filterItems)(itemsWithPlaceholders, inputValue, enableFuzzySearch);
+    }, [searchable, autocomplete, typing, itemsWithPlaceholders, inputValue, enableFuzzySearch]);
     const filteredPinTop = (0, react_1.useMemo)(() => {
         if (!searchable || autocomplete || !typing || !pinTop) {
             return pinTop;
@@ -156,22 +164,7 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
         }
         return (0, utils_2.filterItems)(pinBottom, inputValue, enableFuzzySearch);
     }, [searchable, autocomplete, typing, pinBottom, inputValue, enableFuzzySearch]);
-    const handleOpenChange = (0, react_1.useCallback)((next) => {
-        // readonly/disabled поле открывать нельзя, закрывать — можно.
-        if (next && (disabled || readOnly))
-            return;
-        if (openProp === undefined) {
-            setOpenLocal(next);
-        }
-        onOpenChange?.(next);
-        if (!next) {
-            setTyping(false);
-            if (resetSearchOnOptionSelection) {
-                setInputValue(selectedLabel);
-            }
-        }
-    }, [openProp, onOpenChange, disabled, readOnly, resetSearchOnOptionSelection, setInputValue, selectedLabel]);
-    const handleSingleChange = (next) => {
+    const handleSingleChange = (0, react_1.useCallback)((next) => {
         if (multiple) {
             return;
         }
@@ -180,11 +173,12 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
         }
         props.onChange?.(next);
         setTyping(false);
-    };
-    const handleMultipleChange = (next) => {
+    }, [multiple, props]);
+    const handleMultipleChange = (0, react_1.useCallback)((next) => {
         if (!multiple) {
             return;
         }
+        restoreInputFocusRef.current = (0, utils_1.isBrowser)() && inputElementRef.current === document.activeElement;
         if (props.value === undefined) {
             setMultipleLocal(next);
         }
@@ -195,8 +189,57 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
                 setInputValue('');
             }
         }
-    };
+    }, [multiple, props, searchable, resetSearchOnOptionSelection, setInputValue]);
+    const resetCustomOptionSearch = (0, react_1.useCallback)(() => {
+        setTyping(false);
+        if (resetSearchOnOptionSelection) {
+            setInputValue(multiple ? '' : selectedLabel);
+        }
+    }, [resetSearchOnOptionSelection, setInputValue, multiple, selectedLabel]);
+    const { listRef, suppressCloseCommit, enableCloseCommit, tryCommitOnClose, tryCommitOnBlur, tryCommitFromKeyboard, handleListSingleChange, handleListMultipleChange, } = (0, hooks_2.useCustomOption)({
+        allowCustomOption,
+        addCustomOptionTriggers,
+        addOptionByEnter,
+        multiple,
+        inputValue,
+        typing,
+        multipleValue,
+        commitSingle: handleSingleChange,
+        commitMultiple: handleMultipleChange,
+        resetSearch: resetCustomOptionSearch,
+        inputElementRef,
+        clearButtonRef,
+        copyButtonRef,
+        footerActiveElementsRefs,
+    });
+    const handleOpenChange = (0, react_1.useCallback)((next) => {
+        // readonly/disabled поле открывать нельзя, закрывать — можно.
+        if (next && (disabled || readOnly))
+            return;
+        if (openProp === undefined) {
+            setOpenLocal(next);
+        }
+        onOpenChange?.(next);
+        if (!next) {
+            setTyping(false);
+            const committed = tryCommitOnClose();
+            // Кастомная опция не зафиксирована — вернуть лейбл выбранного значения.
+            if (resetSearchOnOptionSelection && !committed) {
+                setInputValue(selectedLabel);
+            }
+        }
+    }, [
+        openProp,
+        onOpenChange,
+        disabled,
+        readOnly,
+        resetSearchOnOptionSelection,
+        setInputValue,
+        selectedLabel,
+        tryCommitOnClose,
+    ]);
     const handleInputChange = (next) => {
+        enableCloseCommit();
         setInputValue(next);
         setTyping(true);
         if (!open) {
@@ -295,19 +338,12 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
         }
         if (event.key === 'Escape' && open) {
             event.preventDefault();
+            suppressCloseCommit();
             handleOpenChange(false);
         }
-        if (addOptionByEnter && event.key === 'Enter' && inputValue !== '') {
-            // Введённый текст становится новым значением (создание опции «на лету»).
+        if (tryCommitFromKeyboard(event)) {
             event.preventDefault();
-            if (multiple) {
-                if (!multipleValue.includes(inputValue)) {
-                    handleMultipleChange([...multipleValue, inputValue]);
-                }
-            }
-            else {
-                handleSingleChange(inputValue);
-            }
+            event.stopPropagation();
             return;
         }
         if (event.key === 'Enter' && !open) {
@@ -320,6 +356,11 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
             removeChip(last);
         }
     };
+    const handleTriggerKeyDownCapture = (event) => {
+        if (event.key === 'Escape') {
+            suppressCloseCommit();
+        }
+    };
     const handleTriggerMouseEnter = (0, react_1.useCallback)(() => {
         if (!readOnly && !disabled) {
             setHover(true);
@@ -344,14 +385,28 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
         }
         onFocusProp?.(event);
     }, [searchable, onFocusProp]);
-    const handleInputBlur = (0, react_1.useCallback)((event) => {
+    const handleInputBlur = (event) => {
         setFocusVisible(false);
+        const blurResult = tryCommitOnBlur(event);
+        // Закрытый список не получит onOpenChange — вернуть лейбл выбранного значения.
+        // Клик по айтему открытого списка даёт relatedTarget === null, восстановление делает закрытие.
+        if (resetSearchOnOptionSelection && blurResult === 'skipped' && (!open || event.relatedTarget !== null)) {
+            setTyping(false);
+            setInputValue(selectedLabel);
+        }
         onBlurProp?.(event);
-    }, [onBlurProp]);
+    };
     const droplistSelection = multiple
-        ? { mode: 'multiple', value: multipleValue, onChange: handleMultipleChange }
-        : { mode: 'single', value: singleValue, onChange: handleSingleChange };
+        ? { mode: 'multiple', value: multipleValue, onChange: handleListMultipleChange }
+        : { mode: 'single', value: singleValue, onChange: handleListSingleChange };
     const hasChips = chips && selectedPairs.length > 0;
+    (0, utils_1.useLayoutEffect)(() => {
+        if (!restoreInputFocusRef.current) {
+            return;
+        }
+        restoreInputFocusRef.current = false;
+        inputElementRef.current?.focus();
+    }, [multipleValue.length]);
     // minWidth поискового input'а = ширина введённого текста (`.inputPlug`), но не больше строки чипов.
     // Замер до paint, иначе input мигает при вводе.
     (0, utils_1.useLayoutEffect)(() => {
@@ -364,11 +419,11 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
         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 || 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 }));
-    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 }));
+    const searchInput = hasChips ? ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_2.default.inputWrapper, style: { minWidth: chipInputMinWidth }, children: searchInputField }, 'search-input')) : ((0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.inputArea, children: searchInputField }));
     const trigger = (
     // Focusable-элемент — InputPrivate внутри, обёртка только собирает combobox.
     // eslint-disable-next-line jsx-a11y/no-static-element-interactions
-    (0, jsx_runtime_1.jsxs)("div", { className: (0, classnames_1.default)(styles_module_scss_1.default.fieldWrapper, styles_module_scss_2.default.trigger, fieldClassName), "data-size": size, "data-validation-state": effectiveValidationState, "data-disabled": disabled || undefined, "data-readonly": readOnly || undefined, "data-withbackground": background || undefined, "data-focusvisible": focusVisible || open || undefined, "data-hover": !readOnly && !disabled && hover ? true : undefined, "data-test-id": dataTestId, onMouseEnter: handleTriggerMouseEnter, onMouseLeave: handleTriggerMouseLeave, onClick: handleTriggerClick, children: [(0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.backgroundWrapper, children: [(0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.materialLayer, ...(0, shared_1.getAcrylicProps)({
+    (0, jsx_runtime_1.jsxs)("div", { className: (0, classnames_1.default)(styles_module_scss_1.default.fieldWrapper, styles_module_scss_2.default.trigger, fieldClassName), "data-size": size, "data-validation-state": effectiveValidationState, "data-disabled": disabled || undefined, "data-readonly": readOnly || undefined, "data-withbackground": background || undefined, "data-focusvisible": focusVisible || open || undefined, "data-hover": !readOnly && !disabled && hover ? true : undefined, "data-test-id": dataTestId, onMouseEnter: handleTriggerMouseEnter, onMouseLeave: handleTriggerMouseLeave, onKeyDownCapture: handleTriggerKeyDownCapture, onClick: handleTriggerClick, children: [(0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.backgroundWrapper, children: [(0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.materialLayer, ...(0, shared_1.getAcrylicProps)({
                             validationState: effectiveValidationState,
                             disabled,
                             readonly: readOnly,
@@ -377,5 +432,5 @@ exports.FieldSelect = (0, react_1.forwardRef)(function FieldSelect(props, ref) {
                         }), children: (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.acrylicBg, "aria-hidden": true }) }), (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.borderStateLayer, "data-state": 'borderOnBackground' }), (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.focusLayer })] }), (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.fieldContainer, children: (0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.contentWrapper, children: [iconBefore && (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.iconSlot, children: iconBefore }), (0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_1.default.inputLine, children: [prefix && (0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_1.default.prefix, children: prefix }), hasChips ? ((0, jsx_runtime_1.jsxs)("div", { className: styles_module_scss_2.default.chipsRow, ref: contentRef, "data-test-id": constants_1.TEST_IDS.fieldSelectChips, children: [selectedPairs.map(pair => ((0, jsx_runtime_1.jsx)(tag_1.Tag, { label: formatPair(pair), size: utils_2.TAG_SIZE_MAP[size], appearance: pair.appearance ?? 'neutral', onDelete: disabled || readOnly || pair.disabled ? undefined : handleRemoveChip(pair.id) }, String(pair.id)))), searchInput, (0, jsx_runtime_1.jsx)("span", { ref: inputPlugRef, className: styles_module_scss_2.default.inputPlug, "aria-hidden": true, children: inputValue })] })) : (searchInput), postfixButtons && (
                                 // eslint-disable-next-line jsx-a11y/no-static-element-interactions
                                 (0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_1.default.postfixButtonsSlot, onMouseDown: shared_1.preventSlotMouseDown, onClick: shared_1.stopSlotClickPropagation, children: postfixButtons })), postfix && (0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_1.default.postfix, children: postfix })] }), (0, jsx_runtime_1.jsx)("div", { className: styles_module_scss_1.default.iconSlot, children: (0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_2.default.chevron, "data-open": open || undefined, "aria-hidden": true, children: (0, jsx_runtime_1.jsx)(system_1.ChevronDownSVG, {}) }) })] }) })] }));
-    return ((0, jsx_runtime_1.jsx)(field_decorator_1.FieldDecorator, { className: className, label: label, labelTooltip: labelTooltip, caption: caption, hint: hint, error: error, size: size, validationState: validationState, showHintIcon: showHintIcon, length: length, required: required, labelFor: id, disabled: disabled, readonly: readOnly, children: (0, jsx_runtime_1.jsx)(list_1.Droplist, { items: filteredItems, label: label, pinTop: filteredPinTop, pinBottom: filteredPinBottom, trigger: 'click', placement: placement, widthStrategy: widthStrategy, triggerElemRef: inputRef, size: size, open: open, onOpenChange: handleOpenChange, selection: droplistSelection, closeDroplistOnItemClick: closeDroplistOnItemClick, footer: footer, footerActiveElementsRefs: footerActiveElementsRefs, loading: loading, noDataState: noDataState, noResultsState: noResultsState, errorDataState: errorDataState, dataError: dataError, dataFiltered: dataFiltered ?? (searchable && typing && inputValue !== ''), virtualized: virtualized, scroll: true, scrollToSelectedItem: scrollToSelectedItem, limitedScrollHeight: limitedScrollHeight, untouchableScrollbars: untouchableScrollbars, closeOnPopstate: closeOnPopstate, children: trigger }) }));
+    return ((0, jsx_runtime_1.jsx)(field_decorator_1.FieldDecorator, { className: className, label: label, labelTooltip: labelTooltip, caption: caption, hint: hint, error: error, size: size, validationState: validationState, showHintIcon: showHintIcon, length: length, required: required, labelFor: id, disabled: disabled, readonly: readOnly, children: (0, jsx_runtime_1.jsx)(list_1.Droplist, { items: filteredItems, label: label, pinTop: filteredPinTop, pinBottom: filteredPinBottom, trigger: 'click', placement: placement, widthStrategy: widthStrategy, triggerElemRef: inputRef, listRef: listRef, size: size, open: open, onOpenChange: handleOpenChange, selection: droplistSelection, closeDroplistOnItemClick: closeDroplistOnItemClick, footer: footer, footerActiveElementsRefs: footerActiveElementsRefs, loading: loading, noDataState: noDataState, noResultsState: noResultsState, errorDataState: errorDataState, dataError: dataError, dataFiltered: dataFiltered ?? (searchable && typing && inputValue !== ''), virtualized: virtualized, scroll: true, scrollToSelectedItem: scrollToSelectedItem, limitedScrollHeight: limitedScrollHeight, untouchableScrollbars: untouchableScrollbars, closeOnPopstate: closeOnPopstate, children: trigger }) }));
 });

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

@@ -2,3 +2,14 @@ export declare const SELECTION_MODE: {
     readonly Single: "single";
     readonly Multiple: "multiple";
 };
+/** События, по которым произвольный ввод фиксируется как выбранная опция. */
+export declare const ADD_CUSTOM_OPTION_TRIGGER: {
+    readonly Enter: "enter";
+    readonly Blur: "blur";
+    readonly Space: "space";
+    readonly Comma: "comma";
+};
+/** Триггеры по умолчанию для `selection='single'` при `allowCustomOption`. */
+export declare const ADD_CUSTOM_OPTION_TRIGGERS_SINGLE: readonly ["enter", "blur"];
+/** Триггеры по умолчанию для `selection='multiple'` при `allowCustomOption`. */
+export declare const ADD_CUSTOM_OPTION_TRIGGERS_MULTIPLE: readonly ["enter", "blur", "space", "comma"];

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

@@ -1,7 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SELECTION_MODE = void 0;
+exports.ADD_CUSTOM_OPTION_TRIGGERS_MULTIPLE = exports.ADD_CUSTOM_OPTION_TRIGGERS_SINGLE = exports.ADD_CUSTOM_OPTION_TRIGGER = exports.SELECTION_MODE = void 0;
 exports.SELECTION_MODE = {
     Single: 'single',
     Multiple: 'multiple',
 };
+/** События, по которым произвольный ввод фиксируется как выбранная опция. */
+exports.ADD_CUSTOM_OPTION_TRIGGER = {
+    Enter: 'enter',
+    Blur: 'blur',
+    Space: 'space',
+    Comma: 'comma',
+};
+/** Триггеры по умолчанию для `selection='single'` при `allowCustomOption`. */
+exports.ADD_CUSTOM_OPTION_TRIGGERS_SINGLE = [
+    exports.ADD_CUSTOM_OPTION_TRIGGER.Enter,
+    exports.ADD_CUSTOM_OPTION_TRIGGER.Blur,
+];
+/** Триггеры по умолчанию для `selection='multiple'` при `allowCustomOption`. */
+exports.ADD_CUSTOM_OPTION_TRIGGERS_MULTIPLE = [
+    exports.ADD_CUSTOM_OPTION_TRIGGER.Enter,
+    exports.ADD_CUSTOM_OPTION_TRIGGER.Blur,
+    exports.ADD_CUSTOM_OPTION_TRIGGER.Space,
+    exports.ADD_CUSTOM_OPTION_TRIGGER.Comma,
+];

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

@@ -0,0 +1,33 @@
+import { ItemId } from '@cloud-ru/ds-list';
+import { FocusEvent, KeyboardEvent, RefObject } from 'react';
+import { FieldSelectAddCustomOptionTrigger } from './types';
+/** Результат blur: фокус остался внутри поля, ввод зафиксирован, или коммитить было нечего. */
+type CustomOptionBlurResult = 'inside' | 'committed' | 'skipped';
+type UseCustomOptionParams = {
+    allowCustomOption: boolean;
+    addCustomOptionTriggers: readonly FieldSelectAddCustomOptionTrigger[] | undefined;
+    addOptionByEnter: boolean;
+    multiple: boolean;
+    inputValue: string;
+    typing: boolean;
+    multipleValue: ItemId[];
+    commitSingle(value: ItemId | undefined): void;
+    commitMultiple(value: ItemId[]): void;
+    resetSearch(): void;
+    inputElementRef: RefObject<HTMLInputElement | null>;
+    clearButtonRef: RefObject<HTMLButtonElement | null>;
+    copyButtonRef: RefObject<HTMLButtonElement | null>;
+    footerActiveElementsRefs?: RefObject<HTMLElement>[];
+};
+/** Фиксация произвольного ввода как выбранной опции: триггеры, blur, закрытие списка. */
+export declare function useCustomOption({ allowCustomOption, addCustomOptionTriggers, addOptionByEnter, multiple, inputValue, typing, multipleValue, commitSingle, commitMultiple, resetSearch, inputElementRef, clearButtonRef, copyButtonRef, footerActiveElementsRefs, }: UseCustomOptionParams): {
+    listRef: RefObject<HTMLElement>;
+    suppressCloseCommit: () => void;
+    enableCloseCommit: () => void;
+    tryCommitOnClose: () => boolean;
+    tryCommitOnBlur: (event: FocusEvent<HTMLInputElement>) => CustomOptionBlurResult;
+    tryCommitFromKeyboard: (event: KeyboardEvent<HTMLInputElement>) => boolean;
+    handleListSingleChange: (next: ItemId | undefined) => void;
+    handleListMultipleChange: (next: ItemId[]) => void;
+};
+export {};

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

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCustomOption = useCustomOption;
+const utils_1 = require("@cloud-ru/ds-utils");
+const react_1 = require("react");
+const constants_1 = require("./constants");
+const utils_2 = require("./utils");
+/** Фиксация произвольного ввода как выбранной опции: триггеры, blur, закрытие списка. */
+function useCustomOption({ allowCustomOption, addCustomOptionTriggers, addOptionByEnter, multiple, inputValue, typing, multipleValue, commitSingle, commitMultiple, resetSearch, inputElementRef, clearButtonRef, copyButtonRef, footerActiveElementsRefs, }) {
+    const listRef = (0, react_1.useRef)(null);
+    const skipCloseCommitRef = (0, react_1.useRef)(false);
+    const skipBlurCommitRef = (0, react_1.useRef)(false);
+    const resolvedTriggers = (0, react_1.useMemo)(() => (0, utils_2.resolveAddCustomOptionTriggers)({
+        allowCustomOption,
+        addCustomOptionTriggers,
+        addOptionByEnter,
+        defaultTriggers: multiple ? constants_1.ADD_CUSTOM_OPTION_TRIGGERS_MULTIPLE : constants_1.ADD_CUSTOM_OPTION_TRIGGERS_SINGLE,
+    }), [allowCustomOption, addCustomOptionTriggers, addOptionByEnter, multiple]);
+    const tryCommit = (0, react_1.useCallback)((trigger) => {
+        if (!typing || !(0, utils_2.shouldHandleCustomOptionTrigger)(trigger, resolvedTriggers) || inputValue === '') {
+            return false;
+        }
+        if (multiple) {
+            if (multipleValue.includes(inputValue)) {
+                resetSearch();
+            }
+            else {
+                commitMultiple([...multipleValue, inputValue]);
+            }
+        }
+        else {
+            commitSingle(inputValue);
+        }
+        return true;
+    }, [typing, resolvedTriggers, inputValue, multiple, multipleValue, commitMultiple, commitSingle, resetSearch]);
+    const suppressCloseCommit = (0, react_1.useCallback)(() => {
+        skipCloseCommitRef.current = true;
+        skipBlurCommitRef.current = true;
+    }, []);
+    const enableCloseCommit = (0, react_1.useCallback)(() => {
+        skipCloseCommitRef.current = false;
+        skipBlurCommitRef.current = false;
+    }, []);
+    const tryCommitOnClose = (0, react_1.useCallback)(() => {
+        const skipped = skipCloseCommitRef.current;
+        const shouldCommit = (0, utils_2.shouldCommitCustomOptionOnClose)({
+            skip: skipped,
+            inputElement: inputElementRef.current,
+            activeElement: (0, utils_1.isBrowser)() ? document.activeElement : null,
+        });
+        if (skipped) {
+            queueMicrotask(() => {
+                skipCloseCommitRef.current = false;
+            });
+        }
+        return shouldCommit && tryCommit(constants_1.ADD_CUSTOM_OPTION_TRIGGER.Blur);
+    }, [inputElementRef, tryCommit]);
+    const tryCommitOnBlur = (0, react_1.useCallback)((event) => {
+        if (skipBlurCommitRef.current) {
+            skipBlurCommitRef.current = false;
+            return 'skipped';
+        }
+        if ((0, utils_2.isCustomOptionBlurInsideField)(event.relatedTarget, [
+            listRef.current,
+            clearButtonRef.current,
+            copyButtonRef.current,
+            ...(footerActiveElementsRefs?.map(ref => ref.current) ?? []),
+        ])) {
+            return 'inside';
+        }
+        return tryCommit(constants_1.ADD_CUSTOM_OPTION_TRIGGER.Blur) ? 'committed' : 'skipped';
+    }, [clearButtonRef, copyButtonRef, footerActiveElementsRefs, tryCommit]);
+    const tryCommitFromKeyboard = (0, react_1.useCallback)((event) => {
+        const trigger = (0, utils_2.getCustomOptionTriggerByCode)(event.code, event.key);
+        return trigger !== undefined && tryCommit(trigger);
+    }, [tryCommit]);
+    const handleListSingleChange = (0, react_1.useCallback)((next) => {
+        skipCloseCommitRef.current = true;
+        commitSingle(next);
+    }, [commitSingle]);
+    const handleListMultipleChange = (0, react_1.useCallback)((next) => {
+        skipCloseCommitRef.current = true;
+        commitMultiple(next);
+    }, [commitMultiple]);
+    return {
+        listRef,
+        suppressCloseCommit,
+        enableCloseCommit,
+        tryCommitOnClose,
+        tryCommitOnBlur,
+        tryCommitFromKeyboard,
+        handleListSingleChange,
+        handleListMultipleChange,
+    };
+}

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

@@ -4,9 +4,30 @@ import { Appearance as TagAppearance } from '@cloud-ru/ds-tag';
 import { ValueOf } from '@cloud-ru/ds-utils';
 import { FocusEvent, KeyboardEvent, ReactNode } from 'react';
 import { FieldLayoutPresets } from '../../hooks';
-import { SELECTION_MODE } from './constants';
+import { ADD_CUSTOM_OPTION_TRIGGER, ADD_CUSTOM_OPTION_TRIGGERS_MULTIPLE, ADD_CUSTOM_OPTION_TRIGGERS_SINGLE, SELECTION_MODE } from './constants';
 /** Режим выбора FieldSelect: одно значение или несколько. */
 export type Selection = ValueOf<typeof SELECTION_MODE>;
+/** Событие, по которому произвольный ввод фиксируется как выбранная опция. */
+export type FieldSelectAddCustomOptionTrigger = ValueOf<typeof ADD_CUSTOM_OPTION_TRIGGER>;
+/** Триггеры кастомной опции в режиме `single`. */
+export type FieldSelectSingleAddCustomOptionTrigger = (typeof ADD_CUSTOM_OPTION_TRIGGERS_SINGLE)[number];
+/** Триггеры кастомной опции в режиме `multiple`. */
+export type FieldSelectMultipleAddCustomOptionTrigger = (typeof ADD_CUSTOM_OPTION_TRIGGERS_MULTIPLE)[number];
+type CustomOptionProps<TTrigger extends FieldSelectAddCustomOptionTrigger> = {
+    /**
+     * Разрешить фиксировать произвольный ввод из строки поиска как выбранную опцию
+     * (значение, которого нет в `items`).
+     * @default false
+     */
+    allowCustomOption?: boolean;
+    /**
+     * События, по которым произвольный ввод фиксируется как выбранная опция.
+     * Учитывается только при `allowCustomOption={true}`.
+     * Если не задан — используются все триггеры режима (`single`: enter, blur; `multiple`: enter, blur, space, comma).
+     * Триггеры, недоступные в текущем `selection`, игнорируются.
+     */
+    addCustomOptionTriggers?: TTrigger[];
+};
 type WithTagAppearance<T> = T extends {
     items: ItemProps[];
 } ? Omit<T, 'items'> & {
@@ -98,6 +119,8 @@ type CommonSelectProps = FieldSelectDecoratorProps & DroplistPassthrough & {
     autocomplete?: boolean;
     /**
      * Зафиксировать введённый текст как новый выбор по `Enter` (создание опции «на лету»).
+     *
+     * @deprecated Используйте `allowCustomOption`. `true` эквивалентен `allowCustomOption` с триггером `enter`.
      * @default false
      */
     addOptionByEnter?: boolean;
@@ -154,7 +177,7 @@ type CommonSelectProps = FieldSelectDecoratorProps & DroplistPassthrough & {
     /** Тестовый id корня */
     'data-test-id'?: string;
 };
-export type FieldSelectSingleProps = CommonSelectProps & {
+export type FieldSelectSingleProps = CommonSelectProps & CustomOptionProps<FieldSelectSingleAddCustomOptionTrigger> & {
     /** Режим выбора. По умолчанию `'single'`. */
     selection?: typeof SELECTION_MODE.Single;
     /** Управляемое значение. Пустая строка трактуется как «значение не выбрано». */
@@ -169,7 +192,7 @@ export type FieldSelectSingleProps = CommonSelectProps & {
      */
     closeDroplistOnItemClick?: boolean;
 };
-export type FieldSelectMultipleProps = CommonSelectProps & {
+export type FieldSelectMultipleProps = CommonSelectProps & CustomOptionProps<FieldSelectMultipleAddCustomOptionTrigger> & {
     /** Режим выбора */
     selection: typeof SELECTION_MODE.Multiple;
     /** Управляемые значения */

package/dist/cjs/components/FieldSelect/utils/customOption.d.ts

@@ -0,0 +1,21 @@
+import { FieldSelectAddCustomOptionTrigger, FieldSelectMultipleAddCustomOptionTrigger } from '../types';
+/**
+ * Сопоставляет клавишу с триггером кастомной опции (`enter` / `space` / `comma`).
+ * Сначала `KeyboardEvent.code`, затем `key` — если `code` пустой или не из словаря (`','` без `Comma`).
+ */
+export declare function getCustomOptionTriggerByCode(code: string, key?: string): FieldSelectMultipleAddCustomOptionTrigger | undefined;
+export declare function shouldHandleCustomOptionTrigger(trigger: FieldSelectAddCustomOptionTrigger | undefined, availableTriggers: readonly FieldSelectAddCustomOptionTrigger[]): trigger is FieldSelectAddCustomOptionTrigger;
+export declare function resolveAddCustomOptionTriggers(params: {
+    allowCustomOption: boolean;
+    addCustomOptionTriggers: readonly FieldSelectAddCustomOptionTrigger[] | undefined;
+    addOptionByEnter: boolean;
+    defaultTriggers: readonly FieldSelectAddCustomOptionTrigger[];
+}): FieldSelectAddCustomOptionTrigger[];
+/** Фокус ушёл на дроплист, футер или postfix — кастомную опцию на blur фиксировать не нужно. */
+export declare function isCustomOptionBlurInsideField(relatedTarget: EventTarget | null, nodes: (Node | null | undefined)[]): boolean;
+/** Клик снаружи закрывает список, не снимая фокус с input — blur не придёт. */
+export declare function shouldCommitCustomOptionOnClose(params: {
+    skip: boolean;
+    inputElement: Element | null;
+    activeElement: Element | null;
+}): boolean;