@indos/bibliotheque 1.13.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/CHANGELOG.md +44 -0
  2. package/package.json +1 -1
  3. package/src/direct/page.d.ts +1 -2
  4. package/src/direct.d.ts +1 -1
  5. package/src/direct.js +60 -8
  6. package/src/espace/apercu.d.ts +9 -0
  7. package/src/espace/apercu.js +105 -0
  8. package/src/espace/cadre.d.ts +13 -0
  9. package/src/espace/cadre.js +21 -10
  10. package/src/espace/chose-seule.d.ts +13 -0
  11. package/src/espace/chose-seule.js +43 -0
  12. package/src/espace/choses.d.ts +33 -9
  13. package/src/espace/choses.js +34 -9
  14. package/src/espace/coquille.d.ts +4 -0
  15. package/src/espace/coquille.js +44 -34
  16. package/src/espace/direct.d.ts +9 -0
  17. package/src/espace/direct.js +20 -4
  18. package/src/espace/ecran-d-une-chose.d.ts +0 -4
  19. package/src/espace/ecran-d-une-chose.js +42 -30
  20. package/src/espace/ecran.d.ts +1 -2
  21. package/src/espace/ecran.js +7 -6
  22. package/src/espace/formulaire-d-une-fiche.js +4 -5
  23. package/src/espace/index.d.ts +7 -7
  24. package/src/espace/index.js +7 -7
  25. package/src/espace/lien.d.ts +4 -4
  26. package/src/espace/lien.js +3 -5
  27. package/src/espace/liste-des-choses.js +86 -24
  28. package/src/espace/menu-d-une-chose.d.ts +3 -1
  29. package/src/espace/menu-d-une-chose.js +16 -12
  30. package/src/espace/ouvrir.d.ts +1 -4
  31. package/src/espace/ouvrir.js +5 -13
  32. package/src/espace/page.d.ts +0 -2
  33. package/src/espace/page.js +0 -3
  34. package/src/espace/panneau-du-partage.d.ts +9 -8
  35. package/src/espace/panneau-du-partage.js +148 -49
  36. package/src/espace/routes-des-choses.js +14 -6
  37. package/src/forme-du-direct.d.ts +1 -0
  38. package/src/page.d.ts +1 -0
  39. package/src/page.js +12 -0
  40. package/src/partage.d.ts +7 -2
  41. package/src/partage.js +26 -7
  42. package/src/ui/direct.d.ts +4 -2
  43. package/src/ui/direct.js +2 -2
  44. package/src/ui/icones.d.ts +6 -0
  45. package/src/ui/icones.js +8 -0
  46. package/src/ui/index.d.ts +1 -1
  47. package/src/ui/index.js +1 -1
  48. package/src/ui/menu-d-une-ligne.js +1 -1
  49. package/src/ui/tableau.d.ts +3 -1
  50. package/src/ui/tableau.js +10 -5
  51. package/src/espace/barre-de-la-liste.d.ts +0 -6
  52. package/src/espace/barre-de-la-liste.js +0 -78
  53. package/src/espace/heure.d.ts +0 -1
  54. package/src/espace/heure.js +0 -6
