@hgdc/ui 0.72.2 → 0.74.0

package/README.md

@@ -66,7 +66,7 @@ Le menu « Produits » et la palette (`badge` d'une commande) montrent la pastil
 
 ### D'un produit à l'autre sous `app.hgdc.ch` (ADR 0020)
 
-Entre deux produits servis sous la même origine, la coque fait comme une seule app : transition de vue entre documents, lien relatif marqué `data-hgdc-prerender` et prérendu au survol (`PRODUCT_SPECULATION_RULES` de `@hgdc/ui/product-switch`). Le H couvre le contenu 100 ms après le clic (`PRODUCT_LEAVE_DELAY_MS`) : jamais pour une page prérendue. Chrome et Edge : tout ; Safari 18.2+ : la transition, sans prérendu ; Firefox : navigation ordinaire.
+Entre deux produits servis sous la même origine, la coque fait comme une seule app : transition de vue entre documents, lien relatif marqué `data-hgdc-prerender` et prérendu au survol (`PRODUCT_SPECULATION_RULES` de `@hgdc/ui/product-switch`). Le H couvre le contenu 100 ms après le clic (`PRODUCT_LEAVE_DELAY_MS`) : jamais pour une page prérendue. Chrome et Edge : tout ; Safari 18.2+ : la transition, sans prérendu ; Firefox : navigation ordinaire. La barre ouvre aussi en arrière-plan la session des autres modules affichés (ADR 0026, `startSessionOpening`) : un cadre caché à la fois, au plus une fois par jour et par module, jamais après une déconnexion ni sans `localStorage`. Le premier clic vers un module trouve sa session.
 
 Pendant le passage (0.39) :
 

package/dist/account-menu.js

@@ -8,6 +8,7 @@ import SecurityLockIcon from "@hugeicons/core-free-icons/SecurityLockIcon";
 import Tick02Icon from "@hugeicons/core-free-icons/Tick02Icon";
 import UserIcon from "@hugeicons/core-free-icons/UserIcon";
 import { HugeiconsIcon } from "@hugeicons/react";
+import { pauseSessionOpening } from "./product-switch.js";
 import { Menu as MenuPrimitive } from "@base-ui/react/menu";
 import { Avatar, AvatarFallback, AvatarImage } from "./avatar.js";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, } from "./dropdown-menu.js";
