@indos/bibliotheque 1.2.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/package.json +1 -1
  3. package/src/ecran.d.ts +3 -1
  4. package/src/espace/appels.d.ts +2 -0
  5. package/src/espace/appels.js +11 -3
  6. package/src/espace/barre.d.ts +29 -0
  7. package/src/espace/barre.js +40 -0
  8. package/src/espace/choses.d.ts +98 -0
  9. package/src/espace/choses.js +47 -0
  10. package/src/espace/contexte.d.ts +0 -2
  11. package/src/espace/contexte.js +0 -1
  12. package/src/espace/coquille.d.ts +0 -1
  13. package/src/espace/coquille.js +29 -32
  14. package/src/espace/ecran-d-une-chose.d.ts +6 -0
  15. package/src/espace/ecran-d-une-chose.js +45 -0
  16. package/src/espace/ecran.d.ts +1 -1
  17. package/src/espace/ecran.js +8 -10
  18. package/src/espace/en-tete-de-l-app.d.ts +8 -0
  19. package/src/espace/en-tete-de-l-app.js +51 -0
  20. package/src/espace/index.d.ts +11 -2
  21. package/src/espace/index.js +14 -4
  22. package/src/espace/liste-des-choses.d.ts +4 -0
  23. package/src/espace/liste-des-choses.js +109 -0
  24. package/src/espace/menu-d-une-chose.d.ts +8 -0
  25. package/src/espace/menu-d-une-chose.js +53 -0
  26. package/src/espace/ouvrir.d.ts +7 -0
  27. package/src/espace/ouvrir.js +54 -0
  28. package/src/espace/page.d.ts +4 -2
  29. package/src/espace/page.js +14 -5
  30. package/src/espace/panneau-du-partage.d.ts +15 -0
  31. package/src/espace/panneau-du-partage.js +117 -0
  32. package/src/espace/routes-des-choses.d.ts +5 -0
  33. package/src/espace/routes-des-choses.js +19 -0
  34. package/src/faux-core.d.ts +3 -1
  35. package/src/faux-core.js +3 -3
  36. package/src/mcp.d.ts +5 -2
  37. package/src/mcp.js +2 -1
  38. package/src/theme.js +1 -1
  39. package/src/ui/confirmation.d.ts +3 -2
  40. package/src/ui/confirmation.js +3 -2
  41. package/src/ui/fenetre.d.ts +3 -2
  42. package/src/ui/fenetre.js +3 -2
  43. package/src/ui/focus.d.ts +2 -0
  44. package/src/ui/focus.js +9 -0
  45. package/src/ui/panneau.d.ts +3 -2
  46. package/src/ui/panneau.js +4 -3
  47. package/src/ui/tableau.d.ts +2 -1
  48. package/src/ui/tableau.js +25 -4
package/src/mcp.js CHANGED
@@ -35,7 +35,8 @@ export function creerLeMcp(options) {
35
35
  return { statut: 400, resultat: erreurDOutil(`Les arguments de ${outil.nom} ne conviennent pas : ${validation.errorMessage}`) };
36
36
  }
37
37
  try {
38
- return { statut: 200, resultat: { content: [{ type: 'text', text: await outil.executer(arguments_, personne) }] } };
38
+ const rendu = await outil.executer(arguments_, personne);
39
+ return { statut: 200, resultat: typeof rendu === 'string' ? { content: [{ type: 'text', text: rendu }] } : { content: rendu.content } };
39
40
  }
