@indos/bibliotheque 2.0.0 → 2.2.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 (44) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +7 -1
  3. package/bin/bibliotheque.d.ts +1 -0
  4. package/bin/bibliotheque.js +62 -0
  5. package/modeles/app-du-client/.dockerignore +3 -0
  6. package/modeles/app-du-client/DOCUMENTATION.md +27 -0
  7. package/modeles/app-du-client/Dockerfile +36 -0
  8. package/modeles/app-du-client/README.md +53 -0
  9. package/modeles/app-du-client/USAGE.md +3 -0
  10. package/modeles/app-du-client/espace/ecrans/entrees.tsx +57 -0
  11. package/modeles/app-du-client/espace/index.html +9 -0
  12. package/modeles/app-du-client/espace/page.tsx +6 -0
  13. package/modeles/app-du-client/espace/requetes/entrees.ts +16 -0
  14. package/modeles/app-du-client/espace/routes.ts +12 -0
  15. package/modeles/app-du-client/espace/tsconfig.json +7 -0
  16. package/modeles/app-du-client/gitignore +2 -0
  17. package/modeles/app-du-client/logo.svg +1 -0
  18. package/modeles/app-du-client/migrations/0001-creer-les-entrees.sql +10 -0
  19. package/modeles/app-du-client/module.json +12 -0
  20. package/modeles/app-du-client/package.json +17 -0
  21. package/modeles/app-du-client/src/demarrer.ts +17 -0
  22. package/modeles/app-du-client/src/outils.ts +48 -0
  23. package/modeles/app-du-client/src/serveur.ts +46 -0
  24. package/modeles/app-du-client/tests/espace/entrees.test.tsx +57 -0
  25. package/modeles/app-du-client/tests/serveur.test.ts +119 -0
  26. package/modeles/app-du-client/tests/sources-de-la-page.test.ts +23 -0
  27. package/modeles/app-du-client/tsconfig.json +22 -0
  28. package/package.json +3 -2
  29. package/src/direct.d.ts +1 -1
  30. package/src/direct.js +60 -8
  31. package/src/espace/cadre.d.ts +1 -0
  32. package/src/espace/chose-seule.d.ts +13 -0
  33. package/src/espace/chose-seule.js +43 -0
  34. package/src/espace/choses.d.ts +17 -5
  35. package/src/espace/choses.js +19 -6
  36. package/src/espace/ecran-d-une-chose.js +5 -3
  37. package/src/espace/index.d.ts +2 -1
  38. package/src/espace/index.js +2 -1
  39. package/src/espace/menu-d-une-chose.d.ts +2 -1
  40. package/src/espace/menu-d-une-chose.js +4 -3
  41. package/src/espace/panneau-du-partage.js +22 -7
  42. package/src/espace/routes-des-choses.js +13 -5
  43. package/src/page.d.ts +1 -0
  44. package/src/page.js +12 -0
