@creezio/shell-ui 0.22.0

package/README.md

@@ -0,0 +1,336 @@
+# @creezio/shell-ui
+
+## Rôle
+
+`@creezio/shell-ui` fournit la navigation native Creezio, les slots de navigation et le chrome CRM partage entre marques : primitives UI, sidebar, workspace a onglets, recherche globale, surfaces desktop/site externe, settings desktop, layouts et petites libs plateforme.
+
+Le package a deux couches :
+
+| Import | Contenu |
+|---|---|
+| `@creezio/shell-ui` | noyau bas niveau : registry nav, slots, brand tokens, helpers/lib plateforme |
+| `@creezio/shell-ui/ui` | React UI : primitives, AppShell, sidebar, workspace, search, desktop surfaces, settings |
+
+Point d'arbitrage important : historiquement, `shell-ui` etait "nav + slots" (H1/I7). Le package contient aujourd'hui aussi du chrome CRM extrait des apps (sidebar, workspace, search, settings, libs client). Selon `docs/archive/AUDIT-SHELL-UI-SCOPE.md`, ce n'est pas seulement un mauvais nom : c'est le SoT court terme pour le chrome shell CRM, tandis que onboarding, cockpit, splash et auth restent dans leurs packages dedies.
+
+## Périmètre (kit vs marque)
+
+### Dans le kit
+
+Noyau nav / slots :
+
+- `CoreNavItem`, `NavSlotId`, `NavSlot`
+- `CORE_NAV_ITEMS`, `createNavRegistry`, `mergeNav`
+- `createNavShellAdapter`
+- slots `brand-primary`, `brand-secondary`, `plugins`
+
+Chrome CRM / UI :
+
+- primitives shadcn-like (`Button`, `Input`, `Card`, `Dialog`, `Command`, etc.) ;
+- sidebar CRM (`Sidebar`, `CrmSidebar`) et host `configureSidebar` ;
+- workspace a onglets (`TabWorkspaceProvider`, `WorkspaceShell`, `WorkspaceRoot`, `WorkspaceTabBar`) ;
+- bandeau impersonation natif (`ImpersonationBanner`, rendu par `WorkspaceRoot` dès que `me.impersonating` — « Revenir à mon compte » via `stopImpersonate`) ;
+- recherche globale (`configureGlobalSearch`, `GlobalSearchProvider`) ;
+- surfaces desktop/site externe (`ExternalSiteSlot`, `DesktopBridge`, `SiteLink`) ;
+- settings desktop (`DesktopHermesSettings`, `DesktopN8nSettings`, `ApiKeysSettings`, etc.) ;
+- composants layout (`AppShell`, `PageChrome`, `EntityHeader`, `SectionViewShell`) ;
+- helpers plateforme (`resolvePublicOrigin`, `resolveCookieSecure`, scopes API, URL images, keep-alive, trails, telemetry best-effort).
+
+### Dans la marque
+
+- items nav metier avec ids `brand.*` et hrefs produit ;
+- ACL de visibilite (`canShowHref`) ;
+- icones et ordre des liens principaux/admin ;
+- recherche concrete (Meili, fallback DB, labels d'index) ;
+- contexte detail produit / page meta / breadcrumbs metier ;
+- providers metier (`PanierProvider`, RTI, GED, VASP, etc.) ;
+- routes Next (`/site/[id]`, pages settings/admin) ;
+- libelles utilisateur propres a la marque ;
+- choix de `desktopApiGlobal`, prefixe API key, nom produit ;
+- wiring client dans un fichier boot.
+
+### Hors scope a ne pas reabsorber
+
+| Domaine | Package SoT |
+|---|---|
+| Login, session UI | `@creezio/auth/ui` |
+| Setup / onboarding | `@creezio/onboarding/ui` |
+| Cockpit serveur | `@creezio/cockpit/ui` |
+| Splash desktop | `@creezio/electron-shell` |
+| Tasks AI panel | `@creezio/tasks/ui`, injecte via `configureAiActivityPanel` |
+| Auth store/session | `@creezio/auth` |
+
+Conclusion de l'audit : "NATIF shell" est une classification plateforme, pas une obligation de tout mettre dans un seul package. `shell-ui` garde nav + slots + chrome CRM mince ; onboarding/cockpit/splash/auth restent separes.
+
+## Installation / build
+
+```bash
+npm install
+npm run build -w @creezio/shell-ui
+npm run typecheck -w @creezio/shell-ui
+```
+
+Artefacts :
+
+- ESM : `dist/`
+- CJS Electron : `dist-cjs/`
+- UI source : `ui/`
+
+Dependances directes : `@creezio/brand-config`, `@creezio/shell`, `clsx`, `tailwind-merge`. Les dependances React/Radix/Next/Recharts/cmdk/lucide/sonner sont peer dependencies optionnelles car elles concernent `./ui`.
+
+## Configuration
+
+### Brand tokens
+
+```ts
+import { configureShellUiBrand } from "@creezio/shell-ui";
+
+configureShellUiBrand({
+  desktopApiGlobal: "mybrandDesktop",
+  publicHostSuffix: "mybrand.example",
+  titlebarDragClass: "mybrand-titlebar-drag",
+  titlebarNoDragClass: "mybrand-titlebar-no-drag",
+  apiKeyPrefix: "mybrand_live_",
+  productName: "Ma Marque",
+  aidAttr: "data-creezio-aid",
+});
+```
+
+`getShellDesktopApi()` lit `window[desktopApiGlobal]` de maniere souple et retourne `undefined` cote serveur.
+
+#### Page login (`login`)
+
+Le panneau brand de la page login split-screen (`LoginPage` de
+`@creezio/auth/ui`) se configure via la clé `login` — tout est optionnel,
+le défaut est neutre (gradient encre du thème kit, tuile initiale du nom
+produit, aucun texte marketing) :
+
+```ts
+configureShellUiBrand({
+  productName: "Ma Marque",
+  // …
+  login: {
+    tagline: "La tagline produit affichée dans le panneau.",
+    highlights: ["Argument un", "Argument deux", "Argument trois"],
+    logoUrl: "/logo.svg",                    // défaut : initiale du produit
+    panelBackground: "linear-gradient(165deg, #15112e, #221d4d)",
+    panelImageUrl: "/login-visual.jpg",      // optionnel, voilé sombre
+    panelSide: "right",                      // ou "left"
+  },
+});
+```
+
+En pratique la marque passe cet objet à `CreezioUiBoot` (prop `login`,
+`@creezio/os-ui/boot`) plutôt que d'appeler `configureShellUiBrand`
+elle-même. Les composants qui lisent la brand au render utilisent le hook
+`useShellUiBrand` (`@creezio/shell-ui/ui[/kit]`) : la marque est appliquée
+au render par `CreezioUiBoot` et le hook re-render si elle change.
+
+### Boot client marque typique
+
+Un seul fichier de wiring est attendu cote marque, par exemple `crm/src/lib/shell-ui/configure-shell-ui-client.ts`.
+
+```ts
+import {
+  configureDefaultNewTabHref,
+  configureGlobalSearch,
+  configureSidebar,
+  configureShellUiBrand,
+} from "@creezio/shell-ui/ui";
+
+configureShellUiBrand({
+  productName: "Ma Marque",
+  desktopApiGlobal: "mybrandDesktop",
+  apiKeyPrefix: "mybrand_live_",
+});
+
+configureSidebar({
+  getNavItems: () => brandNavItems,
+  getAdminItems: () => brandAdminItems,
+  canShowHref: (href, me) => canAccessHref(href, me),
+  resolveForcedActiveHref: (pathname, search) =>
+    resolveForcedActiveHref(pathname, search),
+});
+
+configureGlobalSearch({
+  placeholder: "Rechercher...",
+  indexLabels: { products: "Produits", clients: "Clients" },
+  search: (query, signal) => searchBrandIndexes(query, signal),
+});
+
+configureDefaultNewTabHref("/dashboard");
+```
+
+### Nav slots bas niveau
+
+La marque enregistre seulement ses items ; le kit ne connait pas les ids metier.
+
+```ts
+import { createNavShellAdapter } from "@creezio/shell-ui";
+
+const shell = createNavShellAdapter();
+shell.registerBrandNav(
+  [{ id: "brand.notes", label: "Notes", href: "/notes", group: "brand" }],
+  "brand-primary",
+);
+shell.registerBrandNav(
+  [{ id: "brand.plugin-x", label: "Plugin X", href: "/plugins/x", group: "plugin" }],
+  "plugins",
+);
+
+const model = shell.getRenderModel();
+```
+
+Slots disponibles :
+
+| Slot | Usage |
+|---|---|
+| `brand-primary` | navigation metier principale |
+| `brand-secondary` | liens secondaires metier |
+| `plugins` | items issus de plugins Product Hub ou equivalents |
+
+Le render model groupe les items par `core`, `brand`, `plugin`.
+
+## API publique (exports + exemples)
+
+### Package root `@creezio/shell-ui`
+
+Exports nav :
+
+- types `CoreNavItem`, `NavItem`, `NavSlot`, `NavSlotId`
+- `CORE_NAV_ITEMS`, `coreNavItems`
+- `createNavRegistry`, `mergeNav`
+- `createNavShellAdapter`
+
+Exports brand :
+
+- `configureShellUiBrand`, `getShellUiBrand`, `getShellDesktopApi`, `resetShellUiBrandForTests`, `subscribeShellUiBrand` (+ hook `useShellUiBrand` côté `./ui`)
+
+Exports helpers :
+
+- scopes API : `API_SCOPE_FULL`, `API_SCOPE_CRM_READ`, `API_SCOPE_CRM_WRITE`, `API_SCOPE_TASKS_RUN`, `normalizeApiScopes`, `parseApiKeyScopes`, `apiKeyAllowsMethod`, `apiKeyAllowsTasks`, `scopesFromPluginPermissions`
+- utils : `cn`, `formatDate`, `formatDateTime`, `formatMoney`, `parsePage`, `formatVariationPct`, `formatDeltaMoney`, `variationTone`
+- origin/cookie : `resolvePublicOrigin`, `resolveCookieSecure`, `isLoopbackHost`
+- ops : `trackServer`, `trackServerDebounced`, `reportServerIncident`
+- UI helpers purs : `haversineKm`, `thumbUrl`, `optimizeCoverUrl`, `buildCatalogSuspenseKey`, `normalizeTabDocumentUrl`, `isSameTabDocument`, `isSameTabOrigin`
+- desktop home/keepalive : `CRM_HOME_PATH`, `SERVER_COCKPIT_PATH`, `resolveDesktopHomePath`, `rankKeepAliveEvictionKeys`
+
+```ts
+import {
+  apiKeyAllowsMethod,
+  createNavShellAdapter,
+  resolveCookieSecure,
+} from "@creezio/shell-ui";
+
+const canWrite = apiKeyAllowsMethod("crm:write", "POST");
+const secure = resolveCookieSecure(headers, {
+  appPublicUrl: process.env.APP_PUBLIC_URL,
+});
+```
+
+### UI `@creezio/shell-ui/ui`
+
+Exports majeurs :
+
+- brand/hosts : `configureShellUiBrand`, `configureTabWorkspaceHost`, `configureGlobalSearchHost`, `configureAiActivityPanel`
+- primitives : `Button`, `Badge`, `Input`, `Card`, `Tabs`, `Dialog`, `Sheet`, `DropdownMenu`, `Command`, `Toaster`, `ChartContainer`, etc.
+- layout : `AppShell`, `PageChrome`, `PageToolbarProvider`, `SectionViewShell`, `EntityHeader`, `Sidebar`, `CrmSidebar`, `configureSidebar`
+- workspace : `TabWorkspaceProvider`, `WorkspaceShell`, `WorkspaceRoot`, `WorkspaceTabBar`, `KeepAliveOutlet`, `ImpersonationBanner`, `createTab`, `createExternalSiteTab`
+- search : `configureGlobalSearch`, `GlobalSearchProvider`, `GlobalSearchTrigger`, `SearchInput`, `search-history`
+- desktop : `ExternalSiteSlot`, `DesktopBridge`, `AuthWindowChrome`, `WindowChromeControls`, `SiteLink`
+- settings : `DesktopHermesSettings`, `DesktopN8nSettings`, `DesktopTunnel`, `ApiKeysSettings`, `AccountSettings`, etc.
+
+```tsx
+import {
+  GlobalSearchProvider,
+  Sidebar,
+  TabWorkspaceProvider,
+  WorkspaceRoot,
+} from "@creezio/shell-ui/ui";
+
+export function AppChrome({ children }) {
+  return (
+    <TabWorkspaceProvider>
+      <GlobalSearchProvider>
+        <WorkspaceRoot sidebar={<Sidebar />}>{children}</WorkspaceRoot>
+      </GlobalSearchProvider>
+    </TabWorkspaceProvider>
+  );
+}
+```
+
+### Sites externes : noms neutres vs alias legacy
+
+La terminologie kit est neutre :
+
+| SoT kit | Alias deprecie TF |
+|---|---|
+| `OpenExternalSiteOpts`, `openExternalSite`, `siteId` | `OpenSupplierSiteOpts`, `openSupplierSite`, `fournisseurId` |
+| `ExternalSiteSlot`, `ExternalSiteTabMeta`, `createExternalSiteTab` | `SupplierSiteSlot`, `SupplierTabMeta`, `createSupplierTab` |
+| `siteIdFromHref`, `isExternalSiteHref` | `fournisseurIdFromHref`, `isSupplierHref` |
+
+Ne pas ajouter de nouveau libelle utilisateur "fournisseur" dans le kit. Les alias restent supportes pour compat, mais les nouveaux appels doivent utiliser les noms `ExternalSite`. Regle de fond : [ADR-no-brand-domain-in-native-packages](../../docs/adr/ADR-no-brand-domain-in-native-packages.md) (gate `test-phase-p29`).
+
+## Flux / fonctionnement
+
+### Nav slots
+
+1. `CORE_NAV_ITEMS` fournit les items Creezio de base.
+2. La marque appelle `registerBrandNav(items, slot)`.
+3. `mergeNav` combine core + marque.
+4. `getRenderModel()` classe les items en groupes `core`, `brand`, `plugin`.
+5. L'UI React ou un rendu HTML minimal consomme le render model.
+
+### Chrome CRM
+
+1. La marque configure `ShellUiBrand`, `SidebarHost`, `GlobalSearchConfig` et defaults workspace.
+2. `Sidebar` lit `getSidebarHost()` et applique ACL/active href.
+3. `TabWorkspaceProvider` gere onglets, historique, keep-alive, liens externes et verrouillages.
+4. `WorkspaceShell` / `WorkspaceRoot` composent sidebar, tab bar, footbar, banners et children metier.
+5. `GlobalSearchProvider` appelle la fonction `search` injectee par la marque et ouvre les resultats via workspace.
+6. `ExternalSiteSlot` coordonne les etats de chargement webview/site externe avec le desktop.
+
+### Settings et libs client
+
+Les settings desktop sont dans `shell-ui/ui/settings` pour eviter les jumeaux TF/CV/Fidu a court terme. Si ce domaine grossit, une extraction future vers `@creezio/desktop-settings` est envisagee, mais elle n'est pas le SoT actuel.
+
+## Intégration marques
+
+Checklist :
+
+1. Appeler `configureShellUiBrand`.
+2. Configurer `configureSidebar` avec nav items, admin items, ACL, render plugins/tools si besoin.
+3. Configurer `configureGlobalSearch`.
+4. Configurer workspace : `configureDefaultNewTabHref`, `configureSidebarCollapsedKey`, `configureProductDetailCtx` si necessaire.
+5. Remplacer les composants locaux par les imports `@creezio/shell-ui/ui`.
+6. Garder un `WorkspaceRoot` local uniquement s'il compose des providers/banners metier minces.
+7. Migrer les surfaces "supplier" vers "external site" pour les nouveaux usages.
+8. Ne pas remettre onboarding/cockpit/auth/splash dans ce package.
+
+Doublons historiques côté marque (à ne pas recréer — remplacés par le kit) :
+
+- `src/components/layout/sidebar.tsx`
+- `src/components/workspace/tab-workspace-context.tsx`
+- `src/components/workspace/workspace-shell.tsx`
+- `src/components/global-search-provider.tsx`
+- `src/components/desktop/supplier-site-slot.tsx`
+
+## Dépendances @creezio/*
+
+| Dependance | Rôle |
+|---|---|
+| `@creezio/brand-config` | contexte marque et convergence config |
+| `@creezio/shell` | types desktop, IPC/bridge et shell runtime |
+
+Peer optional / interactions :
+
+- `@creezio/auth` : `SessionProvider`, `LoginForm`; shell-ui ne possede pas l'auth.
+- `@creezio/assistant` : surfaces AI optionnelles.
+- `@creezio/tasks` : panel AI tasks injecte via `configureAiActivityPanel`.
+- `@creezio/onboarding`, `@creezio/cockpit`, `@creezio/electron-shell` : packages dedies, hors shell-ui.
+
+## Voir aussi → AGENTS.md + docs/FILES.md
+
+- [`AGENTS.md`](./AGENTS.md) : consignes de modification pour agents.
+- [`docs/FILES.md`](./docs/FILES.md) : inventaire fichier par fichier.
+- [`../../docs/archive/AUDIT-SHELL-UI-SCOPE.md`](../../docs/archive/AUDIT-SHELL-UI-SCOPE.md) : arbitrage nav slots vs chrome CRM et frontieres avec onboarding/cockpit/splash/auth.

package/dist/adapters/nav-shell.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Adapter nav shell (Phase I7) — contrat de rendu UI-agnostique.
+ *
+ * Marque = `registerBrandNav` uniquement ; pas de hardcode panier/dispatch
+ * dans le kit. React/Next consomme `getRenderModel()` / `subscribe`.
+ */
+import { type NavRegistry } from "../registry.js";
+import type { CoreNavItem, NavSlotId } from "../types.js";
+export type NavRenderItem = CoreNavItem & {
+    source: "core" | "brand" | "plugin";
+    active?: boolean;
+};
+export type NavRenderGroup = {
+    id: "core" | "brand" | "plugin";
+    label: string;
+    items: NavRenderItem[];
+};
+export type NavRenderModel = {
+    items: NavRenderItem[];
+    groups: NavRenderGroup[];
+    activeHref: string | null;
+    generatedAt: string;
+};
+export type NavShellAdapter = {
+    /** Registre sous-jacent (tests / advanced). */
+    readonly registry: NavRegistry;
+    /** Seule API marque recommandée. */
+    registerBrandNav(items: CoreNavItem[], slot?: NavSlotId): void;
+    clearBrandNav(slot?: NavSlotId): void;
+    setActiveHref(href: string | null): void;
+    getMergedNav(): CoreNavItem[];
+    getRenderModel(): NavRenderModel;
+    subscribe(listener: () => void): () => void;
+    /** HTML minimal (preuve demobrand / SSR sans React). */
+    renderNavHtml(opts?: {
+        className?: string;
+    }): string;
+};
+export type CreateNavShellAdapterOptions = {
+    coreItems?: readonly CoreNavItem[];
+    registry?: NavRegistry;
+    activeHref?: string | null;
+};
+/**
+ * Crée l'adapter shell. Usage marque :
+ *
+ * ```ts
+ * const shell = createNavShellAdapter();
+ * shell.registerBrandNav([{ id: "brand.home", label: "Métier", href: "/brand" }]);
+ * const model = shell.getRenderModel(); // → UI React / HTML
+ * ```
+ */
+export declare function createNavShellAdapter(opts?: CreateNavShellAdapterOptions): NavShellAdapter;
+//# sourceMappingURL=nav-shell.d.ts.map

package/dist/adapters/nav-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-shell.d.ts","sourceRoot":"","sources":["../../src/adapters/nav-shell.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAA+B,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG;IACxC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,oCAAoC;IACpC,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/D,aAAa,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACtC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACzC,YAAY,IAAI,WAAW,EAAE,CAAC;IAC9B,cAAc,IAAI,cAAc,CAAC;IACjC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,wDAAwD;IACxD,aAAa,CAAC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CACtD,CAAC;AAcF,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,CAAC,EAAE,4BAA4B,GAClC,eAAe,CAwFjB"}

package/dist/adapters/nav-shell.js

@@ -0,0 +1,112 @@
+/**
+ * Adapter nav shell (Phase I7) — contrat de rendu UI-agnostique.
+ *
+ * Marque = `registerBrandNav` uniquement ; pas de hardcode panier/dispatch
+ * dans le kit. React/Next consomme `getRenderModel()` / `subscribe`.
+ */
+import { CORE_NAV_ITEMS } from "../core-nav.js";
+import { createNavRegistry, mergeNav } from "../registry.js";
+const GROUP_LABELS = {
+    core: "Creezio",
+    brand: "Métier",
+    plugin: "Plugins",
+};
+function sourceOf(item) {
+    if (item.group === "plugin")
+        return "plugin";
+    if (item.group === "brand" || item.id.startsWith("brand."))
+        return "brand";
+    return "core";
+}
+/**
+ * Crée l'adapter shell. Usage marque :
+ *
+ * ```ts
+ * const shell = createNavShellAdapter();
+ * shell.registerBrandNav([{ id: "brand.home", label: "Métier", href: "/brand" }]);
+ * const model = shell.getRenderModel(); // → UI React / HTML
+ * ```
+ */
+export function createNavShellAdapter(opts) {
+    const core = opts?.coreItems || CORE_NAV_ITEMS;
+    const registry = opts?.registry || createNavRegistry();
+    let activeHref = opts?.activeHref ?? null;
+    const listeners = new Set();
+    function notify() {
+        for (const l of listeners)
+            l();
+    }
+    const adapter = {
+        registry,
+        registerBrandNav(items, slot) {
+            registry.registerBrandNav(items, slot);
+            notify();
+        },
+        clearBrandNav(slot) {
+            registry.clearBrandNav(slot);
+            notify();
+        },
+        setActiveHref(href) {
+            activeHref = href;
+            notify();
+        },
+        getMergedNav() {
+            const brand = [
+                ...registry.getBrandNav("brand-primary"),
+                ...registry.getBrandNav("brand-secondary"),
+                ...registry.getBrandNav("plugins"),
+            ];
+            return mergeNav(core, brand);
+        },
+        getRenderModel() {
+            const items = adapter.getMergedNav().map((i) => ({
+                ...i,
+                source: sourceOf(i),
+                active: Boolean(activeHref && i.href === activeHref),
+            }));
+            const groups = ["core", "brand", "plugin"].map((id) => ({
+                id,
+                label: GROUP_LABELS[id],
+                items: items.filter((i) => i.source === id),
+            }));
+            return {
+                items,
+                groups,
+                activeHref,
+                generatedAt: new Date().toISOString(),
+            };
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        renderNavHtml(htmlOpts) {
+            const model = adapter.getRenderModel();
+            const cls = htmlOpts?.className || "creezio-nav";
+            const parts = [`<nav class="${cls}" data-creezio-shell-ui="i7">`];
+            for (const g of model.groups) {
+                if (!g.items.length)
+                    continue;
+                parts.push(`<div class="${cls}__group" data-group="${g.id}">`);
+                parts.push(`<div class="${cls}__group-label">${escapeHtml(g.label)}</div>`);
+                parts.push(`<ul>`);
+                for (const item of g.items) {
+                    const active = item.active ? ' aria-current="page"' : "";
+                    parts.push(`<li data-source="${item.source}"><a href="${escapeHtml(item.href)}"${active}>${escapeHtml(item.label)}</a></li>`);
+                }
+                parts.push(`</ul></div>`);
+            }
+            parts.push(`</nav>`);
+            return parts.join("");
+        },
+    };
+    return adapter;
+}
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+//# sourceMappingURL=nav-shell.js.map

package/dist/adapters/nav-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-shell.js","sourceRoot":"","sources":["../../src/adapters/nav-shell.ts"],"names":[],"mappings":"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"}

package/dist/brand.d.ts

@@ -0,0 +1,64 @@
+/**
+ * O9 — tokens marque pour shell-ui (desktop API, hosts, titlebar).
+ */
+/**
+ * Panneau brand de la page login split-screen (@creezio/auth LoginPage).
+ * Tout est optionnel : une marque sans config obtient le défaut neutre
+ * (gradient encre du thème kit, tuile initiale, sans tagline ni highlights).
+ */
+export type ShellUiLoginBrand = {
+    /** Tagline sous le nom produit dans le panneau (défaut : aucune). */
+    tagline?: string;
+    /** Points marketing en liste à puces (défaut : aucun — 3 ou 4 recommandés). */
+    highlights?: string[];
+    /** URL d'un logo image (défaut : tuile avec l'initiale du produit). */
+    logoUrl?: string;
+    /**
+     * Fond du panneau — valeur CSS `background` complète (couleur ou gradient).
+     * Défaut : gradient encre neutre du thème kit.
+     */
+    panelBackground?: string;
+    /** Image de fond du panneau (sous un voile sombre, par-dessus le fond). */
+    panelImageUrl?: string;
+    /** Côté du panneau sur desktop (défaut "right"). */
+    panelSide?: "left" | "right";
+    /**
+     * Lien d'action secondaire sous le formulaire de connexion (ex.
+     * inscription POS de la marque : { label: "Créer un compte", href:
+     * "/inscription" }). Absent = aucun lien affiché — jamais de défaut kit.
+     */
+    secondaryLink?: {
+        label: string;
+        href: string;
+    };
+};
+export type ShellUiBrand = {
+    /** Ex. creezioDesktop / certivanDesktop / fiduDesktop */
+    desktopApiGlobal: string;
+    /** Suffixe hôte public (ex. app.example.com / tenant.creez.io) */
+    publicHostSuffix: string;
+    /** Classe CSS titlebar no-drag */
+    titlebarDragClass: string;
+    titlebarNoDragClass: string;
+    /** Préfixe clés API live (ex. product_live_) */
+    apiKeyPrefix: string;
+    /** Nom produit UI — injecté par la marque */
+    productName: string;
+    /** Attribut data-* analytics clics (défaut data-creezio-aid). */
+    aidAttr?: string;
+    /** Config page login split-screen (défauts neutres si absente). */
+    login?: ShellUiLoginBrand;
+};
+export declare function configureShellUiBrand(next: Partial<ShellUiBrand>): void;
+export declare function getShellUiBrand(): ShellUiBrand;
+/**
+ * Abonnement aux changements de brand — la marque est appliquée par
+ * CreezioUiBoot en useEffect (après le 1er render) : les composants qui
+ * lisent la brand au render (page login…) doivent passer par le hook
+ * useShellUiBrand (@creezio/shell-ui/ui/kit) pour re-render.
+ */
+export declare function subscribeShellUiBrand(listener: () => void): () => void;
+export declare function resetShellUiBrandForTests(): void;
+/** Accès typé soft à window[desktopApiGlobal]. */
+export declare function getShellDesktopApi(): any;
+//# sourceMappingURL=brand.d.ts.map

package/dist/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AAoBF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAcvE;AAED,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKtE;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,IAAI,GAAG,CAIxC"}

package/dist/brand.js

@@ -0,0 +1,59 @@
+/**
+ * O9 — tokens marque pour shell-ui (desktop API, hosts, titlebar).
+ */
+const DEFAULT = {
+    desktopApiGlobal: "creezioDesktop",
+    publicHostSuffix: "creez.io",
+    titlebarDragClass: "creezio-titlebar-drag",
+    titlebarNoDragClass: "creezio-titlebar-no-drag",
+    apiKeyPrefix: "creezio_live_",
+    productName: "Creezio",
+    aidAttr: "data-creezio-aid",
+};
+let brand = { ...DEFAULT };
+const listeners = new Set();
+function notifyBrandChanged() {
+    for (const listener of listeners)
+        listener();
+}
+export function configureShellUiBrand(next) {
+    const merged = { ...brand, ...next };
+    // No-op si aucune clé ne change — CreezioUiBoot appelle au render (marque
+    // correcte dès le 1er paint, zéro flash du défaut) : la détection évite
+    // les boucles de re-render des abonnés useSyncExternalStore. `login` est
+    // comparé en profondeur (objet littéral → nouvelle identité à chaque render).
+    const changed = Object.keys(merged).some((k) => k === "login"
+        ? JSON.stringify(merged.login ?? null) !== JSON.stringify(brand.login ?? null)
+        : merged[k] !== brand[k]);
+    if (!changed)
+        return;
+    brand = merged;
+    notifyBrandChanged();
+}
+export function getShellUiBrand() {
+    return brand;
+}
+/**
+ * Abonnement aux changements de brand — la marque est appliquée par
+ * CreezioUiBoot en useEffect (après le 1er render) : les composants qui
+ * lisent la brand au render (page login…) doivent passer par le hook
+ * useShellUiBrand (@creezio/shell-ui/ui/kit) pour re-render.
+ */
+export function subscribeShellUiBrand(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+export function resetShellUiBrandForTests() {
+    brand = { ...DEFAULT };
+    notifyBrandChanged();
+}
+/** Accès typé soft à window[desktopApiGlobal]. */
+export function getShellDesktopApi() {
+    if (typeof window === "undefined")
+        return undefined;
+    const key = getShellUiBrand().desktopApiGlobal;
+    return window[key];
+}
+//# sourceMappingURL=brand.js.map

package/dist/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.js","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiDH,MAAM,OAAO,GAAiB;IAC5B,gBAAgB,EAAE,gBAAgB;IAClC,gBAAgB,EAAE,UAAU;IAC5B,iBAAiB,EAAE,uBAAuB;IAC1C,mBAAmB,EAAE,0BAA0B;IAC/C,YAAY,EAAE,eAAe;IAC7B,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,kBAAkB;CAC5B,CAAC;AAEF,IAAI,KAAK,GAAiB,EAAE,GAAG,OAAO,EAAE,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;AAExC,SAAS,kBAAkB;IACzB,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAA2B;IAC/D,MAAM,MAAM,GAAiB,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;IACnD,0EAA0E;IAC1E,wEAAwE;IACxE,yEAAyE;IACzE,8EAA8E;IAC9E,MAAM,OAAO,GAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACzE,CAAC,KAAK,OAAO;QACX,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC;QAC9E,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAC3B,CAAC;IACF,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,KAAK,GAAG,MAAM,CAAC;IACf,kBAAkB,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAoB;IACxD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,KAAK,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IACvB,kBAAkB,EAAE,CAAC;AACvB,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,kBAAkB;IAChC,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACpD,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC,gBAAgB,CAAC;IAC/C,OAAQ,MAAc,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC"}

package/dist/core-nav.d.ts

@@ -0,0 +1,17 @@
+import type { CoreNavItem } from "./types.js";
+/**
+ * Entrées nav natives Creezio — aucune entrée métier marque
+ * (panier, dispatch, GED, RTI…).
+ *
+ * Liste historique (home / assistant / setup / login / about…) consommée
+ * par `createNavShellAdapter` — **pas** la sidebar CRM. La sidebar OS
+ * primaire (taches, mails, granola, grokbot…) vit dans le catalogue
+ * `defaultOsCatalogEntries()` / `registerOsNavEntry`
+ * (`nav-catalog.ts`, plan `docs/plans/PLAN-NAV-CATALOG.md`). Ne pas
+ * recopier granola/grokbot ici pour « aligner » : Phase D dérivera
+ * `CORE_NAV_ITEMS` du catalogue, ou documentera l'écart à vie.
+ */
+export declare const CORE_NAV_ITEMS: readonly CoreNavItem[];
+/** Alias factory / demobrand. */
+export declare const coreNavItems: CoreNavItem[];
+//# sourceMappingURL=core-nav.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-nav.d.ts","sourceRoot":"","sources":["../src/core-nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EAsBvC,CAAC;AAEX,iCAAiC;AACjC,eAAO,MAAM,YAAY,EAAE,WAAW,EAEnC,CAAC"}