@indos/bibliotheque 1.1.1 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,26 @@
2
2
 
3
3
  Écrit pour le développeur d'une app du client, qui monte la version de la bibliothèque dans son dépôt : une section par version publiée sur npm. Une version qui demande un geste dans l'app a sa rubrique « Ruptures » : le geste, les versions exactes de React, Vite et TanStack à reprendre, et le core que demande la majeure.
4
4
 
5
+ ## 1.3.0
6
+
7
+ - La page de l'espace a une seule coquille, celle de l'espace : les réglages d'une app s'y rendent comme ses écrans. `coquilleDesReglages` reste exportée, comme autre nom de `coquilleDeLEspace` : une app qui y déclare ses réglages marche sans rien changer. Ce nom se retirera dans une version majeure ; déclarez la route de vos réglages sous `coquilleDeLEspace`.
8
+ - Sur chaque page d'une app, au-dessus de l'écran, l'en-tête de l'app : son titre et ses onglets, « Documentation » (`/documentation/<app>`, servie par le core), « Réglages » quand la personne peut les voir, et un onglet par écran. Il se dessine depuis la session : rien à déclarer dans la page.
9
+ - Sur une page d'une app, `Ecran` n'a pas de surtitre par défaut : l'en-tête de l'app porte son titre.
10
+ - Le menu sous le nom de la personne : son courriel, « Mon compte », « Équipe » pour le propriétaire, « Se déconnecter ».
11
+ - Un écran en pleine largeur (`staticData: { pleineLargeur: true }`) est une colonne qui descend jusqu'au bas de la fenêtre : un bloc en `flex-1 min-h-0` prend la hauteur qui reste.
12
+ - `appDuChemin` et `ongletsDe` donnent l'app d'une page et ses onglets.
13
+ - `lancerLeFauxCore` prend des réglages au propriétaire seul, `reglages: { pour: 'proprietaire' }`.
14
+ - La carte de l'app sur l'accueil, son logo et sa documentation se déclarent à la racine de son dépôt : `description` dans `module.json`, `logo.svg` et `DOCUMENTATION.md` à côté, tous facultatifs. Ils demandent le core 2.3.0 et le kit 0.27.0.
15
+ - Rien à changer dans l'app pour monter : `"@indos/bibliotheque": "1.3.0"` dans ses `dependencies`, puis `npm install` et `npm run build`. Un test qui vérifiait la barre des réglages lit l'onglet « Réglages » de l'en-tête (`<nav aria-label="Onglets">`).
16
+
17
+ ## 1.2.0
18
+
19
+ - La page de l'espace s'affiche d'emblée avec sa barre, d'une page à l'autre comme d'une app à une autre : `servirLaPage` écrit dans la page la session de la personne, dans la forme de `/espace/session` (`<meta name="indos-session">`, échappée), et la page se rend avec elle dès son script, sans attendre le réseau, puis relit `/espace/session` en arrière-plan, ce qui prolonge la session.
20
+ - `creerLaSession()` donne `sessionDe(requete)`, cette session pour la page ; son type est `SessionEcriteDansLaPage`. Une app qui passe à `servirLaPage` sa propre session avec `personneDe` (`SessionDeLaPage`, inchangé) est servie comme avant, sans la session écrite.
21
+ - `lancerLaPage` rend une fonction qui démonte la page, pour un test.
22
+ - Un écran qui attend ses données (`useSuspenseQuery`) laisse la barre affichée.
23
+ - Rien à changer dans l'app pour monter : `"@indos/bibliotheque": "1.2.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
24
+
5
25
  ## 1.1.1
6
26
 
7
27
  - `@indos/bibliotheque/app` : le serveur de l'app garde ouverte une connexion inactive 95 s, au-delà des 90 s du proxy de Coolify, qui peut y envoyer la requête suivante : elle est servie.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "1.1.1",
3
+ "version": "1.3.0",
4
4
  "description": "La bibliothèque des apps d'Indos : le serveur, le MCP, la base et la page de l'espace d'une app.",
5
5
  "license": "MIT",
6
6
  "type": "module",
package/src/ecran.d.ts CHANGED
@@ -85,6 +85,8 @@ export declare function creerLaRacine(options: {
85
85
  ecrans?: {
86
86
  nom: string;
87
87
  }[];
88
- reglages?: boolean;
88
+ reglages?: boolean | {
89
+ pour: 'proprietaire';
90
+ };
89
91
  };
90
92
  }): (requete: IncomingMessage, reponse: ServerResponse, chemin: string) => Promise<boolean>;
@@ -4,5 +4,3 @@ export type Piece = {
4
4
  };
5
5
  export declare const ContexteDeLaPiece: import("react").Context<Piece>;
6
6
  export declare function usePiece(): Piece;
7
- export type Coquille = 'espace' | 'reglages';
8
- export declare const ContexteDeLaCoquille: import("react").Context<Coquille>;
@@ -3,4 +3,3 @@ export const ContexteDeLaPiece = createContext({ nom: '', version: '' });
3
3
  export function usePiece() {
4
4
  return useContext(ContexteDeLaPiece);
5
5
  }
6
- export const ContexteDeLaCoquille = createContext('espace');
@@ -1,2 +1 @@
1
1
  export declare function CoquilleDeLEspace(): import("react").JSX.Element;
2
- export declare function CoquilleDesReglages(): import("react").JSX.Element;
@@ -1,48 +1,40 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { Outlet, useLocation, useMatches } from '@tanstack/react-router';
3
- import { useEffect, useId, useState } from 'react';
3
+ import { Suspense, useEffect, useId, useState } from 'react';
4
4
  import { cn } from '../ui/classes.js';
5
5
  import { Menu, MenuContenu, MenuDeclencheur, MenuEntree, MenuLibelle, MenuSeparateur } from '../ui/menu.js';
6
- import { ContexteDeLaCoquille, usePiece } from './contexte.js';
6
+ import { usePiece } from './contexte.js';
7
+ import { EnTeteDeLApp } from './en-tete-de-l-app.js';
7
8
  import { entreeActive } from './entree-active.js';
8
9
  import { LienDansLaPage } from './lien.js';
9
10
  import { useSession } from './session.js';