40
41
  catch (erreur) {
41
42
  if (erreur instanceof Refus) {
package/src/theme.js CHANGED
@@ -1,4 +1,4 @@
1
- // Le thème du client, que sert le core (docs/architecture.md, « L'espace et les réglages ») : ses
1
+ // Le thème du client, que sert le core (docs/architecture.md, « L'espace ») : ses
2
2
  // variables CSS, lues à CORE_ADRESSE et gardées une minute. Si le core ne répond pas, le thème est
3
3
  // vide et la page garde les couleurs du navigateur. `horloge` ne sert qu'aux tests.
4
4
  export function creerLeLecteurDuTheme(adresseDuCore = process.env.CORE_ADRESSE, horloge = Date.now) {
@@ -1,4 +1,4 @@
1
- import type { ReactElement, ReactNode } from 'react';
1
+ import type { ReactElement, ReactNode, RefObject } from 'react';
2
2
  export type ProprietesDUneConfirmation = {
3
3
  titre: string;
4
4
  consequence: ReactNode;
@@ -7,6 +7,7 @@ export type ProprietesDUneConfirmation = {
7
7
  onConfirmer: () => void;
8
8
  ouverte?: boolean;
9
9
  onOuverteChange?: (ouverte: boolean) => void;
10
+ retour?: RefObject<HTMLElement | null>;
10
11
  children?: ReactElement;
11
12
  };
12
- export declare function Confirmation({ titre, consequence, suites, verbe, onConfirmer, ouverte, onOuverteChange, children }: ProprietesDUneConfirmation): import("react").JSX.Element;
13
+ export declare function Confirmation({ titre, consequence, suites, verbe, onConfirmer, ouverte, onOuverteChange, retour, children }: ProprietesDUneConfirmation): import("react").JSX.Element;
@@ -1,6 +1,7 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { AlertDialog } from 'radix-ui';
3
3
  import { Bouton } from './bouton.js';
4
- export function Confirmation({ titre, consequence, suites, verbe, onConfirmer, ouverte, onOuverteChange, children }) {
5
- return (_jsxs(AlertDialog.Root, { open: ouverte, onOpenChange: onOuverteChange, children: [children && _jsx(AlertDialog.Trigger, { asChild: true, children: children }), _jsxs(AlertDialog.Portal, { children: [_jsx(AlertDialog.Overlay, { className: "fixed inset-0 z-50 bg-papier/75" }), _jsx("div", { className: "fixed inset-0 z-50 grid place-items-center overflow-y-auto p-4 pointer-events-none", children: _jsxs(AlertDialog.Content, { className: "pointer-events-auto w-full max-w-[560px] rounded-[10px] border border-trait bg-papier p-[22px] text-encre", children: [_jsx(AlertDialog.Title, { className: "m-0 text-[17px] font-semibold", children: titre }), _jsx(AlertDialog.Description, { asChild: true, children: _jsx("div", { className: "mt-2", children: consequence }) }), suites && suites.length > 0 && (_jsx("ul", { className: "mt-2.5 list-disc pl-5 text-gris", children: suites.map((suite) => _jsx("li", { children: suite }, suite)) })), _jsxs("div", { className: "mt-[22px] flex flex-wrap items-center gap-2", children: [_jsx(AlertDialog.Cancel, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "secondaire", children: "Annuler" }) }), _jsx(AlertDialog.Action, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "detruit", onClick: onConfirmer, children: verbe }) })] })] }) })] })] }));
4
+ import { rendreLeFocus } from './focus.js';
5
+ export function Confirmation({ titre, consequence, suites, verbe, onConfirmer, ouverte, onOuverteChange, retour, children }) {
6
+ return (_jsxs(AlertDialog.Root, { open: ouverte, onOpenChange: onOuverteChange, children: [children && _jsx(AlertDialog.Trigger, { asChild: true, children: children }), _jsxs(AlertDialog.Portal, { children: [_jsx(AlertDialog.Overlay, { className: "fixed inset-0 z-50 bg-papier/75" }), _jsx("div", { className: "fixed inset-0 z-50 grid place-items-center overflow-y-auto p-4 pointer-events-none", children: _jsxs(AlertDialog.Content, { onCloseAutoFocus: (evenement) => rendreLeFocus(evenement, retour), className: "pointer-events-auto w-full max-w-[560px] rounded-[10px] border border-trait bg-papier p-[22px] text-encre", children: [_jsx(AlertDialog.Title, { className: "m-0 text-[17px] font-semibold", children: titre }), _jsx(AlertDialog.Description, { asChild: true, children: _jsx("div", { className: "mt-2", children: consequence }) }), suites && suites.length > 0 && (_jsx("ul", { className: "mt-2.5 list-disc pl-5 text-gris", children: suites.map((suite) => _jsx("li", { children: suite }, suite)) })), _jsxs("div", { className: "mt-[22px] flex flex-wrap items-center gap-2", children: [_jsx(AlertDialog.Cancel, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "secondaire", children: "Annuler" }) }), _jsx(AlertDialog.Action, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "detruit", onClick: onConfirmer, children: verbe }) })] })] }) })] })] }));
6
7
  }
