@evergis/react 4.0.76 → 4.0.79

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Everpoint
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Everpoint
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,7 +1,7 @@
-# @evergis/react
-
-В данном репозитории находятся специфичные (в отличии от `@evergis/uilib-gl`) для `Evergis Online`,
-но в целом переиспользуемые на других проектах, построенных на Evergis API, React-компоненты.
-
-***ВАЖНО!!!***: Разрабатываемые компоненты не должны иметь зависимостей
-от системы поддержки мультиязычности `Evergis Online`!
+# @evergis/react
+
+В данном репозитории находятся специфичные (в отличии от `@evergis/uilib-gl`) для `Evergis Online`,
+но в целом переиспользуемые на других проектах, построенных на Evergis API, React-компоненты.
+
+***ВАЖНО!!!***: Разрабатываемые компоненты не должны иметь зависимостей
+от системы поддержки мультиязычности `Evergis Online`!

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

@@ -18,4 +18,6 @@ export declare const useTreeFilter: (type: WidgetType, filter: ConfigContainerCh
     onClose: () => void;
     onToggleSelect: (item: any) => void;
     onReset: () => void;
+    onSave: () => void;
+    dirty: boolean;
 };

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

@@ -7,5 +7,6 @@ export declare const useTreeFilterData: (type: WidgetType, filterName: string) =
     loadLevelOne: () => Promise<TreeItemProps[]>;
     loadChildren: (item: TreeItemProps) => Promise<PartialLoadData<TreeNodeData>>;
     searchNodes: (query: string) => Promise<TreeItemProps[]>;
-    loadByIds: (ids: TreeId[]) => Promise<TreeItemProps[]>;
+    loadByNames: (names: TreeId[]) => Promise<TreeItemProps[]>;
+    loadByValues: (values: TreeId[]) => Promise<TreeItemProps[]>;
 };

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

@@ -1,9 +1,9 @@
 import { TreeId, TreeItemProps } from '@evergis/uilib-gl';
 type UseTreeFilterSearchParams = {
     searchNodes: (query: string) => Promise<TreeItemProps[]>;
-    loadByIds: (ids: TreeId[]) => Promise<TreeItemProps[]>;
+    loadByNames: (names: TreeId[]) => Promise<TreeItemProps[]>;
 };
-export declare const useTreeFilterSearch: ({ searchNodes, loadByIds }: UseTreeFilterSearchParams) => {
+export declare const useTreeFilterSearch: ({ searchNodes, loadByNames }: UseTreeFilterSearchParams) => {
     searchValue: string;
     isSearchActive: boolean;
     searching: boolean;

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

@@ -4,6 +4,8 @@ export declare const useTreeFilterSelection: (type: WidgetType, filterName: stri
     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

@@ -2,9 +2,10 @@ import { TreeId, TreeItemProps } from '@evergis/uilib-gl';
 type UseTreeFilterTreeParams = {
     selected: Map<TreeId, number>;
     loadLevelOne: () => Promise<TreeItemProps[]>;
-    loadByIds: (ids: TreeId[]) => Promise<TreeItemProps[]>;
+    loadByValues: (values: TreeId[]) => Promise<TreeItemProps[]>;
+    loadByNames: (names: TreeId[]) => Promise<TreeItemProps[]>;
 };
-export declare const useTreeFilterTree: ({ selected, loadLevelOne, loadByIds }: UseTreeFilterTreeParams) => {
+export declare const useTreeFilterTree: ({ selected, loadLevelOne, loadByValues, loadByNames }: UseTreeFilterTreeParams) => {
     treeData: TreeItemProps[];
     setTreeData: import('react').Dispatch<import('react').SetStateAction<TreeItemProps[]>>;
     treeExpanded: TreeId[];

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

@@ -6,9 +6,14 @@ export type FilterOption = {
     min: string | number;
     max: string | number;
 };
-/** Доменные данные узла иерархического фильтра "tree", хранятся в `TreeItemProps.data`. */
+/**
+ * Доменные данные узла иерархического фильтра "tree", хранятся в `TreeItemProps.data`.
+ * `name`/`parentName` — служебная связь дерева (по `attributeName`/`attributeParentName`);
+ * идентичность/значение узла лежит в `TreeItemProps.id` (по `attributeValue`).
+ */
 export type TreeNodeData = {
-    parentId: TreeId | null;
+    name: TreeId;
+    parentName: TreeId | null;
     level: number;
 };
 export type WidgetFilterProps = {

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

@@ -1,9 +1,12 @@
 import { TreeId, TreeItemProps } from '@evergis/uilib-gl';
 import { TreeFilterValue } from '../../../types';
 export declare const buildLevelOneCondition: (attributeLevel: string) => string;
-export declare const buildChildrenCondition: (attributeParentValue: string, parentId: TreeId) => string;
+export declare const buildChildrenCondition: (attributeParentName: string, parentName: TreeId) => string;
 export declare const buildSearchCondition: (attributeAlias: string, query: string) => string;
-export declare const buildIdsCondition: (attributeValue: string, ids: Array<string | number>) => 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`. */
@@ -11,13 +14,15 @@ export declare const parseFilterValue: (value?: TreeFilterValue) => Map<TreeId,
 /** Стабильная сериализация выбора для сравнения (порядок не важен). */
 export declare const serializeSelection: (selected: Map<TreeId, number>) => string;
 /**
- * Дозапрашивает цепочку предков вверх по `parentId` уровень за уровнем (батч `id in (...)`),
- * пока не достигнет уровня 1. Возвращает исходные узлы вместе с предками.
+ * Дозапрашивает цепочку предков вверх по `parentName` уровень за уровнем (батч `attributeName in
+ * (...)`), пока не достигнет уровня 1. Связь идёт по именам (`name`/`parentName`), т.к. `node.id`
+ * хранит значение (`attributeValue`). Возвращает исходные узлы вместе с предками.
  */
-export declare const collectAncestors: (nodes: TreeItemProps[], loadByIds: (ids: TreeId[]) => Promise<TreeItemProps[]>) => Promise<TreeItemProps[]>;
+export declare const collectAncestors: (nodes: TreeItemProps[], loadByNames: (names: TreeId[]) => Promise<TreeItemProps[]>) => Promise<TreeItemProps[]>;
 /**
- * Собирает плоский набор узлов в дерево по `parentId`. Узлы с подгруженными потомками
- * раскрываются; листья-папки без потомков получают `children = null` (ленивая подгрузка).
+ * Собирает плоский набор узлов в дерево по связи `parentName` ↔ `name`. Узлы с подгруженными
+ * потомками раскрываются (`expanded` хранит `node.id` = значение); листья-папки без потомков
+ * получают `children = null` (ленивая подгрузка).
  */
 export declare const assembleTree: (nodes: TreeItemProps[]) => {
     roots: TreeItemProps[];

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

@@ -326,11 +326,18 @@ 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;
-    /** Атрибут id родителя — для иерархического фильтра "tree". */
-    attributeParentValue?: string;
+    /** Атрибут-имя записи — служебная связь дерева (`child.attributeParentName == parent.attributeName`); для "tree". */
+    attributeName?: string;
+    /** Атрибут-имя родителя — служебная связь дерева; для "tree". */
+    attributeParentName?: string;
     /** Атрибут числового уровня (корень = 1) — для "tree". */
     attributeLevel?: string;
     /** Атрибут-флаг наличия детей (показ шеврона) — для "tree". */