@indos/bibliotheque 2.0.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.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,19 @@
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
+
5
18
  ## 2.0.0
6
19
 
7
20
  La tête d'une chose, son partage et sa liste, les mêmes dans toutes les apps.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "2.0.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",
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 && {
@@ -9,7 +9,7 @@ import { cn } from '../ui/classes.js';
9
9
  import { initiale, nomAuSurvol, pastillesMontrees } from '../ui/direct.js';
10
10
  import { Panneau } from '../ui/panneau.js';
11
11
  import { lireLAnnuaire } from './barre.js';
12
- import { cleDesChoses, cleDUneChose, estRangee, motsDe, motsDeLaPublication } from './choses.js';
12
+ import { cleDesChoses, cleDUneChose, droitDuLien, estRangee, motsDe, motsDeLaPublication } from './choses.js';
13
13
  import { demandeLAccord } from './confirmation-d-un-geste.js';
14
14
  import { useAnnoncer } from './ouvrir.js';
15
15
  import { useSession } from './session.js';
@@ -78,7 +78,9 @@ function ContenuDuPartage({ choses, chose, mots }) {
78
78
  if (variables.geste === 'nePlusPartager') {
79
79
  return choses.nePlusPartager(chose, variables.cibles);
80
80
  }
81
- return choses.publier(chose, variables.oui, variables.confirmer === true);
81
+ return variables.droit
82
+ ? choses.publier(chose, variables.oui, variables.confirmer === true, variables.droit)
83
+ : choses.publier(chose, variables.oui, variables.confirmer === true);
82
84
  },
83
85
  onSuccess: (_rendu, variables) => {
84
86
  annoncer(variables.fait);
@@ -99,15 +101,23 @@ function ContenuDuPartage({ choses, chose, mots }) {
99
101
  const libelleDe = (valeur) => options.find((option) => option.valeur === valeur)?.libelle ?? valeur;
100
102
  const sorteDeLaValeur = (valeur) => (valeur === 'equipe' ? 'equipe' : valeur.startsWith('groupe:') ? 'groupe' : 'personne');
101
103
  const nomDeLaValeur = (valeur) => (valeur === 'equipe' ? '' : valeur.startsWith('groupe:') ? valeur.slice('groupe:'.length) : libelleDe(valeur));
102
- const publication = motsDeLaPublication(choses.publication, choses);
104
+ const droitPublic = droitDuLien(choses, chose);
105
+ const publication = motsDeLaPublication(choses.publication, choses, droitPublic);
106
+ const droitsDuLien = choses.publication?.droits ?? [];
103
107
  const erreur = geste.error;
104
108
  const enCours = geste.variables;
105
109
  const question = demandeLAccord(erreur) && enCours
106
110
  ? enCours.geste === 'partager'
107
111
  ? { titre: `Ouvrir « ${chose.nom} » ${enCours.qui}, en ${enCours.droit} ?`, verbe: `Ouvrir en ${enCours.droit}` }
108
- : enCours.geste === 'publier' && enCours.oui
109
- ? { titre: `Ouvrir « ${chose.nom} » à toute personne qui a le lien ?`, texte: publication.consequence, verbe: publication.verbe }
110
- : undefined
112
+ : enCours.geste === 'publier' && enCours.oui && enCours.droit
113
+ ? {
114
+ titre: `Ouvrir « ${chose.nom} » en ${enCours.droit} à toute personne qui a le lien ?`,
115
+ texte: motsDeLaPublication(choses.publication, choses, enCours.droit).consequence,
116
+ verbe: `Ouvrir en ${enCours.droit}`,
117
+ }
118
+ : enCours.geste === 'publier' && enCours.oui
119
+ ? { titre: `Ouvrir « ${chose.nom} » à toute personne qui a le lien ?`, texte: publication.consequence, verbe: publication.verbe }
120
+ : undefined
111
121
  : undefined;
112
122
  return (_jsxs(_Fragment, { children: [question && enCours
113
123
  ? (_jsxs("div", { role: "group", "aria-label": "Confirmer", className: "mb-5 rounded-lg border border-trait bg-surface px-3.5 py-3", children: [_jsx("p", { className: "m-0 font-semibold text-encre", children: question.titre }), question.texte && _jsx("p", { className: "m-0 mt-0.5 text-gris", children: question.texte }), _jsxs("div", { className: "mt-3 flex flex-wrap gap-2", children: [_jsx(Bouton, { type: "button", sorte: "secondaire", onClick: () => geste.reset(), children: "Annuler" }), _jsx(Bouton, { type: "button", disabled: geste.isPending, onClick: () => geste.mutate({ ...enCours, confirmer: true }), children: question.verbe })] })] }))
@@ -130,7 +140,12 @@ function ContenuDuPartage({ choses, chose, mots }) {
130
140
  }
131
141
  }, children: [_jsx(Choix, { libelle: "Ouvrir \u00E0", indication: "Une personne, un groupe", options: options, valeur: avec, onValeurChange: setAvec }), _jsx(Choix, { libelle: "Droit", options: droits, valeur: droit, onValeurChange: (valeur) => setDroit(valeur) }), _jsx(Bouton, { type: "submit", disabled: !avec || geste.isPending, children: "Ouvrir" })] }))
132
142
  : !proprietaire && (_jsxs("p", { className: "mt-3 mb-0 text-gris", children: ["Seul", mots.e, " ", chose.auteur ?? 'la personne', ", qui ", mots.pronom, " poss\u00E8de, peut changer son partage."] })), choses.publier && (_jsxs("section", { "aria-labelledby": `hors-de-l-equipe-${chose.id}`, children: [_jsx(TitreDeSection, { id: `hors-de-l-equipe-${chose.id}`, className: "mt-7 mb-2", children: "Hors de l'\u00E9quipe" }), _jsx("p", { className: "m-0 mb-3 text-gris", children: publication.phrase }), chose.publiee
133
- ? (_jsxs("div", { className: "grid justify-items-start gap-2.5", children: [typeof chose.adresse_publique === 'string' && _jsx(AdressePublique, { adresse: chose.adresse_publique }), proprietaire && (_jsx("button", { type: "button", disabled: geste.isPending, onClick: () => geste.mutate({ geste: 'publier', oui: false, fait: `Le lien de « ${chose.nom} » ne mène plus à rien.` }), className: "cursor-pointer border-0 bg-transparent p-0 font-[inherit] text-[13px] text-gris hover:text-encre disabled:opacity-50", children: publication.fermer }))] }))
143
+ ? (_jsxs("div", { className: "grid justify-items-start gap-2.5", children: [_jsxs("div", { className: "flex w-full min-w-0 items-center gap-2", children: [typeof chose.adresse_publique === 'string' && _jsx(AdressePublique, { adresse: chose.adresse_publique }), proprietaire && droitsDuLien.length > 1 && (_jsx(Choix, { libelle: "Droit du lien", libelleMasque: true, taille: "petite", options: droitsDuLien.map((valeur) => ({ valeur, libelle: libelleDuDroit(valeur) })), valeur: droitPublic, disabled: geste.isPending, onValeurChange: (valeur) => {
144
+ const nouveau = valeur;
145
+ if (nouveau !== droitPublic) {
146
+ geste.mutate({ geste: 'publier', oui: true, droit: nouveau, fait: `Le lien de « ${chose.nom} » donne la ${nouveau}.` });
147
+ }
148
+ } }))] }), proprietaire && (_jsx("button", { type: "button", disabled: geste.isPending, onClick: () => geste.mutate({ geste: 'publier', oui: false, fait: `Le lien de « ${chose.nom} » ne mène plus à rien.` }), className: "cursor-pointer border-0 bg-transparent p-0 font-[inherit] text-[13px] text-gris hover:text-encre disabled:opacity-50", children: publication.fermer }))] }))
134
149
  : proprietaire
135
150
  ? (_jsx(Bouton, { type: "button", disabled: geste.isPending, onClick: () => geste.mutate({ geste: 'publier', oui: true, fait: `Le lien de « ${chose.nom} » est ouvert.` }), children: publication.verbe }))
136
151
  : _jsx("p", { className: "m-0 text-gris", children: "Aucun lien public." })] }))] }));
