@indos/bibliotheque 4.0.0 → 4.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CLAUDE.md +13 -13
- package/README.md +4 -4
- package/bin/page-de-l-espace.js +3 -3
- package/package.json +1 -1
- 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
package/CLAUDE.md
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
#
|
|
1
|
+
# bibliotheque
|
|
2
2
|
|
|
3
3
|
Le code que les apps partagent, intégré à l'image de chaque app au build, et le contrat d'une app : les règles que toute app suit, que le core, la bibliothèque, le kit ou les tests vérifient. À lire en entier avant d'écrire ou de changer une app.
|
|
4
4
|
|
|
5
|
-
Sa version est celle de
|
|
5
|
+
Sa version est celle de son `manifeste.json`, publiée sur npm sous `@indos/bibliotheque` ; `CHANGELOG.md` dit ce que chaque version change pour une app. Une app du catalogue, dans `apps/<nom>/` d'ind-os/sources, la cite par un lien de dossier ; une app du client, son propre dépôt cloné dans `code/<nom>/` du dépôt de l'OS, cite le paquet à une version exacte (« Comment une app s'en sert »).
|
|
6
6
|
|
|
7
7
|
## Commandes
|
|
8
8
|
|
|
9
9
|
```sh
|
|
10
|
-
# dans ind-os/sources, depuis
|
|
10
|
+
# dans ind-os/sources, depuis bibliotheque/, avant toute app du catalogue
|
|
11
11
|
npm ci
|
|
12
12
|
# depuis la racine du dépôt d'un OS : créer une app du client à partir du modèle
|
|
13
|
-
node
|
|
13
|
+
node bibliotheque/bin/bibliotheque.ts creer-une-app <nom>
|
|
14
14
|
# depuis le dossier de l'app (apps/<nom>/ ou code/<nom>/)
|
|
15
15
|
npm install # la première fois, puis commiter package-lock.json
|
|
16
16
|
npm test # construit la page, vérifie les types, tests de Node puis de la page
|
|
@@ -30,8 +30,8 @@ Le dossier de l'app porte :
|
|
|
30
30
|
- `pour`, `ecrans`, `reglages` (« Qui ouvre une app », « Les pages d'une app »).
|
|
31
31
|
- Une app du client ne déclare pas `sousDomaine` : le kit le refuse.
|
|
32
32
|
- `Dockerfile` et `Dockerfile.dockerignore` côte à côte (`**/node_modules`, `**/dist`, `.git`). Aucun `.dockerignore` à la racine du dépôt. Le modèle est `modeles/app-du-client/Dockerfile` :
|
|
33
|
-
- une app du client se construit sur son seul dossier (`docker build .`), la bibliothèque prise du paquet, par la CI de son dépôt (`.github/workflows/publier-l-image.yml`, du modèle), qui pousse l'image sur ghcr.io ; une app du catalogue reproduit l'arbre du dépôt (`/depot/
|
|
34
|
-
- elle ne prend aucun fichier de `
|
|
33
|
+
- une app du client se construit sur son seul dossier (`docker build .`), la bibliothèque prise du paquet, par la CI de son dépôt (`.github/workflows/publier-l-image.yml`, du modèle), qui pousse l'image sur ghcr.io ; une app du catalogue reproduit l'arbre du dépôt (`/depot/bibliotheque`, `/depot/apps/<nom>`) et ne prend, hors de son dossier, que `bibliotheque/` ;
|
|
34
|
+
- elle ne prend aucun fichier de `bibliotheque/tests/`, absent chez un client (la CI le vérifie) ;
|
|
35
35
|
- l'étape `tests` lance `npm test` et l'image prend `dist/` de cette étape : un test qui échoue arrête la construction ;
|
|
36
36
|
- les étapes des tests sont à la plateforme du poste (`FROM --platform=$BUILDPLATFORM <image de Node>`), l'image à celle du serveur ;
|
|
37
37
|
- l'image de Node est citée par sa version et son empreinte ; un seul `EXPOSE`, un `HEALTHCHECK` sur `/sante`, `USER node`.
|
|
@@ -234,10 +234,10 @@ Un geste d'écran est un appel de la page à sa pièce, en JSON, avec la session
|
|
|
234
234
|
|
|
235
235
|
`espace/` porte `index.html` (le même pour chaque pièce, sans script en ligne), `page.tsx` (les routes, puis `lancerLaPage`), `ecrans/` (un écran par fichier, qui n'exporte que son composant), `requetes/`, `tsconfig.json` (qui étend `tsconfig.page.json` de la bibliothèque) ; les tests de la page sont dans `tests/espace/*.test.tsx`. Le modèle est `modeles/app-du-client/espace/`.
|
|
236
236
|
|
|
237
|
-
- La page importe `@indos/bibliotheque/espace`, `@indos/bibliotheque/ui`, React, TanStack, Radix et Yjs tels quels : ils se résolvent depuis la bibliothèque, une seule copie de chacun. Une app du client les reçoit du paquet, dont ils sont les dépendances de pair que npm installe ; une app du catalogue lie `react` et `react-dom` à ceux de la bibliothèque (`file:../../
|
|
237
|
+
- La page importe `@indos/bibliotheque/espace`, `@indos/bibliotheque/ui`, React, TanStack, Radix et Yjs tels quels : ils se résolvent depuis la bibliothèque, une seule copie de chacun. Une app du client les reçoit du paquet, dont ils sont les dépendances de pair que npm installe ; une app du catalogue lie `react` et `react-dom` à ceux de la bibliothèque (`file:../../bibliotheque/node_modules/react`).
|
|
238
238
|
- Ses scripts npm lancent la commande de la page (`construire`, `developper`, `tester`) : `page-de-l-espace` pour une app du client, comme le modèle ; `node node_modules/@indos/bibliotheque/bin/page-de-l-espace.ts` pour une app du catalogue.
|
|
239
239
|
- `npm run build` refuse un script en ligne ; `page-de-l-espace tester` refuse le HTML brut dans `espace/` (`innerHTML`, `dangerouslySetInnerHTML`, `outerHTML`, `insertAdjacentHTML`, `document.write`).
|
|
240
|
-
- `npm run dev` : `INDOS_CORE` (le core de l'espace ou un core local), `INDOS_APP` (l'app lancée en local, `http://localhost:3000`), `INDOS_PORT
|
|
240
|
+
- `npm run dev` : `INDOS_CORE` (le core de l'espace ou un core local), `INDOS_APP` (l'app lancée en local, `http://localhost:3000`), `INDOS_PORT`, `INDOS_HOTE` (l'hôte d'écoute, localhost par défaut, `0.0.0.0` dans un conteneur). L'app est lancée avec `ADRESSE=http://localhost:5173/<app>`. Relié à un espace en HTTPS, la session passe dans Chrome et Firefox, pas dans Safari.
|
|
241
241
|
|
|
242
242
|
## La coquille
|
|
243
243
|
|
|
@@ -330,7 +330,7 @@ Une chose écrite à plusieurs montre son direct de la même façon partout : la
|
|
|
330
330
|
|
|
331
331
|
Une chose écrite à plusieurs en Yjs prend son direct de la bibliothèque : `creerLeDirectYjs` (`@indos/bibliotheque/direct`) au serveur, `ouvrirUnDirectYjs` (`@indos/bibliotheque/direct/page`) à la page. Chaque chose ouverte est un document Yjs en mémoire de l'app, relayé par Hocuspocus, écrit en base par l'app : une seule instance par serveur.
|
|
332
332
|
|
|
333
|
-
- Une seule copie de Yjs, celle de la bibliothèque : une app du catalogue cite `yjs` et `y-protocols` par un lien vers sa copie (`file:../../
|
|
333
|
+
- Une seule copie de Yjs, celle de la bibliothèque : une app du catalogue cite `yjs` et `y-protocols` par un lien vers sa copie (`file:../../bibliotheque/node_modules/yjs`), une app du client ne les cite pas ; aucune ne cite Hocuspocus.
|
|
334
334
|
- L'app donne `droitDe(personne, chose)`, `droitPublic(chose)` pour une chose publiée, `charger`, `enregistrer` (un `UPDATE` seul, qui ne recrée jamais une chose supprimée), `limite` et ses `textes`.
|
|
335
335
|
- Le serveur contrôle à l'ouverture, avant toute donnée, l'`Origin`, la session ou le lien publié, et le droit ; il écrit lui-même la présence de chaque connexion. Un visiteur en lecture sur l'hôte public ne reçoit aucune présence.
|
|
336
336
|
- `relire(...choses)` après un partage, un don, une publication, un changement du droit du lien, un déplacement ou une suppression (et toutes les cinq minutes) : une connexion sans droit est coupée (4403), une dont le droit a changé aussi (4205).
|
|
@@ -341,7 +341,7 @@ Une chose écrite à plusieurs en Yjs prend son direct de la bibliothèque : `cr
|
|
|
341
341
|
|
|
342
342
|
Une app du client cite le paquet publié à une version exacte : `"@indos/bibliotheque": "3.0.0"`. npm installe ses dépendances d'exécution et ses dépendances de pair (React, TanStack, Tailwind, Vite, Vitest, leurs types) ; l'image n'en garde aucune (`npm ci --omit=dev --omit=peer`). Une version publiée ne change plus : l'app ne prend la suivante qu'en changeant ce numéro. Le paquet est compilé, Node n'effaçant pas les types sous `node_modules` : `npm run paquet` l'écrit dans `paquet/` (`scripts/construire-le-paquet.ts`), et la release d'`indos` le publie.
|
|
343
343
|
|
|
344
|
-
Une app du catalogue cite la bibliothèque par un lien de dossier, au même commit : `"@indos/bibliotheque": "file:../../
|
|
344
|
+
Une app du catalogue cite la bibliothèque par un lien de dossier, au même commit : `"@indos/bibliotheque": "file:../../bibliotheque"`. Le lien se résout hors de `node_modules` : ni `install-links` ni `--preserve-symlinks`. Les dépendances de la bibliothèque s'installent par son propre `package-lock.json` ; une version qui en ajoute une demande `npm install` dans chaque app. Ce que les tests d'une app prennent hors de `src/`, comme le Radicale d'essai (`radicale/`), est dans la copie.
|
|
345
345
|
|
|
346
346
|
## Les aides des tests
|
|
347
347
|
|
|
@@ -352,10 +352,10 @@ Les tests de chaque app reposent sur ces aides ; ce qui reste dans ses tests lui
|
|
|
352
352
|
|
|
353
353
|
## Une app du client
|
|
354
354
|
|
|
355
|
-
Le modèle, `modeles/app-du-client/`, est une app à page qui ne prend que la bibliothèque : une migration, deux outils, un écran, ses tests, son `Dockerfile` et son `Dockerfile.dockerignore`, sans `package-lock.json`. `creer-une-app <nom>` le copie dans `code/<nom>/` du dépôt d'un OS, y pose le nom et cite le paquet à la version
|
|
355
|
+
Le modèle, `modeles/app-du-client/`, est une app à page qui ne prend que la bibliothèque : une migration, deux outils, un écran, ses tests, son `Dockerfile` et son `Dockerfile.dockerignore`, sans `package-lock.json`. `creer-une-app <nom>` le copie dans `code/<nom>/` du dépôt d'un OS, y pose le nom et cite le paquet à la version de `manifeste.json` ; elle refuse un dossier qui existe et un nom hors de `^[a-z][a-z0-9-]*$`, et se lance avant toute installation.
|
|
356
356
|
|
|
357
|
-
Les gestes sont les skills `indos-creer-une-app` et `indos-publier-une-app` et la méthode
|
|
357
|
+
Les gestes sont les skills `indos-creer-une-app` et `indos-publier-une-app` et la méthode du kit, `.claude/indos/METHODE.md` dans le dépôt de l'OS. Une app se développe sur une branche de son dépôt ; le clone de l'OS reste sur `main`, d'où elle se publie. La première publication écrit l'entrée de l'app dans `os.json` (`installer <app> <commit>` du kit) : ni `os.json` ni `apps/` ne se modifient à la main.
|
|
358
358
|
|
|
359
359
|
## La note des versions
|
|
360
360
|
|
|
361
|
-
`
|
|
361
|
+
`CHANGELOG.md` s'écrit pour le développeur d'une app du client : une section `## <version>` par version, une rubrique « Ruptures » quand une version demande un geste dans les apps (et, pour une majeure, le core qu'elle demande), et « Pour monter ». Monter une app : sur une branche de son dépôt, les gestes des ruptures de chaque version sautée, puis la version du paquet dans `package.json`, `npm install` et `npm test` dans l'app.
|
package/README.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# La bibliothèque d'Indos
|
|
2
2
|
|
|
3
|
-
Le code que les apps d'Indos partagent : le serveur d'une app, son MCP, sa base et ses migrations, la session du core, et la page de l'espace en React, avec sa coquille et ses composants. Elle
|
|
3
|
+
Le code que les apps d'Indos partagent : le serveur d'une app, son MCP, sa base et ses migrations, la session du core, et la page de l'espace en React, avec sa coquille et ses composants. Elle se publie sur npm sous `@indos/bibliotheque`, à la version de `manifeste.json` ; `CHANGELOG.md` dit ce que change chaque version.
|
|
4
4
|
|
|
5
5
|
- `CLAUDE.md` : le contrat d'une app, à lire avant d'en écrire une.
|
|
6
|
-
- `modeles/app-du-client/` : le modèle d'une app, que copie `node
|
|
6
|
+
- `modeles/app-du-client/` : le modèle d'une app, que copie `node bibliotheque/bin/bibliotheque.ts creer-une-app <nom>`.
|
|
7
7
|
|
|
8
|
-
Avant toute app, et après chaque nouvelle version : `npm ci` dans `
|
|
8
|
+
Avant toute app, et après chaque nouvelle version : `npm ci` dans `bibliotheque/`.
|
|
9
9
|
|
|
10
|
-
Licence : tous droits réservés, AVQN (`
|
|
10
|
+
Licence : tous droits réservés, AVQN (`LICENSE`).
|
package/bin/page-de-l-espace.js
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
// La page de l'espace d'une pièce, lancée dans le dossier de la pièce par ses commandes npm
|
|
3
|
-
// (
|
|
3
|
+
// (bibliotheque/CLAUDE.md, « Écrire une page »), par le lien de la bibliothèque dans ses
|
|
4
4
|
// `node_modules` (`node node_modules/@indos/bibliotheque/bin/page-de-l-espace.ts <commande>`) :
|
|
5
5
|
// - `construire` (`npm run build`) écrit le dossier construit, `dist/` ;
|
|
6
6
|
// - `developper` (`npm run dev`) la sert à chaud sur http://localhost:<port>, le port de
|
|
7
7
|
// `INDOS_PORT`, 5173 par défaut, reliée au core de `INDOS_CORE` et, pour une app, à l'app lancée
|
|
8
|
-
// en local à `INDOS_APP` ;
|
|
8
|
+
// en local à `INDOS_APP`, à l'écoute de `INDOS_HOTE` (localhost par défaut, `0.0.0.0` dans un conteneur) ;
|
|
9
9
|
// - `tester` lance ses tests de Vitest, `tests/espace/**/*.test.tsx`.
|
|
10
10
|
import { construireLaPage, developperLaPage, portDeDeveloppement, testerLaPage } from '../src/vite.js';
|
|
11
11
|
const [commande] = process.argv.slice(2);
|
|
@@ -24,7 +24,7 @@ else if (commande === 'developper') {
|
|
|
24
24
|
console.error(`INDOS_PORT n'est pas un port : ${process.env.INDOS_PORT}. Un nombre de 1 à 65535, comme 5174.`);
|
|
25
25
|
process.exit(1);
|
|
26
26
|
}
|
|
27
|
-
await developperLaPage(dossier, { core, app: process.env.INDOS_APP ?? 'http://localhost:3000', port });
|
|
27
|
+
await developperLaPage(dossier, { core, app: process.env.INDOS_APP ?? 'http://localhost:3000', port, hote: process.env.INDOS_HOTE });
|
|
28
28
|
}
|
|
29
29
|
else if (commande === 'tester') {
|
|
30
30
|
await testerLaPage(dossier);
|
package/package.json
CHANGED
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`).
|