@egen-civitas/esm-extensions 2.2.0 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @egen-civitas/esm-extensions
 
+## 2.3.0
+
+### Minor Changes
+
+- 0afcb05: `StaggeredMenuPanel` accepte des composants libres posés par les apps, comme les rails. Nouveau slot `staggered-menu-slot` (`STAGGERED_MENU_SLOT`) : une extension y déclare dans sa `meta` sa zone (`top`, `content`, `bottom`), son `order`, sa `priority`, `global` (visible quelle que soit l'app active ; sinon seulement quand son app est montée), `showTitle`, `titleKey`. Nouveaux exports : `registerStaggeredMenuEntry` (déclaration par le code), `resolveStaggeredMenuEntries`, `isStaggeredMenuEntryMeta`, `getStaggeredMenuEntryProblems`, `useStaggeredMenuEntries` et les types associés. Nouvelles props du panneau : `extensionSlot` (slot dédié ou `false`) et `maxExtensions` (limite par priorité). Le contenu est chargé à la première ouverture ; chaque composant reçoit `closeMenu`, `position` et `isOpen` en props ; un clic dans un menu/dialogue ouvert par un composant ne ferme plus le panneau (`closeOnClickAway`) ; le panneau fermé est `inert`. Aucun changement pour les usages existants.
+
 ## 2.2.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -3,6 +3,8 @@ export * from './helpers.js';
 export * from './nav-entry.js';
 export * from './tool-window.js';
 export * from './tool-window-registration.js';
+export * from './staggered-menu-slot.js';
+export * from './staggered-menu-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,+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"}
+{"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,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,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

@@ -3,6 +3,8 @@ export * from "./helpers.js";
 export * from "./nav-entry.js";
 export * from "./tool-window.js";
 export * from "./tool-window-registration.js";
+export * from "./staggered-menu-slot.js";
+export * from "./staggered-menu-registration.js";
 export * from "./nav-behavior.js";
 export * from "./modals.js";
 export * from "./workspaces.js";

package/dist/public.d.ts

@@ -6,5 +6,7 @@ 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, 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 { STAGGERED_MENU_SLOT, STAGGERED_MENU_AREAS, DEFAULT_STAGGERED_MENU_AREA, type StaggeredMenuArea, type StaggeredMenuEntryMeta, type StaggeredMenuAssignedExtension, type ResolvedStaggeredMenuEntry, type ResolveStaggeredMenuEntriesOptions, isStaggeredMenuArea, isStaggeredMenuEntryMeta, getStaggeredMenuEntryProblems, resolveStaggeredMenuEntries, } from './staggered-menu-slot.js';
+export { registerStaggeredMenuEntry, type StaggeredMenuEntryRegistration } from './staggered-menu-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,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"}
+{"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,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,kCAAkC,EACvC,mBAAmB,EACnB,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,0BAA0B,EAAE,KAAK,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AACnH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/dist/public.js

@@ -4,4 +4,6 @@ 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, isToolWindowSlot, isSafeToolWindowIconUrl, getToolWindowMetaProblems, getToolWindowCompartment, DEFAULT_COMPARTMENT_HEIGHTS } from "./tool-window.js";
 export { registerToolWindow } from "./tool-window-registration.js";
+export { STAGGERED_MENU_SLOT, STAGGERED_MENU_AREAS, DEFAULT_STAGGERED_MENU_AREA, isStaggeredMenuArea, isStaggeredMenuEntryMeta, getStaggeredMenuEntryProblems, resolveStaggeredMenuEntries } from "./staggered-menu-slot.js";
+export { registerStaggeredMenuEntry } from "./staggered-menu-registration.js";
 export { registerNavBehavior, getNavBehavior } from "./nav-behavior.js";

package/dist/staggered-menu-registration.d.ts

@@ -0,0 +1,27 @@
+import type { ExtensionRegistration } from './store.js';
+import { type StaggeredMenuEntryMeta } from './staggered-menu-slot.js';
+export interface StaggeredMenuEntryRegistration {
+    /** Nom du module (de l'app) qui porte le composant : celui de l'importmap / de la fédération. */
+    moduleName: string;
+    /** Identifiant unique de l'entrée (nom de l'extension). */
+    name: string;
+    /** Zone, ordre, priorité et portée de l'entrée. */
+    meta: StaggeredMenuEntryMeta;
+    /** Chargement du composant (cycles de vie single-spa), appelé quand le panneau s'ouvre pour la première fois. */
+    load: ExtensionRegistration['load'];
+    /**
+     * Slot visé. Défaut : `STAGGERED_MENU_SLOT`. À renseigner pour viser un panneau qui a son propre slot
+     * (prop `extensionSlot` de `StaggeredMenuPanel`).
+     */
+    slot?: string;
+    privileges?: ExtensionRegistration['privileges'];
+    featureFlag?: string;
+    displayExpression?: string;
+}
+/**
+ * Ajoute un composant libre au `StaggeredMenuPanel` par le code, sans `routes.json` : pour une app fédérée
+ * ou open source qui s'intègre depuis son point d'entrée. Équivalent exact d'une extension `routes.json`
+ * posée sur le slot du panneau. Retourne `false` (et avertit) si la `meta` est invalide.
+ */
+export declare function registerStaggeredMenuEntry(registration: StaggeredMenuEntryRegistration): boolean;
+//# sourceMappingURL=staggered-menu-registration.d.ts.map

package/dist/staggered-menu-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staggered-menu-registration.d.ts","sourceRoot":"","sources":["../src/staggered-menu-registration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,8BAA8B;IAC7C,iGAAiG;IACjG,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,IAAI,EAAE,sBAAsB,CAAC;IAC7B,iHAAiH;IACjH,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACpC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,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,0BAA0B,CAAC,YAAY,EAAE,8BAA8B,GAAG,OAAO,CAiChG"}

package/dist/staggered-menu-registration.js

@@ -0,0 +1,27 @@
+/** @module @category Extension */ import { attach, registerExtension } from "./extensions.js";
+import { getStaggeredMenuEntryProblems, STAGGERED_MENU_SLOT } from "./staggered-menu-slot.js";
+/**
+ * Ajoute un composant libre au `StaggeredMenuPanel` par le code, sans `routes.json` : pour une app fédérée
+ * ou open source qui s'intègre depuis son point d'entrée. Équivalent exact d'une extension `routes.json`
+ * posée sur le slot du panneau. Retourne `false` (et avertit) si la `meta` est invalide.
+ */ export function registerStaggeredMenuEntry(registration) {
+    const { moduleName, name, meta, load, slot = STAGGERED_MENU_SLOT, privileges, featureFlag, displayExpression } = registration;
+    const problems = getStaggeredMenuEntryProblems(meta);
+    if (problems.length > 0 || !slot) {
+        console.warn(`[staggered-menu] L'entrée « ${name} » de ${moduleName} n'est pas enregistrée : ${problems.join(' ; ') || 'slot vide'}.`);
+        return false;
+    }
+    registerExtension({
+        name,
+        moduleName,
+        load,
+        meta,
+        privileges,
+        featureFlag,
+        displayExpression,
+        online: true,
+        offline: false
+    });
+    attach(slot, name);
+    return true;
+}

package/dist/staggered-menu-slot.d.ts

@@ -0,0 +1,99 @@
+/** @module @category Extension */
+/**
+ * Extensions du `StaggeredMenuPanel`.
+ *
+ * Le panneau latéral animé du styleguide accepte des composants libres posés par les apps, de la même
+ * façon que les rails du shell (voir `tool-window.ts`) : une app déclare une **extension** sur le slot
+ * `staggered-menu-slot` et indique, dans sa `meta`, où, dans quel ordre et avec quelle priorité elle
+ * s'affiche.
+ *
+ * Déclaration dans le `routes.json` d'une app :
+ * `{ "slot": "staggered-menu-slot", "component": "monWidget", "meta": StaggeredMenuEntryMeta }`.
+ *
+ * Comme pour les rails, une entrée n'apparaît que lorsque son app est montée (une de ses pages est
+ * active), sauf si elle déclare `meta.global: true`.
+ */
+export declare const STAGGERED_MENU_SLOT = "staggered-menu-slot";
+/**
+ * Zones du panneau qui accueillent des extensions, dans l'ordre d'affichage :
+ *
+ *   `top`     avant la liste des liens de navigation
+ *   `content` juste après la liste des liens (zone par défaut)
+ *   `bottom`  en pied de panneau, après le bloc de liens sociaux
+ */
+export declare const STAGGERED_MENU_AREAS: readonly ["top", "content", "bottom"];
+export type StaggeredMenuArea = (typeof STAGGERED_MENU_AREAS)[number];
+/** Zone utilisée quand `meta.area` est absent. */
+export declare const DEFAULT_STAGGERED_MENU_AREA: StaggeredMenuArea;
+/** Métadonnées d'une extension du panneau (titre accessible, zone, ordre, priorité, portée). */
+export interface StaggeredMenuEntryMeta {
+    /** Titre : nom accessible de la section et, avec `showTitle`, intitulé visible au-dessus du composant. */
+    title: string;
+    /** Clé de traduction du titre (optionnelle), cherchée dans le module de l'app. */
+    titleKey?: string;
+    /** Zone du panneau où s'affiche le composant (défaut `content`). */
+    area?: StaggeredMenuArea;
+    /**
+     * Position dans la zone (ordre croissant). Absent : ordre d'enregistrement du slot. Comme pour les rails,
+     * deux entrées de même `order` sont départagées par `priority` puis par l'ordre d'enregistrement.
+     */
+    order?: number;
+    /**
+     * Importance de l'entrée (défaut 0, plus grand = plus important). Sert (1) à départager deux entrées de
+     * même `order` : la plus prioritaire passe devant, et (2) à choisir les entrées conservées quand le panneau
+     * limite leur nombre (`maxExtensions`) : les moins prioritaires sont écartées.
+     */
+    priority?: number;
+    /**
+     * L'entrée reste affichée quelle que soit l'app active (comme `global` des rails). Absent : elle n'apparaît
+     * que lorsqu'une page de son app est montée.
+     */
+    global?: boolean;
+    /** Affiche `title` comme intitulé visible au-dessus du composant (défaut : non, le composant est libre). */
+    showTitle?: boolean;
+}
+/** Vrai si `area` est une zone connue du panneau. */
+export declare function isStaggeredMenuArea(area: unknown): area is StaggeredMenuArea;
+/**
+ * Liste précise des problèmes d'une `meta` d'extension du panneau (vide = valide). Une entrée invalide
+ * n'apparaît pas : le dire clairement à l'enregistrement évite de chercher pourquoi à l'intégration d'une app.
+ */
+export declare function getStaggeredMenuEntryProblems(meta: unknown): string[];
+/** Valide une `meta` d'extension : vrai si c'est une `StaggeredMenuEntryMeta` exploitable. */
+export declare function isStaggeredMenuEntryMeta(meta: unknown): meta is StaggeredMenuEntryMeta;
+/** Forme minimale d'une extension assignée au slot (compatible avec `AssignedExtension`). */
+export interface StaggeredMenuAssignedExtension {
+    name: string;
+    moduleName: string;
+    meta?: unknown;
+}
+/** Entrée résolue : une extension valide, visible, avec sa zone, son ordre et sa priorité calculés. */
+export interface ResolvedStaggeredMenuEntry<T extends StaggeredMenuAssignedExtension = StaggeredMenuAssignedExtension> {
+    /** Nom de l'extension : identifiant de l'entrée dans le panneau. */
+    id: string;
+    moduleName: string;
+    meta: StaggeredMenuEntryMeta;
+    area: StaggeredMenuArea;
+    order: number;
+    priority: number;
+    /** Extension d'origine (pour la retrouver dans le slot). */
+    extension: T;
+}
+export interface ResolveStaggeredMenuEntriesOptions {
+    /**
+     * Nombre maximal d'entrées affichées. Au-delà, les moins prioritaires sont écartées (à priorité égale,
+     * les premières dans l'ordre d'affichage sont conservées). Absent ou invalide : aucune limite.
+     */
+    maxEntries?: number;
+}
+/**
+ * Entrées affichables du panneau, dans l'ordre d'affichage.
+ *
+ * 1. écarte les entrées dont la `meta` est invalide ;
+ * 2. écarte celles dont l'app n'est pas montée, sauf `meta.global` ;
+ * 3. si `maxEntries` est fixé, ne garde que les plus prioritaires ;
+ * 4. trie par zone (`top`, `content`, `bottom`), puis `order` croissant, puis `priority` décroissante,
+ *    puis ordre d'enregistrement.
+ */
+export declare function resolveStaggeredMenuEntries<T extends StaggeredMenuAssignedExtension>(assigned: readonly T[], activeModules: ReadonlySet<string>, options?: ResolveStaggeredMenuEntriesOptions): ResolvedStaggeredMenuEntry<T>[];
+//# sourceMappingURL=staggered-menu-slot.d.ts.map

package/dist/staggered-menu-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staggered-menu-slot.d.ts","sourceRoot":"","sources":["../src/staggered-menu-slot.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,uCAAwC,CAAC;AAE1E,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,kDAAkD;AAClD,eAAO,MAAM,2BAA2B,EAAE,iBAA6B,CAAC;AAExE,gGAAgG;AAChG,MAAM,WAAW,sBAAsB;IACrC,0GAA0G;IAC1G,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4GAA4G;IAC5G,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,iBAAiB,CAE5E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAerE;AAED,8FAA8F;AAC9F,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,sBAAsB,CAEtF;AAED,6FAA6F;AAC7F,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,uGAAuG;AACvG,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,8BAA8B,GAAG,8BAA8B;IACnH,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,SAAS,EAAE,CAAC,CAAC;CACd;AAED,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,SAAS,8BAA8B,EAClF,QAAQ,EAAE,SAAS,CAAC,EAAE,EACtB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,EAClC,OAAO,GAAE,kCAAuC,GAC/C,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAgDjC"}

package/dist/staggered-menu-slot.js

@@ -0,0 +1,93 @@
+/** @module @category Extension */ /**
+ * Extensions du `StaggeredMenuPanel`.
+ *
+ * Le panneau latéral animé du styleguide accepte des composants libres posés par les apps, de la même
+ * façon que les rails du shell (voir `tool-window.ts`) : une app déclare une **extension** sur le slot
+ * `staggered-menu-slot` et indique, dans sa `meta`, où, dans quel ordre et avec quelle priorité elle
+ * s'affiche.
+ *
+ * Déclaration dans le `routes.json` d'une app :
+ * `{ "slot": "staggered-menu-slot", "component": "monWidget", "meta": StaggeredMenuEntryMeta }`.
+ *
+ * Comme pour les rails, une entrée n'apparaît que lorsque son app est montée (une de ses pages est
+ * active), sauf si elle déclare `meta.global: true`.
+ */ export const STAGGERED_MENU_SLOT = 'staggered-menu-slot';
+/**
+ * Zones du panneau qui accueillent des extensions, dans l'ordre d'affichage :
+ *
+ *   `top`     avant la liste des liens de navigation
+ *   `content` juste après la liste des liens (zone par défaut)
+ *   `bottom`  en pied de panneau, après le bloc de liens sociaux
+ */ export const STAGGERED_MENU_AREAS = [
+    'top',
+    'content',
+    'bottom'
+];
+/** Zone utilisée quand `meta.area` est absent. */ export const DEFAULT_STAGGERED_MENU_AREA = 'content';
+/** Vrai si `area` est une zone connue du panneau. */ export function isStaggeredMenuArea(area) {
+    return typeof area === 'string' && STAGGERED_MENU_AREAS.includes(area);
+}
+/**
+ * Liste précise des problèmes d'une `meta` d'extension du panneau (vide = valide). Une entrée invalide
+ * n'apparaît pas : le dire clairement à l'enregistrement évite de chercher pourquoi à l'intégration d'une app.
+ */ export function getStaggeredMenuEntryProblems(meta) {
+    if (!meta || typeof meta !== 'object') return [
+        '`meta` est absente : ajouter au moins { "title": "…" }'
+    ];
+    const m = meta;
+    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.area !== undefined && !isStaggeredMenuArea(m.area)) problems.push(`\`area\` vaut ${STAGGERED_MENU_AREAS.map((a)=>`"${a}"`).join(', ')}`);
+    if (m.order !== undefined && (typeof m.order !== 'number' || !Number.isFinite(m.order))) problems.push('`order` doit être un nombre fini');
+    if (m.priority !== undefined && (typeof m.priority !== 'number' || !Number.isFinite(m.priority))) problems.push('`priority` doit être un nombre fini');
+    if (m.global !== undefined && typeof m.global !== 'boolean') problems.push('`global` doit être un booléen');
+    if (m.showTitle !== undefined && typeof m.showTitle !== 'boolean') problems.push('`showTitle` doit être un booléen');
+    return problems;
+}
+/** Valide une `meta` d'extension : vrai si c'est une `StaggeredMenuEntryMeta` exploitable. */ export function isStaggeredMenuEntryMeta(meta) {
+    return getStaggeredMenuEntryProblems(meta).length === 0;
+}
+/**
+ * Entrées affichables du panneau, dans l'ordre d'affichage.
+ *
+ * 1. écarte les entrées dont la `meta` est invalide ;
+ * 2. écarte celles dont l'app n'est pas montée, sauf `meta.global` ;
+ * 3. si `maxEntries` est fixé, ne garde que les plus prioritaires ;
+ * 4. trie par zone (`top`, `content`, `bottom`), puis `order` croissant, puis `priority` décroissante,
+ *    puis ordre d'enregistrement.
+ */ export function resolveStaggeredMenuEntries(assigned, activeModules, options = {}) {
+    const areaRank = (area)=>STAGGERED_MENU_AREAS.indexOf(area);
+    const visible = assigned.map((extension, index)=>({
+            extension,
+            index
+        })).filter(({ extension })=>isStaggeredMenuEntryMeta(extension.meta)).filter(({ extension })=>extension.meta.global === true || activeModules.has(extension.moduleName)).map(({ extension, index })=>{
+        const meta = extension.meta;
+        return {
+            index,
+            entry: {
+                id: extension.name,
+                moduleName: extension.moduleName,
+                meta,
+                area: meta.area ?? DEFAULT_STAGGERED_MENU_AREA,
+                order: meta.order ?? index,
+                priority: meta.priority ?? 0,
+                extension
+            }
+        };
+    });
+    const byDisplay = (a, b)=>areaRank(a.entry.area) - areaRank(b.entry.area) || a.entry.order - b.entry.order || b.entry.priority - a.entry.priority || a.index - b.index;
+    const sorted = [
+        ...visible
+    ].sort(byDisplay);
+    const { maxEntries } = options;
+    if (typeof maxEntries !== 'number' || !Number.isFinite(maxEntries) || maxEntries < 0 || maxEntries >= sorted.length) {
+        return sorted.map(({ entry })=>entry);
+    }
+    // Les plus prioritaires d'abord ; à priorité égale, celles qui passent en premier à l'affichage.
+    const kept = new Set(sorted.map((item, displayIndex)=>({
+            item,
+            displayIndex
+        })).sort((a, b)=>b.item.entry.priority - a.item.entry.priority || a.displayIndex - b.displayIndex).slice(0, Math.floor(maxEntries)).map(({ item })=>item));
+    return sorted.filter((item)=>kept.has(item)).map(({ entry })=>entry);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@egen-civitas/esm-extensions",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "license": "MPL-2.0",
   "description": "Coordinates extensions and extension points in the Egen Frontend",
   "type": "module",