@dartcom/ui-kit 10.5.15 → 10.5.16

package/dist/index.cjs

@@ -23454,6 +23454,11 @@ class MapService {
      * Полный угол окружности в градусах.
      */
     FULL_CIRCLE_DEGREES = 360;
+    /**
+     * Эпсилон (в метрах) для сравнения координат по умолчанию.
+     */
+    COORDINATE_EQUALITY_EPSILON_M = 2e-3;
+    constructor() { }
     /**
      * Половина окружности в градусах.
      *
@@ -23485,7 +23490,6 @@ class MapService {
     get RAD_TO_DEG() {
         return this.HALF_CIRCLE_DEGREES / Math.PI;
     }
-    constructor() { }
     /**
      * Преобразует объект Leaflet `LatLng` в внутренний формат координат `Coordinate`.
      *
@@ -23640,7 +23644,8 @@ class MapService {
      */
     distanceToMeters(distance, unit = 'meters') {
         const factor = DISTANCE_UNIT_FACTORS[unit];
-        return distance * factor;
+        const distanceToMeters = distance * factor;
+        return distanceToMeters;
     }
     /**
      * Вычисляет общую длину ломаной линии (полилинии) по массиву координат.
@@ -23662,6 +23667,198 @@ class MapService {
         }, 0);
         return this.convertDistance(totalLengthInMeters, unit);
     }
+    /**
+     * Проверяет, совпадают ли две координаты с учётом допустимой
+     * погрешности Float64.
+     *
+     * @param a - Первая координата.
+     * @param b - Вторая координата.
+     * @returns `true`, если расстояние между точками ≤ {@link COORDINATE_EQUALITY_EPSILON_M}.
+     */
+    coordinatesEqual(a, b) {
+        const isEqual = this.haversineDistance(a, b, 'meters') <=
+            this.COORDINATE_EQUALITY_EPSILON_M;
+        return isEqual;
+    }
+    /**
+     * Заменяет все вхождения координаты в плоском массиве.
+     * Используется как общее ядро для методов работы с геометриями.
+     *
+     * @param coordinates - Исходный массив координат.
+     * @param oldCoordinate - Координата, которую нужно заменить.
+     * @param newCoordinate - Новая координата.
+     * @param isEqual - Функция сравнения координат. По умолчанию — {@link coordinatesEqual}.
+     * @returns Новый массив координат с произведёнными заменами.
+     */
+    replaceInFlatRing(coordinates, oldCoordinate, newCoordinate, isEqual) {
+        return coordinates.map((coord) => isEqual(coord, oldCoordinate) ? newCoordinate : coord);
+    }
+    /**
+     * Заменяет все вхождения координаты в линии (одномерный массив координат).
+     *
+     * Оригинальный массив не мутируется — возвращается новый.
+     *
+     * @param line - Исходная линия (массив координат).
+     * @param oldCoordinate - Координата, которую нужно заменить.
+     * @param newCoordinate - Новая координата.
+     * @param isEqual - Опциональная функция сравнения. По умолчанию — {@link coordinatesEqual}.
+     * @returns Новая линия с заменёнными координатами.
+     *
+     * @example
+     * mapService.replaceCoordinateInLine(
+     *   [{ lat: 0, lon: 0 }, { lat: 1, lon: 1 }],
+     *   { lat: 0, lon: 0 },
+     *   { lat: 5, lon: 5 },
+     * );
+     * // [{ lat: 5, lon: 5 }, { lat: 1, lon: 1 }]
+     */
+    replaceCoordinateInLine(line, oldCoordinate, newCoordinate, isEqual = this.coordinatesEqual.bind(this)) {
+        return this.replaceInFlatRing(line, oldCoordinate, newCoordinate, isEqual);
+    }
+    /**
+     * Заменяет все вхождения координаты в полигоне.
+     *
+     * Полигон представлен как массив колец (`Coordinate[][]`),
+     * где первое кольцо — внешний контур, последующие — отверстия.
+     * Оригинальный массив не мутируется.
+     *
+     * @param polygon - Исходный полигон (массив колец).
+     * @param oldCoordinate - Координата, которую нужно заменить.
+     * @param newCoordinate - Новая координата.
+     * @param isEqual - Опциональная функция сравнения. По умолчанию — {@link coordinatesEqual}.
+     * @returns Новый полигон с заменёнными координатами.
+     */
+    replaceCoordinateInPolygon(polygon, oldCoordinate, newCoordinate, isEqual = this.coordinatesEqual.bind(this)) {
+        return polygon.map((ring) => this.replaceInFlatRing(ring, oldCoordinate, newCoordinate, isEqual));
+    }
+    /**
+     * Заменяет все вхождения координаты в мультиполигоне.
+     *
+     * Мультиполигон представлен как массив полигонов (`Coordinate[][][]`).
+     * Оригинальный массив не мутируется.
+     *
+     * @param multiPolygon - Исходный мультиполигон.
+     * @param oldCoordinate - Координата, которую нужно заменить.
+     * @param newCoordinate - Новая координата.
+     * @param isEqual - Опциональная функция сравнения. По умолчанию — {@link coordinatesEqual}.
+     * @returns Новый мультиполигон с заменёнными координатами.
+     */
+    replaceCoordinateInMultiPolygon(multiPolygon, oldCoordinate, newCoordinate, isEqual = this.coordinatesEqual.bind(this)) {
+        return multiPolygon.map((polygon) => this.replaceCoordinateInPolygon(polygon, oldCoordinate, newCoordinate, isEqual));
+    }
+    /**
+     * Выполняет выборку точек вдоль ломаной линии с фиксированным интервалом по расстоянию.
+     *
+     * Алгоритм:
+     * - последовательно проходит все сегменты линии;
+     * - накапливает пройденное расстояние;
+     * - как только накопленное расстояние достигает кратного интервалу,
+     *   интерполирует точку на текущем сегменте;
+     * - продолжает, пока не пройдена вся линия или не достигнут maxPoints.
+     *
+     * Внутренние расчёты ведутся в метрах, но интервал можно задавать
+     * в других поддерживаемых единицах (километры, мили и т.д.).
+     *
+     * Метод корректно работает и для сильно ломаных линий: точки всегда
+     * лежат на самой линии и распределены по её длине, а не по прямой.
+     *
+     * @param coordinates - Линия в виде массива координат.
+     * @param options - Опции выборки.
+     * @returns Массив координат, расположенных вдоль исходной линии
+     * на заданном интервале.
+     */
+    sampleLineByDistance(coordinates, options = {}) {
+        const { interval = 1000, maxPoints, unit = 'meters', includeStart = false, } = options;
+        if (coordinates.length < 2) {
+            return [];
+        }
+        const intervalInMeters = this.distanceToMeters(interval, unit);
+        if (!Number.isFinite(intervalInMeters) || intervalInMeters <= 0) {
+            return [];
+        }
+        const result = [];
+        let accumulated = 0;
+        let previous = coordinates[0];
+        if (includeStart) {
+            result.push(previous);
+        }
+        for (let i = 1; i < coordinates.length; i++) {
+            const current = coordinates[i];
+            const segmentDistance = this.haversineDistance(previous, current, 'meters');
+            // сегмент нулевой длины — просто пропускаем его
+            if (!Number.isFinite(segmentDistance) || segmentDistance === 0) {
+                previous = current;
+                continue;
+            }
+            accumulated += segmentDistance;
+            while (accumulated >= intervalInMeters) {
+                const distanceFromSegmentEnd = accumulated - intervalInMeters;
+                const distanceAlongSegment = segmentDistance - distanceFromSegmentEnd;
+                const fraction = distanceAlongSegment / segmentDistance;
+                const lat = previous.lat + fraction * (current.lat - previous.lat);
+                const lon = previous.lon + fraction * (current.lon - previous.lon);
+                result.push({ lat, lon });
+                if (maxPoints != null && result.length >= maxPoints) {
+                    return result;
+                }
+                accumulated -= intervalInMeters;
+            }
+            previous = current;
+        }
+        if (maxPoints != null) {
+            return result.slice(0, maxPoints);
+        }
+        return result;
+    }
+    /**
+     * Возвращает координату точки, расположенной посередине по длине ломаной.
+     *
+     * Под «центром» понимается точка, находящаяся на половине общей длины
+     * линии, измеренной по её сегментам. Это особенно важно для сильно
+     * ломаных линий: центр почти никогда не совпадает с геометрическим
+     * центром по широте/долготе или с какой‑либо вершиной.
+     *
+     * Если линия короче двух точек, возвращает `null`.
+     * Если все точки совпадают (нулевая длина) — возвращает первую.
+     *
+     * @param coordinates - Линия в виде массива координат.
+     * @returns Координата в середине по длине ломаной или `null`, если
+     * линия некорректна.
+     */
+    getPolylineCenter(coordinates) {
+        if (coordinates.length === 0) {
+            return null;
+        }
+        if (coordinates.length === 1) {
+            return coordinates[0];
+        }
+        const totalLengthMeters = this.getPolylineLength(coordinates, 'meters');
+        if (totalLengthMeters === 0) {
+            return coordinates[0];
+        }
+        const halfDistance = totalLengthMeters / 2;
+        let accumulated = 0;
+        let previous = coordinates[0];
+        for (let i = 1; i < coordinates.length; i++) {
+            const current = coordinates[i];
+            const segmentDistance = this.haversineDistance(previous, current, 'meters');
+            if (segmentDistance === 0) {
+                previous = current;
+                continue;
+            }
+            if (accumulated + segmentDistance >= halfDistance) {
+                const remaining = halfDistance - accumulated;
+                const fraction = remaining / segmentDistance;
+                const lat = previous.lat + fraction * (current.lat - previous.lat);
+                const lon = previous.lon + fraction * (current.lon - previous.lon);
+                return { lat, lon };
+            }
+            accumulated += segmentDistance;
+            previous = current;
+        }
+        // На случай накопленных ошибок округления:
+        return coordinates[coordinates.length - 1];
+    }
 }
 /**
  * Сервис для работы с географическими координатами и базовыми

package/dist/services/map/map.service.d.ts

@@ -1,5 +1,5 @@
 import { Coordinate } from '../../lib';
-import { DistanceUnit } from './map.types';
+import { CoordinateCompareFn, DistanceUnit, SampleLineOptions } from './map.types';
 import { LatLng } from 'leaflet';
 declare class MapService {
     /**
@@ -10,6 +10,11 @@ declare class MapService {
      * Полный угол окружности в градусах.
      */
     readonly FULL_CIRCLE_DEGREES = 360;
