@evergis/react 3.1.101 → 3.1.103

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

@@ -9,4 +9,5 @@ export interface LayerProps {
     beforeId?: string;
     getLayerTempStyle?: ((layerName: string, type: ClientStyleItem["type"]) => Pick<ClientStyleItem, "layout" | "paint"> & Pick<ClientStyle, "settings">);
     onMount?: EffectCallback;
+    filterVersion?: string;
 }

package/dist/components/Layer/utils/getClientStyleItemPrefixSuffix.d.ts

@@ -1,3 +1,3 @@
 import { GeometryType } from '@evergis/api';
 import { ClientStyleItem } from '../../../types';
-export declare const getClientStyleItemPrefixSuffix: (geometryType: GeometryType, type: ClientStyleItem["type"]) => [string, string];
+export declare const getClientStyleItemPrefixSuffix: (geometryType: GeometryType, itemType: ClientStyleItem["type"]) => [string, string];

package/dist/core/icons/index.d.ts

@@ -0,0 +1 @@
+export * from './parseIconNames';

package/dist/core/icons/parseIconNames.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Извлекает имена иконок из выражения icon-image.
+ *
+ * Поддерживает:
+ * - Строки: "parking" → ["parking"]
+ * - match: ["match", ["get", "type"], "a", "icon-a", "b", "icon-b", "default"] → ["icon-a", "icon-b", "default"]
+ * - case: ["case", [...], "icon-a", "icon-b"] → ["icon-a", "icon-b"]
+ * - coalesce: ["coalesce", ["image", "icon-a"], ["image", "icon-b"]] → ["icon-a", "icon-b"]
+ * - image: ["image", "icon-a"] → ["icon-a"]
+ *
+ * @param iconImage - значение icon-image из layout
+ * @returns массив имён иконок
+ */
+export declare const parseIconNames: (iconImage: unknown) => string[];
+/**
+ * Извлекает все имена изображений из clientStyle.
+ * Включает иконки (icon-image) и паттерны (fill-pattern, line-pattern, fill-extrusion-pattern).
+ *
+ * @param clientStyle - конфигурация стиля слоя
+ * @returns массив уникальных имён изображений
+ */
+export declare const parseIconNamesFromClientStyle: (clientStyle: {
+    items?: Array<{
+        layout?: Record<string, unknown>;
+        paint?: Record<string, unknown>;
+    }>;
+} | undefined) => string[];

package/dist/core/index.d.ts

@@ -1,2 +1,3 @@
 export * from './classification';
 export * from './feature';
+export * from './icons';

package/dist/hooks/map/index.d.ts

@@ -1,5 +1,7 @@
 export * from './useMapDraw';
 export * from './useMapContext';
+export * from './useMapImages';
+export * from './useIconsFromLayers';
 export * from './useRedrawLayer';
 export * from './useZoomToFeatures';
 export * from './useZoomToPoint';

package/dist/hooks/map/useIconsFromLayers.d.ts

@@ -0,0 +1,52 @@
+import { ClientStyle } from '../../types/styling';
+export interface LayerIconConfig {
+    /** Идентификатор слоя */
+    layerId: string;
+    /** Конфигурация стиля слоя */
+    clientStyle?: ClientStyle;
+}
+export interface UseIconsFromLayersOptions {
+    /** Массив конфигураций слоёв */
+    layers: LayerIconConfig[];
+    /** Базовый URL для иконок по умолчанию (если не указан в clientStyle.icons) */
+    baseUrl?: string;
+    /** Расширение файлов иконок по умолчанию */
+    defaultExtension?: string;
+}
+export interface UseIconsFromLayersResult {
+    /** Загружены ли все иконки */
+    loaded: boolean;
+    /** Ошибки загрузки (имя иконки -> сообщение об ошибке) */
+    errors: Record<string, string>;
+    /** Массив имён иконок, которые были запрошены */
+    requestedIcons: string[];
+}
+/**
+ * Хук для автоматической загрузки иконок из clientStyle слоёв.
+ *
+ * Парсит все icon-image выражения из clientStyle.items и загружает
+ * соответствующие иконки из clientStyle.icons или по конвенции baseUrl.
+ *
+ * @example
+ * ```tsx
+ * const layers = [
+ *   {
+ *     layerId: 'parking',
+ *     clientStyle: {
+ *       icons: [
+ *         { name: 'parking-icon', url: '/icons/parking.svg', sdf: true }
+ *       ],
+ *       items: [{
+ *         type: 'symbol',
+ *         layout: { 'icon-image': 'parking-icon' }
+ *       }]
+ *     }
+ *   }
+ * ];
+ *
+ * const { loaded, errors } = useIconsFromLayers({ layers });
+ *
+ * if (!loaded) return <Loading />;
+ * ```
+ */
+export declare const useIconsFromLayers: ({ layers, baseUrl, defaultExtension, }: UseIconsFromLayersOptions) => UseIconsFromLayersResult;

package/dist/hooks/map/useMapImages.d.ts

@@ -0,0 +1,48 @@
+export interface MapImageConfig {
+    /** Уникальное имя иконки для использования в icon-image */
+    name: string;
+    /** URL изображения (PNG, SVG или data URL) */
+    url: string;
+    /** SDF режим для перекрашивания иконки через icon-color */
+    sdf?: boolean;
+    /** Размер иконки в пикселях (для SVG растеризации, по умолчанию 64) */
+    size?: number;
+    /** Pixel ratio для retina экранов (1 или 2, по умолчанию 1) */
+    pixelRatio?: number;
+}
+export interface UseMapImagesOptions {
+    /** Массив конфигураций иконок для загрузки */
+    images: MapImageConfig[];
+}
+export interface UseMapImagesResult {
+    /** Загружены ли все иконки */
+    loaded: boolean;
+    /** Ошибки загрузки (имя иконки -> сообщение об ошибке) */
+    errors: Record<string, string>;
+    /** Загрузить дополнительную иконку */
+    addImage: (config: MapImageConfig) => Promise<void>;
+    /** Удалить иконку с карты */
+    removeImage: (name: string) => void;
+    /** Проверить есть ли иконка */
+    hasImage: (name: string) => boolean;
+}
+/**
+ * Хук для загрузки пользовательских иконок в карту Mapbox.
+ *
+ * Поддерживает PNG, SVG и data URL. SVG автоматически растеризуется.
+ *
+ * @example
+ * ```tsx
+ * const { loaded } = useMapImages({
+ *   images: [
+ *     { name: 'my-parking', url: '/icons/parking.png' },
+ *     { name: 'my-marker', url: '/icons/marker.svg', sdf: true, size: 48 },
+ *     { name: 'my-logo', url: '/icons/logo.png', pixelRatio: 2 },
+ *   ]
+ * });
+ *
+ * // В clientStyle:
+ * { "icon-image": "my-parking" }
+ * ```
+ */
+export declare const useMapImages: ({ images }: UseMapImagesOptions) => UseMapImagesResult;