@indos/bibliotheque 1.12.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/CHANGELOG.md +50 -0
  2. package/package.json +33 -2
  3. package/src/app.js +7 -12
  4. package/src/direct/page.d.ts +33 -0
  5. package/src/direct/page.js +145 -0
  6. package/src/direct.d.ts +63 -0
  7. package/src/direct.js +411 -0
  8. package/src/espace/apercu.d.ts +9 -0
  9. package/src/espace/apercu.js +105 -0
  10. package/src/espace/cadre.d.ts +12 -0
  11. package/src/espace/cadre.js +21 -10
  12. package/src/espace/choses.d.ts +28 -7
  13. package/src/espace/choses.js +26 -9
  14. package/src/espace/coquille.d.ts +4 -0
  15. package/src/espace/coquille.js +47 -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 -32
  20. package/src/espace/ecran.d.ts +1 -2
  21. package/src/espace/ecran.js +7 -6
  22. package/src/espace/essai.d.ts +37 -0
  23. package/src/espace/essai.js +117 -0
  24. package/src/espace/formulaire-d-une-fiche.js +4 -5
  25. package/src/espace/index.d.ts +6 -7
  26. package/src/espace/index.js +6 -7
  27. package/src/espace/lien.d.ts +4 -4
  28. package/src/espace/lien.js +3 -5
  29. package/src/espace/liste-des-choses.js +86 -24
  30. package/src/espace/menu-d-une-chose.d.ts +2 -1
  31. package/src/espace/menu-d-une-chose.js +17 -14
  32. package/src/espace/ouvrir.d.ts +1 -4
  33. package/src/espace/ouvrir.js +5 -13
  34. package/src/espace/page.d.ts +0 -2
  35. package/src/espace/page.js +0 -3
  36. package/src/espace/panneau-du-partage.d.ts +9 -8
  37. package/src/espace/panneau-du-partage.js +132 -48
  38. package/src/espace/routes-des-choses.js +2 -2
  39. package/src/faux-core.d.ts +23 -0
  40. package/src/faux-core.js +81 -0
  41. package/src/fichiers-d-une-chose.d.ts +37 -0
  42. package/src/fichiers-d-une-chose.js +136 -0
  43. package/src/forme-du-direct.d.ts +29 -0
  44. package/src/forme-du-direct.js +70 -0
  45. package/src/partage.d.ts +7 -2
  46. package/src/partage.js +26 -7
  47. package/src/presence.d.ts +6 -0
  48. package/src/presence.js +6 -3
  49. package/src/remplacements.d.ts +26 -0
  50. package/src/remplacements.js +41 -0
  51. package/src/sans-le-chemin.d.ts +1 -0
  52. package/src/sans-le-chemin.js +9 -0
  53. package/src/signaux.d.ts +5 -0
  54. package/src/signaux.js +20 -0
  55. package/src/ui/direct.d.ts +7 -6
  56. package/src/ui/direct.js +26 -4
  57. package/src/ui/icones.d.ts +6 -0
  58. package/src/ui/icones.js +8 -0
  59. package/src/ui/index.d.ts +2 -2
  60. package/src/ui/index.js +2 -2
  61. package/src/ui/menu-d-une-ligne.js +1 -1
  62. package/src/ui/tableau.d.ts +3 -1
  63. package/src/ui/tableau.js +10 -5
  64. package/src/vite.js +4 -2
  65. package/src/espace/barre-de-la-liste.d.ts +0 -6
  66. package/src/espace/barre-de-la-liste.js +0 -78
  67. package/src/espace/heure.d.ts +0 -1
  68. package/src/espace/heure.js +0 -6