@@ -0,0 +1,119 @@
1
+ import assert from 'node:assert/strict';
2
+ import { readFileSync } from 'node:fs';
3
+ import { test, type TestContext } from 'node:test';
4
+ import { appliquerLesMigrations, ouvrirLaBase } from '@indos/bibliotheque/base';
5
+ import { ouvrirUneBaseDEssai } from '@indos/bibliotheque/base-d-essai';
6
+ import { appeler, connecter, lancerLeFauxCore, servirLApp, type ClientDEssai } from '@indos/bibliotheque/faux-core';
7
+ import { creerLeTraitement } from '../src/serveur.ts';
8
+
9
+ // Le manifeste et le texte d'usage, que `demarrerLApp` relit au démarrage.
10
+ const manifeste = JSON.parse(readFileSync(new URL('../module.json', import.meta.url), 'utf8'));
11
+ const instructions = readFileSync(new URL('../USAGE.md', import.meta.url), 'utf8').trim();
12
+ const { nom, titre } = manifeste;
13
+ // La page construite par `npm run build`, que l'app sert.
14
+ const page = readFileSync(new URL('../dist/index.html', import.meta.url), 'utf8');
15
+ const ada = { id: 'p1', email: 'ada@exemple.ch', nom: 'Ada', proprietaire: true };
16
+ const eve = { id: 'p2', email: 'eve@exemple.ch', nom: 'Eve', proprietaire: false };
17
+
18
+ // L'app telle que le kit la déclare au core, avec son écran.
19
+ const apps = [{ nom, titre, lien: `https://exemple.ch/${nom}`, ecrans: [{ nom: 'entrees', titre: 'Entrées' }] }];
20
+
21
+ // Démarre l'app sur une base d'essai migrée et un port libre, servie sous /<nom> comme derrière le
22
+ // proxy, qui retire son chemin comme `demarrerLApp`, et branchée au core donné ; rend son adresse,
23
+ // avec son chemin.
24
+ async function demarrer(t: TestContext, adresseDuCore?: string): Promise<string> {
25
+ const essai = await ouvrirUneBaseDEssai();
26
+ const base = ouvrirLaBase(essai.adresse, 1);
27
+ t.after(async () => {
28
+ await base.end();
29
+ await essai.fermer();
30
+ });
31
+ await appliquerLesMigrations(base, new URL('../migrations/', import.meta.url));
32
+ const servie = await servirLApp(t, nom);
33
+ servie.brancher(creerLeTraitement({ base, adresse: servie.adresse, adresseDuCore, manifeste, instructions }));
34
+ return servie.adresse;
35
+ }
36
+
37
+ // Le JSON que rend un outil, qui doit aboutir.
38
+ async function lire(client: ClientDEssai, outil: string, arguments_: Record<string, unknown> = {}) {
39
+ const resultat = await appeler(client, outil, arguments_);
40
+ assert.equal(resultat.erreur, false, resultat.texte);
41
+ return resultat.json;
42
+ }
43
+
44
+ test('la racine renvoie vers l\'écran ; /sante répond ok ; une autre page est introuvable', async (t) => {
45
+ const adresse = await demarrer(t, await lancerLeFauxCore(t, { 'session=ada': ada }, { nom: 'Essai' }, apps));
46
+ const origine = new URL(adresse).origin;
47
+ for (const racine of [`${adresse}/`, `${origine}/`]) {
48
+ const reponse = await fetch(racine, { redirect: 'manual' });
49
+ assert.equal(reponse.status, 303);
50
+ assert.equal(reponse.headers.get('location'), `${adresse}/entrees`);
51
+ }
52
+ assert.equal(await (await fetch(`${origine}/sante`)).text(), 'ok');
53
+ assert.equal((await fetch(`${adresse}/ailleurs`, { headers: { cookie: 'session=ada' } })).status, 404);
54
+ });
55
+
56
+ test('l\'écran sert la page construite à une personne connectée, avec ou sans le chemin de l\'app', async (t) => {
57
+ const adresse = await demarrer(t, await lancerLeFauxCore(t, { 'session=eve': eve }, { nom: 'Essai' }, apps));
58
+ const origine = new URL(adresse).origin;
59
+ for (const ecran of [`${adresse}/entrees`, `${origine}/entrees`]) {
60
+ const reponse = await fetch(ecran, { headers: { cookie: 'session=eve' } });
61
+ assert.equal(reponse.status, 200);
62
+ // La page construite, avec la session de la personne dans sa tête.
63
+ const servie = await reponse.text();
64
+ assert.match(servie, /<meta name="indos-session" content="[^"]+"><\/head>/);
65
+ assert.equal(servie.replace(/<meta name="indos-session" content="[^"]+">/, ''), page);
66
+ }
67
+ const sansSession = await fetch(`${adresse}/entrees`, { redirect: 'manual' });
68
+ assert.equal(sansSession.status, 303);
69
+ assert.match(sansSession.headers.get('location') ?? '', /\/connexion\?retour=/);
70
+ });
71
+
72
+ test('chacun ajoute et lit ses entrées, les plus récentes d\'abord, 25 par page', async (t) => {
73
+ const adresse = await demarrer(t, await lancerLeFauxCore(t));
74
+ const deAda = await connecter(t, adresse, ada);
75
+ const deEve = await connecter(t, adresse, eve);
76
+ for (let rang = 1; rang <= 26; rang += 1) {
77
+ await lire(deAda, 'ajouter', { texte: `Entrée ${rang}` });
78
+ }
79
+ const ajoutee = await lire(deEve, 'ajouter', { texte: ' La seule d\'Eve ' });
80
+ assert.equal(ajoutee.texte, 'La seule d\'Eve');
81
+
82
+ const premiere = await lire(deAda, 'lister', {});
83
+ assert.equal(premiere.total, 26);
84
+ assert.equal(premiere.lignes.length, 25);
85
+ assert.equal(premiere.lignes[0].texte, 'Entrée 26');
86
+ const seconde = await lire(deAda, 'lister', { page: 2 });
87
+ assert.deepEqual(seconde.lignes.map((entree: { texte: string }) => entree.texte), ['Entrée 1']);
88
+ assert.deepEqual(await lire(deEve, 'lister', {}), { lignes: [ajoutee], total: 1 });
89
+
90
+ const vide = await appeler(deEve, 'ajouter', { texte: '' });
91
+ assert.equal(vide.erreur, true);
92
+ });
93
+
94
+ test('l\'écran appelle les outils avec la session de la personne, de l\'origine de l\'app seulement', async (t) => {
95
+ const adresse = await demarrer(t, await lancerLeFauxCore(t, { 'session=eve': eve }, { nom: 'Essai' }, apps));
96
+ const origine = new URL(adresse).origin;
97
+ function appelerDepuisLEcran(outil: string, corps: Record<string, unknown>, entetes: Record<string, string>) {
98
+ return fetch(`${adresse}/outils/${outil}`, {
99
+ method: 'POST',
100
+ headers: { origin: origine, 'content-type': 'application/json', ...entetes },
101
+ body: JSON.stringify(corps),
102
+ });
103
+ }
104
+ assert.equal((await appelerDepuisLEcran('ajouter', { texte: 'Depuis l\'écran' }, { cookie: 'session=eve' })).status, 200);
105
+ const liste = await appelerDepuisLEcran('lister', {}, { cookie: 'session=eve' });
106
+ assert.equal(liste.status, 200);
107
+ const { content } = await liste.json() as { content: { text: string }[] };
108
+ assert.equal(JSON.parse(content[0].text).lignes[0].texte, 'Depuis l\'écran');
109
+ assert.equal((await appelerDepuisLEcran('lister', {}, {})).status, 401);
110
+ assert.equal((await appelerDepuisLEcran('lister', {}, { cookie: 'session=eve', origin: 'https://ailleurs.exemple' })).status, 403);
111
+ });
112
+
113
+ test('sans jeton du core, le MCP répond 401 ; sans CORE_ADRESSE, 503', async (t) => {
114
+ const avecCore = await demarrer(t, await lancerLeFauxCore(t));
115
+ const corps = { method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}' };
116
+ assert.equal((await fetch(`${avecCore}/mcp`, corps)).status, 401);
117
+ const sansCore = await demarrer(t);
118
+ assert.equal((await fetch(`${sansCore}/mcp`, corps)).status, 503);
119
+ });
@@ -0,0 +1,23 @@
1
+ import assert from 'node:assert/strict';
2
+ import { readdirSync, readFileSync } from 'node:fs';
3
+ import test from 'node:test';
4
+
5
+ // Les sources de la page, `espace/`, n'écrivent jamais de HTML brut : React échappe tout ce qu'il
6
+ // rend, et un texte venu de l'app, d'une personne ou de Claude ne devient jamais du HTML.
7
+ const interdits = /dangerouslySetInnerHTML|innerHTML|outerHTML|insertAdjacentHTML|document\.write/;
8
+
9
+ test('les sources de la page n\'écrivent jamais de HTML brut', () => {
10
+ const espace = new URL('../espace/', import.meta.url);
11
+ const fautes: string[] = [];
12
+ for (const fichier of readdirSync(espace, { recursive: true, encoding: 'utf8' })) {
13
+ if (!/\.(tsx?|css|html)$/.test(fichier)) {
14
+ continue;
15
+ }
16
+ readFileSync(new URL(fichier, espace), 'utf8').split('\n').forEach((ligne, rang) => {
17
+ if (interdits.test(ligne)) {
18
+ fautes.push(`espace/${fichier}:${rang + 1} : ${ligne.trim()}`);
19
+ }
20
+ });
21
+ }
22
+ assert.ok(fautes.length === 0, fautes.join('\n'));
23
+ });
@@ -0,0 +1,22 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "esnext",
4
+ "module": "nodenext",
5
+ "strict": true,
6
+ "noEmit": true,
7
+ "allowImportingTsExtensions": true,
8
+ "erasableSyntaxOnly": true,
9
+ "verbatimModuleSyntax": true,
10
+ "types": [
11
+ "node"
12
+ ],
13
+ "skipLibCheck": true
14
+ },
15
+ "include": [
16
+ "src",
17
+ "tests"
18
+ ],
19
+ "exclude": [
20
+ "tests/espace"
21
+ ]
22
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "2.0.0",
3
+ "version": "2.2.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",
@@ -131,7 +131,8 @@
131
131
  "./ui/theme.css": "./src/ui/theme.css"
