@egen-civitas/esm-extensions 1.5.0 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @egen-civitas/esm-extensions
 
+## 2.1.0
+
+### Minor Changes
+
+- 8a39e13: Rails et zones ouverts aux apps distantes/fédérées : `ToolWindowMeta.iconUrl` (icône personnalisée sûre, rendue en masque monochrome), `getToolWindowMetaProblems` + avertissement précis à l'enregistrement quand une `meta` de rail est invalide (plus d'entrée ignorée en silence), `registerToolWindow` (déclaration par le code, sans `routes.json`), `openToolWindow` (ouverture sans bascule). Guide : `packages/framework/esm-extensions/TOOL-WINDOWS.md`.
+
+### Patch Changes
+
+- Updated dependencies [159db44]
+  - @egen-civitas/esm-api@2.0.0
+  - @egen-civitas/esm-config@2.0.0
+  - @egen-civitas/esm-utils@2.0.0
+  - @egen-civitas/esm-globals@2.0.0
+  - @egen-civitas/esm-translations@1.0.3
+  - @egen-civitas/esm-state@1.0.3
+  - @egen-civitas/esm-feature-flags@1.0.2
+
+## 2.0.0
+
+### Major Changes
+
+- b8a56e7: Suppression complète de l'ancienne barre latérale (sidebar) : plus aucune app ne peut la monter. La navigation passe par les rails et zones du shell (`shell-rail-left-slot`, `shell-rail-bottom-slot`, `shell-rail-right-slot`) et la TopBar niveau 2 (`topbar-level2-nav`).
+
+  Retirés : `LeftNavMenu`, `setLeftNav`, `unsetLeftNav`, `SetLeftNavParams`, `LeftNavStore`, `useLeftNav`, `useLeftNavStore`, `DashboardExtension`, `createDashboard` (lien de sidebar), la variable `--egen-sidenav-width`, les styles `.cds--side-nav*` / `.active-left-nav-link`, la clé de traduction `leftNavigation` et les alias `side-nav` / `sidenav` de `esm-ai-tools`.
+
+### Patch Changes
+
+- Updated dependencies [b8a56e7]
+  - @egen-civitas/esm-translations@1.0.2
+
 ## 1.5.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export * from './extensions.js';
 export * from './helpers.js';
-export * from './left-nav.js';
 export * from './nav-entry.js';
 export * from './tool-window.js';
+export * from './tool-window-registration.js';
 export * from './nav-behavior.js';
 export * from './modals.js';
 export * from './workspaces.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -1,8 +1,8 @@
 export * from "./extensions.js";
 export * from "./helpers.js";
-export * from "./left-nav.js";
 export * from "./nav-entry.js";
 export * from "./tool-window.js";
+export * from "./tool-window-registration.js";
 export * from "./nav-behavior.js";
 export * from "./modals.js";
 export * from "./workspaces.js";

package/dist/public.d.ts

@@ -1,10 +1,10 @@
 export { getExtensionNameFromId, registerExtension, attach, detach, detachAll, getAssignedExtensions, registerExtensionSlot, } from './extensions.js';
-export { type LeftNavStore, setLeftNav, unsetLeftNav, type SetLeftNavParams } from './left-nav.js';
 export { type CancelLoading, renderExtension } from './render.js';
 export { type ExtensionMeta, type ExtensionRegistration, type ExtensionStore, type AssignedExtension, type ConnectedExtension, type ExtensionSlotState, getExtensionStore, } from './store.js';
 export { type WorkspaceRegistration } from './workspaces.js';
 export { type ExtensionData, type ComponentConfig } from './types.js';
 export { TOPBAR_LEVEL2_NAV_SLOT, NAV_ALL_WORKSPACES, type NavEntryMeta, isNavEntryMeta, isNavEntryInWorkspace, } from './nav-entry.js';
-export { SHELL_RAIL_LEFT_SLOT, SHELL_RAIL_BOTTOM_SLOT, SHELL_RAIL_RIGHT_SLOT, TOOL_WINDOW_SLOTS, type ToolWindowAnchor, type ToolWindowMeta, isToolWindowMeta, } from './tool-window.js';
+export { SHELL_RAIL_LEFT_SLOT, SHELL_RAIL_BOTTOM_SLOT, SHELL_RAIL_RIGHT_SLOT, TOOL_WINDOW_SLOTS, type ToolWindowAnchor, type ToolWindowMeta, isToolWindowMeta, isToolWindowSlot, isSafeToolWindowIconUrl, getToolWindowMetaProblems, } from './tool-window.js';
+export { registerToolWindow, type ToolWindowRegistration } from './tool-window-registration.js';
 export { type NavBehavior, type NavBehaviorTarget, type NavSelectContext, registerNavBehavior, getNavBehavior, } from './nav-behavior.js';
 //# sourceMappingURL=public.d.ts.map

