@indos/bibliotheque 4.0.0 → 4.3.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/CLAUDE.md +21 -13
- package/README.md +4 -4
- package/bin/bibliotheque.d.ts +1 -0
- package/bin/bibliotheque.js +63 -0
- package/bin/page-de-l-espace.js +3 -3
- package/manifeste.json +5 -0
- package/modeles/app-du-client/.github/workflows/publier-l-image.yml +31 -0
- package/modeles/app-du-client/DOCUMENTATION.md +27 -0
- package/modeles/app-du-client/Dockerfile +34 -0
- package/modeles/app-du-client/Dockerfile.dockerignore +3 -0
- package/modeles/app-du-client/GUIDE.md +3 -0
- package/modeles/app-du-client/README.md +47 -0
- package/modeles/app-du-client/espace/ecrans/entrees.tsx +57 -0
- package/modeles/app-du-client/espace/index.html +9 -0
- package/modeles/app-du-client/espace/page.tsx +6 -0
- package/modeles/app-du-client/espace/requetes/entrees.ts +16 -0
- package/modeles/app-du-client/espace/routes.ts +12 -0
- package/modeles/app-du-client/espace/tsconfig.json +7 -0
- package/modeles/app-du-client/essai/poser.sql +6 -0
- package/modeles/app-du-client/logo.svg +1 -0
- package/modeles/app-du-client/manifeste.json +12 -0
- package/modeles/app-du-client/migrations/0001-creer-les-entrees.sql +10 -0
- package/modeles/app-du-client/package.json +20 -0
- package/modeles/app-du-client/src/demarrer.ts +17 -0
- package/modeles/app-du-client/src/outils.ts +48 -0
- package/modeles/app-du-client/src/serveur.ts +46 -0
- package/modeles/app-du-client/tests/espace/entrees.test.tsx +58 -0
- package/modeles/app-du-client/tests/serveur.test.ts +119 -0
- package/modeles/app-du-client/tsconfig.json +22 -0
- package/package.json +3 -2
- package/src/appeler.js +1 -1
- package/src/compte.js +2 -2
- package/src/direct/page.js +1 -1
- package/src/direct.js +1 -1
- package/src/ecran.js +1 -1
- package/src/espace/apercu.js +1 -1
- package/src/espace/chose-seule.js +1 -1
- package/src/espace/coquille.js +1 -1
- package/src/espace/ecran-d-une-chose.js +1 -1
- package/src/espace/essai.js +2 -2
- package/src/espace/index.js +1 -1
- package/src/faux-core.js +1 -1
- package/src/flux.js +1 -1
- package/src/forme-du-direct.js +1 -1
- package/src/jeton.js +1 -1
- package/src/liens.js +1 -1
- package/src/mcp.js +3 -3
- package/src/notifier.js +1 -1
- package/src/page.js +3 -3
- package/src/presence.js +1 -1
- package/src/sans-accents.js +1 -1
- package/src/session.js +2 -2
- package/src/theme.js +1 -1
- package/src/ui/index.js +1 -1
- package/src/vite.d.ts +2 -0
- package/src/vite.js +7 -6
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import type { IncomingMessage, ServerResponse } from 'node:http';
|
|
2
|
+
import type { ManifesteDeLApp } from '@indos/bibliotheque/app';
|
|
3
|
+
import { creerLaRacine, envoyerLaPage, pageSimple } from '@indos/bibliotheque/ecran';
|
|
4
|
+
import { creerLeMcp } from '@indos/bibliotheque/mcp';
|
|
5
|
+
import { servirLaPage } from '@indos/bibliotheque/page';
|
|
6
|
+
import { creerLaSession } from '@indos/bibliotheque/session';
|
|
7
|
+
import type pg from 'pg';
|
|
8
|
+
import { outils } from './outils.ts';
|
|
9
|
+
|
|
10
|
+
export type Contexte = {
|
|
11
|
+
base: pg.Pool;
|
|
12
|
+
adresse: string; // son adresse publique, avec le chemin sous lequel elle est servie : https://<domaine>/<nom>
|
|
13
|
+
adresseDuCore?: string;
|
|
14
|
+
manifeste: ManifesteDeLApp; // manifeste.json, que l'image porte : son nom, sa version, ses écrans
|
|
15
|
+
instructions: string; // GUIDE.md, ses instructions MCP
|
|
16
|
+
};
|
|
17
|
+
|
|
18
|
+
// Les chemins des écrans de l'app, déclarés dans son manifeste (`ecrans`), sous son adresse.
|
|
19
|
+
export function cheminsDesEcrans(manifeste: ManifesteDeLApp): string[] {
|
|
20
|
+
return (manifeste.ecrans ?? []).map((ecran) => `/${ecran.nom}`);
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
// Les routes de l'app : son MCP sur /mcp et ses outils pour son écran sur /outils/<nom> ; sa page de
|
|
24
|
+
// l'espace, construite dans `dist/` (`npm run build`), sur le chemin de chaque écran et ses fichiers
|
|
25
|
+
// sur /espace/… ; sa racine, qui renvoie vers son premier écran ; une page introuvable partout
|
|
26
|
+
// ailleurs. Elle est servie sous un chemin du domaine de l'OS, que `demarrerLApp` retire de la
|
|
27
|
+
// requête, sauf du chemin d'un écran (`src/demarrer.ts`). La sonde GET /sante est servie par la
|
|
28
|
+
// bibliothèque.
|
|
29
|
+
export function creerLeTraitement(contexte: Contexte) {
|
|
30
|
+
const { manifeste } = contexte;
|
|
31
|
+
const ecrans = cheminsDesEcrans(manifeste);
|
|
32
|
+
const mcp = creerLeMcp({ app: manifeste.nom, version: manifeste.version, instructions: contexte.instructions, outils: outils(contexte.base), adresseDuCore: contexte.adresseDuCore, adresse: contexte.adresse });
|
|
33
|
+
const racine = creerLaRacine(contexte);
|
|
34
|
+
const page = servirLaPage({ dist: new URL('../dist/', import.meta.url), session: creerLaSession(contexte.adresse, contexte.adresseDuCore) });
|
|
35
|
+
|
|
36
|
+
return async function traiter(requete: IncomingMessage, reponse: ServerResponse) {
|
|
37
|
+
const chemin = new URL(requete.url ?? '/', 'http://app').pathname;
|
|
38
|
+
if (chemin === '/mcp' || /^\/outils\/[^/]+$/.test(chemin)) {
|
|
39
|
+
await mcp(requete, reponse);
|
|
40
|
+
} else if (ecrans.includes(chemin) || chemin.startsWith('/espace/')) {
|
|
41
|
+
await page(requete, reponse, chemin);
|
|
42
|
+
} else if (!(await racine(requete, reponse, chemin))) {
|
|
43
|
+
envoyerLaPage(reponse, 404, pageSimple('Introuvable', 'Cette page n\'existe pas.'));
|
|
44
|
+
}
|
|
45
|
+
};
|
|
46
|
+
}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { screen } from '@testing-library/react';
|
|
2
|
+
import userEvent from '@testing-library/user-event';
|
|
3
|
+
import { afterEach, expect, test, vi } from 'vitest';
|
|
4
|
+
import { appDEssai, ouvrirLaPage, resultat, servir, sessionDEssai } from '@indos/bibliotheque/espace-d-essai';
|
|
5
|
+
import { ecrans as ecransDuManifeste, nom, titre } from '../../manifeste.json';
|
|
6
|
+
import { ecrans } from '../../espace/routes.ts';
|
|
7
|
+
|
|
8
|
+
afterEach(() => vi.unstubAllGlobals());
|
|
9
|
+
|
|
10
|
+
const chemin = `/${nom}/entrees`;
|
|
11
|
+
const ada = sessionDEssai([appDEssai(nom, titre, { ecrans: ecransDuManifeste })], { proprietaire: false });
|
|
12
|
+
|
|
13
|
+
test('l\'écran liste les entrées de la personne, la page dans l\'adresse', async () => {
|
|
14
|
+
const appels = servir({
|
|
15
|
+
'/espace/session': () => [200, ada],
|
|
16
|
+
[`/${nom}/outils/lister`]: () => [200, resultat({ lignes: [{ id: 'e1', texte: 'Appeler le notaire', cree_le: '2026-10-28T09:00:00.000Z' }], total: 26 })],
|
|
17
|
+
});
|
|
18
|
+
ouvrirLaPage(`${chemin}?page=2`, ecrans);
|
|
19
|
+
// Chaque onglet porte le titre de son écran : celui des entrées, actif, est le `<h1>` de la ligne
|
|
20
|
+
// du haut.
|
|
21
|
+
expect((await screen.findByRole('heading', { level: 1 })).textContent).toBe('Entrées');
|
|
22
|
+
await screen.findByText('Appeler le notaire');
|
|
23
|
+
expect(screen.getByText('28.10.2026 10:00')).toBeTruthy();
|
|
24
|
+
expect(appels).toContainEqual({ chemin: `/${nom}/outils/lister`, methode: 'POST', corps: { page: 2 } });
|
|
25
|
+
});
|
|
26
|
+
|
|
27
|
+
test('ajouter une entrée appelle l\'outil, puis relit la liste', async () => {
|
|
28
|
+
const entrees: { id: string; texte: string; cree_le: string }[] = [];
|
|
29
|
+
const appels = servir({
|
|
30
|
+
'/espace/session': () => [200, ada],
|
|
31
|
+
[`/${nom}/outils/ajouter`]: (corps) => {
|
|
32
|
+
const entree = { id: `e${entrees.length + 1}`, texte: String(corps.texte), cree_le: '2026-10-28T09:00:00.000Z' };
|
|
33
|
+
entrees.unshift(entree);
|
|
34
|
+
return [200, resultat(entree)];
|
|
35
|
+
},
|
|
36
|
+
[`/${nom}/outils/lister`]: () => [200, resultat({ lignes: entrees, total: entrees.length })],
|
|
37
|
+
});
|
|
38
|
+
ouvrirLaPage(chemin, ecrans);
|
|
39
|
+
await screen.findByText('Aucune entrée.');
|
|
40
|
+
await userEvent.type(screen.getByLabelText('Nouvelle entrée'), 'Relancer le devis');
|
|
41
|
+
await userEvent.click(screen.getByRole('button', { name: 'Ajouter' }));
|
|
42
|
+
await screen.findByText('Relancer le devis');
|
|
43
|
+
expect(appels).toContainEqual({ chemin: `/${nom}/outils/ajouter`, methode: 'POST', corps: { texte: 'Relancer le devis' } });
|
|
44
|
+
expect((screen.getByLabelText('Nouvelle entrée') as HTMLInputElement).value).toBe('');
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
test('un ajout refusé se lit sous le champ, mot pour mot', async () => {
|
|
48
|
+
servir({
|
|
49
|
+
'/espace/session': () => [200, ada],
|
|
50
|
+
[`/${nom}/outils/ajouter`]: () => [422, resultat('Le texte est trop long.', true)],
|
|
51
|
+
[`/${nom}/outils/lister`]: () => [200, resultat({ lignes: [], total: 0 })],
|
|
52
|
+
});
|
|
53
|
+
ouvrirLaPage(chemin, ecrans);
|
|
54
|
+
await screen.findByText('Aucune entrée.');
|
|
55
|
+
await userEvent.type(screen.getByLabelText('Nouvelle entrée'), 'Trop long');
|
|
56
|
+
await userEvent.click(screen.getByRole('button', { name: 'Ajouter' }));
|
|
57
|
+
expect((await screen.findByRole('alert')).textContent).toContain('Le texte est trop long.');
|
|
58
|
+
});
|
|
@@ -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('../manifeste.json', import.meta.url), 'utf8'));
|
|
11
|
+
const instructions = readFileSync(new URL('../GUIDE.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,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": "4.
|
|
3
|
+
"version": "4.3.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": "SEE LICENSE IN LICENSE",
|
|
6
6
|
"type": "module",
|
|
@@ -135,7 +135,8 @@
|
|
|
135
135
|
"./ui/theme.css": "./src/ui/theme.css"
|
|
136
136
|
},
|
|
137
137
|
"bin": {
|
|
138
|
-
"page-de-l-espace": "./bin/page-de-l-espace.js"
|
|
138
|
+
"page-de-l-espace": "./bin/page-de-l-espace.js",
|
|
139
|
+
"bibliotheque": "./bin/bibliotheque.js"
|
|
139
140
|
},
|
|
140
141
|
"dependencies": {
|
|
141
142
|
"@hocuspocus/common": "4.7.1",
|
package/src/appeler.js
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
export function estUnRefus(resultat) {
|
|
5
5
|
return resultat.isError === true && resultat._meta?.['indos/refus'] === true;
|
|
6
6
|
}
|
|
7
|
-
// L'appel d'une app à l'outil d'une autre, pour une personne, par le core (
|
|
7
|
+
// L'appel d'une app à l'outil d'une autre, pour une personne, par le core (bibliotheque/CLAUDE.md,
|
|
8
8
|
// « Les pièces »). `par` est le nom de l'app qui appelle ; le kit passe la clé commune des apps dans
|
|
9
9
|
// CLE_D_APPEL à toute app dont le compose la cite. Le résultat est celui de l'outil, refus compris ; une erreur ne vient que
|
|
10
10
|
// d'un appel que le core refuse (clé, personne ou app inconnue) ou qui n'aboutit pas.
|
package/src/compte.js
CHANGED
|
@@ -3,7 +3,7 @@ import { Refus } from './mcp.js';
|
|
|
3
3
|
import { traiterUnGesteDEcran } from './page.js';
|
|
4
4
|
import { creerLePartage, nomDe, suffit } from './partage.js';
|
|
5
5
|
import { creerLaSession } from './session.js';
|
|
6
|
-
// Un compte branché (
|
|
6
|
+
// Un compte branché (bibliotheque/CLAUDE.md, « Un compte branché ») : l'accès d'une
|
|
7
7
|
// personne à un service extérieur, comme une boîte mail, un agenda ou un kDrive. Il vit dans la
|
|
8
8
|
// base de l'app qui s'en sert, son secret chiffré ; la personne le branche, le modifie et le retire
|
|
9
9
|
// dans les réglages de l'app, sur l'écran commun des comptes. Il est à elle seule tant qu'elle ne
|
|
@@ -55,7 +55,7 @@ const faitsParDefaut = {
|
|
|
55
55
|
const suitesParDefaut = ['Son accès est effacé de l\'OS.', 'Rien n\'est effacé chez son fournisseur.'];
|
|
56
56
|
// L'identifiant d'un compte, un UUID.
|
|
57
57
|
const formeDUnId = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
|
|
58
|
-
// Les gestes d'écran des comptes d'une app (
|
|
58
|
+
// Les gestes d'écran des comptes d'une app (bibliotheque/CLAUDE.md, « Un compte branché »), que
|
|
59
59
|
// l'écran commun des comptes (`EcranDesComptes`, `@indos/bibliotheque/espace`) appelle depuis la page
|
|
60
60
|
// de l'app. Il rend `traiter(requete, reponse, chemin)`, qui sert `/espace/comptes/…` et rend faux
|
|
61
61
|
// pour un autre chemin ; `chemin` est celui de la requête, sans le chemin de l'app. Chaque geste
|
package/src/direct/page.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { HocuspocusProvider, HocuspocusProviderWebsocket } from '@hocuspocus/provider';
|
|
2
2
|
import * as Y from 'yjs';
|
|
3
3
|
import { cheminDuDirect, codes, raisons } from '../forme-du-direct.js';
|
|
4
|
-
// @indos/bibliotheque/direct/page : le direct Yjs d'une chose, côté page (
|
|
4
|
+
// @indos/bibliotheque/direct/page : le direct Yjs d'une chose, côté page (bibliotheque/CLAUDE.md,
|
|
5
5
|
// « Le direct Yjs ») : le document Yjs, relayé par Hocuspocus sur un WebSocket, de la même origine
|
|
6
6
|
// que la page, et sa présence, où le serveur écrit la personne de chaque onglet. L'app écrit dans le
|
|
7
7
|
// document sous sa propre origine, que son historique (⌘Z) suit seule : il ne défait jamais ce qu'un
|
package/src/direct.js
CHANGED
|
@@ -7,7 +7,7 @@ import { cheminDuDirect, codes, personneDeLInvite, raisons } from './forme-du-di
|
|
|
7
7
|
import { Refus } from './mcp.js';
|
|
8
8
|
import { suffit } from './partage.js';
|
|
9
9
|
import { couleurDe, longueurDUnNom } from './presence.js';
|
|
10
|
-
// @indos/bibliotheque/direct : le direct Yjs d'une app, côté serveur (
|
|
10
|
+
// @indos/bibliotheque/direct : le direct Yjs d'une app, côté serveur (bibliotheque/CLAUDE.md, « Le
|
|
11
11
|
// direct Yjs »). Chaque chose ouverte est un document Yjs en mémoire de l'app, relayé par Hocuspocus
|
|
12
12
|
// à chaque page qui l'a ouverte, par un WebSocket, et écrit en base par l'app. Une seule instance par
|
|
13
13
|
// serveur : un redémarrage coupe les connexions, que les pages rouvrent seules, et l'app écrit ses
|
package/src/ecran.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
// Les pages rendues par le serveur, sans script (
|
|
1
|
+
// Les pages rendues par le serveur, sans script (bibliotheque/CLAUDE.md, « Les pages
|
|
2
2
|
// rendues par le serveur ») : la page d'auth, celles du core (la connexion, le consentement, le mot de passe), et
|
|
3
3
|
// la page simple, une page introuvable ou une erreur, du core comme d'une app. La structure est
|
|
4
4
|
// écrite ici, une fois ; le style vient du core, à la racine du même domaine (`/theme/variables.css`,
|
package/src/espace/apercu.js
CHANGED
|
@@ -5,7 +5,7 @@ import { ContexteDuCadre } from './cadre.js';
|
|
|
5
5
|
import { EcranDUneChose } from './ecran-d-une-chose.js';
|
|
6
6
|
import { LienDansLaPage } from './lien.js';
|
|
7
7
|
import { useOuvrir } from './ouvrir.js';
|
|
8
|
-
// L'aperçu d'une chose, par-dessus sa liste (
|
|
8
|
+
// L'aperçu d'une chose, par-dessus sa liste (bibliotheque/CLAUDE.md, « Une app à choses ») : l'écran de la
|
|
9
9
|
// chose, le même, en étroit, dans un panneau posé à droite de la zone de l'écran, sur toute sa
|
|
10
10
|
// hauteur, ligne du haut comprise, une ombre sur son bord gauche, sans voile : la liste reste
|
|
11
11
|
// utilisable et ne bouge pas. 55 % de la zone au plus, 680 px au plus, 380 px au moins ; sous
|
|
@@ -7,7 +7,7 @@ import { EcranDUneChose } from './ecran-d-une-chose.js';
|
|
|
7
7
|
import { LienDansLaPage } from './lien.js';
|
|
8
8
|
import { ContexteDeLAnnonce } from './ouvrir.js';
|
|
9
9
|
import { useSession } from './session.js';
|
|
10
|
-
// Une chose seule, « Ouvrir à part ↗ » (
|
|
10
|
+
// Une chose seule, « Ouvrir à part ↗ » (bibliotheque/CLAUDE.md, « Une app à choses ») : l'écran de la chose,
|
|
11
11
|
// le même, avec la session, hors de la coquille (`horsDeLaCoquille`), ni barre de l'OS ni cadre, à
|
|
12
12
|
// `<chemin>/seule`, pour y travailler en grand dans son propre onglet. Sa tête mince
|
|
13
13
|
// (`TeteDUneChoseSeule`) : la marque, qui mène à l'accueil, le nom, renommable, puis le bloc de
|
package/src/espace/coquille.js
CHANGED
|
@@ -15,7 +15,7 @@ import { cheminDeLaListe } from './choses.js';
|
|
|
15
15
|
import { adresseDeLaListe, ContexteDeLAnnonce, useOuvrir } from './ouvrir.js';
|
|
16
16
|
import { EditionDeLaBarre, IconeDeDossier } from './edition-de-la-barre.js';
|
|
17
17
|
import { useSession } from './session.js';
|
|
18
|
-
// La coquille de la page, rendue d'après la session (
|
|
18
|
+
// La coquille de la page, rendue d'après la session (bibliotheque/CLAUDE.md, « La coquille ») : à gauche
|
|
19
19
|
// la barre de l'OS, la même sur tout écran, à la hauteur de l'écran, repliée en menu sur un
|
|
20
20
|
// téléphone ; à droite, le cadre de l'écran (`cadre.tsx`) et son contenu, sur toute la largeur. Un
|
|
21
21
|
// geste fait s'y annonce en bas de l'écran (`useAnnoncer`), d'un écran à l'autre, par-dessus une
|
|
@@ -14,7 +14,7 @@ import { MenuDUneChose } from './menu-d-une-chose.js';
|
|
|
14
14
|
import { adresseDeLaListe, useAnnoncer, useOuvrir } from './ouvrir.js';
|
|
15
15
|
import { BlocDeLAcces } from './panneau-du-partage.js';
|
|
16
16
|
import { useSession } from './session.js';
|
|
17
|
-
// L'écran d'une chose, dans le cadre de la coquille (
|
|
17
|
+
// L'écran d'une chose, dans le cadre de la coquille (bibliotheque/CLAUDE.md, « Une app à choses ») : le fil
|
|
18
18
|
// d'Ariane « <app> / <liste> / <nom> », que la coquille commence et que l'écran finit par les
|
|
19
19
|
// ancêtres d'une chose rangée dans une autre et le nom, qui se renomme d'un clic ; à droite de la
|
|
20
20
|
// ligne du haut, et seulement, le bloc de l'accès (`BlocDeLAcces`) et le ⋯ ; puis, après l'état de lecture commun, la ligne de tête du corps
|
package/src/espace/essai.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// @indos/bibliotheque/espace-d-essai : de quoi essayer la page de l'espace d'une pièce dans jsdom,
|
|
2
|
-
// par Vitest (
|
|
2
|
+
// par Vitest (bibliotheque/CLAUDE.md, « Les aides des tests ») : la session d'une personne, le
|
|
3
3
|
// serveur d'essai à la place de `fetch`, la page ouverte à une adresse, et le test commun des
|
|
4
4
|
// réglages d'une app à comptes branchés. Jamais chargé par une page servie.
|
|
5
5
|
import { createElement } from 'react';
|
|
@@ -84,7 +84,7 @@ const descriptionDEssai = {
|
|
|
84
84
|
{ nom: 'mot_de_passe', libelle: 'Mot de passe', genre: 'secret', requis: false, avecLeSuivant: false, fixe: false },
|
|
85
85
|
],
|
|
86
86
|
};
|
|
87
|
-
// Le test commun des réglages d'une app à comptes branchés (
|
|
87
|
+
// Le test commun des réglages d'une app à comptes branchés (bibliotheque/CLAUDE.md, « L'écran des
|
|
88
88
|
// comptes ») : à `/<nom>/reglages`, l'écran commun des comptes s'ouvre dans le cadre de l'app,
|
|
89
89
|
// l'onglet « Réglages » actif, et lit la description et la liste des comptes par les gestes d'écran
|
|
90
90
|
// de l'app. `ecrans` sont ceux de la page de l'app ; par défaut, la route que sa page déclare,
|
package/src/espace/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// @indos/bibliotheque/espace : la page de l'espace d'une pièce en React, sa coquille, ses appels, et
|
|
2
|
-
// la liste et l'écran des choses d'une app (
|
|
2
|
+
// la liste et l'écran des choses d'une app (bibliotheque/CLAUDE.md, « La page de l'espace », « Une
|
|
3
3
|
// app à choses »).
|
|
4
4
|
export { lancerLaPage } from './lancer.js';
|
|
5
5
|
export { coquilleDeLEspace, creerLaPage, horsDeLaCoquille, racine } from './page.js';
|
package/src/faux-core.js
CHANGED
|
@@ -36,7 +36,7 @@ function estOuverte(app, proprietaire, groupes) {
|
|
|
36
36
|
return proprietaire || acces.some((avec) => avec === 'equipe' || groupes.includes(avec));
|
|
37
37
|
}
|
|
38
38
|
// Ce que le core rend à `/session` des apps déclarées, pour une personne, dans sa forme
|
|
39
|
-
// (
|
|
39
|
+
// (bibliotheque/CLAUDE.md, « Les pièces ») : les apps qui lui sont ouvertes, d'après
|
|
40
40
|
// ses groupes, dans l'ordre de leur titre, chacune avec ses réglages quand la personne a le droit de
|
|
41
41
|
// les voir, les écrans qu'elle a le droit de voir, avec leur chemin, et son lien (son premier écran
|
|
42
42
|
// visible, sinon ses réglages, sinon son lien déclaré) ; puis la barre de départ : le premier écran
|
package/src/flux.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// Un flux d'événements envoyés par le serveur (`text/event-stream`), le même dans chaque app
|
|
2
|
-
// (
|
|
2
|
+
// (bibliotheque/CLAUDE.md, « Un flux d'événements ») : un commentaire et `retry` à l'ouverture, un
|
|
3
3
|
// battement qui garde la connexion ouverte au proxy, et la fermeture au bout de sa durée, d'un
|
|
4
4
|
// lecteur trop lent et à l'arrêt de l'app. La page se reconnecte seule, `retry` après.
|
|
5
5
|
// Un commentaire toutes les 25 secondes : le proxy de Coolify coupe une connexion muette à 90.
|
package/src/forme-du-direct.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { longueurDUnNom } from './presence.js';
|
|
2
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 (
|
|
3
|
+
// (`@indos/bibliotheque/direct/page`), sans rien de Node ni du navigateur (bibliotheque/CLAUDE.md,
|
|
4
4
|
// « Le direct Yjs ») : son chemin, les raisons de ses refus, ses codes de fermeture et la présence
|
|
5
5
|
// que le serveur écrit.
|
|
6
6
|
// Le chemin du direct d'une chose, sous l'app : `direct/<id>`.
|
package/src/jeton.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { createPublicKey, verify } from 'node:crypto';
|
|
2
2
|
export class JetonRefuse extends Error {
|
|
3
3
|
}
|
|
4
|
-
// Vérifie le jeton court que le core joint à chaque appel d'une app (
|
|
4
|
+
// Vérifie le jeton court que le core joint à chaque appel d'une app (bibliotheque/CLAUDE.md, « Le
|
|
5
5
|
// MCP d'une app ») : un JWT signé en Ed25519, valable une minute, pour cette app.
|
|
6
6
|
// La clé publique vient du core, à CORE_ADRESSE ; elle reste en mémoire, et se relit quand une
|
|
7
7
|
// signature échoue (le core a changé de clé), une fois par minute au plus.
|
package/src/liens.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { createHmac, timingSafeEqual } from 'node:crypto';
|
|
2
2
|
import { deriver } from './deriver.js';
|
|
3
|
-
// Les liens signés d'une app (
|
|
3
|
+
// Les liens signés d'une app (bibliotheque/CLAUDE.md, « Les pièces ») : dix minutes, une charge
|
|
4
4
|
// signée, une clé propre à chaque sorte, tirée de la clé de l'app ; rien n'est gardé en base.
|
|
5
5
|
export const dureeDUnLien = 600;
|
|
6
6
|
function cleDeLaSorte(cle, sorte) {
|
package/src/mcp.js
CHANGED
|
@@ -4,7 +4,7 @@ import { AjvJsonSchemaValidator } from '@modelcontextprotocol/server/validators/
|
|
|
4
4
|
import { creerLeVerificateur, JetonRefuse } from './jeton.js';
|
|
5
5
|
import { repondreEnJson, traiterUnAppelDEcran } from './appel-d-ecran.js';
|
|
6
6
|
import { creerLaSession } from './session.js';
|
|
7
|
-
// Le refus d'un outil (
|
|
7
|
+
// Le refus d'un outil (bibliotheque/CLAUDE.md, « Un refus ») : l'outil ne fait pas ce
|
|
8
8
|
// qu'on lui demande, parce que l'accord de la personne manque (`confirmer`), qu'elle n'y a pas
|
|
9
9
|
// droit, ou que la donnée est refusée. Levé dans `executer`, il rend une erreur d'outil marquée
|
|
10
10
|
// `_meta['indos/refus']`, avec son texte tel quel : le core l'écrit refusée au journal.
|
|
@@ -12,7 +12,7 @@ export class Refus extends Error {
|
|
|
12
12
|
}
|
|
13
13
|
// Le MCP d'une app, sur /mcp : Streamable HTTP sans état, MCP standard, par le SDK officiel.
|
|
14
14
|
// Chaque requête porte le jeton court du core ; l'app ne montre et n'exécute que les outils
|
|
15
|
-
// auxquels la personne a droit (
|
|
15
|
+
// auxquels la personne a droit (bibliotheque/CLAUDE.md, « Le MCP d'une app »).
|
|
16
16
|
// Les instructions sont le texte d'usage de l'app. Le même traitement sert les outils aux écrans
|
|
17
17
|
// de l'app, dans le navigateur, avec la session de la personne : `POST /outils/<nom>`. `adresse`
|
|
18
18
|
// est l'adresse publique de l'app (ADRESSE), dont l'origine est la seule que l'appel admet.
|
|
@@ -58,7 +58,7 @@ export function creerLeMcp(options) {
|
|
|
58
58
|
return serveur;
|
|
59
59
|
}));
|
|
60
60
|
// `POST /outils/<nom>` : l'appel d'un outil par un écran de l'app, pour la personne connectée au
|
|
61
|
-
// core (
|
|
61
|
+
// core (bibliotheque/CLAUDE.md, « Un écran appelle ses outils »), par les règles d'un geste d'écran
|
|
62
62
|
// (`traiterUnAppelDEcran`) : la méthode (405), l'origine de l'app, avant tout appel au core (403),
|
|
63
63
|
// la session (401), l'app ouverte à la personne, parmi les apps de sa session (403), un corps en
|
|
64
64
|
// JSON (415), de 4 Mio au plus (413), un objet (400) ; puis l'outil, avec ses droits et ses refus,
|
package/src/notifier.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// Une app notifie des personnes de ce qu'un autre a fait et qui les concerne
|
|
2
|
-
// (
|
|
2
|
+
// (bibliotheque/CLAUDE.md, « Les notifications »). La notification part au core, qui l'écrit et la
|
|
3
3
|
// montre dans l'écran « Notifications » et par la cloche de la barre.
|
|
4
4
|
// Le délai laissé au core pour répondre, en millisecondes.
|
|
5
5
|
export const delaiDUneNotification = 3_000;
|
package/src/page.js
CHANGED
|
@@ -6,7 +6,7 @@ import { echapper, entetesDeLEspace, envoyerLaPage, pageDAuth, pageSimple } from
|
|
|
6
6
|
import { identifiant } from './identifiant.js';
|
|
7
7
|
import { Refus } from './mcp.js';
|
|
8
8
|
import { creerLaSession } from './session.js';
|
|
9
|
-
// La page de l'espace d'une pièce, le core ou une app (
|
|
9
|
+
// La page de l'espace d'une pièce, le core ou une app (bibliotheque/CLAUDE.md, « La page
|
|
10
10
|
// de l'espace ») : une page en React, construite par Vite dans son dossier `dist/`, que sert la pièce
|
|
11
11
|
// elle-même. `dist/index.html` est la page ; ses fichiers, nommés par leur empreinte, sont sous
|
|
12
12
|
// `dist/espace/`, et la page les cite sous `<base>espace/…`.
|
|
@@ -142,7 +142,7 @@ export function entetesDeLaPagePublique(adresseDuCore, sources = {}) {
|
|
|
142
142
|
'cache-control': 'no-store',
|
|
143
143
|
};
|
|
144
144
|
}
|
|
145
|
-
// L'hôte public d'une app (
|
|
145
|
+
// L'hôte public d'une app (bibliotheque/CLAUDE.md, « L'hôte public d'une app ») : ce qu'un visiteur
|
|
146
146
|
// sans compte lit d'une chose publiée, sur l'hôte que la session du core n'atteint pas et où le
|
|
147
147
|
// chemin de l'app ne se retire pas. Il rend `traiter(requete, reponse)`, à qui l'app confie chaque
|
|
148
148
|
// requête de cet hôte, et `introuvable(requete, reponse)`, sa réponse à tout ce qui n'y est pas.
|
|
@@ -242,7 +242,7 @@ function lireLesFichiers(dossier) {
|
|
|
242
242
|
return fichiers;
|
|
243
243
|
}
|
|
244
244
|
// Un geste d'écran : un appel de la page de l'espace à sa pièce, en JSON, pour un geste que Claude
|
|
245
|
-
// ne doit pas voir (
|
|
245
|
+
// ne doit pas voir (bibliotheque/CLAUDE.md, « Les gestes d'écran »). Les règles d'un appel d'écran
|
|
246
246
|
// (`traiterUnAppelDEcran`) : `POST` (405), l'origine de la page, `origine` (403), la personne que
|
|
247
247
|
// rend `personneDe` (401, 403 pour une app fermée, 503 si le core ne répond pas), un objet JSON de
|
|
248
248
|
// 4 Mio au plus (415, 413, 400). Puis `executer` : sa valeur en 200 (`{}` pour rien) ; un `Refus`
|
package/src/presence.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// @indos/bibliotheque/presence : une personne présente dans le direct et sa couleur, sans rien de
|
|
2
|
-
// Node ni du navigateur (
|
|
2
|
+
// Node ni du navigateur (bibliotheque/CLAUDE.md, « Le direct à l'écran »). La page et le serveur la
|
|
3
3
|
// calculent de la même façon : une personne a la même couleur dans toutes les apps, sur chaque
|
|
4
4
|
// appareil.
|
|
5
5
|
// La longueur d'un nom dans le direct : le nom d'une session, ou le prénom d'un invité, borné.
|
package/src/sans-accents.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
// La recherche sans accents ni casse (
|
|
1
|
+
// La recherche sans accents ni casse (bibliotheque/CLAUDE.md, « Une app à choses ») : la même
|
|
2
2
|
// normalisation en SQL, pour une app qui cherche dans sa base, et en JavaScript, pour une app qui
|
|
3
3
|
// filtre en mémoire. Chaque lettre se décompose (NFD), ses marques combinantes (U+0300 à U+036F)
|
|
4
4
|
// partent, puis la casse : « Été » devient « ete ». La casse vient après les marques, pour qu'une
|
package/src/session.js
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import { envoyerLaPage, pageSimple } from './ecran.js';
|
|
2
|
-
// Une page d'une app reconnaît la personne connectée au core (
|
|
2
|
+
// Une page d'une app reconnaît la personne connectée au core (bibliotheque/CLAUDE.md, « Les
|
|
3
3
|
// pages d'une app ») : servie sous le domaine du core, l'app reçoit du navigateur le cookie de session
|
|
4
4
|
// du core, et le présente au core, à CORE_ADRESSE/session, à chaque requête. `adresse` est
|
|
5
5
|
// l'adresse publique de l'app, avec son chemin (ADRESSE, comme https://essai.indos.ch/courrier) ;
|
|
6
6
|
// la connexion est celle du core, à la racine de la même origine. L'app qui a une page ne démarre
|
|
7
7
|
// pas sans ADRESSE ; sans CORE_ADRESSE, elle démarre, et sa page répond par une erreur.
|
|
8
|
-
// Le dernier segment du chemin d'ADRESSE est le nom de l'app (
|
|
8
|
+
// Le dernier segment du chemin d'ADRESSE est le nom de l'app (bibliotheque/CLAUDE.md, « Les
|
|
9
9
|
// pages d'une app ») : une app fermée à la personne n'a de page pour elle ni dans l'espace ni dans les
|
|
10
10
|
// réglages. `personneDe` ne la rend pas, et `envoyerALaConnexion` répond alors une page introuvable,
|
|
11
11
|
// sans renvoyer vers une connexion qui ramènerait ici.
|
package/src/theme.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
// Le thème du client, que sert le core (
|
|
1
|
+
// Le thème du client, que sert le core (bibliotheque/CLAUDE.md, « Les pièces ») : ses
|
|
2
2
|
// variables CSS, lues à CORE_ADRESSE et gardées une minute. Si le core ne répond pas, le thème est
|
|
3
3
|
// vide et la page garde les couleurs du navigateur. `horloge` ne sert qu'aux tests.
|
|
4
4
|
export function creerLeLecteurDuTheme(adresseDuCore = process.env.CORE_ADRESSE, horloge = Date.now) {
|
package/src/ui/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// @indos/bibliotheque/ui : les composants des pages de l'espace, sur la feuille
|
|
2
|
-
// @indos/bibliotheque/ui/theme.css (
|
|
2
|
+
// @indos/bibliotheque/ui/theme.css (bibliotheque/CLAUDE.md, « Les composants d'une page »).
|
|
3
3
|
export { cn } from './classes.js';
|
|
4
4
|
export { Lien, LienDeLaPage } from './lien.js';
|
|
5
5
|
export { Bouton } from './bouton.js';
|
package/src/vite.d.ts
CHANGED
|
@@ -19,11 +19,13 @@ export declare function configurationDuDeveloppement(dossier: string, options: {
|
|
|
19
19
|
core: string;
|
|
20
20
|
app: string;
|
|
21
21
|
port?: number;
|
|
22
|
+
hote?: string;
|
|
22
23
|
}): InlineConfig;
|
|
23
24
|
export declare function developperLaPage(dossier: string, options: {
|
|
24
25
|
core: string;
|
|
25
26
|
app: string;
|
|
26
27
|
port?: number;
|
|
28
|
+
hote?: string;
|
|
27
29
|
}): Promise<import("vite").ViteDevServer>;
|
|
28
30
|
export declare function testerLaPage(dossier: string): Promise<void>;
|
|
29
31
|
export declare function fautesDeHtmlBrut(dossier: string): string[];
|
package/src/vite.js
CHANGED
|
@@ -6,13 +6,13 @@ import { fileURLToPath } from 'node:url';
|
|
|
6
6
|
import { build, createServer } from 'vite';
|
|
7
7
|
import { startVitest } from 'vitest/node';
|
|
8
8
|
import { estUnEcranDesChoses } from './page.js';
|
|
9
|
-
// La configuration Vite de la page de l'espace d'une pièce (
|
|
9
|
+
// La configuration Vite de la page de l'espace d'une pièce (bibliotheque/CLAUDE.md, « Écrire une
|
|
10
10
|
// page ») : le dossier de la pièce a son `manifeste.json` et sa page dans `espace/` (`espace/index.html`,
|
|
11
11
|
// qui lance `espace/page.tsx`). `construireLaPage` écrit le dossier construit, `dist/` ;
|
|
12
12
|
// `developperLaPage` la sert à chaud sur `http://localhost:<port>`, 5173 par défaut, reliée au core
|
|
13
13
|
// et à l'app ;
|
|
14
14
|
// `testerLaPage` refuse le HTML brut dans ses sources, puis lance ses tests de Vitest.
|
|
15
|
-
// Le dossier de la bibliothèque : `
|
|
15
|
+
// Le dossier de la bibliothèque : `bibliotheque/` dans le dépôt, `<app>/node_modules/@indos/bibliotheque/`
|
|
16
16
|
// pour le paquet publié.
|
|
17
17
|
const bibliotheque = fileURLToPath(new URL('..', import.meta.url));
|
|
18
18
|
// Le module de la coquille, d'où se résolvent les dépendances du navigateur : sa source dans le
|
|
@@ -24,8 +24,8 @@ const doublesDeJsdom = fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? '
|
|
|
24
24
|
// chacune, celle que la bibliothèque résout, même importée par la page d'une app ou ses tests. Yjs
|
|
25
25
|
// surtout : deux copies dans une page ne se reconnaissent pas, et le direct (`@indos/bibliotheque/
|
|
26
26
|
// direct/page`) ne lirait pas le document d'un éditeur qui importe l'autre.
|
|
27
|
-
// Dans le dépôt, ce sont celles de `
|
|
28
|
-
// déclare que React et React DOM, en liens vers elles (`file:../../
|
|
27
|
+
// Dans le dépôt, ce sont celles de `bibliotheque/node_modules`, dont une app du catalogue ne
|
|
28
|
+
// déclare que React et React DOM, en liens vers elles (`file:../../bibliotheque/node_modules/react`) ;
|
|
29
29
|
// pour le paquet publié, ses dépendances de pair, que npm installe dans `<app>/node_modules`.
|
|
30
30
|
const dependancesDuNavigateur = /^(react|react-dom|@tanstack\/react-router|@tanstack\/react-query|radix-ui|tailwind-merge|yjs|y-protocols|@hocuspocus\/provider|@testing-library\/[^/]+|vitest)(\/|$)/;
|
|
31
31
|
// Le port du serveur de développement, quand la pièce n'en choisit pas d'autre (`INDOS_PORT`) : il
|
|
@@ -203,7 +203,8 @@ export function relais(options) {
|
|
|
203
203
|
return relais;
|
|
204
204
|
}
|
|
205
205
|
// La configuration du serveur de développement de la pièce, sur `http://localhost:<port>`
|
|
206
|
-
// (`portDeDeveloppement` par défaut),
|
|
206
|
+
// (`portDeDeveloppement` par défaut), à l'écoute de `hote` (localhost par défaut ; `0.0.0.0` dans un
|
|
207
|
+
// conteneur que joint un proxy), reliée au core de `core` (celui d'un espace ou un core local)
|
|
207
208
|
// et, pour une app, à l'app lancée en local à `app`. Après la connexion, le core ramène à `/` : pour
|
|
208
209
|
// une app, la racine mène à son premier écran.
|
|
209
210
|
export function configurationDuDeveloppement(dossier, options) {
|
|
@@ -227,7 +228,7 @@ export function configurationDuDeveloppement(dossier, options) {
|
|
|
227
228
|
...config,
|
|
228
229
|
mode: 'development',
|
|
229
230
|
plugins: [...(config.plugins ?? []), racine],
|
|
230
|
-
server: { ...config.server, port: options.port ?? portDeDeveloppement, strictPort: true, proxy: relais({ base: piece.base, core: options.core, app: options.app, garde: cheminsGardes(dossier) }) },
|
|
231
|
+
server: { ...config.server, ...(options.hote ? { host: options.hote } : {}), port: options.port ?? portDeDeveloppement, strictPort: true, proxy: relais({ base: piece.base, core: options.core, app: options.app, garde: cheminsGardes(dossier) }) },
|
|
231
232
|
};
|
|
232
233
|
}
|
|
233
234
|
// Sert la page de la pièce à chaud sur `http://localhost:<port>` (`configurationDuDeveloppement`).
|