10
- // Les deux coquilles de la page, rendues d'après la session (docs/architecture.md, « L'espace et
11
- // les réglages ») : la barre, à la hauteur de l'écran, repliée en menu sur un téléphone ; puis
12
- // l'écran (son en-tête et son contenu, `Ecran`) et, au pied, la version de la pièce. L'entrée
13
- // active (`entreeActive`) est marquée `aria-current="page"`.
11
+ // La coquille de la page, rendue d'après la session (docs/architecture.md, « L'espace ») : la barre,
12
+ // à la hauteur de l'écran, repliée en menu sur un téléphone ; puis, sur une page d'une app, son
13
+ // en-tête et ses onglets (`EnTeteDeLApp`) ; l'écran (son en-tête et son contenu, `Ecran`) et, au
14
+ // pied, la version de la pièce. L'entrée active (`entreeActive`) est marquée `aria-current="page"`.
14
15
  // La largeur sous laquelle la barre se replie en menu, celle du tableau empilé (`ui/theme.css`).
15
16
  const large = 'max-[760px]:hidden';
16
17
  const etroit = 'min-[761px]:hidden';
17
- // La coquille de l'espace : la marque, qui mène à l'accueil, les entrées de la barre, et en bas le
18
- // nom de la personne, qui ouvre son menu.
18
+ // La barre : la marque, qui mène à l'accueil, les entrées de la barre, et en bas le nom de la
19
+ // personne, qui ouvre son menu.
19
20
  export function CoquilleDeLEspace() {
20
21
  const session = useSession();
21
22
  const ici = useLocation({ select: (lieu) => lieu.pathname });
22
23
  const active = entreeActive(session.barre.map((entree) => entree.chemin), ici);
23
24
  const navigation = (_jsx("nav", { "aria-label": "Espace", className: "grid content-start gap-px", children: session.barre.map((entree) => (_jsx(EntreeDeLaBarre, { chemin: entree.chemin, active: entree.chemin === active, children: entree.titre }, entree.chemin))) }));
24
- return (_jsx(Coquille, { coquille: "espace", haut: _jsx(Marque, { session: session, active: ici === '/' }), navigation: navigation, bas: _jsx(MenuDeLaPersonne, { session: session }) }));
25
+ return (_jsx(Coquille, { haut: _jsx(Marque, { session: session, active: ici === '/' }), navigation: navigation, bas: _jsx(MenuDeLaPersonne, { session: session }) }));
25
26
  }
26
- // La coquille des réglages : « ← Espace » en haut, puis leur accueil, les apps ouvertes à la
27
- // personne qui ont des réglages, « Mon compte », et « Équipe » au propriétaire seul. Rien sous les
28
- // entrées.
29
- export function CoquilleDesReglages() {
30
- const session = useSession();
31
- const ici = useLocation({ select: (lieu) => lieu.pathname });
32
- const apps = session.apps.filter((app) => app.reglages);
33
- const active = entreeActive(['/reglages', ...apps.map((app) => app.lien), '/compte', '/equipe'], ici);
34
- const navigation = (_jsxs("nav", { "aria-label": "R\u00E9glages", className: "grid content-start gap-4", children: [_jsx(GroupeDeLaBarre, { children: _jsx(EntreeDeLaBarre, { chemin: "/reglages", active: active === '/reglages', children: "R\u00E9glages" }) }), apps.length > 0 && (_jsx(GroupeDeLaBarre, { titre: "Apps", children: apps.map((app) => (_jsx(EntreeDeLaBarre, { chemin: app.lien, active: active === app.lien, children: app.titre }, app.nom))) })), _jsx(GroupeDeLaBarre, { titre: "Vous", children: _jsx(EntreeDeLaBarre, { chemin: "/compte", active: active === '/compte', children: "Mon compte" }) }), session.proprietaire && (_jsx(GroupeDeLaBarre, { titre: "Entreprise", children: _jsx(EntreeDeLaBarre, { chemin: "/equipe", active: active === '/equipe', children: "\u00C9quipe" }) }))] }));
35
- const retour = (_jsx(LienDansLaPage, { href: "/", className: "flex h-8 items-center rounded-md px-2 font-medium text-gris no-underline hover:bg-survol hover:text-encre", children: "\u2190 Espace" }));
36
- return _jsx(Coquille, { coquille: "reglages", haut: retour, navigation: navigation });
37
- }
38
- // La structure commune : la barre large, à la hauteur de l'écran ; sur un téléphone, la barre
39
- // repliée, son haut et le bouton « Menu », qui déplie les entrées ; le contenu et son pied. Le
27
+ // La structure : la barre large, à la hauteur de l'écran ; sur un téléphone, la barre repliée, son
28
+ // haut et le bouton « Menu », qui déplie les entrées ; l'en-tête de l'app, le contenu et son pied. Le
40
29
  // contenu se lit sur 880 px au plus, sauf pour un écran déclaré en pleine largeur
