@evergis/react 4.0.74 → 4.0.78

package/dist/components/Dashboard/containers/FiltersContainer/components/TreeFilter.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+import { WidgetFilterProps } from '../types';
+export declare const TreeFilter: FC<WidgetFilterProps>;

package/dist/components/Dashboard/containers/FiltersContainer/hooks/useTreeFilter.d.ts

@@ -0,0 +1,23 @@
+import { ConfigContainerChild, WidgetType } from '../../../types';
+export declare const useTreeFilter: (type: WidgetType, filter: ConfigContainerChild) => {
+    width: string;
+    placeholder: string;
+    multiSelect: boolean;
+    loading: boolean;
+    data: import('@evergis/uilib-gl').TreeItemProps[];
+    setData: import('react').Dispatch<import('react').SetStateAction<import('@evergis/uilib-gl').TreeItemProps[]>>;
+    expanded: import('@evergis/uilib-gl').TreeId[];
+    setExpanded: import('react').Dispatch<import('react').SetStateAction<import('@evergis/uilib-gl').TreeId[]>>;
+    onLoadChildren: (item: import('@evergis/uilib-gl').TreeItemProps) => Promise<import('@evergis/uilib-gl').PartialLoadData<import('../types').TreeNodeData>>;
+    selectedIds: Set<import('@evergis/uilib-gl').TreeId>;
+    selectedCount: number;
+    selectedLabel: string;
+    searchValue: string;
+    onSearchChange: (value: string) => void;
+    onOpen: () => Promise<void>;
+    onClose: () => void;
+    onToggleSelect: (item: any) => void;
+    onReset: () => void;
+    onSave: () => void;
+    dirty: boolean;
+};

package/dist/components/Dashboard/containers/FiltersContainer/hooks/useTreeFilterData.d.ts

@@ -0,0 +1,12 @@
+import { PartialLoadData, TreeId, TreeItemProps } from '@evergis/uilib-gl';
+import { WidgetType } from '../../../types';
+import { TreeNodeData } from '../types';
+export declare const useTreeFilterData: (type: WidgetType, filterName: string) => {
+    configFilter: import('../../../types').ConfigFilter;
+    layerName: string;
+    loadLevelOne: () => Promise<TreeItemProps[]>;
+    loadChildren: (item: TreeItemProps) => Promise<PartialLoadData<TreeNodeData>>;
+    searchNodes: (query: string) => Promise<TreeItemProps[]>;
+    loadByNames: (names: TreeId[]) => Promise<TreeItemProps[]>;
+    loadByValues: (values: TreeId[]) => Promise<TreeItemProps[]>;
+};

package/dist/components/Dashboard/containers/FiltersContainer/hooks/useTreeFilterSearch.d.ts

@@ -0,0 +1,17 @@
+import { TreeId, TreeItemProps } from '@evergis/uilib-gl';
+type UseTreeFilterSearchParams = {
+    searchNodes: (query: string) => Promise<TreeItemProps[]>;
+    loadByNames: (names: TreeId[]) => Promise<TreeItemProps[]>;
+};
+export declare const useTreeFilterSearch: ({ searchNodes, loadByNames }: UseTreeFilterSearchParams) => {
+    searchValue: string;
+    isSearchActive: boolean;
+    searching: boolean;
+    searchData: TreeItemProps[];
+    setSearchData: import('react').Dispatch<import('react').SetStateAction<TreeItemProps[]>>;
+    searchExpanded: TreeId[];
+    setSearchExpanded: import('react').Dispatch<import('react').SetStateAction<TreeId[]>>;
+    onSearchChange: (value: string) => void;
+    resetSearch: () => void;
+};
+export {};

package/dist/components/Dashboard/containers/FiltersContainer/hooks/useTreeFilterSelection.d.ts

@@ -0,0 +1,11 @@
+import { TreeId, TreeItemProps } from '@evergis/uilib-gl';
+import { ConfigFilter, WidgetType } from '../../../types';
+export declare const useTreeFilterSelection: (type: WidgetType, filterName: string, configFilter?: ConfigFilter) => {
+    selected: Map<TreeId, number>;
+    selectedIds: Set<TreeId>;
+    selectedLabel: string;
+    dirty: boolean;
+    onToggleSelect: (item: TreeItemProps, multiSelect?: boolean) => void;
+    onReset: () => void;
+    onSave: () => void;
+};

package/dist/components/Dashboard/containers/FiltersContainer/hooks/useTreeFilterTree.d.ts