@@ -47,6 +48,8 @@ export function AccountMenu({ user, onProfile, onSecurity, onSignOut, products:
     return (_jsxs(DropdownMenu, { children: [_jsxs(DropdownMenuTrigger, { render: variant === "row" ? (_jsx("button", { type: "button", "aria-label": `Compte de ${user.name}`, className: "flex w-full min-w-0 items-center gap-2.5 rounded-xl p-1.5 text-left outline-none transition-colors duration-(--duration-fast) ease-out hover:bg-muted focus-visible:ring-2 focus-visible:ring-ring/50 aria-expanded:bg-muted lg:hover:bg-shell-hover lg:aria-expanded:bg-shell-hover lg:rail:justify-center" })) : (_jsx("button", { type: "button", "aria-label": `Compte de ${user.name}`, className: "touch-target grid size-9 place-items-center rounded-full outline-none focus-visible:ring-2 focus-visible:ring-ring/50" })), children: [_jsx(AccountAvatar, { user: user }), variant === "row" ? (_jsxs("span", { className: "min-w-0 flex-1 lg:rail:hidden", children: [_jsx("span", { className: "block truncate text-sm font-medium", children: user.name }), _jsx("span", { className: "block truncate text-xs text-muted-foreground lg:text-shell-muted", children: user.email })] })) : null] }), _jsxs(DropdownMenuContent, { align: variant === "row" ? "start" : "end", side: variant === "row" ? "top" : "bottom", className: "w-72", children: [_jsx(DropdownMenuGroup, { children: _jsxs(DropdownMenuLabel, { className: "flex items-center gap-2.5 py-2", children: [_jsx(AccountAvatar, { user: user }), _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-sm font-medium text-foreground", children: user.name }), _jsx("span", { className: "block truncate", children: user.email })] })] }) }), _jsx(DropdownMenuSeparator, {}), onProfile ? (_jsxs(DropdownMenuItem, { onClick: onProfile, children: [_jsx(HugeiconsIcon, { icon: UserIcon, "aria-hidden": true }), "Profil"] })) : null, onSecurity ? (_jsxs(DropdownMenuItem, { onClick: onSecurity, children: [_jsx(HugeiconsIcon, { icon: SecurityLockIcon, "aria-hidden": true }), "S\u00E9curit\u00E9"] })) : null, _jsx(ThemeSwitch, {}), children ? (_jsxs(_Fragment, { children: [_jsx(DropdownMenuSeparator, {}), children] })) : null, _jsx(AccountMenuLinks, { links: menuLinks }), products.length ? (_jsxs(_Fragment, { children: [_jsx(DropdownMenuSeparator, {}), _jsxs(DropdownMenuGroup, { children: [_jsx(DropdownMenuLabel, { children: "Produits" }), products.map((product) => product.current ? (_jsxs(DropdownMenuItem, { disabled: true, className: "data-disabled:opacity-100", children: [_jsx(ProductMenuIcon, { product: product }), _jsx("span", { className: "flex-1", children: product.name }), _jsx(HugeiconsIcon, { icon: Tick02Icon, "aria-label": "Produit ouvert" })] }, product.name)) : (_jsxs(MenuPrimitive.LinkItem, { href: product.href, onClick: leaveOnClick, className: MENU_LINK_ITEM, children: [_jsx(ProductMenuIcon, { product: product }), _jsx("span", { className: "flex-1", children: product.name }), product.hint ? (_jsx("span", { className: "text-xs font-normal text-muted-foreground", children: product.hint })) : null] }, product.name)))] })] })) : null, _jsx(DropdownMenuSeparator, {}), _jsxs(DropdownMenuItem, { onClick: () => {
                             // La marque de l'organisation retenue pour la coque ne survit pas à la session.
                             forgetShellOrganization();
+                            // Aucun module ne se rouvre seul après une déconnexion (ADR 0026).
+                            pauseSessionOpening();
                             onSignOut();
                         }, children: [_jsx(HugeiconsIcon, { icon: Logout01Icon, "aria-hidden": true }), "Se d\u00E9connecter"] })] })] }));
 }

package/dist/csp.d.ts

@@ -0,0 +1,38 @@
+/** Socle : jamais encadrable (clickjacking), ni `<base>`, ni plugin, formulaires vers soi. */
+export declare const BASE_POLICY = "frame-ancestors 'none'; base-uri 'self'; object-src 'none'; form-action 'self'";
+/**
+ * Empreintes des scripts en ligne que ce paquet rend sans nonce. Aujourd'hui : les règles de
+ * préchargement de la barre (`PRODUCT_SPECULATION_RULES`), que Chrome bloque malgré
+ * `'inline-speculation-rules'`. `csp.test.ts` les recalcule : changer un script sans son empreinte échoue.
+ */
+export declare const KIT_INLINE_SCRIPT_HASHES: readonly string[];
+/** Scripts en ligne couverts par `KIT_INLINE_SCRIPT_HASHES`, pour le test qui recalcule les empreintes. */
+export declare const KIT_INLINE_SCRIPTS: readonly string[];
+/**
+ * Origines que les composants de ce paquet joignent depuis le navigateur : bandeau d'état
+ * (`ServiceStatus`), formulaire « Demander un accès » (`AccessRequest`), réglage de la barre.
+ */
+export declare const FAMILY_CONNECT_SOURCES: readonly string[];
+/**
+ * Origines joignables par `fetch` ou WebSocket, tirées d'adresses complètes (backend, collecteur
+ * d'erreurs) : l'origine seule, plus sa version WebSocket. Une adresse vide ou illisible est ignorée :
+ * elle ne doit jamais ouvrir la politique.
+ */
+export declare function connectSources(urls: ReadonlyArray<string | undefined>): string[];
+/** Nonce d'une requête : 16 octets aléatoires en base64. */
+export declare function newNonce(): string;
+export type DocumentPolicyOptions = {
+    /** Nonce de la requête (`newNonce`), posé aussi sur les scripts en ligne du rendu serveur. */
+    nonce: string;
+    /** Origines que le navigateur joint, en plus de la sienne et de `FAMILY_CONNECT_SOURCES`. */
+    connect: ReadonlyArray<string>;
+    /** Empreintes de scripts en ligne propres à l'application, en plus de celles du paquet. */
+    scriptHashes?: ReadonlyArray<string>;
+};
+/**
+ * Politique des documents : le socle, `script-src` (fichiers de l'application, scripts en ligne portant
+ * le nonce, ceux du paquet par leur empreinte) et `connect-src`. Ni `'unsafe-inline'` ni `'unsafe-eval'`.
+ * Images, styles et polices ne sont pas restreints. Une valeur mal formée lève : elle ne doit jamais
+ * pouvoir ajouter une directive.
+ */
+export declare function documentPolicy({ nonce, connect, scriptHashes }: DocumentPolicyOptions): string;

package/dist/csp.js

@@ -0,0 +1,83 @@
+/**
+ * Politique de sécurité du contenu (CSP) des documents d'une console, commune à tous les modules.
+ *
+ * Les modules partagent une même origine : un script injecté dans l'un agit dans tous les autres. La
+ * politique doit donc être la même partout, d'où ce module. Aucune dépendance : le middleware qui
+ * tire le nonce et pose l'en-tête reste dans chaque application (il dépend de son serveur).
+ */
+import { PRODUCT_SPECULATION_RULES } from "./product-switch.js";
+/** Socle : jamais encadrable (clickjacking), ni `<base>`, ni plugin, formulaires vers soi. */
+export const BASE_POLICY = "frame-ancestors 'none'; base-uri 'self'; object-src 'none'; form-action 'self'";
+/**
+ * Empreintes des scripts en ligne que ce paquet rend sans nonce. Aujourd'hui : les règles de
+ * préchargement de la barre (`PRODUCT_SPECULATION_RULES`), que Chrome bloque malgré
+ * `'inline-speculation-rules'`. `csp.test.ts` les recalcule : changer un script sans son empreinte échoue.
+ */
+export const KIT_INLINE_SCRIPT_HASHES = ["sha256-a67/vPhviRex9BGXSAteyrRDrGJEKbTE/4tBKxtGgjQ="];
+/** Scripts en ligne couverts par `KIT_INLINE_SCRIPT_HASHES`, pour le test qui recalcule les empreintes. */
+export const KIT_INLINE_SCRIPTS = [PRODUCT_SPECULATION_RULES];
+/**
+ * Origines que les composants de ce paquet joignent depuis le navigateur : bandeau d'état
+ * (`ServiceStatus`), formulaire « Demander un accès » (`AccessRequest`), réglage de la barre.
+ */
+export const FAMILY_CONNECT_SOURCES = [
+    "https://status.hgdc.ch",
+    "https://api.mail.hgdc.ch",
+    "https://account.hgdc.ch",
+];
+/**
+ * Origines joignables par `fetch` ou WebSocket, tirées d'adresses complètes (backend, collecteur
+ * d'erreurs) : l'origine seule, plus sa version WebSocket. Une adresse vide ou illisible est ignorée :
+ * elle ne doit jamais ouvrir la politique.
+ */
+export function connectSources(urls) {
+    const sources = new Set();
+    for (const raw of urls) {
+        if (!raw)
+            continue;
+        let url;
+        try {
+            url = new URL(raw);
+        }
+        catch {
+            continue;
+        }
+        if (url.protocol !== "https:" && url.protocol !== "http:")
+            continue;
+        sources.add(url.origin);
+        sources.add(`${url.protocol === "https:" ? "wss:" : "ws:"}//${url.host}`);
+    }
+    return [...sources];
+}
+/** Nonce d'une requête : 16 octets aléatoires en base64. */
+export function newNonce() {
+    const bytes = crypto.getRandomValues(new Uint8Array(16));
+    return btoa(String.fromCharCode(...bytes));
+}
+const NONCE = /^[A-Za-z0-9+/_-]{16,}={0,2}$/;
+const HASH = /^sha(256|384|512)-[A-Za-z0-9+/]+={0,2}$/;
+/** Une source de `connect-src` : une origine `https:`, `wss:`, `http:` ou `ws:`, sans chemin ni séparateur. */
+const SOURCE = /^(https|wss|http|ws):\/\/[A-Za-z0-9.*:[\]-]+$/;
+/**
+ * Politique des documents : le socle, `script-src` (fichiers de l'application, scripts en ligne portant
+ * le nonce, ceux du paquet par leur empreinte) et `connect-src`. Ni `'unsafe-inline'` ni `'unsafe-eval'`.
+ * Images, styles et polices ne sont pas restreints. Une valeur mal formée lève : elle ne doit jamais
+ * pouvoir ajouter une directive.
+ */
+export function documentPolicy({ nonce, connect, scriptHashes = [] }) {
+    if (!NONCE.test(nonce))
+        throw new Error("nonce CSP invalide");
+    const hashes = [...KIT_INLINE_SCRIPT_HASHES, ...scriptHashes];
+    for (const hash of hashes)
+        if (!HASH.test(hash))
+            throw new Error(`empreinte CSP invalide : ${hash}`);
+    const sources = [...new Set([...connect, ...FAMILY_CONNECT_SOURCES])];
+    for (const source of sources)
+        if (!SOURCE.test(source))
+            throw new Error(`source CSP invalide : ${source}`);
+    return [
+        BASE_POLICY,
+        `script-src ${["'self'", `'nonce-${nonce}'`, ...hashes.map((hash) => `'${hash}'`), "'inline-speculation-rules'"].join(" ")}`,
+        `connect-src ${["'self'", ...sources].join(" ")}`,
+    ].join("; ");
+}

package/dist/module-bar.d.ts

@@ -1,8 +1,14 @@
 import { type ReactNode } from "react";
 import type { FamilyProduct } from "./family-svg.ts";
 import { type ModuleWord } from "./modules.ts";
+import { type ShellProductEntry } from "./products.ts";
 /** Ce que montre le milieu de la barre : les onglets du module ouvert, la liste des modules, ou son réglage. */
 export type ShellNavLevel = "tabs" | "modules" | "edit";
+/**
+ * Bases des modules affichés (`shown`), autres que le module ouvert et servis sous la même origine :
+ * ceux dont la session s'ouvre en arrière-plan (ADR 0026). Manager n'en fait pas partie.
+ */
+export declare function sessionBases(entries: ReadonlyArray<ShellProductEntry>, shown: ReadonlyArray<ModuleWord>, current: FamilyProduct): Array<string>;
 /**
  * Le milieu de la barre de Basalte : Manager, un trait, puis l'un des trois niveaux. Dans un module,
  * ses onglets (`nav`) sous « Retour aux modules » ; un clic y affiche la liste sans rien recharger ;

package/dist/module-bar.js

@@ -14,7 +14,7 @@ import { saveModuleBar, useModuleBar } from "./module-bar-store.js";
 import { pushModuleBar } from "./product-bar.js";
 import { hiddenModules, moduleByWord, moveModule, shownModules } from "./modules.js";
 import { ProductBadge } from "./product-badge.js";
-import { PRODUCT_PRERENDER_ATTRIBUTE } from "./product-switch.js";
+import { PRODUCT_PRERENDER_ATTRIBUTE, productEntryBase, useSessionOpening } from "./product-switch.js";
 import { shellProductEntries } from "./products.js";
 import { familyProductName } from "./product-name.js";
 import { lastOrganization } from "./shell-memory.js";
@@ -46,6 +46,19 @@ function ShellEntryLink({ entry, icon, onOpenCurrent, }) {
     };
     return (_jsx("li", { children: _jsxs(Tooltip, { disabled: !rail, children: [_jsxs(TooltipTrigger, { render: _jsx("a", { href: entry.href, onClick: onClick, ...(entry.sameOrigin ? { [PRODUCT_PRERENDER_ATTRIBUTE]: "" } : {}), "aria-current": entry.current ? "page" : undefined, className: SIDEBAR_ITEM }), children: [icon ? (_jsx(HugeiconsIcon, { icon: icon, strokeWidth: 1.8, "aria-hidden": true, className: "size-5 shrink-0 lg:size-[1.125rem]" })) : (_jsx(ProductBadge, { product: entry.badge, className: "size-5 shrink-0 lg:size-[1.125rem]" })), _jsx("span", { className: "min-w-0 flex-1 truncate lg:rail:sr-only", children: entry.name }), entry.hint ? _jsx("span", { className: "text-xs font-normal lg:rail:hidden", children: entry.hint }) : null] }), _jsx(TooltipContent, { side: "right", children: entry.name })] }) }));
 }
+/**
+ * Bases des modules affichés (`shown`), autres que le module ouvert et servis sous la même origine :
+ * ceux dont la session s'ouvre en arrière-plan (ADR 0026). Manager n'en fait pas partie.
+ */
+export function sessionBases(entries, shown, current) {
+    return shown.flatMap((word) => {
+        const entry = entries.find((item) => item.badge === word);
+        if (!entry || entry.badge === current || !entry.sameOrigin)
+            return [];
+        const base = productEntryBase(entry.href);
+        return base ? [base] : [];
+    });
+}
 function ModuleList({ entries, order, onOpenCurrent, onCustomize, }) {
     const shown = order.flatMap((word) => {
         const entry = entries.find((item) => item.badge === word);
@@ -91,7 +104,11 @@ export function ShellNavigation({ product, nav, accountHref, level, onLevelChang
     const organization = useLastOrganization();
     const order = useModuleBar();
     const { products, account } = shellProductEntries({ current: product, accountHref, pageOrigin, organization });
-    return (_jsxs("div", { "data-slot": "shell-navigation", className: "flex min-h-0 flex-1 flex-col", children: [_jsxs("div", { "data-slot": "shell-manager", className: "shrink-0 px-3 pt-1", children: [_jsx("ul", { children: _jsx(ShellEntryLink, { entry: account, icon: UserGroupIcon }) }), _jsx("div", { "aria-hidden": true, className: "mx-2 mt-2 h-px bg-foreground/8" })] }), level === "modules" ? (_jsx(ModuleList, { entries: products, order: shownModules(order, product).filter((word) => !projectModules || word === product || projectModules.includes(word)), onOpenCurrent: () => onLevelChange("tabs"), onCustomize: () => onLevelChange("edit") })) : level === "edit" ? (_jsx(ModuleBarEditor, { order: order, onSave: (next) => {
+    const shown = shownModules(order, product).filter((word) => !projectModules || word === product || projectModules.includes(word));
+    // Sessions des autres modules affichés, ouvertes en arrière-plan : le premier clic n'attend pas
+    // la connexion chez ID (ADR 0026).
+    useSessionOpening(sessionBases(products, shown, product));
+    return (_jsxs("div", { "data-slot": "shell-navigation", className: "flex min-h-0 flex-1 flex-col", children: [_jsxs("div", { "data-slot": "shell-manager", className: "shrink-0 px-3 pt-1", children: [_jsx("ul", { children: _jsx(ShellEntryLink, { entry: account, icon: UserGroupIcon }) }), _jsx("div", { "aria-hidden": true, className: "mx-2 mt-2 h-px bg-foreground/8" })] }), level === "modules" ? (_jsx(ModuleList, { entries: products, order: shown, onOpenCurrent: () => onLevelChange("tabs"), onCustomize: () => onLevelChange("edit") })) : level === "edit" ? (_jsx(ModuleBarEditor, { order: order, onSave: (next) => {
                     saveModuleBar(next);
                     void pushModuleBar(next);
                     onLevelChange("modules");

package/dist/product-switch.d.ts

@@ -13,6 +13,22 @@ export declare const BACKGROUND_REFRESH_TIMEOUT_MS = 20000;
 export declare const BACKGROUND_REFRESH_INTERVAL_MS: number;
 /** Heure de la dernière relecture d'un produit, en `localStorage` : `hgdc-org-sync:<base>` (`/` à la racine). */
 export declare const ORG_SYNC_LAST_KEY_PREFIX = "hgdc-org-sync:";
+/** Cadre caché qui ouvre la session d'un autre produit, seulement si elle manque (ADR 0026). */
+export declare const SESSION_OPEN_PATH = "/auth/hgdc?frame=open";
+/** Une ouverture au plus par produit pendant ce délai : une session vit 7 jours (`@hgdc/auth`). */
+export declare const SESSION_OPEN_INTERVAL_MS: number;
+/** Attente après l'affichage de la page avant la première ouverture : la page passe d'abord. */
+export declare const SESSION_OPEN_DELAY_MS = 3000;
+/** Heure de la dernière ouverture d'un produit, en `localStorage` : `hgdc-session-open:<base>`. */
+export declare const SESSION_OPEN_KEY_PREFIX = "hgdc-session-open:";
+/**
+ * Posée à la déconnexion d'un module (`AccountMenu`), levée à la prochaine connexion par clic
+ * (`HgdcSignInButton` de `@hgdc/auth`) : tant qu'elle est là, rien ne s'ouvre en arrière-plan. Une
+ * déconnexion (changer de compte, poste partagé) n'est jamais défaite sans la personne.
+ */
+export declare const SESSION_OPEN_PAUSED_KEY = "hgdc-session-open:paused";
+/** À la déconnexion d'un module : plus d'ouverture en arrière-plan jusqu'à la prochaine connexion. */
+export declare function pauseSessionOpening(win?: Window | null): void;
 /** Marque d'un lien de la barre vers un autre produit servi sous la même origine : prérendu au survol. */
 export declare const PRODUCT_PRERENDER_ATTRIBUTE = "data-hgdc-prerender";
 /**
@@ -48,6 +64,20 @@ export declare function takeOrgSyncCookie(doc?: Document): boolean;
  * clic ne relit rien.
  */
 export declare function startBackgroundRefresh(doc?: Document): HTMLIFrameElement | null;
+/**
+ * La base d'un produit (`/mail`) depuis le lien relatif de sa barre (`/mail/auth/hgdc?…`), ou
+ * `null` pour un lien absolu (autre origine) ou une base illisible.
+ */
+export declare function productEntryBase(href: string): string | null;
+/**
+ * Ouvre en arrière-plan la session des autres modules de la barre (ADR 0026) : un cadre caché à la
+ * fois vers `<base>/auth/hgdc?frame=open`, au plus une fois par jour et par module. Session déjà
+ * ouverte : réponse vide sans appel à ID. Sinon, la connexion HGDC se fait dans le cadre ; si ID
+ * demande quelque chose (session expirée, consentement), il refuse d'être affiché dans un cadre et
+ * rien ne se passe : le clic fera la connexion habituelle. Pas sur une page prérendue, ni quand
+ * l'économie de données est demandée. Rend une fonction qui arrête la file.
+ */
+export declare function startSessionOpening(bases: ReadonlyArray<string>, doc?: Document): () => void;
 /**
  * Relecture en arrière-plan si l'entrée l'a demandé. Montée à la racine du document
  * (`FamilyLoaderRoot`), pour toutes les pages, y compris celles hors de la coque : la page « il te
@@ -62,3 +92,9 @@ export declare function useBackgroundOrganizationRefresh(): void;
  * `script-src` doit y autoriser `'inline-speculation-rules'` (README).
  */
 export declare function useProductSwitch(enabled?: boolean): void;
+/**
+ * Dans la barre de Basalte (`ShellNavigation`) : ouvre la session des modules affichés servis sous
+ * la même origine, `SESSION_OPEN_DELAY_MS` après l'affichage (ADR 0026). `bases` : clé stable
+ * (les bases jointes), pour ne pas relancer la file à chaque rendu.
+ */
+export declare function useSessionOpening(bases: ReadonlyArray<string>): void;

package/dist/product-switch.js

@@ -24,6 +24,29 @@ export const BACKGROUND_REFRESH_TIMEOUT_MS = 20_000;
 export const BACKGROUND_REFRESH_INTERVAL_MS = 10 * 60_000;
 /** Heure de la dernière relecture d'un produit, en `localStorage` : `hgdc-org-sync:<base>` (`/` à la racine). */
 export const ORG_SYNC_LAST_KEY_PREFIX = "hgdc-org-sync:";
+/** Cadre caché qui ouvre la session d'un autre produit, seulement si elle manque (ADR 0026). */
+export const SESSION_OPEN_PATH = "/auth/hgdc?frame=open";
+/** Une ouverture au plus par produit pendant ce délai : une session vit 7 jours (`@hgdc/auth`). */
+export const SESSION_OPEN_INTERVAL_MS = 24 * 60 * 60_000;
+/** Attente après l'affichage de la page avant la première ouverture : la page passe d'abord. */
+export const SESSION_OPEN_DELAY_MS = 3000;
+/** Heure de la dernière ouverture d'un produit, en `localStorage` : `hgdc-session-open:<base>`. */
+export const SESSION_OPEN_KEY_PREFIX = "hgdc-session-open:";
+/**
+ * Posée à la déconnexion d'un module (`AccountMenu`), levée à la prochaine connexion par clic
+ * (`HgdcSignInButton` de `@hgdc/auth`) : tant qu'elle est là, rien ne s'ouvre en arrière-plan. Une
+ * déconnexion (changer de compte, poste partagé) n'est jamais défaite sans la personne.
+ */
+export const SESSION_OPEN_PAUSED_KEY = "hgdc-session-open:paused";
+/** À la déconnexion d'un module : plus d'ouverture en arrière-plan jusqu'à la prochaine connexion. */
+export function pauseSessionOpening(win = typeof window === "undefined" ? null : window) {
+    try {
+        win?.localStorage.setItem(SESSION_OPEN_PAUSED_KEY, String(Date.now()));
+    }
+    catch {
+        // Stockage refusé : l'ouverture n'a pas lieu non plus sans lui (`startSessionOpening`).
+    }
+}
 /** Marque d'un lien de la barre vers un autre produit servi sous la même origine : prérendu au survol. */
 export const PRODUCT_PRERENDER_ATTRIBUTE = "data-hgdc-prerender";
 /**
@@ -95,19 +118,20 @@ export function takeOrgSyncCookie(doc = document) {
  * Vrai si la relecture de ce produit est due, et note alors l'heure : au plus une toutes les
  * `BACKGROUND_REFRESH_INTERVAL_MS`. Sans `localStorage` (navigation privée stricte), toujours due.
  */
-function refreshDue(base, win, now = Date.now()) {
-    const key = `${ORG_SYNC_LAST_KEY_PREFIX}${base || "/"}`;
+function refreshDue(base, win, now = Date.now(), prefix = ORG_SYNC_LAST_KEY_PREFIX, interval = BACKGROUND_REFRESH_INTERVAL_MS, withoutStorage = true) {
+    const key = `${prefix}${base || "/"}`;
     try {
         const storage = win?.localStorage;
         if (!storage)
-            return true;
+            return withoutStorage;
         const last = Number(storage.getItem(key));
-        if (Number.isFinite(last) && last > 0 && now - last >= 0 && now - last < BACKGROUND_REFRESH_INTERVAL_MS)
+        if (Number.isFinite(last) && last > 0 && now - last >= 0 && now - last < interval)
             return false;
         storage.setItem(key, String(now));
     }
     catch {
-        // Stockage refusé : la relecture part, comme avant.
+        // Stockage refusé : la relecture part, comme avant ; l'ouverture, elle, ne part pas.
+        return withoutStorage;
     }
     return true;
 }
@@ -128,24 +152,82 @@ export function startBackgroundRefresh(doc = document) {
     const base = takeOrgSync(doc);
     if (base === null || !refreshDue(base, doc.defaultView))
         return null;
+    return openHiddenFrame(doc, `${base}${BACKGROUND_REFRESH_PATH}`);
+}
+/** Vrai si une déconnexion a suspendu l'ouverture, ou si le stockage manque (rien ne la limiterait). */
+function openingPaused(win) {
+    try {
+        return !win?.localStorage || win.localStorage.getItem(SESSION_OPEN_PAUSED_KEY) !== null;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Un cadre caché vers une adresse de l'entrée, retiré à son chargement ou après
+ * `BACKGROUND_REFRESH_TIMEOUT_MS`. Ni script, ni formulaire, ni navigation de la page (`sandbox`) ;
+ * même origine pour les cookies du produit. `onDone` est appelé une fois, quand il est retiré.
+ */
+function openHiddenFrame(doc, src, onDone) {
     const frame = doc.createElement("iframe");
     frame.hidden = true;
     frame.tabIndex = -1;
     frame.title = "";
     frame.setAttribute("aria-hidden", "true");
-    // Même origine pour les cookies du produit ; ni script, ni formulaire, ni navigation de la page.
     frame.setAttribute("sandbox", "allow-same-origin");
     frame.referrerPolicy = "no-referrer";
     const done = () => {
         window.clearTimeout(timer);
         frame.remove();
+        onDone?.();
     };
     const timer = window.setTimeout(done, BACKGROUND_REFRESH_TIMEOUT_MS);
     frame.addEventListener("load", done, { once: true });
-    frame.src = `${base}${BACKGROUND_REFRESH_PATH}`;
+    frame.src = src;
     doc.body.append(frame);
     return frame;
 }
+/**
+ * La base d'un produit (`/mail`) depuis le lien relatif de sa barre (`/mail/auth/hgdc?…`), ou
+ * `null` pour un lien absolu (autre origine) ou une base illisible.
+ */
+export function productEntryBase(href) {
+    if (!href.startsWith("/"))
+        return null;
+    const index = href.indexOf("/auth/hgdc");
+    if (index <= 0)
+        return null;
+    const base = href.slice(0, index);
+    return BASE_PATH.test(base) ? base : null;
+}
+/**
+ * Ouvre en arrière-plan la session des autres modules de la barre (ADR 0026) : un cadre caché à la
+ * fois vers `<base>/auth/hgdc?frame=open`, au plus une fois par jour et par module. Session déjà
+ * ouverte : réponse vide sans appel à ID. Sinon, la connexion HGDC se fait dans le cadre ; si ID
+ * demande quelque chose (session expirée, consentement), il refuse d'être affiché dans un cadre et
+ * rien ne se passe : le clic fera la connexion habituelle. Pas sur une page prérendue, ni quand
+ * l'économie de données est demandée. Rend une fonction qui arrête la file.
+ */
+export function startSessionOpening(bases, doc = document) {
+    const win = doc.defaultView;
+    const saveData = win?.navigator?.connection
+        ?.saveData;
+    if (saveData || doc.prerendering || openingPaused(win))
+        return () => { };
+    // Sans stockage, pas de limite par jour : rien ne part (sinon une connexion par module à chaque page).
+    const queue = bases.filter((base) => refreshDue(base, win, Date.now(), SESSION_OPEN_KEY_PREFIX, SESSION_OPEN_INTERVAL_MS, false));
+    let stopped = false;
+    const next = () => {
+        const base = queue.shift();
+        if (stopped || base === undefined)
+            return;
+        openHiddenFrame(doc, `${base}${SESSION_OPEN_PATH}`, next);
+    };
+    next();
+    return () => {
+        stopped = true;
+    };
+}
 /**
  * Relecture en arrière-plan si l'entrée l'a demandé. Montée à la racine du document
  * (`FamilyLoaderRoot`), pour toutes les pages, y compris celles hors de la coque : la page « il te
@@ -181,3 +263,23 @@ export function useProductSwitch(enabled = true) {
         return () => script.remove();
     }, [enabled]);
 }
+/**
+ * Dans la barre de Basalte (`ShellNavigation`) : ouvre la session des modules affichés servis sous
+ * la même origine, `SESSION_OPEN_DELAY_MS` après l'affichage (ADR 0026). `bases` : clé stable
+ * (les bases jointes), pour ne pas relancer la file à chaque rendu.
+ */
+export function useSessionOpening(bases) {
+    const key = bases.join(" ");
+    useEffect(() => {
+        if (!key)
+            return;
+        let stop = () => { };
+        const timer = window.setTimeout(() => {
+            stop = startSessionOpening(key.split(" "));
+        }, SESSION_OPEN_DELAY_MS);
+        return () => {
+            window.clearTimeout(timer);
+            stop();
+        };
+    }, [key]);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hgdc/ui",
-  "version": "0.72.2",
+  "version": "0.74.0",
   "description": "Interface de la H Collection : jetons de la DA, thèmes, polices et composants.",
   "license": "UNLICENSED",
   "homepage": "https://github.com/hugogebel-boop/hgdc-kit/tree/main/packages/ui#readme",