aur-openlayers 19.6.4 → 19.6.6

package/lib/map-framework/public/types.d.ts

@@ -456,6 +456,53 @@ export type MapController = {
     /** Освободить ресурсы при отвязке (опционально). */
     unbind?: () => void;
 };
+/**
+ * Конфигурация стрелок направления вдоль LineString.
+ */
+export type ArrowDecoration = {
+    /**
+     * Расстояние между стрелками в метрах.
+     * Функция — для адаптации интервала к масштабу.
+     *
+     * @example
+     * interval: (view) => Math.max(100, view.resolution * 80)
+     */
+    interval: MaybeFn<number, [view: StyleView]>;
+    /**
+     * Стиль стрелки.
+     * Получает rotation (радианы, по часовой от севера — конвенция OL)
+     * и текущий вид карты.
+     */
+    style: (args: {
+        rotation: number;
+        view: StyleView;
+    }) => Style | Style[];
+    /**
+     * Смещение первой стрелки от начала линии как доля интервала (0–1).
+     * По умолчанию: 0.5.
+     */
+    offsetRatio?: number;
+};
+/**
+ * Конфигурация буферного полигона (коридора) вдоль LineString.
+ */
+export type BufferDecoration = {
+    /** Ширина буфера в метрах (в одну сторону — полная ширина = distance * 2). */
+    distance: number;
+    /** Стиль буферного полигона (OL Style). */
+    style: Style | Style[];
+    /** Форма торцов. По умолчанию: 'round'. */
+    cap?: 'round' | 'flat';
+};
+/**
+ * Декоративные элементы вдоль LineString-геометрий.
+ */
+export type LineDecorations = {
+    /** Стрелки направления вдоль линии. */
+    arrows?: ArrowDecoration;
+    /** Буферный полигон (коридор) вокруг линии. */
+    buffer?: BufferDecoration;
+};
 /**
  * Описание фичи: геометрия, стиль, взаимодействия и popup.
  *
@@ -668,6 +715,11 @@ export interface FeatureDescriptor<M, G extends Geometry, OPTS extends object> {
             event?: MapBrowserEvent<UIEvent>;
         }) => PopupItem<M>;
     };
+    /**
+     * Декоративные элементы вдоль LineString-геометрий.
+     * Игнорируется для не-LineString геометрий.
+     */
+    decorations?: LineDecorations;
 }
 /**
  * Конфигурация кластеризации слоя.

package/lib/map-framework/runtime/decorations/arrow-decoration-manager.d.ts

@@ -0,0 +1,27 @@
+import VectorLayer from 'ol/layer/Vector';
+import type OlMap from 'ol/Map';
+import type { ArrowDecoration, VectorLayerApi } from '../../public/types';
+export type ArrowDecorationManagerOptions = {
+    map: OlMap;
+    parentLayer: VectorLayer;
+    parentApi: VectorLayerApi<any, any>;
+    config: ArrowDecoration;
+};
+export declare class ArrowDecorationManager {
+    private readonly source;
+    private readonly layer;
+    private readonly config;
+    private readonly map;
+    private readonly parentLayer;
+    private readonly parentApi;
+    private readonly moveEndKey;
+    private readonly unsubCollection;
+    private readonly unsubChanges;
+    private rafId;
+    constructor(options: ArrowDecorationManagerOptions);
+    private scheduleUpdate;
+    private rebuild;
+    private syncVisibility;
+    private syncOpacity;
+    dispose(): void;
+}

package/lib/map-framework/runtime/decorations/buffer-decoration-manager.d.ts

@@ -0,0 +1,27 @@
+import VectorLayer from 'ol/layer/Vector';
+import type OlMap from 'ol/Map';
+import type { BufferDecoration, VectorLayerApi } from '../../public/types';
+export type BufferDecorationManagerOptions = {
+    map: OlMap;
+    parentLayer: VectorLayer;
+    parentApi: VectorLayerApi<any, any>;
+    config: BufferDecoration;
+};
+export declare class BufferDecorationManager {
+    private readonly source;
+    private readonly layer;
+    private readonly config;
+    private readonly map;
+    private readonly parentLayer;
+    private readonly parentApi;
+    private readonly moveEndKey;
+    private readonly unsubCollection;
+    private readonly unsubChanges;
+    private rafId;
+    constructor(options: BufferDecorationManagerOptions);
+    private scheduleUpdate;
+    private rebuild;
+    private syncVisibility;
+    private syncOpacity;
+    dispose(): void;
+}

package/lib/map-framework/runtime/decorations/generate-buffer-polygon.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generate a closed polygon ring representing a buffer around a polyline.
+ *
+ * @param coords Line vertices in EPSG:3857.
+ * @param distance Buffer width in meters (one side).
+ * @param cap End cap style: 'round' or 'flat'.
+ * @returns Closed ring (first == last point), or empty array if line is degenerate.
+ */
+export declare function generateBufferPolygon(coords: number[][], distance: number, cap: 'round' | 'flat'): number[][];

package/lib/map-framework/runtime/layer-manager.d.ts

@@ -9,6 +9,7 @@ export declare class LayerManager<Layers extends readonly VectorLayerDescriptor<
     private readonly scheduler;
     private readonly popupHost;
     private readonly ctx;
+    private readonly decorationManagers;
     private constructor();
     static create<Layers extends readonly VectorLayerDescriptor<any, any, any, any>[]>(map: OlMap, schema: MapSchema<Layers>): LayerManager<Layers>;
     getLayer(id: string): VectorLayer | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aur-openlayers",
-  "version": "19.6.4",
+  "version": "19.6.6",
   "peerDependencies": {
     "@angular/common": "^19.2.0",
     "@angular/core": "^19.2.0",