@egen-civitas/esm-extensions 1.2.1 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @egen-civitas/esm-extensions
 
+## 1.4.0
+
+### Minor Changes
+
+- af95904: Rail gauche : options globales avec sous-options.
+
+  - `ToolWindowMeta.global` : une extension du slot `shell-rail-left-slot` (ou `shell-rail-bottom-slot`) déclarée avec `meta.global: true` reste affichée dans le rail quelle que soit l'app active, comme le rail droit. Sans ce drapeau, le comportement est inchangé (seules les extensions de l'app active apparaissent).
+  - Nouveau composant `SectionNavPanel` (`section`) : contenu prêt à l'emploi d'une option globale. Il liste, dans la zone gauche, les sous-options d'une section (entrées `NavEntryMeta` déclarées par l'app sur `topbar-level2-nav`), regroupées par `group`, avec icône, et navigue vers la route de la sous-option au clic ; la sous-option de la page courante est marquée active. La zone centrale se met à jour par la navigation habituelle.
+  - Liste blanche d'icônes du plan de travail étendue (`Calendar`, `CalendarCheck`, `Compass`, `Contact`, `FileCheck`, `FileText`, `Globe`, `Layers`, `Radio`, `Star`, `Zap`).
+
+## 1.3.0
+
+### Minor Changes
+
+- 6ddbd06: Shell : plan de travail façon IntelliJ (rails fixes et zones redimensionnables).
+
+  - `esm-extensions` : contrat des fenêtres d'outils — slots `shell-rail-left-slot`, `shell-rail-bottom-slot` et `shell-rail-right-slot`, `ToolWindowMeta` (`title`, `titleKey`, `icon`, `order`) et `isToolWindowMeta`.
+  - `esm-styleguide` : composants `LeftRail`, `RightRail`, `ToolWindowZone` et `Splitter`, store `workbenchStore` (tailles et fenêtres actives mémorisées dans le navigateur), `renderWorkbench`, `useToolWindows`, `useActiveAppModules`. La grille du body passe à rail | zone gauche | centre | zone droite | rail | workspaces, avec une zone basse entre les rails ; la zone centrale devient une carte arrondie.
+  - `esm-app-shell` : nouveaux conteneurs `egen-rail-*-container` et `egen-zone-*-container`, montés au démarrage par `renderWorkbench`.
+
+  Le rail gauche (groupe haut → zone gauche, groupe bas → zone basse) n'affiche que les outils de l'app montée ; le rail droit est global. Rails et zones sont masqués sur les routes publiques, en dessous de 768 px et à l'impression.
+
 ## 1.2.1
 
 ### Patch Changes

package/dist/index.d.ts

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

package/dist/index.js

@@ -2,6 +2,7 @@ export * from "./extensions.js";
 export * from "./helpers.js";
 export * from "./left-nav.js";
 export * from "./nav-entry.js";
+export * from "./tool-window.js";
 export * from "./nav-behavior.js";
 export * from "./modals.js";
 export * from "./workspaces.js";

package/dist/public.d.ts