@@ -0,0 +1,16 @@
+import { TreeId, TreeItemProps } from '@evergis/uilib-gl';
+type UseTreeFilterTreeParams = {
+    selected: Map<TreeId, number>;
+    loadLevelOne: () => Promise<TreeItemProps[]>;
+    loadByValues: (values: TreeId[]) => Promise<TreeItemProps[]>;
+    loadByNames: (names: TreeId[]) => Promise<TreeItemProps[]>;
+};
+export declare const useTreeFilterTree: ({ selected, loadLevelOne, loadByValues, loadByNames }: UseTreeFilterTreeParams) => {
+    treeData: TreeItemProps[];
+    setTreeData: import('react').Dispatch<import('react').SetStateAction<TreeItemProps[]>>;
+    treeExpanded: TreeId[];
+    setTreeExpanded: import('react').Dispatch<import('react').SetStateAction<TreeId[]>>;
+    loading: boolean;
+    onOpen: () => Promise<void>;
+};
+export {};

package/dist/components/Dashboard/containers/FiltersContainer/types.d.ts

@@ -1,3 +1,4 @@
+import { TreeId } from '@evergis/uilib-gl';
 import { ConfigContainer, ConfigContainerChild, WidgetType } from '../../types';
 export type FilterOption = {
     text: string;
@@ -5,6 +6,16 @@ export type FilterOption = {
     min: string | number;
     max: string | number;
 };
+/**
+ * Доменные данные узла иерархического фильтра "tree", хранятся в `TreeItemProps.data`.
+ * `name`/`parentName` — служебная связь дерева (по `attributeName`/`attributeParentName`);
+ * идентичность/значение узла лежит в `TreeItemProps.id` (по `attributeValue`).
+ */
+export type TreeNodeData = {
+    name: TreeId;
+    parentName: TreeId | null;
+    level: number;
+};
 export type WidgetFilterProps = {
     type: WidgetType;
     filter: ConfigContainerChild;

package/dist/components/Dashboard/containers/FiltersContainer/utils/treeFilterUtils.d.ts

@@ -0,0 +1,30 @@
+import { TreeId, TreeItemProps } from '@evergis/uilib-gl';
+import { TreeFilterValue } from '../../../types';
+export declare const buildLevelOneCondition: (attributeLevel: string) => string;
+export declare const buildChildrenCondition: (attributeParentName: string, parentName: TreeId) => string;
+export declare const buildSearchCondition: (attributeAlias: string, query: string) => string;
+/** Запрос пачки записей по их именам (`attributeName`) — для достройки предков. */
+export declare const buildNamesCondition: (attributeName: string, names: Array<string | number>) => string;
+/** Запрос пачки записей по их значениям (`attributeValue`) — для восстановления `defaultValue`. */
+export declare const buildValuesCondition: (attributeValue: string, values: Array<string | number>) => string;
+/** Группирует выбранные id по уровню в объектное значение фильтра `{ l{N}: [ids] }`. */
+export declare const buildFilterValue: (selected: Map<TreeId, number>) => TreeFilterValue;
+/** Разбирает объектное значение фильтра в карту `id → level`. */
+export declare const parseFilterValue: (value?: TreeFilterValue) => Map<TreeId, number>;
+/** Стабильная сериализация выбора для сравнения (порядок не важен). */
+export declare const serializeSelection: (selected: Map<TreeId, number>) => string;
+/**
+ * Дозапрашивает цепочку предков вверх по `parentName` уровень за уровнем (батч `attributeName in
+ * (...)`), пока не достигнет уровня 1. Связь идёт по именам (`name`/`parentName`), т.к. `node.id`
+ * хранит значение (`attributeValue`). Возвращает исходные узлы вместе с предками.
+ */
+export declare const collectAncestors: (nodes: TreeItemProps[], loadByNames: (names: TreeId[]) => Promise<TreeItemProps[]>) => Promise<TreeItemProps[]>;
+/**
+ * Собирает плоский набор узлов в дерево по связи `parentName` ↔ `name`. Узлы с подгруженными
+ * потомками раскрываются (`expanded` хранит `node.id` = значение); листья-папки без потомков
+ * получают `children = null` (ленивая подгрузка).
+ */
+export declare const assembleTree: (nodes: TreeItemProps[]) => {
+    roots: TreeItemProps[];
+    expanded: TreeId[];
+};

package/dist/components/Dashboard/types.d.ts

@@ -326,9 +326,24 @@ export interface ConfigFilter {
     relatedDataSource?: string;
     defaultValue?: SelectedFilter["value"];
     attributeAlias?: string;
+    /**
+     * Атрибут хранимого значения фильтра — то, что фильтр отдаёт потребителям (плейсхолдеры
+     * `%name`, для "tree" — `%name.lN`). Для "tree" служит ещё и идентичностью узла дерева
+     * (`TreeItemProps.id`). Если не задан — фолбэк на {@link ConfigFilter.attributeName}.
+     */
     attributeValue?: string;
     attributeMin?: string;
     attributeMax?: string;
+    /** Атрибут-имя записи — служебная связь дерева (`child.attributeParentName == parent.attributeName`); для "tree". */
+    attributeName?: string;
+    /** Атрибут-имя родителя — служебная связь дерева; для "tree". */
+    attributeParentName?: string;
+    /** Атрибут числового уровня (корень = 1) — для "tree". */
+    attributeLevel?: string;
+    /** Атрибут-флаг наличия детей (показ шеврона) — для "tree". */
+    attributeHasChildren?: string;
+    /** Единый лимит на запросы дерева (дети уровня, поиск) — для "tree". */
+    limit?: number;
     valueType?: ConfigFilterValueType;
     resetFilters?: string[];
 }
@@ -345,11 +360,19 @@ export interface ChipOption {
     color?: string;
     icon?: string;
 }
+/**
+ * Значение иерархического фильтра "tree": объект «уровень → массив id».
+ * Ключи вида `l{N}` (l1, l3, ...); уровни без выбранных элементов не включаются.
+ * Пример: `{ l1: [1, 2], l3: [1023] }`.
+ */
+export type TreeFilterValue = Record<string, Array<string | number>>;
 export interface SelectedFilter {
-    value: string | number | string[] | number[] | Date | Date[];
+    value: string | number | string[] | number[] | Date | Date[] | TreeFilterValue;
     min?: string | number | Date;
     max?: string | number | Date;
 }
+/** Значение фильтра без объектного варианта "tree" — для скалярных/массивных фильтров. */
+export type ScalarFilterValue = Exclude<SelectedFilter["value"], TreeFilterValue>;
 export interface ConfigLayer {
     name: string;
     opacity?: number;
@@ -412,7 +435,7 @@ export interface ConfigContainer {
     options?: ConfigOptions;
     header?: ConfigContainerHeader;
 }
-export type FilterType = "checkbox" | "rangeNumber" | "rangeDate" | "text" | "dropdown" | "barChart" | "chips";
+export type FilterType = "checkbox" | "rangeNumber" | "rangeDate" | "text" | "dropdown" | "barChart" | "chips" | "tree";
 /**
  * Литеральный union значений {@link ConfigContainerChild.type}.
  *

package/dist/components/Dashboard/utils/applyTreeFilterToCondition.d.ts

@@ -0,0 +1,12 @@
+import { SelectedFilter, TreeFilterValue } from '../types';
+/**
+ * Объектное значение иерархического фильтра "tree" («уровень → массив id»),
+ * в отличие от скалярных/массивных значений остальных фильтров.
+ */
+export declare const isTreeFilterValue: (value?: SelectedFilter["value"]) => value is TreeFilterValue;
+/**
+ * Подставляет плейсхолдеры уровней `%name.l{N}` значениями id соответствующего уровня
+ * (формат `[id1,id2,...]` для оператора IN). Уровни, отсутствующие в значении (или пустые),
+ * не подставляются — плейсхолдер остаётся нетронутым, как и любой пустой `%`-плейсхолдер.
+ */
+export declare const applyTreeFilterToCondition: (condition: string, name: string, value: TreeFilterValue, isSingle?: boolean) => string;

package/dist/components/Dashboard/utils/getSelectedFilterValue.d.ts

@@ -1,2 +1,2 @@
 import { SelectedFilter, SelectedFilters } from '../types';
-export declare const getSelectedFilterValue: (filterName: string, selectedFilters: SelectedFilters, defaultValue: SelectedFilter["value"]) => string | number | Date | (string | number | Date)[];
+export declare const getSelectedFilterValue: (filterName: string, selectedFilters: SelectedFilters, defaultValue: SelectedFilter["value"]) => string | number | Date | import('../types').TreeFilterValue | (string | number | Date | import('../types').TreeFilterValue)[];

package/dist/components/Dashboard/utils/index.d.ts

@@ -5,6 +5,7 @@ export * from './checkEqualOrIncludes';
 export * from './checkIsLoading';
 export * from './createConfigLayer';
 export * from './createConfigPage';
+export * from './applyTreeFilterToCondition';
 export * from './createNewPageId';
 export * from './eqlParametersToPayload';
 export * from './formatChartRelatedValue';