@indos/bibliotheque 1.12.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/CHANGELOG.md +50 -0
  2. package/package.json +33 -2
  3. package/src/app.js +7 -12
  4. package/src/direct/page.d.ts +33 -0
  5. package/src/direct/page.js +145 -0
  6. package/src/direct.d.ts +63 -0
  7. package/src/direct.js +411 -0
  8. package/src/espace/apercu.d.ts +9 -0
  9. package/src/espace/apercu.js +105 -0
  10. package/src/espace/cadre.d.ts +12 -0
  11. package/src/espace/cadre.js +21 -10
  12. package/src/espace/choses.d.ts +28 -7
  13. package/src/espace/choses.js +26 -9
  14. package/src/espace/coquille.d.ts +4 -0
  15. package/src/espace/coquille.js +47 -34
  16. package/src/espace/direct.d.ts +9 -0
  17. package/src/espace/direct.js +20 -4
  18. package/src/espace/ecran-d-une-chose.d.ts +0 -4
  19. package/src/espace/ecran-d-une-chose.js +42 -32
  20. package/src/espace/ecran.d.ts +1 -2
  21. package/src/espace/ecran.js +7 -6
  22. package/src/espace/essai.d.ts +37 -0
  23. package/src/espace/essai.js +117 -0
  24. package/src/espace/formulaire-d-une-fiche.js +4 -5
  25. package/src/espace/index.d.ts +6 -7
  26. package/src/espace/index.js +6 -7
  27. package/src/espace/lien.d.ts +4 -4
  28. package/src/espace/lien.js +3 -5
  29. package/src/espace/liste-des-choses.js +86 -24
  30. package/src/espace/menu-d-une-chose.d.ts +2 -1
  31. package/src/espace/menu-d-une-chose.js +17 -14
  32. package/src/espace/ouvrir.d.ts +1 -4
  33. package/src/espace/ouvrir.js +5 -13
  34. package/src/espace/page.d.ts +0 -2
  35. package/src/espace/page.js +0 -3
  36. package/src/espace/panneau-du-partage.d.ts +9 -8
  37. package/src/espace/panneau-du-partage.js +132 -48
  38. package/src/espace/routes-des-choses.js +2 -2
  39. package/src/faux-core.d.ts +23 -0
  40. package/src/faux-core.js +81 -0
  41. package/src/fichiers-d-une-chose.d.ts +37 -0
  42. package/src/fichiers-d-une-chose.js +136 -0
  43. package/src/forme-du-direct.d.ts +29 -0
  44. package/src/forme-du-direct.js +70 -0
  45. package/src/partage.d.ts +7 -2
  46. package/src/partage.js +26 -7
  47. package/src/presence.d.ts +6 -0
  48. package/src/presence.js +6 -3
  49. package/src/remplacements.d.ts +26 -0
  50. package/src/remplacements.js +41 -0
  51. package/src/sans-le-chemin.d.ts +1 -0
  52. package/src/sans-le-chemin.js +9 -0
  53. package/src/signaux.d.ts +5 -0
  54. package/src/signaux.js +20 -0
  55. package/src/ui/direct.d.ts +7 -6
  56. package/src/ui/direct.js +26 -4
  57. package/src/ui/icones.d.ts +6 -0
  58. package/src/ui/icones.js +8 -0
  59. package/src/ui/index.d.ts +2 -2
  60. package/src/ui/index.js +2 -2
  61. package/src/ui/menu-d-une-ligne.js +1 -1
  62. package/src/ui/tableau.d.ts +3 -1
  63. package/src/ui/tableau.js +10 -5
  64. package/src/vite.js +4 -2
  65. package/src/espace/barre-de-la-liste.d.ts +0 -6
  66. package/src/espace/barre-de-la-liste.js +0 -78
  67. package/src/espace/heure.d.ts +0 -1
  68. package/src/espace/heure.js +0 -6
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.
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.
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,11 +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. Sur un téléphone, jusqu'à 760 px, chaque ligne s'empile (la feuille,
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,
34
35
  // `.tableau`) : les colonnes `tete` d'abord, dans leur ordre, la première colonne quand aucune ne
35
36
  // l'est ; la colonne sans titre en haut à droite ; puis les autres, chacune sur sa ligne, après son
36
37
  // titre en gris (`data-titre`).
37
- export function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, className }) {
38
+ export function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, onOuvrirEnGrand, ligneOuverte, className }) {
38
39
  const avecTete = colonnes.some((colonne) => colonne.tete);
39
40
  const marques = colonnes.map((colonne, rang) => ({
40
41
  'data-tete': (avecTete ? colonne.tete : rang === 0) ? '' : undefined,
@@ -42,11 +43,15 @@ export function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, cla
42
43
  'data-titre': colonne.titre || undefined,
43
44
  }));
44
45
  return (_jsxs("div", { className: className, children: [_jsx("div", { className: "tableau overflow-x-auto rounded-[10px] border border-trait", children: _jsxs("table", { className: "w-full border-collapse text-[13.5px]", children: [_jsx("thead", { children: _jsx("tr", { children: colonnes.map((colonne) => (_jsx("th", { scope: "col", className: "border-b border-trait bg-surface px-3.5 py-2.5 text-left text-[11px] font-medium tracking-[.07em] whitespace-nowrap text-gris uppercase", children: colonne.titre }, colonne.titre))) }) }), _jsx("tbody", { children: lignes.length > 0
45
- ? lignes.map((ligne, rang) => (_jsx("tr", { onClick: onOuvrirLigne && ((evenement) => {
46
+ ? lignes.map((ligne, rang) => (_jsx("tr", { "aria-current": rang === ligneOuverte ? 'true' : undefined, onClick: onOuvrirLigne && ((evenement) => {
46
47
  if (ouvreLaLigne(evenement)) {
47
48
  onOuvrirLigne(rang);
48
49
  }
49
- }), className: cn('border-t border-trait first:border-t-0', onOuvrirLigne && 'cursor-pointer 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
+ }), 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
55
  : (_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 })] }));
51
56
  }
52
57
  function Pages({ page, total, changerDePage, lignes }) {
package/src/vite.js CHANGED
@@ -19,11 +19,13 @@ const coquille = fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? './espa
19
19
  // Les doubles de ce que jsdom n'a pas et que Radix demande, chargés avant les tests de la page.
20
20
  const doublesDeJsdom = fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? './espace/doubles-de-jsdom.ts' : './espace/doubles-de-jsdom.js', import.meta.url));
21
21
  // Les dépendances du navigateur et de ses tests, celles de la bibliothèque : une seule copie de
22
- // chacune, celle que la bibliothèque résout, même importée par la page d'une app ou ses tests.
22
+ // chacune, celle que la bibliothèque résout, même importée par la page d'une app ou ses tests. Yjs
23
+ // surtout : deux copies dans une page ne se reconnaissent pas, et le direct (`@indos/bibliotheque/
24
+ // direct/page`) ne lirait pas le document d'un éditeur qui importe l'autre.
23
25
  // Dans le dépôt, ce sont celles de `bibliotheque/node_modules`, dont une app du catalogue ne déclare
24
26
  // que React et React DOM, en liens vers elles (`file:../../bibliotheque/node_modules/react`) ; pour le
25
27
  // paquet publié, ses dépendances de pair, que npm installe dans `<app>/node_modules`.
26
- const dependancesDuNavigateur = /^(react|react-dom|@tanstack\/react-router|@tanstack\/react-query|radix-ui|tailwind-merge|@testing-library\/[^/]+|vitest)(\/|$)/;
28
+ const dependancesDuNavigateur = /^(react|react-dom|@tanstack\/react-router|@tanstack\/react-query|radix-ui|tailwind-merge|yjs|y-protocols|@hocuspocus\/provider|@testing-library\/[^/]+|vitest)(\/|$)/;
27
29
  // Le port du serveur de développement.
28
30
  export const portDeDeveloppement = 5173;
29
31
  // Ce que le `module.json` de la pièce dit de sa page : son nom, sa base (`/` pour le core,
@@ -1,6 +0,0 @@
1
- import { type ReactNode } from 'react';
2
- import { type ChoseTrouvee, type DeclarationDesChoses } from './choses.ts';
3
- export declare function BarreDeLaListe<C extends ChoseTrouvee>({ choses, bas }: {
4
- choses: DeclarationDesChoses<C>;
5
- bas: ReactNode;
6
- }): import("react").JSX.Element;
@@ -1,78 +0,0 @@
1
- import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
- import { keepPreviousData, useQuery } from '@tanstack/react-query';
3
- import { useLocation, useRouter } from '@tanstack/react-router';
4
- import { useEffect, useState } from 'react';
5
- import { nombre } from '../format.js';
6
- import { lignesParPage } from '../pagination.js';
7
- import { Bouton } from '../ui/bouton.js';
8
- import { Saisie } from '../ui/champ.js';
9
- import { Choix } from '../ui/choix.js';
10
- import { texteSansResultat } from '../ui/etats.js';
11
- import { chercherParLOutil, cleDesChoses, critereDeLaListe, dateDe, motsDe, rechercheDeLaListe } from './choses.js';
12
- import { LienDansLaPage } from './lien.js';
13
- import { adresseDeLaListe, depuisLaListe, retenirLaListe, titreDeLaListe } from './ouvrir.js';
14
- import { useSession } from './session.js';
15
- // La barre de la liste, à la place de la barre de l'OS sur une chose ouverte depuis la liste de son
16
- // app (docs/architecture.md, « L'espace ») : « ‹ <liste> », qui mène à la liste telle qu'on l'a
17
- // quittée et rend la barre de l'OS ; la vue, quand l'app en a plusieurs, et la recherche ; les choses
18
- // de la page, chacune sur deux lignes, son nom et `sousLigne` (la date par défaut), l'ouverte en
19
- // carte bordée ; « 1–25 sur N » et les pages ; le pied de la barre. Sa vue, son texte et sa page
20
- // vivent dans l'adresse retenue de la liste (`retenirLaListe`), jamais dans l'adresse de la chose :
21
- // les changer garde la chose ouverte et son origine. Elle lit le même `chercher`, sous la même clé
22
- // que la liste.
23
- const attenteDeLaFrappe = 300;
24
- const chevron = (_jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", className: "size-4 flex-none", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M10 3.5L5.5 8l4.5 4.5" }) }));
25
- export function BarreDeLaListe({ choses, bas }) {
26
- const session = useSession();
27
- const router = useRouter();
28
- const ici = useLocation({ select: (lieu) => lieu.pathname });
29
- const mots = motsDe(choses);
30
- const titre = titreDeLaListe(session, choses.app);
31
- const vues = choses.vues ?? [];
32
- const premiere = vues[0]?.valeur;
33
- // La recherche de l'adresse retenue de la liste.
34
- function rechercheRetenue() {
35
- const adresse = new URL(adresseDeLaListe(choses.app), window.location.origin);
36
- return rechercheDeLaListe(router.options.parseSearch(adresse.search));
37
- }
38
- const [recherche, setRecherche] = useState(rechercheRetenue);
39
- const [saisie, setSaisie] = useState(recherche.texte ?? '');
40
- // Une recherche nouvelle devient l'adresse retenue de la liste.
41
- function changer(suite) {
42
- const prochaine = {
43
- ...(suite.texte ? { texte: suite.texte } : {}),
44
- ...(suite.vue && suite.vue !== premiere ? { vue: suite.vue } : {}),
45
- ...(suite.page && suite.page > 1 ? { page: suite.page } : {}),
46
- };
47
- setRecherche(prochaine);
48
- retenirLaListe(choses.app, `/${choses.app}/liste${router.options.stringifySearch(prochaine)}`);
49
- }
50
- useEffect(() => {
51
- const propre = saisie.trim();
52
- if (propre === (recherche.texte ?? '')) {
53
- return undefined;
54
- }
55
- const minuteur = setTimeout(() => changer({ texte: propre, vue: recherche.vue }), attenteDeLaFrappe);
56
- return () => clearTimeout(minuteur);
57
- }, [saisie, recherche.texte, recherche.vue]);
58
- const chercher = choses.chercher ?? chercherParLOutil;
59
- const critere = critereDeLaListe(vues, recherche);
60
- const trouvees = useQuery({
61
- queryKey: cleDesChoses(choses.app, 'liste', critere),
62
- queryFn: () => chercher(critere),
63
- placeholderData: keepPreviousData,
64
- });
65
- const page = critere.page;
66
- const lignes = trouvees.data?.lignes ?? [];
67
- const total = trouvees.data?.total ?? 0;
68
- const derniere = Math.max(1, Math.ceil(total / lignesParPage));
69
- const debut = (page - 1) * lignesParPage + 1;
70
- const vue = recherche.vue && vues.some((une) => une.valeur === recherche.vue) ? recherche.vue : premiere;
71
- const classesDuChamp = 'h-8 w-full text-[13.5px]';
72
- return (_jsxs(_Fragment, { children: [_jsxs(LienDansLaPage, { href: adresseDeLaListe(choses.app), className: "flex h-9 flex-none items-center gap-1.5 rounded-md px-2 font-medium text-gris no-underline hover:bg-survol hover:text-encre", children: [chevron, _jsx("span", { className: "truncate", children: titre })] }), _jsxs("div", { className: "grid flex-1 content-start gap-2", children: [_jsxs("div", { className: "grid gap-1.5", children: [vues.length > 1 && (_jsx(Choix, { libelle: "Vue", libelleMasque: true, taille: "petite", options: vues.map((une) => ({ valeur: une.valeur, libelle: une.titre })), valeur: vue, onValeurChange: (prochaine) => changer({ texte: recherche.texte, vue: prochaine }) })), _jsx(Saisie, { type: "search", "aria-label": "Chercher", placeholder: "Chercher", value: saisie, autoComplete: "off", className: classesDuChamp, onChange: (evenement) => setSaisie(evenement.currentTarget.value) })] }), trouvees.error
73
- ? (_jsxs("div", { className: "grid justify-items-start gap-2 px-1 text-[13px] text-gris", children: [_jsx("p", { role: "alert", className: "m-0", children: trouvees.error.message }), _jsx(Bouton, { type: "button", sorte: "secondaire", className: "h-8", onClick: () => void trouvees.refetch(), children: "R\u00E9essayer" })] }))
74
- : trouvees.data && (_jsxs(_Fragment, { children: [_jsxs("nav", { "aria-label": titre, className: "grid gap-0.5", children: [lignes.length === 0 && (_jsx("p", { className: "m-0 px-2.5 py-2 text-[13px] text-gris", children: recherche.texte ? texteSansResultat(choses.une, choses.feminin, recherche.texte) : `${mots.aucune}.` })), lignes.map((chose) => {
75
- const dessous = choses.sousLigne ? choses.sousLigne(chose) : dateDe(choses, chose);
76
- return (_jsxs(LienDansLaPage, { href: chose.chemin, state: depuisLaListe, "aria-current": chose.chemin === ici ? 'page' : undefined, className: "grid gap-px rounded-lg border border-transparent px-2.5 py-2 no-underline hover:bg-survol aria-[current=page]:border-trait aria-[current=page]:bg-papier", children: [_jsx("span", { className: "truncate font-medium text-encre", children: chose.nom }), dessous !== undefined && dessous !== '' && _jsx("span", { className: "truncate text-[12.5px] text-gris", children: dessous })] }, chose.id));
77
- })] }), lignes.length > 0 && (_jsxs("div", { className: "flex items-center justify-between gap-2 px-1", children: [_jsx("p", { className: "m-0 font-mono text-[12px] text-gris tabular-nums", children: `${nombre(debut)}–${nombre(debut + lignes.length - 1)} sur ${nombre(total)}` }), derniere > 1 && (_jsxs("nav", { "aria-label": "Pages", className: "flex gap-1", children: [_jsx(Bouton, { type: "button", sorte: "discret", "aria-label": "Pr\u00E9c\u00E9dent", disabled: page <= 1, onClick: () => changer({ ...recherche, page: Math.min(page - 1, derniere) }), children: "\u2039" }), _jsx(Bouton, { type: "button", sorte: "discret", "aria-label": "Suivant", disabled: page >= derniere, onClick: () => changer({ ...recherche, page: page + 1 }), children: "\u203A" })] }))] }))] }))] }), bas] }));
78
- }
@@ -1 +0,0 @@
1
- export declare function heureDeSuisse(quand: Date | string): string;
@@ -1,6 +0,0 @@
1
- import { jourEtHeure } from '../format.js';
2
- // L'heure de Suisse : `jourEtHeure` de `@indos/bibliotheque/format`, « 28.10.2026 14:21 », sous son
3
- // autre nom, qui se retire dans une version majeure.
4
- export function heureDeSuisse(quand) {
5
- return jourEtHeure(quand);
6
- }