132
132
  },
133
133
  "bin": {
134
- "page-de-l-espace": "./bin/page-de-l-espace.js"
134
+ "page-de-l-espace": "./bin/page-de-l-espace.js",
135
+ "bibliotheque": "./bin/bibliotheque.js"
135
136
  },
136
137
  "dependencies": {
137
138
  "@hocuspocus/common": "4.7.1",
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) => {
@@ -34,6 +34,7 @@ export type Cadre = {
34
34
  apercu?: {
35
35
  quitter: () => void;
36
36
  };
37
+ seule?: true;
37
38
  };
38
39
  export declare const ContexteDuCadre: import("react").Context<Cadre | null>;
39
40
  export declare function useCadre(): Cadre | null;
@@ -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
  };
@@ -98,7 +100,7 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
98
100
  etatDeLaChose?: (chose: C) => ReactNode;
99
101
  gestes?: (chose: C) => ReactNode;
100
102
  rendu?: (chose: C) => RenduDUneChose | undefined;
101
- aPart?: (chose: C) => string | undefined;
103
+ aPart?: true | ((chose: C) => string | undefined);
102
104
  renommer?: (chose: C, nom: string) => Promise<unknown>;
103
105
  supprimer?: (chose: C) => Promise<unknown>;
104
106
  peutSupprimer?: (chose: C) => boolean;
