@evergis/react 4.0.58 → 4.0.61

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/branded.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Branded types для entity-id.
+ *
+ * Идея — TS-only бренд на строку, чтобы `ChartId`, `ModalId`, `TabId`, ... были
+ * несовместимы между собой на этапе компиляции (`findChart(modalId)` → ошибка),
+ * при этом в runtime оставались обычными строками (JSON/Redux/fetch совместимы).
+ *
+ * Slot-id (`"alias" | "chart" | "legend" | ...`) **не покрываются** этим модулем — это
+ * литералы фиксированного набора, типизируются через сужение `id` в parent-specific
+ * child-типах.
+ *
+ * Использование:
+ * ```ts
+ * import { ChartId, asChartId } from "@evergis/react";
+ *
+ * // на границе deserialize: cast через конструктор
+ * const id = asChartId("chart-1");        // ChartId
+ *
+ * function findChart(id: ChartId): Chart | undefined { ... }
+ *
+ * findChart(id);                          // ✓
+ * findChart("chart-1");                   // ❌ TS error — string не подставится в ChartId
+ * findChart(modalId);                     // ❌ TS error — ModalId ≠ ChartId
+ * ```
+ *
+ * Иерархия: `ChartId`/`ModalId`/`TabId` — подтипы `ContainerId` (один runtime-keyspace,
+ * `ConfigContainer.id`). `LayerName`/`FilterName`/`AttributeName`/`DataSourceName`/`ResourceId`
+ * — независимые бренды.
+ */
+declare const brand: unique symbol;
+export type Brand<T, B extends string> = T & {
+    readonly [brand]: B;
+};
+export type ContainerId = Brand<string, "ContainerId">;
+export type ChartId = ContainerId & Brand<string, "ChartId">;
+export type ModalId = ContainerId & Brand<string, "ModalId">;
+export type TabId = ContainerId & Brand<string, "TabId">;
+export type FilterName = Brand<string, "FilterName">;
+export type LayerName = Brand<string, "LayerName">;
+export type AttributeName = Brand<string, "AttributeName">;
+export type DataSourceName = Brand<string, "DataSourceName">;
+export type ResourceId = Brand<string, "ResourceId">;
+export declare const asContainerId: (value: string) => ContainerId;
+export declare const asChartId: (value: string) => ChartId;
+export declare const asModalId: (value: string) => ModalId;
+export declare const asTabId: (value: string) => TabId;
+export declare const asFilterName: (value: string) => FilterName;
+export declare const asLayerName: (value: string) => LayerName;
+export declare const asAttributeName: (value: string) => AttributeName;
+export declare const asDataSourceName: (value: string) => DataSourceName;
+export declare const asResourceId: (value: string) => ResourceId;
+export {};