@indos/bibliotheque 1.11.0 → 1.12.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.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,23 @@
2
2
 
3
3
  Écrit pour le développeur d'une app du client, qui monte la version de la bibliothèque dans son dépôt : une section par version publiée sur npm. Une version qui demande un geste dans l'app a sa rubrique « Ruptures » : le geste, les versions exactes de React, Vite et TanStack à reprendre, et le core que demande la majeure.
4
4
 
5
+ ## 1.12.0
6
+
7
+ - Le direct à l'écran, le même dans toutes les apps où l'on écrit une chose à plusieurs. `EtatEtPresences` (`etat`, `lectureSeule`, `moi`, `autres`) dit l'état en quatre mots, « Connexion… », « En direct » avec le point à l'accent, « Reconnexion… » en gris, et « · Lecture seule », puis une pastille par personne : une seule quel que soit le nombre de ses onglets, la sienne d'abord, même seule, cinq puis « +n », le nom au survol, « (invité) » pour un invité.
8
+ - `DansLEtatDuDirect` pose l'état et les présences en haut à droite de l'écran d'une chose, avant son geste propre, depuis son corps.
9
+ - `@indos/bibliotheque/presence` : `couleurDe(id)`, la couleur d'une personne tirée de son identifiant, la même à la page et au serveur, dans toutes les apps, lisible en clair et en sombre.
10
+ - L'étiquette du nom d'une autre personne, sur son curseur, sa flèche ou sa cellule : `EtiquetteDuNom` en React, `elementDeLEtiquetteDuNom(id, nom)` dans le DOM, la même forme partout.
11
+ - Les gestes du direct : `useAnnoncerLeDroitQuiBaisse(lecture, { une, feminin })` annonce une fois « Ce tableau ne vous est plus ouvert qu'en lecture. » ; `useMontrerLaChoseIntrouvable(app)` montre l'écran commun d'une chose introuvable à la place d'une chose fermée ; `rechargerLaPage()` mène une session fermée à la connexion.
12
+ - `texteDUneChoseAbsente` s'importe aussi de `@indos/bibliotheque/ui`, pour une page hors de l'espace.
13
+ - Supprimer par le ⋯ s'annonce avec le nom de la chose : « Le document « Plan » est supprimé. », sauf quand l'app déclare `motsDeLaSuppression(chose).fait`.
14
+ - Le refus de `donnerLesChoses` pour une personne encore active se lit sans accord de genre : « Rien n'est donné : le compte de Léa (lea@exemple.ch) est encore actif. »
15
+
16
+ ### Ruptures
17
+
18
+ - Aucun geste dans le code de l'app.
19
+ - Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.12.0 peerDependencies` les donne toutes.
20
+ - Pour monter : `"@indos/bibliotheque": "1.12.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
21
+
5
22
  ## 1.11.0
6
23
 
7
24
  - Trouver et chercher une chose partagée, une fois pour toutes les apps : `creerLePartage` prend `colonnes`, `nom`, `cherche`, `ordre` et, pour des choses rangées les unes dans les autres, `racine`, et rend `trouver` (la chose ouverte à la personne avec son droit, ou rien, un identifiant qui n'est pas un UUID compris), `lire` (la chose avec le droit demandé, sinon le refus d'une chose absente) et `chercher` (le texte sans accents ni casse, les vues `toutes`, `a_moi`, `partagees`, la page et le total), avec `schemaDeChercher` pour l'outil.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "1.11.0",
3
+ "version": "1.12.0",
4
4
  "description": "La bibliothèque des apps d'Indos : le serveur, le MCP, la base et la page de l'espace d'une app.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -96,6 +96,10 @@
96
96
  "types": "./src/sans-accents.d.ts",
97
97
  "default": "./src/sans-accents.js"
98
98
  },