package/dist/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../src/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,SAAS,EACT,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,KAAK,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,YAAY,EACjB,cAAc,EACd,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../src/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,SAAS,EACT,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,YAAY,EACjB,cAAc,EACd,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/dist/public.js

@@ -1,7 +1,7 @@
 export { getExtensionNameFromId, registerExtension, attach, detach, detachAll, getAssignedExtensions, registerExtensionSlot } from "./extensions.js";
-export { setLeftNav, unsetLeftNav } from "./left-nav.js";
 export { renderExtension } from "./render.js";
 export { getExtensionStore } from "./store.js";
 export { TOPBAR_LEVEL2_NAV_SLOT, NAV_ALL_WORKSPACES, isNavEntryMeta, isNavEntryInWorkspace } from "./nav-entry.js";
-export { SHELL_RAIL_LEFT_SLOT, SHELL_RAIL_BOTTOM_SLOT, SHELL_RAIL_RIGHT_SLOT, TOOL_WINDOW_SLOTS, isToolWindowMeta } from "./tool-window.js";
+export { SHELL_RAIL_LEFT_SLOT, SHELL_RAIL_BOTTOM_SLOT, SHELL_RAIL_RIGHT_SLOT, TOOL_WINDOW_SLOTS, isToolWindowMeta, isToolWindowSlot, isSafeToolWindowIconUrl, getToolWindowMetaProblems } from "./tool-window.js";
+export { registerToolWindow } from "./tool-window-registration.js";
 export { registerNavBehavior, getNavBehavior } from "./nav-behavior.js";

package/dist/tool-window-registration.d.ts

@@ -0,0 +1,24 @@
+import type { ExtensionRegistration } from './store.js';
+import { type ToolWindowAnchor, type ToolWindowMeta } from './tool-window.js';
+export interface ToolWindowRegistration {
+    /** Nom du module (de l'app) qui porte la fenêtre : celui de l'importmap / de la fédération. */
+    moduleName: string;
+    /** Identifiant unique de la fenêtre d'outils (nom de l'extension). */
+    name: string;
+    /** Zone dans laquelle le contenu s'ouvre ; détermine le rail (voir `ToolWindowMeta.rail` pour le bas). */
+    anchor: ToolWindowAnchor;
+    /** Bouton du rail + titre de la zone. */
+    meta: ToolWindowMeta;
+    /** Chargement du contenu (cycles de vie single-spa), appelé quand la zone s'ouvre. */
+    load: ExtensionRegistration['load'];
+    privileges?: ExtensionRegistration['privileges'];
+    featureFlag?: string;
+    displayExpression?: string;
+}
+/**
+ * Déclare une fenêtre d'outils par le code, sans `routes.json` : pour une app fédérée ou open source
+ * qui s'intègre au shell depuis son point d'entrée. Équivalent exact d'une extension `routes.json` posée
+ * sur le slot de rail de la zone. Retourne `false` (et avertit) si la `meta` est invalide.
+ */
+export declare function registerToolWindow(registration: ToolWindowRegistration): boolean;
+//# sourceMappingURL=tool-window-registration.d.ts.map

package/dist/tool-window-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-window-registration.d.ts","sourceRoot":"","sources":["../src/tool-window-registration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,sBAAsB;IACrC,+FAA+F;IAC/F,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,0GAA0G;IAC1G,MAAM,EAAE,gBAAgB,CAAC;IACzB,yCAAyC;IACzC,IAAI,EAAE,cAAc,CAAC;IACrB,sFAAsF;IACtF,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,sBAAsB,GAAG,OAAO,CAwBhF"}

package/dist/tool-window-registration.js

