@indos/bibliotheque 1.13.0 → 2.0.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.
Files changed (48) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/package.json +1 -1
  3. package/src/direct/page.d.ts +1 -2
  4. package/src/espace/apercu.d.ts +9 -0
  5. package/src/espace/apercu.js +105 -0
  6. package/src/espace/cadre.d.ts +12 -0
  7. package/src/espace/cadre.js +21 -10
  8. package/src/espace/choses.d.ts +19 -7
  9. package/src/espace/choses.js +21 -9
  10. package/src/espace/coquille.d.ts +4 -0
  11. package/src/espace/coquille.js +44 -34
  12. package/src/espace/direct.d.ts +9 -0
  13. package/src/espace/direct.js +20 -4
  14. package/src/espace/ecran-d-une-chose.d.ts +0 -4
  15. package/src/espace/ecran-d-une-chose.js +40 -30
  16. package/src/espace/ecran.d.ts +1 -2
  17. package/src/espace/ecran.js +7 -6
  18. package/src/espace/formulaire-d-une-fiche.js +4 -5
  19. package/src/espace/index.d.ts +6 -7
  20. package/src/espace/index.js +5 -6
  21. package/src/espace/lien.d.ts +4 -4
  22. package/src/espace/lien.js +3 -5
  23. package/src/espace/liste-des-choses.js +86 -24
  24. package/src/espace/menu-d-une-chose.d.ts +2 -1
  25. package/src/espace/menu-d-une-chose.js +14 -11
  26. package/src/espace/ouvrir.d.ts +1 -4
  27. package/src/espace/ouvrir.js +5 -13
  28. package/src/espace/page.d.ts +0 -2
  29. package/src/espace/page.js +0 -3
  30. package/src/espace/panneau-du-partage.d.ts +9 -8
  31. package/src/espace/panneau-du-partage.js +130 -46
  32. package/src/espace/routes-des-choses.js +2 -2
  33. package/src/forme-du-direct.d.ts +1 -0
  34. package/src/partage.d.ts +7 -2
  35. package/src/partage.js +26 -7
  36. package/src/ui/direct.d.ts +4 -2
  37. package/src/ui/direct.js +2 -2
  38. package/src/ui/icones.d.ts +6 -0
  39. package/src/ui/icones.js +8 -0
  40. package/src/ui/index.d.ts +1 -1
  41. package/src/ui/index.js +1 -1
  42. package/src/ui/menu-d-une-ligne.js +1 -1
  43. package/src/ui/tableau.d.ts +3 -1
  44. package/src/ui/tableau.js +10 -5
  45. package/src/espace/barre-de-la-liste.d.ts +0 -6
  46. package/src/espace/barre-de-la-liste.js +0 -78
  47. package/src/espace/heure.d.ts +0 -1
  48. package/src/espace/heure.js +0 -6