@@ -108,7 +110,7 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
108
110
  confirmer?: true;
109
111
  }) => Promise<unknown>;
110
112
  nePlusPartager?: (chose: C, cibles: CiblesDuPartage) => Promise<unknown>;
111
- publier?: (chose: C, oui: boolean, confirmer: boolean) => Promise<unknown>;
113
+ publier?: (chose: C, oui: boolean, confirmer: boolean, droit?: DroitDuLien) => Promise<unknown>;
112
114
  donner?: (chose: C, don: {
113
115
  a: string;
114
116
  confirmer: true;
@@ -123,18 +125,28 @@ export type RenduDUneChose = {
123
125
  libelle: string;
124
126
  adresse: string;
125
127
  };
128
+ export type PhraseDuLien = string | ((droit: DroitDuLien) => string);
126
129
  export type MotsDeLaPublication = {
127
- phrase?: string;
130
+ phrase?: PhraseDuLien;
128
131
  verbe?: string;
129
132
  fermer?: string;
130
133
  etiquette?: string;
131
134
  etiquetteNonPubliee?: string;
132
- consequence?: string;
135
+ consequence?: PhraseDuLien;
136
+ droits?: DroitDuLien[];
133
137
  };
134
138
  export declare function motsDeLaPublication(publication?: MotsDeLaPublication, declaration?: {
135
139
  une: string;
136
140
  feminin?: boolean;
137
- }): Required<Omit<MotsDeLaPublication, 'etiquetteNonPubliee'>>;
141
+ }, droit?: DroitDuLien): {
142
+ phrase: string;
143
+ verbe: string;
144
+ fermer: string;
145
+ etiquette: string;
146
+ consequence: string;
147
+ };
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;
138
150
  export declare function vuesDuPartage(feminin?: boolean, { publiees }?: {
139
151
  publiees?: boolean;
140
152
  }): VueDeLaListe[];
