@artstesh/maps 11.0.0 → 11.0.1

package/dist/package.json

@@ -1,12 +1,12 @@
 {
   "name": "maps-components",
-  "version": "0.0.2",
+  "version": "11.0.1",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
     "ol-geocoder": "^4.0.0",
     "ol": "^10.0.0",
-    "@artstesh/postboy": "^3.3.0",
+    "@artstesh/postboy": "^3.4.0",
     "@artstesh/collections": "^1.0.0"
   },
   "dependencies": {

package/dist/types/maps-components-src-map.d.ts

@@ -12,7 +12,6 @@ import { Subscription } from 'rxjs';
 import { PostboyService, IPostboyDependingService, PostboyGenericMessage, PostboyAbstractRegistrator, PostboyCallbackMessage, PostboyExecutor } from '@artstesh/postboy';
 import Style, { StyleFunction, StyleLike } from 'ol/style/Style';
 export { StyleLike } from 'ol/style/Style';
-import { Dictionary } from '@artstesh/collections';
 import { XYZ, Raster } from 'ol/source';
 import TileLayer from 'ol/layer/Tile';
 import TileSource from 'ol/source/Tile';
@@ -228,6 +227,114 @@ interface MapPosition {
     extent: number[];
 }
 
+/**
+ * A generic class representing a dictionary structure with key-value pairs.
+ * Provides utilities for adding, updating, removing, and iterating over elements.
+ *
+ * @template T The type of values in the dictionary.
+ */
+declare class Dictionary<T> {
+    readonly collection: Record<string, T>;
+    private readonly _keys;
+    /**
+     * Creates a shallow copy of the given dictionary, optionally applying
+     * a transformation function to each element during the cloning process.
+     *
+     * @param {Dictionary<T>} dic - The dictionary to be cloned.
+     * @param {(e: T, k: string) => T} [action] - An optional transformation function
+     *        that is called for each element. The function takes the element value and
+     *        its key as arguments and returns the modified value.
+     * @return {Dictionary<T>} A new dictionary that is a clone of the input dictionary
+     *         with transformations applied if the action function is provided.
+     */
+    static clone<T>(dic: Dictionary<T>, action?: (e: T, k: string) => T): Dictionary<T>;
+    /**
+     * Creates a Dictionary instance from the given array of elements.
+     *
+     * @param {T[]} list - An array of elements to be converted into a Dictionary.
+     * @param {(e: T) => string} id - A function that produces a unique identifier for each element in the array.
+     * @return {Dictionary<T>} A Dictionary where the keys are unique identifiers derived from the elements of the array, and the values are the corresponding elements.
+     */
+    static fromList<T>(list: T[], id: (e: T) => string): Dictionary<T>;
+    /**
+     * Creates a new Dictionary instance from a given Record, optionally applying an action to each element.
+     *
+     * @param {Record<string, T>} dic The input dictionary object.
+     * @param {(e: T, k: string) => T} [action] An optional callback function to transform each element.
+     * The function receives the value and key of each element.
+     * @return {Dictionary<T>} A new Dictionary instance populated with the elements from the input dictionary,
+     * potentially transformed by the action callback if provided.
+     */
+    static create<T>(dic: Record<string, T>, action?: (e: T, k: string) => T): Dictionary<T>;
+    /**
+     * Retrieves all the keys as an array of strings from the internal data structure.
+     *
+     * @return {string[]} An array containing the keys.
+     */
+    get keys(): string[];
+    /**
+     * Retrieves the number of key-value pairs currently stored.
+     *
+     * @return {number} The current size of the collection.
+     */
+    get size(): number;
+    /**
+     * Finds and returns the first element in the collection that satisfies the provided predicate function.
+     *
+     * @param {function(T): boolean} predicate - A function used to test each element of the collection. Returns `true` to select the element, `false` otherwise.
+     * @return {T | null} The first element in the collection that satisfies the predicate, or `null` if no such element is found.
+     */
+    find(predicate: (value: T) => boolean): T | null;
+    /**
+     * Checks if a given key exists within the dictionary.
+     *
+     * @param {string} key - The key to check for existence in the collection.
+     * @returns {boolean} True if the key exists, false otherwise.
+     */
+    has: (key: string) => boolean;
+    /**
+     * Retrieves the value associated with the specified key from the collection if it exists.
+     *
+     * @param {string} key - The key whose associated value is to be retrieved.
+     * @return {T | null} The value associated with the specified key, or null if the key does not exist.
+     */
+    take(key: string): T | null;
+    /**
+     * Adds or updates a value associated with the specified key in the collection.
+     * If the value is null or undefined, removes the key from the collection.
+     *
+     * @param {string} key - The key to associate with the value in the collection.
+     * @param {T | null} [value] - The value to store in the collection. If null or undefined, the key will be removed.
+     * @return {void} Does not return a value.
+     */
+    put(key: string, value?: T | null): void;
+    /**
+     * Removes a specified key and its associated value from the collection.
+     *
+     * @param {string} key - The key to be removed from the collection.
+     * @return {void} Does not return a value.
+     */
+    rmv(key: string): void;
+    /**
+     * Adds a new entry or updates an existing entry in the collection based on the provided key.
+     * If the key already exists, it fetches the current value, applies the action, and replaces the value.
+     * If the key does not exist, it uses the action to create a new value and adds it.
+     *
+     * @param {string} key - The key associated with the value to add or update.
+     * @param {(current: T | null) => T} action - A function that takes the current value (if any) and returns the new value to be stored.
+     * @return {void} - Does not return a value.
+     */
+    addOrUpdate(key: string, action: (current: T | null) => T): void;
+    /**
+     * Iterates over each element in the collection and executes the provided callback function.
+     *
+     * @param {function(T, number): void} callback - A function that is called for each element of the collection.
+     *                                               It takes two arguments: the current element's value and the index.
+     * @return {void} This method does not return a value.
+     */
+    forEach(callback: (value: T, index: number) => void): void;
+}
+
 declare class DestructibleComponent implements OnDestroy {
     protected subs: Subscription[];
     protected onDestroy?: () => void;
@@ -1870,5 +1977,5 @@ declare class TooltipComponent extends DestructibleComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<TooltipComponent, "art-tooltip", never, { "contentRef": { "alias": "contentRef"; "required": true; "isSignal": true; }; "settings": { "alias": "settings"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { AddControlCommand, CalculateAreaExecutor, CancelDrawingCommand, CancelFeatureModificationCommand, CloseTooltipCommand, ClusterLayerComponent, ClusterLayerSettings, DrawSelectionAreaCommand, DrawingType, FeatureLayerComponent, FeatureLayerSettings, FeatureOutputFormat, FilterFeaturesInAreaExecutor, FilterFeaturesInPointExecutor, FitToFeaturesCommand, FitToPolygonsCommand, GeotiffTileLayerComponent, GeotiffTileLayerSettings, GetFeaturesInAreaQuery, GetFeaturesInPointQuery, GetGeometryLengthExecutor, GetMapPositionExecutor, ImageLayerComponent, ImageLayerSettings, MapClickEvent, MapConstants, MapControl, MapControlZoomComponent, MapFeatureHoveredEvent, MapLyrs, MapLyrsLabel, MapMoveEndEvent, MapPlateComponent, MapPointerMoveEvent, MapPostboyService, MapRenderedEvent, MapSettings, MarkerModel, MarkerStyleHelper, MarkersComponent, MessageRegistratorService, ModifyFeatureCommand, OsmTileLayerComponent, PolygonModel, PolygonSelfIntersectionExecutor, PolygonStyleHelper, PolygonsComponent, RasterTileLayerComponent, RasterTileLayerSettings, RemoveControlCommand, SetMapCenterCommand, StartDrawingCommand, StringifyFeatureHelper, TextStyleHelper, TileLayerComponent, TileLayerSettings, TooltipComponent, TooltipSettings, ZoomControlSettings };
+export { AddControlCommand, CalculateAreaExecutor, CancelDrawingCommand, CancelFeatureModificationCommand, CloseTooltipCommand, ClusterLayerComponent, ClusterLayerSettings, Dictionary, DrawSelectionAreaCommand, DrawingType, FeatureLayerComponent, FeatureLayerSettings, FeatureOutputFormat, FilterFeaturesInAreaExecutor, FilterFeaturesInPointExecutor, FitToFeaturesCommand, FitToPolygonsCommand, GeotiffTileLayerComponent, GeotiffTileLayerSettings, GetFeaturesInAreaQuery, GetFeaturesInPointQuery, GetGeometryLengthExecutor, GetMapPositionExecutor, ImageLayerComponent, ImageLayerSettings, MapClickEvent, MapConstants, MapControl, MapControlZoomComponent, MapFeatureHoveredEvent, MapLyrs, MapLyrsLabel, MapMoveEndEvent, MapPlateComponent, MapPointerMoveEvent, MapPostboyService, MapRenderedEvent, MapSettings, MarkerModel, MarkerStyleHelper, MarkersComponent, MessageRegistratorService, ModifyFeatureCommand, OsmTileLayerComponent, PolygonModel, PolygonSelfIntersectionExecutor, PolygonStyleHelper, PolygonsComponent, RasterTileLayerComponent, RasterTileLayerSettings, RemoveControlCommand, SetMapCenterCommand, StartDrawingCommand, StringifyFeatureHelper, TextStyleHelper, TileLayerComponent, TileLayerSettings, TooltipComponent, TooltipSettings, ZoomControlSettings };
 export type { MapPosition };

package/dist/types/maps-components.d.ts

@@ -12,7 +12,6 @@ import { Subscription } from 'rxjs';
 import { PostboyService, IPostboyDependingService, PostboyGenericMessage, PostboyAbstractRegistrator, PostboyCallbackMessage, PostboyExecutor } from '@artstesh/postboy';
 import Style, { StyleFunction, StyleLike } from 'ol/style/Style';
 export { StyleLike } from 'ol/style/Style';
-import { Dictionary } from '@artstesh/collections';
 import { XYZ, Raster } from 'ol/source';
 import TileLayer from 'ol/layer/Tile';
 import TileSource from 'ol/source/Tile';
@@ -228,6 +227,114 @@ interface MapPosition {
     extent: number[];
 }
 
+/**
+ * A generic class representing a dictionary structure with key-value pairs.
+ * Provides utilities for adding, updating, removing, and iterating over elements.
+ *
+ * @template T The type of values in the dictionary.
+ */
+declare class Dictionary<T> {
+    readonly collection: Record<string, T>;
+    private readonly _keys;
+    /**
+     * Creates a shallow copy of the given dictionary, optionally applying
+     * a transformation function to each element during the cloning process.
+     *
+     * @param {Dictionary<T>} dic - The dictionary to be cloned.
+     * @param {(e: T, k: string) => T} [action] - An optional transformation function
+     *        that is called for each element. The function takes the element value and
+     *        its key as arguments and returns the modified value.
+     * @return {Dictionary<T>} A new dictionary that is a clone of the input dictionary
+     *         with transformations applied if the action function is provided.
+     */
+    static clone<T>(dic: Dictionary<T>, action?: (e: T, k: string) => T): Dictionary<T>;
+    /**
+     * Creates a Dictionary instance from the given array of elements.
+     *
+     * @param {T[]} list - An array of elements to be converted into a Dictionary.
+     * @param {(e: T) => string} id - A function that produces a unique identifier for each element in the array.
+     * @return {Dictionary<T>} A Dictionary where the keys are unique identifiers derived from the elements of the array, and the values are the corresponding elements.
+     */
+    static fromList<T>(list: T[], id: (e: T) => string): Dictionary<T>;
+    /**
+     * Creates a new Dictionary instance from a given Record, optionally applying an action to each element.
+     *
+     * @param {Record<string, T>} dic The input dictionary object.
+     * @param {(e: T, k: string) => T} [action] An optional callback function to transform each element.
+     * The function receives the value and key of each element.
+     * @return {Dictionary<T>} A new Dictionary instance populated with the elements from the input dictionary,
+     * potentially transformed by the action callback if provided.
+     */
+    static create<T>(dic: Record<string, T>, action?: (e: T, k: string) => T): Dictionary<T>;
+    /**
+     * Retrieves all the keys as an array of strings from the internal data structure.
+     *
+     * @return {string[]} An array containing the keys.
+     */
+    get keys(): string[];
+    /**
+     * Retrieves the number of key-value pairs currently stored.
+     *
+     * @return {number} The current size of the collection.
+     */
+    get size(): number;
+    /**
+     * Finds and returns the first element in the collection that satisfies the provided predicate function.
+     *
+     * @param {function(T): boolean} predicate - A function used to test each element of the collection. Returns `true` to select the element, `false` otherwise.
+     * @return {T | null} The first element in the collection that satisfies the predicate, or `null` if no such element is found.
+     */
+    find(predicate: (value: T) => boolean): T | null;
+    /**
+     * Checks if a given key exists within the dictionary.
+     *
+     * @param {string} key - The key to check for existence in the collection.
+     * @returns {boolean} True if the key exists, false otherwise.
+     */
+    has: (key: string) => boolean;
+    /**
+     * Retrieves the value associated with the specified key from the collection if it exists.
+     *
+     * @param {string} key - The key whose associated value is to be retrieved.
+     * @return {T | null} The value associated with the specified key, or null if the key does not exist.
+     */
+    take(key: string): T | null;
+    /**
+     * Adds or updates a value associated with the specified key in the collection.
+     * If the value is null or undefined, removes the key from the collection.
+     *
+     * @param {string} key - The key to associate with the value in the collection.
+     * @param {T | null} [value] - The value to store in the collection. If null or undefined, the key will be removed.
+     * @return {void} Does not return a value.
+     */
+    put(key: string, value?: T | null): void;
+    /**
+     * Removes a specified key and its associated value from the collection.
+     *
+     * @param {string} key - The key to be removed from the collection.
+     * @return {void} Does not return a value.
+     */
+    rmv(key: string): void;
+    /**
+     * Adds a new entry or updates an existing entry in the collection based on the provided key.
+     * If the key already exists, it fetches the current value, applies the action, and replaces the value.
+     * If the key does not exist, it uses the action to create a new value and adds it.
+     *
+     * @param {string} key - The key associated with the value to add or update.
+     * @param {(current: T | null) => T} action - A function that takes the current value (if any) and returns the new value to be stored.
+     * @return {void} - Does not return a value.
+     */
+    addOrUpdate(key: string, action: (current: T | null) => T): void;
+    /**
+     * Iterates over each element in the collection and executes the provided callback function.
+     *
+     * @param {function(T, number): void} callback - A function that is called for each element of the collection.
+     *                                               It takes two arguments: the current element's value and the index.
+     * @return {void} This method does not return a value.
+     */
+    forEach(callback: (value: T, index: number) => void): void;
+}
+
 declare class DestructibleComponent implements OnDestroy {
     protected subs: Subscription[];
     protected onDestroy?: () => void;
@@ -1870,5 +1977,5 @@ declare class TooltipComponent extends DestructibleComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<TooltipComponent, "art-tooltip", never, { "contentRef": { "alias": "contentRef"; "required": true; "isSignal": true; }; "settings": { "alias": "settings"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { AddControlCommand, CalculateAreaExecutor, CancelDrawingCommand, CancelFeatureModificationCommand, CloseTooltipCommand, ClusterLayerComponent, ClusterLayerSettings, DrawSelectionAreaCommand, DrawingType, FeatureLayerComponent, FeatureLayerSettings, FeatureOutputFormat, FilterFeaturesInAreaExecutor, FilterFeaturesInPointExecutor, FitToFeaturesCommand, FitToPolygonsCommand, GeotiffTileLayerComponent, GeotiffTileLayerSettings, GetFeaturesInAreaQuery, GetFeaturesInPointQuery, GetGeometryLengthExecutor, GetMapPositionExecutor, ImageLayerComponent, ImageLayerSettings, MapClickEvent, MapConstants, MapControl, MapControlZoomComponent, MapFeatureHoveredEvent, MapLyrs, MapLyrsLabel, MapMoveEndEvent, MapPlateComponent, MapPointerMoveEvent, MapPostboyService, MapRenderedEvent, MapSettings, MarkerModel, MarkerStyleHelper, MarkersComponent, MessageRegistratorService, ModifyFeatureCommand, OsmTileLayerComponent, PolygonModel, PolygonSelfIntersectionExecutor, PolygonStyleHelper, PolygonsComponent, RasterTileLayerComponent, RasterTileLayerSettings, RemoveControlCommand, SetMapCenterCommand, StartDrawingCommand, StringifyFeatureHelper, TextStyleHelper, TileLayerComponent, TileLayerSettings, TooltipComponent, TooltipSettings, ZoomControlSettings };
+export { AddControlCommand, CalculateAreaExecutor, CancelDrawingCommand, CancelFeatureModificationCommand, CloseTooltipCommand, ClusterLayerComponent, ClusterLayerSettings, Dictionary, DrawSelectionAreaCommand, DrawingType, FeatureLayerComponent, FeatureLayerSettings, FeatureOutputFormat, FilterFeaturesInAreaExecutor, FilterFeaturesInPointExecutor, FitToFeaturesCommand, FitToPolygonsCommand, GeotiffTileLayerComponent, GeotiffTileLayerSettings, GetFeaturesInAreaQuery, GetFeaturesInPointQuery, GetGeometryLengthExecutor, GetMapPositionExecutor, ImageLayerComponent, ImageLayerSettings, MapClickEvent, MapConstants, MapControl, MapControlZoomComponent, MapFeatureHoveredEvent, MapLyrs, MapLyrsLabel, MapMoveEndEvent, MapPlateComponent, MapPointerMoveEvent, MapPostboyService, MapRenderedEvent, MapSettings, MarkerModel, MarkerStyleHelper, MarkersComponent, MessageRegistratorService, ModifyFeatureCommand, OsmTileLayerComponent, PolygonModel, PolygonSelfIntersectionExecutor, PolygonStyleHelper, PolygonsComponent, RasterTileLayerComponent, RasterTileLayerSettings, RemoveControlCommand, SetMapCenterCommand, StartDrawingCommand, StringifyFeatureHelper, TextStyleHelper, TileLayerComponent, TileLayerSettings, TooltipComponent, TooltipSettings, ZoomControlSettings };
 export type { MapPosition };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artstesh/maps",
-  "version": "11.0.0",
+  "version": "11.0.1",
   "author": "artstesh",
   "license": "MIT",
   "description": "Let's draw a map ;)",
@@ -11,7 +11,7 @@
     "build": "ng build",
     "prepare": "npm run build",
     "preversion": "npm test",
-    "version": "npm run format && git add -A projects",
+    "version": "npm run format && node scripts/sync-version.js && git add -A projects",
     "format": "prettier --write \"projects/**/*.ts\"",
     "postversion": "git push && git push --tags",
     "watch": "ng build --watch --configuration development",
@@ -30,9 +30,8 @@
     "markers"
   ],
   "module": "dist/fesm2022/maps-components.mjs",
-  "main": "dist/esm2022/public-api.mjs",
-  "types": "dist/public-api.d.ts",
-  "typings": "dist/index.d.ts",
+  "types": "dist/types/maps-components.d.ts",
+  "typings": "dist/types/maps-components.d.ts",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/artstesh/maps.git"
@@ -42,14 +41,12 @@
     "@angular/core": "^22.0.0",
     "ol-geocoder": "^4.0.0",
     "ol": "^10.0.0",
-    "@artstesh/postboy": "^3.4.0",
-    "@artstesh/collections": "^1.0.0"
+    "@artstesh/postboy": "^3.4.0"
   },
   "devDependencies": {
     "@angular/common": "22.1.6",
     "@angular/compiler": "22.1.6",
     "@angular/core": "22.1.6",
-    "@artstesh/collections": "1.0.4",
     "@artstesh/postboy": "3.4.2",
     "ol": "10.7.2",
     "ol-geocoder": "4.3.3",
@@ -108,5 +105,18 @@
     "extends": [
       "plugin:storybook/recommended"
     ]
+  },
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./dist/types/maps-components.d.ts",
+      "default": "./dist/fesm2022/maps-components.mjs"
+    },
+    "./src/map": {
+      "types": "./dist/types/maps-components-src-map.d.ts",
+      "default": "./dist/fesm2022/maps-components-src-map.mjs"
+    }
   }
 }