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

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

@@ -0,0 +1,36 @@
+import { extractSearchText } from './extract.js';
+// Subsequence-fuzzy: символы запроса должны встречаться в строке в исходном порядке.
+// Пример: query=`lge` matches `Large` (L → r → arg → e).
+export function isFuzzyMatch(haystack, needle) {
+    if (!needle) {
+        return true;
+    }
+    let i = 0;
+    for (const ch of haystack) {
+        if (ch === needle[i]) {
+            i += 1;
+            if (i === needle.length) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+export function filterItems(items, query, fuzzy) {
+    if (!query) {
+        return items;
+    }
+    const q = query.toLowerCase();
+    const matches = (item) => {
+        const text = extractSearchText(item).toLowerCase();
+        return fuzzy ? isFuzzyMatch(text, q) : text.includes(q);
+    };
+    const walk = (list) => list.flatMap(item => {
+        if ('items' in item && Array.isArray(item.items)) {
+            const filteredChildren = walk(item.items);
+            return filteredChildren.length > 0 ? [{ ...item, items: filteredChildren }] : [];
+        }
+        return matches(item) ? [item] : [];
+    });
+    return walk(items);
+}

package/dist/esm/components/FieldSelect/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './customOption.js';
+export * from './extract.js';
+export * from './filter.js';
+export * from './items.js';
+export * from './selection.js';
+export * from './tagSize.js';

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

@@ -0,0 +1,6 @@
+export * from './customOption.js';
+export * from './extract.js';
+export * from './filter.js';
+export * from './items.js';
+export * from './selection.js';
+export * from './tagSize.js';

package/dist/esm/components/FieldSelect/utils/items.d.ts

@@ -0,0 +1,9 @@
+import { ItemId } from '@cloud-ru/ds-list';
+import { FieldSelectItem } from '../types.js';
+import { WithIdContent } from './extract.js';
+export declare function flatten(items: FieldSelectItem[]): WithIdContent[];
+export declare function findItem(items: FieldSelectItem[], id: ItemId): WithIdContent | undefined;
+/** Айтем для выбранного значения, которого нет в `items` (кастомная опция, ленивая подгрузка). */
+export declare function createPlaceholderItem(id: ItemId): FieldSelectItem;
+/** Выбранные id, которых нет в дереве айтемов — в дроплист их нужно добавить отдельно. */
+export declare function getMissingSelectedItems(selectedIds: ItemId[], allItems: FieldSelectItem[]): FieldSelectItem[];

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

@@ -0,0 +1,41 @@
+export function flatten(items) {
+    const out = [];
+    for (const item of items) {
+        out.push(item);
+        if ('items' in item && Array.isArray(item.items)) {
+            out.push(...flatten(item.items));
+        }
+    }
+    return out;
+}
+export function findItem(items, id) {
+    for (const item of flatten(items)) {
+        if (item.id === id) {
+            return item;
+        }
+    }
+    return undefined;
+}
+/** Айтем для выбранного значения, которого нет в `items` (кастомная опция, ленивая подгрузка). */
+export function createPlaceholderItem(id) {
+    return { id, content: { label: String(id) } };
+}
+/** Выбранные id, которых нет в дереве айтемов — в дроплист их нужно добавить отдельно. */
+export function getMissingSelectedItems(selectedIds, allItems) {
+    if (selectedIds.length === 0) {
+        return [];
+    }
+    const existingIds = new Set();
+    for (const item of flatten(allItems)) {
+        if (item.id !== undefined) {
+            existingIds.add(item.id);
+        }
+    }
+    const missing = [];
+    for (const id of selectedIds) {
+        if (id !== '' && !existingIds.has(id)) {
+            missing.push(createPlaceholderItem(id));
+        }
+    }
+    return missing;
+}

package/dist/esm/components/FieldSelect/utils/selection.d.ts

@@ -0,0 +1,11 @@
+import { ItemId } from '@cloud-ru/ds-list';
+import { FieldSelectMultipleProps, Selection } from '../types.js';
+export declare function isMultiple(props: {
+    selection?: Selection;
+}): props is FieldSelectMultipleProps;
+/** Выбранные id в нормализованном виде: массив и для `single`, и для `multiple`. */
+export declare function getSelectedIds(params: {
+    multiple: boolean;
+    multipleValue: ItemId[];
+    singleValue: ItemId | undefined;
+}): ItemId[];

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

@@ -0,0 +1,14 @@
+import { SELECTION_MODE } from '../constants.js';
+export function isMultiple(props) {
+    return props.selection === SELECTION_MODE.Multiple;
+}
+/** Выбранные id в нормализованном виде: массив и для `single`, и для `multiple`. */
+export function getSelectedIds(params) {
+    if (params.multiple) {
+        return params.multipleValue;
+    }
+    if (params.singleValue === undefined) {
+        return [];
+    }
+    return [params.singleValue];
+}

package/dist/esm/components/FieldSelect/utils/tagSize.d.ts

@@ -0,0 +1,4 @@
+import { Size } from '@cloud-ru/ds-field-decorator';
+import { Size as TagSize } from '@cloud-ru/ds-tag';
+/** Соответствие размера поля размеру чипа выбранного значения (`selection='multiple'`). */
+export declare const TAG_SIZE_MAP: Record<Size, TagSize>;

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

@@ -0,0 +1,2 @@
+/** Соответствие размера поля размеру чипа выбранного значения (`selection='multiple'`). */
+export const TAG_SIZE_MAP = { s: 'xs', m: 'xs', l: 's' };

package/dist/esm/components/FieldTime/FieldTime.js

@@ -131,7 +131,7 @@ export const FieldTime = forwardRef(function FieldTime({ label = '', labelToolti
         // clear/copy недостижимыми со стрелок — движок всегда делает preventDefault на ArrowRight.
         onInputKeyDown(event);
     }, [onInputKeyDown, timeSeg]);
-    // value ведёт сегментный движок (useSegmentedMask); нативный onChange input'а игнорируем.
+    // value ведёт сегментный движок (keydown); нативный onChange input'а игнорируем.
     const handleInputChange = useCallback(() => undefined, []);
     const handleInputFocus = useCallback((event) => {
         setFocusVisible(event.target.matches(':focus-visible'));
@@ -149,7 +149,7 @@ export const FieldTime = forwardRef(function FieldTime({ label = '', labelToolti
                             readonly: readOnly,
                             hover,
                             focusVisible: focusVisible || open,
-                        }), children: _jsx("div", { className: fieldStyles.acrylicBg, "aria-hidden": true }) }), _jsx("div", { className: fieldStyles.borderStateLayer, "data-state": 'borderOnBackground' }), _jsx("div", { className: fieldStyles.focusLayer })] }), _jsx("div", { className: fieldStyles.fieldContainer, children: _jsxs("div", { className: fieldStyles.contentWrapper, children: [_jsx("div", { className: fieldStyles.inputLine, children: _jsxs("div", { className: fieldStyles.inputArea, children: [_jsx(InputPrivate, { ref: mergeRefs(ref, localRef, timeSeg.nativeInputRef), className: fieldStyles.fieldInput, value: inputValue, onChange: handleInputChange, disabled: disabled, readonly: readOnly, placeholder: placeholderMask, inputMode: INPUT_MODE.Numeric, tabIndex: inputTabIndex, onClick: timeSeg.handleClick, onPaste: timeSeg.handlePaste, onFocus: handleInputFocus, onBlur: handleInputBlur, onKeyDown: handleInputKeyDown, id: id, name: name, autoFocus: resolvedAutoFocus, "aria-haspopup": 'dialog', "aria-expanded": open, ...extractSupportProps(rest), "data-test-id": TEST_IDS.fieldTimeInput }), postfixButtons && _jsx("span", { className: fieldStyles.postfixButtonsSlot, children: postfixButtons })] }) }), _jsx("div", { className: fieldStyles.iconSlot, "data-test-id": TEST_IDS.fieldTimeIcon, "aria-hidden": true, children: _jsx(WatchSVG, {}) })] }) })] }));
+                        }), children: _jsx("div", { className: fieldStyles.acrylicBg, "aria-hidden": true }) }), _jsx("div", { className: fieldStyles.borderStateLayer, "data-state": 'borderOnBackground' }), _jsx("div", { className: fieldStyles.focusLayer })] }), _jsx("div", { className: fieldStyles.fieldContainer, children: _jsxs("div", { className: fieldStyles.contentWrapper, children: [_jsx("div", { className: fieldStyles.inputLine, children: _jsxs("div", { className: fieldStyles.inputArea, children: [_jsx(InputPrivate, { ref: mergeRefs(ref, localRef), className: fieldStyles.fieldInput, value: inputValue, onChange: handleInputChange, disabled: disabled, readonly: readOnly, placeholder: placeholderMask, inputMode: INPUT_MODE.Numeric, tabIndex: inputTabIndex, onClick: timeSeg.handleClick, onPaste: timeSeg.handlePaste, onFocus: handleInputFocus, onBlur: handleInputBlur, onKeyDown: handleInputKeyDown, id: id, name: name, autoFocus: resolvedAutoFocus, "aria-haspopup": 'dialog', "aria-expanded": open, ...extractSupportProps(rest), "data-test-id": TEST_IDS.fieldTimeInput }), postfixButtons && _jsx("span", { className: fieldStyles.postfixButtonsSlot, children: postfixButtons })] }) }), _jsx("div", { className: fieldStyles.iconSlot, "data-test-id": TEST_IDS.fieldTimeIcon, "aria-hidden": true, children: _jsx(WatchSVG, {}) })] }) })] }));
     return (_jsx(FieldDecorator, { className: className, label: label, labelTooltip: labelTooltip, caption: caption, hint: hint, error: error, validationState: validationState, showHintIcon: showHintIcon, length: length, required: required, labelFor: id, disabled: disabled, readonly: readOnly, size: size, children: _jsx(TimePickerDropdown
         // Явный data-test-id на дропдауне → детерминированный id портального контента:
         // `getTestIdBuilder` строит `content-${id}`, так контент адресуем для open-picker-снимка

package/dist/esm/segments/useSegmentedMask.d.ts

@@ -29,7 +29,6 @@ type UseSegmentedMaskParams = {
  * Сегментный ввод даты/времени (порт `useDateField` из @snack-uikit/fields). Каретка ходит по
  * сегментам (`setSelectionRange` подсвечивает текущий), цифры заполняют сегмент с авто-переходом,
  * стрелки двигают по сегментам, Backspace очищает сегмент до плейсхолдера.
- * `nativeInputRef` передаётся в `ref` того же input'а: значение правится через нативные `beforeinput`/`input`.
  */
 export declare function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, setValue, onMaskedChange, onArrowDown, onArrowUp, onEscape, onEdit, }: UseSegmentedMaskParams): {
     handleKeyDown: (event: KeyboardEvent<HTMLInputElement>) => void;
@@ -37,7 +36,6 @@ export declare function useSegmentedMask({ inputRef, mask, slots, readonly, disa
     handleFocus: () => void;
     handleBlur: () => void;
     handlePaste: (event: ClipboardEvent<HTMLInputElement>) => void;
-    nativeInputRef: (node: HTMLInputElement | null) => void;
     selectSlot: (slot: SlotMeta) => void;
     firstSlot: SlotMeta;
     lastSlot: SlotMeta;

package/dist/esm/segments/useSegmentedMask.js

@@ -1,21 +1,8 @@
-import { useEventHandler } from '@cloud-ru/ds-utils';
 import { useCallback, useRef } from 'react';
-const RESET_TYPED_KEYS = new Set([
-    'ArrowLeft',
-    'ArrowRight',
-    'ArrowUp',
-    'ArrowDown',
-    'Backspace',
-    'Delete',
-    'Enter',
-    'Tab',
-    'Escape',
-]);
 /**
  * Сегментный ввод даты/времени (порт `useDateField` из @snack-uikit/fields). Каретка ходит по
  * сегментам (`setSelectionRange` подсвечивает текущий), цифры заполняют сегмент с авто-переходом,
  * стрелки двигают по сегментам, Backspace очищает сегмент до плейсхолдера.
- * `nativeInputRef` передаётся в `ref` того же input'а: значение правится через нативные `beforeinput`/`input`.
  */
 export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, setValue, onMaskedChange, onArrowDown, onArrowUp, onEscape, onEdit, }) {
     const firstSlot = slots[0];
@@ -120,61 +107,70 @@ export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, se
         }
         selectSlot(nextSlot(slot));
     }, [clearSlot, isValidDate, lastSlot, nextSlot, selectSlot, slots, tryToComplete]);
-    // Цифры сегмента храним отдельно от текста: по `01` в поле не отличить `1` от `0` + `1`.
-    const typedRef = useRef(null);
-    const resetTyped = useCallback(() => {
-        typedRef.current = null;
-    }, []);
     const typeDigit = useCallback((slot, key) => {
+        const text = getSlotText(slot);
+        const numberValue = Number(text) || 0;
+        const digit = Number(key);
+        const slotValue = parseInt(numberValue.toString() + key, 10) || 0;
+        const valueLength = slotValue.toString().length;
         const maxLength = slot.max.toString().length;
-        const prev = typedRef.current?.key === slot.key ? typedRef.current.digits : '';
-        const appended = prev + key;
-        // Как в React Aria и MUI X: `13` в месяце → `03`.
-        const overflow = Number(appended) > slot.max;
-        const digits = overflow ? key : appended;
-        const value = Number(digits);
-        const complete = overflow || digits.length >= maxLength || value * 10 > slot.max;
-        const accepted = value >= slot.min;
-        if (accepted)
-            updateSlot(slot, value);
-        if (!complete) {
-            typedRef.current = { key: slot.key, digits };
-            return;
+        const isTheLastInput = /^0+$/.test(text) && maxLength === 2 && digit === 0;
+        if (valueLength < maxLength) {
+            if (slotValue || slotValue >= slot.min) {
+                updateSlot(slot, slotValue);
+                if (isTheLastInput)
+                    checkInputAndGoNext(slot);
+            }
+            if (slotValue * 10 > slot.max) {
+                checkInputAndGoNext(slot);
+            }
+        }
+        else if (valueLength > maxLength) {
+            if (digit * 10 > slot.max) {
+                updateSlot(slot, key);
+                checkInputAndGoNext(slot);
+            }
+            else if (digit || digit >= slot.min) {
+                updateSlot(slot, key);
+            }
+        }
+        else if (slotValue <= slot.max) {
+            updateSlot(slot, slotValue);
+            checkInputAndGoNext(slot);
         }
-        typedRef.current = null;
-        if (accepted)
+        else if (digit * 10 > slot.max) {
+            updateSlot(slot, key);
             checkInputAndGoNext(slot);
-    }, [checkInputAndGoNext, updateSlot]);
+        }
+        else if (digit || digit >= slot.min) {
+            updateSlot(slot, key);
+        }
+    }, [checkInputAndGoNext, getSlotText, updateSlot]);
     const handleFocus = useCallback(() => {
         if (readonly || disabled)
             return;
-        resetTyped();
         ensureMask();
         // На фокус всегда выбираем ПЕРВЫЙ сегмент (паритет с легаси). При клике мышью `handleClick`
         // отработает следом и перевыберет сегмент под кареткой; при Tab остаётся первый.
         selectSlot(firstSlot);
-    }, [disabled, ensureMask, firstSlot, readonly, resetTyped, selectSlot]);
+    }, [disabled, ensureMask, firstSlot, readonly, selectSlot]);
     const handleClick = useCallback((event) => {
         if (readonly || disabled)
             return;
-        resetTyped();
         ensureMask();
         selectSlot(slotFromIndex(event.currentTarget.selectionStart));
-    }, [disabled, ensureMask, readonly, resetTyped, selectSlot, slotFromIndex]);
+    }, [disabled, ensureMask, readonly, selectSlot, slotFromIndex]);
     const handleBlur = useCallback(() => {
-        resetTyped();
         const input = inputRef.current;
         if (input && input.value === mask) {
             input.value = '';
             setValue('');
         }
-    }, [inputRef, mask, resetTyped, setValue]);
+    }, [inputRef, mask, setValue]);
     const handleKeyDown = useCallback((event) => {
         const input = inputRef.current;
         if (!input || readonly || disabled)
             return;
-        if (RESET_TYPED_KEYS.has(event.key))
-            resetTyped();
         // Tab уводит фокус из поля — не перехватываем.
         if (event.key === 'Tab')
             return;
@@ -189,13 +185,7 @@ export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, se
             onArrowUp?.();
             return;
         }
-        // Копирование и вставку не блокируем: правку поля перехватит beforeinput.
-        if (event.ctrlKey || event.metaKey || event.altKey)
-            return;
         onEdit?.();
-        // Экранные клавиатуры присылают `Unidentified` вместо цифры, её данные есть только в beforeinput.
-        if (/^\d$/.test(event.key) || event.key === 'Unidentified')
-            return;
         if (event.key === 'Escape') {
             event.preventDefault();
             onEscape?.();
@@ -230,6 +220,11 @@ export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, se
         if (event.key === 'Enter') {
             tryToComplete();
             emit();
+            return;
+        }
+        if (/^\d$/.test(event.key)) {
+            typeDigit(slot, event.key);
+            emit();
         }
     }, [
         clearSlot,
@@ -245,13 +240,21 @@ export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, se
         onEscape,
         prevSlot,
         readonly,
-        resetTyped,
         selectSlot,
         slotFromIndex,
         tryToComplete,
+        typeDigit,
     ]);
