@egen-civitas/esm-extensions 1.0.2 → 1.1.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @egen-civitas/esm-extensions
 
+## 1.1.1
+
+### Patch Changes
+
+- b49f9e8: Suppression définitive de la barre latérale globale : le conteneur `#egen-left-nav-container` est retiré du shell (il n'était plus que masqué) ainsi que ses règles CSS. `LeftNavMenu`, `useLeftNav`, `setLeftNav` et `unsetLeftNav` sont marqués `@deprecated` : la navigation de niveau 2 est portée par la TopBar (slot `topbar-level2-nav`) ; une app qui veut une navigation interne affiche sa propre barre latérale.
+
+## 1.1.0
+
+### Minor Changes
+
+- 48e7980: Navigation de niveau 2 pilotée par les apps : nouveau type partagé `NavEntryMeta`, constante `TOPBAR_LEVEL2_NAV_SLOT` (`topbar-level2-nav`) et validateur `isNavEntryMeta` dans `esm-extensions`. La colonne de navigation latérale globale (`leftNav`) est retirée de la grille du shell : seuls la TopBar et le footer sont globaux ; une app qui veut une sidebar la fournit dans son propre contenu.
+
 ## 1.0.2
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './extensions.js';
 export * from './helpers.js';
 export * from './left-nav.js';
+export * from './nav-entry.js';
 export * from './modals.js';
 export * from './workspaces.js';
 export * from './workspaces2.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,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,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,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,6 +1,7 @@
 export * from "./extensions.js";
 export * from "./helpers.js";
 export * from "./left-nav.js";
+export * from "./nav-entry.js";
 export * from "./modals.js";
 export * from "./workspaces.js";
 export * from "./workspaces2.js";

package/dist/left-nav.d.ts

@@ -25,13 +25,13 @@ export interface SetLeftNavParams {
 /**
  * Sets the current left nav context. Must be paired with {@link unsetLeftNav}.
  *
- * @deprecated Please use {@link useLeftNav} instead. This function will be made internal in a future release.
+ * @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 Please use {@link useLeftNav} instead. This function will be made internal in a future release.
+ * @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 {};

package/dist/left-nav.js

@@ -7,7 +7,7 @@ import { createGlobalStore } from "@egen-civitas/esm-state";
 /**
  * Sets the current left nav context. Must be paired with {@link unsetLeftNav}.
  *
- * @deprecated Please use {@link useLeftNav} instead. This function will be made internal in a future release.
+ * @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,
@@ -20,7 +20,7 @@ import { createGlobalStore } from "@egen-civitas/esm-state";
 /**
  * Unsets the left nav context if the current context is for the supplied name.
  *
- * @deprecated Please use {@link useLeftNav} instead. This function will be made internal in a future release.
+ * @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);

package/dist/nav-entry.d.ts

@@ -0,0 +1,38 @@
+/** @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 }`.
+ */
+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.
+ * Partagé par les apps (qui le déclarent dans `meta`) et par la TopBar
+ * (qui le lit via `useExtensionSlotMeta<NavEntryMeta>(TOPBAR_LEVEL2_NAV_SLOT)`).
+ */
+export interface NavEntryMeta {
+    /** Entrée de niveau 2 (ex. `informations`) ; regroupe les colonnes du méga-menu. */
+    section: string;
+    /** Colonne du méga-menu (ex. `news`). */
+    group: string;
+    /** Texte par défaut, utilisé si `labelKey` n'a pas de traduction. */
+    label: string;
+    /** Clé de traduction du libellé (optionnelle). */
+    labelKey?: string;
+    /** Description par défaut. */
+    description?: string;
+    /** Clé de traduction de la description (optionnelle). */
+    descriptionKey?: string;
+    /** Nom d'icône lucide (ex. `Star`), résolu par la TopBar dans une liste blanche. */
+    icon?: string;
+    /** Route cible, relative à la base SPA (ex. `informations/news`). Doit exister dans un `pages[].route`. */
+    route: string;
+    /** Libellé/clé de la section et du groupe, si différents de leur identifiant. */
+    sectionLabel?: string;
+    sectionLabelKey?: string;
+    groupLabel?: string;
+    groupLabelKey?: string;
+}
+/** Valide une `meta` d'extension : vrai si c'est une `NavEntryMeta` exploitable. */
+export declare function isNavEntryMeta(meta: unknown): meta is NavEntryMeta;
+//# sourceMappingURL=nav-entry.d.ts.map

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

@@ -0,0 +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,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,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;CACxB;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,YAAY,CAIlE"}

package/dist/nav-entry.js

@@ -0,0 +1,15 @@
+/** @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 }`.
+ */ export const TOPBAR_LEVEL2_NAV_SLOT = 'topbar-level2-nav';
+/** Valide une `meta` d'extension : vrai si c'est une `NavEntryMeta` exploitable. */ export function isNavEntryMeta(meta) {
+    if (!meta || typeof meta !== 'object') return false;
+    const m = meta;
+    return [
+        'section',
+        'group',
+        'label',
+        'route'
+    ].every((k)=>typeof m[k] === 'string' && m[k].length > 0);
+}

package/dist/public.d.ts

@@ -4,4 +4,5 @@ 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, type NavEntryMeta, isNavEntryMeta } from './nav-entry.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"}
+{"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,EAAE,sBAAsB,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/public.js

@@ -2,3 +2,4 @@ export { getExtensionNameFromId, registerExtension, attach, detach, detachAll, g
 export { setLeftNav, unsetLeftNav } from "./left-nav.js";
 export { renderExtension } from "./render.js";
 export { getExtensionStore } from "./store.js";
+export { TOPBAR_LEVEL2_NAV_SLOT, isNavEntryMeta } from "./nav-entry.js";

package/package.json

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