@indos/bibliotheque 1.2.0 → 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,18 @@
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
+
5
17
  ## 1.2.0
6
18
 
7
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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "1.2.0",
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;
@@ -3,47 +3,38 @@ import { Outlet, useLocation, useMatches } from '@tanstack/react-router';
3
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
- // Un écran qui attend ses données laisse la barre affichée.
43
- 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 }) {
44
35
  const piece = usePiece();
45
36
  const pleineLargeur = useMatches({ select: (routes) => routes.some((route) => route.staticData?.pleineLargeur === true) });
46
- 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: _jsx("div", { className: pleineLargeur ? undefined : 'max-w-[880px]', children: _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] })] }) }) })] })] }) }));
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] })] })] }) })] })] }));
47
38
  }
48
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
49
40
  // barre. Elle se replie quand on change d'écran.
@@ -63,15 +54,13 @@ function Marque({ session, active }) {
63
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" }) }))
64
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 })] }));
65
56
  }
66
- function GroupeDeLaBarre({ titre, children }) {
67
- 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] }));
68
- }
69
57
  // Une entrée d'une barre ; l'active, le point à l'accent.
70
58
  function EntreeDeLaBarre({ chemin, active, children }) {
71
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 }));
72
60
  }
73
- // Le nom de la personne, en bas de la barre de l'espace, qui ouvre son menu : son courriel,
74
- // « 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.
75
64
  function MenuDeLaPersonne({ session }) {
76
- 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" }) }) })] })] }) }));
77
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';
@@ -11,7 +11,7 @@ declare module '@tanstack/react-router' {
11
11
  }
12
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
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-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>;
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<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>, 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-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,7 +4,7 @@ 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
10
  import { requeteDeLaSession, sessionDeLaPage, useSession } from './session.js';
@@ -19,7 +19,9 @@ export const racine = createRootRouteWithContext()({
19
19
  notFoundComponent: Introuvable,
20
20
  });
21
21
  export const coquilleDeLEspace = createRoute({ getParentRoute: () => racine, id: 'coquille-de-l-espace', component: CoquilleDeLEspace });
22
- 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;
23
25
  // Le favicon est le logo du thème quand il y en a un ; sinon, celui, vide, de la page construite.
24
26
  // Les liens des composants (`Lien`) s'ouvrent dans la page vers une route de la page.
25
27
  function Racine() {
@@ -34,11 +36,7 @@ function reessayer(essais, erreur) {
34
36
  export function creerLaPage(options) {
35
37
  poserLaBase(options.base);
36
38
  const client = new QueryClient({ defaultOptions: { queries: { retry: reessayer } } });
37
- const dans = (coquille) => options.ecrans.filter((ecran) => ecran.options.getParentRoute?.() === coquille);
38
- const routeTree = racine.addChildren([
39
- coquilleDeLEspace.addChildren(dans(coquilleDeLEspace)),
40
- coquilleDesReglages.addChildren(dans(coquilleDesReglages)),
41
- ]);
39
+ const routeTree = racine.addChildren([coquilleDeLEspace.addChildren(options.ecrans)]);
42
40
  const router = createRouter({
43
41
  routeTree,
44
42
  context: { client },
@@ -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/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) {