@@ -1,4 +1,4 @@
1
- import { type ReactElement, type ReactNode } from 'react';
1
+ import { type ReactElement, type ReactNode, type RefObject } from 'react';
2
2
  export type ProprietesDUneFenetre = {
3
3
  titre: string;
4
4
  presentation?: ReactNode;
@@ -7,7 +7,8 @@ export type ProprietesDUneFenetre = {
7
7
  declencheur?: ReactElement;
8
8
  ouverte?: boolean;
9
9
  onOuverteChange?: (ouverte: boolean) => void;
10
+ retour?: RefObject<HTMLElement | null>;
10
11
  className?: string;
11
12
  children: ReactNode;
12
13
  };
13
- export declare function Fenetre({ titre, presentation, verbe, onEnvoyer, declencheur, ouverte, onOuverteChange, className, children }: ProprietesDUneFenetre): import("react").JSX.Element;
14
+ export declare function Fenetre({ titre, presentation, verbe, onEnvoyer, declencheur, ouverte, onOuverteChange, retour, className, children }: ProprietesDUneFenetre): import("react").JSX.Element;
package/src/ui/fenetre.js CHANGED
@@ -4,8 +4,9 @@ import { Dialog } from 'radix-ui';
4
4
  import { Message } from './blocs.js';
5
5
  import { Bouton } from './bouton.js';
6
6
  import { cn } from './classes.js';
7
+ import { rendreLeFocus } from './focus.js';
7
8
  const saisies = 'input:not([type=hidden]):not([aria-hidden=true]), textarea, select, button[role=combobox], button[role=checkbox]';
8
- export function Fenetre({ titre, presentation, verbe, onEnvoyer, declencheur, ouverte, onOuverteChange, className, children }) {
9
+ export function Fenetre({ titre, presentation, verbe, onEnvoyer, declencheur, ouverte, onOuverteChange, retour, className, children }) {
9
10
  const [ouverteIci, setOuverteIci] = useState(false);
10
11
  const [erreur, setErreur] = useState();
11
12
  const [occupee, setOccupee] = useState(false);
@@ -36,5 +37,5 @@ export function Fenetre({ titre, presentation, verbe, onEnvoyer, declencheur, ou
36
37
  evenement.preventDefault();
37
38
  premier.focus();
38
39
  }
39
- }, className: cn('pointer-events-auto w-full max-w-[560px] rounded-[10px] border border-trait bg-papier p-[22px] text-encre', 'max-[760px]:max-w-none max-[760px]:rounded-none max-[760px]:border-x-0 max-[760px]:border-t-0', className), children: [_jsx(Dialog.Title, { className: "m-0 text-[17px] font-semibold", children: titre }), presentation && (_jsx(Dialog.Description, { asChild: true, children: _jsx("div", { className: "mt-2 text-gris", children: presentation }) })), _jsxs("form", { className: "mt-4 grid gap-4", onSubmit: envoyer, children: [children, erreur && _jsx(Message, { erreur: true, titre: erreur, className: "mb-0" }), _jsxs("div", { className: "mt-1.5 flex flex-wrap items-center gap-2", children: [_jsx(Dialog.Close, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "secondaire", children: "Annuler" }) }), _jsx(Bouton, { type: "submit", disabled: occupee, "aria-busy": occupee || undefined, children: verbe })] })] })] }) })] })] }));
40
+ }, onCloseAutoFocus: (evenement) => rendreLeFocus(evenement, retour), className: cn('pointer-events-auto w-full max-w-[560px] rounded-[10px] border border-trait bg-papier p-[22px] text-encre', 'max-[760px]:max-w-none max-[760px]:rounded-none max-[760px]:border-x-0 max-[760px]:border-t-0', className), children: [_jsx(Dialog.Title, { className: "m-0 text-[17px] font-semibold", children: titre }), presentation && (_jsx(Dialog.Description, { asChild: true, children: _jsx("div", { className: "mt-2 text-gris", children: presentation }) })), _jsxs("form", { className: "mt-4 grid gap-4", onSubmit: envoyer, children: [children, erreur && _jsx(Message, { erreur: true, titre: erreur, className: "mb-0" }), _jsxs("div", { className: "mt-1.5 flex flex-wrap items-center gap-2", children: [_jsx(Dialog.Close, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "secondaire", children: "Annuler" }) }), _jsx(Bouton, { type: "submit", disabled: occupee, "aria-busy": occupee || undefined, children: verbe })] })] })] }) })] })] }));
40
41
  }