+    /**
+     * Эпсилон (в метрах) для сравнения координат по умолчанию.
+     */
+    readonly COORDINATE_EQUALITY_EPSILON_M = 0.002;
+    constructor();
     /**
      * Половина окружности в градусах.
      *
@@ -35,7 +40,6 @@ declare class MapService {
      * @returns Значение коэффициента перевода радиан в градусы.
      */
     get RAD_TO_DEG(): number;
-    constructor();
     /**
      * Преобразует объект Leaflet `LatLng` в внутренний формат координат `Coordinate`.
      *
@@ -137,7 +141,7 @@ declare class MapService {
      * @param unit - Единица, в которой передано расстояние.
      * @returns Расстояние в метрах.
      */
-    private distanceToMeters;
+    distanceToMeters(distance: number, unit?: DistanceUnit): number;
     /**
      * Вычисляет общую длину ломаной линии (полилинии) по массиву координат.
      *
@@ -149,6 +153,111 @@ declare class MapService {
      * @returns Общая длина полилинии в выбранной единице.
      */
     getPolylineLength(coordinates: Coordinate[], unit?: DistanceUnit): number;
+    /**
+     * Проверяет, совпадают ли две координаты с учётом допустимой
+     * погрешности Float64.
+     *
+     * @param a - Первая координата.
+     * @param b - Вторая координата.
+     * @returns `true`, если расстояние между точками ≤ {@link COORDINATE_EQUALITY_EPSILON_M}.
+     */
+    coordinatesEqual(a: Coordinate, b: Coordinate): boolean;
+    /**
+     * Заменяет все вхождения координаты в плоском массиве.
+     * Используется как общее ядро для методов работы с геометриями.
+     *
+     * @param coordinates - Исходный массив координат.
+     * @param oldCoordinate - Координата, которую нужно заменить.
+     * @param newCoordinate - Новая координата.
+     * @param isEqual - Функция сравнения координат. По умолчанию — {@link coordinatesEqual}.
+     * @returns Новый массив координат с произведёнными заменами.
+     */
+    private replaceInFlatRing;
+    /**
+     * Заменяет все вхождения координаты в линии (одномерный массив координат).
+     *
+     * Оригинальный массив не мутируется — возвращается новый.
+     *
+     * @param line - Исходная линия (массив координат).
+     * @param oldCoordinate - Координата, которую нужно заменить.
+     * @param newCoordinate - Новая координата.
+     * @param isEqual - Опциональная функция сравнения. По умолчанию — {@link coordinatesEqual}.
+     * @returns Новая линия с заменёнными координатами.
+     *
+     * @example
+     * mapService.replaceCoordinateInLine(
+     *   [{ lat: 0, lon: 0 }, { lat: 1, lon: 1 }],
+     *   { lat: 0, lon: 0 },
+     *   { lat: 5, lon: 5 },
+     * );
+     * // [{ lat: 5, lon: 5 }, { lat: 1, lon: 1 }]
+     */
+    replaceCoordinateInLine(line: Coordinate[], oldCoordinate: Coordinate, newCoordinate: Coordinate, isEqual?: CoordinateCompareFn): Coordinate[];
+    /**
+     * Заменяет все вхождения координаты в полигоне.
+     *
+     * Полигон представлен как массив колец (`Coordinate[][]`),
+     * где первое кольцо — внешний контур, последующие — отверстия.
+     * Оригинальный массив не мутируется.
+     *
+     * @param polygon - Исходный полигон (массив колец).
+     * @param oldCoordinate - Координата, которую нужно заменить.
+     * @param newCoordinate - Новая координата.
+     * @param isEqual - Опциональная функция сравнения. По умолчанию — {@link coordinatesEqual}.
+     * @returns Новый полигон с заменёнными координатами.
+     */
+    replaceCoordinateInPolygon(polygon: Coordinate[][], oldCoordinate: Coordinate, newCoordinate: Coordinate, isEqual?: CoordinateCompareFn): Coordinate[][];
+    /**
+     * Заменяет все вхождения координаты в мультиполигоне.
+     *
+     * Мультиполигон представлен как массив полигонов (`Coordinate[][][]`).
+     * Оригинальный массив не мутируется.
+     *
+     * @param multiPolygon - Исходный мультиполигон.
+     * @param oldCoordinate - Координата, которую нужно заменить.
+     * @param newCoordinate - Новая координата.
+     * @param isEqual - Опциональная функция сравнения. По умолчанию — {@link coordinatesEqual}.
+     * @returns Новый мультиполигон с заменёнными координатами.
+     */
+    replaceCoordinateInMultiPolygon(multiPolygon: Coordinate[][][], oldCoordinate: Coordinate, newCoordinate: Coordinate, isEqual?: CoordinateCompareFn): Coordinate[][][];
+    /**
+     * Выполняет выборку точек вдоль ломаной линии с фиксированным интервалом по расстоянию.
+     *
+     * Алгоритм:
+     * - последовательно проходит все сегменты линии;
+     * - накапливает пройденное расстояние;
+     * - как только накопленное расстояние достигает кратного интервалу,
+     *   интерполирует точку на текущем сегменте;
+     * - продолжает, пока не пройдена вся линия или не достигнут maxPoints.
+     *
+     * Внутренние расчёты ведутся в метрах, но интервал можно задавать
+     * в других поддерживаемых единицах (километры, мили и т.д.).
+     *
+     * Метод корректно работает и для сильно ломаных линий: точки всегда
+     * лежат на самой линии и распределены по её длине, а не по прямой.
+     *
+     * @param coordinates - Линия в виде массива координат.
+     * @param options - Опции выборки.
+     * @returns Массив координат, расположенных вдоль исходной линии
+     * на заданном интервале.
+     */
+    sampleLineByDistance(coordinates: Coordinate[], options?: SampleLineOptions): Coordinate[];
+    /**
+     * Возвращает координату точки, расположенной посередине по длине ломаной.
+     *
+     * Под «центром» понимается точка, находящаяся на половине общей длины
+     * линии, измеренной по её сегментам. Это особенно важно для сильно
+     * ломаных линий: центр почти никогда не совпадает с геометрическим
+     * центром по широте/долготе или с какой‑либо вершиной.
+     *
+     * Если линия короче двух точек, возвращает `null`.
+     * Если все точки совпадают (нулевая длина) — возвращает первую.
+     *
+     * @param coordinates - Линия в виде массива координат.
+     * @returns Координата в середине по длине ломаной или `null`, если
+     * линия некорректна.
+     */
+    getPolylineCenter(coordinates: Coordinate[]): Coordinate | null;
 }
 /**
  * Сервис для работы с географическими координатами и базовыми

package/dist/services/map/map.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map.service.d.ts","sourceRoot":"","sources":["../../../src/services/map/map.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGnC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,cAAM,UAAU;IACd;;OAEG;IACH,SAAgB,cAAc,WAAa;IAE3C;;OAEG;IACH,SAAgB,mBAAmB,OAAO;IAE1C;;;;;;;OAOG;IACH,IAAW,mBAAmB,WAE7B;IAED;;;;;;OAMG;IACH,IAAW,UAAU,WAEpB;IAED;;;;;;OAMG;IACH,IAAW,UAAU,WAEpB;;IAID;;;;;OAKG;IACI,qBAAqB,CAAC,MAAM,EAAE,MAAM;IAW3C;;;;;OAKG;IACI,qBAAqB,CAAC,UAAU,EAAE,UAAU;IAQnD;;;;;;;;;;;;OAYG;IACI,gBAAgB,CAAC,OAAO,EAAE,MAAM;IAOvC;;;;;;;;;OASG;IACI,kBAAkB,CAAC,GAAG,EAAE,MAAM;IAQrC;;;;;;;;;;;;;OAaG;IACI,oBAAoB,GAAI,0CAK5B;QACD,UAAU,EAAE,UAAU,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,YAAY,CAAC;KACrB;;;MAwBC;IAEF;;;;;;;;;;;OAWG;IACI,iBAAiB,CACtB,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,EACb,IAAI,GAAE,YAAuB;IAkB/B;;;;;;;;;OASG;IACI,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU;IAkBlD;;;;;;OAMG;IACI,eAAe,CACpB,gBAAgB,EAAE,MAAM,EACxB,IAAI,GAAE,YAAuB;IAO/B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;;;;;;;OASG;IACI,iBAAiB,CACtB,WAAW,EAAE,UAAU,EAAE,EACzB,IAAI,GAAE,YAAuB;CAqBhC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC"}
+{"version":3,"file":"map.service.d.ts","sourceRoot":"","sources":["../../../src/services/map/map.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGnC,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,cAAM,UAAU;IACd;;OAEG;IACH,SAAgB,cAAc,WAAa;IAE3C;;OAEG;IACH,SAAgB,mBAAmB,OAAO;IAE1C;;OAEG;IACH,SAAgB,6BAA6B,SAAQ;;IAIrD;;;;;;;OAOG;IACH,IAAW,mBAAmB,WAE7B;IAED;;;;;;OAMG;IACH,IAAW,UAAU,WAEpB;IAED;;;;;;OAMG;IACH,IAAW,UAAU,WAEpB;IAED;;;;;OAKG;IACI,qBAAqB,CAAC,MAAM,EAAE,MAAM;IAW3C;;;;;OAKG;IACI,qBAAqB,CAAC,UAAU,EAAE,UAAU;IAQnD;;;;;;;;;;;;OAYG;IACI,gBAAgB,CAAC,OAAO,EAAE,MAAM;IAOvC;;;;;;;;;OASG;IACI,kBAAkB,CAAC,GAAG,EAAE,MAAM;IAQrC;;;;;;;;;;;;;OAaG;IACI,oBAAoB,GAAI,0CAK5B;QACD,UAAU,EAAE,UAAU,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,YAAY,CAAC;KACrB;;;MAwBC;IAEF;;;;;;;;;;;OAWG;IACI,iBAAiB,CACtB,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,EACb,IAAI,GAAE,YAAuB;IAkB/B;;;;;;;;;OASG;IACI,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU;IAkBlD;;;;;;OAMG;IACI,eAAe,CACpB,gBAAgB,EAAE,MAAM,EACxB,IAAI,GAAE,YAAuB;IAO/B;;;;;;OAMG;IACI,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,YAAuB;IAQvE;;;;;;;;;OASG;IACI,iBAAiB,CACtB,WAAW,EAAE,UAAU,EAAE,EACzB,IAAI,GAAE,YAAuB;IAsB/B;;;;;;;OAOG;IACI,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU;IAQpD;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;;;;;;;;;;;;;;;;OAkBG;IACI,uBAAuB,CAC5B,IAAI,EAAE,UAAU,EAAE,EAClB,aAAa,EAAE,UAAU,EACzB,aAAa,EAAE,UAAU,EACzB,OAAO,GAAE,mBAAsD;IAKjE;;;;;;;;;;;;OAYG;IACI,0BAA0B,CAC/B,OAAO,EAAE,UAAU,EAAE,EAAE,EACvB,aAAa,EAAE,UAAU,EACzB,aAAa,EAAE,UAAU,EACzB,OAAO,GAAE,mBAAsD;IAOjE;;;;;;;;;;;OAWG;IACI,+BAA+B,CACpC,YAAY,EAAE,UAAU,EAAE,EAAE,EAAE,EAC9B,aAAa,EAAE,UAAU,EACzB,aAAa,EAAE,UAAU,EACzB,OAAO,GAAE,mBAAsD;IAYjE;;;;;;;;;;;;;;;;;;;;OAoBG;IACI,oBAAoB,CACzB,WAAW,EAAE,UAAU,EAAE,EACzB,OAAO,GAAE,iBAAsB;IAwEjC;;;;;;;;;;;;;;OAcG;IACI,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE;CAoDnD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/services/map/map.service.esm.js

@@ -1 +1 @@
-import{DISTANCE_UNIT_FACTORS as t}from"./map.constants.esm.js";import{a as s}from"../../_virtual/leaflet-src.esm.js";const n=new class{EARTH_RADIUS_M=6371e3;FULL_CIRCLE_DEGREES=360;get HALF_CIRCLE_DEGREES(){return this.FULL_CIRCLE_DEGREES/2}get DEG_TO_RAD(){return Math.PI/this.HALF_CIRCLE_DEGREES}get RAD_TO_DEG(){return this.HALF_CIRCLE_DEGREES/Math.PI}constructor(){}getCoordinateByLatLng(t){const{lat:s,lng:n}=t;return{lat:s,lon:n}}getLatLngByCoordinate(t){const{lat:n,lon:a}=t;return new s.LatLng(n,a)}normalizeBearing(t){return(t%this.FULL_CIRCLE_DEGREES+this.FULL_CIRCLE_DEGREES)%this.FULL_CIRCLE_DEGREES}normalizeLongitude(t){return(t+this.FULL_CIRCLE_DEGREES+this.HALF_CIRCLE_DEGREES)%this.FULL_CIRCLE_DEGREES-this.HALF_CIRCLE_DEGREES}calculateDestination=({coordinate:t,distance:s,azimuth:n,unit:a="meters"})=>{const e=t.lat*this.DEG_TO_RAD,i=t.lon*this.DEG_TO_RAD,r=this.normalizeBearing(n)*this.DEG_TO_RAD,E=this.distanceToMeters(s,a)/this.EARTH_RADIUS_M,h=Math.sin(e),_=Math.cos(e),o=Math.sin(E),D=Math.cos(E),R=Math.sin(r),L=Math.cos(r),c=Math.asin(h*D+_*o*L),l=i+Math.atan2(R*o*_,D-h*Math.sin(c));return{lat:c*this.RAD_TO_DEG,lon:this.normalizeLongitude(l*this.RAD_TO_DEG)}};haversineDistance(t,s,n="meters"){const a=t.lat*this.DEG_TO_RAD,e=s.lat*this.DEG_TO_RAD,i=(s.lat-t.lat)*this.DEG_TO_RAD,r=(s.lon-t.lon)*this.DEG_TO_RAD,E=Math.sin(i/2)**2+Math.cos(a)*Math.cos(e)*Math.sin(r/2)**2,h=2*Math.atan2(Math.sqrt(E),Math.sqrt(1-E)),_=this.EARTH_RADIUS_M*h;return this.convertDistance(_,n)}initialBearing(t,s){const n=t.lat*this.DEG_TO_RAD,a=s.lat*this.DEG_TO_RAD,e=t.lon*this.DEG_TO_RAD,i=s.lon*this.DEG_TO_RAD,r=Math.sin(i-e)*Math.cos(a),E=Math.cos(n)*Math.sin(a)-Math.sin(n)*Math.cos(a)*Math.cos(i-e);return this.normalizeBearing(Math.atan2(r,E)*this.RAD_TO_DEG)}convertDistance(s,n="meters"){return s/t[n]}distanceToMeters(s,n="meters"){return s*t[n]}getPolylineLength(t,s="meters"){const n=t.reduce((t,s,n,a)=>{const e=a[n+1];if(!e)return t;return t+this.haversineDistance(s,e,"meters")},0);return this.convertDistance(n,s)}};export{n as mapService};
+import{DISTANCE_UNIT_FACTORS as t}from"./map.constants.esm.js";import{a as e}from"../../_virtual/leaflet-src.esm.js";const n=new class{EARTH_RADIUS_M=6371e3;FULL_CIRCLE_DEGREES=360;COORDINATE_EQUALITY_EPSILON_M=.002;constructor(){}get HALF_CIRCLE_DEGREES(){return this.FULL_CIRCLE_DEGREES/2}get DEG_TO_RAD(){return Math.PI/this.HALF_CIRCLE_DEGREES}get RAD_TO_DEG(){return this.HALF_CIRCLE_DEGREES/Math.PI}getCoordinateByLatLng(t){const{lat:e,lng:n}=t;return{lat:e,lon:n}}getLatLngByCoordinate(t){const{lat:n,lon:s}=t;return new e.LatLng(n,s)}normalizeBearing(t){return(t%this.FULL_CIRCLE_DEGREES+this.FULL_CIRCLE_DEGREES)%this.FULL_CIRCLE_DEGREES}normalizeLongitude(t){return(t+this.FULL_CIRCLE_DEGREES+this.HALF_CIRCLE_DEGREES)%this.FULL_CIRCLE_DEGREES-this.HALF_CIRCLE_DEGREES}calculateDestination=({coordinate:t,distance:e,azimuth:n,unit:s="meters"})=>{const i=t.lat*this.DEG_TO_RAD,r=t.lon*this.DEG_TO_RAD,a=this.normalizeBearing(n)*this.DEG_TO_RAD,o=this.distanceToMeters(e,s)/this.EARTH_RADIUS_M,l=Math.sin(i),h=Math.cos(i),E=Math.sin(o),_=Math.cos(o),c=Math.sin(a),D=Math.cos(a),u=Math.asin(l*_+h*E*D),R=r+Math.atan2(c*E*h,_-l*Math.sin(u));return{lat:u*this.RAD_TO_DEG,lon:this.normalizeLongitude(R*this.RAD_TO_DEG)}};haversineDistance(t,e,n="meters"){const s=t.lat*this.DEG_TO_RAD,i=e.lat*this.DEG_TO_RAD,r=(e.lat-t.lat)*this.DEG_TO_RAD,a=(e.lon-t.lon)*this.DEG_TO_RAD,o=Math.sin(r/2)**2+Math.cos(s)*Math.cos(i)*Math.sin(a/2)**2,l=2*Math.atan2(Math.sqrt(o),Math.sqrt(1-o)),h=this.EARTH_RADIUS_M*l;return this.convertDistance(h,n)}initialBearing(t,e){const n=t.lat*this.DEG_TO_RAD,s=e.lat*this.DEG_TO_RAD,i=t.lon*this.DEG_TO_RAD,r=e.lon*this.DEG_TO_RAD,a=Math.sin(r-i)*Math.cos(s),o=Math.cos(n)*Math.sin(s)-Math.sin(n)*Math.cos(s)*Math.cos(r-i);return this.normalizeBearing(Math.atan2(a,o)*this.RAD_TO_DEG)}convertDistance(e,n="meters"){return e/t[n]}distanceToMeters(e,n="meters"){return e*t[n]}getPolylineLength(t,e="meters"){const n=t.reduce((t,e,n,s)=>{const i=s[n+1];if(!i)return t;return t+this.haversineDistance(e,i,"meters")},0);return this.convertDistance(n,e)}coordinatesEqual(t,e){return this.haversineDistance(t,e,"meters")<=this.COORDINATE_EQUALITY_EPSILON_M}replaceInFlatRing(t,e,n,s){return t.map(t=>s(t,e)?n:t)}replaceCoordinateInLine(t,e,n,s=this.coordinatesEqual.bind(this)){return this.replaceInFlatRing(t,e,n,s)}replaceCoordinateInPolygon(t,e,n,s=this.coordinatesEqual.bind(this)){return t.map(t=>this.replaceInFlatRing(t,e,n,s))}replaceCoordinateInMultiPolygon(t,e,n,s=this.coordinatesEqual.bind(this)){return t.map(t=>this.replaceCoordinateInPolygon(t,e,n,s))}sampleLineByDistance(t,e={}){const{interval:n=1e3,maxPoints:s,unit:i="meters",includeStart:r=!1}=e;if(t.length<2)return[];const a=this.distanceToMeters(n,i);if(!Number.isFinite(a)||a<=0)return[];const o=[];let l=0,h=t[0];r&&o.push(h);for(let e=1;e<t.length;e++){const n=t[e],i=this.haversineDistance(h,n,"meters");if(Number.isFinite(i)&&0!==i){for(l+=i;l>=a;){const t=(i-(l-a))/i,e=h.lat+t*(n.lat-h.lat),r=h.lon+t*(n.lon-h.lon);if(o.push({lat:e,lon:r}),null!=s&&o.length>=s)return o;l-=a}h=n}else h=n}return null!=s?o.slice(0,s):o}getPolylineCenter(t){if(0===t.length)return null;if(1===t.length)return t[0];const e=this.getPolylineLength(t,"meters");if(0===e)return t[0];const n=e/2;let s=0,i=t[0];for(let e=1;e<t.length;e++){const r=t[e],a=this.haversineDistance(i,r,"meters");if(0!==a){if(s+a>=n){const t=(n-s)/a;return{lat:i.lat+t*(r.lat-i.lat),lon:i.lon+t*(r.lon-i.lon)}}s+=a,i=r}else i=r}return t[t.length-1]}};export{n as mapService};

package/dist/services/map/map.types.d.ts

@@ -1,5 +1,39 @@
+import { Coordinate } from '../../lib';
 /**
  * Поддерживаемые единицы измерения расстояния.
  */
 export type DistanceUnit = 'meters' | 'kilometers' | 'miles' | 'nauticalMiles';