-    const fillFromDigits = useCallback((digits) => {
-        resetTyped();
+    // Вставка (Ctrl+V) полной строки даты/времени: вытаскиваем цифры и заполняем сегменты
+    // слева направо. Нативный onChange у поля игнорируется (движок controlled), поэтому без
+    // этого обработчика вставка не работала бы вовсе.
+    const handlePaste = useCallback((event) => {
+        if (readonly || disabled)
+            return;
+        event.preventDefault();
+        const digits = event.clipboardData.getData('text').replace(/\D/g, '');
+        if (!digits)
+            return;
         ensureMask();
         let cursor = 0;
         let lastFilled;
@@ -270,100 +273,7 @@ export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, se
         else if (lastFilled) {
             selectSlot(nextSlot(lastFilled));
         }
-    }, [ensureMask, lastSlot, nextSlot, resetTyped, selectSlot, slots, tryToComplete, updateSlot]);
-    const handlePaste = useCallback((event) => {
-        if (readonly || disabled)
-            return;
-        event.preventDefault();
-        const digits = event.clipboardData.getData('text').replace(/\D/g, '');
-        if (!digits)
-            return;
-        fillFromDigits(digits);
-        emit();
-    }, [disabled, emit, fillFromDigits, readonly]);
-    const applyEdit = useCallback((inputType, text) => {
-        const input = inputRef.current;
-        if (!input)
-            return;
-        onEdit?.();
-        if (inputType.startsWith('delete')) {
-            resetTyped();
-            clearSlot(slotFromIndex(input.selectionStart));
-            emit();
-            return;
-        }
-        const digits = text.replace(/\D/g, '');
-        if (!inputType.startsWith('insert') || !digits)
-            return;
-        // Автозаполнение, `fill` и drop присылают строку целиком.
-        if (text.length > 1) {
-            fillFromDigits(digits);
-        }
-        else {
-            typeDigit(slotFromIndex(input.selectionStart), digits);
-        }
-        emit();
-    }, [clearSlot, emit, fillFromDigits, inputRef, onEdit, resetTyped, slotFromIndex, typeDigit]);
-    // Композицию IME браузер не даёт отменить — откатываем её в input.
-    const pendingEditRef = useRef(null);
-    const handleBeforeInput = useCallback((event) => {
-        const input = inputRef.current;
-        if (!input || readonly || disabled)
-            return;
-        ensureMask();
-        if (!event.cancelable) {
-            pendingEditRef.current = { value: input.value, start: input.selectionStart ?? 0, end: input.selectionEnd ?? 0 };
-            return;
-        }
-        event.preventDefault();
-        applyEdit(event.inputType, event.data ?? event.dataTransfer?.getData('text') ?? '');
-    }, [applyEdit, disabled, ensureMask, inputRef, readonly]);
-    const handleInput = useCallback((event) => {
-        const input = inputRef.current;
-        if (!input || readonly || disabled)
-            return;
-        const pending = pendingEditRef.current;
-        pendingEditRef.current = null;
-        if (pending) {
-            const inputType = event instanceof InputEvent ? event.inputType : '';
-            const inserted = input.value.slice(pending.start, input.value.length - (pending.value.length - pending.end));
-            input.value = pending.value;
-            setValue(pending.value);
-            input.setSelectionRange(pending.start, pending.end);
-            // Цифру композиции вводит её фиксация (insertText), иначе цифра запишется дважды.
-            if (!inputType.includes('Composition'))
-                applyEdit(inputType, inserted);
-            return;
-        }
-        // Автозаполнение меняет значение без beforeinput.
-        const digits = input.value.replace(/\D/g, '');
-        input.value = mask;
-        setValue(mask);
-        fillFromDigits(digits);
         emit();
-    }, [applyEdit, disabled, emit, fillFromDigits, inputRef, mask, readonly, setValue]);
-    // React 18 не отдаёт `inputType` в `onBeforeInput`, поэтому слушаем нативные события.
-    const onNativeBeforeInput = useEventHandler(handleBeforeInput);
-    const onNativeInput = useEventHandler(handleInput);
-    const attachedInputRef = useRef(null);
-    const nativeInputRef = useCallback((node) => {
-        /* eslint-disable @cloud-ru/ssr-safe-react/domApi -- callback-ref вызывается только в браузере */
-        attachedInputRef.current?.removeEventListener('beforeinput', onNativeBeforeInput);
-        attachedInputRef.current?.removeEventListener('input', onNativeInput);
-        attachedInputRef.current = node;
-        node?.addEventListener('beforeinput', onNativeBeforeInput);
-        node?.addEventListener('input', onNativeInput);
-        /* eslint-enable @cloud-ru/ssr-safe-react/domApi */
-    }, [onNativeBeforeInput, onNativeInput]);
-    return {
-        handleKeyDown,
-        handleClick,
-        handleFocus,
-        handleBlur,
-        handlePaste,
-        nativeInputRef,
-        selectSlot,
-        firstSlot,
-        lastSlot,
-    };
+    }, [disabled, emit, ensureMask, lastSlot, nextSlot, readonly, selectSlot, slots, tryToComplete, updateSlot]);
+    return { handleKeyDown, handleClick, handleFocus, handleBlur, handlePaste, selectSlot, firstSlot, lastSlot };
 }