@@ -0,0 +1,136 @@
1
+ export const deuxMo = 2 * 1024 * 1024;
2
+ // Un chemin : des segments de lettres, chiffres, `.`, `_` et `-`, séparés par `/`, dont aucun ne
3
+ // commence par un point ou un tiret ; un dossier : un chemin suivi de `/`.
4
+ const segments = '[A-Za-z0-9_][A-Za-z0-9._-]*(/[A-Za-z0-9_][A-Za-z0-9._-]*)*';
5
+ const unChemin = new RegExp(`^${segments}$`);
6
+ const unDossier = new RegExp(`^${segments}/$`);
7
+ export function estUnChemin(chemin) {
8
+ return chemin.length <= 300 && unChemin.test(chemin);
9
+ }
10
+ export function estUnDossier(chemin) {
11
+ return chemin.length <= 300 && unDossier.test(chemin);
12
+ }
13
+ export const formeDUnChemin = 'Un chemin de fichier : des segments de lettres, chiffres, `.`, `_` et `-`, séparés par `/`, dont aucun ne commence par un point ou un tiret, 300 caractères au plus ; un dossier finit par `/`.';
14
+ // Le type d'un fichier d'après l'extension de son chemin : celui que le navigateur attend.
15
+ const types = {
16
+ html: 'text/html', css: 'text/css', js: 'text/javascript', mjs: 'text/javascript', json: 'application/json',
17
+ md: 'text/markdown', txt: 'text/plain', csv: 'text/csv', xml: 'application/xml', svg: 'image/svg+xml',
18
+ png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif', webp: 'image/webp', avif: 'image/avif', ico: 'image/x-icon',
19
+ woff: 'font/woff', woff2: 'font/woff2', ttf: 'font/ttf', otf: 'font/otf',
20
+ pdf: 'application/pdf', mp3: 'audio/mpeg', mp4: 'video/mp4', webm: 'video/webm', wasm: 'application/wasm',
21
+ };
22
+ export function typeDuChemin(chemin) {
23
+ const point = chemin.lastIndexOf('.');
24
+ return point > chemin.lastIndexOf('/') ? types[chemin.slice(point + 1).toLowerCase()] : undefined;
25
+ }
26
+ // Un type MIME tel que la base l'accepte : en minuscules, sans paramètre.
27
+ const unType = /^[a-z]+\/[a-z0-9.+-]+$/;
28
+ export function typeSain(type) {
29
+ const nu = type.split(';')[0]?.trim().toLowerCase() ?? '';
30
+ return unType.test(nu) ? nu : undefined;
31
+ }
32
+ // Un fichier se lit en texte quand son type le dit et que ses octets sont de l'UTF-8.
33
+ export function estUnTexte(type) {
34
+ return /^text\/|^application\/(json|javascript|xml)$|\+(json|xml)$/.test(type);
35
+ }
36
+ export function texteDe(octets) {
37
+ try {
38
+ return new TextDecoder('utf-8', { fatal: true }).decode(octets);
39
+ }
40
+ catch {
41
+ return undefined;
42
+ }
43
+ }
44
+ // Les gestes sur les fichiers des choses de l'app. Une lecture prend la base ou la connexion d'une
45
+ // transaction ; une écriture, la connexion de la transaction de la chose (`enTransaction`), qui
46
+ // tient son verrou et sa date de modification.
47
+ export function creerLesFichiersDUneChose({ chose: nomDeLaChose, laChose }) {
48
+ if (!/^[a-z_][a-z0-9_]*$/.test(nomDeLaChose)) {
49
+ throw new Error(`« ${nomDeLaChose} » n'est pas un nom de colonne.`);
50
+ }
51
+ const chose = nomDeLaChose;
52
+ const LaChose = `${laChose.charAt(0).toUpperCase()}${laChose.slice(1)}`;
53
+ // Le texte d'un fichier lu, ou une erreur qui dit pourquoi il ne se lit pas.
54
+ function texteDuFichier(chemin, fichier) {
55
+ if (!fichier) {
56
+ throw new Error(`${LaChose} n'a pas de fichier « ${chemin} » : \`lire\` sans \`chemins\` donne ses fichiers.`);
57
+ }
58
+ if (!estUnTexte(fichier.type)) {
59
+ throw new Error(`« ${chemin} » n'est pas un fichier texte (${fichier.type}).`);
60
+ }
61
+ const texte = texteDe(fichier.contenu);
62
+ if (texte === undefined) {
63
+ throw new Error(`« ${chemin} » (${fichier.type}) n'est pas écrit en UTF-8 : il ne se lit pas en texte.`);
64
+ }
65
+ return { chemin, type: fichier.type, taille: fichier.taille, texte };
66
+ }
67
+ // Les fichiers de ces chemins, avec leurs octets.
68
+ async function lireLesFichiers(base, id, chemins) {
69
+ if (chemins.length === 0) {
70
+ return new Map();
71
+ }
72
+ const { rows } = await base.query(`select chemin, type, taille, contenu from fichier where ${chose} = $1 and chemin = any($2)`, [id, chemins]);
73
+ return new Map(rows.map((fichier) => [fichier.chemin, fichier]));
74
+ }
75
+ return {
76
+ // Les fichiers d'une chose, sans leur contenu, du premier au dernier chemin.
77
+ async lesFichiers(base, id) {
78
+ const { rows } = await base.query(`select chemin, type, taille from fichier where ${chose} = $1 order by chemin`, [id]);
79
+ return rows;
80
+ },
81
+ lireLesFichiers,
82
+ // Le fichier texte de ce chemin, avec son texte, ou une erreur qui dit pourquoi il ne se lit pas.
83
+ async lireUnTexte(base, id, chemin) {
84
+ return texteDuFichier(chemin, (await lireLesFichiers(base, id, [chemin])).get(chemin));
85
+ },
86
+ // Les fichiers texte de ces chemins, dans l'ordre demandé : chacun avec son texte, ou ce qui
87
+ // l'empêche de se lire.
88
+ async lireDesTextes(base, id, chemins) {
89
+ const uniques = [...new Set(chemins)];
90
+ const lus = await lireLesFichiers(base, id, uniques);
91
+ return uniques.map((chemin) => {
92
+ try {
93
+ return texteDuFichier(chemin, lus.get(chemin));
94
+ }
95
+ catch (erreur) {
96
+ return { chemin, erreur: erreur.message };
97
+ }
98
+ });
99
+ },
100
+ // Pose un fichier sous son chemin : le crée, ou remplace celui du même chemin.
101
+ async poser(client, id, chemin, type, contenu) {
102
+ if (contenu.length > deuxMo) {
103
+ throw new Error(`« ${chemin} » fait ${contenu.length} octets : un fichier en fait 2 Mo au plus.`);
104
+ }
105
+ const { rows } = await client.query(`insert into fichier (${chose}, chemin, type, contenu) values ($1, $2, $3, $4)
106
+ on conflict (${chose}, chemin) do update set type = excluded.type, contenu = excluded.contenu, modifie_le = now()
107
+ returning chemin, type, taille`, [id, chemin, type, contenu]);
108
+ return rows[0];
109
+ },
110
+ // Copie, en une requête, le fichier `depuis` de la chose source sous `vers` dans la chose cible,
111
+ // ou, quand les deux finissent par `/`, tous ses fichiers sous ce dossier dans le dossier cible.
112
+ // Un fichier du même chemin dans la cible est remplacé ; chaque fichier garde son type.
113
+ async copier(client, source, depuis, cible, vers) {
114
+ const dossier = depuis.endsWith('/');
115
+ const { rows } = await client.query(`insert into fichier (${chose}, chemin, type, contenu)
116
+ select $3, case when $5 then $4 || substr(chemin, length($2) + 1) else $4 end, type, contenu
117
+ from fichier
118
+ where ${chose} = $1 and case when $5 then starts_with(chemin, $2) else chemin = $2 end
119
+ order by chemin
120
+ on conflict (${chose}, chemin) do update set type = excluded.type, contenu = excluded.contenu, modifie_le = now()
121
+ returning chemin, type, taille`, [source, depuis, cible, vers, dossier]);
122
+ if (rows.length === 0) {
123
+ throw new Error(`${LaChose} source n'a aucun fichier « ${depuis} ».`);
124
+ }
125
+ return rows;
126
+ },
127
+ // Retire le fichier de ce chemin, ou tous ceux d'un dossier, et rend les chemins retirés.
128
+ async retirer(client, id, chemin) {
129
+ const { rows } = await client.query(`delete from fichier where ${chose} = $1 and case when $3 then starts_with(chemin, $2) else chemin = $2 end returning chemin`, [id, chemin, chemin.endsWith('/')]);
130
+ if (rows.length === 0) {
131
+ throw new Error(`${LaChose} n'a aucun fichier « ${chemin} ».`);
132
+ }
133
+ return rows.map((ligne) => ligne.chemin).sort();
134
+ },
135
+ };
136
+ }
@@ -0,0 +1,29 @@
1
+ import { type PersonnePresente } from './presence.ts';
2
+ export declare const cheminDuDirect = "direct";
3
+ export type EtatDeLaConnexion = 'connexion' | 'en-direct' | 'reconnexion';
4
+ export declare const raisons: {
5
+ readonly introuvable: 'introuvable';
6
+ readonly plusOuvert: 'plus ouvert par ce lien';
7
+ readonly connexion: 'connexion requise';
8
+ readonly reessayez: 'réessayez';
9
+ readonly origine: 'origine refusée';
10
+ };
11
+ export declare const codes: {
12
+ readonly droitChange: 4205;
13
+ readonly plusDeDroit: 4403;
14
+ readonly redemarrage: 1012;
15
+ };
16
+ export declare function estUneChoseAbsente(raison: string): boolean;
17
+ export type Invite = {
18
+ id: string;
19
+ prenom: string;
20
+ };
21
+ export declare function personneDeLInvite(donne: unknown, tirer: () => string): PersonnePresente;
22
+ export type OngletPresent = {
23
+ client: number;
24
+ personne: PersonnePresente;
25
+ etat: Record<string, unknown>;
26
+ };
27
+ export declare function personneDeLEtat(etat: unknown): PersonnePresente | undefined;
28
+ export declare function ongletsDesAutres(etats: Map<number, unknown>, client: number): OngletPresent[];
29
+ export declare function personnesDesAutres(etats: Map<number, unknown>, client: number): PersonnePresente[];
@@ -0,0 +1,70 @@
1
+ import { longueurDUnNom } from './presence.js';
2
+ // La forme commune du direct Yjs, la même au serveur (`@indos/bibliotheque/direct`) et à la page
3
+ // (`@indos/bibliotheque/direct/page`), sans rien de Node ni du navigateur (bibliotheque/CLAUDE.md,
4
+ // « Le direct Yjs ») : son chemin, les raisons de ses refus, ses codes de fermeture et la présence
5
+ // que le serveur écrit.
6
+ // Le chemin du direct d'une chose, sous l'app : `direct/<id>`.
7
+ export const cheminDuDirect = 'direct';
8
+ // Pourquoi le serveur refuse une connexion : la page reçoit la raison à l'ouverture
9
+ // (`onAuthenticationFailed`), ou avec la fermeture 4403. « réessayez » (le core ou la base ne
10
+ // répondent pas) se réessaie seul ; les autres ferment le direct.
11
+ export const raisons = {
12
+ introuvable: 'introuvable',
13
+ plusOuvert: 'plus ouvert par ce lien',
14
+ connexion: 'connexion requise',
15
+ reessayez: 'réessayez',
16
+ origine: 'origine refusée',
17
+ };
18
+ // Les codes de fermeture du serveur : le droit a changé, la page se rouvre au nouveau ; plus de
19
+ // droit, la page ferme le direct, avec la raison ; l'app redémarre, la page se rouvre.
20
+ export const codes = { droitChange: 4205, plusDeDroit: 4403, redemarrage: 1012 };
21
+ // La raison d'un refus qui dit une chose absente, ou qui n'est plus ouverte à la personne : l'écran
22
+ // commun d'une chose introuvable la remplace.
23
+ export function estUneChoseAbsente(raison) {
24
+ return raison === raisons.introuvable || raison === raisons.plusOuvert;
25
+ }
26
+ const formeDUnUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
27
+ // La présence d'un invité, tirée de ce que sa page envoie : son identifiant, un UUID, sinon un
28
+ // identifiant tiré par le serveur ; son prénom, sans les espaces autour, borné à 24 caractères,
29
+ // « Invité » quand il est vide.
30
+ export function personneDeLInvite(donne, tirer) {
31
+ const invite = donne && typeof donne === 'object' ? donne : {};
32
+ const id = typeof invite.id === 'string' && formeDUnUuid.test(invite.id) ? invite.id.toLowerCase() : tirer();
33
+ const prenom = typeof invite.prenom === 'string' ? Array.from(invite.prenom.trim()).slice(0, longueurDUnNom).join('').trim() : '';
34
+ return { id, nom: prenom || 'Invité', invite: true };
35
+ }
36
+ // La personne qu'un état de présence porte, écrite par le serveur, ou rien.
37
+ export function personneDeLEtat(etat) {
38
+ const personne = etat && typeof etat === 'object' ? etat.personne : undefined;
39
+ if (!personne || typeof personne !== 'object') {
40
+ return undefined;
41
+ }
42
+ const { id, nom, invite } = personne;
43
+ if (typeof id !== 'string' || typeof nom !== 'string') {
44
+ return undefined;
45
+ }
46
+ return { id, nom, ...(invite === true ? { invite: true } : {}) };
47
+ }
48
+ // Les onglets des autres, d'après les états de présence (`awareness.getStates()`), sans celui de la
49
+ // page (`client`, son `clientID`) : ceux qui portent une personne, dans l'ordre des états.
50
+ export function ongletsDesAutres(etats, client) {
51
+ const onglets = [];
52
+ for (const [autre, etat] of etats) {
53
+ const personne = autre === client ? undefined : personneDeLEtat(etat);
54
+ if (personne) {
55
+ onglets.push({ client: autre, personne, etat: etat });
56
+ }
57
+ }
58
+ return onglets;
59
+ }
60
+ // Les autres personnes présentes, une fois chacune quel que soit le nombre de ses onglets : les
61
+ // `autres` d'`EtatEtPresences`.
62
+ export function personnesDesAutres(etats, client) {
63
+ const personnes = new Map();
64
+ for (const { personne } of ongletsDesAutres(etats, client)) {
65
+ if (!personnes.has(personne.id)) {
66
+ personnes.set(personne.id, personne);
67
+ }
68
+ }
69
+ return [...personnes.values()];
70
+ }
package/src/partage.d.ts CHANGED
@@ -40,8 +40,11 @@ export declare function schemaDeNePlusPartager(argument: string, schemaDeLaChose
40
40
  export declare function schemaDeDonner(argument: string, schemaDeLaChose: SchemaDUnArgument): Outil['schema'];
41
41
  export declare function schemaDeDonnerLesChoses(): Outil['schema'];
42
42
  export declare const vuesDeChercher: readonly ['toutes', 'a_moi', 'partagees'];
43
- export type VueDeChercher = (typeof vuesDeChercher)[number];
44
- export declare function schemaDeChercher(enPlus?: NonNullable<Outil['schema']['properties']>): Outil['schema'];
43
+ export declare const vueDesPubliees = "publiees";
44
+ export type VueDeChercher = (typeof vuesDeChercher)[number] | typeof vueDesPubliees;
45
+ export declare function schemaDeChercher(enPlus?: NonNullable<Outil['schema']['properties']>, { publiees }?: {
46
+ publiees?: boolean;
47
+ }): Outil['schema'];
45
48
  export type ChoseLue = Record<string, unknown> & {
46
49
  droit: DroitSurLaChose;
47
50
  };
@@ -71,6 +74,7 @@ export type OptionsDuPartage = {
71
74
  droit: Droit;
72
75
  };
73
76
  auProprietaireDuServeur?: Droit;
77
+ publication?: string;
74
78
  };