@@ -0,0 +1,27 @@
+/** @module @category Extension */ import { attach, registerExtension } from "./extensions.js";
+import { getToolWindowMetaProblems, TOOL_WINDOW_SLOTS } from "./tool-window.js";
+/**
+ * Déclare une fenêtre d'outils par le code, sans `routes.json` : pour une app fédérée ou open source
+ * qui s'intègre au shell depuis son point d'entrée. Équivalent exact d'une extension `routes.json` posée
+ * sur le slot de rail de la zone. Retourne `false` (et avertit) si la `meta` est invalide.
+ */ export function registerToolWindow(registration) {
+    const { moduleName, name, anchor, meta, load, privileges, featureFlag, displayExpression } = registration;
+    const problems = getToolWindowMetaProblems(meta);
+    if (problems.length > 0 || !TOOL_WINDOW_SLOTS[anchor]) {
+        console.warn(`[workbench] La fenêtre d'outils « ${name} » de ${moduleName} n'est pas enregistrée : ${problems.join(' ; ') || `zone inconnue « ${String(anchor)} »`}.`);
+        return false;
+    }
+    registerExtension({
+        name,
+        moduleName,
+        load,
+        meta,
+        privileges,
+        featureFlag,
+        displayExpression,
+        online: true,
+        offline: false
+    });
+    attach(TOOL_WINDOW_SLOTS[anchor], name);
+    return true;
+}

package/dist/tool-window.d.ts

@@ -35,6 +35,13 @@ export interface ToolWindowMeta {
     titleKey?: string;
     /** Nom d'icône lucide (ex. `Users`), résolu par le shell dans une liste blanche. */
     icon?: string;
+    /**
+     * Icône personnalisée (apps distantes/fédérées qui ne trouvent pas leur bonheur dans la liste
+     * blanche) : URL `https://…`, chemin absolu `/…` ou `data:image/svg+xml|png|webp…`. Affichée comme un
+     * masque monochrome (elle prend la couleur du rail) : fournir une icône d'une seule teinte. Prioritaire
+     * sur `icon`. Jamais injectée comme HTML : aucun script ne peut s'exécuter.
+     */
+    iconUrl?: string;
     /** Ordre d'affichage dans le rail (croissant) ; défaut : ordre du slot. */
     order?: number;
     /**
@@ -50,6 +57,16 @@ export interface ToolWindowMeta {
      */
     rail?: 'left' | 'right';
 }
+/** Vrai si `url` est une URL d'icône autorisée (`ToolWindowMeta.iconUrl`). */
+export declare function isSafeToolWindowIconUrl(url: unknown): url is string;
+/**
+ * Liste précise des problèmes d'une `meta` de fenêtre d'outils (vide = valide). Sert aux messages
+ * d'avertissement à l'enregistrement : une entrée invalide n'apparaît pas dans les rails, et le dire
+ * clairement évite de chercher pourquoi à l'intégration d'une app distante.
+ */
+export declare function getToolWindowMetaProblems(meta: unknown): string[];
 /** Valide une `meta` d'extension : vrai si c'est une `ToolWindowMeta` exploitable. */
 export declare function isToolWindowMeta(meta: unknown): meta is ToolWindowMeta;
+/** Vrai si `slot` est l'un des slots de rail du shell. */
+export declare function isToolWindowSlot(slot: string): boolean;
 //# sourceMappingURL=tool-window.d.ts.map

