@indos/bibliotheque 2.4.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 (115) 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/cadre.d.ts +3 -5
  16. package/src/espace/cadre.js +29 -31
  17. package/src/espace/chose-seule.d.ts +1 -4
  18. package/src/espace/chose-seule.js +7 -16
  19. package/src/espace/choses.d.ts +9 -5
  20. package/src/espace/choses.js +9 -4
  21. package/src/espace/comptes.js +146 -103
  22. package/src/espace/coquille.d.ts +5 -5
  23. package/src/espace/coquille.js +93 -63
  24. package/src/espace/doubles-de-jsdom.js +11 -4
  25. package/src/espace/ecran-d-une-chose.js +10 -9
  26. package/src/espace/ecran.js +1 -2
  27. package/src/espace/edition-de-la-barre.js +35 -11
  28. package/src/espace/essai.js +4 -4
  29. package/src/espace/fenetre-du-don.d.ts +11 -0
  30. package/src/espace/fenetre-du-don.js +41 -0
  31. package/src/espace/index.d.ts +3 -3
  32. package/src/espace/index.js +3 -3
  33. package/src/espace/liste-des-choses.js +28 -24
  34. package/src/espace/menu-d-une-chose.js +15 -51
  35. package/src/espace/ouvrir.d.ts +3 -3
  36. package/src/espace/ouvrir.js +15 -14
  37. package/src/espace/panneau-du-partage.d.ts +8 -3
  38. package/src/espace/panneau-du-partage.js +36 -14
  39. package/src/espace/routes-des-choses.js +6 -5
  40. package/src/espace/session.d.ts +1 -0
  41. package/src/faux-core.d.ts +15 -3
  42. package/src/faux-core.js +71 -3
  43. package/src/fichiers.d.ts +2 -0
  44. package/src/fichiers.js +6 -4
  45. package/src/flux.js +1 -1
  46. package/src/format.d.ts +3 -0
  47. package/src/format.js +20 -1
  48. package/src/forme-du-direct.js +1 -1
  49. package/src/jeton.js +2 -2
  50. package/src/liens.js +1 -1
  51. package/src/mcp.js +3 -3
  52. package/src/notifier.d.ts +10 -0
  53. package/src/notifier.js +47 -0
  54. package/src/page.d.ts +17 -0
  55. package/src/page.js +139 -14
  56. package/src/partage.d.ts +5 -1
  57. package/src/partage.js +61 -16
  58. package/src/presence.js +1 -1
  59. package/src/sans-accents.js +1 -1
  60. package/src/session.js +4 -4
  61. package/src/theme.js +1 -1
  62. package/src/ui/blocs.d.ts +5 -2
  63. package/src/ui/blocs.js +11 -6
  64. package/src/ui/choix.d.ts +2 -1
  65. package/src/ui/choix.js +3 -2
  66. package/src/ui/fenetre.d.ts +8 -3
  67. package/src/ui/fenetre.js +34 -9
  68. package/src/ui/focus.d.ts +2 -0
  69. package/src/ui/focus.js +5 -0
  70. package/src/ui/gestes-du-contenu.d.ts +21 -0
  71. package/src/ui/gestes-du-contenu.js +24 -0
  72. package/src/ui/icones.d.ts +7 -0
  73. package/src/ui/icones.js +12 -1
  74. package/src/ui/index.d.ts +5 -4
  75. package/src/ui/index.js +4 -3
  76. package/src/ui/lien.d.ts +1 -0
  77. package/src/ui/lien.js +2 -2
  78. package/src/ui/menu-d-une-ligne.d.ts +2 -0
  79. package/src/ui/panneau.d.ts +1 -2
  80. package/src/ui/panneau.js +8 -4
  81. package/src/ui/reglages.d.ts +47 -0
  82. package/src/ui/reglages.js +101 -0
  83. package/src/ui/tableau.d.ts +1 -2
  84. package/src/ui/tableau.js +8 -12
  85. package/src/ui/vues.js +1 -1
  86. package/src/vite.d.ts +3 -0
  87. package/src/vite.js +50 -18
  88. package/CHANGELOG.md +0 -295
  89. package/bin/bibliotheque.d.ts +0 -1
  90. package/bin/bibliotheque.js +0 -62
  91. package/modeles/app-du-client/.dockerignore +0 -3
  92. package/modeles/app-du-client/DOCUMENTATION.md +0 -27
  93. package/modeles/app-du-client/Dockerfile +0 -36
  94. package/modeles/app-du-client/README.md +0 -53
  95. package/modeles/app-du-client/USAGE.md +0 -3
  96. package/modeles/app-du-client/espace/ecrans/entrees.tsx +0 -57
  97. package/modeles/app-du-client/espace/index.html +0 -9
  98. package/modeles/app-du-client/espace/page.tsx +0 -6
  99. package/modeles/app-du-client/espace/requetes/entrees.ts +0 -16
  100. package/modeles/app-du-client/espace/routes.ts +0 -12
  101. package/modeles/app-du-client/espace/tsconfig.json +0 -7
  102. package/modeles/app-du-client/gitignore +0 -2
  103. package/modeles/app-du-client/logo.svg +0 -1
  104. package/modeles/app-du-client/migrations/0001-creer-les-entrees.sql +0 -10
  105. package/modeles/app-du-client/module.json +0 -12
  106. package/modeles/app-du-client/package.json +0 -17
  107. package/modeles/app-du-client/src/demarrer.ts +0 -17
  108. package/modeles/app-du-client/src/outils.ts +0 -48
  109. package/modeles/app-du-client/src/serveur.ts +0 -46
  110. package/modeles/app-du-client/tests/espace/entrees.test.tsx +0 -57
  111. package/modeles/app-du-client/tests/serveur.test.ts +0 -119
  112. package/modeles/app-du-client/tests/sources-de-la-page.test.ts +0 -23
  113. package/modeles/app-du-client/tsconfig.json +0 -22
  114. package/src/ui/repli.d.ts +0 -12
  115. package/src/ui/repli.js +0 -6
