@geogirafe/lib-geoportal 1.0.2251126674 → 1.0.2259617981

package/components/basemap/component.js

@@ -18,12 +18,11 @@ class BasemapComponent extends GirafeHTMLElement {
         if (basemap.opacity == 0)
             return;
         const newBasemapProjection = basemap.projection ?? this.context.configManager.Config.map.srid;
-        const opacityDisabled = basemap.opacity == -1;
         const activeBasemaps = [...this.state.activeBasemaps];
-        if (opacityDisabled) {
+        if (basemap.opacityDisabled) {
             // Normal basemap change (no opacity basemap)
             this.state.projection = newBasemapProjection;
-            const idx = activeBasemaps.findIndex((activeBasemap) => activeBasemap.opacity == -1);
+            const idx = activeBasemaps.findIndex((activeBasemap) => activeBasemap.opacityDisabled);
             if (idx >= 0) {
                 activeBasemaps.splice(idx, 1);
             }
@@ -51,7 +50,7 @@ class BasemapComponent extends GirafeHTMLElement {
     }
     changeBasemapOpacity(basemap, e) {
         e.stopPropagation();
-        if (basemap.opacity == -1) {
+        if (basemap.opacityDisabled) {
             console.warn(`Trying to set Opacity on Basemap '${basemap.name}' which does not allow it`);
             return;
         }

package/components/extlayers/component.js

@@ -15,7 +15,7 @@ class ExternalLayersComponent extends GirafeHTMLElement {
 </style><style>
 #panel{background:var(--bkg-color);height:100%;color:var(--text-color);flex-direction:column;padding:0 1rem;display:flex}#content{flex-direction:column;flex-grow:1;margin:0;display:flex}header{background-color:var(--bkg-color);margin:0;position:sticky;top:-5px}h4{margin-bottom:.5rem}ul{margin-top:0;margin-left:0;padding-left:2rem;line-height:1.3rem;list-style-type:disc}.clearable-input{background-color:var(--bkg-color);border:1px solid #cfd6dd;border-radius:4px;flex-direction:row;margin-bottom:.1rem;display:flex}.scan-button{float:right}.layers{border-top:1px solid #ccc;flex-direction:column;flex-grow:1;margin-top:1rem;padding-top:.5rem;display:flex;overflow:hidden}ul.results{border:none;margin-bottom:.5rem;padding:0;list-style:none;overflow-y:auto}.result{height:1.6rem;display:flex}.result>button>span{text-align:left;white-space:nowrap;text-overflow:ellipsis;overflow:hidden}#panel>div{padding:1rem}#layers li{margin-top:.3rem;margin-bottom:.3rem}#layers li button{text-align:left;overflow-wrap:anywhere;text-wrap-style:balance}#file-selector{display:grid}#file,#file-label{grid-area:1/1}#file{opacity:0;z-index:2;cursor:pointer}#file::file-selector-button{cursor:pointer}#loading-icon{flex-grow:1;align-self:center;width:3rem}.title{margin-top:0}.filter-buttons{flex-direction:row;margin:2px;display:flex}.filter-buttons span{flex-grow:1;align-self:center}.clearable-input-field{width:90%;color:var(--text-color);background:0 0;border:0;outline:none;flex:auto;padding:0;font-size:1rem}.filter-icon,.delete-icon{width:16px;color:var(--text-color);padding:0 .5rem}.delete-button{cursor:pointer;background-color:#0000;border:none;padding:0}
 </style>
-<div id="panel"><header class="gg-tabs"><button class="${this.selectedTab === 'wms_wmts' ? 'gg-tab active' : 'gg-tab'}" onclick="${() => this.setSelectedTab('wms_wmts')}" i18n="wms_wmts"></button> <button class="${this.selectedTab === 'file' ? 'gg-tab active' : 'gg-tab'}" onclick="${() => this.setSelectedTab('file')}" i18n="local file"></button></header><section class="${(this.selectedTab === 'wms_wmts') ? 'group' : 'hidden'}"><h4 class="title" i18n="Suggestions" ?hidden="${this.hasPredefinedWmsWmtsSources}">Suggestions</h4><ul class="suggestions" ?hidden="${this.hasPredefinedWmsWmtsSources}">${this.predefinedWmsWmtsSources.map(source => uHtmlFor(source, source.label) `<li><a href="javascript:void(0)" onclick="${() => this.scanSource(source.url, source.type)}">${source.label}</a></li>`)}</ul><h4 class="title" i18n="Custom service URL">Custom service URL</h4><div class="clearable-input"><input id="url" class="gg-input clearable-input-field" oninput="${() => this.typeUrl()}"><br><button id="clear-url" class="delete-button hidden" onclick="${() => this.clearUrl()}"><img class="delete-icon" alt="delete-button-icon" tip="Reset filter" i18n="Reset filter" src="icons/trash.svg"></button></div><button i18n="Scan Source" class="gg-button scan-button" onclick="${() => this.scanSource()}">Scan Source</button></section><section class="${(this.selectedTab === 'file') ? 'group' : 'hidden'}"><h4 class="title" i18n="Choose local file">Choose local file</h4><div id="file-selector"><label for="file" id="file-label"><button class="gg-button" i18n="Select File"></button> <span>${this.fileDescription}</span></label> <input type="file" accept=".gpx,.kml,.geojson,.json" id="file" onchange="${() => this.render()}"><br></div><button id="load" i18n="Load File" class="gg-button" onclick="${() => this.loadFile()}"></button></section><section class="${(this.selectedTab === 'wms_wmts' && this.externalLayers.length > 0) || this.loading ? 'layers' : 'hidden'}"><h4 class="title" i18n="Layers (from Capabilities)">Layers (from Capabilities)</h4><div class="clearable-input"><img class="filter-icon" alt="filter-button-icon" src="icons/filter.svg"> <input id="layer-search-field" class="gg-input clearable-input-field" placeholder="${this.context.i18nManager.getTranslation('Filter external layers...')}" i18n="Filter external layers..." autocomplete="off" autocorrect="off" oninput="${(e) => this.filterLayers(e.target.value)}"> <button class="${this.isFiltered ? 'delete-button' : 'hidden'}" onclick="${() => this.clearFilter()}"><img class="delete-icon" alt="delete-button-icon" tip="Reset filter" i18n="Reset filter" src="icons/trash.svg"></button></div><div class="filter-buttons"><span>${Object.values(this.externalLayers).filter(layer => layer.isSelected).length.toString()} ${this.context.i18nManager.getTranslation('layers selected')} </span><button class="gg-button" tip="Select all filtered layers" onclick="${() => this.selectVisible()}">+</button> <button class="gg-button" tip="Unselect all filtered layers" onclick="${() => this.deselectVisible()}">-</button> <button class="gg-button" tip="Select none" onclick="${() => this.deselectAll()}">--</button></div><img id="loading-icon" alt="loading-icon" src="icons/loading.svg" class="${this.loading ? 'gg-spin' : 'hidden'}"><ul class="results">${this.filteredLayers.map(layer => uHtmlFor(layer, layer.treeItemId) `<li class="result"><button class="${layer.isSelected ? 'gg-icon-button gg-small gg-selected' : 'gg-icon-button gg-small gg-opacity'}" tip="Activate / Deactivate" onclick="${() => this.selectLayer(layer)}"><img class="${layer.isSelected ? 'gg-checkbox' : 'hidden'}" alt="Expand/Collapse button" src="icons/checked-full.svg"> <img class="${!layer.isSelected ? 'gg-checkbox' : 'hidden'}" alt="Expand/Collapse button" src="icons/checked-no.svg"></button> <button class="${layer.isSelected ? 'gg-icon-button gg-small gg-selected' : 'gg-icon-button gg-small gg-opacity'}" onclick="${() => this.selectLayer(layer)}"><span i18n="${layer.name}" class="gg-tree-label">${layer.name}</span></button></li>`)}</ul><button id="add" tip="Add selected" i18n="Add selected" class="gg-button" onclick="${() => this.addSelectedLayers()}">Add selected</button></section></div>`;
+<div id="panel"><header class="gg-tabs"><button class="${this.selectedTab === 'wms_wmts' ? 'gg-tab active' : 'gg-tab'}" onclick="${() => this.setSelectedTab('wms_wmts')}" i18n="wms_wmts"></button> <button class="${this.selectedTab === 'file' ? 'gg-tab active' : 'gg-tab'}" onclick="${() => this.setSelectedTab('file')}" i18n="local file"></button></header><section class="${(this.selectedTab === 'wms_wmts') ? 'group' : 'hidden'}"><h4 class="title" i18n="Suggestions" ?hidden="${!this.hasPredefinedWmsWmtsSources}">Suggestions</h4><ul class="suggestions" ?hidden="${!this.hasPredefinedWmsWmtsSources}">${this.predefinedWmsWmtsSources.map(source => uHtmlFor(source, source.label) `<li><a href="javascript:void(0)" onclick="${() => this.scanSource(source.url, source.type)}">${source.label}</a></li>`)}</ul><h4 class="title" i18n="Custom service URL">Custom service URL</h4><div class="clearable-input"><input id="url" class="gg-input clearable-input-field" oninput="${() => this.typeUrl()}"><br><button id="clear-url" class="delete-button hidden" onclick="${() => this.clearUrl()}"><img class="delete-icon" alt="delete-button-icon" tip="Reset filter" i18n="Reset filter" src="icons/trash.svg"></button></div><button i18n="Scan Source" class="gg-button scan-button" onclick="${() => this.scanSource()}">Scan Source</button></section><section class="${(this.selectedTab === 'file') ? 'group' : 'hidden'}"><h4 class="title" i18n="Choose local file">Choose local file</h4><div id="file-selector"><label for="file" id="file-label"><button class="gg-button" i18n="Select File"></button> <span>${this.fileDescription}</span></label> <input type="file" accept=".gpx,.kml,.geojson,.json" id="file" onchange="${() => this.render()}"><br></div><button id="load" i18n="Load File" class="gg-button" onclick="${() => this.loadFile()}"></button></section><section class="${(this.selectedTab === 'wms_wmts' && this.externalLayers.length > 0) || this.loading ? 'layers' : 'hidden'}"><h4 class="title" i18n="Layers (from Capabilities)">Layers (from Capabilities)</h4><div class="clearable-input"><img class="filter-icon" alt="filter-button-icon" src="icons/filter.svg"> <input id="layer-search-field" class="gg-input clearable-input-field" placeholder="${this.context.i18nManager.getTranslation('Filter external layers...')}" i18n="Filter external layers..." autocomplete="off" autocorrect="off" oninput="${(e) => this.filterLayers(e.target.value)}"> <button class="${this.isFiltered ? 'delete-button' : 'hidden'}" onclick="${() => this.clearFilter()}"><img class="delete-icon" alt="delete-button-icon" tip="Reset filter" i18n="Reset filter" src="icons/trash.svg"></button></div><div class="filter-buttons"><span>${Object.values(this.externalLayers).filter(layer => layer.isSelected).length.toString()} ${this.context.i18nManager.getTranslation('layers selected')} </span><button class="gg-button" tip="Select all filtered layers" onclick="${() => this.selectVisible()}">+</button> <button class="gg-button" tip="Unselect all filtered layers" onclick="${() => this.deselectVisible()}">-</button> <button class="gg-button" tip="Select none" onclick="${() => this.deselectAll()}">--</button></div><img id="loading-icon" alt="loading-icon" src="icons/loading.svg" class="${this.loading ? 'gg-spin' : 'hidden'}"><ul class="results">${this.filteredLayers.map(layer => uHtmlFor(layer, layer.treeItemId) `<li class="result"><button class="${layer.isSelected ? 'gg-icon-button gg-small gg-selected' : 'gg-icon-button gg-small gg-opacity'}" tip="Activate / Deactivate" onclick="${() => this.selectLayer(layer)}"><img class="${layer.isSelected ? 'gg-checkbox' : 'hidden'}" alt="Expand/Collapse button" src="icons/checked-full.svg"> <img class="${!layer.isSelected ? 'gg-checkbox' : 'hidden'}" alt="Expand/Collapse button" src="icons/checked-no.svg"></button> <button class="${layer.isSelected ? 'gg-icon-button gg-small gg-selected' : 'gg-icon-button gg-small gg-opacity'}" onclick="${() => this.selectLayer(layer)}"><span i18n="${layer.name}" class="gg-tree-label">${layer.name}</span></button></li>`)}</ul><button id="add" tip="Add selected" i18n="Add selected" class="gg-button" onclick="${() => this.addSelectedLayers()}">Add selected</button></section></div>`;
     };
     isPanelVisible = false;
     panelTitle = 'ext-layer-panel';
@@ -26,7 +26,7 @@ class ExternalLayersComponent extends GirafeHTMLElement {
         return this.predefinedSources.filter((source) => source.type === 'WMS' || source.type === 'WMTS');
     }
     get hasPredefinedWmsWmtsSources() {
-        return this.predefinedWmsWmtsSources.length == 0;
+        return this.predefinedWmsWmtsSources.length > 0;
     }
     selectedTab = 'wms_wmts';
     wmtsManager;

package/components/map/component.js

@@ -885,6 +885,12 @@ export default class MapComponent extends GirafeHTMLElement {
                 throw new TypeError('Unknown basemap type');
             }
         }
+        // Apply default opacity
+        for (const basemap of basemaps) {
+            if (!basemap.opacityDisabled) {
+                this.onChangeBasemapOpacity(basemap);
+            }
+        }
     }
     /**
      * This method checks for the presence of an initial selection originating from a shared state.

package/components/treeview/treeviewtheme/component.js

@@ -39,10 +39,8 @@ header{border:none;flex-direction:row-reverse;margin-top:.5rem;margin-bottom:.5r
             this.refreshRender(layer);
             this.refreshRender(layer.parent);
         });
-        this.subscribe('treeview.renderEnabled', (_oldValue, enabled) => {
-            if (enabled) {
-                this.refreshRender();
-            }
+        this.subscribe('treeview.renderEnabled', () => {
+            this.refreshRender();
         });
     }
     connectedCallback() {

package/models/basemaps/basemap.d.ts

@@ -8,5 +8,6 @@ declare class Basemap {
     layersList: BaseLayer[];
     constructor(elem: GMFBackgroundLayer, opacity?: number);
     get projection(): string | undefined;
+    get opacityDisabled(): boolean;
 }
 export default Basemap;

package/models/basemaps/basemap.js

@@ -16,5 +16,8 @@ class Basemap {
         const layer = this.layersList.find((l) => l instanceof LayerVectorTiles);
         return layer?.projection;
     }
+    get opacityDisabled() {
+        return this.opacity === -1;
+    }
 }
 export default Basemap;

package/models/layers/layerwms.js

@@ -1,5 +1,12 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
 import LayerTimeFormatter from '../../tools/time/layertimeformatter.js';
 import Layer from './layer.js';
+import { BrainIgnore } from '../../tools/state/brain/decorators.js';
 class LayerWms extends Layer {
     /**
      * This class is a used in the state of the application, which will be accessed behind a javascript proxy.
@@ -189,4 +196,7 @@ class LayerWms extends Layer {
         return opts;
     }
 }
+__decorate([
+    BrainIgnore
+], LayerWms.prototype, "ogcServer", void 0);
 export default LayerWms;

package/models/layers/layerwmts.js

@@ -1,3 +1,10 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BrainIgnore } from '../../tools/state/brain/decorators.js';
 import Layer from './layer.js';
 class LayerWmts extends Layer {
     /**
@@ -115,4 +122,7 @@ class LayerWmts extends Layer {
         };
     }
 }
+__decorate([
+    BrainIgnore
+], LayerWmts.prototype, "ogcServer", void 0);
 export default LayerWmts;

package/package.json

@@ -5,7 +5,7 @@
     "name": "GeoGirafe PSC",
     "url": "https://doc.geomapfish.dev"
   },
-  "version": "1.0.2251126674",
+  "version": "1.0.2259617981",
   "type": "module",
   "engines": {
     "node": ">=20.19.0"

package/templates/public/about.json

@@ -1 +1 @@
-{"version":"1.0.2251126674", "build":"2251126674", "date":"08/01/2026"}
+{"version":"1.0.2259617981", "build":"2259617981", "date":"13/01/2026"}

package/tools/configuration/girafeconfig.d.ts

@@ -84,6 +84,7 @@ declare class GirafeConfig {
     };
     share?: {
         service: 'gmf' | 'geogirafe' | null;
+        preferNames: boolean;
         createUrl: string;
         getUrl?: string;
     };

package/tools/configuration/girafeconfig.js

@@ -162,6 +162,7 @@ class GirafeConfig {
         }
         return {
             service: config.share?.service ?? 'gmf',
+            preferNames: config.share?.preferNames ?? false,
             createUrl: config.share?.createUrl,
             getUrl: config.share?.getUrl
         };

package/tools/main.d.ts

@@ -54,7 +54,7 @@ export { default as LayersConfigSerializer } from './share/serializers/layerconf
 export { default as MapPositionSerializer } from './share/serializers/mappositionserializer.js';
 export type { SharedInitialSelection } from './share/serializers/selectionserializer.js';
 export { default as SelectionSerializer } from './share/serializers/selectionserializer.js';
-export type { SharedFilter, SharedLayer, SharedInternalTheme, SharedInternalGroup, SharedInternalLayer, SharedExternalTheme, SharedExternalLayer } from './share/serializers/sharedtypes.js';
+export type { SharedFilter, SharedLayer, SharedInternalTheme, SharedInternalGroup, SharedInternalLayer, SharedExternalTheme, SharedExternalLayer, SharedBasemap } from './share/serializers/sharedtypes.js';
 export { default as SessionManager } from './share/sessionmanager.js';
 export { default as ShareManager } from './share/sharemanager.js';
 export { default as StateSerializer } from './share/stateserializer.js';
@@ -62,11 +62,11 @@ export type { default as ISnappingConfig } from './snap/isnapconfig.js';
 export type { TProxy } from './state/brain/brain.js';
 export { default as Brain } from './state/brain/brain.js';
 export type { IBrainSerializable } from './state/brain/decorators.js';
-export { ignoreCloneSymbol, serializeSymbol, BrainIgnoreClone, BrainSerialize, isBrainSerializable } from './state/brain/decorators.js';
+export { ignoreSymbol, ignoreCloneSymbol, serializeSymbol, BrainIgnoreClone, BrainIgnore, BrainSerialize, isBrainSerializable } from './state/brain/decorators.js';
 export { default as areEqual } from './state/brain/equality.js';
 export type { Constructor, IBrainSerializer } from './state/brain/serialize.js';
 export { default as BrainSerializer } from './state/brain/serialize.js';
-export { deepFreeze, deepCloneCustomizer, deepClone, isPrimitive, isFunction, isVirtualProperty, isConstructor, isIgnoredProperty, isFlagedIgnoreClone, isTypeSupported, isIterator } from './state/brain/tools.js';
+export { deepFreeze, deepCloneCustomizer, deepClone, isPrimitive, isFunction, isVirtualProperty, isConstructor, isIgnoredProperty, isFlagedIgnoreClone, isFlagedIgnore, isTypeSupported, isIterator } from './state/brain/tools.js';
 export { default as ComponentManager } from './state/componentManager.js';
 export type { CameraConfig } from './state/globe.js';
 export { default as GlobeState } from './state/globe.js';

package/tools/main.js

@@ -49,10 +49,10 @@ export { default as SessionManager } from './share/sessionmanager.js';
 export { default as ShareManager } from './share/sharemanager.js';
 export { default as StateSerializer } from './share/stateserializer.js';
 export { default as Brain } from './state/brain/brain.js';
-export { ignoreCloneSymbol, serializeSymbol, BrainIgnoreClone, BrainSerialize, isBrainSerializable } from './state/brain/decorators.js';
+export { ignoreSymbol, ignoreCloneSymbol, serializeSymbol, BrainIgnoreClone, BrainIgnore, BrainSerialize, isBrainSerializable } from './state/brain/decorators.js';
 export { default as areEqual } from './state/brain/equality.js';
 export { default as BrainSerializer } from './state/brain/serialize.js';
-export { deepFreeze, deepCloneCustomizer, deepClone, isPrimitive, isFunction, isVirtualProperty, isConstructor, isIgnoredProperty, isFlagedIgnoreClone, isTypeSupported, isIterator } from './state/brain/tools.js';
+export { deepFreeze, deepCloneCustomizer, deepClone, isPrimitive, isFunction, isVirtualProperty, isConstructor, isIgnoredProperty, isFlagedIgnoreClone, isFlagedIgnore, isTypeSupported, isIterator } from './state/brain/tools.js';
 export { default as ComponentManager } from './state/componentManager.js';
 export { default as GlobeState } from './state/globe.js';
 export { default as GraphicalInterface } from './state/graphicalInterface.js';

package/tools/share/serializers/activebasemapsserializer.d.ts

@@ -5,6 +5,9 @@ export default class ActiveBasemapsSerializer implements IBrainSerializer<Basema
     private readonly context;
     constructor(context: IGirafeContext);
     private get state();
-    brainSerialize(basemaps: Basemap[]): string;
+    private get preferNames();
+    brainSerialize(activeBasemaps: Basemap[]): string;
     brainDeserialize(serializedString: string): void;
+    private serialize;
+    private deserialize;
 }

package/tools/share/serializers/activebasemapsserializer.js

@@ -1,5 +1,3 @@
-import { applyOpacityToLayers } from '../../utils/utils.js';
-import { DEFAULT_OPACITY } from '../../themes/themes-config.js';
 export default class ActiveBasemapsSerializer {
     context;
     constructor(context) {
@@ -8,31 +6,43 @@ export default class ActiveBasemapsSerializer {
     get state() {
         return this.context.stateManager.state;
     }
-    brainSerialize(basemaps) {
-        const serializedBasemaps = basemaps
-            .map((basemap) => `${basemap.id.toString()}=${basemap.opacity.toString()}`)
-            .join(';');
-        console.debug(`Serialized Basemaps to ${serializedBasemaps}`);
-        return serializedBasemaps;
+    get preferNames() {
+        return this.context.configManager.Config.share?.preferNames ?? false;
+    }
+    brainSerialize(activeBasemaps) {
+        return this.serialize(activeBasemaps);
     }
     brainDeserialize(serializedString) {
-        console.debug(`Deserializing Basemaps from ${serializedString}`);
-        const basemapIdsWithOpacities = Object.fromEntries(serializedString.split(';').map((idAndOpacity) => idAndOpacity.split('=').map(Number)));
-        const basemapIds = Object.keys(basemapIdsWithOpacities).map(Number);
-        const basemaps = Object.values(this.state.basemaps).filter((b) => basemapIds.includes(b.id));
+        const activeBasemaps = this.deserialize(serializedString);
+        this.state.activeBasemaps = activeBasemaps;
+    }
+    serialize(basemaps) {
+        const sharedBasemaps = [];
         for (const basemap of basemaps) {
-            basemap.opacity = basemapIdsWithOpacities[basemap.id] ?? DEFAULT_OPACITY;
-            applyOpacityToLayers(basemap.opacity === -1 ? 1 : basemap.opacity, basemap.layersList);
-        }
-        if (basemaps.length > 0) {
-            this.state.activeBasemaps = basemaps;
+            const sharedBasemap = {
+                id: basemap.id,
+                name: basemap.name,
+                opacity: basemap.opacity
+            };
+            sharedBasemaps.push(sharedBasemap);
         }
-        else {
-            console.debug('No Basemaps could be deserialized => not changing state.activeBasemaps');
-        }
-        if (basemaps.length != basemapIds.length) {
-            const missingIds = basemapIds.filter((id) => basemaps.findIndex((basemap) => basemap.id == id) == -1); //NOSONAR(typescript:S7754) It IS about the Indexes
-            throw new Error(`Some basemaps could not be deserialized: ${missingIds.join(',')}.`);
+        return JSON.stringify(sharedBasemaps);
+    }
+    deserialize(str) {
+        const sharedBasemaps = JSON.parse(str);
+        const basemaps = [];
+        for (const sharedBasemap of sharedBasemaps) {
+            const basemap = this.preferNames
+                ? Object.values(this.state.basemaps).find((b) => b.name === sharedBasemap.name)
+                : Object.values(this.state.basemaps).find((b) => b.id === sharedBasemap.id);
+            if (basemap) {
+                basemap.opacity = sharedBasemap.opacity;
+                basemaps.push(basemap);
+            }
+            else {
+                console.error(`The basemap ${sharedBasemap.name} could not be deserialized`);
+            }
         }
+        return basemaps;
     }
 }

package/tools/share/serializers/activebasemapsserializer.spec.js

@@ -26,7 +26,7 @@ describe('ActiveBasemapsSerializer.serialize', () => {
             })
         ];
         const serialized = serializer.brainSerialize(basemaps);
-        expect(serialized).toBe('1=-1');
+        expect(serialized).toEqual('[{"id":1,"name":"OpenStreetMap","opacity":-1}]');
     });
 });
 describe('ActiveBasemapsSerializer.deserialize', () => {
@@ -40,13 +40,14 @@ describe('ActiveBasemapsSerializer.deserialize', () => {
         basemaps.forEach((basemap) => {
             context.stateManager.state.basemaps[basemap.id] = basemap;
         });
-        serializer.brainDeserialize('1=-1');
+        serializer.brainDeserialize('[{"id":1,"name":"OpenStreetMap","opacity":-1}]');
         const state = context.stateManager.state;
         expect(state.activeBasemaps).toBeInstanceOf((Array));
         expect(state.activeBasemaps[0].id).toBe(basemaps[0].id);
         expect(state.activeBasemaps[0].opacity).toBe(-1);
+        expect(state.activeBasemaps[0].opacityDisabled).toBeTruthy();
     });
-    it('deserializing with non existing IDs should throw an Error', () => {
+    it('should deserialize a valid basemap even if another one cannot be found', () => {
         const basemaps = [
             new Basemap({
                 id: 1,
@@ -56,6 +57,87 @@ describe('ActiveBasemapsSerializer.deserialize', () => {
         basemaps.forEach((basemap) => {
             context.stateManager.state.basemaps[basemap.id] = basemap;
         });
-        expect(() => serializer.brainDeserialize('1=-1;2=0;42=0.45')).toThrow(new Error(`Some basemaps could not be deserialized: 2,42.`));
+        serializer.brainDeserialize('[{"id":1,"name":"OpenStreetMap","opacity":-1},{"id":2,"name":"NotExisting","opacity":0.5}]');
+        const state = context.stateManager.state;
+        expect(state.activeBasemaps).toBeInstanceOf((Array));
+        expect(state.activeBasemaps[0].id).toBe(basemaps[0].id);
+        expect(state.activeBasemaps[0].opacity).toBe(-1);
+        expect(state.activeBasemaps[0].opacityDisabled).toBeTruthy();
+    });
+    it('should deserialize a valid basemap with the right opacity', () => {
+        const basemaps = [
+            new Basemap({
+                id: 1,
+                name: 'OpenStreetMap'
+            })
+        ];
+        basemaps.forEach((basemap) => {
+            context.stateManager.state.basemaps[basemap.id] = basemap;
+        });
+        serializer.brainDeserialize('[{"id":1,"name":"OpenStreetMap","opacity":0.45}]');
+        const state = context.stateManager.state;
+        expect(state.activeBasemaps).toBeInstanceOf((Array));
+        expect(state.activeBasemaps[0].id).toBe(basemaps[0].id);
+        expect(state.activeBasemaps[0].opacity).toBe(0.45);
+        expect(state.activeBasemaps[0].opacityDisabled).toBeFalsy();
+    });
+});
+describe('ActiveBasemapsSerializer.deserialize (preferNames)', () => {
+    beforeAll(() => {
+        context.configManager.Config.share.preferNames = true;
+    });
+    afterAll(() => {
+        context.configManager.Config.share.preferNames = false;
+    });
+    it('should deserialize a valid basemap id and set it as activeBasemap (preferNames)', () => {
+        const basemaps = [
+            new Basemap({
+                id: 1,
+                name: 'OpenStreetMap'
+            })
+        ];
+        basemaps.forEach((basemap) => {
+            context.stateManager.state.basemaps[basemap.id] = basemap;
+        });
+        serializer.brainDeserialize('[{"id":999,"name":"OpenStreetMap","opacity":-1}]');
+        const state = context.stateManager.state;
+        expect(state.activeBasemaps).toBeInstanceOf((Array));
+        expect(state.activeBasemaps[0].id).toBe(basemaps[0].id);
+        expect(state.activeBasemaps[0].opacity).toBe(-1);
+        expect(state.activeBasemaps[0].opacityDisabled).toBeTruthy();
+    });
+    it('should deserialize a valid basemap even if another one cannot be found (preferNames)', () => {
+        const basemaps = [
+            new Basemap({
+                id: 1,
+                name: 'OpenStreetMap'
+            })
+        ];
+        basemaps.forEach((basemap) => {
+            context.stateManager.state.basemaps[basemap.id] = basemap;
+        });
+        serializer.brainDeserialize('[{"id":999,"name":"OpenStreetMap","opacity":-1},{"id":888,"name":"NotExisting","opacity":0.5}]');
+        const state = context.stateManager.state;
+        expect(state.activeBasemaps).toBeInstanceOf((Array));
+        expect(state.activeBasemaps[0].id).toBe(basemaps[0].id);
+        expect(state.activeBasemaps[0].opacity).toBe(-1);
+        expect(state.activeBasemaps[0].opacityDisabled).toBeTruthy();
+    });
+    it('should deserialize a valid basemap with the right opacity (preferNames)', () => {
+        const basemaps = [
+            new Basemap({
+                id: 1,
+                name: 'OpenStreetMap'
+            })
+        ];
+        basemaps.forEach((basemap) => {
+            context.stateManager.state.basemaps[basemap.id] = basemap;
+        });
+        serializer.brainDeserialize('[{"id":999,"name":"OpenStreetMap","opacity":0.45}]');
+        const state = context.stateManager.state;
+        expect(state.activeBasemaps).toBeInstanceOf((Array));
+        expect(state.activeBasemaps[0].id).toBe(basemaps[0].id);
+        expect(state.activeBasemaps[0].opacity).toBe(0.45);
+        expect(state.activeBasemaps[0].opacityDisabled).toBeFalsy();
     });
 });

package/tools/share/serializers/layerconfigserializer.d.ts

@@ -7,6 +7,7 @@ export default class LayersConfigSerializer implements IBrainSerializer<LayersCo
     private readonly context;
     constructor(context: IGirafeContext);
     private get state();
+    private get preferNames();
     brainSerialize(layersConfig: LayersConfig): string;
     protected serialize(layers: BaseLayer[]): string;
     brainDeserialize(str: string): void;
@@ -16,6 +17,7 @@ export default class LayersConfigSerializer implements IBrainSerializer<LayersCo
     private getExternalSerializedTheme;
     private getExternalSerializedLayer;
     private getInternalSerializedGroupOrTheme;
+    private getInternalLayerType;
     private getInternalSerializedLayer;
     private getDeserializedLayerTree;
     private deserializeInternalObject;
@@ -24,8 +26,11 @@ export default class LayersConfigSerializer implements IBrainSerializer<LayersCo
     private deserializeInternalLayer;
     private checkUnknownLayers;
     private removeUnnecessaryChilds;
+    private reorderChildren;
     private findBaseLayerById;
-    private findLayerRecursive;
+    private findLayerRecursiveById;
+    private findBaseLayerByName;
+    private findLayerRecursiveByName;
     private deserializeExternalObject;
     private deserializeExternalTheme;
     private deserializeExternalWmsLayer;

package/tools/share/serializers/layerconfigserializer.js

@@ -7,6 +7,11 @@ import ThemeLayerExternal from '../../../models/layers/themelayerexternal.js';
 import LayerWmsExternal from '../../../models/layers/layerwmsexternal.js';
 import LayerWmtsExternal from '../../../models/layers/layerwmtsexternal.js';
 import ServerOgc from '../../../models/serverogc.js';
+import LayerWmts from '../../../models/layers/layerwmts.js';
+import LayerVectorTiles from '../../../models/layers/layervectortiles.js';
+import LayerCog from '../../../models/layers/layercog.js';
+import LayerOsm from '../../../models/layers/layerosm.js';
+import LayerXYZ from '../../../models/layers/layerxyz.js';
 export default class LayersConfigSerializer {
     context;
     constructor(context) {
@@ -15,6 +20,9 @@ export default class LayersConfigSerializer {
     get state() {
         return this.context.stateManager.state;
     }
+    get preferNames() {
+        return this.context.configManager.Config.share?.preferNames ?? false;
+    }
     brainSerialize(layersConfig) {
         return this.serialize(layersConfig.layersList);
     }
@@ -104,6 +112,7 @@ export default class LayersConfigSerializer {
         const originalTheme = this.context.themesHelper.findBaseLayerById(group.id);
         const sharedChildren = [];
         const removedChildrenIds = [];
+        const removedChildrenNames = [];
         for (const originalChild of originalTheme.children) {
             const index = group.children.findIndex((el) => el.id === originalChild.id);
             if (index >= 0) {
@@ -114,6 +123,7 @@ export default class LayersConfigSerializer {
             else {
                 // Element is not in the list any more, and therefore should not be shared or restored
                 removedChildrenIds.push(originalChild.id);
+                removedChildrenNames.push(originalChild.name);
             }
         }
         return {
@@ -123,9 +133,39 @@ export default class LayersConfigSerializer {
             isExpanded: Number(group.isExpanded),
             timeRestriction: isTimeAwareLayer(group) ? group.timeRestriction : undefined,
             children: sharedChildren,
-            excludedChildrenIds: removedChildrenIds
+            excludedChildrenIds: removedChildrenIds,
+            name: group.name,
+            type: this.getInternalLayerType(group),
+            excludedChildrenNames: removedChildrenNames
         };
     }
+    getInternalLayerType(layer) {
+        if (layer instanceof ThemeLayer) {
+            return 'theme';
+        }
+        if (layer instanceof GroupLayer) {
+            return 'group';
+        }
+        if (layer instanceof LayerWms) {
+            return 'wms';
+        }
+        if (layer instanceof LayerWmts) {
+            return 'wmts';
+        }
+        if (layer instanceof LayerVectorTiles) {
+            return 'vt';
+        }
+        if (layer instanceof LayerCog) {
+            return 'cog';
+        }
+        if (layer instanceof LayerOsm) {
+            return 'osm';
+        }
+        if (layer instanceof LayerXYZ) {
+            return 'xyz';
+        }
+        throw new Error(`The layer ${layer.name} has an unknown type and cannot be shared.`);
+    }
     getInternalSerializedLayer(layer) {
         return {
             id: layer.id,
@@ -137,7 +177,9 @@ export default class LayersConfigSerializer {
             filter: layer instanceof LayerWms && this.context.layerManager.isLayerWithFilter(layer)
                 ? layer.filter
                 : undefined,
-            timeRestriction: isTimeAwareLayer(layer) ? layer.timeRestriction : undefined
+            timeRestriction: isTimeAwareLayer(layer) ? layer.timeRestriction : undefined,
+            name: layer.name,
+            type: this.getInternalLayerType(layer)
         };
     }
     getDeserializedLayerTree(sharedLayers) {
@@ -146,7 +188,12 @@ export default class LayersConfigSerializer {
             let layer;
             if ('id' in sharedLayer) {
                 // Id attribute found => we are on an internal layer
-                layer = this.findBaseLayerById(sharedLayer.id);
+                if (this.preferNames && sharedLayer.name) {
+                    layer = this.findBaseLayerByName(sharedLayer.name, sharedLayer.type);
+                }
+                else {
+                    layer = this.findBaseLayerById(sharedLayer.id);
+                }
                 if (layer) {
                     this.deserializeInternalObject(layer, sharedLayer);
                 }
@@ -228,7 +275,9 @@ export default class LayersConfigSerializer {
         let reorder = false;
         for (let i = originalLayer.children.length - 1; i >= 0; i--) {
             const child = originalLayer.children[i];
-            const serializedChild = sharedLayer.children.find((l) => l.id == child.id);
+            const serializedChild = this.preferNames
+                ? sharedLayer.children.find((l) => l.name == child.name)
+                : sharedLayer.children.find((l) => l.id == child.id);
             if (serializedChild) {
                 this.deserializeInternalObject(child, serializedChild);
             }
@@ -236,7 +285,9 @@ export default class LayersConfigSerializer {
                 // This child exists in the original layer, but not in the shared state.
                 // => If it is present in the x list, it was explicitely removed
                 // And we can remove it from the current object
-                const explicitlyRemoved = sharedLayer.excludedChildrenIds.find((id) => id == child.id);
+                const explicitlyRemoved = this.preferNames
+                    ? sharedLayer.excludedChildrenNames.find((name) => name == child.name)
+                    : sharedLayer.excludedChildrenIds.find((id) => id == child.id);
                 if (explicitlyRemoved) {
                     originalLayer.children.splice(i, 1);
                     console.debug(`Layer ${child.name} was removed from initial state`);
@@ -253,23 +304,26 @@ export default class LayersConfigSerializer {
             }
         }
         if (reorder) {
-            console.debug(`Reordering childs for layer ${originalLayer.name}`);
-            let order = 1;
-            for (const child of originalLayer.children) {
-                child.order = order++;
-            }
+            this.reorderChildren(originalLayer);
+        }
+    }
+    reorderChildren(originalLayer) {
+        console.debug(`Reordering childs for layer ${originalLayer.name}`);
+        let order = 1;
+        for (const child of originalLayer.children) {
+            child.order = order++;
         }
     }
     findBaseLayerById(layerId) {
         for (const theme of Object.values(this.state.themes._allThemes)) {
-            const layer = this.findLayerRecursive(theme, layerId);
+            const layer = this.findLayerRecursiveById(theme, layerId);
             if (layer) {
                 return layer;
             }
         }
         return null;
     }
-    findLayerRecursive(layer, layerId) {
+    findLayerRecursiveById(layer, layerId) {
         if (layer.id === layerId) {
             // When deserializing the layer, we clone it,
             // otherwise the following operation will also
@@ -280,7 +334,35 @@ export default class LayersConfigSerializer {
         // Else, we call recursively on the children
         if (layer instanceof GroupLayer || layer instanceof ThemeLayer) {
             for (const childLayer of layer.children) {
-                const foundChild = this.findLayerRecursive(childLayer, layerId);
+                const foundChild = this.findLayerRecursiveById(childLayer, layerId);
+                if (foundChild) {
+                    return foundChild;
+                }
+            }
+        }
+        return null;
+    }
+    findBaseLayerByName(layerName, layerType) {
+        for (const theme of Object.values(this.state.themes._allThemes)) {
+            const layer = this.findLayerRecursiveByName(theme, layerName, layerType);
+            if (layer) {
+                return layer;
+            }
+        }
+        return null;
+    }
+    findLayerRecursiveByName(layer, layerName, layerType) {
+        if (layer.name === layerName && this.getInternalLayerType(layer) === layerType) {
+            // When deserializing the layer, we clone it,
+            // otherwise the following operation will also
+            // affect the layer referenced in other themes
+            const foundLayer = layer.clone();
+            return foundLayer;
+        }
+        // Else, we call recursively on the children
+        if (layer instanceof GroupLayer || layer instanceof ThemeLayer) {
+            for (const childLayer of layer.children) {
+                const foundChild = this.findLayerRecursiveByName(childLayer, layerName, layerType);
                 if (foundChild) {
                     return foundChild;
                 }

package/tools/share/serializers/layerconfigserializer.spec.js

@@ -74,10 +74,16 @@ function getTestData(options = {}) {
                     checked: options.isGroupChecked ? 1 : 0,
                     isExpanded: options.isGroupExpanded ? 1 : 0,
                     children: [],
-                    excludedChildrenIds: options.addSecondMissingLayer ? [22] : []
+                    excludedChildrenIds: options.addSecondMissingLayer ? [22] : [],
+                    name: 'Group 1',
+                    type: 'group',
+                    excludedChildrenNames: options.addSecondMissingLayer ? ['Layer WMTS 2'] : []
                 }
             ],
-            excludedChildrenIds: options.addSecondMissingGroup ? [12] : []
+            excludedChildrenIds: options.addSecondMissingGroup ? [12] : [],
+            name: 'test-theme',
+            type: 'theme',
+            excludedChildrenNames: options.addSecondMissingGroup ? ['Group 2'] : []
         }
     ];
     if (options.addWmtsLayer) {
@@ -87,7 +93,9 @@ function getTestData(options = {}) {
             checked: 0,
             isExpanded: 0,
             opacity: options.opacity ?? 1,
-            swiped: options.swiped ?? 'no'
+            swiped: options.swiped ?? 'no',
+            name: 'Layer WMTS 1',
+            type: 'wmts'
         });
     }
     return {
@@ -269,6 +277,70 @@ describe('LayersConfigSerializer.deserialize', () => {
         expect(serialized).toEqual(data.controlValue);
     });
 });
+describe('LayersConfigSerializer.deserialize (preferNames)', () => {
+    beforeAll(() => {
+        context.configManager.Config.share.preferNames = true;
+    });
+    afterAll(() => {
+        context.configManager.Config.share.preferNames = false;
+    });
+    it('should return serialized data for a GroupLayer (id, order) (preferNames)', () => {
+        const data = getTestData();
+        serializer.brainDeserialize(data.controlValue);
+        const layersConfig = context.stateManager.state.layers;
+        const serialized = serializer.brainSerialize(layersConfig);
+        expect(serialized).toEqual(data.controlValue);
+    });
+    it('should return serialized data for a GroupLayer (isExpanded) (preferNames)', () => {
+        const data = getTestData({ isGroupExpanded: true });
+        serializer.brainDeserialize(data.controlValue);
+        const layersConfig = context.stateManager.state.layers;
+        const serialized = serializer.brainSerialize(layersConfig);
+        expect(serialized).toEqual(data.controlValue);
+    });
+    it('should return serialized data for a GroupLayer with children (preferNames)', () => {
+        const data = getTestData({ addWmtsLayer: true });
+        serializer.brainDeserialize(data.controlValue);
+        const layersConfig = context.stateManager.state.layers;
+        const serialized = serializer.brainSerialize(layersConfig);
+        expect(serialized).toEqual(data.controlValue);
+    });
+    it('should return serialized data for a GroupLayer with children (opacity) (preferNames)', () => {
+        const data = getTestData({ addWmtsLayer: true, opacity: 0.5 });
+        serializer.brainDeserialize(data.controlValue);
+        const layersConfig = context.stateManager.state.layers;
+        const serialized = serializer.brainSerialize(layersConfig);
+        expect(serialized).toEqual(data.controlValue);
+    });
+    it('should return serialized data for a GroupLayer with children (swiped left) (preferNames)', () => {
+        const data = getTestData({ addWmtsLayer: true, swiped: 'left' });
+        serializer.brainDeserialize(data.controlValue);
+        const layersConfig = context.stateManager.state.layers;
+        const serialized = serializer.brainSerialize(layersConfig);
+        expect(serialized).toEqual(data.controlValue);
+    });
+    it('should return serialized data for a GroupLayer with children (swiped right) (preferNames)', () => {
+        const data = getTestData({ addWmtsLayer: true, swiped: 'left' });
+        serializer.brainDeserialize(data.controlValue);
+        const layersConfig = context.stateManager.state.layers;
+        const serialized = serializer.brainSerialize(layersConfig);
+        expect(serialized).toEqual(data.controlValue);
+    });
+    it('should serialize a missing original group correctly (explicitely removed) (preferNames)', () => {
+        const data = getTestData({ addSecondMissingGroup: true });
+        serializer.brainDeserialize(data.controlValue);
+        const layersConfig = context.stateManager.state.layers;
+        const serialized = serializer.brainSerialize(layersConfig);
+        expect(serialized).toEqual(data.controlValue);
+    });
+    it('should serialize a missing original layer correctly (explicitely removed) (preferNames)', () => {
+        const data = getTestData({ addWmtsLayer: true, addSecondMissingLayer: true });
+        serializer.brainDeserialize(data.controlValue);
+        const layersConfig = context.stateManager.state.layers;
+        const serialized = serializer.brainSerialize(layersConfig);
+        expect(serialized).toEqual(data.controlValue);
+    });
+});
 describe('LayersConfigSerializer.serialize external', () => {
     it('should return serialized data for an external theme', () => {
         const data = getExternalTestData();

package/tools/share/serializers/sharedtypes.d.ts

@@ -20,6 +20,16 @@ export type SharedInternalTheme = {
      * Or if it was explicitly removed from the user, and then we won't have to display it again
      */
     excludedChildrenIds: number[];
+    /**
+     * When configuring the share with "preferNames=true", the name of the layer will be used to generate the sahred state
+     * instead of the ID. But in this case, we also have to share the type os the layer, because tha layer name can be
+     * the same for a them, a group, a WMS-Layer, a WMTSLayer, etc...
+     * Also note that the "excludedChildrenNames" options has some limitations : if we have 2 layers of different types with the same name
+     * And if one of it is exceluded, both will be excluded.
+     */
+    name: string;
+    type: string;
+    excludedChildrenNames: string[];
 };
 export type SharedInternalGroup = {
     id: number;
@@ -29,6 +39,9 @@ export type SharedInternalGroup = {
     timeRestriction?: string;
     children: SharedInternalLayer[];
     excludedChildrenIds: number[];
+    name: string;
+    type: string;
+    excludedChildrenNames: string[];
 };
 export type SharedInternalLayer = {
     id: number;
@@ -39,6 +52,8 @@ export type SharedInternalLayer = {
     opacity?: number;
     swiped?: 'left' | 'right' | 'no';
     filter?: SharedFilter;
+    name: string;
+    type: string;
 };
 export type SharedExternalTheme = {
     name: string;
@@ -64,3 +79,8 @@ export type SharedExternalLayer = {
     opacity?: number;
     swiped?: 'left' | 'right' | 'no';
 };
+export type SharedBasemap = {
+    id: number;
+    name: string;
+    opacity: number;
+};

package/tools/state/brain/brain.base.spec.js

@@ -6,7 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { describe, it, expect, beforeEach } from 'vitest';
 import Brain from './brain';
-import { BrainIgnoreClone } from './decorators';
+import { BrainIgnore, BrainIgnoreClone } from './decorators';
 let state;
 let brain;
 describe('State: base principles', () => {
@@ -377,7 +377,7 @@ describe('State: base principles', () => {
         });
         expect(counter).toBe(2);
     });
-    it('Base principles: Do not clone objects with attribute BrainIgnoreClone', () => {
+    it('Base principles: Do not clone objects with decorator @BrainIgnoreClone', () => {
         class Pizza {
             key;
             owner;
@@ -406,7 +406,7 @@ describe('State: base principles', () => {
         brain.getState().objectValue = pizza2;
         expect(counter).toBe(2);
     });
-    it('Base principles: Do not clone objects with attribute BrainIgnoreClone, but listen to changes', () => {
+    it('Base principles: Do not clone objects with decorator @BrainIgnoreClone, but listen to changes', () => {
         class Pizza {
             key;
             owner;
@@ -434,6 +434,35 @@ describe('State: base principles', () => {
         brain.getState().objectValue.owner.place = 'Bernwiller';
         expect(counter).toBe(2);
     });
+    it('Base principles: Do not create proxy for attributes with decorator @BrainIgnore', () => {
+        class Pizza {
+            key;
+            owner;
+            constructor(key, owner) {
+                this.key = key;
+                this.owner = owner;
+            }
+        }
+        __decorate([
+            BrainIgnore
+        ], Pizza.prototype, "owner", void 0);
+        const pizzeria = {
+            name: 'Noninna',
+            place: 'Aspach'
+        };
+        const pizza1 = new Pizza('pizza1', pizzeria);
+        state.objectValue = pizza1;
+        let counter = 1;
+        brain = new Brain(state, () => {
+            counter++;
+        });
+        const pizzaProxy = brain.getState().objectValue;
+        expect(pizzaProxy.__brainIsProxy).toBeTruthy();
+        const owner = pizzaProxy.owner;
+        expect(owner.__brainIsProxy).toBeFalsy();
+        owner.place = 'Bernwiller';
+        expect(counter).toBe(1);
+    });
     it('Base principles: Handles multiple parents referencing the same object', () => {
         const shared = { id: 42 };
         state.objectValue = { child: shared };

package/tools/state/brain/brain.js

@@ -20,20 +20,20 @@ export default class Brain {
         this.externalCallback = callback;
     }
     callback(path, oldValue, newValue, parents) {
-        if (!this.delayed) {
-            // Immediate Callback
-            this.externalCallback(path, oldValue, newValue, parents);
-        }
-        else {
+        if (this.delayed) {
             // Remember all callback infos
             const infos = this.delayedCallbacks.get(path);
-            if (!infos) {
-                this.delayedCallbacks.set(path, { oldValue: oldValue, newValue: newValue, parents: parents });
-            }
-            else {
+            if (infos) {
                 // Just set the new value
                 infos.newValue = newValue;
             }
+            else {
+                this.delayedCallbacks.set(path, { oldValue: oldValue, newValue: newValue, parents: parents });
+            }
+        }
+        else {
+            // Immediate Callback
+            this.externalCallback(path, oldValue, newValue, parents);
         }
     }
     /**
@@ -86,17 +86,21 @@ export default class Brain {
             return this.mergeMinimalPathsCache.get(cacheKey);
         }
         const minimalPaths = new Set();
+        const parentsPaths = [];
+        for (const p of parents) {
+            parentsPaths.push(...p.__brainFullPaths);
+        }
         for (const candidate of [...existingPaths, ...candidatePaths]) {
             // Already present
             if (minimalPaths.has(candidate)) {
                 continue;
             }
             // If the candidate hat a minimal path as prefix
-            if ([...minimalPaths].some((path) => candidate.startsWith(`${path}.`))) {
+            if (Array.from(minimalPaths).some((path) => candidate.startsWith(`${path}.`))) {
                 continue;
             }
             // If not prefixed by any parent
-            if (!this.isRightParent(candidate, parents)) {
+            if (!this.isRightParent(candidate, parentsPaths)) {
                 continue;
             }
             minimalPaths.add(candidate);
@@ -105,30 +109,23 @@ export default class Brain {
         this.mergeMinimalPathsCache.set(cacheKey, returnValue);
         return returnValue;
     }
-    isRightParent(candidate, parents) {
-        const parentsPaths = [];
-        for (const p of parents) {
-            parentsPaths.push(...p.__brainFullPaths);
+    isRightParent(candidate, parentsPaths) {
+        if (parentsPaths.length === 0 || parentsPaths[0].length === 0) {
+            // On the root
+            return true;
         }
-        if (parentsPaths?.length > 0 && parentsPaths[0].length > 0) {
-            // Not on the root
-            let circularReference = false;
-            let rightParent = false;
-            for (const parentPath of parentsPaths) {
-                if (parentPath.includes(`${candidate}.`)) {
-                    circularReference = true;
-                    break;
-                }
-                else if (candidate.startsWith(`${parentPath}.`)) {
-                    rightParent = true;
-                    break;
-                }
+        for (const parentPath of parentsPaths) {
+            if (parentPath.includes(`${candidate}.`)) {
+                // Circular reference
+                return true;
             }
-            if (!circularReference && !rightParent) {
-                return false;
+            if (candidate.startsWith(`${parentPath}.`)) {
+                // Parent found
+                return true;
             }
         }
-        return true;
+        // Not a valid parent
+        return false;
     }
     getOrCreateProxyForValue(proxy, prop, value, childPaths) {
         if (isPrimitive(value)) {
@@ -150,8 +147,8 @@ export default class Brain {
             const fullPaths = valueProxy.__brainFullPaths;
             if (merged.length !== fullPaths.length || merged.some((p, i) => p !== fullPaths[i])) {
                 fullPaths.splice(0, fullPaths.length, ...merged);
+                this.updateChildPathsRecursively(valueProxy, fullPaths);
             }
-            this.updateChildPathsRecursively(valueProxy, fullPaths);
         }
         else {
             // Create a new proxy
@@ -197,7 +194,7 @@ export default class Brain {
     }
     recalculateChildrenForArray(proxy, target, oldValue) {
         if (!Array.isArray(target)) {
-            throw new Error('This method is only for arrays');
+            throw new TypeError('This method is only for arrays');
         }
         // Clean previous childs
         proxy.__brainChildren.clear();
@@ -266,7 +263,7 @@ export default class Brain {
     }
     handleGetIgnored(target, prop) {
         const value = target[prop];
-        if (typeof prop === 'symbol' || prop.startsWith('_')) {
+        if (isIgnoredProperty(target, prop)) {
             return value;
         }
         throw new Error(`Unknown ignored property: ${prop}`);
@@ -334,7 +331,7 @@ export default class Brain {
         };
     }
     getHandler(proxy, target, prop) {
-        if (isIgnoredProperty(prop)) {
+        if (isIgnoredProperty(target, prop)) {
             return this.handleGetIgnored(target, prop);
         }
         if (isVirtualProperty(prop)) {
@@ -388,7 +385,7 @@ export default class Brain {
             let oldValue = target[prop];
             const childPaths = proxy.__brainFullPaths.map((path) => this.getFullPath(path, prop));
             this.cleanProxyForValue(proxy, prop, oldValue, childPaths);
-            if (isIgnoredProperty(prop)) {
+            if (isIgnoredProperty(target, prop)) {
                 // Ignored => No callback and no clone of the old version
                 // Just set the new value
                 target[prop] = newValue;

package/tools/state/brain/decorators.d.ts

@@ -1,3 +1,7 @@
+/**
+ * A symbol used to mark properties that should be ignored during cloning operations.
+ */
+export declare const ignoreSymbol: unique symbol;
 /**
  * A symbol used to mark properties that should be ignored during cloning operations.
  */
@@ -13,6 +17,13 @@ export declare const serializeSymbol: unique symbol;
  * @param propertyKey - The key of the property to be ignored during cloning.
  */
 export declare function BrainIgnoreClone(target: any, propertyKey: string | symbol): void;
+/**
+ * A decorator function that marks a property of a class to be ignored. No proxy will be created for this object.
+ *
+ * @param target - The target object (class prototype) where the property resides.
+ * @param propertyKey - The key of the property to be ignored.
+ */
+export declare function BrainIgnore(target: any, propertyKey: string | symbol): void;
 /**
  * A decorator function that marks a property of a class to be serializable.
  *

package/tools/state/brain/decorators.js

@@ -1,3 +1,7 @@
+/**
+ * A symbol used to mark properties that should be ignored during cloning operations.
+ */
+export const ignoreSymbol = Symbol('brainIgnore');
 /**
  * A symbol used to mark properties that should be ignored during cloning operations.
  */
@@ -16,6 +20,16 @@ export function BrainIgnoreClone(target, propertyKey) {
     target[ignoreCloneSymbol] ??= [];
     target[ignoreCloneSymbol].push(propertyKey);
 }
+/**
+ * A decorator function that marks a property of a class to be ignored. No proxy will be created for this object.
+ *
+ * @param target - The target object (class prototype) where the property resides.
+ * @param propertyKey - The key of the property to be ignored.
+ */
+export function BrainIgnore(target, propertyKey) {
+    target[ignoreSymbol] ??= [];
+    target[ignoreSymbol].push(propertyKey);
+}
 /**
  * A decorator function that marks a property of a class to be serializable.
  *

package/tools/state/brain/tools.d.ts

@@ -62,7 +62,7 @@ export declare function isConstructor(prop: string): boolean;
  * @param prop - The property name or symbol to check.
  * @returns `true` if the property should be ignored, otherwise `false`.
  */
-export declare function isIgnoredProperty(prop: string | symbol): boolean;
+export declare function isIgnoredProperty(target: any, prop: string | symbol): boolean;
 /**
  * Checks if a property on a target object is flagged to be ignored during cloning.
  *
@@ -71,6 +71,14 @@ export declare function isIgnoredProperty(prop: string | symbol): boolean;
  * @returns `true` if the property is flagged to be ignored, otherwise `false`.
  */
 export declare function isFlagedIgnoreClone(target: any, prop?: string | number): any;
+/**
+ * Checks if a property on a target object is flagged to be totally ignored by brain.
+ *
+ * @param target - The object containing the property.
+ * @param prop - The property name or index to check.
+ * @returns `true` if the property is flagged to be ignored, otherwise `false`.
+ */
+export declare function isFlagedIgnore(target: any, prop?: string | number): any;
 /**
  * Determines if a value is of a supported type.
  * Unsupported types include `WeakMap`, `WeakSet`, `Map`, and `Set`.

package/tools/state/brain/tools.js

@@ -1,5 +1,5 @@
 import { cloneDeepWith } from 'lodash-es';
-import { ignoreCloneSymbol } from './decorators.js';
+import { ignoreCloneSymbol, ignoreSymbol } from './decorators.js';
 /**
  * Recursively freezes an object and all its properties to make it immutable.
  * This function also handles circular references by using a `WeakSet` to track visited objects.
@@ -17,15 +17,15 @@ export function deepFreeze(obj, visitedObjects = new WeakSet()) {
     }
     visitedObjects.add(obj);
     Object.freeze(obj);
-    Object.getOwnPropertyNames(obj).forEach((prop) => {
-        if (!isIgnoredProperty(prop) && !isFlagedIgnoreClone(obj, prop)) {
+    for (const prop of Object.getOwnPropertyNames(obj)) {
+        if (!isIgnoredProperty(obj, prop) && !isFlagedIgnoreClone(obj, prop)) {
             // Do not freeze ignored objects
             const value = obj[prop];
             if (typeof value === 'object' && value !== null) {
                 deepFreeze(value, visitedObjects);
             }
         }
-    });
+    }
 }
 /**
  * Customizer function for `cloneDeepWith` to handle specific cloning rules.
@@ -39,14 +39,10 @@ export function deepFreeze(obj, visitedObjects = new WeakSet()) {
  * @returns The value to use for the cloned property, or `undefined` to use the default cloning behavior.
  */
 export function deepCloneCustomizer(value, prop, target) {
-    if (prop?.toString().startsWith('_')) {
+    if (isFlagedIgnore(value, prop) || isFlagedIgnoreClone(target, prop) || prop?.toString().startsWith('_')) {
         // Do not clone : just copy the reference
         return value;
     }
-    if (isFlagedIgnoreClone(target, prop)) {
-        // Do not clone marked properties
-        return value;
-    }
     // Else : do nothing special, the default cloneDeep will be used.
 }
 /**
@@ -108,8 +104,14 @@ export function isConstructor(prop) {
  * @param prop - The property name or symbol to check.
  * @returns `true` if the property should be ignored, otherwise `false`.
  */
-export function isIgnoredProperty(prop) {
-    return typeof prop === 'symbol' || (prop.startsWith('_') && !isVirtualProperty(prop));
+export function isIgnoredProperty(target, prop) {
+    if (typeof prop === 'symbol') {
+        return true;
+    }
+    if (prop.startsWith('_') && !isVirtualProperty(prop)) {
+        return true;
+    }
+    return isFlagedIgnore(target, prop);
 }
 /**
  * Checks if a property on a target object is flagged to be ignored during cloning.
@@ -121,6 +123,16 @@ export function isIgnoredProperty(prop) {
 export function isFlagedIgnoreClone(target, prop) {
     return target?.[ignoreCloneSymbol]?.includes(prop);
 }
+/**
+ * Checks if a property on a target object is flagged to be totally ignored by brain.
+ *
+ * @param target - The object containing the property.
+ * @param prop - The property name or index to check.
+ * @returns `true` if the property is flagged to be ignored, otherwise `false`.
+ */
+export function isFlagedIgnore(target, prop) {
+    return target?.[ignoreSymbol]?.includes(prop);
+}
 /**
  * Determines if a value is of a supported type.
  * Unsupported types include `WeakMap`, `WeakSet`, `Map`, and `Set`.

package/tools/state/statemanager.spec.js

@@ -52,7 +52,7 @@ describe('StateManager.subscribe', () => {
             controlValue = 2;
         };
         try {
-            manager.state.ogcServers = {};
+            manager.state.basemaps = {};
             manager.subscribe('ogcServers', callback);
             expect(controlValue).toEqual(1);
         }