41
- // (`staticData: { pleineLargeur: true }`), comme la page hôte d'une page, qui encadre une page entière.
42
- function Coquille({ coquille, haut, navigation, bas }) {
30
+ // (`staticData: { pleineLargeur: true }`), comme la page hôte d'une page, qui encadre une page entière :
31
+ // son contenu est alors une colonne qui descend jusqu'au bas de la fenêtre, où un bloc qui prend
32
+ // `flex-1` occupe la hauteur qui reste, comme une toile. Un écran qui attend ses données laisse la
33
+ // barre et l'en-tête de l'app affichés.
34
+ function Coquille({ haut, navigation, bas }) {
43
35
  const piece = usePiece();
44
36
  const pleineLargeur = useMatches({ select: (routes) => routes.some((route) => route.staticData?.pleineLargeur === true) });
45
- return (_jsx(ContexteDeLaCoquille.Provider, { value: coquille, children: _jsxs("div", { className: "grid min-h-dvh grid-cols-[248px_minmax(0,1fr)] max-[760px]:grid-cols-[minmax(0,1fr)]", children: [_jsxs("aside", { className: cn('sticky top-0 flex h-dvh flex-col gap-[18px] overflow-y-auto border-r border-trait bg-surface px-3 py-3.5', large), children: [haut, _jsx("div", { className: "flex-1", children: navigation }), bas] }), _jsxs("div", { className: "min-w-0", children: [_jsx(BarreRepliee, { haut: haut, navigation: navigation, bas: bas }), _jsx("main", { className: "min-w-0 px-10 pt-9 pb-14 max-[760px]:px-4 max-[760px]:pt-6 max-[760px]:pb-10", children: _jsxs("div", { className: pleineLargeur ? undefined : 'max-w-[880px]', children: [_jsx(Outlet, {}), _jsxs("p", { className: "mt-10 mb-0 font-mono text-[11.5px] leading-[1.4] text-gris", children: [piece.nom, " ", piece.version] })] }) })] })] }) }));
37
+ return (_jsxs("div", { className: "grid min-h-dvh grid-cols-[248px_minmax(0,1fr)] max-[760px]:grid-cols-[minmax(0,1fr)]", children: [_jsxs("aside", { className: cn('sticky top-0 flex h-dvh flex-col gap-[18px] overflow-y-auto border-r border-trait bg-surface px-3 py-3.5', large), children: [haut, _jsx("div", { className: "flex-1", children: navigation }), bas] }), _jsxs("div", { className: "flex min-h-dvh min-w-0 flex-col", children: [_jsx(BarreRepliee, { haut: haut, navigation: navigation, bas: bas }), _jsx("main", { className: "flex min-w-0 flex-1 flex-col px-10 pt-9 pb-14 max-[760px]:px-4 max-[760px]:pt-6 max-[760px]:pb-10", children: _jsxs("div", { className: pleineLargeur ? 'flex min-h-0 flex-1 flex-col' : 'max-w-[880px]', children: [_jsx(EnTeteDeLApp, {}), _jsxs(Suspense, { fallback: null, children: [_jsx(Outlet, {}), _jsxs("p", { className: "mt-10 mb-0 font-mono text-[11.5px] leading-[1.4] text-gris", children: [piece.nom, " ", piece.version] })] })] }) })] })] }));
46
38
  }
47
39
  // La barre repliée, sur un téléphone : son haut et « Menu », qui déplie les entrées et le bas de la
48
40
  // barre. Elle se replie quand on change d'écran.
@@ -62,15 +54,13 @@ function Marque({ session, active }) {
62
54
  ? (_jsx("span", { className: "grid size-[30px] flex-none place-items-center rounded-[7px] border border-trait bg-papier-du-logo", children: _jsx("img", { alt: "", src: "/theme/logo.svg", className: "block size-5" }) }))
63
55
  : (_jsx("span", { "aria-hidden": "true", className: "grid size-[30px] flex-none place-items-center rounded-[7px] border border-trait bg-papier text-encre", children: initiale.toLocaleUpperCase('fr') })), _jsx("span", { className: "truncate font-titre text-[22px] leading-none tracking-[-.01em]", children: theme.nom })] }));
64
56
  }
65
- function GroupeDeLaBarre({ titre, children }) {
66
- return (_jsxs("div", { className: "grid gap-px", children: [titre && _jsx("div", { className: "px-2 pb-1 text-[11px] tracking-[.07em] text-gris uppercase", children: titre }), children] }));
67
- }
68
57
  // Une entrée d'une barre ; l'active, le point à l'accent.
69
58
  function EntreeDeLaBarre({ chemin, active, children }) {
70
59
  return (_jsx(LienDansLaPage, { href: chemin, "aria-current": active ? 'page' : undefined, className: cn('flex h-8 items-center gap-2.5 rounded-md border border-transparent px-2 font-medium text-gris no-underline hover:bg-survol hover:text-encre', 'before:size-1.5 before:flex-none before:rounded-full before:bg-transparent', 'aria-[current=page]:border-trait aria-[current=page]:bg-papier aria-[current=page]:text-encre aria-[current=page]:before:bg-accent'), children: children }));
71
60
  }