@@ -4,6 +4,7 @@ export type FenetreDuMenu = {
4
4
  onOuverteChange: (ouverte: boolean) => void;
5
5
  retour: RefObject<HTMLButtonElement | null>;
6
6
  };
7
+ export type GroupeDuMenu = 'ouvrir' | 'changer' | 'copie' | 'clore';
7
8
  export type GesteDuMenu = {
8
9
  libelle: string;
9
10
  choisir?: () => void;
@@ -13,6 +14,7 @@ export type GesteDuMenu = {
13
14
  fenetre?: (fenetre: FenetreDuMenu) => ReactNode;
14
15
  detruit?: boolean;
15
16
  inactif?: boolean;
17
+ groupe?: GroupeDuMenu;
16
18
  };
17
19
  export type ProprietesDuMenuDUneLigne = {
18
20
  nom?: string;
@@ -1,7 +1,6 @@
1
1
  import { type ReactElement, type ReactNode, type RefObject } from 'react';
2
2
  export type ProprietesDUnPanneau = {
3
3
  titre: string;
4
- surtitre?: string;
5
4
  etiquette?: ReactNode;
6
5
  declencheur?: ReactElement;
7
6
  ouvert?: boolean;
@@ -10,4 +9,4 @@ export type ProprietesDUnPanneau = {
10
9
  className?: string;
11
10
  children: ReactNode;
12
11
  };
13
- export declare function Panneau({ titre, surtitre, etiquette, declencheur, ouvert, onOuvertChange, retour, className, children }: ProprietesDUnPanneau): import("react").JSX.Element;
12
+ export declare function Panneau({ titre, etiquette, declencheur, ouvert, onOuvertChange, retour, className, children }: ProprietesDUnPanneau): import("react").JSX.Element;
package/src/ui/panneau.js CHANGED
@@ -2,18 +2,22 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { useRef } from 'react';
3
3
  import { Dialog } from 'radix-ui';
4
4
  import { classesDuTitreDeSection } from './blocs.js';
5
- import { Bouton } from './bouton.js';
6
5
  import { cn } from './classes.js';
7
- export function Panneau({ titre, surtitre, etiquette, declencheur, ouvert, onOuvertChange, retour, className, children }) {
6
+ import { attributDuFocusALOuverture, saisies } from './focus.js';
7
+ import { classesDUneIcone, IconeFermer } from './icones.js';
8
+ export function Panneau({ titre, etiquette, declencheur, ouvert, onOuvertChange, retour, className, children }) {
8
9
  // Ce qui avait le focus à l'ouverture, où il revient à la fermeture, même sans déclencheur.
9
10
  const avant = useRef(null);
10
- return (_jsxs(Dialog.Root, { open: ouvert, onOpenChange: onOuvertChange, children: [declencheur && _jsx(Dialog.Trigger, { asChild: true, children: declencheur }), _jsxs(Dialog.Portal, { children: [_jsx(Dialog.Overlay, { className: "fixed inset-0 z-50 bg-papier/60" }), _jsxs(Dialog.Content, { "aria-describedby": undefined, onOpenAutoFocus: () => {
11
+ return (_jsxs(Dialog.Root, { open: ouvert, onOpenChange: onOuvertChange, children: [declencheur && _jsx(Dialog.Trigger, { asChild: true, children: declencheur }), _jsxs(Dialog.Portal, { children: [_jsx(Dialog.Overlay, { className: "fixed inset-0 z-50 bg-papier/60" }), _jsxs(Dialog.Content, { "aria-describedby": undefined, onOpenAutoFocus: (evenement) => {
11
12
  avant.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
13
+ const panneau = evenement.currentTarget;
14
+ evenement.preventDefault();
15
+ (panneau.querySelector(`[${attributDuFocusALOuverture}]`) ?? panneau.querySelector(saisies) ?? panneau).focus();
12
16
  }, onCloseAutoFocus: (evenement) => {
13
17
  const cible = retour?.current?.isConnected ? retour.current : avant.current;
14
18
  if (cible?.isConnected) {
15
19
  evenement.preventDefault();
16
20
  cible.focus();
17
21
  }
18
- }, className: cn('fixed inset-y-0 right-0 z-50 flex w-[min(560px,100%)] flex-col border-l border-trait bg-papier text-encre', 'max-[760px]:w-full max-[760px]:border-l-0', className), children: [_jsxs("div", { className: "flex items-start justify-between gap-4 border-b border-trait px-[22px] py-4", children: [_jsxs("div", { className: "min-w-0", children: [surtitre && _jsx("p", { className: cn(classesDuTitreDeSection, 'mb-1'), children: surtitre }), _jsx(Dialog.Title, { className: "m-0 font-titre text-[26px] leading-[1.1] font-normal [overflow-wrap:anywhere]", children: titre }), etiquette && _jsx("div", { className: "mt-2", children: etiquette })] }), _jsx(Dialog.Close, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "discret", children: "Fermer" }) })] }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto px-[22px] py-5", children: children })] })] })] }));
22
+ }, tabIndex: -1, className: cn('fixed inset-y-0 right-0 z-50 flex w-[min(560px,100%)] flex-col border-l border-trait bg-papier pt-4 text-encre outline-none', 'max-[760px]:w-full max-[760px]:border-l-0 max-[760px]:pt-3', className), 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(Dialog.Title, { className: cn(classesDuTitreDeSection, 'min-w-0 [overflow-wrap:anywhere]'), children: titre }), etiquette, _jsx(Dialog.Close, { asChild: true, children: _jsx("button", { type: "button", "aria-label": "Fermer", title: "Fermer", className: cn(classesDUneIcone, 'ms-auto'), children: _jsx(IconeFermer, {}) }) })] }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto px-5 pt-3.5 pb-6 max-[760px]:px-3", children: children })] })] })] }));
19
23
  }
@@ -0,0 +1,47 @@
1
+ import { type ReactNode, type RefObject } from 'react';
2
+ import { type Etape } from './blocs.tsx';
3
+ import { type GesteDuMenu } from './menu-d-une-ligne.tsx';
4
+ export type GesteDeReglage = GesteDuMenu & {
5
+ court?: string;
6
+ nom?: string;
7
+ };
8
+ export type LigneDeReglage = {
9
+ cle?: string;
10
+ nom: string;
11
+ detail?: ReactNode;
12
+ etat?: ReactNode;
13
+ acces?: ReactNode;
14
+ gestes?: (GesteDeReglage | false | null | undefined)[][];
15
+ menu?: boolean;
16
+ };
17
+ export declare function LignesDeReglages({ lignes, className }: {
18
+ lignes: LigneDeReglage[];
19
+ className?: string;
20
+ }): import("react").JSX.Element;
21
+ export declare function SecretGarde({ libelle, name, id, aide, enregistre, requis }: {
22
+ libelle: string;
23
+ name: string;
24
+ id: string;
25
+ aide?: string;
26
+ enregistre: boolean;
27
+ requis?: boolean;
28
+ }): import("react").JSX.Element;
29
+ export type ProprietesDuPanneauEnDeuxTemps = {
30
+ titre: string;
31
+ fournisseur?: string;
32
+ introduction?: string;
33
+ etapes?: Etape[];
34
+ note?: string;
35
+ modification?: boolean;
36
+ verbe: string;
37
+ onEnvoyer: (donnees: FormData) => unknown;
38
+ ouvert: boolean;
39
+ onOuvertChange: (ouvert: boolean) => void;
40
+ retour?: RefObject<HTMLElement | null>;
41
+ children: ReactNode;
42
+ };
43
+ export declare function PanneauEnDeuxTemps({ ouvert, onOuvertChange, retour, titre, ...suite }: ProprietesDuPanneauEnDeuxTemps): import("react").JSX.Element;
44
+ export declare function ValeurMontreeUneFois({ valeur, consigne }: {
45
+ valeur: string;
46
+ consigne?: string;
47
+ }): import("react").JSX.Element;
@@ -0,0 +1,101 @@
1
+ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { useEffect, useRef, useState } from 'react';
3
+ import { Etapes, Lignes, Message } from './blocs.js';
4
+ import { Bouton } from './bouton.js';
5
+ import { Champ, Saisie } from './champ.js';
6
+ import { cn } from './classes.js';
7
+ import { GesteApresLaValeur, GesteAuBoutDeLaLigne } from './gestes-du-contenu.js';
8
+ import { MenuDUneLigne } from './menu-d-une-ligne.js';
9
+ import { Panneau } from './panneau.js';
10
+ import { saisies } from './focus.js';
11
+ export function LignesDeReglages({ lignes, className }) {
12
+ return (_jsx(Lignes, { className: className, lignes: lignes.map((ligne) => ({
13
+ cle: ligne.cle,
14
+ nom: ligne.nom,
15
+ texte: ligne.detail && _jsx("span", { className: "font-mono text-[12.5px] [overflow-wrap:anywhere]", children: ligne.detail }),
16
+ fin: _jsx(FinDUneLigne, { ligne: ligne }),
17
+ })) }));
18
+ }
19
+ function FinDUneLigne({ ligne }) {
20
+ const groupes = (ligne.gestes ?? []).map((groupe) => groupe.filter((geste) => Boolean(geste))).filter((groupe) => groupe.length > 0);
21
+ const tous = groupes.flat();
22
+ return (_jsxs(_Fragment, { children: [ligne.etat, ligne.acces, ligne.menu || tous.length > 2
23
+ ? _jsx(MenuDUneLigne, { nom: ligne.nom, groupes: groupes })
24
+ : tous.map((geste) => _jsx(GesteSurLaLigne, { geste: geste }, geste.libelle))] }));
25
+ }
26
+ function GesteSurLaLigne({ geste }) {
27
+ const [ouverte, setOuverte] = useState(false);
28
+ const retour = useRef(null);
29
+ const texte = geste.court ?? geste.libelle;
30
+ if (geste.lien) {
31
+ return _jsx(GesteAuBoutDeLaLigne, { lien: geste.lien, nom: geste.nom, children: texte });
32
+ }
33
+ return (_jsxs(_Fragment, { children: [_jsx(GesteAuBoutDeLaLigne, { ref: retour, nom: geste.nom, disabled: geste.inactif, onClick: () => (geste.fenetre ? setOuverte(true) : geste.choisir?.()), className: cn(geste.detruit && 'hover:text-erreur'), children: texte }), geste.fenetre?.({ ouverte, onOuverteChange: setOuverte, retour })] }));
34
+ }
35
+ // Un secret : enregistré, il se montre comme une valeur, des points, « enregistré » et « Remplacer »,
36
+ // qui fait apparaître le champ ; sans ce clic, aucune saisie, et le formulaire n'envoie rien pour lui,
37
+ // ce que l'app lit comme « garder celui qui est enregistré ». Pas encore enregistré, c'est un champ.
38
+ export function SecretGarde({ libelle, name, id, aide, enregistre, requis }) {
39
+ const [remplace, setRemplace] = useState(false);
40
+ if (enregistre && !remplace) {
41
+ return (_jsxs("div", { role: "group", "aria-label": libelle, className: "grid gap-1.5", children: [_jsx("span", { className: "text-[13px] font-medium", children: libelle }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { "aria-hidden": "true", className: "font-mono text-gris", children: "\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022" }), _jsx("span", { className: "text-gris", children: "enregistr\u00E9" }), _jsx(GesteApresLaValeur, { nom: `Remplacer ${libelle}`, onClick: () => setRemplace(true), children: "Remplacer" })] })] }));
42
+ }
43
+ return (_jsx(Champ, { id: id, libelle: libelle, aide: aide, children: _jsx(Saisie, { name: name, type: "password", autoComplete: "new-password", required: requis, autoFocus: remplace }) }));
44
+ }
45
+ export function PanneauEnDeuxTemps({ ouvert, onOuvertChange, retour, titre, ...suite }) {
46
+ return (_jsx(Panneau, { titre: titre, ouvert: ouvert, onOuvertChange: onOuvertChange, retour: retour, children: ouvert && _jsx(DeuxTemps, { ...suite, fermer: () => onOuvertChange(false) }) }));
47
+ }
48
+ function DeuxTemps({ fournisseur, introduction, etapes = [], note, modification = false, verbe, onEnvoyer, fermer, children }) {
49
+ const avecEtapes = etapes.length > 0;
50
+ const [temps, setTemps] = useState(avecEtapes && !modification ? 1 : 2);
51
+ const [erreur, setErreur] = useState();
52
+ const [occupe, setOccupe] = useState(false);
53
+ const deuxieme = useRef(null);
54
+ const premier = useRef(null);
55
+ const [change, setChange] = useState(false);
56
+ // Passer d'un temps à l'autre rend le focus au premier champ du temps montré, sinon au temps.
57
+ useEffect(() => {
58
+ if (!change) {
59
+ return;
60
+ }
61
+ const cible = temps === 2 ? deuxieme.current : premier.current;
62
+ (cible?.querySelector(saisies) ?? cible)?.focus();
63
+ }, [temps, change]);
64
+ function aller(suivant) {
65
+ setChange(true);
66
+ setTemps(suivant);
67
+ }
68
+ async function envoyer(evenement) {
69
+ evenement.preventDefault();
70
+ setErreur(undefined);
71
+ setOccupe(true);
72
+ try {
73
+ await onEnvoyer(new FormData(evenement.currentTarget));
74
+ fermer();
75
+ }
76
+ catch (raison) {
77
+ setErreur(raison instanceof Error ? raison.message : String(raison));
78
+ }
79
+ finally {
80
+ setOccupe(false);
81
+ }
82
+ }
83
+ return (_jsxs("div", { className: "grid gap-4", children: [avecEtapes && (_jsxs("ol", { "aria-label": "Les deux temps", className: "m-0 flex list-none gap-4 p-0 text-[13px] text-gris", children: [_jsxs("li", { "aria-current": temps === 1 ? 'step' : undefined, className: cn(temps === 1 && 'font-semibold text-encre'), children: ["1 \u00B7 Chez ", fournisseur] }), _jsx("li", { "aria-current": temps === 2 ? 'step' : undefined, className: cn(temps === 2 && 'font-semibold text-encre'), children: "2 \u00B7 Dans l'OS" })] })), avecEtapes && (_jsxs("div", { ref: premier, tabIndex: -1, hidden: temps !== 1, className: "grid gap-4 outline-none", children: [introduction && _jsx("p", { className: "m-0 text-gris", children: introduction }), _jsx(Etapes, { etapes: etapes }), _jsx("div", { children: _jsx(Bouton, { type: "button", onClick: () => aller(2), children: "Continuer" }) })] })), _jsx("div", { ref: deuxieme, tabIndex: -1, hidden: temps !== 2, className: "outline-none", children: _jsxs("form", { className: "grid gap-4", onSubmit: envoyer, children: [children, note && _jsx("p", { className: "m-0 text-[12.5px] text-gris", children: note }), avecEtapes && modification && (_jsx("div", { children: _jsxs(GesteApresLaValeur, { className: "ml-0", onClick: () => aller(1), children: ["Revoir les \u00E9tapes chez ", fournisseur] }) })), erreur && _jsx(Message, { erreur: true, titre: "Rien n'est enregistr\u00E9", texte: erreur, className: "mb-0" }), _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx(Bouton, { type: "submit", disabled: occupe, "aria-busy": occupe || undefined, children: verbe }), avecEtapes && !modification && _jsx(Bouton, { type: "button", sorte: "secondaire", onClick: () => aller(1), children: "Retour" })] })] }) })] }));
84
+ }
85
+ // Une valeur montrée une fois, à la dernière étape d'une fenêtre (`derniereEtape` de `Fenetre`) : la
86
+ // valeur entière, sélectionnable d'un geste, « Copier », la consigne de l'écran s'il y en a une, puis
87
+ // « Il ne sera plus montré. ». « Copier » annonce « Copié » ; un navigateur qui refuse la copie dit de
88
+ // sélectionner la valeur, qui reste à l'écran.
89
+ export function ValeurMontreeUneFois({ valeur, consigne }) {
90
+ const [etat, setEtat] = useState();
91
+ async function copier() {
92
+ try {
93
+ await navigator.clipboard.writeText(valeur);
94
+ setEtat('copie');
95
+ }
96
+ catch {
97
+ setEtat('refus');
98
+ }
99
+ }
100
+ return (_jsxs("div", { className: "grid gap-3", children: [_jsxs("div", { className: "flex items-start gap-2", children: [_jsx("div", { className: "min-w-0 flex-1 rounded-md border border-trait bg-surface px-3 py-2.5 font-mono text-[13.5px] leading-[1.4] text-encre whitespace-pre-line select-all [overflow-wrap:anywhere]", children: valeur }), _jsx(Bouton, { type: "button", sorte: "secondaire", taille: "petite", onClick: () => void copier(), children: "Copier" })] }), _jsx("p", { role: "status", className: "m-0 min-h-[1.4em] text-[12.5px] text-gris", children: etat === 'copie' ? 'Copié.' : etat === 'refus' ? 'Le navigateur refuse la copie : sélectionnez la valeur, puis copiez-la.' : '' }), _jsxs("p", { className: "m-0 text-gris", children: [consigne && _jsxs(_Fragment, { children: [consigne, " "] }), "Il ne sera plus montr\u00E9."] })] }));
101
+ }
@@ -15,8 +15,7 @@ export type ProprietesDUnTableau = {
15
15
  vide?: string;
16
16
  pagination?: Pagination;
17
17
  onOuvrirLigne?: (rang: number) => void;
18
- onOuvrirEnGrand?: (rang: number) => void;
19
18
  ligneOuverte?: number;
20
19
  className?: string;
21
20
  };
22
- export declare function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, onOuvrirEnGrand, ligneOuverte, className }: ProprietesDUnTableau): import("react").JSX.Element;
21
+ export declare function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, ligneOuverte, className }: ProprietesDUnTableau): import("react").JSX.Element;
package/src/ui/tableau.js CHANGED
@@ -16,7 +16,7 @@ function etendue(page, total, lignes) {
16
16
  const elementsDUneLigne = 'a, button, input, select, textarea, label, [role=menuitem], [role=menu], [role=dialog], [role=alertdialog]';
17
17
  // Un clic qui ouvre la ligne : un clic simple, fait dans la ligne elle-même. Un clic venu d'un
18
18
  // portail (un menu, une fenêtre), que React fait remonter par la ligne sans qu'il soit dedans, ne
19
- // l'ouvre pas, ni un clic dans un élément qui a son propre geste. Le double-clic suit la même règle.
19
+ // l'ouvre pas, ni un clic dans un élément qui a son propre geste.
20
20
  function ouvreLaLigne(evenement) {
21
21
  const cible = evenement.target;
22
22
  if (evenement.defaultPrevented || evenement.button !== 0 || evenement.metaKey || evenement.ctrlKey || evenement.shiftKey || evenement.altKey) {
@@ -30,12 +30,12 @@ function ouvreLaLigne(evenement) {
30
30
  // Un tableau : ses colonnes, ses lignes, chaque cellule un contenu, et `vide`, dit sans ligne. Avec
31
31
  // `pagination`, et plus d'une page, il a sous lui « Précédent », « Suivant » et l'étendue. Avec
32
32
  // `onOuvrirLigne`, un clic dans une ligne l'ouvre (`ouvreLaLigne`) ; au clavier, la ligne s'ouvre
33
- // par le lien qu'elle porte. Avec `onOuvrirEnGrand`, un double-clic l'ouvre en grand. `ligneOuverte`,
34
- // le rang de la ligne que montre l'aperçu d'une liste : `aria-current`, sur un fond doux. Sur un téléphone, jusqu'à 760 px, chaque ligne s'empile (la feuille,
35
- // `.tableau`) : les colonnes `tete` d'abord, dans leur ordre, la première colonne quand aucune ne
36
- // l'est ; la colonne sans titre en haut à droite ; puis les autres, chacune sur sa ligne, après son
37
- // titre en gris (`data-titre`).
38
- export function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, onOuvrirEnGrand, ligneOuverte, className }) {
33
+ // par le lien qu'elle porte. `ligneOuverte`, le rang de la ligne que montre l'aperçu d'une liste :
34
+ // `aria-current`, sur un fond doux. Chaque cellule est centrée en hauteur. Sur un téléphone, jusqu'à
35
+ // 760 px, chaque ligne s'empile (la feuille, `.tableau`) : les colonnes `tete` d'abord, dans leur
36
+ // ordre, la première colonne quand aucune ne l'est ; la colonne sans titre en haut à droite ; puis
37
+ // les autres, chacune sur sa ligne, après son titre en gris (`data-titre`).
38
+ export function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, ligneOuverte, className }) {
39
39
  const avecTete = colonnes.some((colonne) => colonne.tete);
40
40
  const marques = colonnes.map((colonne, rang) => ({
41
41
  'data-tete': (avecTete ? colonne.tete : rang === 0) ? '' : undefined,
@@ -47,11 +47,7 @@ export function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, onO
47
47
  if (ouvreLaLigne(evenement)) {
48
48
  onOuvrirLigne(rang);
49
49
  }
50
- }), onDoubleClick: onOuvrirEnGrand && ((evenement) => {
51
- if (ouvreLaLigne(evenement)) {
52
- onOuvrirEnGrand(rang);
53
- }
54
- }), className: cn('border-t border-trait first:border-t-0', onOuvrirLigne && 'cursor-pointer', rang === ligneOuverte ? 'bg-accent/10' : onOuvrirLigne && 'hover:bg-surface'), children: ligne.map((cellule, colonne) => (_jsx("td", { ...marques[colonne], className: cn('px-3.5 py-2.5 align-top', colonnes[colonne]?.fixe && 'font-mono text-[12.5px] whitespace-nowrap tabular-nums', colonnes[colonne]?.titre === '' && 'w-px py-1.5 pr-2 whitespace-nowrap'), children: cellule }, colonne))) }, rang)))
50
+ }), className: cn('border-t border-trait first:border-t-0', onOuvrirLigne && 'cursor-pointer', rang === ligneOuverte ? 'bg-accent/10' : onOuvrirLigne && 'hover:bg-surface'), children: ligne.map((cellule, colonne) => (_jsx("td", { ...marques[colonne], className: cn('px-3.5 py-2.5 align-middle', colonnes[colonne]?.fixe && 'font-mono text-[12.5px] whitespace-nowrap tabular-nums', colonnes[colonne]?.titre === '' && 'w-px py-1.5 pr-2 whitespace-nowrap'), children: cellule }, colonne))) }, rang)))
55
51
  : (_jsx("tr", { children: _jsx("td", { colSpan: colonnes.length, className: "px-3.5 py-2.5 text-gris", children: vide }) })) })] }) }), pagination && _jsx(Pages, { ...pagination, lignes: lignes.length })] }));