@@ -5,5 +5,6 @@ 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 { 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,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,EACL,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,YAAY,EACjB,cAAc,EACd,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,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,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,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"}

package/dist/public.js

@@ -3,4 +3,5 @@ export { setLeftNav, unsetLeftNav } from "./left-nav.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 { SHELL_RAIL_LEFT_SLOT, SHELL_RAIL_BOTTOM_SLOT, SHELL_RAIL_RIGHT_SLOT, TOOL_WINDOW_SLOTS, isToolWindowMeta } from "./tool-window.js";
 export { registerNavBehavior, getNavBehavior } from "./nav-behavior.js";

package/dist/tool-window.d.ts

@@ -0,0 +1,48 @@
+/** @module @category Extension */
+/**
+ * Fenêtres d'outils du shell (façon IntelliJ).
+ *
+ * Le shell porte deux rails fixes (gauche et droite) et trois zones redimensionnables
+ * (gauche, droite, bas). Chaque entrée d'un rail est une **extension** : sa `meta`
+ * (`ToolWindowMeta`) décrit le bouton du rail, son composant est le contenu de la zone
+ * associée, affiché quand le bouton est actif.
+ *
+ *   rail gauche, groupe haut  → slot `shell-rail-left-slot`   → zone gauche (sidebar de l'app)
+ *   rail gauche, groupe bas   → slot `shell-rail-bottom-slot` → zone basse (ex. terminal)
+ *   rail droit                → slot `shell-rail-right-slot`  → zone droite (options globales)
+ *
+ * Déclaration dans le `routes.json` d'une app :
+ * `{ "slot": "shell-rail-left-slot", "component": "projectPanel", "meta": ToolWindowMeta }`.
+ *
+ * Les rails gauche et bas n'affichent que les extensions de l'app active, sauf celles qui
+ * déclarent `meta.global: true` (toujours visibles, quelle que soit l'app active, comme le rail
+ * droit). Le rail droit est entièrement global (toutes les apps, y compris celles qui ne sont
+ * pas montées).
+ */
+export declare const SHELL_RAIL_LEFT_SLOT = "shell-rail-left-slot";
+export declare const SHELL_RAIL_BOTTOM_SLOT = "shell-rail-bottom-slot";
+export declare const SHELL_RAIL_RIGHT_SLOT = "shell-rail-right-slot";
+/** Zone du shell dans laquelle une fenêtre d'outils affiche son contenu. */
+export type ToolWindowAnchor = 'left' | 'bottom' | 'right';
+/** Slot de rail associé à chaque zone. */
+export declare const TOOL_WINDOW_SLOTS: Readonly<Record<ToolWindowAnchor, string>>;
+/** 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. */
+    title: string;
+    /** Clé de traduction du titre (optionnelle). */
+    titleKey?: string;
+    /** Nom d'icône lucide (ex. `Users`), résolu par le shell dans une liste blanche. */
+    icon?: string;
+    /** Ordre d'affichage dans le rail (croissant) ; défaut : ordre du slot. */
+    order?: number;
+    /**
+     * Rails gauche et bas : l'entrée reste affichée quelle que soit l'app active (option globale,
+     * ex. Annuaire, News), au lieu de n'apparaître que quand son app est montée. Sans effet sur
+     * le rail droit, déjà global.
+     */
+    global?: boolean;
+}
+/** Valide une `meta` d'extension : vrai si c'est une `ToolWindowMeta` exploitable. */
+export declare function isToolWindowMeta(meta: unknown): meta is ToolWindowMeta;
+//# sourceMappingURL=tool-window.d.ts.map

package/dist/tool-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-window.d.ts","sourceRoot":"","sources":["../src/tool-window.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC;;;;;;;;;;;;;;;;;;;GAmBG;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;CAClB;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,cAAc,CAStE"}

package/dist/tool-window.js

@@ -0,0 +1,37 @@
+/** @module @category Extension */ /**
+ * Fenêtres d'outils du shell (façon IntelliJ).
+ *
+ * Le shell porte deux rails fixes (gauche et droite) et trois zones redimensionnables
+ * (gauche, droite, bas). Chaque entrée d'un rail est une **extension** : sa `meta`
+ * (`ToolWindowMeta`) décrit le bouton du rail, son composant est le contenu de la zone
+ * associée, affiché quand le bouton est actif.
+ *
+ *   rail gauche, groupe haut  → slot `shell-rail-left-slot`   → zone gauche (sidebar de l'app)
+ *   rail gauche, groupe bas   → slot `shell-rail-bottom-slot` → zone basse (ex. terminal)
+ *   rail droit                → slot `shell-rail-right-slot`  → zone droite (options globales)
+ *
+ * Déclaration dans le `routes.json` d'une app :
+ * `{ "slot": "shell-rail-left-slot", "component": "projectPanel", "meta": ToolWindowMeta }`.
+ *
+ * Les rails gauche et bas n'affichent que les extensions de l'app active, sauf celles qui
+ * déclarent `meta.global: true` (toujours visibles, quelle que soit l'app active, comme le rail
+ * droit). Le rail droit est entièrement global (toutes les apps, y compris celles qui ne sont
+ * pas montées).
+ */ export const SHELL_RAIL_LEFT_SLOT = 'shell-rail-left-slot';
+export const SHELL_RAIL_BOTTOM_SLOT = 'shell-rail-bottom-slot';
+export const SHELL_RAIL_RIGHT_SLOT = 'shell-rail-right-slot';
+/** Slot de rail associé à chaque zone. */ export const TOOL_WINDOW_SLOTS = {
+    left: SHELL_RAIL_LEFT_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;
+    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;
+    return true;
+}

package/package.json

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