@dartcom/ui-kit 10.5.14 → 10.5.15

package/dist/index.cjs

@@ -8896,6 +8896,21 @@ class LoggerService {
 }
 const loggerService = new LoggerService();
 
+/**
+ * Коэффициенты перевода единиц в метры.
+ *
+ * Значение — сколько метров содержится в одной единице.
+ *
+ * Основано на стандартных метрических и международных определениях
+ * (1 km = 1000 m, 1 mi = 1609.344 m, 1 NM = 1852 m и т.д.). [web:45][web:48][web:54]
+ */
+const DISTANCE_UNIT_FACTORS = {
+    meters: 1,
+    kilometers: 1_000,
+    miles: 1_609.344,
+    nauticalMiles: 1_852,
+};
+
 function getDefaultExportFromCjs (x) {
 	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
 }
@@ -23532,27 +23547,22 @@ class MapService {
      * Вычисляет координату точки назначения по исходной точке,
      * расстоянию и азимуту.
      *
-     * Расчет выполняется по формулам сферической геометрии,
-     * где Земля рассматривается как сфера с радиусом `EARTH_RADIUS_M`.
+     * Расстояние можно задавать в произвольной поддерживаемой единице
+     * (по умолчанию метры) — перед вычислениями оно будет переведено в метры.
      *
-     * @param params - Параметры расчета.
+     * @param params - Параметры расчёта.
      * @param params.coordinate - Исходная координата.
-     * @param params.distance - Расстояние до точки назначения в метрах.
+     * @param params.distance - Расстояние до точки назначения в заданной единице.
      * @param params.azimuth - Азимут движения в градусах.
+     * @param params.unit - Единица, в которой задано расстояние (по умолчанию метры).
      * @returns Координата точки назначения в формате `{ lat, lon }`.
-     *
-     * @example
-     * mapService.calculateDestination({
-     *   coordinate: { lat: 55.75, lon: 37.61 },
-     *   distance: 1000,
-     *   azimuth: 90,
-     * });
      */
-    calculateDestination = ({ coordinate, distance, azimuth, }) => {
+    calculateDestination = ({ coordinate, distance, azimuth, unit = 'meters', }) => {
         const φ1 = coordinate.lat * this.DEG_TO_RAD;
         const λ1 = coordinate.lon * this.DEG_TO_RAD;
         const θ = this.normalizeBearing(azimuth) * this.DEG_TO_RAD;
-        const δ = distance / this.EARTH_RADIUS_M;
+        const distanceInMeters = this.distanceToMeters(distance, unit);
+        const δ = distanceInMeters / this.EARTH_RADIUS_M;
         const sinφ1 = Math.sin(φ1);
         const cosφ1 = Math.cos(φ1);
         const sinδ = Math.sin(δ);
@@ -23570,14 +23580,15 @@ class MapService {
      * Вычисляет расстояние между двумя географическими точками
      * по формуле гаверсинуса.
      *
-     * Метод подходит для расчета кратчайшего расстояния по поверхности Земли
-     * между двумя координатами.
+     * По умолчанию возвращает значение в метрах, но можно запросить
+     * километры, мили или морские мили.
      *
      * @param a - Первая координата.
      * @param b - Вторая координата.
-     * @returns Расстояние между точками в метрах.
+     * @param unit - Единица измерения результата (по умолчанию метры).
+     * @returns Расстояние между точками в выбранной единице.
      */
-    haversineDistance(a, b) {
+    haversineDistance(a, b, unit = 'meters') {
         const φ1 = a.lat * this.DEG_TO_RAD;
         const φ2 = b.lat * this.DEG_TO_RAD;
         const Δφ = (b.lat - a.lat) * this.DEG_TO_RAD;
@@ -23585,8 +23596,8 @@ class MapService {
         const h = Math.sin(Δφ / 2) ** 2 +
             Math.cos(φ1) * Math.cos(φ2) * Math.sin(Δλ / 2) ** 2;
         const c = 2 * Math.atan2(Math.sqrt(h), Math.sqrt(1 - h));
-        const distance = this.EARTH_RADIUS_M * c;
-        return distance;
+        const distanceInMeters = this.EARTH_RADIUS_M * c;
+        return this.convertDistance(distanceInMeters, unit);
     }
     /**
      * Вычисляет начальный азимут из точки `a` в точку `b`.
@@ -23609,6 +23620,48 @@ class MapService {
         const initialBearing = this.normalizeBearing(Math.atan2(y, x) * this.RAD_TO_DEG);
         return initialBearing;
     }
+    /**
+     * Переводит расстояние в метрах в заданную единицу измерения.
+     *
+     * @param distanceInMeters - Расстояние в метрах.
+     * @param unit - Желаемая единица измерения (по умолчанию метры).
+     * @returns Расстояние в выбранной единице.
+     */
+    convertDistance(distanceInMeters, unit = 'meters') {
+        const factor = DISTANCE_UNIT_FACTORS[unit];
+        return distanceInMeters / factor;
+    }
+    /**
+     * Переводит расстояние из заданной единицы измерения в метры.
+     *
+     * @param distance - Расстояние в выбранной единице измерения.
+     * @param unit - Единица, в которой передано расстояние.
+     * @returns Расстояние в метрах.
+     */
+    distanceToMeters(distance, unit = 'meters') {
+        const factor = DISTANCE_UNIT_FACTORS[unit];
+        return distance * factor;
+    }
+    /**
+     * Вычисляет общую длину ломаной линии (полилинии) по массиву координат.
+     *
+     * Суммирует расстояния между последовательными точками.
+     * По умолчанию возвращает метры, но можно указать другую единицу.
+     *
+     * @param coordinates - Массив координат, образующих ломаную линию.
+     * @param unit - Единица измерения результата (по умолчанию метры).
+     * @returns Общая длина полилинии в выбранной единице.
+     */
+    getPolylineLength(coordinates, unit = 'meters') {
+        const totalLengthInMeters = coordinates.reduce((totalLength, coordinate, index, coords) => {
+            const nextCoordinate = coords[index + 1];
+            if (!nextCoordinate)
+                return totalLength;
+            const segmentLength = this.haversineDistance(coordinate, nextCoordinate, 'meters');
+            return totalLength + segmentLength;
+        }, 0);
+        return this.convertDistance(totalLengthInMeters, unit);
+    }
 }
 /**
  * Сервис для работы с географическими координатами и базовыми

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

@@ -0,0 +1,11 @@
+import { DistanceUnit } from './map.types';
+/**
+ * Коэффициенты перевода единиц в метры.
+ *
+ * Значение — сколько метров содержится в одной единице.
+ *
+ * Основано на стандартных метрических и международных определениях
+ * (1 km = 1000 m, 1 mi = 1609.344 m, 1 NM = 1852 m и т.д.). [web:45][web:48][web:54]
+ */
+export declare const DISTANCE_UNIT_FACTORS: Record<DistanceUnit, number>;
+//# sourceMappingURL=map.constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map.constants.d.ts","sourceRoot":"","sources":["../../../src/services/map/map.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAK9D,CAAC"}

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

@@ -0,0 +1 @@
+const e={meters:1,kilometers:1e3,miles:1609.344,nauticalMiles:1852};export{e as DISTANCE_UNIT_FACTORS};

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

@@ -1,4 +1,5 @@
 import { Coordinate } from '../../lib';
+import { DistanceUnit } from './map.types';
 import { LatLng } from 'leaflet';
 declare class MapService {
     /**
@@ -78,26 +79,21 @@ declare class MapService {
      * Вычисляет координату точки назначения по исходной точке,
      * расстоянию и азимуту.
      *
-     * Расчет выполняется по формулам сферической геометрии,
-     * где Земля рассматривается как сфера с радиусом `EARTH_RADIUS_M`.
+     * Расстояние можно задавать в произвольной поддерживаемой единице
+     * (по умолчанию метры) — перед вычислениями оно будет переведено в метры.
      *
-     * @param params - Параметры расчета.
+     * @param params - Параметры расчёта.
      * @param params.coordinate - Исходная координата.
-     * @param params.distance - Расстояние до точки назначения в метрах.
+     * @param params.distance - Расстояние до точки назначения в заданной единице.
      * @param params.azimuth - Азимут движения в градусах.
+     * @param params.unit - Единица, в которой задано расстояние (по умолчанию метры).
      * @returns Координата точки назначения в формате `{ lat, lon }`.
-     *
-     * @example
-     * mapService.calculateDestination({
-     *   coordinate: { lat: 55.75, lon: 37.61 },
-     *   distance: 1000,
-     *   azimuth: 90,
-     * });
      */
-    calculateDestination: ({ coordinate, distance, azimuth, }: {
+    calculateDestination: ({ coordinate, distance, azimuth, unit, }: {
         coordinate: Coordinate;
         distance: number;
         azimuth: number;
+        unit?: DistanceUnit;
     }) => {
         lat: number;
         lon: number;
@@ -106,14 +102,15 @@ declare class MapService {
      * Вычисляет расстояние между двумя географическими точками
      * по формуле гаверсинуса.
      *
-     * Метод подходит для расчета кратчайшего расстояния по поверхности Земли
-     * между двумя координатами.
+     * По умолчанию возвращает значение в метрах, но можно запросить
+     * километры, мили или морские мили.
      *
      * @param a - Первая координата.
      * @param b - Вторая координата.
-     * @returns Расстояние между точками в метрах.
+     * @param unit - Единица измерения результата (по умолчанию метры).
+     * @returns Расстояние между точками в выбранной единице.
      */
-    haversineDistance(a: Coordinate, b: Coordinate): number;
+    haversineDistance(a: Coordinate, b: Coordinate, unit?: DistanceUnit): number;
     /**
      * Вычисляет начальный азимут из точки `a` в точку `b`.
      *
@@ -125,6 +122,33 @@ declare class MapService {
      * @returns Начальный азимут в градусах.
      */
     initialBearing(a: Coordinate, b: Coordinate): number;
+    /**
+     * Переводит расстояние в метрах в заданную единицу измерения.
+     *
+     * @param distanceInMeters - Расстояние в метрах.
+     * @param unit - Желаемая единица измерения (по умолчанию метры).
+     * @returns Расстояние в выбранной единице.
+     */
+    convertDistance(distanceInMeters: number, unit?: DistanceUnit): number;
+    /**
+     * Переводит расстояние из заданной единицы измерения в метры.
+     *
+     * @param distance - Расстояние в выбранной единице измерения.
+     * @param unit - Единица, в которой передано расстояние.
+     * @returns Расстояние в метрах.
+     */
+    private distanceToMeters;
+    /**
+     * Вычисляет общую длину ломаной линии (полилинии) по массиву координат.
+     *
+     * Суммирует расстояния между последовательными точками.
+     * По умолчанию возвращает метры, но можно указать другую единицу.
+     *
+     * @param coordinates - Массив координат, образующих ломаную линию.
+     * @param unit - Единица измерения результата (по умолчанию метры).
+     * @returns Общая длина полилинии в выбранной единице.
+     */
+    getPolylineLength(coordinates: Coordinate[], unit?: DistanceUnit): number;
 }
 /**
  * Сервис для работы с географическими координатами и базовыми

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;AAEnC,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;;;;;;;;;;;;;;;;;;;OAmBG;IACI,oBAAoB,GAAI,oCAI5B;QACD,UAAU,EAAE,UAAU,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB;;;MAsBC;IAEF;;;;;;;;;;OAUG;IACI,iBAAiB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU;IAiBrD;;;;;;;;;OASG;IACI,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU;CAiBnD;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,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"}

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

@@ -1 +1 @@
-import{a as t}from"../../_virtual/leaflet-src.esm.js";const a=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:a,lng:s}=t;return{lat:a,lon:s}}getLatLngByCoordinate(a){const{lat:s,lon:E}=a;return new t.LatLng(s,E)}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:a,azimuth:s})=>{const E=t.lat*this.DEG_TO_RAD,i=t.lon*this.DEG_TO_RAD,n=this.normalizeBearing(s)*this.DEG_TO_RAD,_=a/this.EARTH_RADIUS_M,h=Math.sin(E),D=Math.cos(E),R=Math.sin(_),e=Math.cos(_),o=Math.sin(n),r=Math.cos(n),L=Math.asin(h*e+D*R*r),l=i+Math.atan2(o*R*D,e-h*Math.sin(L));return{lat:L*this.RAD_TO_DEG,lon:this.normalizeLongitude(l*this.RAD_TO_DEG)}};haversineDistance(t,a){const s=t.lat*this.DEG_TO_RAD,E=a.lat*this.DEG_TO_RAD,i=(a.lat-t.lat)*this.DEG_TO_RAD,n=(a.lon-t.lon)*this.DEG_TO_RAD,_=Math.sin(i/2)**2+Math.cos(s)*Math.cos(E)*Math.sin(n/2)**2,h=2*Math.atan2(Math.sqrt(_),Math.sqrt(1-_));return this.EARTH_RADIUS_M*h}initialBearing(t,a){const s=t.lat*this.DEG_TO_RAD,E=a.lat*this.DEG_TO_RAD,i=t.lon*this.DEG_TO_RAD,n=a.lon*this.DEG_TO_RAD,_=Math.sin(n-i)*Math.cos(E),h=Math.cos(s)*Math.sin(E)-Math.sin(s)*Math.cos(E)*Math.cos(n-i);return this.normalizeBearing(Math.atan2(_,h)*this.RAD_TO_DEG)}};export{a as mapService};
+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};

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

@@ -0,0 +1,5 @@
+/**
+ * Поддерживаемые единицы измерения расстояния.
+ */
+export type DistanceUnit = 'meters' | 'kilometers' | 'miles' | 'nauticalMiles';
+//# sourceMappingURL=map.types.d.ts.map

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

@@ -0,0 +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"}

package/package.json

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