@@ -1,20 +1,33 @@
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, 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 }) {
4
+ // Une phrase, au droit du lien.
5
+ const auDroit = (phrase, droit) => (typeof phrase === 'function' ? phrase(droit) : phrase);
6
+ // Les mots de la publication d'une app, au droit du lien (`droit`, la lecture par défaut), ses défauts
7
+ // compris, au genre de la chose : « Quiconque a le lien la voit, en lecture, sans compte. », ou « … la
8
+ // voit et la modifie, sans compte. », « Publier », « Ne plus publier », « Publiée ». Sans phrase,
9
+ // celle de la conséquence ; sans conséquence, la question reprend la phrase.
10
+ export function motsDeLaPublication(publication = {}, declaration = { une: 'chose', feminin: true }, droit = 'lecture') {
8
11
  const { e, pronom } = motsDe(declaration);
9
- const phrase = publication.phrase ?? publication.consequence ?? `Quiconque a le lien ${pronom} voit, en lecture, sans compte.`;
12
+ const parDefaut = droit === 'modification' ? `Quiconque a le lien ${pronom} voit et ${pronom} modifie, sans compte.` : `Quiconque a le lien ${pronom} voit, en lecture, sans compte.`;
13
+ const phrase = auDroit(publication.phrase, droit) ?? auDroit(publication.consequence, droit) ?? parDefaut;
10
14
  return {
11
15
  phrase,
12
16
  verbe: publication.verbe ?? 'Publier',
13
17
  fermer: publication.fermer ?? 'Ne plus publier',
14
18
  etiquette: publication.etiquette ?? `Publié${e}`,
15
- consequence: publication.consequence ?? phrase,
19
+ consequence: auDroit(publication.consequence, droit) ?? phrase,
16
20
  };
17
21
  }
22
+ // Le droit que donne le lien d'une chose : celui que la ligne porte, sinon le premier que l'app
23
+ // déclare, sinon la lecture.
24
+ export function droitDuLien(choses, chose) {
25
+ return chose.droit_public ?? choses.publication?.droits?.[0] ?? 'lecture';
26
+ }
27
+ // L'adresse de « Ouvrir à part ↗ » : `<chemin>/seule` pour `aPart: true`, sinon celle que l'app sert.
28
+ export function adresseAPart(choses, chose) {
29
+ return choses.aPart === true ? `${chose.chemin}/seule` : choses.aPart?.(chose);
30
+ }
18
31
  // Les vues d'une app qui partage : toutes, à moi, partagées avec moi ; avec `publiees`, pour une app
19
32
  // à lien public, les publiées, que `chercher` connaît quand son partage déclare sa colonne
20
33
  // (`creerLePartage({ publication })`).
@@ -26,7 +26,8 @@ import { useSession } from './session.js';
26
26
  // envoie ne déclenche un geste du cadre ni du panneau du partage, qui n'écoutent que leurs boutons.
27
27
  // Dans l'aperçu (`apercu.tsx`), le même écran se rend dans le cadre du panneau : son nom est un
28
28
  // `<h2>`, l'onglet du navigateur garde le titre de la liste, et une chose supprimée ou donnée ferme
29
- // l'aperçu.
29
+ // l'aperçu. Seule (`chose-seule.tsx`), il se rend dans le cadre de sa tête mince, et son ⋯ ramène
30
+ // dans l'OS.
30
31
  // Une chose absente, ou fermée à la personne : un refus ou une réponse 4xx de `lire`, ou rien.
31
32
  function estAbsente(erreur) {
32
33
  return erreur instanceof ErreurDUnAppel && erreur.statut >= 400 && erreur.statut < 500;
@@ -34,7 +35,8 @@ function estAbsente(erreur) {
34
35
  export function EcranDUneChose({ choses, id }) {
35
36
  const session = useSession();
36
37
  const ouvrir = useOuvrir();
37
- const apercu = useCadre()?.apercu;
38
+ const cadre = useCadre();
39
+ const apercu = cadre?.apercu;
38
40
  const [direct, setDirect] = useState();
39
41
  const lecture = useQuery({
40
42
  queryKey: cleDUneChose(choses, 'chose', id),
@@ -53,7 +55,7 @@ export function EcranDUneChose({ choses, id }) {
53
55
  return _jsx(EtatDeLecture, {});
54
56
  }
55
57
  const ancetres = choses.ancetres?.(chose) ?? [];
56
- return (_jsxs(ContexteDuDirect.Provider, { value: setDirect, children: [!apercu && _jsx("title", { children: `${chose.nom} · ${session.theme.nom}` }), _jsxs(DansLeFil, { children: [_jsx(AncetresDansLeFil, { ancetres: ancetres }), _jsx(NomDUneChose, { choses: choses, chose: chose })] }), _jsx(DansLesGestes, { children: _jsx(BlocDeLAcces, { choses: choses, chose: chose, direct: direct }) }), _jsx(DansLeMenu, { children: _jsx(MenuDUneChose, { choses: choses, chose: chose, surLEcran: true, surSupprimee: apercu?.quitter ?? (() => ouvrir(ancetres.at(-1)?.chemin ?? choses.liste?.chemin ?? adresseDeLaListe(choses.app))) }) }), _jsx(LigneDeTeteDUneChose, { choses: choses, chose: chose }), choses.plein ? _jsx("div", { className: "flex min-h-0 flex-1 flex-col", children: choses.corps(chose) }) : choses.corps(chose)] }));
58
+ return (_jsxs(ContexteDuDirect.Provider, { value: setDirect, children: [!apercu && _jsx("title", { children: `${chose.nom} · ${session.theme.nom}` }), _jsxs(DansLeFil, { children: [!cadre?.seule && _jsx(AncetresDansLeFil, { ancetres: ancetres }), _jsx(NomDUneChose, { choses: choses, chose: chose })] }), _jsx(DansLesGestes, { children: _jsx(BlocDeLAcces, { choses: choses, chose: chose, direct: direct }) }), _jsx(DansLeMenu, { children: _jsx(MenuDUneChose, { choses: choses, chose: chose, surLEcran: true, seule: cadre?.seule === true, surSupprimee: apercu?.quitter ?? (() => ouvrir(ancetres.at(-1)?.chemin ?? choses.liste?.chemin ?? adresseDeLaListe(choses.app))) }) }), _jsx(LigneDeTeteDUneChose, { choses: choses, chose: chose }), choses.plein ? _jsx("div", { className: "flex min-h-0 flex-1 flex-col", children: choses.corps(chose) }) : choses.corps(chose)] }));
57
59
  }
58
60
  // Un nœud qui rend quelque chose.
59
61
  function rendQuelqueChose(noeud) {
@@ -14,9 +14,10 @@ export { desepingler, epingler, lireLAnnuaire, useEpingle, type AnnuaireDeLEcran
14
14
  export { useAnnoncer } from './ouvrir.ts';
15
15
  export { useAnnoncerLeDroitQuiBaisse, useDeclarerLeDirect, useMontrerLaChoseIntrouvable, type DirectDeclare } from './direct.ts';
16
16
  export { rechargerLaPage } from './navigation.ts';
17
- export { chercherParLOutil, cleDesChoses, cleDUneChose, 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 RenduDUneChose, type RechercheDeLaListe, type VueDeLaListe, } from './choses.ts';
17
+ export { adresseAPart, chercherParLOutil, cleDesChoses, cleDUneChose, droitDuLien, motsDeLaPublication, rechercheDeLaListe, useRelireLesChoses, vuesDuPartage, type AncetreDUneChose, type ChoseTrouvee, type ChosesTrouvees, type CiblesDuPartage, type ColonneDUneChose, type CritereDeRecherche, type DeclarationDesChoses, type DroitDuLien, type DroitSurUneChose, type FenetreDuMenu, type FormulaireDUneFicheDeclare, type GesteDuMenu, type MotsDeLaPublication, type MotsDUnGeste, type OuvertureDUneChose, type PhraseDuLien, type RenduDUneChose, type RechercheDeLaListe, type VueDeLaListe, } from './choses.ts';
18
18
  export { ListeDesChoses } from './liste-des-choses.tsx';
19
19
  export { EcranDUneChose } from './ecran-d-une-chose.tsx';
20
+ export { ChoseSeule, TeteDUneChoseSeule } from './chose-seule.tsx';
20
21
  export { texteDUneChoseAbsente } from '../ui/etats.tsx';
21
22
  export { MenuDUneChose, type ProprietesDuMenuDUneChose } from './menu-d-une-chose.tsx';
22
23
  export { FormulaireDUneFiche, ModifierLaFiche, peutModifierLaFiche, type ProprietesDuFormulaireDUneFiche } from './formulaire-d-une-fiche.tsx';
@@ -16,9 +16,10 @@ export { desepingler, epingler, lireLAnnuaire, useEpingle } from './barre.js';
16
16
  export { useAnnoncer } from './ouvrir.js';
17
17
  export { useAnnoncerLeDroitQuiBaisse, useDeclarerLeDirect, useMontrerLaChoseIntrouvable } from './direct.js';
18
18
  export { rechargerLaPage } from './navigation.js';
19
- export { chercherParLOutil, cleDesChoses, cleDUneChose, motsDeLaPublication, rechercheDeLaListe, useRelireLesChoses, vuesDuPartage, } from './choses.js';
19
+ export { adresseAPart, chercherParLOutil, cleDesChoses, cleDUneChose, droitDuLien, motsDeLaPublication, rechercheDeLaListe, useRelireLesChoses, vuesDuPartage, } from './choses.js';
20
20
  export { ListeDesChoses } from './liste-des-choses.js';
21
21
  export { EcranDUneChose } from './ecran-d-une-chose.js';
22
+ export { ChoseSeule, TeteDUneChoseSeule } from './chose-seule.js';
22
23
  export { texteDUneChoseAbsente } from '../ui/etats.js';
23
24
  export { MenuDUneChose } from './menu-d-une-chose.js';
24
25
  export { FormulaireDUneFiche, ModifierLaFiche, peutModifierLaFiche } from './formulaire-d-une-fiche.js';
@@ -5,5 +5,6 @@ export type ProprietesDuMenuDUneChose<C extends ChoseTrouvee> = {
5
5
  surLEcran?: boolean;
6
6
  surSupprimee?: () => void;
7
7
  ouvrirLApercu?: () => void;
8
+ seule?: boolean;
8
9
  };
9
- export declare function MenuDUneChose<C extends ChoseTrouvee>({ choses, chose, surLEcran, surSupprimee, ouvrirLApercu }: ProprietesDuMenuDUneChose<C>): import("react").JSX.Element;
10
+ export declare function MenuDUneChose<C extends ChoseTrouvee>({ choses, chose, surLEcran, surSupprimee, ouvrirLApercu, seule }: ProprietesDuMenuDUneChose<C>): import("react").JSX.Element;
@@ -6,11 +6,11 @@ import { Confirmation } from '../ui/confirmation.js';
6
6
  import { Fenetre } from '../ui/fenetre.js';
7
7
  import { MenuDUneLigne } from '../ui/menu-d-une-ligne.js';
8
8
  import { lireLAnnuaire, useEpingle } from './barre.js';
9
- import { cleDesChoses, cleDUneChose, estRangee, motsDe } from './choses.js';
9
+ import { adresseAPart, cleDesChoses, cleDUneChose, estRangee, motsDe } from './choses.js';
10
10
  import { useAnnoncer, useOuvrir } from './ouvrir.js';
11
11
  import { PanneauDuPartage } from './panneau-du-partage.js';
12
12
  import { useSession } from './session.js';
13
- export function MenuDUneChose({ choses, chose, surLEcran = false, surSupprimee, ouvrirLApercu }) {
13
+ export function MenuDUneChose({ choses, chose, surLEcran = false, surSupprimee, ouvrirLApercu, seule = false }) {
14
14
  const client = useQueryClient();
15
15
  const annoncer = useAnnoncer();
16
16
  const ouvrir = useOuvrir();
@@ -21,7 +21,7 @@ export function MenuDUneChose({ choses, chose, surLEcran = false, surSupprimee,
21
21
  echec: annoncer,
22
22
  });
23
23
  const supprimable = Boolean(choses.supprimer) && (choses.peutSupprimer ? choses.peutSupprimer(chose) : (chose.droit ?? 'proprietaire') === 'proprietaire');
24
- const aPart = choses.aPart?.(chose);
24
+ const aPart = seule ? undefined : adresseAPart(choses, chose);
25
25
  const rendu = choses.rendu?.(chose);
26
26
  const partageable = Boolean(choses.lirePartage && choses.partager) && !estRangee(choses, chose);
27
27
  const donnable = Boolean(choses.donner) && (chose.droit ?? 'proprietaire') === 'proprietaire' && !estRangee(choses, chose);
@@ -49,6 +49,7 @@ export function MenuDUneChose({ choses, chose, surLEcran = false, surSupprimee,
49
49
  const deLaChose = [
50
50
  dansLaListe && { libelle: 'Ouvrir', choisir: ouvrirLApercu ?? (() => ouvrir(chose.chemin)) },
51
51
  dansLaListe && ouvrirLApercu && { libelle: 'Ouvrir en grand', choisir: () => ouvrir(chose.chemin) },
52
+ seule && { libelle: 'Ouvrir dans l\'OS', choisir: () => ouvrir(chose.chemin) },
52
53
  aPart !== undefined && { libelle: 'Ouvrir à part ↗', lien: aPart, nouvelOnglet: true },
53
54
  rendu && { libelle: `${rendu.libelle} ↗`, lien: rendu.adresse, nouvelOnglet: true },
54
55
  dansLaListe && partageable && {