@@ -0,0 +1,2 @@
1
+ import type { RefObject } from 'react';
2
+ export declare function rendreLeFocus(evenement: Event, retour: RefObject<HTMLElement | null> | undefined): void;
@@ -0,0 +1,9 @@
1
+ // À la fermeture d'une fenêtre tenue depuis l'écran, le focus va à `retour` quand il est encore dans
2
+ // la page, comme le bouton du menu qui l'a ouverte, dont l'entrée n'est plus là ; sinon, Radix le
3
+ // rend à ce qui l'avait avant.
4
+ export function rendreLeFocus(evenement, retour) {
5
+ if (retour?.current?.isConnected) {
6
+ evenement.preventDefault();
7
+ retour.current.focus();
8
+ }
9
+ }
@@ -1,4 +1,4 @@
1
- import { type ReactElement, type ReactNode } from 'react';
1
+ import { type ReactElement, type ReactNode, type RefObject } from 'react';
2
2
  export type ProprietesDUnPanneau = {
3
3
  titre: string;
4
4
  surtitre?: string;
@@ -6,7 +6,8 @@ export type ProprietesDUnPanneau = {
6
6
  declencheur?: ReactElement;
7
7
  ouvert?: boolean;
8
8
  onOuvertChange?: (ouvert: boolean) => void;
9
+ retour?: RefObject<HTMLElement | null>;
9
10
  className?: string;
10
11
  children: ReactNode;
11
12
  };
12
- export declare function Panneau({ titre, surtitre, etiquette, declencheur, ouvert, onOuvertChange, className, children }: ProprietesDUnPanneau): import("react").JSX.Element;
13
+ export declare function Panneau({ titre, surtitre, etiquette, declencheur, ouvert, onOuvertChange, retour, className, children }: ProprietesDUnPanneau): import("react").JSX.Element;
package/src/ui/panneau.js CHANGED
@@ -3,15 +3,16 @@ import { useRef } from 'react';
3
3
  import { Dialog } from 'radix-ui';
4
4
  import { Bouton } from './bouton.js';
5
5
  import { cn } from './classes.js';
6
- export function Panneau({ titre, surtitre, etiquette, declencheur, ouvert, onOuvertChange, className, children }) {
6
+ export function Panneau({ titre, surtitre, etiquette, declencheur, ouvert, onOuvertChange, retour, className, children }) {
7
7
  // Ce qui avait le focus à l'ouverture, où il revient à la fermeture, même sans déclencheur.
8
8
  const avant = useRef(null);
9
9
  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: () => {
10
10
  avant.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
11
11
  }, onCloseAutoFocus: (evenement) => {
12
- if (avant.current?.isConnected) {
12
+ const cible = retour?.current?.isConnected ? retour.current : avant.current;
13
+ if (cible?.isConnected) {
13
14
  evenement.preventDefault();
14
- avant.current.focus();
15
+ cible.focus();
15
16
  }
16
17
  }, 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: "m-0 mb-1 text-[11px] tracking-[.07em] text-gris uppercase", 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 })] })] })] }));
