@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 +17 -0
- package/package.json +5 -1
- package/src/espace/direct.d.ts +5 -0
- package/src/espace/direct.js +37 -0
- package/src/espace/ecran-d-une-chose.d.ts +4 -1
- package/src/espace/ecran-d-une-chose.js +18 -8
- package/src/espace/index.d.ts +4 -1
- package/src/espace/index.js +4 -1
- package/src/espace/menu-d-une-chose.js +1 -1
- package/src/espace/navigation.d.ts +1 -0
- package/src/espace/navigation.js +4 -0
- package/src/partage.js +1 -1
- package/src/presence.d.ts +2 -0
- package/src/presence.js +28 -0
- package/src/ui/direct.d.ts +26 -0
- package/src/ui/direct.js +69 -0
- package/src/ui/etats.d.ts +1 -0
- package/src/ui/etats.js +3 -0
- package/src/ui/index.d.ts +2 -1
- package/src/ui/index.js +2 -1
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.
|
|
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,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
|
|
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 :
|
|
21
|
-
//
|
|
22
|
-
//
|
|
23
|
-
//
|
|
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
|
-
|
|
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(
|
|
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
|
// « … ».
|
package/src/espace/index.d.ts
CHANGED
|
@@ -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 {
|
|
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';
|
package/src/espace/index.js
CHANGED
|
@@ -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 {
|
|
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();
|
package/src/espace/navigation.js
CHANGED
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
|
|
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) {
|
package/src/presence.js
ADDED
|
@@ -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;
|
package/src/ui/direct.js
ADDED
|
@@ -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';
|