package/CHANGELOG.md CHANGED
@@ -2,6 +2,50 @@
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.1.0
6
+
7
+ « Ouvrir à part », le droit du lien public, et le direct public en lecture.
8
+
9
+ - `aPart: true` dans la déclaration des choses : `routesDesChoses` rend aussi la chose seule, hors de la coquille, au chemin de son écran suivi de `/seule` (`/<app>/<id>/seule`), avec la session et le thème, et « Ouvrir à part ↗ » y mène dans un autre onglet. Sa tête mince, `TeteDUneChoseSeule` : la marque, qui mène à l'accueil, le nom, qui se renomme d'un clic, le bloc de l'accès, l'épingle de la chose et le ⋯, où « Ouvrir dans l'OS » ramène à son écran ; puis le corps, sur la hauteur qui reste. `aPart: (chose) => adresse` reste la forme d'une adresse que l'app sert elle-même. Une app qui écrit ses routes à la main monte `ChoseSeule` sous `horsDeLaCoquille`.
10
+ - `estUnEcranDesChoses(chemin)`, de `@indos/bibliotheque/page`, dit au serveur de l'app les chemins de sa page, `/liste`, `/<id>` et `/<id>/seule` : il les confie à `servirLaPage`, pour qu'un rechargement de la chose seule serve la page.
11
+ - Le droit du lien public : `publication.droits`, les droits que le lien peut donner (`['lecture', 'modification']`) ; avec deux, « Hors de l'équipe » montre à la propriétaire le choix du droit à côté de l'adresse publique, qui appelle `publier(chose, true, confirmer, droit)`, et un refus qui demande l'accord devient la question du panneau (« Ouvrir « <nom> » en modification à toute personne qui a le lien ? »). Une ligne de `chercher` porte `droit_public`. La phrase suit le droit : par défaut « Quiconque a le lien la voit, en lecture, sans compte. » ou « Quiconque a le lien la voit et la modifie, sans compte. » ; `phrase` et `consequence` s'écrivent aussi selon le droit, `(droit) => texte`. `motsDeLaPublication(publication, declaration, droit)` les rend.
12
+ - Le direct sur l'hôte public : `creerLeDirectYjs({ droitPublic })`, le droit que donne le lien d'une chose publiée, `'lecture'` ou `'modification'`, ou rien pour une chose qui ne l'est pas. En lecture, la connexion ne peut pas écrire, n'écrit pas sa présence et ne reçoit pas celle des autres ; l'équipe ne la voit pas.
13
+ - `droitPublic` prend la place d'`estPubliee` : `droitPublic: async (id) => (publiee ? 'modification' : undefined)` garde le comportement d'une app qui ouvrait sa chose publiée en modification. Une app du client n'a pas d'hôte public, son manifeste n'ayant pas de `sousDomaine` : elle ne déclare ni l'un ni l'autre, et n'a rien à changer.
14
+ - `aPart` prend aussi `true` : `adresseAPart(choses, chose)` rend l'adresse de « Ouvrir à part ↗ » dans les deux formes.
15
+
16
+ Pour monter : `"@indos/bibliotheque": "2.1.0"` dans ses `dependencies`, puis `npm install` et `npm run build`. Les versions de React, Vite et TanStack et le core demandé ne changent pas.
17
+
18
+ ## 2.0.0
19
+
20
+ La tête d'une chose, son partage et sa liste, les mêmes dans toutes les apps.
21
+
22
+ - 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.
23
+ - 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.
24
+ - 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 ⋯.
25
+ - 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.
26
+ - 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.
27
+ - 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.
28
+ - 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 »).
29
+ - 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()`.
30
+
31
+ ### Ruptures
32
+
33
+ - `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.
34
+ - `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).
35
+ - `sousLigne` est retiré : l'aperçu montre la chose.
36
+ - `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é.
37
+ - `DansLesGestes` n'est plus exporté : rien de l'app n'entre dans la ligne du haut.
38
+ - `Ecran.action` est retiré : les gestes d'un onglet vont dans son contenu.
39
+ - `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`.
40
+ - `PastilleDeLAcces` est retirée : `BlocDeLAcces`.
41
+ - Les mots de `publication` sont `phrase`, `verbe`, `fermer`, `etiquette`, `etiquetteNonPubliee` et `consequence` : `titre` est retiré.
42
+ - 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.
43
+ - « 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.
44
+ - 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 ».
45
+ - 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.
46
+ - 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.
47
+ - Pour monter : `"@indos/bibliotheque": "2.0.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
48
+
5
49
  ## 1.13.0
6
50
 
7
51
  - 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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "1.13.0",
3
+ "version": "2.1.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",
@@ -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;
package/src/direct.d.ts CHANGED
@@ -28,7 +28,7 @@ export type ReglagesDuDirectYjs = {
28
28
  personneDuGeste(requete: IncomingMessage): Promise<PersonneConnectee | 'fermee' | undefined>;
29
29
  };
30
30
  droitDe(personne: PersonneConnectee, chose: string): Promise<DroitSurLaChose | undefined>;
31
- estPubliee?(chose: string): Promise<boolean>;
31
+ droitPublic?(chose: string): Promise<DroitDuDirect | undefined>;
32
32
  charger(chose: string): Promise<Uint8Array | undefined>;
33
33
  enregistrer(chose: string, etat: Uint8Array, document: Y.Doc): Promise<void>;
34
34
  limite: number;
package/src/direct.js CHANGED
@@ -21,6 +21,34 @@ export const delaiDeRelecture = 5 * 60_000;
21
21
  const refuser = (raison) => ({ reason: raison });
22
22
  // Le chemin d'un direct, sans celui de l'app : `/direct/<id>`, l'identifiant de la chose un UUID.
23
23
  const cheminDUnDirect = new RegExp(`^/${cheminDuDirect}/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$`, 'i');
24
+ // Un message de présence de Hocuspocus : le nom du document (sa longueur en varUint, puis ses
25
+ // octets), puis le type du message, 1 pour la présence (`MessageType.Awareness`).
26
+ const typeDeLaPresence = 1;
27
+ function lireUnVarUint(octets, depuis) {
28
+ let valeur = 0;
29
+ let decalage = 0;
30
+ let rang = depuis;
31
+ while (rang < octets.length) {
32
+ const octet = octets[rang++];
33
+ valeur += (octet & 0x7f) * 2 ** decalage;
34
+ decalage += 7;
35
+ if (octet < 0x80) {
36
+ return [valeur, rang];
37
+ }
38
+ }
39
+ return [-1, rang];
40
+ }
41
+ function estUnMessageDePresence(message) {
42
+ if (!(message instanceof Uint8Array)) {
43
+ return false;
44
+ }
45
+ const [longueur, apresLaLongueur] = lireUnVarUint(message, 0);
46
+ if (longueur < 0) {
47
+ return false;
48
+ }
49
+ const [type] = lireUnVarUint(message, apresLaLongueur + longueur);
50
+ return type === typeDeLaPresence;
51
+ }
24
52
  // Lit ce qu'un invité envoie à l'ouverture, en JSON ; rien sinon.
25
53
  function lireLeJeton(jeton) {
26
54
  try {
@@ -32,8 +60,8 @@ function lireLeJeton(jeton) {
32
60
  }
33
61
  export function creerLeDirectYjs(reglages) {
34
62
  const { adresse, adressePublique, session, limite } = reglages;
35
- if (adressePublique && !reglages.estPubliee) {
36
- throw new Error('Le direct sur l\'hôte public demande estPubliee.');
63
+ if (adressePublique && !reglages.droitPublic) {
64
+ throw new Error('Le direct sur l\'hôte public demande droitPublic.');
37
65
  }
38
66
  const prefixe = new URL(adresse).pathname.replace(/\/$/, '');
39
67
  const origineDuDomaine = new URL(adresse).origin;
@@ -47,10 +75,13 @@ export function creerLeDirectYjs(reglages) {
47
75
  // Les derniers présents signalés de chaque chose, et leurs signaux, l'un après l'autre.
48
76
  const presentsSignales = new Map();
49
77
  const filesDesPresents = new Map();
78
+ // Les WebSocket qui ne reçoivent pas la présence : la lecture sur l'hôte public.
79
+ const sansPresence = new WeakSet();
50
80
  let enFermeture = false;
51
81
  // Le droit d'une connexion sur la chose qu'elle demande, ou son refus. Sous le domaine : son
52
82
  // origine est celle d'ADRESSE, la personne est connectée au core, et son droit sur la chose. Sur
53
- // l'hôte public : son origine est celle d'ADRESSE_PUBLIQUE, et la chose est publiée.
83
+ // l'hôte public : son origine est celle d'ADRESSE_PUBLIQUE, et le droit que donne le lien de la
84
+ // chose publiée ; en lecture, la connexion n'a pas de personne.
54
85
  async function droitDe(entree, chose, jeton) {
55
86
  if (chose !== entree.chose) {
56
87
  throw refuser(raisons.introuvable);
@@ -59,13 +90,15 @@ export function creerLeDirectYjs(reglages) {
59
90
  if (entree.origine !== origineDeLHotePublic) {
60
91
  throw refuser(raisons.origine);
61
92
  }
62
- const publiee = await reglages.estPubliee(chose).catch(() => {
93
+ const droit = await reglages.droitPublic(chose).catch(() => {
63
94
  throw refuser(raisons.reessayez);
64
95
  });
65
- if (!publiee) {
96
+ if (droit !== 'lecture' && droit !== 'modification') {
66
97
  throw refuser(raisons.plusOuvert);
67
98
  }
68
- return { droit: 'modification', personne: personneDeLInvite(jeton === undefined ? undefined : lireLeJeton(jeton), randomUUID) };
99
+ return droit === 'lecture'
100
+ ? { droit }
101
+ : { droit, personne: personneDeLInvite(jeton === undefined ? undefined : lireLeJeton(jeton), randomUUID) };
69
102
  }
70
103
  if (entree.origine !== origineDuDomaine) {
71
104
  throw refuser(raisons.origine);
@@ -177,6 +210,9 @@ export function creerLeDirectYjs(reglages) {
177
210
  }
178
211
  const { droit, personne } = await droitDe(context.entree, documentName, token);
179
212
  connectionConfig.readOnly = droit === 'lecture' || pleines.has(documentName);
213
+ if (!personne && context.socket) {
214
+ sansPresence.add(context.socket);
215
+ }
180
216
  return { droit, personne };
181
217
  },
182
218
  async connected({ documentName, connection, instance }) {
@@ -213,7 +249,8 @@ export function creerLeDirectYjs(reglages) {
213
249
  },
214
250
  // La présence d'un onglet : le serveur y écrit la personne de sa connexion (`personne`), et le
215
251
  // nom et la couleur que lisent les extensions de Yjs (`user`, comme le curseur de Tiptap) ; une
216
- // page ne touche ni à la présence d'un client d'une autre connexion, ni à son retrait.
252
+ // page ne touche ni à la présence d'un client d'une autre connexion, ni à son retrait. Une
253
+ // connexion sans personne, la lecture sur l'hôte public, n'en écrit aucune.
217
254
  async beforeHandleAwareness({ states, context, connection, document, removedClients }) {
218
255
  if (!connection) {
219
256
  return;
@@ -237,8 +274,23 @@ export function creerLeDirectYjs(reglages) {
237
274
  });
238
275
  // Un WebSocket accepté, confié à Hocuspocus. Un message trop grand le ferme (`maxPayload`, 1009).
239
276
  const serveurDesSockets = new WebSocketServer({ noServer: true, maxPayload: tailleMaximaleDUnMessage });
277
+ // Ce que Hocuspocus envoie passe par là : à une connexion sans présence, aucun message de présence,
278
+ // ni l'état de départ, ni les changements, ni la réponse à sa demande.
279
+ function passerelle(socket) {
280
+ return {
281
+ send(message) {
282
+ if (!(sansPresence.has(socket) && estUnMessageDePresence(message))) {
283
+ socket.send(message);
284
+ }
285
+ },
286
+ close: (code, raison) => socket.close(code, raison),
287
+ get readyState() {
288
+ return socket.readyState;
289
+ },
290
+ };
291
+ }
240
292
  function brancher(socket, entree) {
241
- const client = hocuspocus.handleConnection(socket, new Request(origineDuDomaine), { entree, socket });
293
+ const client = hocuspocus.handleConnection(passerelle(socket), new Request(origineDuDomaine), { entree, socket });
242
294
  vivants.set(socket, true);
243
295
  socket.on('pong', () => vivants.set(socket, true));
244
296
  socket.on('message', (donnees) => {
@@ -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
+ }
@@ -24,11 +24,17 @@ 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
+ };
37
+ seule?: true;
32
38
  };
33
39
  export declare const ContexteDuCadre: import("react").Context<Cadre | null>;
34
40
  export declare function useCadre(): Cadre | null;
@@ -39,8 +45,15 @@ export declare function DansLeFil({ children }: {
39
45
  export declare function DansLesGestes({ children }: {
40
46
  children: ReactNode;
41
47
  }): import("react").ReactPortal | null;
48
+ export declare function DansLeMenu({ children }: {
49
+ children: ReactNode;
50
+ }): import("react").ReactPortal | null;
42
51
  export declare const separateurDuFil: import("react").JSX.Element;
43
52
  export declare const classesDuTitre = "m-0 min-w-0 truncate text-[15px] leading-[1.4] font-semibold text-encre";
53
+ export declare function useTitreDuCadre(): {
54
+ Balise: 'h1' | 'h2';
55
+ tabIndex?: number;
56
+ };
44
57
  export declare function TitreDuFil({ children }: {
45
58
  children: ReactNode;
46
59
  }): import("react").JSX.Element;
@@ -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, « Réglages » quand la personne a le droit de
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, et dans les gestes de l'écran : par un portail, dans l'emplacement que
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
- return _jsx("h1", { className: classesDuTitre, children: children });
109
+ const { Balise, tabIndex } = useTitreDuCadre();
110
+ return _jsx(Balise, { tabIndex: tabIndex, className: classesDuTitre, children: children });
100
111
  }
@@ -0,0 +1,13 @@
1
+ import { type EcranDeclare } from './cadre.tsx';
2
+ import type { ChoseTrouvee, DeclarationDesChoses } from './choses.ts';
3
+ export declare function ChoseSeule<C extends ChoseTrouvee>({ choses, id }: {
4
+ choses: DeclarationDesChoses<C>;
5
+ id: string;
6
+ }): import("react").JSX.Element;
7
+ export declare function TeteDUneChoseSeule({ ecran, chemin, setFin, setGestes, setMenu }: {
8
+ ecran: EcranDeclare;
9
+ chemin: string;
10
+ setFin: (element: HTMLElement | null) => void;
11
+ setGestes: (element: HTMLElement | null) => void;
12
+ setMenu: (element: HTMLElement | null) => void;
13
+ }): import("react").JSX.Element;
@@ -0,0 +1,43 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { useLocation } from '@tanstack/react-router';
3
+ import { useMemo, useState } from 'react';
4
+ import { createPortal } from 'react-dom';
5
+ import { Annonce } from '../ui/annonce.js';
6
+ import { estEpingle } from './barre.js';
7
+ import { ContexteDuCadre } from './cadre.js';
8
+ import { EpingleDuCadre } from './coquille.js';
9
+ import { EcranDUneChose } from './ecran-d-une-chose.js';
10
+ import { LienDansLaPage } from './lien.js';
11
+ import { ContexteDeLAnnonce } from './ouvrir.js';
12
+ import { useSession } from './session.js';
13
+ // Une chose seule, « Ouvrir à part ↗ » (docs/architecture.md, « L'espace ») : l'écran de la chose,
14
+ // le même, avec la session, hors de la coquille (`horsDeLaCoquille`), ni barre de l'OS ni cadre, à
15
+ // `<chemin>/seule`, pour y travailler en grand dans son propre onglet. Sa tête mince
16
+ // (`TeteDUneChoseSeule`) : la marque, qui mène à l'accueil, le nom, renommable, puis le bloc de
17
+ // l'accès, l'épingle de la chose et le ⋯, où « Ouvrir dans l'OS » ramène à son écran ; puis le corps,
18
+ // sur la hauteur qui reste. Un geste fait s'y annonce en bas de l'écran, comme dans la coquille.
19
+ export function ChoseSeule({ choses, id }) {
20
+ const ici = useLocation({ select: (lieu) => lieu.pathname });
21
+ const [annonce, setAnnonce] = useState();
22
+ const [fin, setFin] = useState(null);
23
+ const [gestes, setGestes] = useState(null);
24
+ const [menu, setMenu] = useState(null);
25
+ const [ecran, setEcran] = useState({});
26
+ const cadre = useMemo(() => ({ fin, gestes, menu, declarer: setEcran, seule: true }), [fin, gestes, menu]);
27
+ // Le chemin de la chose dans l'OS, celui de son écran, que l'épingle épingle.
28
+ const chemin = ecran.chemin ?? ici.replace(/\/seule$/, '');
29
+ return (_jsxs(ContexteDeLAnnonce.Provider, { value: setAnnonce, children: [_jsxs("div", { className: "flex h-dvh min-w-0 flex-col bg-papier text-encre", children: [_jsx(TeteDUneChoseSeule, { ecran: ecran, chemin: chemin, setFin: setFin, setGestes: setGestes, setMenu: setMenu }), _jsx("main", { className: "flex min-h-0 min-w-0 flex-1 flex-col overflow-y-auto px-6 pt-3.5 pb-6 max-[760px]:px-3 max-[760px]:pt-3", children: _jsx(ContexteDuCadre.Provider, { value: cadre, children: _jsx(EcranDUneChose, { choses: choses, id: id }, id) }) })] }), annonce && createPortal(_jsx(Annonce, { message: annonce, onFin: () => setAnnonce(undefined), className: "z-[60]" }), document.body)] }));
30
+ }
31
+ // La tête mince d'une chose seule, d'une ligne, qu'un trait ferme : la marque de l'OS, son logo ou
32
+ // son initiale, qui mène à l'accueil ; l'emplacement du nom, le `<h1>`, que l'écran de la chose rend ;
33
+ // puis ceux du bloc de l'accès et du ⋯, de part et d'autre de l'épingle de la chose. Une chose
34
+ // introuvable ne montre l'épingle que si son chemin est dans la barre, pour la retirer.
35
+ export function TeteDUneChoseSeule({ ecran, chemin, setFin, setGestes, setMenu }) {
36
+ const session = useSession();
37
+ const { theme } = session;
38
+ const [initiale = ''] = theme.nom.trim();
39
+ const epingleMontree = !ecran.introuvable || estEpingle(session.barre, chemin);
40
+ return (_jsxs("header", { className: "flex min-h-11 flex-none items-center gap-x-3 border-b border-trait px-4 max-[760px]:px-3", children: [_jsx(LienDansLaPage, { href: "/", "aria-label": `${theme.nom}, accueil`, title: theme.nom, className: "grid size-7 flex-none place-items-center rounded-md no-underline hover:bg-survol", children: theme.logo
41
+ ? (_jsx("span", { className: "grid size-6 place-items-center rounded-[6px] border border-trait bg-papier-du-logo", children: _jsx("img", { alt: "", src: "/theme/logo.svg", className: "block size-4" }) }))
42
+ : (_jsx("span", { "aria-hidden": "true", className: "grid size-6 place-items-center rounded-[6px] border border-trait bg-papier text-[13px] text-encre", children: initiale.toLocaleUpperCase('fr') })) }), _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" }), epingleMontree && _jsx(EpingleDuCadre, { chemin: chemin, nom: ecran.nom }, chemin), _jsx("div", { ref: setMenu, className: "flex items-center empty:hidden" })] })] }));
43
+ }
@@ -1,6 +1,7 @@
1
1
  import type { ComponentType, ReactNode } from 'react';
2
2
  import type { GesteDuMenu } from '../ui/menu-d-une-ligne.tsx';
3
3
  export type DroitSurUneChose = 'proprietaire' | 'modification' | 'lecture';
4
+ export type DroitDuLien = 'lecture' | 'modification';
4
5
  export type ChoseTrouvee = {
5
6
  id: string;
6
7
  nom: string;
@@ -10,6 +11,7 @@ export type ChoseTrouvee = {
10
11
  partagee?: boolean;
11
12
  publiee?: boolean;
12
13
  adresse_publique?: string;
14
+ droit_public?: DroitDuLien;
13
15
  modifie_le?: string;
14
16
  [champ: string]: unknown;
15
17
  };
@@ -82,9 +84,7 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
82
84
  titre: string;
83
85
  valeur: (chose: C) => ReactNode;
84
86
  } | false;
85
- sousLigne?: (chose: C) => ReactNode;
86
87
  plein?: boolean;
87
- libelleDeLaPleinePage?: string;
88
88
  publication?: MotsDeLaPublication;
89
89
  consequenceDeLaSuppression?: string | ((chose: C) => string | undefined);
90
90
  motsDeLaSuppression?: (chose: C) => MotsDUnGeste;
@@ -97,7 +97,10 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
97
97
  chercher?: (critere: CritereDeRecherche) => Promise<ChosesTrouvees<C>>;
98
98
  lire: (id: string) => Promise<C | undefined>;
99
99
  corps: (chose: C) => ReactNode;
100
- pleinePage?: (chose: C) => string | undefined;
100
+ etatDeLaChose?: (chose: C) => ReactNode;
101
+ gestes?: (chose: C) => ReactNode;
102
+ rendu?: (chose: C) => RenduDUneChose | undefined;
103
+ aPart?: true | ((chose: C) => string | undefined);
101
104
  renommer?: (chose: C, nom: string) => Promise<unknown>;
102
105
  supprimer?: (chose: C) => Promise<unknown>;
103
106
  peutSupprimer?: (chose: C) => boolean;
@@ -107,7 +110,7 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
107
110
  confirmer?: true;
108
111
  }) => Promise<unknown>;
109
112
  nePlusPartager?: (chose: C, cibles: CiblesDuPartage) => Promise<unknown>;
110
- publier?: (chose: C, oui: boolean, confirmer: boolean) => Promise<unknown>;
113
+ publier?: (chose: C, oui: boolean, confirmer: boolean, droit?: DroitDuLien) => Promise<unknown>;
111
114
  donner?: (chose: C, don: {
112
115
  a: string;
113
116
  confirmer: true;
@@ -117,20 +120,41 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
117
120
  } | undefined | void>;
118
121
  formulaire?: FormulaireDUneFicheDeclare<C>;
119
122
  gestesDeLaListe?: ReactNode;
120
- geste?: (chose: C) => ReactNode;
121
123
  };
124
+ export type RenduDUneChose = {
125
+ libelle: string;
126
+ adresse: string;
127
+ };
128
+ export type PhraseDuLien = string | ((droit: DroitDuLien) => string);
122
129
  export type MotsDeLaPublication = {
123
- titre?: string;
130
+ phrase?: PhraseDuLien;
124
131
  verbe?: string;
125
132
  fermer?: string;
126
- consequence?: string;
133
+ etiquette?: string;
134
+ etiquetteNonPubliee?: string;
135
+ consequence?: PhraseDuLien;
136
+ droits?: DroitDuLien[];
137
+ };
138
+ export declare function motsDeLaPublication(publication?: MotsDeLaPublication, declaration?: {
139
+ une: string;
140
+ feminin?: boolean;
141
+ }, droit?: DroitDuLien): {
142
+ phrase: string;
143
+ verbe: string;
144
+ fermer: string;
145
+ etiquette: string;
146
+ consequence: string;
127
147
  };
128
- export declare function motsDeLaPublication(publication?: MotsDeLaPublication): Required<MotsDeLaPublication>;
129
- export declare function vuesDuPartage(feminin?: boolean): VueDeLaListe[];
148
+ export declare function droitDuLien<C extends ChoseTrouvee>(choses: DeclarationDesChoses<C>, chose: C): DroitDuLien;
149
+ export declare function adresseAPart<C extends ChoseTrouvee>(choses: DeclarationDesChoses<C>, chose: C): string | undefined;
150
+ export declare function vuesDuPartage(feminin?: boolean, { publiees }?: {
151
+ publiees?: boolean;
152
+ }): VueDeLaListe[];
130
153
  export type RechercheDeLaListe = {
131
154
  texte?: string;
132
155
  vue?: string;
133
156
  page?: number;
157
+ apercu?: string;
134
158
  };
135
159
  export declare function rechercheDeLaListe(recherche: Record<string, unknown>): RechercheDeLaListe;
136
160
  export declare function critereDeLaListe(vues: VueDeLaListe[] | undefined, recherche: RechercheDeLaListe): CritereDeRecherche;