@indos/bibliotheque 2.3.0 → 3.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 (121) hide show
  1. package/CLAUDE.md +361 -0
  2. package/LICENSE +4 -18
  3. package/README.md +6 -11
  4. package/bin/page-de-l-espace.js +12 -6
  5. package/package.json +16 -13
  6. package/src/app.js +2 -2
  7. package/src/appeler.js +4 -5
  8. package/src/compte.d.ts +222 -8
  9. package/src/compte.js +250 -22
  10. package/src/description-des-comptes.d.ts +16 -0
  11. package/src/direct/page.js +1 -1
  12. package/src/direct.js +1 -1
  13. package/src/ecran.js +2 -2
  14. package/src/espace/apercu.js +10 -23
  15. package/src/espace/barre.d.ts +1 -0
  16. package/src/espace/barre.js +8 -2
  17. package/src/espace/cadre.d.ts +4 -5
  18. package/src/espace/cadre.js +31 -29
  19. package/src/espace/chose-seule.d.ts +1 -4
  20. package/src/espace/chose-seule.js +7 -16
  21. package/src/espace/choses.d.ts +9 -5
  22. package/src/espace/choses.js +9 -4
  23. package/src/espace/comptes.js +146 -103
  24. package/src/espace/coquille.d.ts +6 -6
  25. package/src/espace/coquille.js +157 -68
  26. package/src/espace/doubles-de-jsdom.js +11 -4
  27. package/src/espace/ecran-d-une-chose.js +10 -9
  28. package/src/espace/ecran.js +1 -2
  29. package/src/espace/edition-de-la-barre.d.ts +31 -0
  30. package/src/espace/edition-de-la-barre.js +450 -0
  31. package/src/espace/essai.js +4 -4
  32. package/src/espace/fenetre-du-don.d.ts +11 -0
  33. package/src/espace/fenetre-du-don.js +41 -0
  34. package/src/espace/index.d.ts +3 -3
  35. package/src/espace/index.js +3 -3
  36. package/src/espace/liste-des-choses.js +28 -24
  37. package/src/espace/menu-d-une-chose.js +15 -51
  38. package/src/espace/ouvrir.d.ts +3 -3
  39. package/src/espace/ouvrir.js +15 -14
  40. package/src/espace/page.js +1 -1
  41. package/src/espace/panneau-du-partage.d.ts +8 -3
  42. package/src/espace/panneau-du-partage.js +36 -14
  43. package/src/espace/routes-des-choses.js +6 -5
  44. package/src/espace/session.d.ts +14 -0
  45. package/src/faux-core.d.ts +29 -3
  46. package/src/faux-core.js +90 -12
  47. package/src/fichiers.d.ts +2 -0
  48. package/src/fichiers.js +6 -4
  49. package/src/flux.js +1 -1
  50. package/src/format.d.ts +3 -0
  51. package/src/format.js +20 -1
  52. package/src/forme-du-direct.js +1 -1
  53. package/src/jeton.js +2 -2
  54. package/src/liens.js +1 -1
  55. package/src/mcp.js +3 -3
  56. package/src/notifier.d.ts +10 -0
  57. package/src/notifier.js +47 -0
  58. package/src/page.d.ts +17 -0
  59. package/src/page.js +139 -14
  60. package/src/partage.d.ts +5 -1
  61. package/src/partage.js +61 -16
  62. package/src/presence.js +1 -1
  63. package/src/sans-accents.js +1 -1
  64. package/src/session.js +4 -4
  65. package/src/theme.js +1 -1
  66. package/src/ui/blocs.d.ts +5 -2
  67. package/src/ui/blocs.js +11 -6
  68. package/src/ui/choix.d.ts +2 -1
  69. package/src/ui/choix.js +3 -2
  70. package/src/ui/direct.d.ts +6 -0
  71. package/src/ui/direct.js +9 -5
  72. package/src/ui/fenetre.d.ts +8 -3
  73. package/src/ui/fenetre.js +34 -9
  74. package/src/ui/focus.d.ts +2 -0
  75. package/src/ui/focus.js +5 -0
  76. package/src/ui/gestes-du-contenu.d.ts +21 -0
  77. package/src/ui/gestes-du-contenu.js +24 -0
  78. package/src/ui/icones.d.ts +7 -0
  79. package/src/ui/icones.js +12 -1
  80. package/src/ui/index.d.ts +6 -5
  81. package/src/ui/index.js +5 -4
  82. package/src/ui/lien.d.ts +1 -0
  83. package/src/ui/lien.js +2 -2
  84. package/src/ui/menu-d-une-ligne.d.ts +2 -0
  85. package/src/ui/panneau.d.ts +1 -2
  86. package/src/ui/panneau.js +8 -4
  87. package/src/ui/reglages.d.ts +47 -0
  88. package/src/ui/reglages.js +101 -0
  89. package/src/ui/tableau.d.ts +1 -2
  90. package/src/ui/tableau.js +8 -12
  91. package/src/ui/vues.js +1 -1
  92. package/src/vite.d.ts +3 -0
  93. package/src/vite.js +50 -18
  94. package/CHANGELOG.md +0 -276
  95. package/bin/bibliotheque.d.ts +0 -1
  96. package/bin/bibliotheque.js +0 -62
  97. package/modeles/app-du-client/.dockerignore +0 -3
  98. package/modeles/app-du-client/DOCUMENTATION.md +0 -27
  99. package/modeles/app-du-client/Dockerfile +0 -36
  100. package/modeles/app-du-client/README.md +0 -53
  101. package/modeles/app-du-client/USAGE.md +0 -3
  102. package/modeles/app-du-client/espace/ecrans/entrees.tsx +0 -57
  103. package/modeles/app-du-client/espace/index.html +0 -9
  104. package/modeles/app-du-client/espace/page.tsx +0 -6
  105. package/modeles/app-du-client/espace/requetes/entrees.ts +0 -16
  106. package/modeles/app-du-client/espace/routes.ts +0 -12
  107. package/modeles/app-du-client/espace/tsconfig.json +0 -7
  108. package/modeles/app-du-client/gitignore +0 -2
  109. package/modeles/app-du-client/logo.svg +0 -1
  110. package/modeles/app-du-client/migrations/0001-creer-les-entrees.sql +0 -10
  111. package/modeles/app-du-client/module.json +0 -12
  112. package/modeles/app-du-client/package.json +0 -17
  113. package/modeles/app-du-client/src/demarrer.ts +0 -17
  114. package/modeles/app-du-client/src/outils.ts +0 -48
  115. package/modeles/app-du-client/src/serveur.ts +0 -46
  116. package/modeles/app-du-client/tests/espace/entrees.test.tsx +0 -57
  117. package/modeles/app-du-client/tests/serveur.test.ts +0 -119
  118. package/modeles/app-du-client/tests/sources-de-la-page.test.ts +0 -23
  119. package/modeles/app-du-client/tsconfig.json +0 -22
  120. package/src/ui/repli.d.ts +0 -12
  121. package/src/ui/repli.js +0 -6