+/**
+ * Функция сравнения двух координат.
+ * Возвращает `true`, если координаты считаются равными.
+ *
+ * Позволяет задавать собственный критерий равенства —
+ * например, с учётом допустимой погрешности Float64.
+ */
+export type CoordinateCompareFn = (a: Coordinate, b: Coordinate) => boolean;
+/**
+ * Опции выборки координат вдоль линии.
+ */
+export interface SampleLineOptions {
+    /**
+     * Интервал между соседними точками выборки в выбранной единице.
+     * По умолчанию 1000 (метров).
+     */
+    interval?: number;
+    /**
+     * Максимальное количество точек в результате.
+     * Если не задано — возвращаются все возможные точки.
+     */
+    maxPoints?: number;
+    /**
+     * Единица измерения интервала.
+     * По умолчанию — метры.
+     */
+    unit?: DistanceUnit;
+    /**
+     * Включать ли первую точку линии в результат.
+     * Если true — начальная координата всегда будет первой в массиве.
+     */
+    includeStart?: boolean;
+}
 //# sourceMappingURL=map.types.d.ts.map

package/dist/services/map/map.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map.types.d.ts","sourceRoot":"","sources":["../../../src/services/map/map.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,eAAe,CAAC"}
+{"version":3,"file":"map.types.d.ts","sourceRoot":"","sources":["../../../src/services/map/map.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,eAAe,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dartcom/ui-kit",
-  "version": "10.5.15",
+  "version": "10.5.16",
   "description": "Кастомная библиотека компонентов Dartcom",
   "type": "module",
   "main": "./dist/index.cjs",