@cloud-ru/ds-fields 2.5.9-preview-10cf17ae.0 → 3.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -0
- package/README.md +2 -1
- package/dist/cjs/components/FieldSelect/FieldSelect.js +136 -65
- package/dist/cjs/components/FieldSelect/constants.d.ts +15 -0
- package/dist/cjs/components/FieldSelect/constants.js +32 -1
- package/dist/cjs/components/FieldSelect/hooks.d.ts +32 -0
- package/dist/cjs/components/FieldSelect/hooks.js +94 -0
- package/dist/cjs/components/FieldSelect/types.d.ts +24 -8
- package/dist/cjs/components/FieldSelect/utils/customOption.d.ts +20 -0
- package/dist/cjs/components/FieldSelect/utils/customOption.js +48 -0
- package/dist/cjs/components/FieldSelect/utils/extract.d.ts +11 -0
- package/dist/cjs/components/FieldSelect/utils/extract.js +39 -0
- package/dist/cjs/components/FieldSelect/utils/filter.d.ts +3 -0
- package/dist/cjs/components/FieldSelect/utils/filter.js +40 -0
- package/dist/cjs/components/FieldSelect/utils/index.d.ts +6 -0
- package/dist/cjs/components/FieldSelect/utils/index.js +22 -0
- package/dist/cjs/components/FieldSelect/utils/items.d.ts +9 -0
- package/dist/cjs/components/FieldSelect/utils/items.js +47 -0
- package/dist/cjs/components/FieldSelect/utils/selection.d.ts +11 -0
- package/dist/cjs/components/FieldSelect/utils/selection.js +18 -0
- package/dist/cjs/components/FieldSelect/utils/tagSize.d.ts +4 -0
- package/dist/cjs/components/FieldSelect/utils/tagSize.js +5 -0
- package/dist/esm/components/FieldSelect/FieldSelect.js +138 -67
- package/dist/esm/components/FieldSelect/constants.d.ts +15 -0
- package/dist/esm/components/FieldSelect/constants.js +31 -0
- package/dist/esm/components/FieldSelect/hooks.d.ts +32 -0
- package/dist/esm/components/FieldSelect/hooks.js +91 -0
- package/dist/esm/components/FieldSelect/types.d.ts +24 -8
- package/dist/esm/components/FieldSelect/utils/customOption.d.ts +20 -0
- package/dist/esm/components/FieldSelect/utils/customOption.js +41 -0
- package/dist/esm/components/FieldSelect/utils/extract.d.ts +11 -0
- package/dist/esm/components/FieldSelect/utils/extract.js +34 -0
- package/dist/esm/components/FieldSelect/utils/filter.d.ts +3 -0
- package/dist/esm/components/FieldSelect/utils/filter.js +36 -0
- package/dist/esm/components/FieldSelect/utils/index.d.ts +6 -0
- package/dist/esm/components/FieldSelect/utils/index.js +6 -0
- package/dist/esm/components/FieldSelect/utils/items.d.ts +9 -0
- package/dist/esm/components/FieldSelect/utils/items.js +41 -0
- package/dist/esm/components/FieldSelect/utils/selection.d.ts +11 -0
- package/dist/esm/components/FieldSelect/utils/selection.js +14 -0
- package/dist/esm/components/FieldSelect/utils/tagSize.d.ts +4 -0
- package/dist/esm/components/FieldSelect/utils/tagSize.js +2 -0
- package/dist/tsconfig.cjs.tsbuildinfo +1 -1
- package/dist/tsconfig.esm.tsbuildinfo +1 -1
- package/package.json +20 -20
- package/src/components/FieldSelect/FieldSelect.tsx +190 -82
- package/src/components/FieldSelect/constants.ts +36 -0
- package/src/components/FieldSelect/hooks.ts +170 -0
- package/src/components/FieldSelect/types.ts +80 -53
- package/src/components/FieldSelect/utils/customOption.ts +69 -0
- package/src/components/FieldSelect/utils/extract.ts +49 -0
- package/src/components/FieldSelect/utils/filter.ts +51 -0
- package/src/components/FieldSelect/utils/index.ts +6 -0
- package/src/components/FieldSelect/utils/items.ts +58 -0
- package/src/components/FieldSelect/utils/selection.ts +25 -0
- package/src/components/FieldSelect/utils/tagSize.ts +5 -0
- package/dist/cjs/components/FieldSelect/utils.d.ts +0 -19
- package/dist/cjs/components/FieldSelect/utils.js +0 -103
- package/dist/esm/components/FieldSelect/utils.d.ts +0 -19
- package/dist/esm/components/FieldSelect/utils.js +0 -92
- package/src/components/FieldSelect/utils.ts +0 -132
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { FieldSelectAddCustomOptionTrigger, FieldSelectMultipleAddCustomOptionTrigger } from '../types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Сопоставляет клавишу с триггером кастомной опции (`enter` / `space` / `comma`).
|
|
4
|
+
* Сначала `KeyboardEvent.code`, затем `key` — если `code` пустой или не из словаря (`','` без `Comma`).
|
|
5
|
+
*/
|
|
6
|
+
export declare function getCustomOptionTriggerByKey(key: string): FieldSelectMultipleAddCustomOptionTrigger | undefined;
|
|
7
|
+
export declare function shouldHandleCustomOptionTrigger(trigger: FieldSelectAddCustomOptionTrigger | undefined, availableTriggers: readonly FieldSelectAddCustomOptionTrigger[]): trigger is FieldSelectAddCustomOptionTrigger;
|
|
8
|
+
export declare function resolveAddCustomOptionTriggers(params: {
|
|
9
|
+
allowCustomOption: boolean;
|
|
10
|
+
addCustomOptionTriggers: readonly FieldSelectAddCustomOptionTrigger[] | undefined;
|
|
11
|
+
multiple?: boolean;
|
|
12
|
+
}): readonly FieldSelectAddCustomOptionTrigger[];
|
|
13
|
+
/** Фокус ушёл на дроплист, футер или postfix — кастомную опцию на blur фиксировать не нужно. */
|
|
14
|
+
export declare function isCustomOptionBlurInsideField(relatedTarget: EventTarget | null, nodes: (Node | null | undefined)[]): boolean;
|
|
15
|
+
/** Клик снаружи закрывает список, не снимая фокус с input — blur не придёт. */
|
|
16
|
+
export declare function shouldCommitCustomOptionOnClose(params: {
|
|
17
|
+
skip: boolean;
|
|
18
|
+
inputElement: Element | null;
|
|
19
|
+
activeElement: Element | null;
|
|
20
|
+
}): boolean;
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { ADD_CUSTOM_OPTION_TRIGGER, ADD_CUSTOM_OPTION_TRIGGERS_MULTIPLE_ALLOWED, ADD_CUSTOM_OPTION_TRIGGERS_MULTIPLE_DEFAULT, ADD_CUSTOM_OPTION_TRIGGERS_SINGLE_ALLOWED, ADD_CUSTOM_OPTION_TRIGGERS_SINGLE_DEFAULT, } from '../constants.js';
|
|
2
|
+
/**
|
|
3
|
+
* Сопоставляет клавишу с триггером кастомной опции (`enter` / `space` / `comma`).
|
|
4
|
+
* Сначала `KeyboardEvent.code`, затем `key` — если `code` пустой или не из словаря (`','` без `Comma`).
|
|
5
|
+
*/
|
|
6
|
+
export function getCustomOptionTriggerByKey(key) {
|
|
7
|
+
switch (key) {
|
|
8
|
+
case 'Enter':
|
|
9
|
+
return ADD_CUSTOM_OPTION_TRIGGER.Enter;
|
|
10
|
+
case ' ':
|
|
11
|
+
return ADD_CUSTOM_OPTION_TRIGGER.Space;
|
|
12
|
+
case ',':
|
|
13
|
+
return ADD_CUSTOM_OPTION_TRIGGER.Comma;
|
|
14
|
+
default:
|
|
15
|
+
return undefined;
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
export function shouldHandleCustomOptionTrigger(trigger, availableTriggers) {
|
|
19
|
+
return trigger !== undefined && availableTriggers.includes(trigger);
|
|
20
|
+
}
|
|
21
|
+
export function resolveAddCustomOptionTriggers(params) {
|
|
22
|
+
if (params.allowCustomOption) {
|
|
23
|
+
const defaultTriggers = params.multiple
|
|
24
|
+
? ADD_CUSTOM_OPTION_TRIGGERS_MULTIPLE_DEFAULT
|
|
25
|
+
: ADD_CUSTOM_OPTION_TRIGGERS_SINGLE_DEFAULT;
|
|
26
|
+
const allowedTriggers = params.multiple
|
|
27
|
+
? ADD_CUSTOM_OPTION_TRIGGERS_MULTIPLE_ALLOWED
|
|
28
|
+
: ADD_CUSTOM_OPTION_TRIGGERS_SINGLE_ALLOWED;
|
|
29
|
+
const availableTriggers = params.addCustomOptionTriggers ?? defaultTriggers;
|
|
30
|
+
return availableTriggers.filter(trigger => allowedTriggers.includes(trigger));
|
|
31
|
+
}
|
|
32
|
+
return [];
|
|
33
|
+
}
|
|
34
|
+
/** Фокус ушёл на дроплист, футер или postfix — кастомную опцию на blur фиксировать не нужно. */
|
|
35
|
+
export function isCustomOptionBlurInsideField(relatedTarget, nodes) {
|
|
36
|
+
return relatedTarget instanceof Node && nodes.some(node => Boolean(node?.contains(relatedTarget)));
|
|
37
|
+
}
|
|
38
|
+
/** Клик снаружи закрывает список, не снимая фокус с input — blur не придёт. */
|
|
39
|
+
export function shouldCommitCustomOptionOnClose(params) {
|
|
40
|
+
return !params.skip && params.activeElement !== null && params.activeElement === params.inputElement;
|
|
41
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { ItemId } from '@cloud-ru/ds-list';
|
|
2
|
+
import { Appearance as TagAppearance } from '@cloud-ru/ds-tag';
|
|
3
|
+
export type WithIdContent = {
|
|
4
|
+
id?: ItemId;
|
|
5
|
+
content?: unknown;
|
|
6
|
+
disabled?: boolean;
|
|
7
|
+
appearance?: TagAppearance;
|
|
8
|
+
};
|
|
9
|
+
export declare function extractLabel(item: WithIdContent): string;
|
|
10
|
+
export declare function extractSearchText(item: WithIdContent): string;
|
|
11
|
+
export declare function extractAppearance(item?: WithIdContent): TagAppearance | undefined;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
export function extractLabel(item) {
|
|
2
|
+
const { content, id } = item;
|
|
3
|
+
if (!content) {
|
|
4
|
+
return String(id ?? '');
|
|
5
|
+
}
|
|
6
|
+
if (typeof content === 'string' || typeof content === 'number') {
|
|
7
|
+
return String(content);
|
|
8
|
+
}
|
|
9
|
+
if (typeof content === 'object' && content !== null && 'label' in content) {
|
|
10
|
+
return String(content.label);
|
|
11
|
+
}
|
|
12
|
+
return String(id ?? '');
|
|
13
|
+
}
|
|
14
|
+
// Текст для поиска: лейбл (option) + caption + description — паритет с легаси `useSearch`,
|
|
15
|
+
// который матчил запрос по всем трём полям контента, а не только по лейблу.
|
|
16
|
+
export function extractSearchText(item) {
|
|
17
|
+
const parts = [extractLabel(item)];
|
|
18
|
+
const { content } = item;
|
|
19
|
+
if (content && typeof content === 'object') {
|
|
20
|
+
const c = content;
|
|
21
|
+
if (typeof c.caption === 'string') {
|
|
22
|
+
parts.push(c.caption);
|
|
23
|
+
}
|
|
24
|
+
if (typeof c.description === 'string') {
|
|
25
|
+
parts.push(c.description);
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
return parts.join(' ');
|
|
29
|
+
}
|
|
30
|
+
// Цвет тега выбранного значения (multiple) — паритет с легаси `option.appearance`.
|
|
31
|
+
// Проверка типа нужна и при типизированном поле: items часто приходят из ответа бэкенда.
|
|
32
|
+
export function extractAppearance(item) {
|
|
33
|
+
return typeof item?.appearance === 'string' ? item.appearance : undefined;
|
|
34
|
+
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { extractSearchText } from './extract.js';
|
|
2
|
+
// Subsequence-fuzzy: символы запроса должны встречаться в строке в исходном порядке.
|
|
3
|
+
// Пример: query=`lge` matches `Large` (L → r → arg → e).
|
|
4
|
+
export function isFuzzyMatch(haystack, needle) {
|
|
5
|
+
if (!needle) {
|
|
6
|
+
return true;
|
|
7
|
+
}
|
|
8
|
+
let i = 0;
|
|
9
|
+
for (const ch of haystack) {
|
|
10
|
+
if (ch === needle[i]) {
|
|
11
|
+
i += 1;
|
|
12
|
+
if (i === needle.length) {
|
|
13
|
+
return true;
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
return false;
|
|
18
|
+
}
|
|
19
|
+
export function filterItems(items, query, fuzzy) {
|
|
20
|
+
if (!query) {
|
|
21
|
+
return items;
|
|
22
|
+
}
|
|
23
|
+
const q = query.toLowerCase();
|
|
24
|
+
const matches = (item) => {
|
|
25
|
+
const text = extractSearchText(item).toLowerCase();
|
|
26
|
+
return fuzzy ? isFuzzyMatch(text, q) : text.includes(q);
|
|
27
|
+
};
|
|
28
|
+
const walk = (list) => list.flatMap(item => {
|
|
29
|
+
if ('items' in item && Array.isArray(item.items)) {
|
|
30
|
+
const filteredChildren = walk(item.items);
|
|
31
|
+
return filteredChildren.length > 0 ? [{ ...item, items: filteredChildren }] : [];
|
|
32
|
+
}
|
|
33
|
+
return matches(item) ? [item] : [];
|
|
34
|
+
});
|
|
35
|
+
return walk(items);
|
|
36
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { ItemId } from '@cloud-ru/ds-list';
|
|
2
|
+
import { FieldSelectItem } from '../types.js';
|
|
3
|
+
import { WithIdContent } from './extract.js';
|
|
4
|
+
export declare function flatten(items: FieldSelectItem[]): WithIdContent[];
|
|
5
|
+
export declare function findItem(items: FieldSelectItem[], id: ItemId): WithIdContent | undefined;
|
|
6
|
+
/** Айтем для выбранного значения, которого нет в `items` (кастомная опция, ленивая подгрузка). */
|
|
7
|
+
export declare function createPlaceholderItem(id: ItemId): FieldSelectItem;
|
|
8
|
+
/** Выбранные id, которых нет в дереве айтемов — в дроплист их нужно добавить отдельно. */
|
|
9
|
+
export declare function getMissingSelectedItems(selectedIds: ItemId[], allItems: FieldSelectItem[]): FieldSelectItem[];
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
export function flatten(items) {
|
|
2
|
+
const out = [];
|
|
3
|
+
for (const item of items) {
|
|
4
|
+
out.push(item);
|
|
5
|
+
if ('items' in item && Array.isArray(item.items)) {
|
|
6
|
+
out.push(...flatten(item.items));
|
|
7
|
+
}
|
|
8
|
+
}
|
|
9
|
+
return out;
|
|
10
|
+
}
|
|
11
|
+
export function findItem(items, id) {
|
|
12
|
+
for (const item of flatten(items)) {
|
|
13
|
+
if (item.id === id) {
|
|
14
|
+
return item;
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
return undefined;
|
|
18
|
+
}
|
|
19
|
+
/** Айтем для выбранного значения, которого нет в `items` (кастомная опция, ленивая подгрузка). */
|
|
20
|
+
export function createPlaceholderItem(id) {
|
|
21
|
+
return { id, content: { label: String(id) } };
|
|
22
|
+
}
|
|
23
|
+
/** Выбранные id, которых нет в дереве айтемов — в дроплист их нужно добавить отдельно. */
|
|
24
|
+
export function getMissingSelectedItems(selectedIds, allItems) {
|
|
25
|
+
if (selectedIds.length === 0) {
|
|
26
|
+
return [];
|
|
27
|
+
}
|
|
28
|
+
const existingIds = new Set();
|
|
29
|
+
for (const item of flatten(allItems)) {
|
|
30
|
+
if (item.id !== undefined) {
|
|
31
|
+
existingIds.add(item.id);
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
const missing = [];
|
|
35
|
+
for (const id of selectedIds) {
|
|
36
|
+
if (id !== '' && !existingIds.has(id)) {
|
|
37
|
+
missing.push(createPlaceholderItem(id));
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
return missing;
|
|
41
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { ItemId } from '@cloud-ru/ds-list';
|
|
2
|
+
import { FieldSelectMultipleProps, Selection } from '../types.js';
|
|
3
|
+
export declare function isMultiple(props: {
|
|
4
|
+
selection?: Selection;
|
|
5
|
+
}): props is FieldSelectMultipleProps;
|
|
6
|
+
/** Выбранные id в нормализованном виде: массив и для `single`, и для `multiple`. */
|
|
7
|
+
export declare function getSelectedIds(params: {
|
|
8
|
+
multiple: boolean;
|
|
9
|
+
multipleValue: ItemId[];
|
|
10
|
+
singleValue: ItemId | undefined;
|
|
11
|
+
}): ItemId[];
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { SELECTION_MODE } from '../constants.js';
|
|
2
|
+
export function isMultiple(props) {
|
|
3
|
+
return props.selection === SELECTION_MODE.Multiple;
|
|
4
|
+
}
|
|
5
|
+
/** Выбранные id в нормализованном виде: массив и для `single`, и для `multiple`. */
|
|
6
|
+
export function getSelectedIds(params) {
|
|
7
|
+
if (params.multiple) {
|
|
8
|
+
return params.multipleValue;
|
|
9
|
+
}
|
|
10
|
+
if (params.singleValue === undefined) {
|
|
11
|
+
return [];
|
|
12
|
+
}
|
|
13
|
+
return [params.singleValue];
|
|
14
|
+
}
|