75
79
  export declare function creerLePartage(options: OptionsDuPartage): {
76
80
  pourLaPersonne: (personne: Personne, { alias, depuis }?: {
@@ -90,6 +94,7 @@ export declare function creerLePartage(options: OptionsDuPartage): {
90
94
  lireLAnnuaire: ({ sansCache }?: {
91
95
  sansCache?: boolean;
92
96
  }) => Promise<Annuaire>;
97
+ schemaDeChercher(enPlus?: NonNullable<Outil['schema']['properties']>): Outil['schema'];
93
98
  droitSur(personne: Personne, id: string): Promise<DroitSurLaChose | undefined>;
94
99
  lire<C = ChoseLue>(personne: Personne, id: unknown, { droit, ...reste }?: {
95
100
  droit?: DroitSurLaChose;
package/src/partage.js CHANGED
@@ -127,16 +127,24 @@ export function schemaDeDonnerLesChoses() {
127
127
  };
128
128
  }
129
129
  // Les vues de `chercher` d'une app qui partage : toutes les choses que la personne voit, les
130
- // siennes, celles qu'un autre lui a ouvertes.
130
+ // siennes, celles qu'un autre lui a ouvertes ; et, pour une app à lien public, les publiées
131
+ // (`publiees`).
131
132
  export const vuesDeChercher = ['toutes', 'a_moi', 'partagees'];
133
+ export const vueDesPubliees = 'publiees';
132
134
  // Le schéma des arguments de `chercher` d'une app qui partage : `texte`, `vue`, `page`, et les
133
- // arguments propres de l'app (`enPlus`), comme les seules chartes des pages.
134
- export function schemaDeChercher(enPlus = {}) {
135
+ // arguments propres de l'app (`enPlus`), comme les seules chartes des pages. Avec `publiees`, la
136
+ // vue des publiées : le partage d'une app à lien public le rend tel (`creerLePartage({ publication
137
+ // }).schemaDeChercher`).
138
+ export function schemaDeChercher(enPlus = {}, { publiees = false } = {}) {
135
139
  return {
136
140
  type: 'object',
137
141
  properties: {
138
142
  texte: { type: 'string', description: 'Un texte à chercher, sans tenir compte des accents ni de la casse ; sans lui, toutes.' },
139
- vue: { type: 'string', enum: [...vuesDeChercher], description: 'Les siennes (`a_moi`), celles qu\'un autre lui a ouvertes (`partagees`), ou toutes (`toutes`, par défaut).' },
143
+ vue: {
144
+ type: 'string',
145
+ enum: [...vuesDeChercher, ...(publiees ? [vueDesPubliees] : [])],
146
+ description: `Les siennes (\`a_moi\`), celles qu'un autre lui a ouvertes (\`partagees\`)${publiees ? ', celles qui ont un lien public (`publiees`)' : ''}, ou toutes (\`toutes\`, par défaut).`,
147
+ },
140
148
  page: { type: 'integer', minimum: 1, description: 'La page de la liste, à partir de 1 ; 1 sans elle.' },
141
149
  ...enPlus,
142
150
  },
@@ -149,6 +157,8 @@ export function creerLePartage(options) {
149
157
  const partage = identifiantSql(options.partage ?? 'partage');
150
158
  const nom = identifiantSql(options.nom ?? 'nom');
151
159
  const racine = options.racine === undefined ? undefined : identifiantSql(options.racine);
160
+ const publication = options.publication === undefined ? undefined : identifiantSql(options.publication);
161
+ const vues = publication ? [...vuesDeChercher, vueDesPubliees] : [...vuesDeChercher];
152
162
  const { base, laChose, absente, aLaCreation, auProprietaireDuServeur } = options;
153
163
  const colonnes = options.colonnes ?? `${table}.*`;
154
164
  const cherche = options.cherche ?? [`${table}.${nom}`];
@@ -245,6 +255,11 @@ export function creerLePartage(options) {
245
255
  pourLaPersonne,
246
256
  trouver,
247
257
  lireLAnnuaire,
258
+ // Le schéma des arguments de `chercher` de l'app, la vue `publiees` comprise quand elle déclare
259
+ // `publication`.
260
+ schemaDeChercher(enPlus = {}) {
261
+ return schemaDeChercher(enPlus, { publiees: publication !== undefined });
262
+ },
248
263
  // Le droit de la personne sur une chose, ou rien : une chose absente, ou qui ne lui est pas ouverte.
249
264
  async droitSur(personne, id) {
250
265
  return (await trouver(personne, id, { colonnes: `${table}.id` }))?.droit;
@@ -261,7 +276,8 @@ export function creerLePartage(options) {
261
276
  },
262
277
  // `chercher` d'une app qui partage : les choses que la personne voit dont le texte se trouve
263
278
  // dans `cherche`, sans tenir compte des accents ni de la casse, dans la vue demandée (`toutes`
264
- // par défaut, `a_moi`, `partagees`), chacune avec son droit : la page demandée (1 par
279
+ // par défaut, `a_moi`, `partagees`, et `publiees` avec `publication`), chacune avec son droit :
280
+ // la page demandée (1 par
265
281
  // défaut), `lignesParPage` choses au plus, dans l'ordre de l'app ; et le total de celles qui
266
282
  // répondent. Les arguments sont ceux de l'outil, tels que Claude ou l'écran les donne ;
267
283
  // `condition` ajoute une condition de l'app, ses valeurs passées par `valeur`, qui rend leur
@@ -271,14 +287,17 @@ export function creerLePartage(options) {
271
287
  const parametres = [...valeurs];
272
288
  const valeur = (une) => `$${parametres.push(une)}`;
273
289
  const texte = typeof arguments_.texte === 'string' ? arguments_.texte.trim() : '';
274
- const vue = vuesDeChercher.find((une) => une === arguments_.vue) ?? 'toutes';
290
+ const vue = vues.find((une) => une === arguments_.vue) ?? 'toutes';
275
291
  const page = typeof arguments_.page === 'number' && Number.isInteger(arguments_.page) && arguments_.page > 1 ? arguments_.page : 1;
276
292
  const conditions = [ouverte];
277
293
  if (texte) {
278
294
  const motif = valeur(motifSansAccents(texte));
279
295
  conditions.push(`(${cherche.map((expression) => `${sansAccentsEnSql(expression)} like ${motif}`).join(' or ')})`);
280
296
  }
281
- if (vue !== 'toutes') {
297
+ if (vue === vueDesPubliees && publication) {
298
+ conditions.push(`${table}.${publication}`);
299
+ }
300
+ else if (vue !== 'toutes') {
282
301
  conditions.push(`${aliasDuDroit}.${proprietaire} ${vue === 'a_moi' ? '=' : 'is distinct from'} $1`);
283
302
  }
284
303
  const enPlus = condition?.(valeur);
package/src/presence.d.ts CHANGED
@@ -1,2 +1,8 @@
1
+ export type PersonnePresente = {
2
+ id: string;
3
+ nom: string;
4
+ invite?: boolean;
5
+ };
6
+ export declare const longueurDUnNom = 24;
1
7
  export declare const couleursDesPersonnes: readonly ['#2b6dc9', '#c6327c', '#1f7d4e', '#996216', '#9a49c2', '#177a83', '#4a7a29', '#6262cb'];
2
8
  export declare function couleurDe(id: string): string;
package/src/presence.js CHANGED
@@ -1,6 +1,9 @@
1
- // @indos/bibliotheque/presence : la couleur d'une personne dans le direct, sans rien de Node ni du
2
- // navigateur (bibliotheque/CLAUDE.md, « Le direct à l'écran »). La page et le serveur la calculent
3
- // de la même façon : une personne a la même couleur dans toutes les apps, sur chaque appareil.
1
+ // @indos/bibliotheque/presence : une personne présente dans le direct et sa couleur, sans rien de
2
+ // Node ni du navigateur (bibliotheque/CLAUDE.md, « Le direct à l'écran »). La page et le serveur la
3
+ // calculent de la même façon : une personne a la même couleur dans toutes les apps, sur chaque
4
+ // appareil.
5
+ // La longueur d'un nom dans le direct : le nom d'une session, ou le prénom d'un invité, borné.
6
+ export const longueurDUnNom = 24;
4
7
  // Huit couleurs à la même luminance, ni rouge ni orange, pour ne se confondre ni avec l'accent ni
5
8
  // avec l'erreur. Chacune se lit sur le papier clair (#faf8f3) et sur la surface du charbon (#1e1e1e)
6
9
  // à 3:1 au moins, et porte un texte blanc à 4,5:1 au moins (tests/presence.test.ts). Elles sont les
@@ -0,0 +1,26 @@
1
+ export type Remplacement = {
2
+ avant: string;
3
+ apres: string;
4
+ };
5
+ export declare const schemaDesRemplacements: {
6
+ type: string;
7
+ minItems: number;
8
+ maxItems: number;
9
+ description: string;
10
+ items: {
11
+ type: string;
12
+ properties: {
13
+ avant: {
14
+ type: string;
15
+ minLength: number;
16
+ };
17
+ apres: {
18
+ type: string;
19
+ };
20
+ };
21
+ required: string[];
22
+ additionalProperties: boolean;
23
+ };
24
+ };
25
+ export declare function appliquerLesRemplacements(contenu: string, remplacements: Remplacement[]): string;
26
+ export declare function extraitLePlusProche(contenu: string, avant: string): string | undefined;
@@ -0,0 +1,41 @@
1
+ export const schemaDesRemplacements = {
2
+ type: 'array',
3
+ minItems: 1,
4
+ maxItems: 100,
5
+ description: 'Les remplacements, appliqués dans l\'ordre : `avant`, un passage du contenu assez long pour y être unique ; `apres`, ce qui le remplace.',
6
+ items: {
7
+ type: 'object',
8
+ properties: { avant: { type: 'string', minLength: 1 }, apres: { type: 'string' } },
9
+ required: ['avant', 'apres'],
10
+ additionalProperties: false,
11
+ },
12
+ };
13
+ export function appliquerLesRemplacements(contenu, remplacements) {
14
+ for (const [rang, { avant, apres }] of remplacements.entries()) {
15
+ const position = contenu.indexOf(avant);
16
+ if (position < 0) {
17
+ const extrait = extraitLePlusProche(contenu, avant);
18
+ throw new Error(`Le remplacement ${rang + 1} : son « avant » ne se trouve pas dans le contenu ; rien n'est écrit.${extrait ? ` Le passage le plus proche : ${extrait}` : ''}`);
19
+ }
20
+ if (contenu.indexOf(avant, position + 1) >= 0) {
21
+ throw new Error(`Le remplacement ${rang + 1} : son « avant » se trouve plusieurs fois dans le contenu ; rien n'est écrit. L'allonger pour qu'il soit unique.`);
22
+ }
23
+ contenu = contenu.slice(0, position) + apres + contenu.slice(position + avant.length);
24
+ }
25
+ return contenu;
26
+ }
27
+ // Le passage du contenu le plus proche d'un « avant » introuvable : le plus long début, ou la plus
28
+ // longue fin, de l'« avant » qui s'y trouve, avec ce qui l'entoure.
29
+ const autour = 120;
30
+ export function extraitLePlusProche(contenu, avant) {
31
+ for (let longueur = avant.length - 1; longueur >= Math.min(8, avant.length); longueur--) {
32
+ for (const position of [contenu.indexOf(avant.slice(0, longueur)), contenu.indexOf(avant.slice(avant.length - longueur))]) {
33
+ if (position >= 0) {
34
+ const debut = Math.max(0, position - autour);
35
+ const fin = Math.min(contenu.length, position + longueur + autour);
36
+ return `${debut > 0 ? '…' : ''}${contenu.slice(debut, fin)}${fin < contenu.length ? '…' : ''}`;
37
+ }
38
+ }
39
+ }
40
+ return undefined;
41
+ }
@@ -0,0 +1 @@
1
+ export declare function sansLeChemin(url: string, prefixe: string): string;
@@ -0,0 +1,9 @@
1
+ // L'adresse d'une requête sans le chemin de l'app (`/<nom>`), sa recherche gardée ; telle quelle
2
+ // sans lui. `demarrerLApp` la donne au traitement de l'app, et l'app à l'essai du faux core de même.
3
+ export function sansLeChemin(url, prefixe) {
4
+ const { pathname, search } = new URL(url, 'http://app');
5
+ if (pathname !== prefixe && !pathname.startsWith(`${prefixe}/`)) {
6
+ return url;
7
+ }
8
+ return `${pathname.slice(prefixe.length) || '/'}${search}`;
9
+ }
@@ -0,0 +1,5 @@
1
+ export type Signaux<Quoi extends string> = {
2
+ signaler(id: string, quoi: Quoi): void;
3
+ ecouter(id: string, rappel: (quoi: Quoi) => void): () => void;
4
+ };
5
+ export declare function creerLesSignaux<Quoi extends string>(): Signaux<Quoi>;
package/src/signaux.js ADDED
@@ -0,0 +1,20 @@
1
+ export function creerLesSignaux() {
2
+ const ecouteurs = new Map();
3
+ return {
4
+ signaler(id, quoi) {
5
+ for (const rappel of ecouteurs.get(id) ?? []) {
6
+ rappel(quoi);
7
+ }
8
+ },
9
+ ecouter(id, rappel) {
10
+ const deLaChose = ecouteurs.get(id) ?? new Set();
11
+ ecouteurs.set(id, deLaChose.add(rappel));
12
+ return () => {
13
+ deLaChose.delete(rappel);
14
+ if (deLaChose.size === 0) {
15
+ ecouteurs.delete(id);
16
+ }
17
+ };
18
+ },
19
+ };
20
+ }
@@ -1,10 +1,7 @@
1
1
  import type { HTMLAttributes } from 'react';
2
- export type EtatDeLaConnexion = 'connexion' | 'en-direct' | 'reconnexion';
3
- export type PersonnePresente = {
4
- id: string;
5
- nom: string;
6
- invite?: boolean;
7
- };
2
+ import { type EtatDeLaConnexion } from '../forme-du-direct.ts';
3
+ import { type PersonnePresente } from '../presence.ts';
4
+ export type { EtatDeLaConnexion, PersonnePresente };
8
5
  export type ProprietesDeLEtatEtDesPresences = {
9
6
  etat: EtatDeLaConnexion;
10
7
  lectureSeule?: boolean;
@@ -15,6 +12,8 @@ export type ProprietesDeLEtatEtDesPresences = {
15
12
  export declare function texteDeLEtat(etat: EtatDeLaConnexion, lectureSeule?: boolean): string;
16
13
  export declare const pastillesMontrees = 5;
17
14
  export declare function personnesPresentes(moi: PersonnePresente, autres: PersonnePresente[]): PersonnePresente[];
15
+ export declare function nomAuSurvol(personne: PersonnePresente, estMoi: boolean): string;
16
+ export declare function initiale(nom: string): string;
18
17
  export declare function EtatEtPresences({ etat, lectureSeule, moi, autres, className }: ProprietesDeLEtatEtDesPresences): import("react").JSX.Element;
19
18
  export declare const classesDeLEtiquetteDuNom = "pointer-events-none inline-block max-w-[16em] truncate rounded-[4px] px-1.5 align-top font-sans text-[11px] leading-[18px] font-semibold whitespace-nowrap select-none";
20
19
  export type ProprietesDeLEtiquetteDuNom = {
@@ -24,3 +23,5 @@ export type ProprietesDeLEtiquetteDuNom = {
24
23
  export declare function EtiquetteDuNom({ id, nom, className, style, ...reste }: ProprietesDeLEtiquetteDuNom): import("react").JSX.Element;
25
24
  export declare function elementDeLEtiquetteDuNom(id: string, nom: string): HTMLSpanElement;
26
25
  export declare function texteDuDroitQuiBaisse(une: string, feminin?: boolean): string;
26
+ export declare function texteDeCeQuiNEstPasEnregistre(une: string, feminin?: boolean): string;
27
+ export declare function texteDUnRefusDuDirect(raison: string, une: string, feminin?: boolean): string;
package/src/ui/direct.js CHANGED
@@ -1,4 +1,5 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { raisons } from '../forme-du-direct.js';
2
3
  import { couleurDe } from '../presence.js';
3
4
  import { cn } from './classes.js';
4
5
  const motsDeLEtat = { connexion: 'Connexion…', 'en-direct': 'En direct', reconnexion: 'Reconnexion…' };
@@ -23,11 +24,11 @@ export function personnesPresentes(moi, autres) {
23
24
  return toutes;
24
25
  }
25
26
  // Le nom d'une personne au survol : « Léa (vous) », « Max (invité) », « Zoé ».
26
- function nomAuSurvol(personne, estMoi) {
27
+ export function nomAuSurvol(personne, estMoi) {
27
28
  return estMoi ? `${personne.nom} (vous)` : personne.invite ? `${personne.nom} (invité)` : personne.nom;
28
29
  }
29
30
  // L'initiale d'un nom, une lettre entière même hors du plan de base d'Unicode.
30
- function initiale(nom) {
31
+ export function initiale(nom) {
31
32
  return (Array.from(nom.trim())[0] ?? '?').toLocaleUpperCase('fr');
32
33
  }
33
34
  // L'état et les présences : le point, à l'accent en direct et en gris sinon, et l'état en mots, en
@@ -61,9 +62,30 @@ export function elementDeLEtiquetteDuNom(id, nom) {
61
62
  element.textContent = nom;
62
63
  return element;
63
64
  }
65
+ // « Ce », « Cet » ou « Cette » devant le nom d'une chose.
66
+ function ceDevant(une, feminin) {
67
+ return feminin ? 'Cette' : /^[aeiouyàâéèêëîïôûü]/i.test(une) ? 'Cet' : 'Ce';
68
+ }
64
69
  // Ce que dit le droit qui baisse pendant que la chose est ouverte : « Ce tableau ne vous est plus
65
70
  // ouvert qu'en lecture. » `une` et `feminin` sont ceux de la déclaration des choses.
66
71
  export function texteDuDroitQuiBaisse(une, feminin = false) {
67
- const ce = feminin ? 'Cette' : /^[aeiouyàâéèêëîïôûü]/i.test(une) ? 'Cet' : 'Ce';
68
- return `${ce} ${une} ne vous est plus ouvert${feminin ? 'e' : ''} qu'en lecture.`;
72
+ return `${ceDevant(une, feminin)} ${une} ne vous est plus ouvert${feminin ? 'e' : ''} qu'en lecture.`;
73
+ }
74
+ // Ce que dit le direct quand le serveur n'a pas pris ce que la personne a écrit pendant que la
75
+ // connexion se rouvrait au droit qui a baissé : « Ce que vous venez d'écrire n'est pas enregistré :
76
+ // ce tableau ne vous est plus ouvert qu'en lecture. »
77
+ export function texteDeCeQuiNEstPasEnregistre(une, feminin = false) {
78
+ return `Ce que vous venez d'écrire n'est pas enregistré : ${ceDevant(une, feminin).toLowerCase()} ${une} ne vous est plus ouvert${feminin ? 'e' : ''} qu'en lecture.`;
79
+ }
80
+ // Ce que dit un refus du direct qui ne montre ni une chose introuvable ni la connexion : « Ce
81
+ // tableau ne s'ouvre pas depuis cette adresse. », « Votre session est fermée : rechargez la page
82
+ // pour vous reconnecter. », sinon « Le direct est fermé : <raison>. ».
83
+ export function texteDUnRefusDuDirect(raison, une, feminin = false) {
84
+ if (raison === raisons.origine) {
85
+ return `${ceDevant(une, feminin)} ${une} ne s'ouvre pas depuis cette adresse.`;
86
+ }
87
+ if (raison === raisons.connexion) {
88
+ return 'Votre session est fermée : rechargez la page pour vous reconnecter.';
89
+ }
90
+ return `Le direct est fermé : ${raison}.`;
69
91
  }
@@ -5,3 +5,9 @@ export declare function IconeDEpingle({ pleine, className }: {
5
5
  export declare function IconeDesApps({ className }: {
6
6
  className?: string;
7
7
  }): import("react").JSX.Element;
8
+ export declare function IconeAgrandir({ className }: {
9
+ className?: string;
10
+ }): import("react").JSX.Element;
11
+ export declare function IconeFermer({ className }: {
12
+ className?: string;
13
+ }): import("react").JSX.Element;
package/src/ui/icones.js CHANGED
@@ -9,3 +9,11 @@ export function IconeDEpingle({ pleine = false, className }) {
9
9
  export function IconeDesApps({ className }) {
10
10
  return (_jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", className: cn('size-4 flex-none', className), fill: "currentColor", children: [3, 8, 13].flatMap((y) => [3, 8, 13].map((x) => _jsx("circle", { cx: x, cy: y, r: "1.4" }, `${x}-${y}`))) }));
11
11
  }
12
+ // Agrandir : deux flèches qui s'écartent, vers les coins.
13
+ export function IconeAgrandir({ className }) {
14
+ return (_jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", className: cn('size-4 flex-none', className), fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("path", { d: "M9.5 2.5h4v4M13.5 2.5 9 7M6.5 13.5h-4v-4M2.5 13.5 7 9" }) }));
15
+ }
16
+ // Fermer : une croix.
17
+ export function IconeFermer({ className }) {
18
+ return (_jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", className: cn('size-4 flex-none', className), fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", children: _jsx("path", { d: "M4 4l8 8M12 4l-8 8" }) }));
19
+ }
package/src/ui/index.d.ts CHANGED
@@ -18,6 +18,6 @@ export { Panneau, type ProprietesDUnPanneau } from './panneau.tsx';
18
18
  export { Choix, type OptionDeChoix, type ProprietesDeChoix } from './choix.tsx';
19
19
  export { Vues, type ProprietesDesVues, type Vue } from './vues.tsx';
20
20
  export { Annonce, type ProprietesDUneAnnonce } from './annonce.tsx';
21
- export { IconeDEpingle, IconeDesApps } from './icones.tsx';
21
+ export { IconeAgrandir, IconeDEpingle, IconeDesApps, IconeFermer } from './icones.tsx';
22
22
  export { Suggestions, type ProprietesDesSuggestions, type Suggestion } from './suggestions.tsx';
23
- export { classesDeLEtiquetteDuNom, elementDeLEtiquetteDuNom, EtatEtPresences, EtiquetteDuNom, pastillesMontrees, personnesPresentes, texteDeLEtat, texteDuDroitQuiBaisse, type EtatDeLaConnexion, type PersonnePresente, type ProprietesDeLEtatEtDesPresences, type ProprietesDeLEtiquetteDuNom, } from './direct.tsx';
23
+ export { classesDeLEtiquetteDuNom, elementDeLEtiquetteDuNom, EtatEtPresences, EtiquetteDuNom, pastillesMontrees, personnesPresentes, texteDeLEtat, texteDeCeQuiNEstPasEnregistre, texteDuDroitQuiBaisse, texteDUnRefusDuDirect, type EtatDeLaConnexion, type PersonnePresente, type ProprietesDeLEtatEtDesPresences, type ProprietesDeLEtiquetteDuNom, } from './direct.tsx';
package/src/ui/index.js CHANGED
@@ -20,6 +20,6 @@ export { Panneau } from './panneau.js';
20
20
  export { Choix } from './choix.js';
21
21
  export { Vues } from './vues.js';
22
22
  export { Annonce } from './annonce.js';
23
- export { IconeDEpingle, IconeDesApps } from './icones.js';
23
+ export { IconeAgrandir, IconeDEpingle, IconeDesApps, IconeFermer } from './icones.js';
24
24
  export { Suggestions } from './suggestions.js';
25
- export { classesDeLEtiquetteDuNom, elementDeLEtiquetteDuNom, EtatEtPresences, EtiquetteDuNom, pastillesMontrees, personnesPresentes, texteDeLEtat, texteDuDroitQuiBaisse, } from './direct.js';
25
+ export { classesDeLEtiquetteDuNom, elementDeLEtiquetteDuNom, EtatEtPresences, EtiquetteDuNom, pastillesMontrees, personnesPresentes, texteDeLEtat, texteDeCeQuiNEstPasEnregistre, texteDuDroitQuiBaisse, texteDUnRefusDuDirect, } from './direct.js';
@@ -13,7 +13,7 @@ export function MenuDUneLigne({ nom, groupes, surLEcran = false }) {
13
13
  }
14
14
  const fermer = (ouverteMaintenant) => !ouverteMaintenant && setOuverte(undefined);
15
15
  const tous = pleins.flat();
16
- return (_jsxs(_Fragment, { children: [_jsxs(Menu, { children: [_jsx(MenuDeclencheur, { asChild: true, children: _jsx(Bouton, { ref: declencheur, type: "button", sorte: surLEcran ? 'secondaire' : 'discret', "aria-label": nom === undefined ? 'Plus de gestes' : `Plus de gestes pour « ${nom} »`, className: surLEcran ? 'px-2.5' : 'h-8 px-2', children: troisPoints }) }), _jsx(MenuContenu, { align: "end", children: pleins.map((groupe, rang) => (_jsxs(Fragment, { children: [rang > 0 && _jsx(MenuSeparateur, {}), groupe.map((geste) => (_jsx(EntreeDuMenu, { geste: geste, ouvrir: () => setOuverte(geste.libelle) }, geste.libelle)))] }, rang))) })] }), tous.map((geste) => geste.fenetre && (_jsx(Fragment, { children: geste.fenetre({ ouverte: ouverte === geste.libelle, onOuverteChange: fermer, retour: declencheur }) }, geste.libelle)))] }));
16
+ return (_jsxs(_Fragment, { children: [_jsxs(Menu, { children: [_jsx(MenuDeclencheur, { asChild: true, children: _jsx(Bouton, { ref: declencheur, type: "button", sorte: "discret", "aria-label": nom === undefined ? 'Plus de gestes' : `Plus de gestes pour « ${nom} »`, className: surLEcran ? 'size-7 px-0 text-gris hover:text-encre' : 'h-8 px-2', children: troisPoints }) }), _jsx(MenuContenu, { align: "end", children: pleins.map((groupe, rang) => (_jsxs(Fragment, { children: [rang > 0 && _jsx(MenuSeparateur, {}), groupe.map((geste) => (_jsx(EntreeDuMenu, { geste: geste, ouvrir: () => setOuverte(geste.libelle) }, geste.libelle)))] }, rang))) })] }), tous.map((geste) => geste.fenetre && (_jsx(Fragment, { children: geste.fenetre({ ouverte: ouverte === geste.libelle, onOuverteChange: fermer, retour: declencheur }) }, geste.libelle)))] }));
17
17
  }
18
18
  function EntreeDuMenu({ geste, ouvrir }) {
19
19
  const classes = geste.detruit ? 'text-erreur' : undefined;
@@ -15,6 +15,8 @@ export type ProprietesDUnTableau = {
15
15
  vide?: string;
16
16
  pagination?: Pagination;
17
17
  onOuvrirLigne?: (rang: number) => void;
18
+ onOuvrirEnGrand?: (rang: number) => void;
19
+ ligneOuverte?: number;
18
20
  className?: string;
19
21
  };
20
- export declare function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, className }: ProprietesDUnTableau): import("react").JSX.Element;
22
+ export declare function Tableau({ colonnes, lignes, vide, pagination, onOuvrirLigne, onOuvrirEnGrand, ligneOuverte, className }: ProprietesDUnTableau): import("react").JSX.Element;