@egen-civitas/esm-extensions 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# @egen-civitas/esm-extensions
+
+## 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
+
+- c82f723: Corrige une série de dépendances manquantes/mal déclarées trouvées en débloquant la CI (l'installation était bloquée depuis fin août, masquant ces problèmes) :
+
+  - `esm-tenant` : `happy-dom` manquait alors que ses tests l'utilisent (ni dep, ni peerDep) → ajouté en devDependency.
+  - `esm-ai-tools` : `swr` est chargé via un `import()` dynamique dans `native/index.ts` mais n'était déclaré nulle part → ajouté en peerDependency (`2.x`, cohérent avec `esm-styleguide`/`esm-react-utils`/`esm-framework`).
+  - `esm-api`, `esm-data-api` : `rxjs` utilisé au runtime mais absent de peerDependencies → ajouté (`7.x`).
+  - `esm-navigation`, `esm-styleguide`, `esm-react-utils` : `single-spa` utilisé au runtime mais absent de peerDependencies → ajouté (`6.x`).
+  - `esm-extensions` : `react` utilisé au runtime mais absent de peerDependencies → ajouté (`18.x`).
+  - `esm-ai-framework` : `framework.test.ts` faisait `require('@egen-civitas/esm-ai-tools')` en plein milieu du corps de 3 tests (au lieu d'un import statique en haut de fichier) — ce require contournait le mock de `@egen-civitas/esm-styleguide` et déclenchait une résolution Node native qui tentait de charger pour de vrai des fichiers `.module.scss` compilés (`Unknown file extension ".scss"`). Remplacé par un import statique de `hasTool`/`getTool`/`overrideTool`, et ajout d'un `vi.mock('@egen-civitas/esm-styleguide', ...)` en tête de fichier (même pattern déjà utilisé dans `esm-ai-tools/src/native/native.test.ts`).
+
+  Tous les fixes vérifiés par reproduction isolée réelle (installation + exécution effective des tests concernés), pas seulement par lecture de code.
+
+- Updated dependencies [c82f723]
+  - @egen-civitas/esm-api@1.1.1

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/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.1",
+  "version": "1.1.0",
   "license": "MPL-2.0",
   "description": "Coordinates extensions and extension points in the Egen Frontend",
   "type": "module",
@@ -63,7 +63,7 @@
     "lodash-es": "^4.17.21"
   },
   "peerDependencies": {
-    "@egen-civitas/esm-api": "^1.0.0",
+    "@egen-civitas/esm-api": "^1.1.1",
     "@egen-civitas/esm-config": "^1.0.0",
     "@egen-civitas/esm-expression-evaluator": "^1.0.0",
     "@egen-civitas/esm-feature-flags": "^1.0.0",
@@ -71,10 +71,11 @@
     "@egen-civitas/esm-state": "^1.0.0",
     "@egen-civitas/esm-translations": "^1.0.0",
     "@egen-civitas/esm-utils": "^1.0.0",
+    "react": "18.x",
     "single-spa": "6.x"
   },
   "devDependencies": {
-    "@egen-civitas/esm-api": "^1.0.0",
+    "@egen-civitas/esm-api": "^1.1.1",
     "@egen-civitas/esm-config": "^1.0.0",
     "@egen-civitas/esm-expression-evaluator": "^1.0.0",
     "@egen-civitas/esm-feature-flags": "^1.0.0",
@@ -94,4 +95,4 @@
     "single-spa": "^6.0.3",
     "vitest": "^4.1.2"
   }
-}
+}