@indos/bibliotheque 1.7.0 → 1.9.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 (72) hide show
  1. package/CHANGELOG.md +38 -0
  2. package/package.json +17 -1
  3. package/src/app.d.ts +43 -1
  4. package/src/app.js +113 -0
  5. package/src/base.d.ts +3 -0
  6. package/src/base.js +29 -0
  7. package/src/espace/barre-de-la-liste.d.ts +6 -0
  8. package/src/espace/barre-de-la-liste.js +77 -0
  9. package/src/espace/base64.d.ts +2 -0
  10. package/src/espace/base64.js +14 -0
  11. package/src/espace/cadre.d.ts +46 -0
  12. package/src/espace/cadre.js +100 -0
  13. package/src/espace/choses.d.ts +5 -0
  14. package/src/espace/choses.js +28 -0
  15. package/src/espace/comptes.js +5 -4
  16. package/src/espace/coquille.d.ts +5 -0
  17. package/src/espace/coquille.js +82 -38
  18. package/src/espace/doubles-de-jsdom.d.ts +1 -0
  19. package/src/espace/doubles-de-jsdom.js +15 -0
  20. package/src/espace/ecran-d-une-chose.d.ts +1 -1
  21. package/src/espace/ecran-d-une-chose.js +93 -19
  22. package/src/espace/ecran.d.ts +3 -1
  23. package/src/espace/ecran.js +11 -15
  24. package/src/espace/entree-active.js +3 -1
  25. package/src/espace/heure.js +4 -12
  26. package/src/espace/index.d.ts +3 -2
  27. package/src/espace/index.js +3 -2
  28. package/src/espace/lien.d.ts +3 -2
  29. package/src/espace/lien.js +4 -2
  30. package/src/espace/liste-des-choses.js +26 -21
  31. package/src/espace/menu-d-une-chose.d.ts +1 -1
  32. package/src/espace/menu-d-une-chose.js +13 -6
  33. package/src/espace/ouvrir.d.ts +4 -1
  34. package/src/espace/ouvrir.js +13 -5
  35. package/src/espace/page.d.ts +3 -0
  36. package/src/espace/page.js +1 -1
  37. package/src/espace/panneau-du-partage.d.ts +16 -1
  38. package/src/espace/panneau-du-partage.js +67 -11
  39. package/src/espace/routes-des-choses.js +5 -3
  40. package/src/fichiers.d.ts +8 -0
  41. package/src/fichiers.js +47 -3
  42. package/src/flux.d.ts +15 -0
  43. package/src/flux.js +102 -0
  44. package/src/format.d.ts +6 -0
  45. package/src/format.js +92 -0
  46. package/src/identifiant.d.ts +6 -0
  47. package/src/identifiant.js +13 -0
  48. package/src/sans-accents.d.ts +3 -0
  49. package/src/sans-accents.js +21 -0
  50. package/src/ui/blocs.d.ts +17 -1
  51. package/src/ui/blocs.js +23 -3
  52. package/src/ui/bouton.d.ts +3 -1
  53. package/src/ui/bouton.js +6 -2
  54. package/src/ui/champ.d.ts +2 -1
  55. package/src/ui/champ.js +2 -2
  56. package/src/ui/choix.d.ts +3 -1
  57. package/src/ui/choix.js +2 -2
  58. package/src/ui/graphiques.js +3 -3
  59. package/src/ui/icones.d.ts +7 -0
  60. package/src/ui/icones.js +11 -0
  61. package/src/ui/index.d.ts +4 -2
  62. package/src/ui/index.js +3 -1
  63. package/src/ui/recherche.d.ts +13 -0
  64. package/src/ui/recherche.js +16 -0
  65. package/src/ui/tableau.d.ts +1 -0
  66. package/src/ui/tableau.js +14 -5
  67. package/src/ui/theme.css +17 -9
  68. package/src/ui/vues.d.ts +2 -1
  69. package/src/ui/vues.js +7 -3
  70. package/src/vite.js +9 -5
  71. package/src/espace/en-tete-de-l-app.d.ts +0 -8
  72. package/src/espace/en-tete-de-l-app.js +0 -51
package/src/ui/theme.css CHANGED
@@ -91,19 +91,27 @@
91
91
  :focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; border-radius: 4px; }
92
92
  }
93
93
 