@@ -1,21 +1,29 @@
1
1
  import { jsx as _jsx } from "react/jsx-runtime";
2
2
  import { createRoute, useParams } from '@tanstack/react-router';
3
3
  import { rechercheDeLaListe } from './choses.js';
4
+ import { ChoseSeule } from './chose-seule.js';
4
5
  import { EcranDUneChose } from './ecran-d-une-chose.js';
5
6
  import { ListeDesChoses } from './liste-des-choses.js';
6
- import { coquilleDeLEspace } from './page.js';
7
- // Les deux écrans d'une app à choses, dans la coquille : sa liste, `/<app>/liste`, la recherche dans
7
+ import { coquilleDeLEspace, horsDeLaCoquille } from './page.js';
8
+ // Les écrans d'une app à choses. Dans la coquille : sa liste, `/<app>/liste`, la recherche dans
8
9
  // l'adresse ; et l'écran d'une chose, `/<app>/$id` par défaut, qui pose
9
10
  // `staticData: { ecranDUneChose: true, choses }`, où la coquille lit la liste que nomme la
10
- // déclaration pour le fil (`liste`). `chose` donne un autre chemin à l'écran d'une chose, son identifiant toujours `$id`,
11
- // comme `/liens/liste/$id`.
11
+ // déclaration pour le fil (`liste`). `chose` donne un autre chemin à l'écran d'une chose, son
12
+ // identifiant toujours `$id`, comme `/liens/liste/$id`. Avec `aPart: true`, hors de la coquille, la
13
+ // chose seule, au chemin de son écran suivi de `/seule` (`ChoseSeule`).
12
14
  export function routesDesChoses(choses, options = {}) {
15
+ const cheminDUneChose = options.chose ?? `/${choses.app}/$id`;
13
16
  function Chose() {
14
17
  const { id = '' } = useParams({ strict: false });
15
18
  return _jsx(EcranDUneChose, { choses: choses, id: id }, id);
16
19
  }
20
+ function Seule() {
21
+ const { id = '' } = useParams({ strict: false });
22
+ return _jsx(ChoseSeule, { choses: choses, id: id }, id);
23
+ }
17
24
  return [
18
25
  createRoute({ getParentRoute: () => coquilleDeLEspace, path: `/${choses.app}/liste`, validateSearch: rechercheDeLaListe, component: () => _jsx(ListeDesChoses, { choses: choses }) }),
19
- createRoute({ getParentRoute: () => coquilleDeLEspace, path: options.chose ?? `/${choses.app}/$id`, staticData: { ecranDUneChose: true, choses: choses }, component: Chose }),
26
+ createRoute({ getParentRoute: () => coquilleDeLEspace, path: cheminDUneChose, staticData: { ecranDUneChose: true, choses: choses }, component: Chose }),
27
+ ...(choses.aPart === true ? [createRoute({ getParentRoute: () => horsDeLaCoquille, path: `${cheminDUneChose}/seule`, component: Seule })] : []),
20
28
  ];
21
29
  }