@@ -29,10 +29,18 @@ export type DescriptionDesComptes = {
29
29
  suites: string[];
30
30
  faits: Record<string, FaitDecrit>;
31
31
  champs: ChampDecrit[];
32
+ enEntier?: string;
33
+ partagePar?: string;
34
+ fournisseur?: string;
35
+ introduction?: string;
36
+ note?: string;
37
+ connecter?: string;
32
38
  };
39
+ export type GesteDUnEtat = 'modifier' | 'lien';
33
40
  export type EtatDUnCompte = {
34
41
  texte: string;
35
42
  sorte?: 'active' | 'erreur';
43
+ geste?: GesteDUnEtat;
36
44
  };
37
45
  export type CompteListe = {
38
46
  id: string;
@@ -44,7 +52,15 @@ export type CompteListe = {
44
52
  texte: string;
45
53
  adresse: string;
46
54
  };
55
+ droit?: 'proprietaire' | 'modification' | 'lecture';
56
+ donnable?: boolean;
57
+ proprietaire?: {
58
+ nom: string;
59
+ };
47
60
  };
48
61
  export type ListeDesComptes = {
49
62
  comptes: CompteListe[];
50
63
  };
64
+ export type ReponseDeBrancher = {
65
+ connexion?: string;
66
+ };
@@ -1,7 +1,7 @@
1
1
  import { HocuspocusProvider, HocuspocusProviderWebsocket } from '@hocuspocus/provider';
2
2
  import * as Y from 'yjs';
3
3
  import { cheminDuDirect, codes, raisons } from '../forme-du-direct.js';
4
- // @indos/bibliotheque/direct/page : le direct Yjs d'une chose, côté page (bibliotheque/CLAUDE.md,
4
+ // @indos/bibliotheque/direct/page : le direct Yjs d'une chose, côté page (indos/bibliotheque/CLAUDE.md,
5
5
  // « Le direct Yjs ») : le document Yjs, relayé par Hocuspocus sur un WebSocket, de la même origine
6
6
  // que la page, et sa présence, où le serveur écrit la personne de chaque onglet. L'app écrit dans le
7
7
  // document sous sa propre origine, que son historique (⌘Z) suit seule : il ne défait jamais ce qu'un
package/src/direct.js CHANGED
@@ -7,7 +7,7 @@ import { cheminDuDirect, codes, personneDeLInvite, raisons } from './forme-du-di
7
7
  import { Refus } from './mcp.js';
8
8
  import { suffit } from './partage.js';
9
9
  import { couleurDe, longueurDUnNom } from './presence.js';
10
- // @indos/bibliotheque/direct : le direct Yjs d'une app, côté serveur (bibliotheque/CLAUDE.md, « Le
10
+ // @indos/bibliotheque/direct : le direct Yjs d'une app, côté serveur (indos/bibliotheque/CLAUDE.md, « Le
11
11
  // direct Yjs »). Chaque chose ouverte est un document Yjs en mémoire de l'app, relayé par Hocuspocus
12
12
  // à chaque page qui l'a ouverte, par un WebSocket, et écrit en base par l'app. Une seule instance par
13
13
  // serveur : un redémarrage coupe les connexions, que les pages rouvrent seules, et l'app écrit ses