94
- /* Le tableau sur un téléphone, en lignes empilées : la première cellule et la dernière en tête (l'heure
95
- et l'issue du journal), puis l'avant-dernière (l'outil), puis celle d'avant (la personne). Les
96
- en-têtes restent lus par un lecteur d'écran. */
94
+ /* Le tableau sur un téléphone, jusqu'à 760 px, le seul seuil de l'espace : chaque ligne s'empile. En
95
+ tête, les cellules que sa déclaration y met (`data-tete`), dans leur ordre, chacune sur sa ligne ;
96
+ en haut à droite, celle de ses gestes, une colonne sans titre (`data-geste`), comme le ⋯ ; puis les
97
+ autres, chacune sur sa ligne, après le titre de sa colonne en gris (`data-titre`). Les en-têtes
98
+ restent lus par un lecteur d'écran, qui ne lit pas les titres recopiés. */
97
99
  @media (max-width: 760px) {
98
100
  .tableau { overflow-x: visible; }
99
101
  .tableau table, .tableau tbody { display: block; }
100
102
  .tableau thead { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
101
- .tableau tr { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 4px 12px; align-items: center; padding: 12px 14px; }
102
- .tableau td { padding: 0; min-width: 0; white-space: normal; overflow-wrap: anywhere; }
103
- .tableau td:first-child { grid-row: 1; grid-column: 1; }
104
- .tableau td:last-child { grid-row: 1; grid-column: 2; }
105
- .tableau td:nth-last-child(2):not(:first-child) { grid-row: 2; grid-column: 1 / -1; }
106
- .tableau td:nth-last-child(3):not(:first-child) { grid-row: 3; grid-column: 1 / -1; color: var(--gris); }
103
+ .tableau tr { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 4px 12px; align-items: start; padding: 12px 14px; }
104
+ .tableau td { grid-column: 1 / -1; order: 1; padding: 0; min-width: 0; white-space: normal; overflow-wrap: anywhere; }
105
+ .tableau td[data-tete] { grid-column: 1; order: 0; }
106
+ .tableau tr:not(:has(> td[data-geste])) > td[data-tete] { grid-column: 1 / -1; }
107
+ .tableau td[data-geste] { grid-column: 2; grid-row: 1; order: 0; width: auto; }
108
+ .tableau td[data-titre]:not([data-tete])::before {
109
+ content: attr(data-titre) / "";
110
+ margin-right: 8px;
111
+ font-family: var(--police-texte);
112
+ font-size: 12.5px;
113
+ color: var(--gris);
114
+ }
107
115
  .tableau td[colspan] { grid-column: 1 / -1; }
108
116
  }
109
117
 
package/src/ui/vues.d.ts CHANGED
@@ -9,7 +9,8 @@ export type ProprietesDesVues = {
9
9
  valeur: string;
10
10
  onValeurChange: (valeur: string) => void;
11
11
  nom?: string;
12
+ gestes?: ReactNode;
12
13
  className?: string;
13
14
  children: ReactNode;
14
15
  };
15
- export declare function Vues({ vues, valeur, onValeurChange, nom, className, children }: ProprietesDesVues): import("react").JSX.Element;
16
+ export declare function Vues({ vues, valeur, onValeurChange, nom, gestes, className, children }: ProprietesDesVues): import("react").JSX.Element;
package/src/ui/vues.js CHANGED
@@ -1,7 +1,11 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { Tabs } from 'radix-ui';
3
+ import { nombre } from '../format.js';
3
4
  import { cn } from './classes.js';
4
- const nombre = new Intl.NumberFormat('fr-CH');
5
- export function Vues({ vues, valeur, onValeurChange, nom, className, children }) {
6
- return (_jsxs(Tabs.Root, { value: valeur, onValueChange: onValeurChange, className: className, children: [_jsx(Tabs.List, { "aria-label": nom, className: "flex flex-wrap gap-x-1 border-b border-trait", children: vues.map((vue) => (_jsxs(Tabs.Trigger, { value: vue.valeur, className: cn('-mb-px flex h-9 cursor-pointer items-center gap-2 border-0 border-b-2 border-transparent bg-transparent px-2.5 text-[14px] font-medium text-gris hover:text-encre', 'data-[state=active]:border-accent data-[state=active]:text-encre'), children: [vue.titre, vue.nombre !== undefined && _jsx("span", { className: "font-mono text-[12px] text-gris tabular-nums", children: nombre.format(vue.nombre) })] }, vue.valeur))) }), _jsx(Tabs.Content, { value: valeur, className: "pt-4", children: children })] }));
5
+ import { GestesDeLaLigne } from './recherche.js';
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))) }));
8
+ return (_jsxs(Tabs.Root, { value: valeur, onValueChange: onValeurChange, className: className, children: [gestes
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
+ : liste, _jsx(Tabs.Content, { value: valeur, className: "pt-3", children: children })] }));
7
11
  }
