@indos/bibliotheque 1.13.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.
- package/CHANGELOG.md +31 -0
- package/package.json +1 -1
- package/src/direct/page.d.ts +1 -2
- package/src/espace/apercu.d.ts +9 -0
- package/src/espace/apercu.js +105 -0
- package/src/espace/cadre.d.ts +12 -0
- package/src/espace/cadre.js +21 -10
- package/src/espace/choses.d.ts +19 -7
- package/src/espace/choses.js +21 -9
- package/src/espace/coquille.d.ts +4 -0
- package/src/espace/coquille.js +44 -34
- package/src/espace/direct.d.ts +9 -0
- package/src/espace/direct.js +20 -4
- package/src/espace/ecran-d-une-chose.d.ts +0 -4
- package/src/espace/ecran-d-une-chose.js +40 -30
- package/src/espace/ecran.d.ts +1 -2
- package/src/espace/ecran.js +7 -6
- package/src/espace/formulaire-d-une-fiche.js +4 -5
- package/src/espace/index.d.ts +6 -7
- package/src/espace/index.js +5 -6
- package/src/espace/lien.d.ts +4 -4
- package/src/espace/lien.js +3 -5
- package/src/espace/liste-des-choses.js +86 -24
- package/src/espace/menu-d-une-chose.d.ts +2 -1
- package/src/espace/menu-d-une-chose.js +14 -11
- package/src/espace/ouvrir.d.ts +1 -4
- package/src/espace/ouvrir.js +5 -13
- package/src/espace/page.d.ts +0 -2
- package/src/espace/page.js +0 -3
- package/src/espace/panneau-du-partage.d.ts +9 -8
- package/src/espace/panneau-du-partage.js +130 -46
- package/src/espace/routes-des-choses.js +2 -2
- package/src/forme-du-direct.d.ts +1 -0
- package/src/partage.d.ts +7 -2
- package/src/partage.js +26 -7
- package/src/ui/direct.d.ts +4 -2
- package/src/ui/direct.js +2 -2
- package/src/ui/icones.d.ts +6 -0
- package/src/ui/icones.js +8 -0
- package/src/ui/index.d.ts +1 -1
- package/src/ui/index.js +1 -1
- package/src/ui/menu-d-une-ligne.js +1 -1
- package/src/ui/tableau.d.ts +3 -1
- package/src/ui/tableau.js +10 -5
- package/src/espace/barre-de-la-liste.d.ts +0 -6
- package/src/espace/barre-de-la-liste.js +0 -78
- package/src/espace/heure.d.ts +0 -1
- package/src/espace/heure.js +0 -6
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,37 @@
|
|
|
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
|
+
## 2.0.0
|
|
6
|
+
|
|
7
|
+
La tête d'une chose, son partage et sa liste, les mêmes dans toutes les apps.
|
|
8
|
+
|
|
9
|
+
- La barre de gauche est toujours celle de l'OS : la barre de la liste disparaît. Un clic sur une ligne de la liste ouvre la chose dans l'aperçu, posé par-dessus la liste, à droite (`?apercu=<id>` dans la recherche de la liste) ; ↑ ↓ passent d'une chose à l'autre, Entrée l'ouvre en grand, Échap ferme ; le carré en tête de la ligne, ou un double-clic, l'ouvre en grand. L'aperçu est l'écran de la chose, le même, dans un panneau de 380 à 680 px : un corps se garde lisible en étroit. Une app qui écrit sa route de liste à la main lui donne `validateSearch: rechercheDeLaListe` et rend `ListeDesChoses`, qui monte l'aperçu. `Tableau` prend `onOuvrirEnGrand` et `ligneOuverte` ; `IconeAgrandir` et `IconeFermer` rejoignent les icônes.
|
|
10
|
+
- La ligne du haut porte les onglets de l'app : le premier au titre de l'app, puis « Réglages » et « Documentation » ; l'onglet actif est le `<h1>`, que rend la coquille. Une app sans écran fait précéder ses onglets de son titre (« Agenda / Réglages · Documentation »). L'épingle est tout à droite de la ligne, et non dans le fil.
|
|
11
|
+
- Sur une chose, le fil « App / Nom » (« App / Mandats / Nom » pour une chose qui déclare `liste`), puis à droite, et seulement, le bloc de l'accès, l'épingle et le ⋯.
|
|
12
|
+
- La ligne de tête du corps : `etatDeLaChose(chose)` à gauche, en gris (« Brouillon · échéance le 30.11.2026 ») ; à droite, « Modifier » (le `formulaire` d'une fiche) puis `gestes(chose)`, chaque geste un composant autonome qui porte sa fenêtre, sa mutation et sa relecture.
|
|
13
|
+
- Le bloc de l'accès, `BlocDeLAcces` : qui voit la chose (le cadenas, les personnes et leur nombre, le globe d'une chose publiée), puis les présents, une pastille chacun, avec le point vert ; « Reconnexion… » ou « Lecture » à sa gauche, hors du nominal seulement. Le corps déclare son direct en données, `useDeclarerLeDirect({ etat, personnes, lecture })`. Le bloc ouvre le panneau du partage ; quand l'app déclare `lirePartage` sans `partager`, comme une facture qui montre le partage de son mandat, il se lit sans s'ouvrir.
|
|
14
|
+
- Le ⋯, le même ordre dans la liste et sur la chose : Ouvrir et Ouvrir en grand (dans la liste), « Ouvrir à part ↗ » (`aPart(chose)`, une adresse que l'app sert, la chose avec la session), le rendu (`rendu(chose)`, `{ libelle, adresse }`, comme « PDF ↗ »), Partager… et Renommer (dans la liste ; Partager… quand l'app déclare `partager`), `gestesDuMenu`, Donner à…, l'épingle (dans la liste), Supprimer.
|
|
15
|
+
- Le panneau du partage a deux parties : « Dans l'équipe », et « Hors de l'équipe » quand l'app déclare `publier`, avec ses mots, `publication: { phrase, verbe, fermer, etiquette, etiquetteNonPubliee, consequence }` (par défaut « Quiconque a le lien la voit, en lecture, sans compte. », « Publier », « Ne plus publier », « Publiée ») ; publiée, l'adresse publique en lien, son icône qui la copie (« Lien public copié. ») et le lien discret qui la ferme. La colonne de la liste dit « <partage> · <etiquette> » (« Privée · Publiée »).
|
|
16
|
+
- La vue des publiées : `vuesDuPartage(feminin, { publiees: true })` à l'écran ; côté serveur, `creerLePartage({ publication: '<colonne>' })` fait entrer `publiees` dans `chercher` et dans `partage.schemaDeChercher()`.
|
|
17
|
+
|
|
18
|
+
### Ruptures
|
|
19
|
+
|
|
20
|
+
- `geste(chose)` est retiré : les gestes de l'app vont dans `gestes(chose)`, et son état dans `etatDeLaChose(chose)`, sur la ligne de tête du corps. « Modifier » y vient du `formulaire` : l'app ne rend plus `<ModifierLaFiche />` dans son corps.
|
|
21
|
+
- `pleinePage` et `libelleDeLaPleinePage` sont retirés : `rendu: (chose) => ({ libelle, adresse })` pour ce qu'on donne hors de l'écran (un PDF, un QR code), ou `aPart: (chose) => adresse` pour la chose elle-même hors du cadre, avec la session (le lecteur d'une présentation).
|
|
22
|
+
- `sousLigne` est retiré : l'aperçu montre la chose.
|
|
23
|
+
- `DansLEtatDuDirect` est retiré : le corps déclare son direct par `useDeclarerLeDirect({ etat, personnes, lecture })`, que le bloc de l'accès dessine. `EtatEtPresences` reste dans `@indos/bibliotheque/ui`, pour une page hors de l'espace, comme celle d'un invité.
|
|
24
|
+
- `DansLesGestes` n'est plus exporté : rien de l'app n'entre dans la ligne du haut.
|
|
25
|
+
- `Ecran.action` est retiré : les gestes d'un onglet vont dans son contenu.
|
|
26
|
+
- `coquilleDesReglages` est retirée : la route des réglages se déclare sous `coquilleDeLEspace`. `staticData: { pleineLargeur: true }` est retiré : `pleineHauteur`. `heureDeSuisse` est retirée : `jourEtHeure`, de `@indos/bibliotheque/format`.
|
|
27
|
+
- `PastilleDeLAcces` est retirée : `BlocDeLAcces`.
|
|
28
|
+
- Les mots de `publication` sont `phrase`, `verbe`, `fermer`, `etiquette`, `etiquetteNonPubliee` et `consequence` : `titre` est retiré.
|
|
29
|
+
- Les mots par défaut de la publication sont « Publier », « Ne plus publier », la phrase « Quiconque a le lien la voit, en lecture, sans compte. » et l'étiquette « Publiée » : un test qui cherchait « Ouvrir le lien », « Fermer le lien » ou « Par un lien » les cherche par ces mots.
|
|
30
|
+
- « Partager… », dans le ⋯ d'une ligne, ne s'offre que si l'app déclare `partager` : une app qui déclare `lirePartage` seul n'a plus d'entrée pour ouvrir le panneau en lecture depuis la liste ; le bloc de l'accès de l'aperçu et de l'écran se lit sans s'ouvrir.
|
|
31
|
+
- Un test qui ouvrait une chose d'un clic sur sa ligne clique « Ouvrir « <nom> » en grand », ou lit l'aperçu (`complementary`, « Aperçu ») ; le titre d'un onglet se lit dans la ligne du haut (`navigation`, « Onglets ») ; le fil d'une chose est « App / Nom ».
|
|
32
|
+
- Les versions de React (19.3.1), Vite (8.3.5) et TanStack (`@tanstack/react-router` 1.170.44, `@tanstack/react-query` 5.104.2) ne changent pas ; `npm view @indos/bibliotheque@2.0.0 peerDependencies` les donne toutes.
|
|
33
|
+
- Le core 2.4 ou plus récent, dans sa majeure 2 : `"core": ">=2.4 <3"` dans `dependances.core` du `module.json` de l'app.
|
|
34
|
+
- Pour monter : `"@indos/bibliotheque": "2.0.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
|
|
35
|
+
|
|
5
36
|
## 1.13.0
|
|
6
37
|
|
|
7
38
|
- Le direct Yjs, écrit une fois pour toutes les apps où l'on écrit une chose à plusieurs, dans sa propre entrée : `@indos/bibliotheque/direct` pour le serveur, `creerLeDirectYjs`, et `@indos/bibliotheque/direct/page` pour la page, `ouvrirUnDirectYjs`. L'app donne le droit d'une personne sur une chose, sa chose publiée, l'état en base et son écriture ; la bibliothèque fait le contrôle à l'ouverture, sous le domaine comme sur l'hôte public, la taille des messages, le battement, la relecture du droit après un partage, un don ou une suppression, la chose pleine, l'écriture de Claude, la reconnexion et « réessayez ».
|
package/package.json
CHANGED
package/src/direct/page.d.ts
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import { HocuspocusProvider } from '@hocuspocus/provider';
|
|
2
2
|
import * as Y from 'yjs';
|
|
3
|
-
import { type Invite } from '../forme-du-direct.ts';
|
|
4
|
-
import type { EtatDeLaConnexion } from '../ui/direct.tsx';
|
|
3
|
+
import { type EtatDeLaConnexion, type Invite } from '../forme-du-direct.ts';
|
|
5
4
|
export { codes, estUneChoseAbsente, ongletsDesAutres, personneDeLEtat, personnesDesAutres, raisons, type Invite, type OngletPresent, } from '../forme-du-direct.ts';
|
|
6
5
|
export type EtatDuDirect = {
|
|
7
6
|
sorte: EtatDeLaConnexion;
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { ChoseTrouvee, DeclarationDesChoses } from './choses.ts';
|
|
2
|
+
export declare function ApercuDUneChose<C extends ChoseTrouvee>({ choses, id, chemin: cheminDeLaLigne, fermer, passer, quitter }: {
|
|
3
|
+
choses: DeclarationDesChoses<C>;
|
|
4
|
+
id: string;
|
|
5
|
+
chemin?: string;
|
|
6
|
+
fermer: () => void;
|
|
7
|
+
passer: (sens: 1 | -1) => void;
|
|
8
|
+
quitter: () => void;
|
|
9
|
+
}): import("react").JSX.Element;
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
2
|
+
import { useEffect, useMemo, useRef, useState } from 'react';
|
|
3
|
+
import { IconeAgrandir, IconeFermer } from '../ui/icones.js';
|
|
4
|
+
import { ContexteDuCadre } from './cadre.js';
|
|
5
|
+
import { EpingleDuCadre } from './coquille.js';
|
|
6
|
+
import { EcranDUneChose } from './ecran-d-une-chose.js';
|
|
7
|
+
import { LienDansLaPage } from './lien.js';
|
|
8
|
+
import { useOuvrir } from './ouvrir.js';
|
|
9
|
+
// L'aperçu d'une chose, par-dessus sa liste (docs/architecture.md, « L'espace ») : l'écran de la
|
|
10
|
+
// chose, le même, en étroit, dans un panneau posé à droite de la zone de l'écran, sur toute sa
|
|
11
|
+
// hauteur, ligne du haut comprise, une ombre sur son bord gauche, sans voile : la liste reste
|
|
12
|
+
// utilisable et ne bouge pas. 55 % de la zone au plus, 680 px au plus, 380 px au moins ; sous
|
|
13
|
+
// 760 px, tout l'écran. Il apparaît net, sans glisser.
|
|
14
|
+
//
|
|
15
|
+
// Sa tête est celle d'une chose, dans le cadre que le panneau donne à l'écran de la chose : le nom à
|
|
16
|
+
// gauche (un `<h2>`, renommable), puis le bloc de l'accès, l'épingle de la chose, le ⋯, un trait,
|
|
17
|
+
// « Agrandir », qui mène à son écran, et « Fermer ». Son pied dit le clavier : ↑ ↓ passent à la ligne
|
|
18
|
+
// voisine (`passer`), Entrée agrandit, Échap ferme (`toucheDeLApercu`). Le focus va au titre à
|
|
19
|
+
// l'ouverture. La liste tient l'adresse (`apercu`) et le focus qui revient à la ligne.
|
|
20
|
+
// Les icônes de la tête, de 28 px comme l'épingle et le ⋯ ; le survol ne change que la couleur.
|
|
21
|
+
const classesDUneIcone = 'grid size-7 flex-none cursor-pointer place-items-center rounded-md border-0 bg-transparent text-gris no-underline hover:bg-survol hover:text-encre';
|
|
22
|
+
// Le corps de la chose dans l'aperçu, que rend l'app : ses touches restent les siennes.
|
|
23
|
+
const attributDuCorps = 'data-corps-de-l-apercu';
|
|
24
|
+
export function ApercuDUneChose({ choses, id, chemin: cheminDeLaLigne, fermer, passer, quitter }) {
|
|
25
|
+
const ouvrir = useOuvrir();
|
|
26
|
+
const [fin, setFin] = useState(null);
|
|
27
|
+
const [gestes, setGestes] = useState(null);
|
|
28
|
+
const [menu, setMenu] = useState(null);
|
|
29
|
+
const [ecran, setEcran] = useState({});
|
|
30
|
+
// Le cadre ne change qu'avec ses emplacements : `quitter` se lit au moment où la chose part.
|
|
31
|
+
const quitterMaintenant = useRef(quitter);
|
|
32
|
+
quitterMaintenant.current = quitter;
|
|
33
|
+
const cadre = useMemo(() => ({ fin, gestes, menu, declarer: setEcran, apercu: { quitter: () => quitterMaintenant.current() } }), [fin, gestes, menu]);
|
|
34
|
+
const chemin = ecran.introuvable ? undefined : ecran.chemin ?? cheminDeLaLigne;
|
|
35
|
+
// Le focus au titre, une fois la chose lue ou dite introuvable, sans faire défiler la page.
|
|
36
|
+
const focalise = useRef(false);
|
|
37
|
+
useEffect(() => {
|
|
38
|
+
if (focalise.current || !fin || (ecran.nom === undefined && !ecran.introuvable)) {
|
|
39
|
+
return;
|
|
40
|
+
}
|
|
41
|
+
const titre = fin.querySelector('h2');
|
|
42
|
+
if (titre) {
|
|
43
|
+
focalise.current = true;
|
|
44
|
+
titre.focus({ preventScroll: true });
|
|
45
|
+
}
|
|
46
|
+
}, [fin, ecran.nom, ecran.introuvable]);
|
|
47
|
+
useEffect(() => {
|
|
48
|
+
function touche(evenement) {
|
|
49
|
+
const geste = toucheDeLApercu(evenement);
|
|
50
|
+
if (!geste || (geste === 'agrandir' && !chemin)) {
|
|
51
|
+
return;
|
|
52
|
+
}
|
|
53
|
+
evenement.preventDefault();
|
|
54
|
+
if (geste === 'fermer') {
|
|
55
|
+
fermer();
|
|
56
|
+
}
|
|
57
|
+
else if (geste === 'agrandir') {
|
|
58
|
+
ouvrir(chemin);
|
|
59
|
+
}
|
|
60
|
+
else {
|
|
61
|
+
passer(geste === 'suivante' ? 1 : -1);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
document.addEventListener('keydown', touche);
|
|
65
|
+
return () => document.removeEventListener('keydown', touche);
|
|
66
|
+
}, [chemin, fermer, passer, ouvrir]);
|
|
67
|
+
return (_jsx("aside", { "aria-label": "Aper\u00E7u", className: [
|
|
68
|
+
'absolute inset-y-0 right-0 z-30 w-[min(55%,680px)] min-w-[380px] border-l border-trait bg-papier text-encre shadow-[-16px_0_40px_rgb(0_0_0/0.12)]',
|
|
69
|
+
'max-[760px]:fixed max-[760px]:inset-0 max-[760px]:w-auto max-[760px]:min-w-0 max-[760px]:border-l-0 max-[760px]:shadow-none',
|
|
70
|
+
].join(' '), children: _jsxs("div", { className: "sticky top-0 flex h-dvh max-h-full flex-col pt-4 max-[760px]:max-h-none max-[760px]:pt-3", children: [_jsxs("div", { className: "flex min-h-11 flex-none items-center gap-x-3 px-5 shadow-[inset_0_-1px_0_var(--color-trait)] max-[760px]:px-3", children: [_jsx("div", { ref: setFin, className: "flex min-w-0 flex-1 items-center gap-2 text-[15px]" }), _jsxs("div", { className: "flex flex-none items-center gap-1", children: [_jsx("div", { ref: setGestes, className: "flex items-center gap-2 empty:hidden" }), chemin && _jsx(EpingleDuCadre, { chemin: chemin, nom: ecran.nom }, chemin), _jsx("div", { ref: setMenu, className: "flex items-center empty:hidden" }), _jsx("span", { "aria-hidden": "true", className: "mx-1.5 h-[18px] w-px bg-trait" }), chemin && (_jsx(LienDansLaPage, { href: chemin, "aria-label": "Agrandir", title: "Agrandir", className: classesDUneIcone, children: _jsx(IconeAgrandir, {}) })), _jsx("button", { type: "button", "aria-label": "Fermer l'aper\u00E7u", title: "Fermer", onClick: fermer, className: classesDUneIcone, children: _jsx(IconeFermer, {}) })] })] }), _jsx("div", { [attributDuCorps]: '', className: "flex min-h-0 flex-1 flex-col overflow-y-auto px-5 pt-3.5 pb-6 max-[760px]:px-3", children: _jsx(ContexteDuCadre.Provider, { value: cadre, children: _jsx(EcranDUneChose, { choses: choses, id: id }, id) }) }), _jsxs("p", { className: "m-0 flex flex-none flex-wrap items-center gap-x-2 border-t border-trait px-5 py-1.5 text-[12px] text-gris max-[760px]:hidden", children: [_jsxs("span", { children: [_jsx(Touche, { children: "\u2191" }), " ", _jsx(Touche, { children: "\u2193" }), " pr\u00E9c\u00E9dent / suivant"] }), _jsx("span", { "aria-hidden": "true", children: "\u00B7" }), _jsxs("span", { children: [_jsx(Touche, { children: "Entr\u00E9e" }), " agrandir"] }), _jsx("span", { "aria-hidden": "true", children: "\u00B7" }), _jsxs("span", { children: [_jsx(Touche, { children: "\u00C9chap" }), " fermer"] })] })] }) }));
|
|
71
|
+
}
|
|
72
|
+
function Touche({ children }) {
|
|
73
|
+
return _jsx("kbd", { className: "rounded-[4px] border border-b-2 border-trait px-1 font-mono text-[11px]", children: children });
|
|
74
|
+
}
|
|
75
|
+
// Ce qui garde ses touches : un champ, un éditeur, une liste de choix, une fenêtre, un menu, un cadre.
|
|
76
|
+
const champsEtFenetres = [
|
|
77
|
+
'input', 'textarea', 'select', '[contenteditable]:not([contenteditable=false])', 'iframe',
|
|
78
|
+
'[role=dialog]', '[role=alertdialog]', '[role=menu]', '[role=listbox]', '[role=combobox]', '[role=textbox]', '[role=grid]', '[role=application]',
|
|
79
|
+
].join(', ');
|
|
80
|
+
// Ce qui fait son geste à Entrée : un lien, un bouton.
|
|
81
|
+
const elementsAEntree = 'a, button, summary, [role=button], [role=link], [role=tab], [role=menuitem]';
|
|
82
|
+
// La touche d'un aperçu ouvert, hors d'un champ, d'un éditeur ou d'une fenêtre : ↑ ↓ passent à la
|
|
83
|
+
// ligne voisine, Entrée agrandit, Échap ferme. Dans le corps de la chose, que l'app rend, ↑ ↓ et
|
|
84
|
+
// Entrée restent au corps ; Entrée sur un lien ou un bouton fait son geste.
|
|
85
|
+
function toucheDeLApercu(evenement) {
|
|
86
|
+
if (evenement.defaultPrevented || evenement.altKey || evenement.ctrlKey || evenement.metaKey || evenement.shiftKey || evenement.isComposing) {
|
|
87
|
+
return undefined;
|
|
88
|
+
}
|
|
89
|
+
const touches = { ArrowUp: 'precedente', ArrowDown: 'suivante', Enter: 'agrandir', Escape: 'fermer' };
|
|
90
|
+
const touche = touches[evenement.key];
|
|
91
|
+
if (!touche) {
|
|
92
|
+
return undefined;
|
|
93
|
+
}
|
|
94
|
+
const cible = evenement.target instanceof Element ? evenement.target : null;
|
|
95
|
+
if (cible?.closest(champsEtFenetres)) {
|
|
96
|
+
return undefined;
|
|
97
|
+
}
|
|
98
|
+
if (touche !== 'fermer' && cible?.closest(`[${attributDuCorps}]`)) {
|
|
99
|
+
return undefined;
|
|
100
|
+
}
|
|
101
|
+
if (touche === 'agrandir' && cible?.closest(elementsAEntree)) {
|
|
102
|
+
return undefined;
|
|
103
|
+
}
|
|
104
|
+
return touche;
|
|
105
|
+
}
|
package/src/espace/cadre.d.ts
CHANGED
|
@@ -24,11 +24,16 @@ export declare function cadreDe(session: Session, ici: string): CadreDeLaPage;
|
|
|
24
24
|
export type EcranDeclare = {
|
|
25
25
|
nom?: string;
|
|
26
26
|
introuvable?: boolean;
|
|
27
|
+
chemin?: string;
|
|
27
28
|
};
|
|
28
29
|
export type Cadre = {
|
|
29
30
|
fin: HTMLElement | null;
|
|
30
31
|
gestes: HTMLElement | null;
|
|
32
|
+
menu: HTMLElement | null;
|
|
31
33
|
declarer: (ecran: EcranDeclare) => void;
|
|
34
|
+
apercu?: {
|
|
35
|
+
quitter: () => void;
|
|
36
|
+
};
|
|
32
37
|
};
|
|
33
38
|
export declare const ContexteDuCadre: import("react").Context<Cadre | null>;
|
|
34
39
|
export declare function useCadre(): Cadre | null;
|
|
@@ -39,8 +44,15 @@ export declare function DansLeFil({ children }: {
|
|
|
39
44
|
export declare function DansLesGestes({ children }: {
|
|
40
45
|
children: ReactNode;
|
|
41
46
|
}): import("react").ReactPortal | null;
|
|
47
|
+
export declare function DansLeMenu({ children }: {
|
|
48
|
+
children: ReactNode;
|
|
49
|
+
}): import("react").ReactPortal | null;
|
|
42
50
|
export declare const separateurDuFil: import("react").JSX.Element;
|
|
43
51
|
export declare const classesDuTitre = "m-0 min-w-0 truncate text-[15px] leading-[1.4] font-semibold text-encre";
|
|
52
|
+
export declare function useTitreDuCadre(): {
|
|
53
|
+
Balise: 'h1' | 'h2';
|
|
54
|
+
tabIndex?: number;
|
|
55
|
+
};
|
|
44
56
|
export declare function TitreDuFil({ children }: {
|
|
45
57
|
children: ReactNode;
|
|
46
58
|
}): import("react").JSX.Element;
|
package/src/espace/cadre.js
CHANGED
|
@@ -10,11 +10,11 @@ export function appDuChemin(session, ici) {
|
|
|
10
10
|
const nom = premier === 'documentation' ? second : premier;
|
|
11
11
|
return session.apps.find((app) => app.nom === nom);
|
|
12
12
|
}
|
|
13
|
-
// Les onglets d'une app, dans leur ordre : ses écrans,
|
|
14
|
-
// les voir, et « Documentation ».
|
|
13
|
+
// Les onglets d'une app, dans leur ordre : ses écrans, le premier sous le titre de l'app, « Réglages »
|
|
14
|
+
// quand la personne a le droit de les voir, et « Documentation ».
|
|
15
15
|
export function ongletsDe(app) {
|
|
16
16
|
return [
|
|
17
|
-
...app.ecrans.map((ecran) => ({ titre: ecran.titre, chemin: ecran.chemin })),
|
|
17
|
+
...app.ecrans.map((ecran, rang) => ({ titre: rang === 0 ? app.titre : ecran.titre, chemin: ecran.chemin })),
|
|
18
18
|
...(app.reglages ? [{ titre: 'Réglages', chemin: `/${app.nom}/reglages` }] : []),
|
|
19
19
|
{ titre: 'Documentation', chemin: `/documentation/${app.nom}` },
|
|
20
20
|
];
|
|
@@ -32,7 +32,8 @@ function lienDeLOnglet(app, onglet) {
|
|
|
32
32
|
}
|
|
33
33
|
// Le cadre d'une page. Sur une page d'une app : le titre de l'app, puis l'onglet actif quand son
|
|
34
34
|
// titre n'est pas celui de l'app, puis, sur un écran qui n'est pas l'onglet lui-même, le titre que
|
|
35
|
-
// l'écran donne. Sur une page du core, le titre de l'écran seul.
|
|
35
|
+
// l'écran donne. Sur une page du core, le titre de l'écran seul. Sur un onglet, la coquille rend le
|
|
36
|
+
// `<h1>` elle-même, à l'onglet actif.
|
|
36
37
|
export function cadreDe(session, ici) {
|
|
37
38
|
const app = appDuChemin(session, ici);
|
|
38
39
|
if (!app) {
|
|
@@ -73,17 +74,17 @@ export function useCadre() {
|
|
|
73
74
|
// L'écran dit ce que la coquille ne sait pas de lui, tant qu'il est rendu.
|
|
74
75
|
export function useDeclarerLEcran(ecran) {
|
|
75
76
|
const cadre = useCadre();
|
|
76
|
-
const { nom, introuvable } = ecran;
|
|
77
|
+
const { nom, introuvable, chemin } = ecran;
|
|
77
78
|
useEffect(() => {
|
|
78
79
|
if (!cadre) {
|
|
79
80
|
return undefined;
|
|
80
81
|
}
|
|
81
|
-
cadre.declarer({ nom, introuvable });
|
|
82
|
+
cadre.declarer({ nom, introuvable, chemin });
|
|
82
83
|
return () => cadre.declarer({});
|
|
83
|
-
}, [cadre?.declarer, nom, introuvable]);
|
|
84
|
+
}, [cadre?.declarer, nom, introuvable, chemin]);
|
|
84
85
|
}
|
|
85
|
-
// Rendre à la fin du fil,
|
|
86
|
-
// donne la coquille.
|
|
86
|
+
// Rendre à la fin du fil, dans les gestes de l'écran, avant l'épingle, et dans le menu, après elle :
|
|
87
|
+
// par un portail, dans l'emplacement que donne la coquille.
|
|
87
88
|
export function DansLeFil({ children }) {
|
|
88
89
|
const cadre = useCadre();
|
|
89
90
|
return cadre?.fin ? createPortal(children, cadre.fin) : null;
|
|
@@ -92,9 +93,19 @@ export function DansLesGestes({ children }) {
|
|
|
92
93
|
const cadre = useCadre();
|
|
93
94
|
return cadre?.gestes ? createPortal(children, cadre.gestes) : null;
|
|
94
95
|
}
|
|
96
|
+
export function DansLeMenu({ children }) {
|
|
97
|
+
const cadre = useCadre();
|
|
98
|
+
return cadre?.menu ? createPortal(children, cadre.menu) : null;
|
|
99
|
+
}
|
|
95
100
|
// Le séparateur du fil, et le dernier segment, le `<h1>` de l'écran.
|
|
96
101
|
export const separateurDuFil = _jsx("span", { "aria-hidden": "true", className: "text-trait-champ max-[760px]:hidden", children: "/" });
|
|
97
102
|
export const classesDuTitre = 'm-0 min-w-0 truncate text-[15px] leading-[1.4] font-semibold text-encre';
|
|
103
|
+
// La balise du titre : le `<h1>` de l'écran ; dans un aperçu, sous le `<h1>` de la liste, un `<h2>`
|
|
104
|
+
// que le panneau focalise à son ouverture.
|
|
105
|
+
export function useTitreDuCadre() {
|
|
106
|
+
return useCadre()?.apercu ? { Balise: 'h2', tabIndex: -1 } : { Balise: 'h1' };
|
|
107
|
+
}
|
|
98
108
|
export function TitreDuFil({ children }) {
|
|
99
|
-
|
|
109
|
+
const { Balise, tabIndex } = useTitreDuCadre();
|
|
110
|
+
return _jsx(Balise, { tabIndex: tabIndex, className: classesDuTitre, children: children });
|
|
100
111
|
}
|
package/src/espace/choses.d.ts
CHANGED
|
@@ -82,9 +82,7 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
|
|
|
82
82
|
titre: string;
|
|
83
83
|
valeur: (chose: C) => ReactNode;
|
|
84
84
|
} | false;
|
|
85
|
-
sousLigne?: (chose: C) => ReactNode;
|
|
86
85
|
plein?: boolean;
|
|
87
|
-
libelleDeLaPleinePage?: string;
|
|
88
86
|
publication?: MotsDeLaPublication;
|
|
89
87
|
consequenceDeLaSuppression?: string | ((chose: C) => string | undefined);
|
|
90
88
|
motsDeLaSuppression?: (chose: C) => MotsDUnGeste;
|
|
@@ -97,7 +95,10 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
|
|
|
97
95
|
chercher?: (critere: CritereDeRecherche) => Promise<ChosesTrouvees<C>>;
|
|
98
96
|
lire: (id: string) => Promise<C | undefined>;
|
|
99
97
|
corps: (chose: C) => ReactNode;
|
|
100
|
-
|
|
98
|
+
etatDeLaChose?: (chose: C) => ReactNode;
|
|
99
|
+
gestes?: (chose: C) => ReactNode;
|
|
100
|
+
rendu?: (chose: C) => RenduDUneChose | undefined;
|
|
101
|
+
aPart?: (chose: C) => string | undefined;
|
|
101
102
|
renommer?: (chose: C, nom: string) => Promise<unknown>;
|
|
102
103
|
supprimer?: (chose: C) => Promise<unknown>;
|
|
103
104
|
peutSupprimer?: (chose: C) => boolean;
|
|
@@ -117,20 +118,31 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
|
|
|
117
118
|
} | undefined | void>;
|
|
118
119
|
formulaire?: FormulaireDUneFicheDeclare<C>;
|
|
119
120
|
gestesDeLaListe?: ReactNode;
|
|
120
|
-
|
|
121
|
+
};
|
|
122
|
+
export type RenduDUneChose = {
|
|
123
|
+
libelle: string;
|
|
124
|
+
adresse: string;
|
|
121
125
|
};
|
|
122
126
|
export type MotsDeLaPublication = {
|
|
123
|
-
|
|
127
|
+
phrase?: string;
|
|
124
128
|
verbe?: string;
|
|
125
129
|
fermer?: string;
|
|
130
|
+
etiquette?: string;
|
|
131
|
+
etiquetteNonPubliee?: string;
|
|
126
132
|
consequence?: string;
|
|
127
133
|
};
|
|
128
|
-
export declare function motsDeLaPublication(publication?: MotsDeLaPublication
|
|
129
|
-
|
|
134
|
+
export declare function motsDeLaPublication(publication?: MotsDeLaPublication, declaration?: {
|
|
135
|
+
une: string;
|
|
136
|
+
feminin?: boolean;
|
|
137
|
+
}): Required<Omit<MotsDeLaPublication, 'etiquetteNonPubliee'>>;
|
|
138
|
+
export declare function vuesDuPartage(feminin?: boolean, { publiees }?: {
|
|
139
|
+
publiees?: boolean;
|
|
140
|
+
}): VueDeLaListe[];
|
|
130
141
|
export type RechercheDeLaListe = {
|
|
131
142
|
texte?: string;
|
|
132
143
|
vue?: string;
|
|
133
144
|
page?: number;
|
|
145
|
+
apercu?: string;
|
|
134
146
|
};
|
|
135
147
|
export declare function rechercheDeLaListe(recherche: Record<string, unknown>): RechercheDeLaListe;
|
|
136
148
|
export declare function critereDeLaListe(vues: VueDeLaListe[] | undefined, recherche: RechercheDeLaListe): CritereDeRecherche;
|
package/src/espace/choses.js
CHANGED
|
@@ -1,33 +1,45 @@
|
|
|
1
1
|
import { useQueryClient } from '@tanstack/react-query';
|
|
2
2
|
import { jourEtHeure } from '../format.js';
|
|
3
3
|
import { appeler, texteDe } from './appels.js';
|
|
4
|
-
// Les mots de la publication d'une app, ses défauts compris
|
|
5
|
-
|
|
4
|
+
// Les mots de la publication d'une app, ses défauts compris, au genre de la chose : « Quiconque a le
|
|
5
|
+
// lien la voit, en lecture, sans compte. », « Publier », « Ne plus publier », « Publiée ». Sans
|
|
6
|
+
// phrase, celle de la conséquence ; sans conséquence, la question reprend la phrase.
|
|
7
|
+
export function motsDeLaPublication(publication = {}, declaration = { une: 'chose', feminin: true }) {
|
|
8
|
+
const { e, pronom } = motsDe(declaration);
|
|
9
|
+
const phrase = publication.phrase ?? publication.consequence ?? `Quiconque a le lien ${pronom} voit, en lecture, sans compte.`;
|
|
6
10
|
return {
|
|
7
|
-
|
|
8
|
-
verbe: publication.verbe ?? '
|
|
9
|
-
fermer: publication.fermer ?? '
|
|
10
|
-
|
|
11
|
+
phrase,
|
|
12
|
+
verbe: publication.verbe ?? 'Publier',
|
|
13
|
+
fermer: publication.fermer ?? 'Ne plus publier',
|
|
14
|
+
etiquette: publication.etiquette ?? `Publié${e}`,
|
|
15
|
+
consequence: publication.consequence ?? phrase,
|
|
11
16
|
};
|
|
12
17
|
}
|
|
13
|
-
// Les vues d'une app qui partage : toutes, à moi, partagées avec moi
|
|
14
|
-
|
|
18
|
+
// Les vues d'une app qui partage : toutes, à moi, partagées avec moi ; avec `publiees`, pour une app
|
|
19
|
+
// à lien public, les publiées, que `chercher` connaît quand son partage déclare sa colonne
|
|
20
|
+
// (`creerLePartage({ publication })`).
|
|
21
|
+
export function vuesDuPartage(feminin = false, { publiees = false } = {}) {
|
|
15
22
|
return [
|
|
16
23
|
{ valeur: 'toutes', titre: feminin ? 'Toutes' : 'Tous' },
|
|
17
24
|
{ valeur: 'a_moi', titre: 'À moi' },
|
|
18
25
|
{ valeur: 'partagees', titre: feminin ? 'Partagées avec moi' : 'Partagés avec moi' },
|
|
26
|
+
...(publiees ? [{ valeur: 'publiees', titre: feminin ? 'Publiées' : 'Publiés' }] : []),
|
|
19
27
|
];
|
|
20
28
|
}
|
|
29
|
+
// La recherche de la liste dans l'adresse : le texte, la vue, la page, et `apercu`, l'identifiant de
|
|
30
|
+
// la chose que montre l'aperçu, gardé en texte même quand il s'écrit comme un nombre.
|
|
21
31
|
export function rechercheDeLaListe(recherche) {
|
|
22
32
|
const page = Number(recherche.page);
|
|
33
|
+
const apercu = typeof recherche.apercu === 'number' ? String(recherche.apercu) : recherche.apercu;
|
|
23
34
|
return {
|
|
24
35
|
...(typeof recherche.texte === 'string' && recherche.texte ? { texte: recherche.texte } : {}),
|
|
25
36
|
...(typeof recherche.vue === 'string' && recherche.vue ? { vue: recherche.vue } : {}),
|
|
26
37
|
...(Number.isInteger(page) && page > 1 ? { page } : {}),
|
|
38
|
+
...(typeof apercu === 'string' && apercu ? { apercu } : {}),
|
|
27
39
|
};
|
|
28
40
|
}
|
|
29
41
|
// Le critère que `chercher` reçoit pour une recherche de la liste : la vue par défaut ne s'y dit
|
|
30
|
-
// pas.
|
|
42
|
+
// pas.
|
|
31
43
|
export function critereDeLaListe(vues, recherche) {
|
|
32
44
|
const premiere = vues?.[0]?.valeur;
|
|
33
45
|
const vue = recherche.vue && vues?.some((une) => une.valeur === recherche.vue) ? recherche.vue : undefined;
|
package/src/espace/coquille.d.ts
CHANGED
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
import { type Session } from './session.ts';
|
|
2
2
|
export declare function CoquilleDeLEspace(): import("react").JSX.Element;
|
|
3
|
+
export declare function EpingleDuCadre({ chemin, nom }: {
|
|
4
|
+
chemin: string;
|
|
5
|
+
nom?: string;
|
|
6
|
+
}): import("react").JSX.Element;
|
|
3
7
|
export declare function PiedDeLaBarre({ session, surLesApps }: {
|
|
4
8
|
session: Session;
|
|
5
9
|
surLesApps: boolean;
|
package/src/espace/coquille.js
CHANGED
|
@@ -8,16 +8,14 @@ import { EtatDeLecture } from '../ui/etats.js';
|
|
|
8
8
|
import { IconeDEpingle, IconeDesApps } from '../ui/icones.js';
|
|
9
9
|
import { Menu, MenuContenu, MenuDeclencheur, MenuEntree, MenuLibelle, MenuSeparateur } from '../ui/menu.js';
|
|
10
10
|
import { estEpingle, useEpingle } from './barre.js';
|
|
11
|
-
import { BarreDeLaListe } from './barre-de-la-liste.js';
|
|
12
11
|
import { cadreDe, ContexteDuCadre, sEpingle, separateurDuFil } from './cadre.js';
|
|
13
12
|
import { cheminDe, entreeActive } from './entree-active.js';
|
|
14
13
|
import { LienDansLaPage } from './lien.js';
|
|
15
|
-
import { ContexteDeLAnnonce, useAnnoncer
|
|
14
|
+
import { ContexteDeLAnnonce, useAnnoncer } from './ouvrir.js';
|
|
16
15
|
import { useSession } from './session.js';
|
|
17
16
|
// La coquille de la page, rendue d'après la session (docs/architecture.md, « L'espace ») : à gauche
|
|
18
|
-
// la barre, à la hauteur de l'écran, repliée en menu sur un
|
|
19
|
-
// l'écran (`cadre.tsx`) et son contenu, sur toute la largeur.
|
|
20
|
-
// une chose ouverte depuis la liste de son app, où la liste prend sa place (`BarreDeLaListe`). Un
|
|
17
|
+
// la barre de l'OS, la même sur tout écran, à la hauteur de l'écran, repliée en menu sur un
|
|
18
|
+
// téléphone ; à droite, le cadre de l'écran (`cadre.tsx`) et son contenu, sur toute la largeur. Un
|
|
21
19
|
// geste fait s'y annonce en bas de l'écran (`useAnnoncer`), d'un écran à l'autre, par-dessus une
|
|
22
20
|
// fenêtre ou un panneau ouvert. Un écran qui se lit montre l'état de lecture commun.
|
|
23
21
|
// La largeur sous laquelle la barre se replie en menu, celle du tableau empilé (`ui/theme.css`).
|
|
@@ -26,17 +24,9 @@ const etroit = 'min-[761px]:hidden';
|
|
|
26
24
|
export function CoquilleDeLEspace() {
|
|
27
25
|
const session = useSession();
|
|
28
26
|
const ici = useLocation({ select: (lieu) => lieu.pathname });
|
|
29
|
-
const depuisLaListe = useOuvertDepuisLaListe();
|
|
30
|
-
const choses = useMatches({ select: (routes) => routes.find((route) => route.staticData?.choses)?.staticData?.choses });
|
|
31
27
|
const [ecran, setEcran] = useState({});
|
|
32
28
|
const bas = _jsx(PiedDeLaBarre, { session: session, surLesApps: ici === '/apps' });
|
|
33
|
-
|
|
34
|
-
// Une chose ouverte depuis sa liste garde la liste ; une chose introuvable, la barre de l'OS.
|
|
35
|
-
const avecLaListe = choses && depuisLaListe && !ecran.introuvable;
|
|
36
|
-
const barre = avecLaListe
|
|
37
|
-
? _jsx(BarreDeLaListe, { choses: choses, bas: bas })
|
|
38
|
-
: _jsx(BarreDeLOS, { session: session, ici: ici, bas: bas });
|
|
39
|
-
return (_jsx(Coquille, { marque: marque, barre: barre, depliee: avecLaListe ? _jsx(BarreDeLaListe, { choses: choses, bas: bas }) : _jsx(BarreDeLOS, { session: session, ici: ici, bas: bas, sansMarque: true }), ecran: ecran, declarer: setEcran }));
|
|
29
|
+
return (_jsx(Coquille, { marque: _jsx(Marque, { session: session, active: ici === '/' }), barre: _jsx(BarreDeLOS, { session: session, ici: ici, bas: bas }), depliee: _jsx(BarreDeLOS, { session: session, ici: ici, bas: bas, sansMarque: true }), ecran: ecran, declarer: setEcran }));
|
|
40
30
|
}
|
|
41
31
|
// La barre de l'OS : la marque, qui mène à l'accueil, les entrées de la barre de la personne, l'active
|
|
42
32
|
// marquée `aria-current="page"` (`entreeActive`), et le pied de la barre.
|
|
@@ -45,26 +35,29 @@ function BarreDeLOS({ session, ici, bas, sansMarque = false }) {
|
|
|
45
35
|
return (_jsxs(_Fragment, { children: [!sansMarque && _jsx(Marque, { session: session, active: ici === '/' }), _jsx("nav", { "aria-label": "Espace", className: "grid flex-1 content-start gap-px", children: session.barre.map((entree) => (_jsx(EntreeDeLaBarre, { chemin: entree.chemin, active: entree.chemin === active, children: entree.titre }, entree.chemin))) }), bas] }));
|
|
46
36
|
}
|
|
47
37
|
// La structure : la barre large, à la hauteur de l'écran ; sur un téléphone, la barre repliée, la
|
|
48
|
-
// marque et « Menu », qui déplie la barre
|
|
49
|
-
// toute la largeur ; un écran déclaré en pleine hauteur (`staticData: { pleineHauteur: true }
|
|
50
|
-
//
|
|
51
|
-
//
|
|
38
|
+
// marque et « Menu », qui déplie la barre de l'OS ; puis le cadre et le contenu. Le contenu prend
|
|
39
|
+
// toute la largeur ; un écran déclaré en pleine hauteur (`staticData: { pleineHauteur: true }`),
|
|
40
|
+
// comme une toile, et l'écran d'une chose, ont pour contenu une colonne qui descend jusqu'au bas de
|
|
41
|
+
// la fenêtre, où un bloc en `flex-1` prend la hauteur qui reste. La zone de l'écran (`main`) porte
|
|
42
|
+
// l'aperçu d'une liste, posé par-dessus elle, ligne du haut comprise (`apercu.tsx`).
|
|
52
43
|
function Coquille({ marque, barre, depliee, ecran, declarer }) {
|
|
53
|
-
const pleineHauteur = useMatches({ select: (routes) => routes.some((route) => route.staticData?.pleineHauteur === true
|
|
44
|
+
const pleineHauteur = useMatches({ select: (routes) => routes.some((route) => route.staticData?.pleineHauteur === true) });
|
|
54
45
|
const ecranDUneChose = useMatches({ select: (routes) => routes.some((route) => route.staticData?.ecranDUneChose === true) });
|
|
55
46
|
const [annonce, setAnnonce] = useState();
|
|
56
47
|
const [fin, setFin] = useState(null);
|
|
57
48
|
const [gestes, setGestes] = useState(null);
|
|
58
|
-
const
|
|
59
|
-
|
|
49
|
+
const [menu, setMenu] = useState(null);
|
|
50
|
+
const cadre = useMemo(() => ({ fin, gestes, menu, declarer }), [fin, gestes, menu, declarer]);
|
|
51
|
+
return (_jsx(ContexteDeLAnnonce.Provider, { value: setAnnonce, children: _jsx(ContexteDuCadre.Provider, { value: cadre, children: _jsxs("div", { className: "grid min-h-dvh grid-cols-[248px_minmax(0,1fr)] max-[760px]:grid-cols-[minmax(0,1fr)]", children: [_jsx("aside", { className: cn('sticky top-0 flex h-dvh flex-col gap-[18px] overflow-y-auto border-r border-trait bg-surface px-3 py-3.5', large), children: barre }), _jsxs("div", { className: "flex min-h-dvh min-w-0 flex-col", children: [_jsx(BarreRepliee, { marque: marque, children: depliee }), _jsxs("main", { className: "relative flex min-w-0 flex-1 flex-col px-6 pt-4 pb-6 max-[760px]:px-3 max-[760px]:pt-3", children: [_jsx(LigneDuHaut, { ecran: ecran, setFin: setFin, setGestes: setGestes, setMenu: setMenu }), _jsx("div", { className: pleineHauteur || ecranDUneChose ? 'flex min-h-0 min-w-0 flex-1 flex-col pt-3.5' : 'min-w-0 pt-3.5', children: _jsx(Suspense, { fallback: _jsx(EtatDeLecture, {}), children: _jsx(Outlet, {}) }) })] })] }), annonce && createPortal(_jsx(Annonce, { message: annonce, onFin: () => setAnnonce(undefined), className: "z-[60]" }), document.body)] }) }) }));
|
|
60
52
|
}
|
|
61
|
-
// La ligne du haut
|
|
62
|
-
//
|
|
63
|
-
// l'
|
|
64
|
-
//
|
|
65
|
-
//
|
|
66
|
-
// les onglets
|
|
67
|
-
|
|
53
|
+
// La ligne du haut. À gauche, sur un onglet d'une app, ses onglets (`OngletsDeLaLigne`) ; sur tout
|
|
54
|
+
// autre écran, le fil d'Ariane : son début (l'app, l'onglet, la liste d'une chose), puis
|
|
55
|
+
// l'emplacement où l'écran rend la fin (son `<h1>`). À droite, l'emplacement des gestes de l'écran
|
|
56
|
+
// (le bloc de l'accès d'une chose), l'épingle, puis celui du menu d'une chose (son ⋯) : sur un onglet,
|
|
57
|
+
// l'épingle est tout à droite. Sur une page d'une app, un trait la ferme, où l'onglet actif pose son
|
|
58
|
+
// soulignement. Sous 760 px, le fil ne montre que son dernier segment et les onglets défilent sur leur
|
|
59
|
+
// ligne. Pendant qu'un écran se lit, le début du fil, les onglets et l'épingle restent.
|
|
60
|
+
function LigneDuHaut({ ecran, setFin, setGestes, setMenu }) {
|
|
68
61
|
const session = useSession();
|
|
69
62
|
const ici = useLocation({ select: (lieu) => lieu.pathname });
|
|
70
63
|
const cadre = cadreDe(session, ici);
|
|
@@ -76,12 +69,29 @@ function LigneDuHaut({ ecran, surUneChose, setFin, setGestes }) {
|
|
|
76
69
|
// montre l'épingle que si son chemin est déjà dans la barre, pour la retirer.
|
|
77
70
|
const nomDeLEpingle = cadre.nomDeLEpingle ?? ecran.nom;
|
|
78
71
|
const epingleMontree = sEpingle(session, ici) && (!ecran.introuvable || estEpingle(session.barre, ici));
|
|
79
|
-
|
|
72
|
+
const fin = _jsx("div", { ref: setFin, className: "contents" });
|
|
73
|
+
return (_jsxs("div", { className: cn('flex min-h-9 items-stretch gap-x-4 max-[760px]:flex-wrap', cadre.app && 'min-h-11 shadow-[inset_0_-1px_0_var(--color-trait)]'), children: [cadre.app && cadre.surLOnglet
|
|
74
|
+
? _jsx(OngletsDeLaLigne, { cadre: cadre, fin: fin })
|
|
75
|
+
: (_jsxs("nav", { "aria-label": "Fil d'Ariane", className: "flex min-h-9 min-w-0 flex-1 items-center gap-2 text-[15px]", children: [debut.map((segment, rang) => (_jsxs("span", { className: "contents", children: [_jsx(LienDansLaPage, { href: segment.chemin, className: "flex-none font-medium whitespace-nowrap text-gris no-underline hover:text-encre max-[760px]:hidden", children: segment.titre }), separateurDuFil] }, rang))), fin] })), _jsxs("div", { className: "flex flex-none items-center gap-1", children: [_jsx("div", { ref: setGestes, className: "flex items-center gap-2 empty:hidden" }), epingleMontree && _jsx(EpingleDuCadre, { chemin: ici, nom: nomDeLEpingle }, ici), _jsx("div", { ref: setMenu, className: "flex items-center empty:hidden" })] })] }));
|
|
80
76
|
}
|
|
81
|
-
//
|
|
82
|
-
//
|
|
83
|
-
//
|
|
84
|
-
|
|
77
|
+
// Les onglets d'une app dans la ligne du haut, `<nav aria-label="Onglets">` : ses écrans, le premier
|
|
78
|
+
// sous le titre de l'app, « Réglages » et « Documentation » (`ongletsDe`) ; l'actif, `aria-current`,
|
|
79
|
+
// souligné à l'accent, est le `<h1>` de l'écran. Une app sans écran, dont aucun onglet ne porte le
|
|
80
|
+
// titre, les fait précéder du fil d'Ariane, son titre en lien, caché sous 760 px. Ils défilent sur
|
|
81
|
+
// leur ligne, sans passer à la ligne. L'écran ne rend là que ce qui suit son titre (`fin`).
|
|
82
|
+
function OngletsDeLaLigne({ cadre, fin }) {
|
|
83
|
+
const avant = cadre.app && cadre.app.ecrans.length === 0 ? cadre.debut : [];
|
|
84
|
+
return (_jsxs(_Fragment, { children: [avant.length > 0 && (_jsx("nav", { "aria-label": "Fil d'Ariane", className: "flex flex-none items-center gap-2 text-[15px] max-[760px]:hidden", children: avant.map((segment, rang) => (_jsxs("span", { className: "contents", children: [_jsx(LienDansLaPage, { href: segment.chemin, className: "font-medium whitespace-nowrap text-gris no-underline hover:text-encre", children: segment.titre }), separateurDuFil] }, rang))) })), _jsxs("nav", { "aria-label": "Onglets", className: "flex min-w-0 flex-1 items-stretch gap-x-6 overflow-x-auto [scrollbar-width:none] [&::-webkit-scrollbar]:hidden", children: [cadre.onglets.map((onglet) => {
|
|
85
|
+
const actif = onglet.chemin === cadre.actif?.chemin;
|
|
86
|
+
const lien = (_jsx(LienDansLaPage, { href: onglet.chemin, "aria-current": actif ? 'page' : undefined, className: "flex flex-none items-center font-medium whitespace-nowrap text-gris no-underline hover:text-encre aria-[current=page]:text-encre aria-[current=page]:shadow-[inset_0_-2px_0_var(--color-accent)]", children: onglet.titre }, onglet.chemin));
|
|
87
|
+
return actif ? _jsx("h1", { className: "m-0 flex flex-none text-[length:inherit] font-[inherit]", children: lien }, onglet.chemin) : lien;
|
|
88
|
+
}), fin] })] }));
|
|
89
|
+
}
|
|
90
|
+
// L'épingle de la ligne du haut, tout à droite sur un onglet, entre le bloc de l'accès et le ⋯ sur
|
|
91
|
+
// une chose, pour le chemin de la page, sans sa recherche : grise, pleine à l'accent quand il est dans
|
|
92
|
+
// la barre de la personne, qui l'y ajoute ou l'en retire (`useEpingle`). Sans nom, elle n'épingle
|
|
93
|
+
// pas : elle ne fait que retirer une épingle, sous le nom qu'elle a dans la barre.
|
|
94
|
+
export function EpingleDuCadre({ chemin, nom }) {
|
|
85
95
|
const session = useSession();
|
|
86
96
|
const annoncer = useAnnoncer();
|
|
87
97
|
const dansLaBarre = session.barre.find((entree) => cheminDe(entree.chemin) === chemin)?.titre;
|
|
@@ -93,7 +103,7 @@ function EpingleDuCadre({ chemin, nom }) {
|
|
|
93
103
|
const libelle = epingle.epinglee ? 'Retirer de la barre' : 'Épingler dans la barre';
|
|
94
104
|
return (_jsx("button", { type: "button", "aria-pressed": epingle.epinglee, "aria-label": libelle, title: libelle, disabled: epingle.enCours || (!epingle.epinglee && !nom), onClick: () => epingle.basculer(nomDit), className: "grid size-7 flex-none cursor-pointer place-items-center rounded-md border-0 bg-transparent text-gris hover:bg-survol hover:text-encre disabled:opacity-50 aria-pressed:text-accent aria-pressed:hover:text-accent", children: _jsx(IconeDEpingle, { pleine: epingle.epinglee }) }));
|
|
95
105
|
}
|
|
96
|
-
// La barre repliée, sur un téléphone : la marque et « Menu », qui déplie la barre
|
|
106
|
+
// La barre repliée, sur un téléphone : la marque et « Menu », qui déplie la barre de l'OS. Elle se
|
|
97
107
|
// replie quand on change d'écran.
|
|
98
108
|
function BarreRepliee({ marque, children }) {
|
|
99
109
|
const [ouverte, setOuverte] = useState(false);
|
package/src/espace/direct.d.ts
CHANGED
|
@@ -1,3 +1,12 @@
|
|
|
1
|
+
import type { EtatDeLaConnexion } from '../forme-du-direct.ts';
|
|
2
|
+
import type { PersonnePresente } from '../presence.ts';
|
|
3
|
+
export type DirectDeclare = {
|
|
4
|
+
etat: EtatDeLaConnexion | 'ferme';
|
|
5
|
+
personnes: PersonnePresente[];
|
|
6
|
+
lecture?: boolean;
|
|
7
|
+
};
|
|
8
|
+
export declare const ContexteDuDirect: import("react").Context<((direct: DirectDeclare | undefined) => void) | null>;
|
|
9
|
+
export declare function useDeclarerLeDirect(direct: DirectDeclare | undefined): void;
|
|
1
10
|
export declare function useAnnoncerLeDroitQuiBaisse(lecture: boolean | undefined, chose: {
|
|
2
11
|
une: string;
|
|
3
12
|
feminin?: boolean;
|
package/src/espace/direct.js
CHANGED
|
@@ -1,11 +1,27 @@
|
|
|
1
1
|
import { useQueryClient } from '@tanstack/react-query';
|
|
2
|
-
import { useCallback, useEffect, useRef } from 'react';
|
|
2
|
+
import { createContext, useCallback, useContext, useEffect, useRef } from 'react';
|
|
3
3
|
import { texteDuDroitQuiBaisse } from '../ui/direct.js';
|
|
4
4
|
import { cleDesChoses } from './choses.js';
|
|
5
5
|
import { useAnnoncer } from './ouvrir.js';
|
|
6
|
-
//
|
|
7
|
-
|
|
8
|
-
//
|
|
6
|
+
// Ce que l'écran d'une chose donne à son corps pour y recevoir le direct.
|
|
7
|
+
export const ContexteDuDirect = createContext(null);
|
|
8
|
+
// Le corps d'une chose déclare son direct, en données : le bloc de l'accès de l'écran les dessine,
|
|
9
|
+
// les présents en pastilles, et un mot hors du nominal (« Reconnexion… », « Lecture »). La personne
|
|
10
|
+
// elle-même peut être parmi `personnes` : le bloc ne la montre pas. `undefined` ne déclare rien, pour
|
|
11
|
+
// un corps dont le direct n'est pas encore ouvert. Hors de l'écran d'une chose, rien.
|
|
12
|
+
export function useDeclarerLeDirect(direct) {
|
|
13
|
+
const declarer = useContext(ContexteDuDirect);
|
|
14
|
+
const cle = direct ? JSON.stringify([direct.etat, direct.lecture === true, direct.personnes.map((personne) => [personne.id, personne.nom, personne.invite === true])]) : '';
|
|
15
|
+
const dernier = useRef(direct);
|
|
16
|
+
dernier.current = direct;
|
|
17
|
+
useEffect(() => {
|
|
18
|
+
if (!declarer) {
|
|
19
|
+
return undefined;
|
|
20
|
+
}
|
|
21
|
+
declarer(dernier.current);
|
|
22
|
+
return () => declarer(undefined);
|
|
23
|
+
}, [declarer, cle]);
|
|
24
|
+
}
|
|
9
25
|
// Annonce le droit qui baisse : quand `lecture`, ce que le direct dit du droit de la personne, passe
|
|
10
26
|
// de faux à vrai, une annonce, « Ce tableau ne vous est plus ouvert qu'en lecture. ». Une chose qui
|
|
11
27
|
// s'ouvre déjà en lecture ne dit rien. `undefined`, un droit pas encore lu (pendant une connexion),
|
|
@@ -1,8 +1,4 @@
|
|
|
1
|
-
import { type ReactNode } from 'react';
|
|
2
1
|
import { type ChoseTrouvee, type DeclarationDesChoses } from './choses.ts';
|
|
3
|
-
export declare function DansLEtatDuDirect({ children }: {
|
|
4
|
-
children: ReactNode;
|
|
5
|
-
}): import("react").ReactPortal | null;
|
|
6
2
|
export declare function EcranDUneChose<C extends ChoseTrouvee>({ choses, id }: {
|
|
7
3
|
choses: DeclarationDesChoses<C>;
|
|
8
4
|
id: string;
|