package/src/ecran.js CHANGED
@@ -1,5 +1,5 @@
1
- // Les pages rendues par le serveur, sans script (docs/architecture.md, « L'espace et les
2
- // réglages ») : la page d'auth, celles du core (la connexion, le consentement, le mot de passe), et
1
+ // Les pages rendues par le serveur, sans script (indos/bibliotheque/CLAUDE.md, « Les pages
2
+ // rendues par le serveur ») : la page d'auth, celles du core (la connexion, le consentement, le mot de passe), et
3
3
  // la page simple, une page introuvable ou une erreur, du core comme d'une app. La structure est
4
4
  // écrite ici, une fois ; le style vient du core, à la racine du même domaine (`/theme/variables.css`,
5
5
  // `/theme/console.css`), dont les classes sont un contrat. Un paramètre de texte est échappé ; un
@@ -1,24 +1,22 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { useEffect, useMemo, useRef, useState } from 'react';
3
- import { IconeAgrandir, IconeFermer } from '../ui/icones.js';
3
+ import { classesDUneIcone, IconeAgrandir, IconeFermer } from '../ui/icones.js';
4
4
  import { ContexteDuCadre } from './cadre.js';
5
- import { EpingleDuCadre } from './coquille.js';
6
5
  import { EcranDUneChose } from './ecran-d-une-chose.js';
7
6
  import { LienDansLaPage } from './lien.js';
8
7
  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
8
+ // L'aperçu d'une chose, par-dessus sa liste (indos/bibliotheque/CLAUDE.md, « Une app à choses ») : l'écran de la
10
9
  // chose, le même, en étroit, dans un panneau posé à droite de la zone de l'écran, sur toute sa
11
10
  // hauteur, ligne du haut comprise, une ombre sur son bord gauche, sans voile : la liste reste
12
11
  // utilisable et ne bouge pas. 55 % de la zone au plus, 680 px au plus, 380 px au moins ; sous
13
12
  // 760 px, tout l'écran. Il apparaît net, sans glisser.
14
13
  //
15
14
  // 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,
15
+ // gauche (un `<h2>`, renommable), puis le bloc de l'accès, le ⋯, un trait,
17
16
  // « 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';
17
+ // voisine (`passer`), Entrée agrandit, Échap ferme (`toucheDeLApercu`). Il ne prend pas le focus,
18
+ // qui reste à l'œil de la ligne : les touches marchent dès l'ouverture. La liste tient l'adresse
19
+ // (`apercu`) et le focus qui revient à la ligne.
22
20
  // Le corps de la chose dans l'aperçu, que rend l'app : ses touches restent les siennes.
23
21
  const attributDuCorps = 'data-corps-de-l-apercu';