package/dist/tool-window.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-window.d.ts","sourceRoot":"","sources":["../src/tool-window.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAIxE,CAAC;AAEF,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,cAAc,CAUtE"}
+{"version":3,"file":"tool-window.d.ts","sourceRoot":"","sources":["../src/tool-window.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAIxE,CAAC;AAEF,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAcjE;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,cAAc,CAEtE;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/tool-window.js

@@ -26,14 +26,32 @@ export const SHELL_RAIL_RIGHT_SLOT = 'shell-rail-right-slot';
     bottom: SHELL_RAIL_BOTTOM_SLOT,
     right: SHELL_RAIL_RIGHT_SLOT
 };
-/** Valide une `meta` d'extension : vrai si c'est une `ToolWindowMeta` exploitable. */ export function isToolWindowMeta(meta) {
-    if (!meta || typeof meta !== 'object') return false;
+/** Vrai si `url` est une URL d'icône autorisée (`ToolWindowMeta.iconUrl`). */ export function isSafeToolWindowIconUrl(url) {
+    if (typeof url !== 'string' || url.length === 0) return false;
+    return /^(https:\/\/|\/(?!\/)|data:image\/(svg\+xml|png|webp|gif|jpeg)[;,])/i.test(url);
+}
+/**
+ * Liste précise des problèmes d'une `meta` de fenêtre d'outils (vide = valide). Sert aux messages
+ * d'avertissement à l'enregistrement : une entrée invalide n'apparaît pas dans les rails, et le dire
+ * clairement évite de chercher pourquoi à l'intégration d'une app distante.
+ */ export function getToolWindowMetaProblems(meta) {
+    if (!meta || typeof meta !== 'object') return [
+        '`meta` est absente : ajouter au moins { "title": "…" }'
+    ];
     const m = meta;
-    if (typeof m.title !== 'string' || m.title.length === 0) return false;
-    if (m.titleKey !== undefined && typeof m.titleKey !== 'string') return false;
-    if (m.icon !== undefined && typeof m.icon !== 'string') return false;
-    if (m.order !== undefined && (typeof m.order !== 'number' || !Number.isFinite(m.order))) return false;
-    if (m.global !== undefined && typeof m.global !== 'boolean') return false;
-    if (m.rail !== undefined && m.rail !== 'left' && m.rail !== 'right') return false;
-    return true;
+    const problems = [];
+    if (typeof m.title !== 'string' || m.title.length === 0) problems.push('`title` doit être une chaîne non vide');
+    if (m.titleKey !== undefined && typeof m.titleKey !== 'string') problems.push('`titleKey` doit être une chaîne');
+    if (m.icon !== undefined && typeof m.icon !== 'string') problems.push('`icon` doit être une chaîne');
+    if (m.iconUrl !== undefined && !isSafeToolWindowIconUrl(m.iconUrl)) problems.push('`iconUrl` doit commencer par https://, / ou data:image/(svg+xml|png|webp|gif|jpeg)');
+    if (m.order !== undefined && (typeof m.order !== 'number' || !Number.isFinite(m.order))) problems.push('`order` doit être un nombre fini');
+    if (m.global !== undefined && typeof m.global !== 'boolean') problems.push('`global` doit être un booléen');
+    if (m.rail !== undefined && m.rail !== 'left' && m.rail !== 'right') problems.push('`rail` vaut "left" ou "right"');
+    return problems;
+}
+/** Valide une `meta` d'extension : vrai si c'est une `ToolWindowMeta` exploitable. */ export function isToolWindowMeta(meta) {
+    return getToolWindowMetaProblems(meta).length === 0;
+}
+/** Vrai si `slot` est l'un des slots de rail du shell. */ export function isToolWindowSlot(slot) {
+    return Object.values(TOOL_WINDOW_SLOTS).includes(slot);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@egen-civitas/esm-extensions",
-  "version": "1.5.0",
+  "version": "2.1.0",
   "license": "MPL-2.0",
   "description": "Coordinates extensions and extension points in the Egen Frontend",
   "type": "module",
@@ -63,26 +63,26 @@
     "lodash-es": "^4.17.21"
   },
   "peerDependencies": {
-    "@egen-civitas/esm-api": "^1.1.1",
-    "@egen-civitas/esm-config": "^1.0.0",
+    "@egen-civitas/esm-api": "^2.0.0",
+    "@egen-civitas/esm-config": "^2.0.0",
     "@egen-civitas/esm-expression-evaluator": "^1.0.0",
-    "@egen-civitas/esm-feature-flags": "^1.0.0",
-    "@egen-civitas/esm-globals": "^1.0.3",
-    "@egen-civitas/esm-state": "^1.0.0",
-    "@egen-civitas/esm-translations": "^1.0.0",
-    "@egen-civitas/esm-utils": "^1.0.0",
+    "@egen-civitas/esm-feature-flags": "^1.0.2",
+    "@egen-civitas/esm-globals": "^2.0.0",
+    "@egen-civitas/esm-state": "^1.0.3",
+    "@egen-civitas/esm-translations": "^1.0.3",
+    "@egen-civitas/esm-utils": "^2.0.0",
     "react": "18.x",
     "single-spa": "6.x"
   },
   "devDependencies": {
-    "@egen-civitas/esm-api": "^1.1.1",
-    "@egen-civitas/esm-config": "^1.0.0",
+    "@egen-civitas/esm-api": "^2.0.0",
+    "@egen-civitas/esm-config": "^2.0.0",
     "@egen-civitas/esm-expression-evaluator": "^1.0.0",
-    "@egen-civitas/esm-feature-flags": "^1.0.0",
-    "@egen-civitas/esm-globals": "^1.0.3",
-    "@egen-civitas/esm-state": "^1.0.0",
-    "@egen-civitas/esm-translations": "^1.0.0",
-    "@egen-civitas/esm-utils": "^1.0.0",
+    "@egen-civitas/esm-feature-flags": "^1.0.2",
+    "@egen-civitas/esm-globals": "^2.0.0",
+    "@egen-civitas/esm-state": "^1.0.3",
+    "@egen-civitas/esm-translations": "^1.0.3",
+    "@egen-civitas/esm-utils": "^2.0.0",
     "@swc/cli": "0.8.1",
     "@swc/core": "1.15.21",
     "@vitest/coverage-v8": "^4.1.2",

package/dist/left-nav.d.ts

@@ -1,38 +0,0 @@
-import { type ComponentConfig } from './types.js';
-import { type ExtensionSlotState } from './store.js';
-type LeftNavMode = 'normal' | 'collapsed' | 'hidden';
-export interface LeftNavStore {
-    slotName: string | null;
-    basePath: string;
-    mode: LeftNavMode;
-    componentContext?: ComponentConfig;
-    state?: ExtensionSlotState;
-}
-/** @internal */
-export declare const leftNavStore: import("zustand").StoreApi<LeftNavStore>;
-export interface SetLeftNavParams {
-    name: string;
-    basePath: string;
-    /**
-     * In normal mode, the left nav is shown in desktop mode, and collapse into hamburger menu button in tablet mode
-     * In collapsed mode, the left nav is always collapsed, regardless of desktop / tablet mode.
-     * In hidden mode, the left nav is not shown at all.
-     */
-    mode?: LeftNavMode;
-    componentContext?: ComponentConfig;
-    state?: ExtensionSlotState;
-}
-/**
- * Sets the current left nav context. Must be paired with {@link unsetLeftNav}.
- *
- * @deprecated Il n'existe plus de barre latérale globale : la navigation de niveau 2 est portée par la TopBar (slot `topbar-level2-nav`, type `NavEntryMeta`). Une app qui a besoin d'une navigation interne affiche sa propre barre latérale.
- */
-export declare function setLeftNav({ name, basePath, mode, componentContext, state }: SetLeftNavParams): void;
-/**
- * Unsets the left nav context if the current context is for the supplied name.
- *
- * @deprecated Il n'existe plus de barre latérale globale : la navigation de niveau 2 est portée par la TopBar (slot `topbar-level2-nav`, type `NavEntryMeta`). Une app qui a besoin d'une navigation interne affiche sa propre barre latérale.
- */
-export declare function unsetLeftNav(name: string): void;
-export {};
-//# sourceMappingURL=left-nav.d.ts.map

package/dist/left-nav.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"left-nav.d.ts","sourceRoot":"","sources":["../src/left-nav.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,KAAK,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AACrD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED,gBAAgB;AAChB,eAAO,MAAM,YAAY,0CAIvB,CAAC;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,EAAE,gBAAgB,QAE7F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,QAIxC"}

package/dist/left-nav.js

@@ -1,28 +0,0 @@
-import { createGlobalStore } from "@egen-civitas/esm-state";
-/** @internal */ export const leftNavStore = createGlobalStore('left-nav', {
-    slotName: null,
-    basePath: window.spaBase,
-    mode: 'normal'
-});
-/**
- * Sets the current left nav context. Must be paired with {@link unsetLeftNav}.
- *
- * @deprecated Il n'existe plus de barre latérale globale : la navigation de niveau 2 est portée par la TopBar (slot `topbar-level2-nav`, type `NavEntryMeta`). Une app qui a besoin d'une navigation interne affiche sa propre barre latérale.
- */ export function setLeftNav({ name, basePath, mode, componentContext, state }) {
-    leftNavStore.setState({
-        slotName: name,
-        basePath,
-        mode: mode ?? 'normal',
-        componentContext,
-        state
-    });
-}
-/**
- * Unsets the left nav context if the current context is for the supplied name.
- *
- * @deprecated Il n'existe plus de barre latérale globale : la navigation de niveau 2 est portée par la TopBar (slot `topbar-level2-nav`, type `NavEntryMeta`). Une app qui a besoin d'une navigation interne affiche sa propre barre latérale.
- */ export function unsetLeftNav(name) {
-    if (leftNavStore.getState().slotName === name) {
-        leftNavStore.setState(leftNavStore.getInitialState(), true);
-    }
-}