@igo2/context 19.0.0-next.9 → 19.0.0

package/lib/context-manager/shared/context.interface.d.ts

@@ -26,9 +26,9 @@ export type ExtraFeatures = FeatureCollection & {
     visible: boolean;
 };
 export interface DetailedContext extends Context {
+    layers?: AnyLayerOptions[];
     base?: string;
     map?: ContextMap;
-    layers?: AnyLayerOptions[];
     tools?: Tool[];
     toolbar?: string[];
     message?: Message;

package/lib/context-manager/shared/context.service.d.ts

@@ -9,6 +9,7 @@ import { StorageService } from '@igo2/core/storage';
 import type { AnyLayer, IgoMap } from '@igo2/geo';
 import { ExportService } from '@igo2/geo';
 import { BehaviorSubject, Observable, Subject } from 'rxjs';
+import { ShareMapService } from '../../share-map/shared/share-map.service';
 import { TypePermission } from './context.enum';
 import { Context, ContextPermission, ContextProfils, ContextsList, DetailedContext } from './context.interface';
 import * as i0 from "@angular/core";
@@ -20,6 +21,7 @@ export declare class ContextService {
     private messageService;
     private storageService;
     private exportService;
+    private shareMapService;
     private route;
     context$: BehaviorSubject<DetailedContext>;
     contexts$: BehaviorSubject<ContextsList>;
@@ -35,7 +37,7 @@ export declare class ContextService {
     get defaultContextUri(): string;
     set defaultContextUri(uri: string);
     private _defaultContextUri;
-    constructor(http: HttpClient, authService: AuthService, languageService: LanguageService, config: ConfigService, messageService: MessageService, storageService: StorageService, exportService: ExportService, route: RouteService);
+    constructor(http: HttpClient, authService: AuthService, languageService: LanguageService, config: ConfigService, messageService: MessageService, storageService: StorageService, exportService: ExportService, shareMapService: ShareMapService, route: RouteService);
     get(permissions?: string[], hidden?: boolean): Observable<ContextsList>;
     getById(id: string): Observable<Context>;
     getDetails(id: string): Observable<DetailedContext>;
@@ -69,12 +71,11 @@ export declare class ContextService {
     private handleContextMessage;
     private getContextByUri;
     getContextLayers(map: IgoMap): readonly AnyLayer[];
-    private readParamsFromRoute;
     private getPath;
     private handleError;
     private handleContextsChange;
     private addContextToList;
     private findContext;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ContextService, [null, null, null, null, null, null, null, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ContextService, [null, null, null, null, null, null, null, null, { optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ContextService>;
 }

package/lib/context-manager/shared/layer-context.directive.d.ts

@@ -1,8 +1,8 @@
-import { OnDestroy, OnInit } from '@angular/core';
+import { EventEmitter, OnDestroy, OnInit } from '@angular/core';
 import { ConfigService } from '@igo2/core/config';
-import { RouteService } from '@igo2/core/route';
 import { LayerService, MapBrowserComponent, StyleListService, StyleService } from '@igo2/geo';
 import type { IgoMap } from '@igo2/geo';
+import { ShareMapService } from '../../share-map/shared/share-map.service';
 import { ContextService } from './context.service';
 import * as i0 from "@angular/core";
 export declare class LayerContextDirective implements OnInit, OnDestroy {
@@ -12,19 +12,20 @@ export declare class LayerContextDirective implements OnInit, OnDestroy {
     private configService;
     private styleListService;
     private styleService;
-    private route;
+    private shareMapService;
     private context$$;
     private queryParams;
     private contextLayers;
     removeLayersOnContextChange: boolean;
+    contextLayersLoaded: EventEmitter<boolean>;
     get map(): IgoMap;
-    constructor(component: MapBrowserComponent, contextService: ContextService, layerService: LayerService, configService: ConfigService, styleListService: StyleListService, styleService: StyleService, route: RouteService);
+    constructor(component: MapBrowserComponent, contextService: ContextService, layerService: LayerService, configService: ConfigService, styleListService: StyleListService, styleService: StyleService, shareMapService: ShareMapService);
     ngOnInit(): void;
     ngOnDestroy(): void;
     private handleContextChange;
-    private getFlattenOptions;
     private handleAddLayers;
     private computeLayerVisibilityFromUrl;
-    static ɵfac: i0.ɵɵFactoryDeclaration<LayerContextDirective, [null, null, null, null, null, null, { optional: true; }]>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<LayerContextDirective, "[igoLayerContext]", never, { "removeLayersOnContextChange": { "alias": "removeLayersOnContextChange"; "required": false; }; }, {}, never, never, true, never>;
+    private handleContextWithSharedUrl;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LayerContextDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<LayerContextDirective, "[igoLayerContext]", never, { "removeLayersOnContextChange": { "alias": "removeLayersOnContextChange"; "required": false; }; }, { "contextLayersLoaded": "contextLayersLoaded"; }, never, never, true, never>;
 }

package/lib/context-manager/shared/map-context.directive.d.ts

@@ -2,15 +2,18 @@ import { OnDestroy, OnInit } from '@angular/core';
 import { MediaService } from '@igo2/core/media';
 import { MapBrowserComponent } from '@igo2/geo';
 import type { IgoMap } from '@igo2/geo';
+import { ShareMapService } from '../../share-map/shared/share-map.service';
 import { ContextService } from './context.service';
 import * as i0 from "@angular/core";
 export declare class MapContextDirective implements OnInit, OnDestroy {
     private contextService;
     private mediaService;
+    private shareMapService;
     private component;
     private context$$;
     get map(): IgoMap;
-    constructor(component: MapBrowserComponent, contextService: ContextService, mediaService: MediaService);
+    private queryParams;
+    constructor(component: MapBrowserComponent, contextService: ContextService, mediaService: MediaService, shareMapService: ShareMapService);
     ngOnInit(): void;
     ngOnDestroy(): void;
     private handleContextChange;

package/lib/share-map/share-map/share-map-api.component.d.ts

@@ -5,6 +5,7 @@ import { AuthService } from '@igo2/auth';
 import { LanguageService } from '@igo2/core/language';
 import { MessageService } from '@igo2/core/message';
 import type { IgoMap } from '@igo2/geo';
+import { ContextService } from '../../context-manager';
 import { ShareMapService } from '../shared/share-map.service';
 import * as i0 from "@angular/core";
 export declare class ShareMapApiComponent implements OnInit {
@@ -14,17 +15,20 @@ export declare class ShareMapApiComponent implements OnInit {
     private auth;
     private shareMapService;
     private formBuilder;
+    private contextService;
     form: UntypedFormGroup;
     map: IgoMap;
     url: string;
     userId: string;
     idContextShared: string;
-    constructor(clipboard: Clipboard, languageService: LanguageService, messageService: MessageService, auth: AuthService, shareMapService: ShareMapService, formBuilder: UntypedFormBuilder);
+    constructor(clipboard: Clipboard, languageService: LanguageService, messageService: MessageService, auth: AuthService, shareMapService: ShareMapService, formBuilder: UntypedFormBuilder, contextService: ContextService);
     ngOnInit(): void;
     createUrl(values?: any): void;
     updateContextShared(values?: any): void;
     copyTextToClipboard(textArea: HTMLTextAreaElement): void;
     buildForm(): void;
+    private createContextShared;
+    private _updateContextShared;
     static ɵfac: i0.ɵɵFactoryDeclaration<ShareMapApiComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ShareMapApiComponent, "igo-share-map-api", never, { "map": { "alias": "map"; "required": false; }; }, {}, never, never, true, never>;
 }

package/lib/share-map/share-map/share-map-url.component.d.ts

@@ -1,27 +1,27 @@
 import { Clipboard } from '@angular/cdk/clipboard';
-import { AfterViewInit, ChangeDetectorRef, OnDestroy, OnInit } from '@angular/core';
+import { ChangeDetectorRef, OnDestroy, OnInit } from '@angular/core';
 import { MessageService } from '@igo2/core/message';
+import { RouteService } from '@igo2/core/route';
 import type { IgoMap } from '@igo2/geo';
+import { ContextService } from '../../context-manager/shared/context.service';
 import { ShareMapService } from '../shared/share-map.service';
 import * as i0 from "@angular/core";
-export declare class ShareMapUrlComponent implements AfterViewInit, OnInit, OnDestroy {
+export declare class ShareMapUrlComponent implements OnInit, OnDestroy {
     private clipboard;
     private messageService;
     private shareMapService;
+    private contextService;
     private cdRef;
+    private route;
     private mapState$$;
     map: IgoMap;
     url: string;
-    publicShareOption: {
-        layerlistControls: {
-            querystring: string;
-        };
-    };
-    constructor(clipboard: Clipboard, messageService: MessageService, shareMapService: ShareMapService, cdRef: ChangeDetectorRef);
+    private publicShareOption;
+    private language;
+    constructor(clipboard: Clipboard, messageService: MessageService, shareMapService: ShareMapService, contextService: ContextService, cdRef: ChangeDetectorRef, route: RouteService);
     ngOnInit(): void;
-    ngAfterViewInit(): void;
     ngOnDestroy(): void;
-    resetUrl(): void;
+    generateUrl(): void;
     copyTextToClipboard(textArea: HTMLTextAreaElement): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ShareMapUrlComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ShareMapUrlComponent, "igo-share-map-url", never, { "map": { "alias": "map"; "required": false; }; }, {}, never, never, true, never>;

package/lib/share-map/shared/index.d.ts

@@ -1 +1,4 @@
 export * from './share-map.service';
+export * from './share-map-legacy.service';
+export * from './share-map.interface';
+export * from './share-map.utils';

package/lib/share-map/shared/share-map-definitions.d.ts

@@ -0,0 +1,2 @@
+import { ShareMapKeysDefinitions, ShareMapRouteKeysOptions } from './share-map.interface';
+export declare function shareMapKeyDefs(options: ShareMapRouteKeysOptions): ShareMapKeysDefinitions;

package/lib/share-map/shared/share-map-encoder.d.ts

@@ -0,0 +1,62 @@
+import { IgoMap } from '@igo2/geo';
+import type { DetailedContext } from '../../context-manager';
+import { ShareMapKeysDefinitions, ShareOption } from './share-map.interface';
+export declare class ShareMapEncoder {
+    private SHARE_MAP_DEFS;
+    private document;
+    private context;
+    constructor(SHARE_MAP_DEFS: ShareMapKeysDefinitions, document: Document);
+    generateUrl(map: IgoMap, context: DetailedContext, publicShareOption: ShareOption, language: string | undefined): string;
+    /**
+     * Replaces local group IDs with unique IDs to avoid conflicts and have short URL.
+     * This is necessary for sharing the map context.
+     */
+    private replaceGroupLocalIds;
+    private getUniqueId;
+    private getCurrentContext;
+    /**
+     * Filters layers to include only LayerGroups or LayerItems with a valid ServiceType.
+     */
+    private isLayerSharable;
+    /**
+     * Extracts only LayerGroup items from the filtered layers.
+     */
+    private getLayerGroups;
+    /**
+     * Extracts only LayerItem items from the filtered layers.
+     */
+    private getLayerItems;
+    private buildQueryUrl;
+    /**
+     * Retrieves the current context layers and maps them by identifier.
+     */
+    private getContextLayersMap;
+    /**
+     * Filters layers and context layers based on visibility, opacity, and expanded state.
+     */
+    private getFilteredMapLayers;
+    private getIdsNestedParent;
+    private generateLayersOptionsByService;
+    private generateLayerOption;
+    private getLayerNames;
+    private getWmsVersion;
+    private concatUrlWithVersion;
+    private getLayerParams;
+    private getOpacity;
+    private getVisibility;
+    private getQueryString;
+    private buildLayersQueryUrl;
+    private stringifyLayerParams;
+    private getBaseUrlConfig;
+    private sanitizeBaseUrl;
+    private extractKeys;
+    private getPosition;
+    private getProjection;
+    private getZoom;
+    private getRotation;
+    private stringifyPosition;
+    private stringifyDefinitions;
+    private buildGroupsQueryUrl;
+    private getLayerGroupParams;
+    private stringifyGroupParams;
+}

package/lib/share-map/shared/share-map-legacy.service.d.ts

@@ -0,0 +1,18 @@
+import { Params } from '@angular/router';
+import { RouteServiceOptions } from '@igo2/core/route';
+import { LayerOptions } from '@igo2/geo';
+import { PositionParams } from './share-map.interface';
+export declare class ShareMapLegacyParser {
+    private options;
+    constructor(options: RouteServiceOptions);
+    parseUrl(params: Params): LayerOptions[] | undefined;
+    parsePosition(params: Params): PositionParams;
+    private readLayersQueryParamsByType;
+    private getQueryKeyByType;
+    private sanitizeUrl;
+    private getQueryParam;
+    private extractLayersByService;
+    private removeParenthesis;
+    private extractLayersOptions;
+    private computeLayerVisibilityFromUrl;
+}

package/lib/share-map/shared/share-map-parser.d.ts

@@ -0,0 +1,20 @@
+import { Params } from '@angular/router';
+import { RouteServiceOptions } from '@igo2/core/route';
+import { type AnyLayerOptions } from '@igo2/geo';
+import { ShareMapLegacyParser } from './share-map-legacy.service';
+import { PositionParams, ShareMapKeysDefinitions } from './share-map.interface';
+export declare class ShareMapParser {
+    private keysDefinitions;
+    private legacyOptions;
+    legacy: ShareMapLegacyParser;
+    constructor(keysDefinitions: ShareMapKeysDefinitions, legacyOptions: RouteServiceOptions);
+    parseLayers(params: Params): AnyLayerOptions[] | undefined;
+    private splitParam;
+    parsePosition(params: Params): PositionParams | undefined;
+    private parseLayer;
+    private parseGroup;
+    private extractVersionFromUrl;
+    private extractUrlIndex;
+    private extractLayerNames;
+    private extractLayerProperties;
+}

package/lib/share-map/shared/share-map.interface.d.ts

@@ -0,0 +1,81 @@
+import { RouteServiceOptions } from '@igo2/core/route';
+import { LayerGroupOptions, LayerOptions } from '@igo2/geo';
+export declare const ServiceType: readonly ["wms", "wmts", "arcgisrest", "imagearcgisrest", "tilearcgisrest"];
+export type ServiceType = (typeof ServiceType)[number];
+export declare enum ServiceTypeEnum {
+    wms = 0,
+    wmts = 1,
+    arcgisrest = 2,
+    imagearcgisrest = 3,
+    tilearcgisrest = 4
+}
+export interface ShareOption {
+    layerlistControls: {
+        querystring: string;
+    };
+}
+export declare const LayerParamsKeys: readonly ["index", "names", "type", "version", "queryString", "visible", "opacity", "zIndex", "parentId"];
+export type LayerParamsKeys = (typeof LayerParamsKeys)[number];
+export declare const GroupParamsKeys: readonly ["title", "id", "expanded", "visible", "opacity", "zIndex", "parentId"];
+export type GroupParamsKeys = (typeof GroupParamsKeys)[number];
+declare const PositionParamsKeys: readonly ["center", "zoom", "rotation", "projection"];
+type PositionParamsKeys = (typeof PositionParamsKeys)[number];
+export interface ShareMapKeysDefinitions {
+    urlsKey: string;
+    contextKey: string;
+    languageKey: string;
+    pos: DefinitionKeyParams<PositionParamsKeys>;
+    layers: DefinitionKeyParams<LayerParamsKeys>;
+    groups: DefinitionKeyParams<GroupParamsKeys>;
+}
+export interface DefinitionKeyParams<T extends string> extends BaseKeyParams {
+    params: DefinitionParams<T>;
+}
+export type DefinitionParams<T extends string = string> = Record<T, BaseKeyParams | undefined>;
+export interface BaseKeyParams {
+    key: string;
+    parse?: (value: string) => unknown;
+    stringify?: (value: unknown) => string;
+}
+export interface PositionParams {
+    center?: [number, number];
+    zoom?: number;
+    rotation?: number;
+    projection?: string;
+}
+export interface LayerProperties {
+    zIndex: number;
+    visibility: boolean;
+    type: ServiceType;
+    opacity: number;
+    parentId: string;
+}
+export interface UrlParsedParam {
+    position: PositionParams;
+    layersOptions: LayerOptions[];
+    context: string;
+}
+export type LayerParams = BaseLayerParams & {
+    index: number;
+    names: string;
+    type: string;
+    queryString?: string;
+};
+export type GroupParams = BaseLayerParams & Pick<LayerGroupOptions, 'title' | 'id'> & {
+    expanded?: boolean;
+};
+type BaseLayerParams = Pick<LayerOptions, 'visible' | 'opacity' | 'zIndex' | 'parentId'>;
+export interface ShareMapRouteKeysOptions extends RouteServiceOptions {
+    context: string;
+    urls: string;
+    position: string;
+    layers: string;
+    groups: string;
+    center: string;
+    zoom: string;
+    projection: string;
+    rotation: string;
+    opacity: string;
+}
+export declare const SHARE_MAP_KEYS_DEFAULT_OPTIONS: ShareMapRouteKeysOptions;
+export {};

package/lib/share-map/shared/share-map.service.d.ts

@@ -1,17 +1,23 @@
-import { RouteService } from '@igo2/core/route';
-import type { IgoMap } from '@igo2/geo';
-import { ContextService } from '../../context-manager/shared/context.service';
+import { Params } from '@angular/router';
+import { RouteService, RouteServiceOptions } from '@igo2/core/route';
+import { ShareMapEncoder } from './share-map-encoder';
+import { ShareMapParser } from './share-map-parser';
+import { ShareMapKeysDefinitions, ShareMapRouteKeysOptions } from './share-map.interface';
 import * as i0 from "@angular/core";
 export declare class ShareMapService {
-    private contextService;
-    private route;
+    routeService: RouteService;
+    document: Document;
     private language;
-    constructor(contextService: ContextService, route: RouteService);
+    options: ShareMapRouteKeysOptions;
+    optionsLegacy: RouteServiceOptions;
+    keysDefinitions: ShareMapKeysDefinitions;
+    encoder: ShareMapEncoder;
+    parser: ShareMapParser;
+    constructor(routeService: RouteService, document: Document);
+    getContext(params: Params): string | undefined;
+    getZoom(params: Params): number | undefined;
     getUrlWithApi(formValues: any): string;
-    createContextShared(map: IgoMap, formValues: any): import("rxjs").Observable<import("../../context-manager/shared/context.interface").Context>;
-    updateContextShared(map: IgoMap, formValues: any, id: string): import("rxjs").Observable<import("../../context-manager/shared/context.interface").Context>;
-    getUrlWithoutApi(map: IgoMap, publicShareOption: any): string;
-    private makeLayersByService;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ShareMapService, [null, { optional: true; }]>;
+    hasPositionParams(params: Params): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ShareMapService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ShareMapService>;
 }

package/lib/share-map/shared/share-map.utils.d.ts

@@ -0,0 +1,13 @@
+import { Params } from '@angular/router';
+import { RouteServiceOptions } from '@igo2/core/route';
+import { AnyDataSourceOptions, AnyLayerOptions } from '@igo2/geo';
+import { ServiceType, ShareMapKeysDefinitions } from './share-map.interface';
+export declare function buildDataSourceOptions(type: ServiceType, url: string, layers: string[], version: string): AnyDataSourceOptions;
+export declare function getFlattenOptions(options: AnyLayerOptions[]): AnyLayerOptions[];
+/**
+ * Checks if the provided query parameters contain legacy parameter pairs
+ * (e.g., layers and URLs) that indicate older configuration formats.
+ */
+export declare function hasLegacyParams(params: Params, optionsLegacy: RouteServiceOptions): boolean;
+export declare function hasModernShareParams(params: Params, keysDefinitions: ShareMapKeysDefinitions): boolean;
+export declare function getParamValue(params: Params, key: string): string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@igo2/context",
-  "version": "19.0.0-next.9",
+  "version": "19.0.0",
   "description": "IGO Library",
   "author": "IGO Community",
   "keywords": [
@@ -21,12 +21,15 @@
       "default": "./fesm2022/igo2-context.mjs"
     },
     "./theme": {
-      "sass": "./src/context-theme.scss"
+      "sass": "./src/context.theme.scss"
     },
     "./package.json": {
       "default": "./package.json"
     }
   },
+  "dependencies": {
+    "tslib": "^2.6.0"
+  },
   "peerDependencies": {
     "@angular/animations": "^19.0.0",
     "@angular/common": "^19.0.0",
@@ -34,17 +37,14 @@
     "@angular/forms": "^19.0.0",
     "@angular/material": "^19.0.0",
     "@angular/platform-browser": "^19.0.0",
-    "@igo2/auth": "^19.0.0-next.9",
-    "@igo2/common": "^19.0.0-next.9",
-    "@igo2/core": "^19.0.0-next.9",
-    "@igo2/geo": "^19.0.0-next.9",
-    "@igo2/utils": "^19.0.0-next.9",
-    "ol": "9.1.0",
+    "@igo2/auth": "^19.0.0",
+    "@igo2/common": "^19.0.0",
+    "@igo2/core": "^19.0.0",
+    "@igo2/geo": "^19.0.0",
+    "@igo2/utils": "^19.0.0",
+    "ol": "10.6.0",
     "rxjs": "^7.8.0"
   },
-  "dependencies": {
-    "tslib": "^2.6.0"
-  },
   "engines": {
     "node": "^18.19.1 || ^20.11.1 || >=22.0.0"
   },

package/src/{context-theme.scss → context.theme.scss}

@@ -1,5 +1,5 @@
 @use './lib/context-manager/context-manager.theming.scss' as context-manager;
 
-@mixin context-component-themes($theme) {
+@mixin themes($theme) {
   @include context-manager.themes($theme);
 }

package/src/lib/context-manager/context-item/context-item.theming.scss

@@ -6,7 +6,7 @@
 }
 
 @mixin density($theme) {
-  $density: mat.m2-get-density-config($theme);
+  $density: mat.get-theme-density($theme);
 
   $theme: map.merge(
     $theme,

package/src/lib/context-manager/context-list/context-list.theming.scss

@@ -6,7 +6,7 @@
 }
 
 @mixin density($theme) {
-  $density: mat.m2-get-density-config($theme);
+  $density: mat.get-theme-density($theme);
 
   $theme: map.merge(
     $theme,