package/src/page.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import type { IncomingMessage, ServerResponse } from 'node:http';
2
2
  export { lignesParPage } from './pagination.ts';
3
+ export declare function estUnEcranDesChoses(chemin: string): boolean;
3
4
  export type SessionDeLaPage = {
4
5
  personneDe: (requete: IncomingMessage) => Promise<unknown>;
5
6
  envoyerALaConnexion: (requete: IncomingMessage, reponse: ServerResponse) => void;
package/src/page.js CHANGED
@@ -3,6 +3,7 @@ import { extname, join } from 'node:path';
3
3
  import { fileURLToPath } from 'node:url';
4
4
  import { traiterUnAppelDEcran } from './appel-d-ecran.js';
5
5
  import { echapper, entetesDeLEspace, envoyerLaPage, pageSimple } from './ecran.js';
6
+ import { identifiant } from './identifiant.js';
6
7
  import { Refus } from './mcp.js';
7
8
  import { creerLaSession } from './session.js';
8
9
  // La page de l'espace d'une pièce, le core ou une app (docs/architecture.md, « L'espace et les
@@ -12,6 +13,17 @@ import { creerLaSession } from './session.js';
12
13
  // Le nombre de lignes d'une page d'une liste : un geste ou un outil paginé reçoit `page`, un entier
13
14
  // à partir de 1, et rend `{ lignes, total }`.
14
15
  export { lignesParPage } from './pagination.js';
16
+ // Un écran d'une app à choses, que la page sert : sa liste, `/liste`, l'écran d'une chose, `/<id>`,
17
+ // et la chose seule, `/<id>/seule`, l'identifiant un UUID ; `chemin` est celui de la requête dans
18
+ // l'app, sans son préfixe. Le serveur de l'app y répond par `servirLaPage`, pour qu'un rechargement
19
+ // de chacun serve la page.
20
+ export function estUnEcranDesChoses(chemin) {
21
+ if (chemin === '/liste') {
22
+ return true;
23
+ }
24
+ const [, id] = /^\/([^/]+)(?:\/seule)?$/.exec(chemin) ?? [];
25
+ return identifiant(id) !== undefined;
26
+ }
15
27
  // Les types des fichiers construits, par leur extension.
16
28
  const types = {
17
29
  '.js': 'text/javascript; charset=utf-8',