package/src/vite.js CHANGED
@@ -16,10 +16,13 @@ const bibliotheque = fileURLToPath(new URL('..', import.meta.url));
16
16
  // Le module de la coquille, d'où se résolvent les dépendances du navigateur : sa source dans le
17
17
  // dépôt, son JavaScript compilé dans le paquet publié.
18
18
  const coquille = fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? './espace/index.ts' : './espace/index.js', import.meta.url));
19
+ // Les doubles de ce que jsdom n'a pas et que Radix demande, chargés avant les tests de la page.
20
+ const doublesDeJsdom = fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? './espace/doubles-de-jsdom.ts' : './espace/doubles-de-jsdom.js', import.meta.url));
19
21
  // Les dépendances du navigateur et de ses tests, celles de la bibliothèque : une seule copie de
20
22
  // chacune, celle que la bibliothèque résout, même importée par la page d'une app ou ses tests.
21
- // Dans le dépôt, ce sont celles de `bibliotheque/node_modules`, qu'une app du catalogue n'installe
22
- // pas ; pour le paquet publié, ses dépendances de pair, que npm installe dans `<app>/node_modules`.
23
+ // Dans le dépôt, ce sont celles de `bibliotheque/node_modules`, dont une app du catalogue ne déclare
24
+ // que React et React DOM, en liens vers elles (`file:../../bibliotheque/node_modules/react`) ; pour le
25
+ // paquet publié, ses dépendances de pair, que npm installe dans `<app>/node_modules`.
23
26
  const dependancesDuNavigateur = /^(react|react-dom|@tanstack\/react-router|@tanstack\/react-query|radix-ui|tailwind-merge|@testing-library\/[^/]+|vitest)(\/|$)/;
24
27
  // Le port du serveur de développement.
25
28
  export const portDeDeveloppement = 5173;
@@ -178,8 +181,8 @@ export async function developperLaPage(dossier, options) {
178
181
  return serveur;
179
182
  }
180
183
  // Lance les tests du navigateur de la pièce, `tests/espace/**/*.test.tsx`, une fois, par Vitest,
181
- // dans le DOM de jsdom, avec les dépendances du navigateur et de ses tests résolues depuis la
182
- // bibliothèque. La bibliothèque passe par Vite, qui lit la feuille qu'importe sa coquille : installée
184
+ // dans le DOM de jsdom, complété des doubles que Radix demande (`doublesDeJsdom`), avec les
185
+ // 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
183
186
  // dans `node_modules`, Node la chargerait seule. Un test qui échoue fait échouer la commande.
184
187
  export async function testerLaPage(dossier) {
185
188
  const vitest = await startVitest([], {
@@ -189,7 +192,8 @@ export async function testerLaPage(dossier) {
189
192
  include: ['tests/espace/**/*.test.tsx'],
190
193
  environment: 'jsdom',
191
194
  globals: true,
195
+ setupFiles: [doublesDeJsdom],
192
196
  server: { deps: { inline: [/[\\/]@indos[\\/]bibliotheque[\\/]/] } },
193
- }, { plugins: [react(), reglesDeLaPage()], cacheDir: join(dossier, 'node_modules/.vite') });
197
+ }, { plugins: [react(), reglesDeLaPage()], cacheDir: join(dossier, 'node_modules/.vite'), server: { fs: { allow: [dossier, bibliotheque] } } });
194
198
  await vitest.close();
195
199
  }