package/CHANGELOG.md CHANGED
@@ -2,6 +2,37 @@
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
+ ## 2.0.0
6
+
7
+ La tête d'une chose, son partage et sa liste, les mêmes dans toutes les apps.
8
+
9
+ - La barre de gauche est toujours celle de l'OS : la barre de la liste disparaît. Un clic sur une ligne de la liste ouvre la chose dans l'aperçu, posé par-dessus la liste, à droite (`?apercu=<id>` dans la recherche de la liste) ; ↑ ↓ passent d'une chose à l'autre, Entrée l'ouvre en grand, Échap ferme ; le carré en tête de la ligne, ou un double-clic, l'ouvre en grand. L'aperçu est l'écran de la chose, le même, dans un panneau de 380 à 680 px : un corps se garde lisible en étroit. Une app qui écrit sa route de liste à la main lui donne `validateSearch: rechercheDeLaListe` et rend `ListeDesChoses`, qui monte l'aperçu. `Tableau` prend `onOuvrirEnGrand` et `ligneOuverte` ; `IconeAgrandir` et `IconeFermer` rejoignent les icônes.
10
+ - La ligne du haut porte les onglets de l'app : le premier au titre de l'app, puis « Réglages » et « Documentation » ; l'onglet actif est le `<h1>`, que rend la coquille. Une app sans écran fait précéder ses onglets de son titre (« Agenda / Réglages · Documentation »). L'épingle est tout à droite de la ligne, et non dans le fil.
11
+ - Sur une chose, le fil « App / Nom » (« App / Mandats / Nom » pour une chose qui déclare `liste`), puis à droite, et seulement, le bloc de l'accès, l'épingle et le ⋯.
12
+ - La ligne de tête du corps : `etatDeLaChose(chose)` à gauche, en gris (« Brouillon · échéance le 30.11.2026 ») ; à droite, « Modifier » (le `formulaire` d'une fiche) puis `gestes(chose)`, chaque geste un composant autonome qui porte sa fenêtre, sa mutation et sa relecture.
13
+ - Le bloc de l'accès, `BlocDeLAcces` : qui voit la chose (le cadenas, les personnes et leur nombre, le globe d'une chose publiée), puis les présents, une pastille chacun, avec le point vert ; « Reconnexion… » ou « Lecture » à sa gauche, hors du nominal seulement. Le corps déclare son direct en données, `useDeclarerLeDirect({ etat, personnes, lecture })`. Le bloc ouvre le panneau du partage ; quand l'app déclare `lirePartage` sans `partager`, comme une facture qui montre le partage de son mandat, il se lit sans s'ouvrir.
14
+ - Le ⋯, le même ordre dans la liste et sur la chose : Ouvrir et Ouvrir en grand (dans la liste), « Ouvrir à part ↗ » (`aPart(chose)`, une adresse que l'app sert, la chose avec la session), le rendu (`rendu(chose)`, `{ libelle, adresse }`, comme « PDF ↗ »), Partager… et Renommer (dans la liste ; Partager… quand l'app déclare `partager`), `gestesDuMenu`, Donner à…, l'épingle (dans la liste), Supprimer.
15
+ - Le panneau du partage a deux parties : « Dans l'équipe », et « Hors de l'équipe » quand l'app déclare `publier`, avec ses mots, `publication: { phrase, verbe, fermer, etiquette, etiquetteNonPubliee, consequence }` (par défaut « Quiconque a le lien la voit, en lecture, sans compte. », « Publier », « Ne plus publier », « Publiée ») ; publiée, l'adresse publique en lien, son icône qui la copie (« Lien public copié. ») et le lien discret qui la ferme. La colonne de la liste dit « <partage> · <etiquette> » (« Privée · Publiée »).
16
+ - La vue des publiées : `vuesDuPartage(feminin, { publiees: true })` à l'écran ; côté serveur, `creerLePartage({ publication: '<colonne>' })` fait entrer `publiees` dans `chercher` et dans `partage.schemaDeChercher()`.
17
+
18
+ ### Ruptures
19
+
20
+ - `geste(chose)` est retiré : les gestes de l'app vont dans `gestes(chose)`, et son état dans `etatDeLaChose(chose)`, sur la ligne de tête du corps. « Modifier » y vient du `formulaire` : l'app ne rend plus `<ModifierLaFiche />` dans son corps.
21
+ - `pleinePage` et `libelleDeLaPleinePage` sont retirés : `rendu: (chose) => ({ libelle, adresse })` pour ce qu'on donne hors de l'écran (un PDF, un QR code), ou `aPart: (chose) => adresse` pour la chose elle-même hors du cadre, avec la session (le lecteur d'une présentation).
22
+ - `sousLigne` est retiré : l'aperçu montre la chose.
23
+ - `DansLEtatDuDirect` est retiré : le corps déclare son direct par `useDeclarerLeDirect({ etat, personnes, lecture })`, que le bloc de l'accès dessine. `EtatEtPresences` reste dans `@indos/bibliotheque/ui`, pour une page hors de l'espace, comme celle d'un invité.
24
+ - `DansLesGestes` n'est plus exporté : rien de l'app n'entre dans la ligne du haut.
25
+ - `Ecran.action` est retiré : les gestes d'un onglet vont dans son contenu.
26
+ - `coquilleDesReglages` est retirée : la route des réglages se déclare sous `coquilleDeLEspace`. `staticData: { pleineLargeur: true }` est retiré : `pleineHauteur`. `heureDeSuisse` est retirée : `jourEtHeure`, de `@indos/bibliotheque/format`.
27
+ - `PastilleDeLAcces` est retirée : `BlocDeLAcces`.
28
+ - Les mots de `publication` sont `phrase`, `verbe`, `fermer`, `etiquette`, `etiquetteNonPubliee` et `consequence` : `titre` est retiré.
29
+ - Les mots par défaut de la publication sont « Publier », « Ne plus publier », la phrase « Quiconque a le lien la voit, en lecture, sans compte. » et l'étiquette « Publiée » : un test qui cherchait « Ouvrir le lien », « Fermer le lien » ou « Par un lien » les cherche par ces mots.
30
+ - « Partager… », dans le ⋯ d'une ligne, ne s'offre que si l'app déclare `partager` : une app qui déclare `lirePartage` seul n'a plus d'entrée pour ouvrir le panneau en lecture depuis la liste ; le bloc de l'accès de l'aperçu et de l'écran se lit sans s'ouvrir.
31
+ - Un test qui ouvrait une chose d'un clic sur sa ligne clique « Ouvrir « <nom> » en grand », ou lit l'aperçu (`complementary`, « Aperçu ») ; le titre d'un onglet se lit dans la ligne du haut (`navigation`, « Onglets ») ; le fil d'une chose est « App / Nom ».
32
+ - Les versions de React (19.3.1), Vite (8.3.5) et TanStack (`@tanstack/react-router` 1.170.44, `@tanstack/react-query` 5.104.2) ne changent pas ; `npm view @indos/bibliotheque@2.0.0 peerDependencies` les donne toutes.
33
+ - Le core 2.4 ou plus récent, dans sa majeure 2 : `"core": ">=2.4 <3"` dans `dependances.core` du `module.json` de l'app.
34
+ - Pour monter : `"@indos/bibliotheque": "2.0.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
35
+
5
36
  ## 1.13.0
6
37
 
7
38
  - Le direct Yjs, écrit une fois pour toutes les apps où l'on écrit une chose à plusieurs, dans sa propre entrée : `@indos/bibliotheque/direct` pour le serveur, `creerLeDirectYjs`, et `@indos/bibliotheque/direct/page` pour la page, `ouvrirUnDirectYjs`. L'app donne le droit d'une personne sur une chose, sa chose publiée, l'état en base et son écriture ; la bibliothèque fait le contrôle à l'ouverture, sous le domaine comme sur l'hôte public, la taille des messages, le battement, la relecture du droit après un partage, un don ou une suppression, la chose pleine, l'écriture de Claude, la reconnexion et « réessayez ».
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "1.13.0",
3
+ "version": "2.0.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",
@@ -1,7 +1,6 @@
1
1
  import { HocuspocusProvider } from '@hocuspocus/provider';
2
2
  import * as Y from 'yjs';
3
- import { type Invite } from '../forme-du-direct.ts';
4
- import type { EtatDeLaConnexion } from '../ui/direct.tsx';
3
+ import { type EtatDeLaConnexion, type Invite } from '../forme-du-direct.ts';
5
4
  export { codes, estUneChoseAbsente, ongletsDesAutres, personneDeLEtat, personnesDesAutres, raisons, type Invite, type OngletPresent, } from '../forme-du-direct.ts';
6
5
  export type EtatDuDirect = {
7
6
  sorte: EtatDeLaConnexion;
@@ -0,0 +1,9 @@
1
+ import type { ChoseTrouvee, DeclarationDesChoses } from './choses.ts';
2
+ export declare function ApercuDUneChose<C extends ChoseTrouvee>({ choses, id, chemin: cheminDeLaLigne, fermer, passer, quitter }: {
3
+ choses: DeclarationDesChoses<C>;
4
+ id: string;
5
+ chemin?: string;
6
+ fermer: () => void;
7
+ passer: (sens: 1 | -1) => void;
8
+ quitter: () => void;
9
+ }): import("react").JSX.Element;
@@ -0,0 +1,105 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { useEffect, useMemo, useRef, useState } from 'react';
3
+ import { IconeAgrandir, IconeFermer } from '../ui/icones.js';
4
+ import { ContexteDuCadre } from './cadre.js';
5
+ import { EpingleDuCadre } from './coquille.js';
6
+ import { EcranDUneChose } from './ecran-d-une-chose.js';
7
+ import { LienDansLaPage } from './lien.js';
8
+ import { useOuvrir } from './ouvrir.js';
9
+ // L'aperçu d'une chose, par-dessus sa liste (docs/architecture.md, « L'espace ») : l'écran de la
10
+ // chose, le même, en étroit, dans un panneau posé à droite de la zone de l'écran, sur toute sa
11
+ // hauteur, ligne du haut comprise, une ombre sur son bord gauche, sans voile : la liste reste
12
+ // utilisable et ne bouge pas. 55 % de la zone au plus, 680 px au plus, 380 px au moins ; sous
13
+ // 760 px, tout l'écran. Il apparaît net, sans glisser.
14
+ //
15
+ // Sa tête est celle d'une chose, dans le cadre que le panneau donne à l'écran de la chose : le nom à
16
+ // gauche (un `<h2>`, renommable), puis le bloc de l'accès, l'épingle de la chose, le ⋯, un trait,
17
+ // « Agrandir », qui mène à son écran, et « Fermer ». Son pied dit le clavier : ↑ ↓ passent à la ligne
18
+ // voisine (`passer`), Entrée agrandit, Échap ferme (`toucheDeLApercu`). Le focus va au titre à
19
+ // l'ouverture. La liste tient l'adresse (`apercu`) et le focus qui revient à la ligne.
20
+ // Les icônes de la tête, de 28 px comme l'épingle et le ⋯ ; le survol ne change que la couleur.
21
+ const classesDUneIcone = 'grid size-7 flex-none cursor-pointer place-items-center rounded-md border-0 bg-transparent text-gris no-underline hover:bg-survol hover:text-encre';
22
+ // Le corps de la chose dans l'aperçu, que rend l'app : ses touches restent les siennes.
23
+ const attributDuCorps = 'data-corps-de-l-apercu';
24
+ export function ApercuDUneChose({ choses, id, chemin: cheminDeLaLigne, fermer, passer, quitter }) {
25
+ const ouvrir = useOuvrir();
26
+ const [fin, setFin] = useState(null);
27
+ const [gestes, setGestes] = useState(null);
28
+ const [menu, setMenu] = useState(null);
29
+ const [ecran, setEcran] = useState({});
30
+ // Le cadre ne change qu'avec ses emplacements : `quitter` se lit au moment où la chose part.
31
+ const quitterMaintenant = useRef(quitter);
32
+ quitterMaintenant.current = quitter;
33
+ const cadre = useMemo(() => ({ fin, gestes, menu, declarer: setEcran, apercu: { quitter: () => quitterMaintenant.current() } }), [fin, gestes, menu]);
34
+ const chemin = ecran.introuvable ? undefined : ecran.chemin ?? cheminDeLaLigne;
35
+ // Le focus au titre, une fois la chose lue ou dite introuvable, sans faire défiler la page.
36
+ const focalise = useRef(false);
37
+ useEffect(() => {
38
+ if (focalise.current || !fin || (ecran.nom === undefined && !ecran.introuvable)) {
39
+ return;
40
+ }
41
+ const titre = fin.querySelector('h2');
42
+ if (titre) {
43
+ focalise.current = true;
44
+ titre.focus({ preventScroll: true });
45
+ }
46
+ }, [fin, ecran.nom, ecran.introuvable]);
47
+ useEffect(() => {
48
+ function touche(evenement) {
49
+ const geste = toucheDeLApercu(evenement);
50
+ if (!geste || (geste === 'agrandir' && !chemin)) {
51
+ return;
52
+ }
53
+ evenement.preventDefault();
54
+ if (geste === 'fermer') {
55
+ fermer();
56
+ }
57
+ else if (geste === 'agrandir') {
58
+ ouvrir(chemin);
59
+ }
60
+ else {
61
+ passer(geste === 'suivante' ? 1 : -1);
62
+ }
63
+ }
64
+ document.addEventListener('keydown', touche);
65
+ return () => document.removeEventListener('keydown', touche);
66
+ }, [chemin, fermer, passer, ouvrir]);
67
+ return (_jsx("aside", { "aria-label": "Aper\u00E7u", className: [
68
+ 'absolute inset-y-0 right-0 z-30 w-[min(55%,680px)] min-w-[380px] border-l border-trait bg-papier text-encre shadow-[-16px_0_40px_rgb(0_0_0/0.12)]',
69
+ 'max-[760px]:fixed max-[760px]:inset-0 max-[760px]:w-auto max-[760px]:min-w-0 max-[760px]:border-l-0 max-[760px]:shadow-none',
70
+ ].join(' '), children: _jsxs("div", { className: "sticky top-0 flex h-dvh max-h-full flex-col pt-4 max-[760px]:max-h-none max-[760px]:pt-3", children: [_jsxs("div", { className: "flex min-h-11 flex-none items-center gap-x-3 px-5 shadow-[inset_0_-1px_0_var(--color-trait)] max-[760px]:px-3", children: [_jsx("div", { ref: setFin, className: "flex min-w-0 flex-1 items-center gap-2 text-[15px]" }), _jsxs("div", { className: "flex flex-none items-center gap-1", children: [_jsx("div", { ref: setGestes, className: "flex items-center gap-2 empty:hidden" }), chemin && _jsx(EpingleDuCadre, { chemin: chemin, nom: ecran.nom }, chemin), _jsx("div", { ref: setMenu, className: "flex items-center empty:hidden" }), _jsx("span", { "aria-hidden": "true", className: "mx-1.5 h-[18px] w-px bg-trait" }), chemin && (_jsx(LienDansLaPage, { href: chemin, "aria-label": "Agrandir", title: "Agrandir", className: classesDUneIcone, children: _jsx(IconeAgrandir, {}) })), _jsx("button", { type: "button", "aria-label": "Fermer l'aper\u00E7u", title: "Fermer", onClick: fermer, className: classesDUneIcone, children: _jsx(IconeFermer, {}) })] })] }), _jsx("div", { [attributDuCorps]: '', className: "flex min-h-0 flex-1 flex-col overflow-y-auto px-5 pt-3.5 pb-6 max-[760px]:px-3", children: _jsx(ContexteDuCadre.Provider, { value: cadre, children: _jsx(EcranDUneChose, { choses: choses, id: id }, id) }) }), _jsxs("p", { className: "m-0 flex flex-none flex-wrap items-center gap-x-2 border-t border-trait px-5 py-1.5 text-[12px] text-gris max-[760px]:hidden", children: [_jsxs("span", { children: [_jsx(Touche, { children: "\u2191" }), " ", _jsx(Touche, { children: "\u2193" }), " pr\u00E9c\u00E9dent / suivant"] }), _jsx("span", { "aria-hidden": "true", children: "\u00B7" }), _jsxs("span", { children: [_jsx(Touche, { children: "Entr\u00E9e" }), " agrandir"] }), _jsx("span", { "aria-hidden": "true", children: "\u00B7" }), _jsxs("span", { children: [_jsx(Touche, { children: "\u00C9chap" }), " fermer"] })] })] }) }));
71
+ }
72
+ function Touche({ children }) {
73
+ return _jsx("kbd", { className: "rounded-[4px] border border-b-2 border-trait px-1 font-mono text-[11px]", children: children });
74
+ }
75
+ // Ce qui garde ses touches : un champ, un éditeur, une liste de choix, une fenêtre, un menu, un cadre.
76
+ const champsEtFenetres = [
77
+ 'input', 'textarea', 'select', '[contenteditable]:not([contenteditable=false])', 'iframe',
78
+ '[role=dialog]', '[role=alertdialog]', '[role=menu]', '[role=listbox]', '[role=combobox]', '[role=textbox]', '[role=grid]', '[role=application]',
79
+ ].join(', ');
80
+ // Ce qui fait son geste à Entrée : un lien, un bouton.
81
+ const elementsAEntree = 'a, button, summary, [role=button], [role=link], [role=tab], [role=menuitem]';
82
+ // La touche d'un aperçu ouvert, hors d'un champ, d'un éditeur ou d'une fenêtre : ↑ ↓ passent à la
83
+ // ligne voisine, Entrée agrandit, Échap ferme. Dans le corps de la chose, que l'app rend, ↑ ↓ et
84
+ // Entrée restent au corps ; Entrée sur un lien ou un bouton fait son geste.
85
+ function toucheDeLApercu(evenement) {
86
+ if (evenement.defaultPrevented || evenement.altKey || evenement.ctrlKey || evenement.metaKey || evenement.shiftKey || evenement.isComposing) {
87
+ return undefined;
88
+ }
89
+ const touches = { ArrowUp: 'precedente', ArrowDown: 'suivante', Enter: 'agrandir', Escape: 'fermer' };
90
+ const touche = touches[evenement.key];
91
+ if (!touche) {
92
+ return undefined;
93
+ }
94
+ const cible = evenement.target instanceof Element ? evenement.target : null;
95
+ if (cible?.closest(champsEtFenetres)) {
96
+ return undefined;
97
+ }
98
+ if (touche !== 'fermer' && cible?.closest(`[${attributDuCorps}]`)) {
99
+ return undefined;
100
+ }
101
+ if (touche === 'agrandir' && cible?.closest(elementsAEntree)) {
102
+ return undefined;
103
+ }
104
+ return touche;
105
+ }
@@ -24,11 +24,16 @@ export declare function cadreDe(session: Session, ici: string): CadreDeLaPage;
24
24
  export type EcranDeclare = {
25
25
  nom?: string;
26
26
  introuvable?: boolean;
27
+ chemin?: string;
27
28
  };
28
29
  export type Cadre = {
29
30
  fin: HTMLElement | null;
30
31
  gestes: HTMLElement | null;
32
+ menu: HTMLElement | null;
31
33
  declarer: (ecran: EcranDeclare) => void;
34
+ apercu?: {
35
+ quitter: () => void;
36
+ };
32
37
  };
33
38
  export declare const ContexteDuCadre: import("react").Context<Cadre | null>;
34
39
  export declare function useCadre(): Cadre | null;
@@ -39,8 +44,15 @@ export declare function DansLeFil({ children }: {
39
44
  export declare function DansLesGestes({ children }: {
40
45
  children: ReactNode;
41
46
  }): import("react").ReactPortal | null;
47
+ export declare function DansLeMenu({ children }: {
48
+ children: ReactNode;
49
+ }): import("react").ReactPortal | null;
42
50
  export declare const separateurDuFil: import("react").JSX.Element;
43
51
  export declare const classesDuTitre = "m-0 min-w-0 truncate text-[15px] leading-[1.4] font-semibold text-encre";
52
+ export declare function useTitreDuCadre(): {
53
+ Balise: 'h1' | 'h2';
54
+ tabIndex?: number;
55
+ };
44
56
  export declare function TitreDuFil({ children }: {
45
57
  children: ReactNode;
46
58
  }): import("react").JSX.Element;
@@ -10,11 +10,11 @@ export function appDuChemin(session, ici) {
10
10
  const nom = premier === 'documentation' ? second : premier;
11
11
  return session.apps.find((app) => app.nom === nom);
12
12
  }
13
- // Les onglets d'une app, dans leur ordre : ses écrans, « Réglages » quand la personne a le droit de
14
- // les voir, et « Documentation ».
13
+ // Les onglets d'une app, dans leur ordre : ses écrans, le premier sous le titre de l'app, « Réglages »
14
+ // quand la personne a le droit de les voir, et « Documentation ».
15
15
  export function ongletsDe(app) {
16
16
  return [
17
- ...app.ecrans.map((ecran) => ({ titre: ecran.titre, chemin: ecran.chemin })),
17
+ ...app.ecrans.map((ecran, rang) => ({ titre: rang === 0 ? app.titre : ecran.titre, chemin: ecran.chemin })),
18
18
  ...(app.reglages ? [{ titre: 'Réglages', chemin: `/${app.nom}/reglages` }] : []),
19
19
  { titre: 'Documentation', chemin: `/documentation/${app.nom}` },
20
20
  ];
@@ -32,7 +32,8 @@ function lienDeLOnglet(app, onglet) {
32
32
  }
33
33
  // Le cadre d'une page. Sur une page d'une app : le titre de l'app, puis l'onglet actif quand son
34
34
  // titre n'est pas celui de l'app, puis, sur un écran qui n'est pas l'onglet lui-même, le titre que
35
- // l'écran donne. Sur une page du core, le titre de l'écran seul.
35
+ // l'écran donne. Sur une page du core, le titre de l'écran seul. Sur un onglet, la coquille rend le
36
+ // `<h1>` elle-même, à l'onglet actif.
36
37
  export function cadreDe(session, ici) {
37
38
  const app = appDuChemin(session, ici);
38
39
  if (!app) {
@@ -73,17 +74,17 @@ export function useCadre() {
73
74
  // L'écran dit ce que la coquille ne sait pas de lui, tant qu'il est rendu.
74
75
  export function useDeclarerLEcran(ecran) {
75
76
  const cadre = useCadre();
76
- const { nom, introuvable } = ecran;
77
+ const { nom, introuvable, chemin } = ecran;
77
78
  useEffect(() => {
78
79
  if (!cadre) {
79
80
  return undefined;
80
81
  }
81
- cadre.declarer({ nom, introuvable });
82
+ cadre.declarer({ nom, introuvable, chemin });
82
83
  return () => cadre.declarer({});
83
- }, [cadre?.declarer, nom, introuvable]);
84
+ }, [cadre?.declarer, nom, introuvable, chemin]);
84
85
  }
85
- // Rendre à la fin du fil, et dans les gestes de l'écran : par un portail, dans l'emplacement que
86
- // donne la coquille.
86
+ // Rendre à la fin du fil, dans les gestes de l'écran, avant l'épingle, et dans le menu, après elle :
87
+ // par un portail, dans l'emplacement que donne la coquille.
87
88
  export function DansLeFil({ children }) {
88
89
  const cadre = useCadre();
89
90
  return cadre?.fin ? createPortal(children, cadre.fin) : null;
@@ -92,9 +93,19 @@ export function DansLesGestes({ children }) {
92
93
  const cadre = useCadre();
93
94
  return cadre?.gestes ? createPortal(children, cadre.gestes) : null;
94
95
  }
96
+ export function DansLeMenu({ children }) {
97
+ const cadre = useCadre();
98
+ return cadre?.menu ? createPortal(children, cadre.menu) : null;
99
+ }
95
100
  // Le séparateur du fil, et le dernier segment, le `<h1>` de l'écran.
96
101
  export const separateurDuFil = _jsx("span", { "aria-hidden": "true", className: "text-trait-champ max-[760px]:hidden", children: "/" });
97
102
  export const classesDuTitre = 'm-0 min-w-0 truncate text-[15px] leading-[1.4] font-semibold text-encre';
103
+ // La balise du titre : le `<h1>` de l'écran ; dans un aperçu, sous le `<h1>` de la liste, un `<h2>`
104
+ // que le panneau focalise à son ouverture.
105
+ export function useTitreDuCadre() {
106
+ return useCadre()?.apercu ? { Balise: 'h2', tabIndex: -1 } : { Balise: 'h1' };
107
+ }
98
108
  export function TitreDuFil({ children }) {
99
- return _jsx("h1", { className: classesDuTitre, children: children });
109
+ const { Balise, tabIndex } = useTitreDuCadre();
110
+ return _jsx(Balise, { tabIndex: tabIndex, className: classesDuTitre, children: children });
100
111
  }
@@ -82,9 +82,7 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
82
82
  titre: string;
83
83
  valeur: (chose: C) => ReactNode;
84
84
  } | false;
85
- sousLigne?: (chose: C) => ReactNode;
86
85
  plein?: boolean;
87
- libelleDeLaPleinePage?: string;
88
86
  publication?: MotsDeLaPublication;
89
87
  consequenceDeLaSuppression?: string | ((chose: C) => string | undefined);
90
88
  motsDeLaSuppression?: (chose: C) => MotsDUnGeste;
@@ -97,7 +95,10 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
97
95
  chercher?: (critere: CritereDeRecherche) => Promise<ChosesTrouvees<C>>;
98
96
  lire: (id: string) => Promise<C | undefined>;
99
97
  corps: (chose: C) => ReactNode;
100
- pleinePage?: (chose: C) => string | undefined;
98
+ etatDeLaChose?: (chose: C) => ReactNode;
99
+ gestes?: (chose: C) => ReactNode;
100
+ rendu?: (chose: C) => RenduDUneChose | undefined;
101
+ aPart?: (chose: C) => string | undefined;
101
102
  renommer?: (chose: C, nom: string) => Promise<unknown>;
102
103
  supprimer?: (chose: C) => Promise<unknown>;
103
104
  peutSupprimer?: (chose: C) => boolean;
@@ -117,20 +118,31 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
117
118
  } | undefined | void>;
118
119
  formulaire?: FormulaireDUneFicheDeclare<C>;
119
120
  gestesDeLaListe?: ReactNode;
120
- geste?: (chose: C) => ReactNode;
121
+ };
122
+ export type RenduDUneChose = {
123
+ libelle: string;
124
+ adresse: string;
121
125
  };
122
126
  export type MotsDeLaPublication = {
123
- titre?: string;
127
+ phrase?: string;
124
128
  verbe?: string;
125
129
  fermer?: string;
130
+ etiquette?: string;
131
+ etiquetteNonPubliee?: string;
126
132
  consequence?: string;
127
133
  };
128
- export declare function motsDeLaPublication(publication?: MotsDeLaPublication): Required<MotsDeLaPublication>;
129
- export declare function vuesDuPartage(feminin?: boolean): VueDeLaListe[];
134
+ export declare function motsDeLaPublication(publication?: MotsDeLaPublication, declaration?: {
135
+ une: string;
136
+ feminin?: boolean;
137
+ }): Required<Omit<MotsDeLaPublication, 'etiquetteNonPubliee'>>;
138
+ export declare function vuesDuPartage(feminin?: boolean, { publiees }?: {
139
+ publiees?: boolean;
140
+ }): VueDeLaListe[];
130
141
  export type RechercheDeLaListe = {
131
142
  texte?: string;
132
143
  vue?: string;
133
144
  page?: number;
145
+ apercu?: string;
134
146
  };
135
147
  export declare function rechercheDeLaListe(recherche: Record<string, unknown>): RechercheDeLaListe;
136
148
  export declare function critereDeLaListe(vues: VueDeLaListe[] | undefined, recherche: RechercheDeLaListe): CritereDeRecherche;
@@ -1,33 +1,45 @@
1
1
  import { useQueryClient } from '@tanstack/react-query';
2
2
  import { jourEtHeure } from '../format.js';
3
3
  import { appeler, texteDe } from './appels.js';
4
- // Les mots de la publication d'une app, ses défauts compris.
5
- export function motsDeLaPublication(publication = {}) {
4
+ // Les mots de la publication d'une app, ses défauts compris, au genre de la chose : « Quiconque a le
5
+ // lien la voit, en lecture, sans compte. », « Publier », « Ne plus publier », « Publiée ». Sans
6
+ // phrase, celle de la conséquence ; sans conséquence, la question reprend la phrase.
7
+ export function motsDeLaPublication(publication = {}, declaration = { une: 'chose', feminin: true }) {
8
+ const { e, pronom } = motsDe(declaration);
9
+ const phrase = publication.phrase ?? publication.consequence ?? `Quiconque a le lien ${pronom} voit, en lecture, sans compte.`;
6
10
  return {
7
- titre: publication.titre ?? 'Par un lien',
8
- verbe: publication.verbe ?? 'Ouvrir le lien',
9
- fermer: publication.fermer ?? 'Fermer le lien',
10
- consequence: publication.consequence ?? 'Toute personne qui a le lien y accède, sans compte.',
11
+ phrase,
12
+ verbe: publication.verbe ?? 'Publier',
13
+ fermer: publication.fermer ?? 'Ne plus publier',
14
+ etiquette: publication.etiquette ?? `Publié${e}`,
15
+ consequence: publication.consequence ?? phrase,
11
16
  };
12
17
  }
13
- // Les vues d'une app qui partage : toutes, à moi, partagées avec moi.
14
- export function vuesDuPartage(feminin = false) {
18
+ // Les vues d'une app qui partage : toutes, à moi, partagées avec moi ; avec `publiees`, pour une app
19
+ // à lien public, les publiées, que `chercher` connaît quand son partage déclare sa colonne
20
+ // (`creerLePartage({ publication })`).
21
+ export function vuesDuPartage(feminin = false, { publiees = false } = {}) {
15
22
  return [
16
23
  { valeur: 'toutes', titre: feminin ? 'Toutes' : 'Tous' },
17
24
  { valeur: 'a_moi', titre: 'À moi' },
18
25
  { valeur: 'partagees', titre: feminin ? 'Partagées avec moi' : 'Partagés avec moi' },
26
+ ...(publiees ? [{ valeur: 'publiees', titre: feminin ? 'Publiées' : 'Publiés' }] : []),
19
27
  ];
20
28
  }
29
+ // La recherche de la liste dans l'adresse : le texte, la vue, la page, et `apercu`, l'identifiant de
30
+ // la chose que montre l'aperçu, gardé en texte même quand il s'écrit comme un nombre.
21
31
  export function rechercheDeLaListe(recherche) {
22
32
  const page = Number(recherche.page);
33
+ const apercu = typeof recherche.apercu === 'number' ? String(recherche.apercu) : recherche.apercu;
23
34
  return {
24
35
  ...(typeof recherche.texte === 'string' && recherche.texte ? { texte: recherche.texte } : {}),
25
36
  ...(typeof recherche.vue === 'string' && recherche.vue ? { vue: recherche.vue } : {}),
26
37
  ...(Number.isInteger(page) && page > 1 ? { page } : {}),
38
+ ...(typeof apercu === 'string' && apercu ? { apercu } : {}),
27
39
  };
28
40
  }
29
41
  // Le critère que `chercher` reçoit pour une recherche de la liste : la vue par défaut ne s'y dit
30
- // pas. La liste et la barre de la liste le lisent sous la même clé.
42
+ // pas.
31
43
  export function critereDeLaListe(vues, recherche) {
32
44
  const premiere = vues?.[0]?.valeur;
33
45
  const vue = recherche.vue && vues?.some((une) => une.valeur === recherche.vue) ? recherche.vue : undefined;
@@ -1,5 +1,9 @@
1
1
  import { type Session } from './session.ts';
2
2
  export declare function CoquilleDeLEspace(): import("react").JSX.Element;
3
+ export declare function EpingleDuCadre({ chemin, nom }: {
4
+ chemin: string;
5
+ nom?: string;
6
+ }): import("react").JSX.Element;
3
7
  export declare function PiedDeLaBarre({ session, surLesApps }: {
4
8
  session: Session;
5
9
  surLesApps: boolean;
@@ -8,16 +8,14 @@ import { EtatDeLecture } from '../ui/etats.js';
8
8
  import { IconeDEpingle, IconeDesApps } from '../ui/icones.js';
9
9
  import { Menu, MenuContenu, MenuDeclencheur, MenuEntree, MenuLibelle, MenuSeparateur } from '../ui/menu.js';
10
10
  import { estEpingle, useEpingle } from './barre.js';
11
- import { BarreDeLaListe } from './barre-de-la-liste.js';
12
11
  import { cadreDe, ContexteDuCadre, sEpingle, separateurDuFil } from './cadre.js';
13
12
  import { cheminDe, entreeActive } from './entree-active.js';
14
13
  import { LienDansLaPage } from './lien.js';
15
- import { ContexteDeLAnnonce, useAnnoncer, useOuvertDepuisLaListe } from './ouvrir.js';
14
+ import { ContexteDeLAnnonce, useAnnoncer } from './ouvrir.js';
16
15
  import { useSession } from './session.js';
17
16
  // La coquille de la page, rendue d'après la session (docs/architecture.md, « L'espace ») : à gauche
18
- // la barre, à la hauteur de l'écran, repliée en menu sur un téléphone ; à droite, le cadre de
19
- // l'écran (`cadre.tsx`) et son contenu, sur toute la largeur. La barre est celle de l'OS, sauf sur
20
- // une chose ouverte depuis la liste de son app, où la liste prend sa place (`BarreDeLaListe`). Un
17
+ // la barre de l'OS, la même sur tout écran, à la hauteur de l'écran, repliée en menu sur un
18
+ // téléphone ; à droite, le cadre de l'écran (`cadre.tsx`) et son contenu, sur toute la largeur. Un
21
19
  // geste fait s'y annonce en bas de l'écran (`useAnnoncer`), d'un écran à l'autre, par-dessus une
22
20
  // fenêtre ou un panneau ouvert. Un écran qui se lit montre l'état de lecture commun.
23
21
  // La largeur sous laquelle la barre se replie en menu, celle du tableau empilé (`ui/theme.css`).
@@ -26,17 +24,9 @@ const etroit = 'min-[761px]:hidden';
26
24
  export function CoquilleDeLEspace() {
27
25
  const session = useSession();
28
26
  const ici = useLocation({ select: (lieu) => lieu.pathname });
29
- const depuisLaListe = useOuvertDepuisLaListe();
30
- const choses = useMatches({ select: (routes) => routes.find((route) => route.staticData?.choses)?.staticData?.choses });
31
27
  const [ecran, setEcran] = useState({});
32
28
  const bas = _jsx(PiedDeLaBarre, { session: session, surLesApps: ici === '/apps' });
33
- const marque = _jsx(Marque, { session: session, active: ici === '/' });
34
- // Une chose ouverte depuis sa liste garde la liste ; une chose introuvable, la barre de l'OS.
35
- const avecLaListe = choses && depuisLaListe && !ecran.introuvable;
36
- const barre = avecLaListe
37
- ? _jsx(BarreDeLaListe, { choses: choses, bas: bas })
38
- : _jsx(BarreDeLOS, { session: session, ici: ici, bas: bas });
39
- return (_jsx(Coquille, { marque: marque, barre: barre, depliee: avecLaListe ? _jsx(BarreDeLaListe, { choses: choses, bas: bas }) : _jsx(BarreDeLOS, { session: session, ici: ici, bas: bas, sansMarque: true }), ecran: ecran, declarer: setEcran }));
29
+ return (_jsx(Coquille, { marque: _jsx(Marque, { session: session, active: ici === '/' }), barre: _jsx(BarreDeLOS, { session: session, ici: ici, bas: bas }), depliee: _jsx(BarreDeLOS, { session: session, ici: ici, bas: bas, sansMarque: true }), ecran: ecran, declarer: setEcran }));
40
30
  }
41
31
  // La barre de l'OS : la marque, qui mène à l'accueil, les entrées de la barre de la personne, l'active
42
32
  // marquée `aria-current="page"` (`entreeActive`), et le pied de la barre.
@@ -45,26 +35,29 @@ function BarreDeLOS({ session, ici, bas, sansMarque = false }) {
45
35
  return (_jsxs(_Fragment, { children: [!sansMarque && _jsx(Marque, { session: session, active: ici === '/' }), _jsx("nav", { "aria-label": "Espace", className: "grid flex-1 content-start gap-px", children: session.barre.map((entree) => (_jsx(EntreeDeLaBarre, { chemin: entree.chemin, active: entree.chemin === active, children: entree.titre }, entree.chemin))) }), bas] }));
46
36
  }
47
37
  // La structure : la barre large, à la hauteur de l'écran ; sur un téléphone, la barre repliée, la
48
- // marque et « Menu », qui déplie la barre en cours ; puis le cadre et le contenu. Le contenu prend
49
- // toute la largeur ; un écran déclaré en pleine hauteur (`staticData: { pleineHauteur: true }`, ou
50
- // `pleineLargeur`), comme une toile, et l'écran d'une chose, ont pour contenu une colonne qui descend
51
- // jusqu'au bas de la fenêtre, où un bloc en `flex-1` prend la hauteur qui reste.
38
+ // marque et « Menu », qui déplie la barre de l'OS ; puis le cadre et le contenu. Le contenu prend
39
+ // toute la largeur ; un écran déclaré en pleine hauteur (`staticData: { pleineHauteur: true }`),
40
+ // comme une toile, et l'écran d'une chose, ont pour contenu une colonne qui descend jusqu'au bas de
41
+ // la fenêtre, où un bloc en `flex-1` prend la hauteur qui reste. La zone de l'écran (`main`) porte
42
+ // l'aperçu d'une liste, posé par-dessus elle, ligne du haut comprise (`apercu.tsx`).
52
43
  function Coquille({ marque, barre, depliee, ecran, declarer }) {
53
- const pleineHauteur = useMatches({ select: (routes) => routes.some((route) => route.staticData?.pleineHauteur === true || route.staticData?.pleineLargeur === true) });
44
+ const pleineHauteur = useMatches({ select: (routes) => routes.some((route) => route.staticData?.pleineHauteur === true) });
54
45
  const ecranDUneChose = useMatches({ select: (routes) => routes.some((route) => route.staticData?.ecranDUneChose === true) });
55
46
  const [annonce, setAnnonce] = useState();
56
47
  const [fin, setFin] = useState(null);
57
48
  const [gestes, setGestes] = useState(null);
58
- const cadre = useMemo(() => ({ fin, gestes, declarer }), [fin, gestes, declarer]);
59
- return (_jsx(ContexteDeLAnnonce.Provider, { value: setAnnonce, children: _jsx(ContexteDuCadre.Provider, { value: cadre, children: _jsxs("div", { className: "grid min-h-dvh grid-cols-[248px_minmax(0,1fr)] max-[760px]:grid-cols-[minmax(0,1fr)]", children: [_jsx("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: barre }), _jsxs("div", { className: "flex min-h-dvh min-w-0 flex-col", children: [_jsx(BarreRepliee, { marque: marque, children: depliee }), _jsxs("main", { className: "flex min-w-0 flex-1 flex-col px-6 pt-4 pb-6 max-[760px]:px-3 max-[760px]:pt-3", children: [_jsx(LigneDuHaut, { ecran: ecran, surUneChose: ecranDUneChose, setFin: setFin, setGestes: setGestes }), _jsx("div", { className: pleineHauteur || ecranDUneChose ? 'flex min-h-0 min-w-0 flex-1 flex-col pt-3.5' : 'min-w-0 pt-3.5', children: _jsx(Suspense, { fallback: _jsx(EtatDeLecture, {}), children: _jsx(Outlet, {}) }) })] })] }), annonce && createPortal(_jsx(Annonce, { message: annonce, onFin: () => setAnnonce(undefined), className: "z-[60]" }), document.body)] }) }) }));
49
+ const [menu, setMenu] = useState(null);
50
+ const cadre = useMemo(() => ({ fin, gestes, menu, declarer }), [fin, gestes, menu, declarer]);
51
+ return (_jsx(ContexteDeLAnnonce.Provider, { value: setAnnonce, children: _jsx(ContexteDuCadre.Provider, { value: cadre, children: _jsxs("div", { className: "grid min-h-dvh grid-cols-[248px_minmax(0,1fr)] max-[760px]:grid-cols-[minmax(0,1fr)]", children: [_jsx("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: barre }), _jsxs("div", { className: "flex min-h-dvh min-w-0 flex-col", children: [_jsx(BarreRepliee, { marque: marque, children: depliee }), _jsxs("main", { className: "relative flex min-w-0 flex-1 flex-col px-6 pt-4 pb-6 max-[760px]:px-3 max-[760px]:pt-3", children: [_jsx(LigneDuHaut, { ecran: ecran, setFin: setFin, setGestes: setGestes, setMenu: setMenu }), _jsx("div", { className: pleineHauteur || ecranDUneChose ? 'flex min-h-0 min-w-0 flex-1 flex-col pt-3.5' : 'min-w-0 pt-3.5', children: _jsx(Suspense, { fallback: _jsx(EtatDeLecture, {}), children: _jsx(Outlet, {}) }) })] })] }), annonce && createPortal(_jsx(Annonce, { message: annonce, onFin: () => setAnnonce(undefined), className: "z-[60]" }), document.body)] }) }) }));
60
52
  }
61
- // La ligne du haut, de 36 px au moins : à gauche le fil d'Ariane, son début (l'app, l'onglet), puis
62
- // l'emplacement où l'écran rend la fin (son `<h1>`, la pastille de l'accès d'une chose), puis
63
- // l'épingle ; à droite l'emplacement des gestes de l'écran. Dessous, sur une page d'une app, ses
64
- // onglets ; sur l'écran d'une chose, le seul trait. Sous 760 px, le fil ne montre que son dernier
65
- // segment, et les gestes passent sous lui. Pendant qu'un écran se lit, le début du fil, l'épingle et
66
- // les onglets restent.
67
- function LigneDuHaut({ ecran, surUneChose, setFin, setGestes }) {
53
+ // La ligne du haut. À gauche, sur un onglet d'une app, ses onglets (`OngletsDeLaLigne`) ; sur tout
54
+ // autre écran, le fil d'Ariane : son début (l'app, l'onglet, la liste d'une chose), puis
55
+ // l'emplacement où l'écran rend la fin (son `<h1>`). À droite, l'emplacement des gestes de l'écran
56
+ // (le bloc de l'accès d'une chose), l'épingle, puis celui du menu d'une chose (son ⋯) : sur un onglet,
57
+ // l'épingle est tout à droite. Sur une page d'une app, un trait la ferme, où l'onglet actif pose son
58
+ // soulignement. Sous 760 px, le fil ne montre que son dernier segment et les onglets défilent sur leur
59
+ // ligne. Pendant qu'un écran se lit, le début du fil, les onglets et l'épingle restent.
60
+ function LigneDuHaut({ ecran, setFin, setGestes, setMenu }) {
68
61
  const session = useSession();
69
62
  const ici = useLocation({ select: (lieu) => lieu.pathname });
70
63
  const cadre = cadreDe(session, ici);
@@ -76,12 +69,29 @@ function LigneDuHaut({ ecran, surUneChose, setFin, setGestes }) {
76
69
  // montre l'épingle que si son chemin est déjà dans la barre, pour la retirer.
77
70
  const nomDeLEpingle = cadre.nomDeLEpingle ?? ecran.nom;
78
71
  const epingleMontree = sEpingle(session, ici) && (!ecran.introuvable || estEpingle(session.barre, ici));
79
- return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "flex min-h-9 flex-wrap items-center justify-between gap-x-4 gap-y-2 max-[760px]:flex-col max-[760px]:items-stretch", children: [_jsxs("nav", { "aria-label": "Fil d'Ariane", className: "flex min-h-9 min-w-0 items-center gap-2 text-[15px]", children: [debut.map((segment, rang) => (_jsxs("span", { className: "contents", children: [_jsx(LienDansLaPage, { href: segment.chemin, className: "flex-none font-medium whitespace-nowrap text-gris no-underline hover:text-encre max-[760px]:hidden", children: segment.titre }), separateurDuFil] }, rang))), _jsx("div", { ref: setFin, className: "contents" }), epingleMontree && _jsx(EpingleDuCadre, { chemin: ici, nom: nomDeLEpingle }, ici)] }), _jsx("div", { ref: setGestes, className: "flex flex-wrap items-center gap-2 empty:hidden" })] }), cadre.app && !surUneChose && cadre.onglets.length > 0 && (_jsx("nav", { "aria-label": "Onglets", className: "mt-1.5 flex flex-wrap gap-x-6 border-b border-trait", children: cadre.onglets.map((onglet) => (_jsx(LienDansLaPage, { href: onglet.chemin, "aria-current": onglet.chemin === cadre.actif?.chemin ? 'page' : undefined, className: "-mb-px border-b-2 border-transparent pt-1 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))) })), surUneChose && _jsx("div", { className: "mt-2.5 border-b border-trait" })] }));
72
+ const fin = _jsx("div", { ref: setFin, className: "contents" });
73
+ return (_jsxs("div", { className: cn('flex min-h-9 items-stretch gap-x-4 max-[760px]:flex-wrap', cadre.app && 'min-h-11 shadow-[inset_0_-1px_0_var(--color-trait)]'), children: [cadre.app && cadre.surLOnglet
74
+ ? _jsx(OngletsDeLaLigne, { cadre: cadre, fin: fin })
75
+ : (_jsxs("nav", { "aria-label": "Fil d'Ariane", className: "flex min-h-9 min-w-0 flex-1 items-center gap-2 text-[15px]", children: [debut.map((segment, rang) => (_jsxs("span", { className: "contents", children: [_jsx(LienDansLaPage, { href: segment.chemin, className: "flex-none font-medium whitespace-nowrap text-gris no-underline hover:text-encre max-[760px]:hidden", children: segment.titre }), separateurDuFil] }, rang))), fin] })), _jsxs("div", { className: "flex flex-none items-center gap-1", children: [_jsx("div", { ref: setGestes, className: "flex items-center gap-2 empty:hidden" }), epingleMontree && _jsx(EpingleDuCadre, { chemin: ici, nom: nomDeLEpingle }, ici), _jsx("div", { ref: setMenu, className: "flex items-center empty:hidden" })] })] }));
80
76
  }
81
- // L'épingle au bout du fil, pour le chemin de la page, sans sa recherche : grise, pleine à l'accent
82
- // quand il est dans la barre de la personne, qui l'y ajoute ou l'en retire (`useEpingle`). Sans nom,
83
- // elle n'épingle pas : elle ne fait que retirer une épingle, sous le nom qu'elle a dans la barre.
84
- function EpingleDuCadre({ chemin, nom }) {
77
+ // Les onglets d'une app dans la ligne du haut, `<nav aria-label="Onglets">` : ses écrans, le premier
78
+ // sous le titre de l'app, « Réglages » et « Documentation » (`ongletsDe`) ; l'actif, `aria-current`,
79
+ // souligné à l'accent, est le `<h1>` de l'écran. Une app sans écran, dont aucun onglet ne porte le
80
+ // titre, les fait précéder du fil d'Ariane, son titre en lien, caché sous 760 px. Ils défilent sur
81
+ // leur ligne, sans passer à la ligne. L'écran ne rend là que ce qui suit son titre (`fin`).
82
+ function OngletsDeLaLigne({ cadre, fin }) {
83
+ const avant = cadre.app && cadre.app.ecrans.length === 0 ? cadre.debut : [];
84
+ return (_jsxs(_Fragment, { children: [avant.length > 0 && (_jsx("nav", { "aria-label": "Fil d'Ariane", className: "flex flex-none items-center gap-2 text-[15px] max-[760px]:hidden", children: avant.map((segment, rang) => (_jsxs("span", { className: "contents", children: [_jsx(LienDansLaPage, { href: segment.chemin, className: "font-medium whitespace-nowrap text-gris no-underline hover:text-encre", children: segment.titre }), separateurDuFil] }, rang))) })), _jsxs("nav", { "aria-label": "Onglets", className: "flex min-w-0 flex-1 items-stretch gap-x-6 overflow-x-auto [scrollbar-width:none] [&::-webkit-scrollbar]:hidden", children: [cadre.onglets.map((onglet) => {
85
+ const actif = onglet.chemin === cadre.actif?.chemin;
86
+ const lien = (_jsx(LienDansLaPage, { href: onglet.chemin, "aria-current": actif ? 'page' : undefined, className: "flex flex-none items-center font-medium whitespace-nowrap text-gris no-underline hover:text-encre aria-[current=page]:text-encre aria-[current=page]:shadow-[inset_0_-2px_0_var(--color-accent)]", children: onglet.titre }, onglet.chemin));
87
+ return actif ? _jsx("h1", { className: "m-0 flex flex-none text-[length:inherit] font-[inherit]", children: lien }, onglet.chemin) : lien;
88
+ }), fin] })] }));
89
+ }
90
+ // L'épingle de la ligne du haut, tout à droite sur un onglet, entre le bloc de l'accès et le ⋯ sur
91
+ // une chose, pour le chemin de la page, sans sa recherche : grise, pleine à l'accent quand il est dans
92
+ // la barre de la personne, qui l'y ajoute ou l'en retire (`useEpingle`). Sans nom, elle n'épingle
93
+ // pas : elle ne fait que retirer une épingle, sous le nom qu'elle a dans la barre.
94
+ export function EpingleDuCadre({ chemin, nom }) {
85
95
  const session = useSession();
86
96
  const annoncer = useAnnoncer();
87
97
  const dansLaBarre = session.barre.find((entree) => cheminDe(entree.chemin) === chemin)?.titre;
@@ -93,7 +103,7 @@ function EpingleDuCadre({ chemin, nom }) {
93
103
  const libelle = epingle.epinglee ? 'Retirer de la barre' : 'Épingler dans la barre';
94
104
  return (_jsx("button", { type: "button", "aria-pressed": epingle.epinglee, "aria-label": libelle, title: libelle, disabled: epingle.enCours || (!epingle.epinglee && !nom), onClick: () => epingle.basculer(nomDit), className: "grid size-7 flex-none cursor-pointer place-items-center rounded-md border-0 bg-transparent text-gris hover:bg-survol hover:text-encre disabled:opacity-50 aria-pressed:text-accent aria-pressed:hover:text-accent", children: _jsx(IconeDEpingle, { pleine: epingle.epinglee }) }));
95
105
  }
96
- // La barre repliée, sur un téléphone : la marque et « Menu », qui déplie la barre en cours. Elle se
106
+ // La barre repliée, sur un téléphone : la marque et « Menu », qui déplie la barre de l'OS. Elle se
97
107
  // replie quand on change d'écran.
98
108
  function BarreRepliee({ marque, children }) {
99
109
  const [ouverte, setOuverte] = useState(false);
@@ -1,3 +1,12 @@
1
+ import type { EtatDeLaConnexion } from '../forme-du-direct.ts';
2
+ import type { PersonnePresente } from '../presence.ts';
3
+ export type DirectDeclare = {
4
+ etat: EtatDeLaConnexion | 'ferme';
5
+ personnes: PersonnePresente[];
6
+ lecture?: boolean;
7
+ };
8
+ export declare const ContexteDuDirect: import("react").Context<((direct: DirectDeclare | undefined) => void) | null>;
9
+ export declare function useDeclarerLeDirect(direct: DirectDeclare | undefined): void;
1
10
  export declare function useAnnoncerLeDroitQuiBaisse(lecture: boolean | undefined, chose: {
2
11
  une: string;
3
12
  feminin?: boolean;
@@ -1,11 +1,27 @@
1
1
  import { useQueryClient } from '@tanstack/react-query';
2
- import { useCallback, useEffect, useRef } from 'react';
2
+ import { createContext, useCallback, useContext, useEffect, useRef } from 'react';
3
3
  import { texteDuDroitQuiBaisse } from '../ui/direct.js';
4
4
  import { cleDesChoses } from './choses.js';
5
5
  import { useAnnoncer } from './ouvrir.js';
6
- // Les gestes du direct dans l'écran d'une chose (bibliotheque/CLAUDE.md, « Le direct à l'écran ») :
7
- // le droit qui baisse se dit une fois, la chose fermée devient l'écran d'une chose introuvable, et la
8
- // session fermée recharge la page (`rechargerLaPage`, de ./navigation.ts).
6
+ // Ce que l'écran d'une chose donne à son corps pour y recevoir le direct.
7
+ export const ContexteDuDirect = createContext(null);
8
+ // Le corps d'une chose déclare son direct, en données : le bloc de l'accès de l'écran les dessine,
9
+ // les présents en pastilles, et un mot hors du nominal (« Reconnexion… », « Lecture »). La personne
10
+ // elle-même peut être parmi `personnes` : le bloc ne la montre pas. `undefined` ne déclare rien, pour
11
+ // un corps dont le direct n'est pas encore ouvert. Hors de l'écran d'une chose, rien.
12
+ export function useDeclarerLeDirect(direct) {
13
+ const declarer = useContext(ContexteDuDirect);
14
+ const cle = direct ? JSON.stringify([direct.etat, direct.lecture === true, direct.personnes.map((personne) => [personne.id, personne.nom, personne.invite === true])]) : '';
15
+ const dernier = useRef(direct);
16
+ dernier.current = direct;
17
+ useEffect(() => {
18
+ if (!declarer) {
19
+ return undefined;
20
+ }
21
+ declarer(dernier.current);
22
+ return () => declarer(undefined);
23
+ }, [declarer, cle]);
24
+ }
9
25
  // Annonce le droit qui baisse : quand `lecture`, ce que le direct dit du droit de la personne, passe
10
26
  // de faux à vrai, une annonce, « Ce tableau ne vous est plus ouvert qu'en lecture. ». Une chose qui
11
27
  // s'ouvre déjà en lecture ne dit rien. `undefined`, un droit pas encore lu (pendant une connexion),
@@ -1,8 +1,4 @@
1
- import { type ReactNode } from 'react';
2
1
  import { type ChoseTrouvee, type DeclarationDesChoses } from './choses.ts';
3
- export declare function DansLEtatDuDirect({ children }: {
4
- children: ReactNode;
5
- }): import("react").ReactPortal | null;
6
2
  export declare function EcranDUneChose<C extends ChoseTrouvee>({ choses, id }: {
7
3
  choses: DeclarationDesChoses<C>;
8
4
  id: string;