@egen-civitas/esm-extensions 2.0.0 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @egen-civitas/esm-extensions
 
+## 2.2.0
+
+### Minor Changes
+
+- fa07dbd: Compartiments verticaux dans les zones gauche et droite. Chaque zone devient une pile de compartiments dont les hauteurs (en % de la zone) totalisent toujours 100 : aucun débordement, contenu défilant en interne, redimensionnement libre entre voisins (les autres s'ajustent selon leurs minimum et maximum). La zone actuelle devient le compartiment par défaut (dimensions fixées par le shell) et porte désormais le fond sombre à la place de la zone. Une app choisit, dans la `meta` de son option de rail, d'afficher dans le compartiment par défaut ou dans un compartiment propre via `meta.compartment` (`{ height, minHeight, maxHeight }` en %, valeurs par défaut `DEFAULT_COMPARTMENT_HEIGHTS`). Nouveaux exports : `getToolWindowCompartment`, `DEFAULT_COMPARTMENT_HEIGHTS`, `ToolWindowCompartment`, `closeToolWindow(anchor, id?)` pour fermer un seul compartiment.
+
+## 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

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './extensions.js';
 export * from './helpers.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,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

@@ -2,6 +2,7 @@ export * from "./extensions.js";
 export * from "./helpers.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

@@ -4,6 +4,7 @@ export { type ExtensionMeta, type ExtensionRegistration, type ExtensionStore, ty
 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, getToolWindowCompartment, DEFAULT_COMPARTMENT_HEIGHTS, type ToolWindowCompartment, type ResolvedToolWindowCompartment, } 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,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,EACzB,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,GACnC,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

@@ -2,5 +2,6 @@ export { getExtensionNameFromId, registerExtension, attach, detach, detachAll, g
 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, getToolWindowCompartment, DEFAULT_COMPARTMENT_HEIGHTS } 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,CA6BhF"}

package/dist/tool-window-registration.js

@@ -0,0 +1,30 @@
+/** @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;
+    }
+    if (anchor === 'bottom' && meta.compartment && meta.compartment !== 'default') {
+        console.warn(`[workbench] La fenêtre d'outils « ${name} » de ${moduleName} : \`compartment\` est ignoré dans la zone basse (zones gauche et droite uniquement).`);
+    }
+    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

@@ -27,6 +27,28 @@ export declare const SHELL_RAIL_RIGHT_SLOT = "shell-rail-right-slot";
 export type ToolWindowAnchor = 'left' | 'bottom' | 'right';
 /** Slot de rail associé à chaque zone. */
 export declare const TOOL_WINDOW_SLOTS: Readonly<Record<ToolWindowAnchor, string>>;
+/**
+ * Compartiment propre : bloc vertical redimensionnable d'une zone latérale (gauche ou droite).
+ *
+ * Une zone latérale est une pile verticale de compartiments dont les hauteurs, exprimées en
+ * **pourcentage de la hauteur de la zone**, totalisent toujours 100 : jamais de débordement. Chaque
+ * compartiment défile en interne quand son contenu est trop haut, et peut être redimensionné librement
+ * (dans ses bornes) face à ses voisins.
+ *
+ * Toutes les valeurs sont optionnelles : celles qui manquent prennent `DEFAULT_COMPARTMENT_HEIGHTS`.
+ */
+export interface ToolWindowCompartment {
+    /** Hauteur de base à l'ouverture, en % de la zone (défaut 40). */
+    height?: number;
+    /** Hauteur minimale, en % de la zone (défaut 15). */
+    minHeight?: number;
+    /** Hauteur maximale, en % de la zone (défaut 100). */
+    maxHeight?: number;
+}
+/** Hauteurs (en % de la zone) d'un compartiment propre dont l'app n'a pas précisé les valeurs. */
+export declare const DEFAULT_COMPARTMENT_HEIGHTS: Readonly<Required<ToolWindowCompartment>>;
+/** Hauteurs résolues d'un compartiment propre : `minHeight <= height <= maxHeight`, tout dans ]0, 100]. */
+export type ResolvedToolWindowCompartment = Required<ToolWindowCompartment>;
 /** Métadonnées d'une fenêtre d'outils (bouton de rail + titre de zone). */
 export interface ToolWindowMeta {
     /** Titre par défaut : info-bulle du bouton et en-tête de la zone. */
@@ -35,6 +57,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;
     /**
@@ -49,7 +78,37 @@ export interface ToolWindowMeta {
      * qui occupe toute la largeur entre les rails.
      */
     rail?: 'left' | 'right';
+    /**
+     * Zones gauche et droite uniquement : où s'affiche le contenu.
+     *
+     * - `'default'` (ou absent) : dans le **compartiment par défaut** de la zone, partagé avec les autres
+     *   fenêtres d'outils du rail (une seule y est affichée à la fois). Ses dimensions sont fixées par le
+     *   shell et ne sont pas modifiables par les apps.
+     * - un objet `ToolWindowCompartment` : dans un **compartiment propre**, empilé verticalement sous/sur les
+     *   autres, ouvert indépendamment du compartiment par défaut. L'app y définit la hauteur de base, le
+     *   minimum et le maximum (en % de la zone) ; les valeurs omises prennent `DEFAULT_COMPARTMENT_HEIGHTS`.
+     *
+     * Sans effet sur la zone basse.
+     */
+    compartment?: 'default' | ToolWindowCompartment;
 }
+/**
+ * Résout `meta.compartment` : `null` pour le compartiment par défaut, sinon les hauteurs d'un compartiment
+ * propre, complétées par `DEFAULT_COMPARTMENT_HEIGHTS` puis rendues cohérentes (`min <= base <= max`).
+ */
+export declare function getToolWindowCompartment(meta: {
+    compartment?: unknown;
+}): ResolvedToolWindowCompartment | null;
+/** 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;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kGAAkG;AAClG,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAIjF,CAAC;AAEF,2GAA2G;AAC3G,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAAC;AAE5E,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;IACxB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,SAAS,GAAG,qBAAqB,CAAC;CACjD;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,6BAA6B,GAAG,IAAI,CAW9G;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,CAmCjE;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,82 @@ 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;
+/** Hauteurs (en % de la zone) d'un compartiment propre dont l'app n'a pas précisé les valeurs. */ export const DEFAULT_COMPARTMENT_HEIGHTS = {
+    height: 40,
+    minHeight: 15,
+    maxHeight: 100
+};
+const COMPARTMENT_KEYS = [
+    'height',
+    'minHeight',
+    'maxHeight'
+];
+/**
+ * Résout `meta.compartment` : `null` pour le compartiment par défaut, sinon les hauteurs d'un compartiment
+ * propre, complétées par `DEFAULT_COMPARTMENT_HEIGHTS` puis rendues cohérentes (`min <= base <= max`).
+ */ export function getToolWindowCompartment(meta) {
+    const raw = meta.compartment;
+    if (!raw || raw === 'default' || typeof raw !== 'object') return null;
+    const value = (key)=>{
+        const n = raw[key];
+        return typeof n === 'number' && Number.isFinite(n) && n > 0 && n <= 100 ? n : DEFAULT_COMPARTMENT_HEIGHTS[key];
+    };
+    const minHeight = value('minHeight');
+    const maxHeight = Math.max(minHeight, value('maxHeight'));
+    const height = Math.min(maxHeight, Math.max(minHeight, value('height')));
+    return {
+        height,
+        minHeight,
+        maxHeight
+    };
+}
+/** 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"');
+    if (m.compartment !== undefined && m.compartment !== 'default') {
+        const c = m.compartment;
+        if (!c || typeof c !== 'object' || Array.isArray(c)) {
+            problems.push('`compartment` vaut \"default\" ou un objet { height, minHeight, maxHeight }');
+        } else {
+            for (const key of COMPARTMENT_KEYS){
+                const n = c[key];
+                if (n !== undefined && (typeof n !== 'number' || !Number.isFinite(n) || n <= 0 || n > 100)) problems.push(`\`compartment.${key}\` doit être un nombre dans ]0, 100] (pourcentage de la zone)`);
+            }
+            const resolved = getToolWindowCompartment({
+                compartment: c
+            });
+            if (resolved && problems.length === 0) {
+                const { minHeight, maxHeight } = {
+                    minHeight: c.minHeight ?? DEFAULT_COMPARTMENT_HEIGHTS.minHeight,
+                    maxHeight: c.maxHeight ?? DEFAULT_COMPARTMENT_HEIGHTS.maxHeight
+                };
+                if (minHeight > maxHeight) problems.push('`compartment.minHeight` ne peut pas dépasser `compartment.maxHeight`');
+            }
+        }
+    }
+    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": "2.0.0",
+  "version": "2.2.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.2",
-    "@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.2",
-    "@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",