72
- // Le nom de la personne, en bas de la barre de l'espace, qui ouvre son menu : son courriel,
73
- // « Réglages », et « Se déconnecter », un formulaire `POST /deconnexion` du core, sans script.
61
+ // Le nom de la personne, en bas de la barre, qui ouvre son menu : son courriel, « Mon compte »,
62
+ // « Équipe » pour le propriétaire, et « Se déconnecter », un formulaire `POST /deconnexion` du core,
63
+ // sans script.
74
64
  function MenuDeLaPersonne({ session }) {
75
- return (_jsx("div", { className: "border-t border-trait pt-3", children: _jsxs(Menu, { children: [_jsxs(MenuDeclencheur, { className: "flex h-9 w-full cursor-pointer items-center justify-between gap-2 rounded-md border-0 bg-transparent px-2 text-left font-medium text-encre hover:bg-survol data-[state=open]:bg-survol", children: [_jsx("span", { className: "truncate", children: session.nom }), _jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", className: "size-4 flex-none text-gris", children: _jsx("path", { d: "M4 6l4 4 4-4", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }) })] }), _jsxs(MenuContenu, { side: "top", align: "start", className: "w-[224px]", children: [_jsx(MenuLibelle, { className: "font-mono", children: session.email }), _jsx(MenuSeparateur, {}), _jsx(MenuEntree, { asChild: true, children: _jsx(LienDansLaPage, { href: "/reglages", children: "R\u00E9glages" }) }), _jsx("form", { method: "post", action: "/deconnexion", children: _jsx(MenuEntree, { asChild: true, onSelect: (evenement) => evenement.preventDefault(), children: _jsx("button", { type: "submit", children: "Se d\u00E9connecter" }) }) })] })] }) }));
65
+ return (_jsx("div", { className: "border-t border-trait pt-3", children: _jsxs(Menu, { children: [_jsxs(MenuDeclencheur, { className: "flex h-9 w-full cursor-pointer items-center justify-between gap-2 rounded-md border-0 bg-transparent px-2 text-left font-medium text-encre hover:bg-survol data-[state=open]:bg-survol", children: [_jsx("span", { className: "truncate", children: session.nom }), _jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", className: "size-4 flex-none text-gris", children: _jsx("path", { d: "M4 6l4 4 4-4", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }) })] }), _jsxs(MenuContenu, { side: "top", align: "start", className: "w-[224px]", children: [_jsx(MenuLibelle, { className: "font-mono", children: session.email }), _jsx(MenuSeparateur, {}), _jsx(MenuEntree, { asChild: true, children: _jsx(LienDansLaPage, { href: "/compte", children: "Mon compte" }) }), session.proprietaire && (_jsx(MenuEntree, { asChild: true, children: _jsx(LienDansLaPage, { href: "/equipe", children: "\u00C9quipe" }) })), _jsx(MenuSeparateur, {}), _jsx("form", { method: "post", action: "/deconnexion", children: _jsx(MenuEntree, { asChild: true, onSelect: (evenement) => evenement.preventDefault(), children: _jsx("button", { type: "submit", children: "Se d\u00E9connecter" }) }) })] })] }) }));
76
66
  }
@@ -1,4 +1,4 @@
1
- import { type ReactNode } from 'react';
1
+ import type { ReactNode } from 'react';
2
2
  export type ProprietesDUnEcran = {
3
3
  titre: string;
4
4
  surtitre?: string;
@@ -1,22 +1,20 @@
1
1
  import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { useLocation } from '@tanstack/react-router';
3
- import { useContext } from 'react';
4
- import { ContexteDeLaCoquille } from './contexte.js';
3
+ import { appDuChemin } from './en-tete-de-l-app.js';
5
4
  import { entreeActive } from './entree-active.js';
6
5
  import { useSession } from './session.js';
7
6
  export function Ecran({ titre, surtitre, onglet, presentation, action, children }) {
8
7
  const session = useSession();
9
- const coquille = useContext(ContexteDeLaCoquille);
10
8
  const ici = useLocation({ select: (lieu) => lieu.pathname });
11
- const dessus = surtitre ?? surtitreDe(session, coquille, ici);
9
+ const dessus = surtitre ?? surtitreDe(session, ici);
12
10
  return (_jsxs(_Fragment, { children: [_jsx("title", { children: `${onglet ?? titre} · ${session.theme.nom}` }), _jsxs("header", { className: "mb-7 flex flex-wrap items-end justify-between gap-x-6 gap-y-3", children: [_jsxs("div", { className: "min-w-0", children: [dessus && _jsx("p", { className: "m-0 mb-1.5 text-[11px] tracking-[.07em] text-gris uppercase", children: dessus }), _jsx("h1", { className: "m-0 font-titre text-[40px] leading-[1.05] font-normal tracking-[-.01em] text-balance max-[760px]:text-[32px]", children: titre }), presentation && _jsx("p", { className: "mt-2.5 mb-0 max-w-[62ch] text-gris", children: presentation })] }), action] }), children] }));
13
11
  }
14
- // Le surtitre par défaut : dans l'espace, le titre de l'app de l'entrée active de la barre
15
- // (`entreeActive`) ; dans les réglages, le groupe de l'entrée.
16
- const groupesDesReglages = { '/reglages': 'Réglages', '/compte': 'Vous', '/equipe': 'Entreprise' };
17
- function surtitreDe(session, coquille, ici) {
18
- if (coquille === 'reglages') {
19
- return groupesDesReglages[ici] ?? 'Apps';
12
+ // Le surtitre par défaut : aucun sur une page d'une app, dont l'en-tête porte le titre ; ailleurs,
13
+ // le titre de l'app de l'entrée active de la barre (`entreeActive`), comme le nom de l'OS sur le
14
+ // journal.
15
+ function surtitreDe(session, ici) {
16
+ if (appDuChemin(session, ici)) {
17
+ return undefined;
20
18
  }
21
19
  const active = entreeActive(session.barre.map((entree) => entree.chemin), ici);
22
20
  return session.barre.find((entree) => entree.chemin === active)?.app;
@@ -0,0 +1,8 @@
1
+ import { type AppOuverte, type Session } from './session.ts';
2
+ export type Onglet = {
3
+ titre: string;
4
+ chemin: string;
5
+ };
6
+ export declare function appDuChemin(session: Session, ici: string): AppOuverte | undefined;
7
+ export declare function ongletsDe(app: AppOuverte): Onglet[];
8
+ export declare function EnTeteDeLApp(): import("react").JSX.Element | null;
@@ -0,0 +1,33 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { useLocation } from '@tanstack/react-router';
3
+ import { entreeActive } from './entree-active.js';
4
+ import { LienDansLaPage } from './lien.js';
5
+ import { useSession } from './session.js';
6
+ // L'app de la page, d'après son chemin : `/documentation/<app>`, ou `/<app>/…` pour une app ouverte
7
+ // à la personne. Le core, ses écrans (`/journal`, `/compte`) et l'accueil n'en ont pas.
8
+ export function appDuChemin(session, ici) {
9
+ const [, premier, second] = ici.split('/');
10
+ const nom = premier === 'documentation' ? second : premier;
11
+ return session.apps.find((app) => app.nom === nom);
12
+ }
13
+ // Les onglets d'une app, dans leur ordre.
14
+ export function ongletsDe(app) {
15
+ return [
16
+ { titre: 'Documentation', chemin: `/documentation/${app.nom}` },
17
+ ...(app.reglages ? [{ titre: 'Réglages', chemin: `/${app.nom}/reglages` }] : []),
18
+ ...app.ecrans.map((ecran) => ({ titre: ecran.titre, chemin: ecran.chemin })),
19
+ ];
20
+ }
21
+ export function EnTeteDeLApp() {
22
+ const session = useSession();
23
+ const ici = useLocation({ select: (lieu) => lieu.pathname });
24
+ const app = appDuChemin(session, ici);
25
+ if (!app) {
26
+ return null;
27
+ }
28
+ const onglets = ongletsDe(app);
29
+ // L'onglet du chemin ; sinon le premier écran de l'app sous le même `/<app>/`, comme « Pages » sur
30
+ // la page hôte d'une page (`/pages/<id>`).
31
+ const active = onglets.find((onglet) => onglet.chemin === ici)?.chemin ?? entreeActive(app.ecrans.map((ecran) => ecran.chemin), ici);
32
+ return (_jsxs("div", { className: "mb-8 border-b border-trait", children: [_jsx("p", { className: "m-0 mb-2.5 text-[11px] tracking-[.07em] text-gris uppercase", children: app.titre }), _jsx("nav", { "aria-label": "Onglets", className: "-mb-px flex flex-wrap gap-x-6", children: onglets.map((onglet) => (_jsx(LienDansLaPage, { href: onglet.chemin, "aria-current": onglet.chemin === active ? 'page' : undefined, className: "border-b-2 border-transparent pb-2.5 font-medium text-gris no-underline hover:text-encre aria-[current=page]:border-accent aria-[current=page]:text-encre", children: onglet.titre }, onglet.chemin))) })] }));
33
+ }
@@ -2,6 +2,7 @@ export { lancerLaPage } from './lancer.tsx';
2
2
  export { coquilleDeLEspace, coquilleDesReglages, creerLaPage, racine, type ContexteDuRouteur, type OptionsDeLaPage } from './page.tsx';
3
3
  export { usePiece, type Piece } from './contexte.ts';
4
4
  export { Ecran, type ProprietesDUnEcran } from './ecran.tsx';
5
+ export { appDuChemin, ongletsDe, type Onglet } from './en-tete-de-l-app.tsx';
5
6
  export { ErreurDUnEcran } from './erreur.tsx';
6
7
  export { useSession, requeteDeLaSession, type AppOuverte, type EcranDUneApp, type EntreeDeLaBarre, type Session } from './session.ts';
7
8
  export { appeler, faireUnGeste, texteDe, ErreurDUnAppel, type ResultatDUnOutil } from './appels.ts';
@@ -4,6 +4,7 @@ export { lancerLaPage } from './lancer.js';
4
4
  export { coquilleDeLEspace, coquilleDesReglages, creerLaPage, racine } from './page.js';
5
5
  export { usePiece } from './contexte.js';
6
6
  export { Ecran } from './ecran.js';
7
+ export { appDuChemin, ongletsDe } from './en-tete-de-l-app.js';
7
8
  export { ErreurDUnEcran } from './erreur.js';
8
9
  export { useSession, requeteDeLaSession } from './session.js';
9
10
  export { appeler, faireUnGeste, texteDe, ErreurDUnAppel } from './appels.js';
@@ -1,3 +1,3 @@
1
1
  import '../ui/theme.css';
2
2
  import { type OptionsDeLaPage } from './page.tsx';
3
- export declare function lancerLaPage(options: Omit<OptionsDeLaPage, 'historique'>): void;
3
+ export declare function lancerLaPage(options: Omit<OptionsDeLaPage, 'historique'>): () => void;
@@ -1,13 +1,32 @@
1
1
  import { jsx as _jsx } from "react/jsx-runtime";
2
2
  import { StrictMode } from 'react';
3
+ import { flushSync } from 'react-dom';
3
4
  import { createRoot } from 'react-dom/client';
4
5
  import '../ui/theme.css';
5
6
  import { creerLaPage } from './page.js';
6
7
  // Lance la page de l'espace d'une pièce, depuis le module de sa page (`espace/page.tsx`), avec la
7
8
  // feuille des pages (`@indos/bibliotheque/ui/theme.css`), après `/theme/variables.css`.
9
+ // Le routeur résout l'écran, puis la page se rend d'un seul geste, sans attendre l'ordonnanceur de
10
+ // React. Avec la session dans la page, rien n'attend le réseau : le rendu se fait dans la foulée du
11
+ // script, avant que le navigateur affiche la page, et la barre est sur sa première image.
12
+ // Elle rend de quoi démonter la page, sa racine React et le routeur branché sur l'historique,
13
+ // pour un test.
8
14
  export function lancerLaPage(options) {
9
- const { Page } = creerLaPage(options);
15
+ const { router, Page } = creerLaPage(options);
10
16
  const element = document.createElement('div');
11
17
  document.body.append(element);
12
- createRoot(element).render(_jsx(StrictMode, { children: _jsx(Page, {}) }));
18
+ const racine = createRoot(element);
19
+ let demontee = false;
20
+ function rendre() {
21
+ if (demontee) {
22
+ return;
23
+ }
24
+ flushSync(() => racine.render(_jsx(StrictMode, { children: _jsx(Page, {}) })));
25
+ }
26
+ router.load().then(rendre, rendre);
27
+ return function demonter() {
28
+ demontee = true;
29
+ racine.unmount();
30
+ element.remove();
31
+ };
13
32
  }
@@ -9,9 +9,9 @@ declare module '@tanstack/react-router' {
9
9
  pleineLargeur?: boolean;
10
10
  }
11
11
  }
12
- export declare const racine: import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, ({ context }: import("@tanstack/react-router").BeforeLoadContextOptions<import("@tanstack/react-router").Register, any, undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, "__root__", unknown, undefined>) => Promise<void>, {}, undefined, unknown, unknown, unknown, unknown, undefined>;
13
- export declare const coquilleDeLEspace: import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, ({ context }: import("@tanstack/react-router").BeforeLoadContextOptions<import("@tanstack/react-router").Register, any, undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, "__root__", unknown, undefined>) => Promise<void>, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/", "/", "coquille-de-l-espace", "/coquille-de-l-espace", undefined, import("@tanstack/react-router").ResolveParams<"/">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>;
14
- export declare const coquilleDesReglages: import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, ({ context }: import("@tanstack/react-router").BeforeLoadContextOptions<import("@tanstack/react-router").Register, any, undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, "__root__", unknown, undefined>) => Promise<void>, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/", "/", "coquille-des-reglages", "/coquille-des-reglages", undefined, import("@tanstack/react-router").ResolveParams<"/">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>;
12
+ export declare const racine: import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, ({ context }: import("@tanstack/react-router").BeforeLoadContextOptions<import("@tanstack/react-router").Register, any, undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, "__root__", unknown, undefined>) => Promise<undefined> | undefined, {}, undefined, unknown, unknown, unknown, unknown, undefined>;
13
+ export declare const coquilleDeLEspace: import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, ({ context }: import("@tanstack/react-router").BeforeLoadContextOptions<import("@tanstack/react-router").Register, any, undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, "__root__", unknown, undefined>) => Promise<undefined> | undefined, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/", "/", "coquille-de-l-espace", "/coquille-de-l-espace", undefined, import("@tanstack/react-router").ResolveParams<"/">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>;
14
+ export declare const coquilleDesReglages: import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, ({ context }: import("@tanstack/react-router").BeforeLoadContextOptions<import("@tanstack/react-router").Register, any, undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, "__root__", unknown, undefined>) => Promise<undefined> | undefined, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/", "/", "coquille-de-l-espace", "/coquille-de-l-espace", undefined, import("@tanstack/react-router").ResolveParams<"/">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>;
15
15
  export type OptionsDeLaPage = {
16
16
  piece: Piece;
17
17
  base: string;
@@ -19,7 +19,7 @@ export type OptionsDeLaPage = {
19
19
  historique?: RouterHistory;
20
20
  };
21
21
  export declare function creerLaPage(options: OptionsDeLaPage): {
22
- router: import("@tanstack/router-core").RouterCore<import("@tanstack/router-core").Route<import("@tanstack/react-router").Register, any, "/", "/", string, "__root__", undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, ({ context }: import("@tanstack/react-router").BeforeLoadContextOptions<import("@tanstack/react-router").Register, any, undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, "__root__", unknown, undefined>) => Promise<void>, {}, undefined, readonly [import("@tanstack/router-core").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, ({ context }: import("@tanstack/react-router").BeforeLoadContextOptions<import("@tanstack/react-router").Register, any, undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, "__root__", unknown, undefined>) => Promise<void>, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/", "/", "coquille-de-l-espace", "/coquille-de-l-espace", undefined, import("@tanstack/react-router").ResolveParams<"/">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, AnyRoute[], unknown, unknown, unknown, undefined>, import("@tanstack/router-core").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, ({ context }: import("@tanstack/react-router").BeforeLoadContextOptions<import("@tanstack/react-router").Register, any, undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, "__root__", unknown, undefined>) => Promise<void>, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/", "/", "coquille-des-reglages", "/coquille-des-reglages", undefined, import("@tanstack/react-router").ResolveParams<"/">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, AnyRoute[], unknown, unknown, unknown, undefined>], unknown, unknown, unknown, undefined>, "never", false, RouterHistory, Record<string, any>>;
22
+ router: import("@tanstack/router-core").RouterCore<import("@tanstack/router-core").Route<import("@tanstack/react-router").Register, any, "/", "/", string, "__root__", undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, ({ context }: import("@tanstack/react-router").BeforeLoadContextOptions<import("@tanstack/react-router").Register, any, undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, "__root__", unknown, undefined>) => Promise<undefined> | undefined, {}, undefined, readonly [import("@tanstack/router-core").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, ({ context }: import("@tanstack/react-router").BeforeLoadContextOptions<import("@tanstack/react-router").Register, any, undefined, {}, ContexteDuRouteur, import("@tanstack/react-router").AnyContext, "__root__", unknown, undefined>) => Promise<undefined> | undefined, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/", "/", "coquille-de-l-espace", "/coquille-de-l-espace", undefined, import("@tanstack/react-router").ResolveParams<"/">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, AnyRoute[], unknown, unknown, unknown, undefined>], unknown, unknown, unknown, undefined>, "never", false, RouterHistory, Record<string, any>>;
23
23
  client: QueryClient;
24
24
  Page: () => import("react").JSX.Element;
25
25
  };
@@ -4,20 +4,24 @@ import { createBrowserHistory, createRootRouteWithContext, createRoute, createRo
4
4
  import { LienDeLaPage } from '../ui/lien.js';
5
5
  import { ErreurDUnAppel, poserLaBase } from './appels.js';
6
6
  import { ContexteDeLaPiece } from './contexte.js';
7
- import { CoquilleDeLEspace, CoquilleDesReglages } from './coquille.js';
7
+ import { CoquilleDeLEspace } from './coquille.js';
8
8
  import { ErreurDUnEcran, Introuvable } from './erreur.js';
9
9
  import { LienDansLaPage } from './lien.js';
10
- import { requeteDeLaSession, useSession } from './session.js';
10
+ import { requeteDeLaSession, sessionDeLaPage, useSession } from './session.js';
11
11
  export const racine = createRootRouteWithContext()({
12
- async beforeLoad({ context }) {
13
- await context.client.ensureQueryData(requeteDeLaSession);
12
+ beforeLoad({ context }) {
13
+ if (!sessionDeLaPage()) {
14
+ return context.client.ensureQueryData(requeteDeLaSession).then(() => undefined);
15
+ }
14
16
  },
15
17
  component: Racine,
16
18
  errorComponent: ErreurDUnEcran,
17
19
  notFoundComponent: Introuvable,
18
20
  });
19
21
  export const coquilleDeLEspace = createRoute({ getParentRoute: () => racine, id: 'coquille-de-l-espace', component: CoquilleDeLEspace });
20
- export const coquilleDesReglages = createRoute({ getParentRoute: () => racine, id: 'coquille-des-reglages', component: CoquilleDesReglages });
22
+ // L'autre nom de la coquille, pour une app qui déclare ses réglages sous `coquilleDesReglages` : ils s'y
23
+ // rendent comme tout écran. Il se retire dans une version majeure.
24
+ export const coquilleDesReglages = coquilleDeLEspace;
21
25
  // Le favicon est le logo du thème quand il y en a un ; sinon, celui, vide, de la page construite.
22
26
  // Les liens des composants (`Lien`) s'ouvrent dans la page vers une route de la page.
23
27
  function Racine() {
@@ -32,11 +36,7 @@ function reessayer(essais, erreur) {
32
36
  export function creerLaPage(options) {
33
37
  poserLaBase(options.base);
34
38
  const client = new QueryClient({ defaultOptions: { queries: { retry: reessayer } } });
35
- const dans = (coquille) => options.ecrans.filter((ecran) => ecran.options.getParentRoute?.() === coquille);
36
- const routeTree = racine.addChildren([
37
- coquilleDeLEspace.addChildren(dans(coquilleDeLEspace)),
38
- coquilleDesReglages.addChildren(dans(coquilleDesReglages)),
39
- ]);
39
+ const routeTree = racine.addChildren([coquilleDeLEspace.addChildren(options.ecrans)]);
40
40
  const router = createRouter({
41
41
  routeTree,
42
42
  context: { client },
@@ -31,6 +31,7 @@ export type Session = {
31
31
  logo: boolean;
32
32
  };
33
33
  };
34
+ export declare function sessionDeLaPage(): Session | undefined;
34
35
  export declare const requeteDeLaSession: import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<Session, Error, Session, string[]>, "queryFn"> & {
35
36
  queryFn?: import("@tanstack/react-query").QueryFunction<Session, string[], never> | undefined;
36
37
  } & import("@tanstack/react-query").QueryKeyWithDataTag<string[], Session, Error>;
@@ -1,11 +1,28 @@
1
1
  import { queryOptions, useSuspenseQuery } from '@tanstack/react-query';
2
2
  import { demander } from './appels.js';
3
- // La requête de la session. Relue au retour sur la fenêtre, elle prolonge la session ; sans
4
- // session, la connexion du core (`demander`).
3
+ // La session que le serveur a écrite dans la page (`servirLaPage`, `<meta name="indos-session">`),
4
+ // ou rien : une page servie sans elle, comme en développement, la lit à `/espace/session`.
5
+ export function sessionDeLaPage() {
6
+ const contenu = document.querySelector('meta[name="indos-session"]')?.content;
7
+ if (!contenu) {
8
+ return undefined;
9
+ }
10
+ try {
11
+ return JSON.parse(contenu);
12
+ }
13
+ catch {
14
+ return undefined;
15
+ }
16
+ }
17
+ // La requête de la session. Sa première valeur est celle de la page, datée de zéro : la page la
18
+ // relit aussitôt, en arrière-plan, pour prolonger la session. Relue au retour sur la fenêtre après
19
+ // 30 secondes, elle la prolonge encore ; sans session, la connexion du core (`demander`).
5
20
  export const requeteDeLaSession = queryOptions({
6
21
  queryKey: ['session'],
7
22
  queryFn: () => demander('/espace/session', { methode: 'GET' }),
8
23
  staleTime: 30_000,
24
+ initialData: sessionDeLaPage,
25
+ initialDataUpdatedAt: 0,
9
26
  });
10
27
  // La personne connectée, pour un écran : la session est lue avant qu'il ne s'affiche.
11
28
  export function useSession() {
@@ -17,7 +17,9 @@ export type AppDeclaree = {
17
17
  titre: string;
18
18
  pour?: 'proprietaire';
19
19
  }[];
20
- reglages?: boolean;
20
+ reglages?: boolean | {
21
+ pour: 'proprietaire';
22
+ };
21
23
  };
22
24
  export declare function sessionDuCore(apps: AppDeclaree[], proprietaire: boolean, nomDeLOS: string, groupes?: string[]): {
23
25
  apps: AppDeLaConsole[];
package/src/faux-core.js CHANGED
@@ -25,8 +25,8 @@ function estOuverte(app, proprietaire, groupes) {
25
25
  }
26
26
  // Ce que le core rend à `/session` des apps déclarées, pour une personne, dans sa forme
27
27
  // (core/CLAUDE.md, « La personne connectée ») : les apps qui lui sont ouvertes, d'après
28
- // ses groupes, dans l'ordre de leur titre, chacune avec ses réglages, les écrans que la personne a
29
- // le droit de voir, avec leur chemin, et son lien (ses réglages, sinon son premier écran visible,
28
+ // ses groupes, dans l'ordre de leur titre, chacune avec ses réglages quand la personne a le droit de
29
+ // les voir, les écrans qu'elle a le droit de voir, avec leur chemin, et son lien (ses réglages, sinon son premier écran visible,
30
30
  // sinon son lien déclaré) ; puis la barre de l'espace, leurs écrans, puis le journal, au nom de l'OS.
31
31
  export function sessionDuCore(apps, proprietaire, nomDeLOS, groupes = []) {
32
32
  const resolues = apps
@@ -38,7 +38,7 @@ export function sessionDuCore(apps, proprietaire, nomDeLOS, groupes = []) {
38
38
  const ecrans = (app.ecrans ?? [])
39
39
  .filter((ecran) => !ecran.pour || proprietaire)
40
40
  .map((ecran) => ({ nom: ecran.nom, titre: ecran.titre, chemin: `${chemin}/${ecran.nom}` }));
41
- const reglages = app.reglages === true;
41
+ const reglages = app.reglages === true || (typeof app.reglages === 'object' && proprietaire);
42
42
  return {
43
43
  nom: app.nom,
44
44
  titre: app.titre,
package/src/page.d.ts CHANGED
@@ -4,9 +4,13 @@ export type SessionDeLaPage = {
4
4
  personneDe: (requete: IncomingMessage) => Promise<unknown>;
5
5
  envoyerALaConnexion: (requete: IncomingMessage, reponse: ServerResponse) => void;
6
6
  };
7
+ export type SessionEcriteDansLaPage = {
8
+ sessionDe: (requete: IncomingMessage) => Promise<object | undefined>;
9
+ envoyerALaConnexion: (requete: IncomingMessage, reponse: ServerResponse) => void;
10
+ };
7
11
  export declare function servirLaPage(options: {
8
12
  dist: string | URL;
9
- session?: SessionDeLaPage;
13
+ session?: SessionEcriteDansLaPage | SessionDeLaPage;
10
14
  cadre?: string;
11
15
  entetes?: Record<string, string>;
12
16
  }): (requete: IncomingMessage, reponse: ServerResponse, chemin: string) => Promise<void>;
package/src/page.js CHANGED
@@ -2,7 +2,7 @@ import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
2
2
  import { extname, join } from 'node:path';
3
3
  import { fileURLToPath } from 'node:url';
4
4
  import { traiterUnAppelDEcran } from './appel-d-ecran.js';
5
- import { entetesDeLEspace, envoyerLaPage, pageSimple } from './ecran.js';
5
+ import { echapper, entetesDeLEspace, envoyerLaPage, pageSimple } from './ecran.js';
6
6
  import { Refus } from './mcp.js';
7
7
  import { creerLaSession } from './session.js';
8
8
  // La page de l'espace d'une pièce, le core ou une app (docs/architecture.md, « L'espace et les
@@ -35,8 +35,11 @@ const types = {
35
35
  // `/espace/…` ; `chemin` est celui de la requête dans la pièce, sans son préfixe.
36
36
  // - `/espace/<fichier>` : un fichier construit, gardé un an par le navigateur (son nom change avec
37
37
  // son contenu), sans question au core ; un fichier absent, la page simple en 404.
38
- // - tout autre chemin : la page, pour la personne que rend `session.personneDe`, avec la politique
39
- // de l'espace (`entetesDeLEspace(cadre)`) et `entetes` ; sinon `session.envoyerALaConnexion`.
38
+ // - tout autre chemin : la page, à la personne connectée, avec la politique de l'espace
39
+ // (`entetesDeLEspace(cadre)`) et `entetes` ; sinon `session.envoyerALaConnexion`. Avec
40
+ // `session.sessionDe`, la page porte la session de la personne, dans une balise
41
+ // `<meta name="indos-session">` de sa tête, échappée : la coquille s'y rend dès le premier
42
+ // affichage, sans attendre `/espace/session`.
40
43
  // Seuls `GET` et `HEAD` sont servis. Sans `dist/index.html`, la pièce ne démarre pas.
41
44
  export function servirLaPage(options) {
42
45
  const dossier = typeof options.dist === 'string' ? options.dist : fileURLToPath(options.dist);
@@ -44,8 +47,13 @@ export function servirLaPage(options) {
44
47
  if (!existsSync(index)) {
45
48
  throw new Error(`La page n'est pas construite : ${index} manque (npm run build).`);
46
49
  }
47
- const page = readFileSync(index);
48
- const entetesDeLaPage = { ...entetesDeLEspace(options.cadre), ...options.entetes, 'content-length': String(page.length) };
50
+ const page = readFileSync(index, 'utf8');
51
+ const fin = page.search(/<\/head>/i);
52
+ if (fin === -1) {
53
+ throw new Error(`La page n'a pas de tête : ${index}.`);
54
+ }
55
+ const [debut, suite] = [page.slice(0, fin), page.slice(fin)];
56
+ const entetesDeLaPage = { ...entetesDeLEspace(options.cadre), ...options.entetes };
49
57
  const fichiers = lireLesFichiers(join(dossier, 'espace'));
50
58
  const session = options.session ?? creerLaSession();
51
59
  return async function traiter(requete, reponse, chemin) {
@@ -71,12 +79,15 @@ export function servirLaPage(options) {
71
79
  reponse.end(lecture ? fichier.octets : undefined);
72
80
  return;
73
81
  }
74
- if (!(await session.personneDe(requete))) {
82
+ const ecrite = 'sessionDe' in session;
83
+ const lue = ecrite ? await session.sessionDe(requete) : await session.personneDe(requete);
84
+ if (!lue) {
75
85
  session.envoyerALaConnexion(requete, reponse);
76
86
  return;
77
87
  }
78
- reponse.writeHead(200, entetesDeLaPage);
79
- reponse.end(lecture ? page : undefined);
88
+ const octets = Buffer.from(ecrite ? `${debut}<meta name="indos-session" content="${echapper(JSON.stringify(lue))}">${suite}` : page);
89
+ reponse.writeHead(200, { ...entetesDeLaPage, 'content-length': String(octets.length) });
90
+ reponse.end(lecture ? octets : undefined);
80
91
  };
81
92
  }
82
93
  // Les fichiers construits sous `dist/espace/`, par leur chemin sous ce dossier.
package/src/session.d.ts CHANGED
@@ -7,10 +7,12 @@ export type PersonneConnectee = Personne & PersonneDeLEspace & {
7
7
  export type SessionLue = {
8
8
  personne: PersonneConnectee;
9
9
  ouvre: (app: string) => boolean;
10
+ corps: Record<string, unknown>;
10
11
  };
11
12
  export declare function creerLaSession(adresse?: string | undefined, adresseDuCore?: string | undefined): {
12
13
  lireLaSession: (requete: IncomingMessage) => Promise<SessionLue | undefined>;
13
14
  personneDe: (requete: IncomingMessage) => Promise<PersonneConnectee | undefined>;
15
+ sessionDe(requete: IncomingMessage): Promise<Record<string, unknown> | undefined>;
14
16
  personneDuFormulaire(requete: IncomingMessage): Promise<PersonneConnectee | undefined>;
15
17
  personneDuGeste(requete: IncomingMessage): Promise<PersonneConnectee | 'fermee' | undefined>;
16
18
  envoyerALaConnexion(requete: IncomingMessage, reponse: ServerResponse): void;
package/src/session.js CHANGED
@@ -37,7 +37,8 @@ export function creerLaSession(adresse = process.env.ADRESSE, adresseDuCore = pr
37
37
  if (!reponse.ok) {
38
38
  throw new Error(`Le core ne dit pas qui est connecté : ${reponse.status}.`);
39
39
  }
40
- const { id, email, nom, proprietaire, groupes, apps, barre, theme } = (await reponse.json());
40
+ const corps = (await reponse.json());
41
+ const { id, email, nom, proprietaire, groupes, apps, barre, theme } = corps;
41
42
  if (typeof id !== 'string' || typeof email !== 'string' || typeof nom !== 'string' || typeof proprietaire !== 'boolean') {
42
43
  throw new Error('Le core rend une personne illisible.');
43
44
  }
@@ -45,20 +46,30 @@ export function creerLaSession(adresse = process.env.ADRESSE, adresseDuCore = pr
45
46
  return {
46
47
  personne: { id, email, nom, proprietaire, groupes: groupesDe(groupes), apps: lues, barre: barreDe(barre), theme: themeDe(theme) },
47
48
  ouvre: (app) => !Array.isArray(groupes) || !Array.isArray(apps) || lues.some((lue) => lue.nom === app),
49
+ corps,
48
50
  };
49
51
  }
50
- // La personne connectée à qui l'app est ouverte, ou rien.
51
- async function personneDe(requete) {
52
+ // La session de la personne connectée à qui l'app est ouverte, ou rien.
53
+ async function sessionOuverte(requete) {
52
54
  const lue = await lireLaSession(requete);
53
55
  if (lue && app && !lue.ouvre(app)) {
54
56
  fermees.add(requete);
55
57
  return undefined;
56
58
  }
57
- return lue?.personne;
59
+ return lue;
60
+ }
61
+ // La personne connectée à qui l'app est ouverte, ou rien.
62
+ async function personneDe(requete) {
63
+ return (await sessionOuverte(requete))?.personne;
58
64
  }
59
65
  return {
60
66
  lireLaSession,
61
67
  personneDe,
68
+ // La session que la page de l'espace écrit en elle (`servirLaPage`), dans la forme de
69
+ // `/espace/session`, pour la personne connectée à qui l'app est ouverte ; rien sinon.
70
+ async sessionDe(requete) {
71
+ return (await sessionOuverte(requete))?.corps;
72
+ },
62
73
  // La personne d'un formulaire de l'app : un envoi venu d'une autre origine, ou sans origine, n'en
63
74
  // a pas, comme pour les formulaires du core.
64
75
  async personneDuFormulaire(requete) {
package/src/theme.js CHANGED
@@ -1,4 +1,4 @@
1
- // Le thème du client, que sert le core (docs/architecture.md, « L'espace et les réglages ») : ses
1
+ // Le thème du client, que sert le core (docs/architecture.md, « L'espace ») : ses
2
2
  // variables CSS, lues à CORE_ADRESSE et gardées une minute. Si le core ne répond pas, le thème est
3
3
  // vide et la page garde les couleurs du navigateur. `horloge` ne sert qu'aux tests.
4
4
  export function creerLeLecteurDuTheme(adresseDuCore = process.env.CORE_ADRESSE, horloge = Date.now) {