99
+ "./presence": {
100
+ "types": "./src/presence.d.ts",
101
+ "default": "./src/presence.js"
102
+ },
99
103
  "./ui": {
100
104
  "types": "./src/ui/index.d.ts",
101
105
  "default": "./src/ui/index.js"
@@ -0,0 +1,5 @@
1
+ export declare function useAnnoncerLeDroitQuiBaisse(lecture: boolean | undefined, chose: {
2
+ une: string;
3
+ feminin?: boolean;
4
+ }): void;
5
+ export declare function useMontrerLaChoseIntrouvable(app: string): (id: string) => void;
@@ -0,0 +1,37 @@
1
+ import { useQueryClient } from '@tanstack/react-query';
2
+ import { useCallback, useEffect, useRef } from 'react';
3
+ import { texteDuDroitQuiBaisse } from '../ui/direct.js';
4
+ import { cleDesChoses } from './choses.js';
5
+ import { useAnnoncer } from './ouvrir.js';
6
+ // Les gestes du direct dans l'écran d'une chose (bibliotheque/CLAUDE.md, « Le direct à l'écran ») :
7
+ // le droit qui baisse se dit une fois, la chose fermée devient l'écran d'une chose introuvable, et la
8
+ // session fermée recharge la page (`rechargerLaPage`, de ./navigation.ts).
9
+ // Annonce le droit qui baisse : quand `lecture`, ce que le direct dit du droit de la personne, passe
10
+ // de faux à vrai, une annonce, « Ce tableau ne vous est plus ouvert qu'en lecture. ». Une chose qui
11
+ // s'ouvre déjà en lecture ne dit rien. `undefined`, un droit pas encore lu (pendant une connexion),
12
+ // ne compte pas : le dernier droit connu reste celui d'avant.
13
+ export function useAnnoncerLeDroitQuiBaisse(lecture, chose) {
14
+ const annoncer = useAnnoncer();
15
+ const connu = useRef(undefined);
16
+ const { une, feminin } = chose;
17
+ useEffect(() => {
18
+ if (lecture === undefined) {
19
+ return;
20
+ }
21
+ if (connu.current === false && lecture) {
22
+ annoncer(texteDuDroitQuiBaisse(une, feminin));
23
+ }
24
+ connu.current = lecture;
25
+ }, [lecture, annoncer, une, feminin]);
26
+ }
27
+ // Rend la fonction qui montre l'écran commun d'une chose introuvable à la place de la chose `id`,
28
+ // quand le direct dit qu'elle n'existe plus ou n'est plus ouverte à la personne : le même écran
29
+ // qu'à l'ouverture d'un lien vers une chose fermée (`texteDUneChoseAbsente`).
30
+ export function useMontrerLaChoseIntrouvable(app) {
31
+ const client = useQueryClient();
32
+ return useCallback((id) => {
33
+ const cle = cleDesChoses(app, 'chose', id);
34
+ void client.cancelQueries({ queryKey: cle });
35
+ client.setQueryData(cle, null);
36
+ }, [client, app]);
37
+ }
@@ -1,5 +1,8 @@
1
+ import { type ReactNode } from 'react';
1
2
  import { type ChoseTrouvee, type DeclarationDesChoses } from './choses.ts';
2
- export declare const texteDUneChoseAbsente = "Cette chose n'existe pas, ou vous n'y avez pas acc\u00E8s.";
3
+ export declare function DansLEtatDuDirect({ children }: {
4
+ children: ReactNode;
5
+ }): import("react").ReactPortal | null;
3
6
  export declare function EcranDUneChose<C extends ChoseTrouvee>({ choses, id }: {
4
7
  choses: DeclarationDesChoses<C>;
5
8
  id: string;
@@ -1,10 +1,11 @@
1
1
  import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { useQuery } from '@tanstack/react-query';
3
- import { useRef, useState } from 'react';
3
+ import { createContext, useContext, useRef, useState } from 'react';
4
+ import { createPortal } from 'react-dom';
4
5
  import { Message } from '../ui/blocs.js';
5
6
  import { cn } from '../ui/classes.js';
6
7
  import { Bouton } from '../ui/bouton.js';
7
- import { EtatDeLecture } from '../ui/etats.js';
8
+ import { EtatDeLecture, texteDUneChoseAbsente } from '../ui/etats.js';
8
9
  import { Lien } from '../ui/lien.js';
9
10
  import { ErreurDUnAppel } from './appels.js';
10
11
  import { classesDuTitre, DansLeFil, DansLesGestes, separateurDuFil, TitreDuFil, useDeclarerLEcran } from './cadre.js';
@@ -17,10 +18,11 @@ import { useSession } from './session.js';
17
18
  // L'écran d'une chose, dans le cadre de la coquille (docs/architecture.md, « L'espace ») : le fil
18
19
  // d'Ariane « <app> / <liste> / <nom> », que la coquille commence et que l'écran finit par les
19
20
  // ancêtres d'une chose rangée dans une autre, le nom, qui se renomme d'un clic, et la pastille de
20
- // l'accès ; ses gestes en haut à droite, dans leur ordre : le geste propre de l'app, ou « Modifier »
21
- // pour une fiche qui n'en a pas d'autre (`ModifierLaFiche`), la pleine page dans un autre onglet, et
22
- // le ⋯ ; puis le corps, que rend l'app, après l'état de lecture commun. Ni onglets ni étiquette d'état. La
23
- // route pose `staticData: { ecranDUneChose: true, choses }` (`routesDesChoses`) : la coquille y lit la
21
+ // l'accès ; ses gestes en haut à droite, dans leur ordre : l'état du direct d'une chose qu'on écrit
22
+ // à plusieurs (`DansLEtatDuDirect`), le geste propre de l'app, ou « Modifier » pour une fiche qui
23
+ // n'en a pas d'autre (`ModifierLaFiche`), la pleine page dans un autre onglet, et le ⋯ ; puis le
24
+ // corps, que rend l'app, après l'état de lecture commun. Ni onglets ni étiquette d'état. La route
25
+ // pose `staticData: { ecranDUneChose: true, choses }` (`routesDesChoses`) : la coquille y lit la
24
26
  // déclaration pour la barre de la liste. Le corps est à l'app : un cadre qu'il porte reste isolé, et
25
27
  // rien de ce qu'il envoie ne déclenche un geste du cadre ni du panneau du partage, qui n'écoutent que
26
28
  // leurs boutons.
@@ -28,10 +30,18 @@ import { useSession } from './session.js';
28
30
  function estAbsente(erreur) {
29
31
  return erreur instanceof ErreurDUnAppel && erreur.statut >= 400 && erreur.statut < 500;
30
32
  }
31
- export const texteDUneChoseAbsente = 'Cette chose n\'existe pas, ou vous n\'y avez pas accès.';
33
+ // La place de l'état du direct, en haut à droite, avant le geste propre : le corps d'une chose y
34
+ // rend l'état et les présences (`EtatEtPresences`) par `DansLEtatDuDirect`, d'où que vienne son
35
+ // direct.
36
+ const PlaceDuDirect = createContext(null);
37
+ export function DansLEtatDuDirect({ children }) {
38
+ const place = useContext(PlaceDuDirect);
39
+ return place ? createPortal(children, place) : null;
40
+ }
32
41
  export function EcranDUneChose({ choses, id }) {
33
42
  const session = useSession();
34
43
  const ouvrir = useOuvrir();
44
+ const [placeDuDirect, setPlaceDuDirect] = useState(null);
35
45
  const lecture = useQuery({
36
46
  queryKey: cleDesChoses(choses.app, 'chose', id),
37
47
  queryFn: async () => (await choses.lire(id)) ?? null,
@@ -50,7 +60,7 @@ export function EcranDUneChose({ choses, id }) {
50
60
  }
51
61
  const pleinePage = choses.pleinePage?.(chose);
52
62
  const ancetres = choses.ancetres?.(chose) ?? [];
53
- return (_jsxs(_Fragment, { children: [_jsx("title", { children: `${chose.nom} · ${session.theme.nom}` }), _jsxs(DansLeFil, { children: [_jsx(AncetresDansLeFil, { ancetres: ancetres }), _jsx(NomDUneChose, { choses: choses, chose: chose }), choses.lirePartage && _jsx(PastilleDeLAcces, { choses: choses, chose: chose })] }), _jsxs(DansLesGestes, { children: [choses.geste ? choses.geste(chose) : _jsx(ModifierLaFiche, { choses: choses, chose: chose }), pleinePage && (_jsx(Bouton, { asChild: true, sorte: "secondaire", children: _jsxs("a", { href: pleinePage, target: "_blank", rel: "noopener noreferrer", children: [choses.libelleDeLaPleinePage ?? 'Pleine page', " \u2197"] }) })), _jsx(MenuDUneChose, { choses: choses, chose: chose, surLEcran: true, surSupprimee: () => ouvrir(ancetres.at(-1)?.chemin ?? adresseDeLaListe(choses.app)) })] }), choses.plein ? _jsx("div", { className: "flex min-h-0 flex-1 flex-col", children: choses.corps(chose) }) : choses.corps(chose)] }));
63
+ return (_jsxs(PlaceDuDirect.Provider, { value: placeDuDirect, children: [_jsx("title", { children: `${chose.nom} · ${session.theme.nom}` }), _jsxs(DansLeFil, { children: [_jsx(AncetresDansLeFil, { ancetres: ancetres }), _jsx(NomDUneChose, { choses: choses, chose: chose }), choses.lirePartage && _jsx(PastilleDeLAcces, { choses: choses, chose: chose })] }), _jsxs(DansLesGestes, { children: [_jsx("span", { ref: setPlaceDuDirect, className: "contents" }), choses.geste ? choses.geste(chose) : _jsx(ModifierLaFiche, { choses: choses, chose: chose }), pleinePage && (_jsx(Bouton, { asChild: true, sorte: "secondaire", children: _jsxs("a", { href: pleinePage, target: "_blank", rel: "noopener noreferrer", children: [choses.libelleDeLaPleinePage ?? 'Pleine page', " \u2197"] }) })), _jsx(MenuDUneChose, { choses: choses, chose: chose, surLEcran: true, surSupprimee: () => ouvrir(ancetres.at(-1)?.chemin ?? adresseDeLaListe(choses.app)) })] }), choses.plein ? _jsx("div", { className: "flex min-h-0 flex-1 flex-col", children: choses.corps(chose) }) : choses.corps(chose)] }));
54
64
  }
55
65
  // Les ancêtres d'une chose rangée dans une autre, chacun un lien ; au-delà de deux, le premier et
56
66
  // « … ».
@@ -13,9 +13,12 @@ export { EcranDesComptes } from './comptes.tsx';
13
13
  export type { ChampDecrit, CompteListe, DescriptionDesComptes, ListeDesComptes } from '../description-des-comptes.ts';
14
14
  export { desepingler, epingler, lireLAnnuaire, useEpingle, type AnnuaireDeLEcran, type Epingle } from './barre.ts';
15
15
  export { useAnnoncer } from './ouvrir.ts';
16
+ export { useAnnoncerLeDroitQuiBaisse, useMontrerLaChoseIntrouvable } from './direct.ts';
17
+ export { rechargerLaPage } from './navigation.ts';
16
18
  export { chercherParLOutil, cleDesChoses, motsDeLaPublication, rechercheDeLaListe, useRelireLesChoses, vuesDuPartage, type AncetreDUneChose, type ChoseTrouvee, type ChosesTrouvees, type CiblesDuPartage, type ColonneDUneChose, type CritereDeRecherche, type DeclarationDesChoses, type DroitSurUneChose, type FenetreDuMenu, type FormulaireDUneFicheDeclare, type GesteDuMenu, type MotsDeLaPublication, type MotsDUnGeste, type OuvertureDUneChose, type RechercheDeLaListe, type VueDeLaListe, } from './choses.ts';
17
19
  export { ListeDesChoses } from './liste-des-choses.tsx';
18
- export { EcranDUneChose, texteDUneChoseAbsente } from './ecran-d-une-chose.tsx';
20
+ export { DansLEtatDuDirect, EcranDUneChose } from './ecran-d-une-chose.tsx';
21
+ export { texteDUneChoseAbsente } from '../ui/etats.tsx';
19
22
  export { MenuDUneChose, type ProprietesDuMenuDUneChose } from './menu-d-une-chose.tsx';
20
23
  export { FormulaireDUneFiche, ModifierLaFiche, peutModifierLaFiche, type ProprietesDuFormulaireDUneFiche } from './formulaire-d-une-fiche.tsx';
21
24
  export { ConfirmationDUnGeste, demandeLAccord, type AppelAConfirmer, type ProprietesDeLaConfirmationDUnGeste, type QuestionDUnGeste, } from './confirmation-d-un-geste.tsx';
@@ -15,9 +15,12 @@ export { heureDeSuisse } from './heure.js';
15
15
  export { EcranDesComptes } from './comptes.js';
16
16
  export { desepingler, epingler, lireLAnnuaire, useEpingle } from './barre.js';
17
17
  export { useAnnoncer } from './ouvrir.js';
18
+ export { useAnnoncerLeDroitQuiBaisse, useMontrerLaChoseIntrouvable } from './direct.js';
19
+ export { rechargerLaPage } from './navigation.js';
18
20
  export { chercherParLOutil, cleDesChoses, motsDeLaPublication, rechercheDeLaListe, useRelireLesChoses, vuesDuPartage, } from './choses.js';
19
21
  export { ListeDesChoses } from './liste-des-choses.js';
20
- export { EcranDUneChose, texteDUneChoseAbsente } from './ecran-d-une-chose.js';
22
+ export { DansLEtatDuDirect, EcranDUneChose } from './ecran-d-une-chose.js';
23
+ export { texteDUneChoseAbsente } from '../ui/etats.js';
21
24
  export { MenuDUneChose } from './menu-d-une-chose.js';
22
25
  export { FormulaireDUneFiche, ModifierLaFiche, peutModifierLaFiche } from './formulaire-d-une-fiche.js';
23
26
  export { ConfirmationDUnGeste, demandeLAccord, } from './confirmation-d-un-geste.js';
@@ -31,7 +31,7 @@ export function MenuDUneChose({ choses, chose, surLEcran = false, surSupprimee }
31
31
  const suppression = useMutation({
32
32
  mutationFn: () => choses.supprimer(chose),
33
33
  onSuccess: () => {
34
- annoncer(motsDeLaSuppression.fait ?? `${LaChose} est supprimé${mots.e}.`);
34
+ annoncer(motsDeLaSuppression.fait ?? `${LaChose} « ${chose.nom} » est supprimé${mots.e}.`);
35
35
  client.removeQueries({ queryKey: cleDesChoses(choses.app, 'chose', chose.id) });
36
36
  surSupprimee?.();
37
37
  void relire();
@@ -1 +1,2 @@
1
1
  export declare function allerA(adresse: string): void;
2
+ export declare function rechargerLaPage(): void;
@@ -3,3 +3,7 @@
3
3
  export function allerA(adresse) {
4
4
  window.location.assign(adresse);
5
5
  }
6
+ // Recharge la page : une session fermée mène ainsi à la connexion du core, qui ramène à la page.
7
+ export function rechargerLaPage() {
8
+ window.location.reload();
9
+ }
package/src/partage.js CHANGED
@@ -390,7 +390,7 @@ export function creerLePartage(options) {
390
390
  const annuaire = await lireLAnnuaire({ sansCache: true });
391
391
  const de = personneDuCourriel(annuaire, arguments_.de, 'Rien n\'est donné');
392
392
  if (de.active) {
393
- throw new Refus(`Rien n'est donné : ${de.nom} (${de.email}) est encore active. Ses choses ne se donnent ainsi qu'une fois la personne désactivée, dans « Équipe ».`);
393
+ throw new Refus(`Rien n'est donné : le compte de ${de.nom} (${de.email}) est encore actif. Ses choses ne se donnent ainsi qu'une fois la personne désactivée, dans « Équipe ».`);
394
394
  }
395
395
  const a = personneDuCourriel(annuaire, arguments_.a, 'Rien n\'est donné');
396
396
  if (!a.active) {
@@ -0,0 +1,2 @@
1
+ export declare const couleursDesPersonnes: readonly ['#2b6dc9', '#c6327c', '#1f7d4e', '#996216', '#9a49c2', '#177a83', '#4a7a29', '#6262cb'];
2
+ export declare function couleurDe(id: string): string;
@@ -0,0 +1,28 @@
1
+ // @indos/bibliotheque/presence : la couleur d'une personne dans le direct, sans rien de Node ni du
2
+ // navigateur (bibliotheque/CLAUDE.md, « Le direct à l'écran »). La page et le serveur la calculent
3
+ // de la même façon : une personne a la même couleur dans toutes les apps, sur chaque appareil.
4
+ // Huit couleurs à la même luminance, ni rouge ni orange, pour ne se confondre ni avec l'accent ni
5
+ // avec l'erreur. Chacune se lit sur le papier clair (#faf8f3) et sur la surface du charbon (#1e1e1e)
6
+ // à 3:1 au moins, et porte un texte blanc à 4,5:1 au moins (tests/presence.test.ts). Elles sont les
7
+ // mêmes en clair et en sombre : la couleur dit qui est là, rien d'autre.
8
+ export const couleursDesPersonnes = [
9
+ '#2b6dc9', // bleu
10
+ '#c6327c', // magenta
11
+ '#1f7d4e', // vert
12
+ '#996216', // ocre
13
+ '#9a49c2', // violet
14
+ '#177a83', // sarcelle
15
+ '#4a7a29', // olive
16
+ '#6262cb', // indigo
17
+ ];
18
+ // La couleur d'une personne, tirée de son identifiant (celui de sa session, ou celui qu'un invité
19
+ // garde dans son navigateur) : FNV-1a sur 32 bits, sur les unités UTF-16 de l'identifiant, puis le
20
+ // reste de sa division par le nombre de couleurs. Deux personnes peuvent avoir la même.
21
+ export function couleurDe(id) {
22
+ let empreinte = 0x811c9dc5;
23
+ for (let rang = 0; rang < id.length; rang++) {
24
+ empreinte ^= id.charCodeAt(rang);
25
+ empreinte = Math.imul(empreinte, 0x01000193);
26
+ }
27
+ return couleursDesPersonnes[(empreinte >>> 0) % couleursDesPersonnes.length];
28
+ }
@@ -0,0 +1,26 @@
1
+ import type { HTMLAttributes } from 'react';
2
+ export type EtatDeLaConnexion = 'connexion' | 'en-direct' | 'reconnexion';
3
+ export type PersonnePresente = {
4
+ id: string;
5
+ nom: string;
6
+ invite?: boolean;
7
+ };
8
+ export type ProprietesDeLEtatEtDesPresences = {
9
+ etat: EtatDeLaConnexion;
10
+ lectureSeule?: boolean;
11
+ moi: PersonnePresente;
12
+ autres: PersonnePresente[];
13
+ className?: string;
14
+ };
15
+ export declare function texteDeLEtat(etat: EtatDeLaConnexion, lectureSeule?: boolean): string;
16
+ export declare const pastillesMontrees = 5;
17
+ export declare function personnesPresentes(moi: PersonnePresente, autres: PersonnePresente[]): PersonnePresente[];
18
+ export declare function EtatEtPresences({ etat, lectureSeule, moi, autres, className }: ProprietesDeLEtatEtDesPresences): import("react").JSX.Element;
19
+ export declare const classesDeLEtiquetteDuNom = "pointer-events-none inline-block max-w-[16em] truncate rounded-[4px] px-1.5 align-top font-sans text-[11px] leading-[18px] font-semibold whitespace-nowrap select-none";
20
+ export type ProprietesDeLEtiquetteDuNom = {
21
+ id: string;
22
+ nom: string;
23
+ } & Omit<HTMLAttributes<HTMLSpanElement>, 'children'>;
24
+ export declare function EtiquetteDuNom({ id, nom, className, style, ...reste }: ProprietesDeLEtiquetteDuNom): import("react").JSX.Element;
25
+ export declare function elementDeLEtiquetteDuNom(id: string, nom: string): HTMLSpanElement;
26
+ export declare function texteDuDroitQuiBaisse(une: string, feminin?: boolean): string;
@@ -0,0 +1,69 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { couleurDe } from '../presence.js';
3
+ import { cn } from './classes.js';
4
+ const motsDeLEtat = { connexion: 'Connexion…', 'en-direct': 'En direct', reconnexion: 'Reconnexion…' };
5
+ // L'état en mots : « Connexion… », « En direct », « Reconnexion… », suivis de « · Lecture seule »
6
+ // quand la personne ne peut que lire.
7
+ export function texteDeLEtat(etat, lectureSeule = false) {
8
+ return `${motsDeLEtat[etat]}${lectureSeule ? ' · Lecture seule' : ''}`;
9
+ }
10
+ // Les pastilles montrées avant « +n ».
11
+ export const pastillesMontrees = 5;
12
+ // Les personnes présentes, chacune une fois, quel que soit le nombre de ses onglets : la personne
13
+ // d'abord, puis les autres dans l'ordre reçu.
14
+ export function personnesPresentes(moi, autres) {
15
+ const vues = new Set([moi.id]);
16
+ const toutes = [moi];
17
+ for (const autre of autres) {
18
+ if (!vues.has(autre.id)) {
19
+ vues.add(autre.id);
20
+ toutes.push(autre);
21
+ }
22
+ }
23
+ return toutes;
24
+ }
25
+ // Le nom d'une personne au survol : « Léa (vous) », « Max (invité) », « Zoé ».
26
+ function nomAuSurvol(personne, estMoi) {
27
+ return estMoi ? `${personne.nom} (vous)` : personne.invite ? `${personne.nom} (invité)` : personne.nom;
28
+ }
29
+ // L'initiale d'un nom, une lettre entière même hors du plan de base d'Unicode.
30
+ function initiale(nom) {
31
+ return (Array.from(nom.trim())[0] ?? '?').toLocaleUpperCase('fr');
32
+ }
33
+ // L'état et les présences : le point, à l'accent en direct et en gris sinon, et l'état en mots, en
34
+ // gris ; puis une pastille par personne, la sienne d'abord, même seule, à sa couleur, son initiale
35
+ // en blanc, son nom au survol ; au-delà de cinq, « +n », les autres noms au survol. Les noms passent
36
+ // par React, qui les échappe.
37
+ export function EtatEtPresences({ etat, lectureSeule = false, moi, autres, className }) {
38
+ const presentes = personnesPresentes(moi, autres);
39
+ const montrees = presentes.slice(0, pastillesMontrees);
40
+ const cachees = presentes.slice(pastillesMontrees);
41
+ return (_jsxs("div", { className: cn('flex min-w-0 items-center gap-3', className), children: [_jsxs("span", { role: "status", className: "flex items-center gap-1.5 text-[13px] whitespace-nowrap text-gris", children: [_jsx("span", { "aria-hidden": "true", "data-en-direct": etat === 'en-direct' ? '' : undefined, className: cn('size-[7px] shrink-0 rounded-full', etat === 'en-direct' ? 'bg-accent' : 'bg-gris') }), texteDeLEtat(etat, lectureSeule)] }), _jsxs("div", { role: "group", "aria-label": presentes.length === 1 ? '1 personne présente' : `${presentes.length} personnes présentes`, className: "flex shrink-0 gap-1", children: [montrees.map((personne, rang) => {
42
+ const nom = nomAuSurvol(personne, rang === 0);
43
+ return (_jsx("span", { role: "img", "aria-label": nom, title: nom, className: "inline-flex size-6 items-center justify-center rounded-full font-sans text-[12px] font-medium select-none", style: { background: couleurDe(personne.id), color: '#fff' }, children: initiale(personne.nom) }, personne.id));
44
+ }), cachees.length > 0 && (_jsxs("span", { role: "img", "aria-label": `Et ${cachees.length} de plus : ${cachees.map((personne) => nomAuSurvol(personne, false)).join(', ')}`, title: cachees.map((personne) => nomAuSurvol(personne, false)).join(', '), className: "inline-flex h-6 items-center rounded-full bg-survol px-1.5 text-[12px] text-gris select-none", children: ["+", cachees.length] }))] })] }));
45
+ }
46
+ // La forme de l'étiquette du nom, la même partout : un petit bloc à la couleur de la personne, son
47
+ // nom en blanc, sur une ligne, coupé au-delà de 16 caractères environ. L'app la place (sur un
48
+ // curseur, une flèche, une cellule) par ses propres classes.
49
+ export const classesDeLEtiquetteDuNom = 'pointer-events-none inline-block max-w-[16em] truncate rounded-[4px] px-1.5 align-top font-sans text-[11px] leading-[18px] font-semibold whitespace-nowrap select-none';
50
+ // L'étiquette du nom d'une autre personne, en React (une flèche sur une toile, une cellule).
51
+ export function EtiquetteDuNom({ id, nom, className, style, ...reste }) {
52
+ return (_jsx("span", { ...reste, className: cn(classesDeLEtiquetteDuNom, className), style: { ...style, background: couleurDe(id), color: '#fff' }, children: nom }));
53
+ }
54
+ // La même étiquette, en élément du DOM, pour ce qui ne se rend pas par React, comme le curseur d'un
55
+ // éditeur de texte. Le nom en est le texte, jamais du HTML.
56
+ export function elementDeLEtiquetteDuNom(id, nom) {
57
+ const element = document.createElement('span');
58
+ element.className = classesDeLEtiquetteDuNom;
59
+ element.style.background = couleurDe(id);
60
+ element.style.color = '#fff';
61
+ element.textContent = nom;
62
+ return element;
63
+ }
64
+ // Ce que dit le droit qui baisse pendant que la chose est ouverte : « Ce tableau ne vous est plus
65
+ // ouvert qu'en lecture. » `une` et `feminin` sont ceux de la déclaration des choses.
66
+ export function texteDuDroitQuiBaisse(une, feminin = false) {
67
+ const ce = feminin ? 'Cette' : /^[aeiouyàâéèêëîïôûü]/i.test(une) ? 'Cet' : 'Ce';
68
+ return `${ce} ${une} ne vous est plus ouvert${feminin ? 'e' : ''} qu'en lecture.`;
69
+ }
package/src/ui/etats.d.ts CHANGED
@@ -3,6 +3,7 @@ export declare const texteDeLaLecture = "Chargement\u2026";
3
3
  export declare function EtatDeLecture({ className }: {
4
4
  className?: string;
5
5
  }): import("react").JSX.Element | null;
6
+ export declare const texteDUneChoseAbsente = "Cette chose n'existe pas, ou vous n'y avez pas acc\u00E8s.";
6
7
  export declare function texteSansResultat(une: string, feminin: boolean | undefined, texte: string): string;
7
8
  export declare function SansResultat({ une, feminin, texte, className }: {
8
9
  une: string;
package/src/ui/etats.js CHANGED
@@ -18,6 +18,9 @@ export function EtatDeLecture({ className }) {
18
18
  }, []);
19
19
  return visible ? _jsx("p", { className: cn('m-0 text-gris', className), children: texteDeLaLecture }) : null;
20
20
  }
21
+ // Une chose absente, ou qui n'est plus ouverte à la personne : la même phrase dans toutes les apps,
22
+ // sur l'écran d'une chose comme sur une page hors de l'espace, comme celle d'un invité.
23
+ export const texteDUneChoseAbsente = 'Cette chose n\'existe pas, ou vous n\'y avez pas accès.';
21
24
  // La phrase d'une recherche sans résultat, la même partout : « Aucun contact ne correspond à
22
25
  // « Léa ». ». `une` et `feminin` sont la chose cherchée, comme dans la déclaration des choses.
23
26
  export function texteSansResultat(une, feminin, texte) {
package/src/ui/index.d.ts CHANGED
@@ -8,7 +8,7 @@ export { largeurDeLaRecherche, largeurDUnFormulaire, Recherche, type ProprietesD
8
8
  export { Confirmation, type ProprietesDUneConfirmation } from './confirmation.tsx';
9
9
  export { Menu, MenuContenu, MenuDeclencheur, MenuEntree, MenuLibelle, MenuSeparateur } from './menu.tsx';
10
10
  export { MenuDUneLigne, type FenetreDuMenu, type GesteDuMenu, type ProprietesDuMenuDUneLigne } from './menu-d-une-ligne.tsx';
11
- export { attenteDeLaLecture, EtatDeLecture, SansResultat, texteDeLaLecture, texteSansResultat } from './etats.tsx';
11
+ export { attenteDeLaLecture, EtatDeLecture, SansResultat, texteDeLaLecture, texteDUneChoseAbsente, texteSansResultat } from './etats.tsx';
12
12
  export { lignesParPage } from '../pagination.ts';
13
13
  export { Tableau, type Colonne, type Pagination, type ProprietesDUnTableau } from './tableau.tsx';
14
14
  export { Repli, type ProprietesDUnRepli } from './repli.tsx';
@@ -20,3 +20,4 @@ export { Vues, type ProprietesDesVues, type Vue } from './vues.tsx';
20
20
  export { Annonce, type ProprietesDUneAnnonce } from './annonce.tsx';
21
21
  export { IconeDEpingle, IconeDesApps } from './icones.tsx';
22
22
  export { Suggestions, type ProprietesDesSuggestions, type Suggestion } from './suggestions.tsx';
23
+ export { classesDeLEtiquetteDuNom, elementDeLEtiquetteDuNom, EtatEtPresences, EtiquetteDuNom, pastillesMontrees, personnesPresentes, texteDeLEtat, texteDuDroitQuiBaisse, type EtatDeLaConnexion, type PersonnePresente, type ProprietesDeLEtatEtDesPresences, type ProprietesDeLEtiquetteDuNom, } from './direct.tsx';
package/src/ui/index.js CHANGED
@@ -10,7 +10,7 @@ export { largeurDeLaRecherche, largeurDUnFormulaire, Recherche } from './recherc
10
10
  export { Confirmation } from './confirmation.js';
11
11
  export { Menu, MenuContenu, MenuDeclencheur, MenuEntree, MenuLibelle, MenuSeparateur } from './menu.js';
12
12
  export { MenuDUneLigne } from './menu-d-une-ligne.js';
13
- export { attenteDeLaLecture, EtatDeLecture, SansResultat, texteDeLaLecture, texteSansResultat } from './etats.js';
13
+ export { attenteDeLaLecture, EtatDeLecture, SansResultat, texteDeLaLecture, texteDUneChoseAbsente, texteSansResultat } from './etats.js';
14
14
  export { lignesParPage } from '../pagination.js';
15
15
  export { Tableau } from './tableau.js';
16
16
  export { Repli } from './repli.js';
@@ -22,3 +22,4 @@ export { Vues } from './vues.js';
22
22
  export { Annonce } from './annonce.js';
23
23
  export { IconeDEpingle, IconeDesApps } from './icones.js';
24
24
  export { Suggestions } from './suggestions.js';
25
+ export { classesDeLEtiquetteDuNom, elementDeLEtiquetteDuNom, EtatEtPresences, EtiquetteDuNom, pastillesMontrees, personnesPresentes, texteDeLEtat, texteDuDroitQuiBaisse, } from './direct.js';