@@ -1,8 +0,0 @@
1
- import { type AppOuverte, type Session } from './session.ts';
2
- export type Onglet = {
3
- titre: string;
4
- chemin: string;
5
- };
6
- export declare function appDuChemin(session: Session, ici: string): AppOuverte | undefined;
7
- export declare function ongletsDe(app: AppOuverte): Onglet[];
8
- export declare function EnTeteDeLApp(): import("react").JSX.Element | null;
@@ -1,51 +0,0 @@
1
- import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
- import { useLocation } from '@tanstack/react-router';
3
- import { Bouton } from '../ui/bouton.js';
4
- import { useEpingle } from './barre.js';
5
- import { entreeActive } from './entree-active.js';
6
- import { LienDansLaPage } from './lien.js';
7
- import { useAnnoncer } from './ouvrir.js';
8
- import { useSession } from './session.js';
9
- // L'app de la page, d'après son chemin : `/documentation/<app>`, ou `/<app>/…` pour une app ouverte
10
- // à la personne. Le core, ses écrans (`/journal`, `/compte`) et l'accueil n'en ont pas.
11
- export function appDuChemin(session, ici) {
12
- const [, premier, second] = ici.split('/');
13
- const nom = premier === 'documentation' ? second : premier;
14
- return session.apps.find((app) => app.nom === nom);
15
- }
16
- // Les onglets d'une app, dans leur ordre.
17
- export function ongletsDe(app) {
18
- return [
19
- ...app.ecrans.map((ecran) => ({ titre: ecran.titre, chemin: ecran.chemin })),
20
- ...(app.reglages ? [{ titre: 'Réglages', chemin: `/${app.nom}/reglages` }] : []),
21
- { titre: 'Documentation', chemin: `/documentation/${app.nom}` },
22
- ];
23
- }
24
- // Le nom d'un onglet épinglé dans la barre : le titre de l'app pour son premier écran, sinon
25
- // « <app> · <onglet> ».
26
- function nomDeLEpingle(app, onglet) {
27
- return onglet.chemin === app.ecrans[0]?.chemin ? app.titre : `${app.titre} · ${onglet.titre}`;
28
- }
29
- export function EnTeteDeLApp() {
30
- const session = useSession();
31
- const ici = useLocation({ select: (lieu) => lieu.pathname });
32
- const app = appDuChemin(session, ici);
33
- if (!app) {
34
- return null;
35
- }
36
- const onglets = ongletsDe(app);
37
- // L'onglet du chemin ; sinon le premier écran de l'app sous le même `/<app>/`, comme « Pages » sur
38
- // la page hôte d'une page (`/pages/<id>`).
39
- const active = onglets.find((onglet) => onglet.chemin === ici)?.chemin ?? entreeActive(app.ecrans.map((ecran) => ecran.chemin), ici);
40
- const ouvert = onglets.find((onglet) => onglet.chemin === active);
41
- return (_jsxs("div", { className: "mb-8 border-b border-trait", children: [_jsxs("div", { className: "mb-1.5 flex min-h-7 items-center justify-between gap-3", children: [_jsx("p", { className: "m-0 text-[11px] tracking-[.07em] text-gris uppercase", children: app.titre }), ouvert && _jsx(BoutonEpingler, { chemin: ouvert.chemin, nom: nomDeLEpingle(app, ouvert) }, ouvert.chemin)] }), _jsx("nav", { "aria-label": "Onglets", className: "-mb-px flex flex-wrap gap-x-6", children: onglets.map((onglet) => (_jsx(LienDansLaPage, { href: onglet.chemin, "aria-current": onglet.chemin === active ? 'page' : undefined, className: "border-b-2 border-transparent pb-2.5 font-medium text-gris no-underline hover:text-encre aria-[current=page]:border-accent aria-[current=page]:text-encre", children: onglet.titre }, onglet.chemin))) })] }));
42
- }
43
- // « Épingler » ajoute l'onglet ouvert à la barre de la personne, « Épinglé » l'en retire.
44
- function BoutonEpingler({ chemin, nom }) {
45
- const annoncer = useAnnoncer();
46
- const epingle = useEpingle(chemin, {
47
- fait: (epinglee) => annoncer(epinglee ? `${nom} est dans votre barre.` : `${nom} n'est plus dans votre barre.`),
48
- echec: annoncer,
49
- });
50
- return (_jsx(Bouton, { type: "button", sorte: "discret", "aria-pressed": epingle.epinglee, disabled: epingle.enCours, onClick: () => epingle.basculer(nom), className: "h-7 px-2 text-[13px]", children: epingle.epinglee ? 'Épinglé' : 'Épingler' }));
51
- }