24
22
  export function ApercuDUneChose({ choses, id, chemin: cheminDeLaLigne, fermer, passer, quitter }) {
@@ -32,18 +30,6 @@ export function ApercuDUneChose({ choses, id, chemin: cheminDeLaLigne, fermer, p
32
30
  quitterMaintenant.current = quitter;
33
31
  const cadre = useMemo(() => ({ fin, gestes, menu, declarer: setEcran, apercu: { quitter: () => quitterMaintenant.current() } }), [fin, gestes, menu]);
34
32
  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
33
  useEffect(() => {
48
34
  function touche(evenement) {
49
35
  const geste = toucheDeLApercu(evenement);
@@ -67,7 +53,7 @@ export function ApercuDUneChose({ choses, id, chemin: cheminDeLaLigne, fermer, p
67
53
  return (_jsx("aside", { "aria-label": "Aper\u00E7u", className: [
68
54
  '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
55
  '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"] })] })] }) }));
56
+ ].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" }), _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
57
  }
72
58
  function Touche({ children }) {
73
59
  return _jsx("kbd", { className: "rounded-[4px] border border-b-2 border-trait px-1 font-mono text-[11px]", children: children });
@@ -77,7 +63,8 @@ const champsEtFenetres = [
77
63
  'input', 'textarea', 'select', '[contenteditable]:not([contenteditable=false])', 'iframe',
78
64
  '[role=dialog]', '[role=alertdialog]', '[role=menu]', '[role=listbox]', '[role=combobox]', '[role=textbox]', '[role=grid]', '[role=application]',
79
65
  ].join(', ');
80
- // Ce qui fait son geste à Entrée : un lien, un bouton.
66
+ // Ce qui fait son geste à Entrée : un lien, un bouton, sauf l'œil de la ligne montrée, où Entrée
67
+ // agrandit ; sur l'œil d'une autre ligne, Entrée montre sa chose.
81
68
  const elementsAEntree = 'a, button, summary, [role=button], [role=link], [role=tab], [role=menuitem]';
82
69
  // La touche d'un aperçu ouvert, hors d'un champ, d'un éditeur ou d'une fenêtre : ↑ ↓ passent à la
83
70
  // ligne voisine, Entrée agrandit, Échap ferme. Dans le corps de la chose, que l'app rend, ↑ ↓ et
@@ -98,7 +85,7 @@ function toucheDeLApercu(evenement) {
98
85
  if (touche !== 'fermer' && cible?.closest(`[${attributDuCorps}]`)) {
99
86
  return undefined;
100
87
  }
101
- if (touche === 'agrandir' && cible?.closest(elementsAEntree)) {
88
+ if (touche === 'agrandir' && cible?.closest(elementsAEntree) && !cible.closest('[data-oeil-de-l-apercu][aria-pressed="true"]')) {
102
89
  return undefined;
103
90
  }
104
91
  return touche;
@@ -16,6 +16,7 @@ export type AnnuaireDeLEcran = {
16
16
  export declare function epingler(epingle: Epingle): Promise<unknown>;
17
17
  export declare function desepingler(epingle: Pick<Epingle, 'chemin'>): Promise<unknown>;
18
18
  export declare function lireLAnnuaire(): Promise<AnnuaireDeLEcran>;
19
+ export declare const cleDeLaBarreEnEdition: string[];
19
20
  export declare function estEpingle(barre: {
20
21
  chemin: string;
21
22
  }[], chemin: string): boolean;
@@ -15,12 +15,15 @@ export function desepingler(epingle) {
15
15
  export function lireLAnnuaire() {
16
16
  return faireUnGeste('/espace/annuaire');
17
17
  }
18
+ // La clé de la barre que lit la barre en édition (`edition-de-la-barre.tsx`) : un geste de
19
+ // l'épingle la fait relire, pour que l'édition ouverte ne l'efface pas au changement suivant.
20
+ export const cleDeLaBarreEnEdition = ['barre-rangee'];
18
21
  // Si un chemin est épinglé dans la barre de la session.
19
22
  export function estEpingle(barre, chemin) {
20
23
  return barre.some((entree) => cheminDe(entree.chemin) === chemin);
21
24
  }
22
25
  // Pour un écran : l'épingle d'un chemin, et le geste qui l'ajoute ou la retire, après lequel la
23
- // session se relit, et la barre avec elle. `suites.fait` reçoit l'état nouveau, `suites.echec` le
26
+ // session se relit, et la barre avec elle, celle de l'édition comprise. `suites.fait` reçoit l'état nouveau, `suites.echec` le
24
27
  // texte d'un geste refusé, mot pour mot.
25
28
  export function useEpingle(chemin, suites = {}) {
26
29
  const session = useSession();
@@ -29,7 +32,10 @@ export function useEpingle(chemin, suites = {}) {
29
32
  mutationFn: ({ epinglee, nom }) => (epinglee ? desepingler({ chemin }) : epingler({ chemin, nom })),
30
33
  onSuccess: (_rendu, { epinglee }) => suites.fait?.(!epinglee),
31
34
  onError: (erreur) => suites.echec?.(erreur.message),
32
- onSettled: () => client.invalidateQueries({ queryKey: requeteDeLaSession.queryKey }),
35
+ onSettled: () => Promise.all([
36
+ client.invalidateQueries({ queryKey: requeteDeLaSession.queryKey }),
37
+ client.invalidateQueries({ queryKey: cleDeLaBarreEnEdition }),
38
+ ]),
33
39
  });
34
40
  const epinglee = estEpingle(session.barre, chemin);
35
41
  return {
@@ -3,6 +3,7 @@ import type { AppOuverte, Session } from './session.ts';
3
3
  export type Onglet = {
4
4
  titre: string;
5
5
  chemin: string;
6
+ delApp?: true;
6
7
  };
7
8
  export type SegmentDuFil = {
8
9
  titre: string;
@@ -10,7 +11,7 @@ export type SegmentDuFil = {
10
11
  };
11
12
  export declare function appDuChemin(session: Session, ici: string): AppOuverte | undefined;
12
13
  export declare function ongletsDe(app: AppOuverte): Onglet[];
13
- export declare function sEpingle(session: Session, ici: string): boolean;
14
+ export declare function estReglagesOuDocumentation(chemin: string): boolean;
14
15
  export type CadreDeLaPage = {
15
16
  app?: AppOuverte;
16
17
  onglets: Onglet[];
@@ -18,11 +19,9 @@ export type CadreDeLaPage = {
18
19
  surLOnglet: boolean;
19
20
  debut: SegmentDuFil[];
20
21
  dernier?: string;
21
- nomDeLEpingle?: string;
22
22
  };
23
23
  export declare function cadreDe(session: Session, ici: string): CadreDeLaPage;
24
24
  export type EcranDeclare = {
25
- nom?: string;
26
25
  introuvable?: boolean;
27
26
  chemin?: string;
28
27
  };
@@ -30,7 +29,7 @@ export type Cadre = {
30
29
  fin: HTMLElement | null;
31
30
  gestes: HTMLElement | null;
32
31
  menu: HTMLElement | null;
33
- declarer: (ecran: EcranDeclare) => void;
32
+ declarer?: (ecran: EcranDeclare) => void;
34
33
  apercu?: {
35
34
  quitter: () => void;
36
35
  };
@@ -50,9 +49,9 @@ export declare function DansLeMenu({ children }: {
50
49
  }): import("react").ReactPortal | null;
51
50
  export declare const separateurDuFil: import("react").JSX.Element;
52
51
  export declare const classesDuTitre = "m-0 min-w-0 truncate text-[15px] leading-[1.4] font-semibold text-encre";
52
+ export declare function useDansLApercu(): boolean;
53
53
  export declare function useTitreDuCadre(): {
54
54
  Balise: 'h1' | 'h2';
55
- tabIndex?: number;
56
55
  };
57
56
  export declare function TitreDuFil({ children }: {
58
57
  children: ReactNode;
@@ -10,25 +10,24 @@ 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, le premier sous le titre de l'app, « Réglages »
14
- // quand la personne a le droit de les voir, et « Documentation ».
13
+ // Les onglets d'une app, dans leur ordre : ses écrans, chacun sous son titre, « Réglages » quand la
14
+ // personne a le droit de les voir, et « Documentation », ces deux-là marqués `delApp`.
15
15
  export function ongletsDe(app) {
16
16
  return [
17
- ...app.ecrans.map((ecran, rang) => ({ titre: rang === 0 ? app.titre : ecran.titre, chemin: ecran.chemin })),
18
- ...(app.reglages ? [{ titre: 'Réglages', chemin: `/${app.nom}/reglages` }] : []),
19
- { titre: 'Documentation', chemin: `/documentation/${app.nom}` },
17
+ ...app.ecrans.map((ecran) => ({ titre: ecran.titre, chemin: ecran.chemin })),
18
+ ...(app.reglages ? [{ titre: 'Réglages', chemin: `/${app.nom}/reglages`, delApp: true }] : []),
19
+ { titre: 'Documentation', chemin: `/documentation/${app.nom}`, delApp: true },
20
20
  ];
21
21
  }
22
- // Les écrans de l'OS qui s'épinglent, avec tout chemin d'une app ouverte et sa documentation : la
23
- // règle du core (core/src/barre.ts). « Mon compte » et « Équipe » ne s'épinglent pas.
24
- const ecransDeLOS = ['/bienvenue', '/apps', '/journal'];
25
- export function sEpingle(session, ici) {
26
- return ecransDeLOS.includes(ici) || appDuChemin(session, ici) !== undefined;
22
+ // Les réglages d'une app et sa documentation ne s'épinglent pas : ils s'ouvrent par l'onglet de l'app
23
+ // (la règle du core, apps/core/src/barre.ts).
24
+ export function estReglagesOuDocumentation(chemin) {
25
+ return chemin.startsWith('/documentation/') || /^\/[^/]+\/reglages(?:\/|$)/.test(chemin);
27
26
  }
28
- // Le lien d'un onglet dans le fil : celui de la liste d'une app à choses mène à la liste telle qu'on
29
- // l'a quittée.
30
- function lienDeLOnglet(app, onglet) {
31
- return app.ecrans.some((ecran) => ecran.nom === 'liste' && ecran.chemin === onglet.chemin) ? adresseDeLaListe(app.nom) : onglet.chemin;
27
+ // Le lien d'un onglet dans le fil : celui d'une liste mène à la liste telle qu'on l'a quittée ; un
28
+ // autre écran, qui ne retient rien, à son chemin.
29
+ function lienDeLOnglet(onglet) {
30
+ return adresseDeLaListe(onglet.chemin);
32
31
  }
33
32
  // Le cadre d'une page. Sur une page d'une app : le titre de l'app, puis l'onglet actif quand son
34
33
  // titre n'est pas celui de l'app, puis, sur un écran qui n'est pas l'onglet lui-même, le titre que
@@ -46,7 +45,7 @@ export function cadreDe(session, ici) {
46
45
  const cheminActif = exact?.chemin ?? entreeActive(app.ecrans.map((ecran) => ecran.chemin), ici);
47
46
  const actif = onglets.find((onglet) => onglet.chemin === cheminActif);
48
47
  const premier = onglets[0];
49
- const titreDeLApp = { titre: app.titre, chemin: premier ? lienDeLOnglet(app, premier) : app.lien };
48
+ const titreDeLApp = { titre: app.titre, chemin: premier ? lienDeLOnglet(premier) : app.lien };
50
49
  const ongletDistinct = actif && actif.titre !== app.titre ? actif : undefined;
51
50
  if (exact) {
52
51
  return {
@@ -56,7 +55,6 @@ export function cadreDe(session, ici) {
56
55
  surLOnglet: true,
57
56
  debut: ongletDistinct ? [titreDeLApp] : [],
58
57
  dernier: ongletDistinct ? ongletDistinct.titre : app.titre,
59
- nomDeLEpingle: exact.chemin === app.ecrans[0]?.chemin ? app.titre : `${app.titre} · ${exact.titre}`,
60
58
  };
61
59
  }
62
60
  return {
@@ -64,7 +62,7 @@ export function cadreDe(session, ici) {
64
62
  onglets,
65
63
  actif,
66
64
  surLOnglet: false,
67
- debut: [titreDeLApp, ...(ongletDistinct ? [{ titre: ongletDistinct.titre, chemin: lienDeLOnglet(app, ongletDistinct) }] : [])],
65
+ debut: [titreDeLApp, ...(ongletDistinct ? [{ titre: ongletDistinct.titre, chemin: lienDeLOnglet(ongletDistinct) }] : [])],
68
66
  };
69
67
  }
70
68
  export const ContexteDuCadre = createContext(null);
@@ -74,17 +72,18 @@ export function useCadre() {
74
72
  // L'écran dit ce que la coquille ne sait pas de lui, tant qu'il est rendu.
75
73
  export function useDeclarerLEcran(ecran) {
76
74
  const cadre = useCadre();
77
- const { nom, introuvable, chemin } = ecran;
75
+ const { introuvable, chemin } = ecran;
76
+ const declarer = cadre?.declarer;
78
77
  useEffect(() => {
79
- if (!cadre) {
78
+ if (!declarer) {
80
79
  return undefined;
81
80
  }
82
- cadre.declarer({ nom, introuvable, chemin });
83
- return () => cadre.declarer({});
84
- }, [cadre?.declarer, nom, introuvable, chemin]);
81
+ declarer({ introuvable, chemin });
82
+ return () => declarer({});
83
+ }, [declarer, introuvable, chemin]);
85
84
  }
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.
85
+ // Rendre à la fin du fil, dans les gestes de l'écran, puis dans le menu : par un portail, dans
86
+ // l'emplacement que donne le cadre.
88
87
  export function DansLeFil({ children }) {
89
88
  const cadre = useCadre();
90
89
  return cadre?.fin ? createPortal(children, cadre.fin) : null;
@@ -100,12 +99,15 @@ export function DansLeMenu({ children }) {
100
99
  // Le séparateur du fil, et le dernier segment, le `<h1>` de l'écran.
101
100
  export const separateurDuFil = _jsx("span", { "aria-hidden": "true", className: "text-trait-champ max-[760px]:hidden", children: "/" });
102
101
  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.
102
+ // Vrai pour un écran rendu dans l'aperçu d'une liste : un corps peut s'y montrer en plus simple.
103
+ export function useDansLApercu() {
104
+ return Boolean(useCadre()?.apercu);
105
+ }
106
+ // La balise du titre : le `<h1>` de l'écran ; dans un aperçu, sous le `<h1>` de la liste, un `<h2>`.
105
107
  export function useTitreDuCadre() {
106
- return useCadre()?.apercu ? { Balise: 'h2', tabIndex: -1 } : { Balise: 'h1' };
108
+ return { Balise: useDansLApercu() ? 'h2' : 'h1' };
107
109
  }
108
110
  export function TitreDuFil({ children }) {
109
- const { Balise, tabIndex } = useTitreDuCadre();
110
- return _jsx(Balise, { tabIndex: tabIndex, className: classesDuTitre, children: children });
111
+ const { Balise } = useTitreDuCadre();
112
+ return _jsx(Balise, { className: classesDuTitre, children: children });
111
113
  }
@@ -1,12 +1,9 @@
1
- import { type EcranDeclare } from './cadre.tsx';
2
1
  import type { ChoseTrouvee, DeclarationDesChoses } from './choses.ts';
3
2
  export declare function ChoseSeule<C extends ChoseTrouvee>({ choses, id }: {
4
3
  choses: DeclarationDesChoses<C>;
5
4
  id: string;
6
5
  }): import("react").JSX.Element;
7
- export declare function TeteDUneChoseSeule({ ecran, chemin, setFin, setGestes, setMenu }: {
8
- ecran: EcranDeclare;
9
- chemin: string;
6
+ export declare function TeteDUneChoseSeule({ setFin, setGestes, setMenu }: {
10
7
  setFin: (element: HTMLElement | null) => void;
11
8
  setGestes: (element: HTMLElement | null) => void;
12
9
  setMenu: (element: HTMLElement | null) => void;
@@ -1,43 +1,34 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
- import { useLocation } from '@tanstack/react-router';
3
2
  import { useMemo, useState } from 'react';
4
3
  import { createPortal } from 'react-dom';
5
4
  import { Annonce } from '../ui/annonce.js';
6
- import { estEpingle } from './barre.js';
7
5
  import { ContexteDuCadre } from './cadre.js';
8
- import { EpingleDuCadre } from './coquille.js';
9
6
  import { EcranDUneChose } from './ecran-d-une-chose.js';
10
7
  import { LienDansLaPage } from './lien.js';
11
8
  import { ContexteDeLAnnonce } from './ouvrir.js';
12
9
  import { useSession } from './session.js';
13
- // Une chose seule, « Ouvrir à part ↗ » (docs/architecture.md, « L'espace ») : l'écran de la chose,
10
+ // Une chose seule, « Ouvrir à part ↗ » (indos/bibliotheque/CLAUDE.md, « Une app à choses ») : l'écran de la chose,
14
11
  // le même, avec la session, hors de la coquille (`horsDeLaCoquille`), ni barre de l'OS ni cadre, à
15
12
  // `<chemin>/seule`, pour y travailler en grand dans son propre onglet. Sa tête mince
16
13
  // (`TeteDUneChoseSeule`) : la marque, qui mène à l'accueil, le nom, renommable, puis le bloc de
17
- // l'accès, l'épingle de la chose et le ⋯, où « Ouvrir dans l'OS » ramène à son écran ; puis le corps,
14
+ // l'accès et le ⋯, où « Ouvrir dans l'OS » ramène à son écran ; puis le corps,
18
15
  // sur la hauteur qui reste. Un geste fait s'y annonce en bas de l'écran, comme dans la coquille.
19
16
  export function ChoseSeule({ choses, id }) {
20
- const ici = useLocation({ select: (lieu) => lieu.pathname });
21
17
  const [annonce, setAnnonce] = useState();
22
18
  const [fin, setFin] = useState(null);
23
19
  const [gestes, setGestes] = useState(null);
24
20
  const [menu, setMenu] = useState(null);
25
- const [ecran, setEcran] = useState({});
26
- const cadre = useMemo(() => ({ fin, gestes, menu, declarer: setEcran, seule: true }), [fin, gestes, menu]);
27
- // Le chemin de la chose dans l'OS, celui de son écran, que l'épingle épingle.
28
- const chemin = ecran.chemin ?? ici.replace(/\/seule$/, '');
29
- return (_jsxs(ContexteDeLAnnonce.Provider, { value: setAnnonce, children: [_jsxs("div", { className: "flex h-dvh min-w-0 flex-col bg-papier text-encre", children: [_jsx(TeteDUneChoseSeule, { ecran: ecran, chemin: chemin, setFin: setFin, setGestes: setGestes, setMenu: setMenu }), _jsx("main", { className: "flex min-h-0 min-w-0 flex-1 flex-col overflow-y-auto px-6 pt-3.5 pb-6 max-[760px]:px-3 max-[760px]:pt-3", children: _jsx(ContexteDuCadre.Provider, { value: cadre, children: _jsx(EcranDUneChose, { choses: choses, id: id }, id) }) })] }), annonce && createPortal(_jsx(Annonce, { message: annonce, onFin: () => setAnnonce(undefined), className: "z-[60]" }), document.body)] }));
21
+ const cadre = useMemo(() => ({ fin, gestes, menu, seule: true }), [fin, gestes, menu]);
22
+ return (_jsxs(ContexteDeLAnnonce.Provider, { value: setAnnonce, children: [_jsxs("div", { className: "flex h-dvh min-w-0 flex-col bg-papier text-encre", children: [_jsx(TeteDUneChoseSeule, { setFin: setFin, setGestes: setGestes, setMenu: setMenu }), _jsx("main", { className: "flex min-h-0 min-w-0 flex-1 flex-col overflow-y-auto px-6 pt-3.5 pb-6 max-[760px]:px-3 max-[760px]:pt-3", children: _jsx(ContexteDuCadre.Provider, { value: cadre, children: _jsx(EcranDUneChose, { choses: choses, id: id }, id) }) })] }), annonce && createPortal(_jsx(Annonce, { message: annonce, onFin: () => setAnnonce(undefined), className: "z-[60]" }), document.body)] }));
30
23
  }
31
24
  // La tête mince d'une chose seule, d'une ligne, qu'un trait ferme : la marque de l'OS, son logo ou
32
25
  // son initiale, qui mène à l'accueil ; l'emplacement du nom, le `<h1>`, que l'écran de la chose rend ;
33
- // puis ceux du bloc de l'accès et du ⋯, de part et d'autre de l'épingle de la chose. Une chose
34
- // introuvable ne montre l'épingle que si son chemin est dans la barre, pour la retirer.
35
- export function TeteDUneChoseSeule({ ecran, chemin, setFin, setGestes, setMenu }) {
26
+ // puis ceux du bloc de l'accès et du ⋯.
27
+ export function TeteDUneChoseSeule({ setFin, setGestes, setMenu }) {
36
28
  const session = useSession();
37
29
  const { theme } = session;
38
30
  const [initiale = ''] = theme.nom.trim();
39
- const epingleMontree = !ecran.introuvable || estEpingle(session.barre, chemin);
40
31
  return (_jsxs("header", { className: "flex min-h-11 flex-none items-center gap-x-3 border-b border-trait px-4 max-[760px]:px-3", children: [_jsx(LienDansLaPage, { href: "/", "aria-label": `${theme.nom}, accueil`, title: theme.nom, className: "grid size-7 flex-none place-items-center rounded-md no-underline hover:bg-survol", children: theme.logo
41
32
  ? (_jsx("span", { className: "grid size-6 place-items-center rounded-[6px] border border-trait bg-papier-du-logo", children: _jsx("img", { alt: "", src: "/theme/logo.svg", className: "block size-4" }) }))
42
- : (_jsx("span", { "aria-hidden": "true", className: "grid size-6 place-items-center rounded-[6px] border border-trait bg-papier text-[13px] text-encre", children: initiale.toLocaleUpperCase('fr') })) }), _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" }), epingleMontree && _jsx(EpingleDuCadre, { chemin: chemin, nom: ecran.nom }, chemin), _jsx("div", { ref: setMenu, className: "flex items-center empty:hidden" })] })] }));
33
+ : (_jsx("span", { "aria-hidden": "true", className: "grid size-6 place-items-center rounded-[6px] border border-trait bg-papier text-[13px] text-encre", children: initiale.toLocaleUpperCase('fr') })) }), _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" }), _jsx("div", { ref: setMenu, className: "flex items-center empty:hidden" })] })] }));
43
34
  }
@@ -50,7 +50,7 @@ export type AncetreDUneChose = {
50
50
  nom: string;
51
51
  chemin: string;
52
52
  };
53
- export type { FenetreDuMenu, GesteDuMenu } from '../ui/menu-d-une-ligne.tsx';
53
+ export type { FenetreDuMenu, GesteDuMenu, GroupeDuMenu } from '../ui/menu-d-une-ligne.tsx';
54
54
  export type FormulaireDUneFicheDeclare<C extends ChoseTrouvee = ChoseTrouvee> = {
55
55
  champs: ComponentType<{
56
56
  chose?: C;
@@ -70,12 +70,10 @@ export type MotsDUnGeste = {
70
70
  };
71
71
  export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
72
72
  app: string;
73
+ ecran?: string;
73
74
  une: string;
74
75
  feminin?: boolean;
75
- liste?: {
76
- titre: string;
77
- chemin: string;
78
- };
76
+ nouvelle?: string;
79
77
  sorte?: string;
80
78
  colonnes?: ColonneDUneChose<C>[];
81
79
  vues?: VueDeLaListe[];
@@ -115,6 +113,7 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
115
113
  a: string;
116
114
  confirmer: true;
117
115
  }) => Promise<unknown>;
116
+ peutDonner?: (chose: C) => boolean;
118
117
  nouveau?: () => Promise<{
119
118
  chemin: string;
120
119
  } | undefined | void>;
@@ -165,6 +164,7 @@ export declare function estRangee<C extends ChoseTrouvee>(choses: DeclarationDes
165
164
  export declare function motsDe(declaration: {
166
165
  une: string;
167
166
  feminin?: boolean;
167
+ nouvelle?: string;
168
168
  }): {
169
169
  e: string;
170
170
  laChose: string;
@@ -173,6 +173,10 @@ export declare function motsDe(declaration: {
173
173
  nouvelle: string;
174
174
  pronom: string;
175
175
  };
176
+ export declare function cheminDeLaListe(choses: {
177
+ app: string;
178
+ ecran?: string;
179
+ }): string;
176
180
  export declare function cleDesChoses(app: string, ...suite: unknown[]): unknown[];
177
181
  export declare function cleDUneChose(choses: {
178
182
  app: string;
@@ -51,12 +51,13 @@ export function rechercheDeLaListe(recherche) {
51
51
  ...(typeof apercu === 'string' && apercu ? { apercu } : {}),
52
52
  };
53
53
  }
54
- // Le critère que `chercher` reçoit pour une recherche de la liste : la vue par défaut ne s'y dit
55
- // pas.
54
+ // Le critère que `chercher` reçoit pour une recherche de la liste : toujours sa vue, la première
55
+ // par défaut ; sans vue, l'outil chercherait dans tout ce que la personne voit.
56
56
  export function critereDeLaListe(vues, recherche) {
57
57
  const premiere = vues?.[0]?.valeur;
58
58
  const vue = recherche.vue && vues?.some((une) => une.valeur === recherche.vue) ? recherche.vue : undefined;
59
- return { ...(recherche.texte ? { texte: recherche.texte } : {}), ...(vue && vue !== premiere ? { vue } : {}), page: recherche.page ?? 1 };
59
+ const choisie = vue ?? premiere;
60
+ return { ...(recherche.texte ? { texte: recherche.texte } : {}), ...(choisie ? { vue: choisie } : {}), page: recherche.page ?? 1 };
60
61
  }
61
62
  // La date d'une chose : celle que l'app déclare, sinon sa dernière modification, sinon aucune.
62
63
  export function dateDe(choses, chose) {
@@ -103,11 +104,15 @@ export function motsDe(declaration) {
103
104
  // « Page », pour l'en-tête de la colonne.
104
105
  titre: une.charAt(0).toLocaleUpperCase('fr') + une.slice(1),
105
106
  aucune: `${feminin ? 'Aucune' : 'Aucun'} ${une}`,
106
- nouvelle: `${feminin ? 'Nouvelle' : 'Nouveau'} ${une}`,
107
+ nouvelle: declaration.nouvelle ?? `${feminin ? 'Nouvelle' : 'Nouveau'} ${une}`,
107
108
  // Le pronom : « la », « le ».
108
109
  pronom: feminin ? 'la' : 'le',
109
110
  };
110
111
  }
112
+ // Le chemin de la liste d'une déclaration : `/<app>/<ecran>`, `/<app>/liste` par défaut.
113
+ export function cheminDeLaListe(choses) {
114
+ return `/${choses.app}/${choses.ecran ?? 'liste'}`;
115
+ }
111
116
  // Les clés des requêtes des choses d'une app, que chaque geste relit. `cleDesChoses(app, 'chose', id)`
112
117
  // est la chose lue de son écran : un geste de l'app la retouche (`setQueryData`), comme un nom qui
113
118
  // suit la frappe.