17
18
  }
@@ -13,6 +13,7 @@ export type ProprietesDUnTableau = {
13
13
  lignes: ReactNode[][];
14
14
  vide?: string;
15
15
  pagination?: Pagination;
16
+ onOuvrirLigne?: (rang: number) => void;
16
17
  className?: string;
17
18
  };
18
- export declare function Tableau({ colonnes, lignes, vide, pagination, className }: ProprietesDUnTableau): import("react").JSX.Element;
19
+ export declare function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, className }: ProprietesDUnTableau): import("react").JSX.Element;
package/src/ui/tableau.js CHANGED
@@ -11,12 +11,33 @@ function etendue(page, total, lignes) {
11
11
  const debut = (page - 1) * lignesParPage + 1;
12
12
  return `${nombre.format(debut)}–${nombre.format(debut + lignes - 1)} sur ${nombre.format(total)}`;
13
13
  }
14
+ // Ce qu'un clic dans une ligne laisse à son élément : un lien, un bouton, une saisie, une entrée de
15
+ // menu.
16
+ const elementsDUneLigne = 'a, button, input, select, textarea, label, [role=menuitem], [role=menu], [role=dialog], [role=alertdialog]';
17
+ // Un clic qui ouvre la ligne : un clic simple, fait dans la ligne elle-même. Un clic venu d'un
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.
20
+ function ouvreLaLigne(evenement) {
21
+ const cible = evenement.target;
22
+ if (evenement.defaultPrevented || evenement.button !== 0 || evenement.metaKey || evenement.ctrlKey || evenement.shiftKey || evenement.altKey) {
23
+ return false;
24
+ }
25
+ if (!(cible instanceof Element) || !evenement.currentTarget.contains(cible)) {
26
+ return false;
27
+ }
28
+ return !cible.closest(elementsDUneLigne);
29
+ }
14
30
  // Un tableau : ses colonnes, ses lignes, chaque cellule un contenu, et `vide`, dit sans ligne. Avec
15
- // `pagination`, et plus d'une page, il a sous lui « Précédent », « Suivant » et l'étendue. Sur un
16
- // téléphone, chaque ligne s'empile (la feuille, `.tableau`).
17
- export function Tableau({ colonnes, lignes, vide, pagination, className }) {
31
+ // `pagination`, et plus d'une page, il a sous lui « Précédent », « Suivant » et l'étendue. Avec
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, chaque ligne s'empile (la feuille, `.tableau`).
34
+ export function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, className }) {
18
35
  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
19
- ? lignes.map((ligne, rang) => (_jsx("tr", { className: "border-t border-trait first:border-t-0", children: ligne.map((cellule, colonne) => (_jsx("td", { className: cn('px-3.5 py-2.5 align-top', colonnes[colonne]?.fixe && 'font-mono text-[12.5px] whitespace-nowrap tabular-nums'), children: cellule }, colonne))) }, rang)))
36
+ ? lignes.map((ligne, rang) => (_jsx("tr", { onClick: onOuvrirLigne && ((evenement) => {
37
+ if (ouvreLaLigne(evenement)) {
38
+ onOuvrirLigne(rang);
39
+ }
40
+ }), className: cn('border-t border-trait first:border-t-0', onOuvrirLigne && 'cursor-pointer hover:bg-surface'), children: ligne.map((cellule, colonne) => (_jsx("td", { className: cn('px-3.5 py-2.5 align-top', colonnes[colonne]?.fixe && 'font-mono text-[12.5px] whitespace-nowrap tabular-nums'), children: cellule }, colonne))) }, rang)))
20
41
  : (_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 })] }));
21
42
  }
22
43
  function Pages({ page, total, changerDePage, lignes }) {