@egen-civitas/esm-extensions 2.3.0 → 2.4.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @egen-civitas/esm-extensions
 
+## 2.4.0
+
+### Minor Changes
+
+- 3d304d5: Slot de navigation de la TopBar sans numéro de niveau : nouvelle constante `TOPBAR_NAV_SLOT` (`topbar-nav-slot`) et `TOPBAR_NAV_SLOTS` (tous les noms à lire, officiel d'abord). `TOPBAR_LEVEL2_NAV_SLOT` (`topbar-level2-nav`) est conservée, marquée `@deprecated`, et reste honorée : `SectionNavPanel` lit les deux slots (sans doublon). Les apps migrent leur `routes.json` vers le nouveau nom quand elles veulent ; aucune rupture.
+
 ## 2.3.0
 
 ### Minor Changes

package/dist/nav-entry.d.ts

@@ -1,14 +1,28 @@
 /** @module @category Extension */
 /**
- * Nom du slot sur lequel chaque app déclare ses entrées de navigation
- * (niveau 2 de la TopBar). Déclaré dans le `routes.json` de l'app :
- * `{ "slot": "topbar-level2-nav", "component": "navEntry", "meta": NavEntryMeta }`.
+ * Nom du slot sur lequel chaque app déclare ses entrées de navigation de la TopBar. Déclaré dans le
+ * `routes.json` de l'app : `{ "slot": "topbar-nav-slot", "component": "navEntry", "meta": NavEntryMeta }`.
+ *
+ * Le nom ne désigne aucun niveau : la TopBar est une pile de N niveaux et la navigation peut être placée dans
+ * n'importe lequel (c'est la config de la TopBar qui décide).
+ */
+export declare const TOPBAR_NAV_SLOT = "topbar-nav-slot";
+/**
+ * Ancien nom du slot de navigation (`topbar-level2-nav`), de l'époque où la TopBar n'avait que deux niveaux.
+ * Toujours honoré pour les apps déjà déployées.
+ *
+ * @deprecated Déclarer les entrées sur {@link TOPBAR_NAV_SLOT}.
  */
 export declare const TOPBAR_LEVEL2_NAV_SLOT = "topbar-level2-nav";
 /**
- * Métadonnées d'une entrée de navigation du niveau 2 de la TopBar.
+ * Tous les noms de slot de navigation, le nom officiel d'abord. Un lecteur (TopBar, panneau de section…) doit
+ * les lire TOUS et fusionner les entrées, tant que des apps déclarent encore l'ancien nom.
+ */
+export declare const TOPBAR_NAV_SLOTS: readonly string[];
+/**
+ * Métadonnées d'une entrée de navigation de la TopBar.
  * Partagé par les apps (qui le déclarent dans `meta`) et par la TopBar
- * (qui le lit via `useExtensionSlotMeta<NavEntryMeta>(TOPBAR_LEVEL2_NAV_SLOT)`).
+ * (qui le lit sur tous les slots de {@link TOPBAR_NAV_SLOTS}).
  */
 export interface NavEntryMeta {
     /** Entrée de niveau 2 (ex. `informations`) ; regroupe les colonnes du méga-menu. */

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

@@ -1 +1 @@
-{"version":3,"file":"nav-entry.d.ts","sourceRoot":"","sources":["../src/nav-entry.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2GAA2G;IAC3G,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,YAAY,CAelE;AAED,wGAAwG;AACxG,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAItF"}
+{"version":3,"file":"nav-entry.d.ts","sourceRoot":"","sources":["../src/nav-entry.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAA8C,CAAC;AAE7F;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2GAA2G;IAC3G,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,YAAY,CAelE;AAED,wGAAwG;AACxG,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAItF"}

package/dist/nav-entry.js

@@ -1,8 +1,23 @@
 /** @module @category Extension */ /**
- * Nom du slot sur lequel chaque app déclare ses entrées de navigation
- * (niveau 2 de la TopBar). Déclaré dans le `routes.json` de l'app :
- * `{ "slot": "topbar-level2-nav", "component": "navEntry", "meta": NavEntryMeta }`.
+ * Nom du slot sur lequel chaque app déclare ses entrées de navigation de la TopBar. Déclaré dans le
+ * `routes.json` de l'app : `{ "slot": "topbar-nav-slot", "component": "navEntry", "meta": NavEntryMeta }`.
+ *
+ * Le nom ne désigne aucun niveau : la TopBar est une pile de N niveaux et la navigation peut être placée dans
+ * n'importe lequel (c'est la config de la TopBar qui décide).
+ */ export const TOPBAR_NAV_SLOT = 'topbar-nav-slot';
+/**
+ * Ancien nom du slot de navigation (`topbar-level2-nav`), de l'époque où la TopBar n'avait que deux niveaux.
+ * Toujours honoré pour les apps déjà déployées.
+ *
+ * @deprecated Déclarer les entrées sur {@link TOPBAR_NAV_SLOT}.
  */ export const TOPBAR_LEVEL2_NAV_SLOT = 'topbar-level2-nav';
+/**
+ * Tous les noms de slot de navigation, le nom officiel d'abord. Un lecteur (TopBar, panneau de section…) doit
+ * les lire TOUS et fusionner les entrées, tant que des apps déclarent encore l'ancien nom.
+ */ export const TOPBAR_NAV_SLOTS = [
+    TOPBAR_NAV_SLOT,
+    TOPBAR_LEVEL2_NAV_SLOT
+];
 /** Valeur de `NavEntryMeta.workspaces` qui désigne « tous les espaces ». */ export const NAV_ALL_WORKSPACES = '*';
 /** Valide une `meta` d'extension : vrai si c'est une `NavEntryMeta` exploitable. */ export function isNavEntryMeta(meta) {
     if (!meta || typeof meta !== 'object') return false;

package/dist/public.d.ts

@@ -3,7 +3,7 @@ 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 { TOPBAR_NAV_SLOT, TOPBAR_NAV_SLOTS, 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';

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,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"}
+{"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,eAAe,EACf,gBAAgB,EAChB,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

@@ -1,7 +1,7 @@
 export { getExtensionNameFromId, registerExtension, attach, detach, detachAll, getAssignedExtensions, registerExtensionSlot } from "./extensions.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 { TOPBAR_NAV_SLOT, TOPBAR_NAV_SLOTS, 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";

package/package.json

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