56
52
  }
57
53
  function Pages({ page, total, changerDePage, lignes }) {
package/src/ui/vues.js CHANGED
@@ -4,7 +4,7 @@ import { nombre } from '../format.js';
4
4
  import { cn } from './classes.js';
5
5
  import { GestesDeLaLigne } from './recherche.js';
6
6
  export function Vues({ vues, valeur, onValeurChange, nom, gestes, className, children }) {
7
- const liste = (_jsx(Tabs.List, { "aria-label": nom, className: "flex flex-wrap gap-1", children: vues.map((vue) => (_jsxs(Tabs.Trigger, { value: vue.valeur, className: cn('flex h-7 cursor-pointer items-center gap-2 rounded-md border border-transparent bg-transparent px-2.5 text-[13.5px] font-medium text-gris hover:bg-survol hover:text-encre', 'data-[state=active]:border-trait data-[state=active]:bg-surface data-[state=active]:text-encre'), children: [vue.titre, vue.nombre !== undefined && _jsx("span", { className: "font-mono text-[12px] text-gris tabular-nums", children: nombre(vue.nombre) })] }, vue.valeur))) }));
7
+ const liste = (_jsx(Tabs.List, { "aria-label": nom, className: "flex flex-wrap gap-1", children: vues.map((vue) => (_jsxs(Tabs.Trigger, { value: vue.valeur, className: cn('flex h-7 cursor-pointer items-center gap-2 rounded-md border border-transparent bg-transparent px-2.5 text-[13.5px] font-medium text-gris hover:text-encre', 'data-[state=active]:border-trait data-[state=active]:bg-surface data-[state=active]:text-encre'), children: [vue.titre, vue.nombre !== undefined && _jsx("span", { className: "font-mono text-[12px] text-gris tabular-nums", children: nombre(vue.nombre) })] }, vue.valeur))) }));
8
8
  return (_jsxs(Tabs.Root, { value: valeur, onValueChange: onValeurChange, className: className, children: [gestes
9
9
  ? (_jsxs("div", { className: "flex items-center justify-between gap-x-4 gap-y-2 max-[760px]:flex-col max-[760px]:items-stretch", children: [liste, _jsx(GestesDeLaLigne, { children: gestes })] }))
10
10
  : liste, _jsx(Tabs.Content, { value: valeur, className: "pt-3", children: children })] }));
package/src/vite.d.ts CHANGED
@@ -18,9 +18,12 @@ export declare function relais(options: {
18
18
  export declare function configurationDuDeveloppement(dossier: string, options: {
19
19
  core: string;
20
20
  app: string;
21
+ port?: number;
21
22
  }): InlineConfig;
22
23
  export declare function developperLaPage(dossier: string, options: {
23
24
  core: string;
24
25
  app: string;
26
+ port?: number;
25
27
  }): Promise<import("vite").ViteDevServer>;
26
28
  export declare function testerLaPage(dossier: string): Promise<void>;
29
+ export declare function fautesDeHtmlBrut(dossier: string): string[];
package/src/vite.js CHANGED
@@ -1,17 +1,18 @@
1
1
  import tailwindcss from '@tailwindcss/vite';
2
2
  import react from '@vitejs/plugin-react';
3
- import { existsSync, readFileSync, statSync } from 'node:fs';
3
+ import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
4
4
  import { join, resolve, sep } from 'node:path';
5
5
  import { fileURLToPath } from 'node:url';
6
6
  import { build, createServer } from 'vite';
7
7
  import { startVitest } from 'vitest/node';
8
8
  import { estUnEcranDesChoses } from './page.js';
9
- // La configuration Vite de la page de l'espace d'une pièce (bibliotheque/CLAUDE.md, « Écrire une
10
- // page ») : le dossier de la pièce a son `module.json` et sa page dans `espace/` (`espace/index.html`,
9
+ // La configuration Vite de la page de l'espace d'une pièce (indos/bibliotheque/CLAUDE.md, « Écrire une
10
+ // page ») : le dossier de la pièce a son `manifeste.json` et sa page dans `espace/` (`espace/index.html`,
11
11
  // qui lance `espace/page.tsx`). `construireLaPage` écrit le dossier construit, `dist/` ;
12
- // `developperLaPage` la sert à chaud sur `http://localhost:5173`, reliée au core et à l'app ;
13
- // `testerLaPage` lance ses tests de Vitest.
14
- // Le dossier de la bibliothèque : `bibliotheque/` dans le dépôt, `<app>/node_modules/@indos/bibliotheque/`
12
+ // `developperLaPage` la sert à chaud sur `http://localhost:<port>`, 5173 par défaut, reliée au core
13
+ // et à l'app ;
14
+ // `testerLaPage` refuse le HTML brut dans ses sources, puis lance ses tests de Vitest.
15
+ // Le dossier de la bibliothèque : `indos/bibliotheque/` dans le dépôt, `<app>/node_modules/@indos/bibliotheque/`
15
16
  // pour le paquet publié.
16
17
  const bibliotheque = fileURLToPath(new URL('..', import.meta.url));
17
18
  // Le module de la coquille, d'où se résolvent les dépendances du navigateur : sa source dans le
@@ -23,17 +24,19 @@ const doublesDeJsdom = fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? '
23
24
  // chacune, celle que la bibliothèque résout, même importée par la page d'une app ou ses tests. Yjs
24
25
  // surtout : deux copies dans une page ne se reconnaissent pas, et le direct (`@indos/bibliotheque/
25
26
  // direct/page`) ne lirait pas le document d'un éditeur qui importe l'autre.
26
- // Dans le dépôt, ce sont celles de `bibliotheque/node_modules`, dont une app du catalogue ne déclare
27
- // que React et React DOM, en liens vers elles (`file:../../bibliotheque/node_modules/react`) ; pour le
28
- // paquet publié, ses dépendances de pair, que npm installe dans `<app>/node_modules`.
27
+ // Dans le dépôt, ce sont celles de `indos/bibliotheque/node_modules`, dont une app du catalogue ne
28
+ // déclare que React et React DOM, en liens vers elles (`file:../../indos/bibliotheque/node_modules/react`) ;
29
+ // pour le paquet publié, ses dépendances de pair, que npm installe dans `<app>/node_modules`.
29
30
  const dependancesDuNavigateur = /^(react|react-dom|@tanstack\/react-router|@tanstack\/react-query|radix-ui|tailwind-merge|yjs|y-protocols|@hocuspocus\/provider|@testing-library\/[^/]+|vitest)(\/|$)/;
30
- // Le port du serveur de développement.
31
+ // Le port du serveur de développement, quand la pièce n'en choisit pas d'autre (`INDOS_PORT`) : il
32
+ // le prend ou refuse de démarrer (`strictPort`), pour que l'adresse de la page reste celle que l'app
33
+ // et le core attendent.
31
34
  export const portDeDeveloppement = 5173;
32
- // Ce que le `module.json` de la pièce dit de sa page : son nom, sa base (`/` pour le core,
35
+ // Ce que le `manifeste.json` de la pièce dit de sa page : son nom, sa base (`/` pour le core,
33
36
  // `/<app>/` pour une app) et son premier écran, où mène la racine en développement : le premier de
34
37
  // ses écrans, sinon ses réglages, comme la racine de l'app (`creerLaRacine`).
35
38
  export function lirePiece(dossier) {
36
- const manifeste = JSON.parse(readFileSync(join(dossier, 'module.json'), 'utf8'));
39
+ const manifeste = JSON.parse(readFileSync(join(dossier, 'manifeste.json'), 'utf8'));
37
40
  const base = manifeste.nom === 'core' ? '/' : `/${manifeste.nom}/`;
38
41
  const [premier] = manifeste.ecrans ?? [];
39
42
  const premierEcran = premier ? `${base}${premier.nom}` : manifeste.reglages ? `${base}reglages` : base;
@@ -106,7 +109,7 @@ export async function construireLaPage(dossier) {
106
109
  export function cheminsGardes(dossier) {
107
110
  const page = join(dossier, 'espace');
108
111
  const { base } = lirePiece(dossier);
109
- const manifeste = JSON.parse(readFileSync(join(dossier, 'module.json'), 'utf8'));
112
+ const manifeste = JSON.parse(readFileSync(join(dossier, 'manifeste.json'), 'utf8'));
110
113
  const ecrans = (manifeste.ecrans ?? []).map(({ nom }) => nom);
111
114
  if (manifeste.reglages) {
112
115
  ecrans.push('reglages');
@@ -199,9 +202,10 @@ export function relais(options) {
199
202
  }
200
203
  return relais;
201
204
  }
202
- // La configuration du serveur de développement de la pièce, sur `http://localhost:5173`, reliée au
203
- // core de `core` (le banc d'essai ou un core local) et, pour une app, à l'app lancée en local à
204
- // `app`. Après la connexion, le core ramène à `/` : pour une app, la racine mène à son premier écran.
205
+ // La configuration du serveur de développement de la pièce, sur `http://localhost:<port>`
206
+ // (`portDeDeveloppement` par défaut), reliée au core de `core` (celui d'un espace ou un core local)
207
+ // et, pour une app, à l'app lancée en local à `app`. Après la connexion, le core ramène à `/` : pour
208
+ // une app, la racine mène à son premier écran.
205
209
  export function configurationDuDeveloppement(dossier, options) {
206
210
  const piece = lirePiece(dossier);
207
211
  const racine = {
@@ -223,10 +227,10 @@ export function configurationDuDeveloppement(dossier, options) {
223
227
  ...config,
224
228
  mode: 'development',
225
229
  plugins: [...(config.plugins ?? []), racine],
226
- server: { ...config.server, port: portDeDeveloppement, strictPort: true, proxy: relais({ base: piece.base, core: options.core, app: options.app, garde: cheminsGardes(dossier) }) },
230
+ server: { ...config.server, port: options.port ?? portDeDeveloppement, strictPort: true, proxy: relais({ base: piece.base, core: options.core, app: options.app, garde: cheminsGardes(dossier) }) },
227
231
  };
228
232
  }
229
- // Sert la page de la pièce à chaud sur `http://localhost:5173` (`configurationDuDeveloppement`).
233
+ // Sert la page de la pièce à chaud sur `http://localhost:<port>` (`configurationDuDeveloppement`).
230
234
  export async function developperLaPage(dossier, options) {
231
235
  const serveur = await createServer(configurationDuDeveloppement(dossier, options));
232
236
  await serveur.listen();
@@ -238,6 +242,12 @@ export async function developperLaPage(dossier, options) {
238
242
  // dépendances du navigateur et de ses tests résolues depuis la bibliothèque. La bibliothèque passe par Vite, qui lit la feuille qu'importe sa coquille : installée
239
243
  // dans `node_modules`, Node la chargerait seule. Un test qui échoue fait échouer la commande.
240
244
  export async function testerLaPage(dossier) {
245
+ const fautes = fautesDeHtmlBrut(dossier);
246
+ if (fautes.length > 0) {
247
+ console.error(`Les sources de la page n'écrivent jamais de HTML brut : React échappe ce qu'il rend, et un texte venu de l'app, d'une personne ou de Claude ne devient jamais du HTML.\n${fautes.join('\n')}`);
248
+ process.exitCode = 1;
249
+ return;
250
+ }
241
251
  const vitest = await startVitest([], {
242
252
  root: dossier,
243
253
  run: true,
@@ -250,3 +260,25 @@ export async function testerLaPage(dossier) {
250
260
  }, { plugins: [react(), reglesDeLaPage()], cacheDir: join(dossier, 'node_modules/.vite'), server: { fs: { allow: [dossier, bibliotheque] } } });
251
261
  await vitest.close();
252
262
  }
263
+ // Les lignes des sources de la page, `espace/`, qui écrivent du HTML brut : `innerHTML`,
264
+ // `dangerouslySetInnerHTML`, `outerHTML`, `insertAdjacentHTML`, `document.write`, même en
265
+ // commentaire. Une page sans `espace/` n'en a aucune.
266
+ export function fautesDeHtmlBrut(dossier) {
267
+ const interdits = /dangerouslySetInnerHTML|innerHTML|outerHTML|insertAdjacentHTML|document\.write/;
268
+ const espace = join(dossier, 'espace');
269
+ if (!existsSync(espace)) {
270
+ return [];
271
+ }
272
+ const fautes = [];
273
+ for (const fichier of readdirSync(espace, { recursive: true, encoding: 'utf8' })) {
274
+ if (!/\.(tsx?|css|html)$/.test(fichier)) {
275
+ continue;
276
+ }
277
+ readFileSync(join(espace, fichier), 'utf8').split('\n').forEach((ligne, rang) => {
278
+ if (interdits.test(ligne)) {
279
+ fautes.push(`espace/${fichier}:${rang + 1} : ${ligne.trim()}`);
280
+ }
281
+ });
282
+ }
283
+ return fautes;
284
+ }