@indos/bibliotheque 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +36 -0
- package/LICENSE +21 -0
- package/README.md +8 -2
- package/bin/page-de-l-espace.d.ts +1 -0
- package/bin/page-de-l-espace.js +29 -0
- package/modeles/partage.sql +16 -0
- package/package.json +117 -4
- package/src/app.d.ts +3 -0
- package/src/app.js +30 -0
- package/src/appel-d-ecran.d.ts +18 -0
- package/src/appel-d-ecran.js +82 -0
- package/src/appeler.d.ts +13 -0
- package/src/appeler.js +33 -0
- package/src/base-d-essai.d.ts +4 -0
- package/src/base-d-essai.js +18 -0
- package/src/base.d.ts +3 -0
- package/src/base.js +49 -0
- package/src/compte.d.ts +53 -0
- package/src/compte.js +176 -0
- package/src/deriver.d.ts +2 -0
- package/src/deriver.js +28 -0
- package/src/description-des-comptes.d.ts +50 -0
- package/src/description-des-comptes.js +4 -0
- package/src/ecran.d.ts +90 -0
- package/src/ecran.js +139 -0
- package/src/espace/appel.d.ts +10 -0
- package/src/espace/appel.js +20 -0
- package/src/espace/appels.d.ts +23 -0
- package/src/espace/appels.js +81 -0
- package/src/espace/comptes.d.ts +1 -0
- package/src/espace/comptes.js +180 -0
- package/src/espace/contexte.d.ts +8 -0
- package/src/espace/contexte.js +6 -0
- package/src/espace/coquille.d.ts +2 -0
- package/src/espace/coquille.js +76 -0
- package/src/espace/ecran.d.ts +10 -0
- package/src/espace/ecran.js +23 -0
- package/src/espace/entree-active.d.ts +2 -0
- package/src/espace/entree-active.js +21 -0
- package/src/espace/erreur.d.ts +3 -0
- package/src/espace/erreur.js +23 -0
- package/src/espace/heure.d.ts +1 -0
- package/src/espace/heure.js +14 -0
- package/src/espace/index.d.ts +12 -0
- package/src/espace/index.js +13 -0
- package/src/espace/lancer.d.ts +3 -0
- package/src/espace/lancer.js +13 -0
- package/src/espace/lien.d.ts +6 -0
- package/src/espace/lien.js +43 -0
- package/src/espace/navigation.d.ts +1 -0
- package/src/espace/navigation.js +5 -0
- package/src/espace/page.d.ts +25 -0
- package/src/espace/page.js +51 -0
- package/src/espace/pagination.d.ts +8 -0
- package/src/espace/pagination.js +19 -0
- package/src/espace/session.d.ts +37 -0
- package/src/espace/session.js +13 -0
- package/src/faux-core.d.ts +29 -0
- package/src/faux-core.js +112 -0
- package/src/fichiers.d.ts +36 -0
- package/src/fichiers.js +109 -0
- package/src/jeton.d.ts +10 -0
- package/src/jeton.js +96 -0
- package/src/liens.d.ts +10 -0
- package/src/liens.js +52 -0
- package/src/mcp.d.ts +20 -0
- package/src/mcp.js +153 -0
- package/src/page.d.ts +17 -0
- package/src/page.js +127 -0
- package/src/pagination.d.ts +1 -0
- package/src/pagination.js +4 -0
- package/src/partage.d.ts +62 -0
- package/src/partage.js +248 -0
- package/src/session.d.ts +17 -0
- package/src/session.js +124 -0
- package/src/theme.d.ts +2 -0
- package/src/theme.js +52 -0
- package/src/type-de-fichier.d.ts +6 -0
- package/src/type-de-fichier.js +115 -0
- package/src/ui/annonce.d.ts +7 -0
- package/src/ui/annonce.js +18 -0
- package/src/ui/blocs.d.ts +44 -0
- package/src/ui/blocs.js +34 -0
- package/src/ui/bouton.d.ts +7 -0
- package/src/ui/bouton.js +13 -0
- package/src/ui/cases.d.ts +19 -0
- package/src/ui/cases.js +17 -0
- package/src/ui/champ.d.ts +21 -0
- package/src/ui/champ.js +25 -0
- package/src/ui/choix.d.ts +16 -0
- package/src/ui/choix.js +11 -0
- package/src/ui/classes.d.ts +2 -0
- package/src/ui/classes.js +7 -0
- package/src/ui/confirmation.d.ts +12 -0
- package/src/ui/confirmation.js +6 -0
- package/src/ui/fenetre.d.ts +13 -0
- package/src/ui/fenetre.js +40 -0
- package/src/ui/graphiques.d.ts +44 -0
- package/src/ui/graphiques.js +128 -0
- package/src/ui/index.d.ts +18 -0
- package/src/ui/index.js +20 -0
- package/src/ui/lien.d.ts +8 -0
- package/src/ui/lien.js +10 -0
- package/src/ui/menu.d.ts +8 -0
- package/src/ui/menu.js +20 -0
- package/src/ui/panneau.d.ts +12 -0
- package/src/ui/panneau.js +17 -0
- package/src/ui/repli.d.ts +12 -0
- package/src/ui/repli.js +6 -0
- package/src/ui/suggestions.d.ts +14 -0
- package/src/ui/suggestions.js +54 -0
- package/src/ui/tableau.d.ts +18 -0
- package/src/ui/tableau.js +28 -0
- package/src/ui/theme.css +112 -0
- package/src/ui/vues.d.ts +15 -0
- package/src/ui/vues.js +7 -0
- package/src/vite.d.ts +19 -0
- package/src/vite.js +195 -0
- package/tsconfig.page.json +30 -0
package/src/vite.d.ts
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { type ProxyOptions } from 'vite';
|
|
2
|
+
export declare const portDeDeveloppement = 5173;
|
|
3
|
+
export declare function lirePiece(dossier: string): {
|
|
4
|
+
nom: string;
|
|
5
|
+
base: string;
|
|
6
|
+
premierEcran: string;
|
|
7
|
+
};
|
|
8
|
+
export declare function scriptsEnLigne(html: string): string[];
|
|
9
|
+
export declare function construireLaPage(dossier: string): Promise<void>;
|
|
10
|
+
export declare function relais(options: {
|
|
11
|
+
base: string;
|
|
12
|
+
core: string;
|
|
13
|
+
app: string;
|
|
14
|
+
}): Record<string, ProxyOptions>;
|
|
15
|
+
export declare function developperLaPage(dossier: string, options: {
|
|
16
|
+
core: string;
|
|
17
|
+
app: string;
|
|
18
|
+
}): Promise<import("vite").ViteDevServer>;
|
|
19
|
+
export declare function testerLaPage(dossier: string): Promise<void>;
|
package/src/vite.js
ADDED
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
import tailwindcss from '@tailwindcss/vite';
|
|
2
|
+
import react from '@vitejs/plugin-react';
|
|
3
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
4
|
+
import { join } from 'node:path';
|
|
5
|
+
import { fileURLToPath } from 'node:url';
|
|
6
|
+
import { build, createServer } from 'vite';
|
|
7
|
+
import { startVitest } from 'vitest/node';
|
|
8
|
+
// La configuration Vite de la page de l'espace d'une pièce (bibliotheque/CLAUDE.md, « Écrire une
|
|
9
|
+
// page ») : le dossier de la pièce a son `module.json` et sa page dans `espace/` (`espace/index.html`,
|
|
10
|
+
// qui lance `espace/page.tsx`). `construireLaPage` écrit le dossier construit, `dist/` ;
|
|
11
|
+
// `developperLaPage` la sert à chaud sur `http://localhost:5173`, reliée au core et à l'app ;
|
|
12
|
+
// `testerLaPage` lance ses tests de Vitest.
|
|
13
|
+
// Le dossier de la bibliothèque : `bibliotheque/` dans le dépôt, `<app>/node_modules/@indos/bibliotheque/`
|
|
14
|
+
// pour le paquet publié.
|
|
15
|
+
const bibliotheque = fileURLToPath(new URL('..', import.meta.url));
|
|
16
|
+
// Le module de la coquille, d'où se résolvent les dépendances du navigateur : sa source dans le
|
|
17
|
+
// dépôt, son JavaScript compilé dans le paquet publié.
|
|
18
|
+
const coquille = fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? './espace/index.ts' : './espace/index.js', import.meta.url));
|
|
19
|
+
// Les dépendances du navigateur et de ses tests, celles de la bibliothèque : une seule copie de
|
|
20
|
+
// chacune, celle que la bibliothèque résout, même importée par la page d'une app ou ses tests.
|
|
21
|
+
// Dans le dépôt, ce sont celles de `bibliotheque/node_modules`, qu'une app du catalogue n'installe
|
|
22
|
+
// pas ; pour le paquet publié, ses dépendances de pair, que npm installe dans `<app>/node_modules`.
|
|
23
|
+
const dependancesDuNavigateur = /^(react|react-dom|@tanstack\/react-router|@tanstack\/react-query|radix-ui|tailwind-merge|@testing-library\/[^/]+|vitest)(\/|$)/;
|
|
24
|
+
// Le port du serveur de développement.
|
|
25
|
+
export const portDeDeveloppement = 5173;
|
|
26
|
+
// Ce que le `module.json` de la pièce dit de sa page : son nom, sa base (`/` pour le core,
|
|
27
|
+
// `/<app>/` pour une app) et son premier écran, où mène la racine en développement.
|
|
28
|
+
export function lirePiece(dossier) {
|
|
29
|
+
const manifeste = JSON.parse(readFileSync(join(dossier, 'module.json'), 'utf8'));
|
|
30
|
+
const base = manifeste.nom === 'core' ? '/' : `/${manifeste.nom}/`;
|
|
31
|
+
const [premier] = manifeste.ecrans ?? [];
|
|
32
|
+
return { nom: manifeste.nom, base, premierEcran: premier ? `${base}${premier.nom}` : base };
|
|
33
|
+
}
|
|
34
|
+
// Les règles de la page, communes au build et au développement :
|
|
35
|
+
// - les dépendances du navigateur se résolvent depuis la bibliothèque ;
|
|
36
|
+
// - `/theme/variables.css`, les couleurs et les polices du client que sert le core, est lié en tête,
|
|
37
|
+
// avant la feuille de la page ; la page n'a pas de favicon tant que la session ne dit pas le logo,
|
|
38
|
+
// sans que le navigateur demande `/favicon.ico` ;
|
|
39
|
+
// - au build, la page n'a aucun script en ligne : la politique de l'espace (`script-src 'self'`)
|
|
40
|
+
// le refuserait.
|
|
41
|
+
function reglesDeLaPage() {
|
|
42
|
+
return {
|
|
43
|
+
name: 'indos:page-de-l-espace',
|
|
44
|
+
resolveId: {
|
|
45
|
+
order: 'pre',
|
|
46
|
+
async handler(source, importer, options) {
|
|
47
|
+
if (!importer || !dependancesDuNavigateur.test(source) || importer.startsWith(bibliotheque)) {
|
|
48
|
+
return null;
|
|
49
|
+
}
|
|
50
|
+
return this.resolve(source, coquille, { ...options, skipSelf: true });
|
|
51
|
+
},
|
|
52
|
+
},
|
|
53
|
+
transformIndexHtml: {
|
|
54
|
+
order: 'post',
|
|
55
|
+
handler(html, contexte) {
|
|
56
|
+
if (contexte.bundle && scriptsEnLigne(html).length) {
|
|
57
|
+
throw new Error(`La page a un script en ligne, que sa politique de sécurité refuserait : ${scriptsEnLigne(html)[0]}`);
|
|
58
|
+
}
|
|
59
|
+
const tete = '<meta name="viewport" content="width=device-width, initial-scale=1">\n <link rel="icon" href="data:,">\n <link rel="stylesheet" href="/theme/variables.css">';
|
|
60
|
+
return /<meta charset[^>]*>/i.test(html)
|
|
61
|
+
? html.replace(/<meta charset[^>]*>/i, (charset) => `${charset}\n ${tete}`)
|
|
62
|
+
: html.replace(/<head[^>]*>/i, (head) => `${head}\n ${tete}`);
|
|
63
|
+
},
|
|
64
|
+
},
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
// Les scripts en ligne d'une page : un `<script>` sans `src`.
|
|
68
|
+
export function scriptsEnLigne(html) {
|
|
69
|
+
return [...html.matchAll(/<script\b[^>]*>/gi)].map(([balise]) => balise).filter((balise) => !/\ssrc=/i.test(balise));
|
|
70
|
+
}
|
|
71
|
+
function configuration(dossier, base) {
|
|
72
|
+
const page = join(dossier, 'espace');
|
|
73
|
+
if (!existsSync(join(page, 'index.html'))) {
|
|
74
|
+
throw new Error(`La page de la pièce manque : ${join(page, 'index.html')}.`);
|
|
75
|
+
}
|
|
76
|
+
return {
|
|
77
|
+
configFile: false,
|
|
78
|
+
root: page,
|
|
79
|
+
base,
|
|
80
|
+
cacheDir: join(dossier, 'node_modules/.vite'),
|
|
81
|
+
plugins: [react(), tailwindcss(), reglesDeLaPage()],
|
|
82
|
+
build: { outDir: join(dossier, 'dist'), emptyOutDir: true, assetsDir: 'espace' },
|
|
83
|
+
server: { fs: { allow: [dossier, bibliotheque] } },
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
// Construit la page de la pièce dans `dist/` : `dist/index.html`, et ses fichiers nommés par leur
|
|
87
|
+
// empreinte sous `dist/espace/`, cités sous `<base>espace/`.
|
|
88
|
+
export async function construireLaPage(dossier) {
|
|
89
|
+
await build({ ...configuration(dossier, lirePiece(dossier).base), mode: 'production' });
|
|
90
|
+
}
|
|
91
|
+
// Les relais du serveur de développement. Vers le core : la connexion et l'auth, la session, le
|
|
92
|
+
// thème et les gestes du core (sous `/espace/`), en lui présentant son origine et son hôte, ses
|
|
93
|
+
// cookies posés pour le serveur de développement, et ses renvois vers lui-même ramenés au serveur
|
|
94
|
+
// de développement. `/theme/variables.css` cite les polices à l'adresse publique du core : le relais
|
|
95
|
+
// la ramène au serveur de développement, d'où la page charge les polices, de sa propre origine. Vers
|
|
96
|
+
// l'app lancée en local (une app, pas le core) : ce qu'une page lui envoie sous sa base (ses outils,
|
|
97
|
+
// ses gestes), sans le chemin de l'app, comme le proxy du serveur.
|
|
98
|
+
export function relais(options) {
|
|
99
|
+
const origineDuCore = new URL(options.core).origin;
|
|
100
|
+
const versLeCore = {
|
|
101
|
+
target: origineDuCore,
|
|
102
|
+
changeOrigin: true,
|
|
103
|
+
cookieDomainRewrite: { '*': '' },
|
|
104
|
+
configure(proxy) {
|
|
105
|
+
proxy.on('proxyReq', (requete) => {
|
|
106
|
+
if (requete.getHeader('origin')) {
|
|
107
|
+
requete.setHeader('origin', origineDuCore);
|
|
108
|
+
}
|
|
109
|
+
});
|
|
110
|
+
proxy.on('proxyRes', (reponse) => {
|
|
111
|
+
const adresse = reponse.headers.location;
|
|
112
|
+
if (adresse?.startsWith(origineDuCore)) {
|
|
113
|
+
reponse.headers.location = adresse.slice(origineDuCore.length) || '/';
|
|
114
|
+
}
|
|
115
|
+
});
|
|
116
|
+
},
|
|
117
|
+
};
|
|
118
|
+
const variablesDuCore = {
|
|
119
|
+
target: origineDuCore,
|
|
120
|
+
changeOrigin: true,
|
|
121
|
+
selfHandleResponse: true,
|
|
122
|
+
configure(proxy) {
|
|
123
|
+
proxy.on('proxyReq', (requete) => requete.removeHeader('accept-encoding'));
|
|
124
|
+
proxy.on('proxyRes', (reponseDuCore, _requete, reponse) => {
|
|
125
|
+
const morceaux = [];
|
|
126
|
+
reponseDuCore.on('data', (morceau) => morceaux.push(morceau));
|
|
127
|
+
reponseDuCore.on('end', () => {
|
|
128
|
+
const css = Buffer.concat(morceaux).toString('utf8').replaceAll(`${origineDuCore}/theme/`, '/theme/');
|
|
129
|
+
reponse.writeHead(reponseDuCore.statusCode ?? 502, { 'content-type': reponseDuCore.headers['content-type'] ?? 'text/css; charset=utf-8', 'cache-control': 'no-store' });
|
|
130
|
+
reponse.end(css);
|
|
131
|
+
});
|
|
132
|
+
});
|
|
133
|
+
},
|
|
134
|
+
};
|
|
135
|
+
// Le premier relais qui prend le chemin le sert : `variables.css` avant le reste du thème.
|
|
136
|
+
const relais = {
|
|
137
|
+
'^/theme/variables\\.css': variablesDuCore,
|
|
138
|
+
'^/(connexion|deconnexion|auth/|mot-de-passe|espace/|theme/)': versLeCore,
|
|
139
|
+
};
|
|
140
|
+
if (options.base !== '/') {
|
|
141
|
+
relais[`^${options.base}`] = {
|
|
142
|
+
target: new URL(options.app).origin,
|
|
143
|
+
// La page elle-même et ses modules restent au serveur de développement.
|
|
144
|
+
bypass: (requete) => (requete.method === 'POST' ? undefined : requete.url),
|
|
145
|
+
rewrite: (chemin) => chemin.slice(options.base.length - 1),
|
|
146
|
+
};
|
|
147
|
+
}
|
|
148
|
+
return relais;
|
|
149
|
+
}
|
|
150
|
+
// Sert la page de la pièce à chaud sur `http://localhost:5173`, reliée au core de `core` (le banc
|
|
151
|
+
// d'essai ou un core local) et, pour une app, à l'app lancée en local à `app`. Après la connexion,
|
|
152
|
+
// le core ramène à `/` : pour une app, la racine mène à son premier écran.
|
|
153
|
+
export async function developperLaPage(dossier, options) {
|
|
154
|
+
const piece = lirePiece(dossier);
|
|
155
|
+
const racine = {
|
|
156
|
+
name: 'indos:racine-en-developpement',
|
|
157
|
+
configureServer(serveur) {
|
|
158
|
+
serveur.middlewares.use((requete, reponse, suite) => {
|
|
159
|
+
const [chemin] = (requete.url ?? '/').split('?');
|
|
160
|
+
if (piece.base !== '/' && requete.method === 'GET' && (chemin === '/' || chemin === piece.base || `${chemin}/` === piece.base)) {
|
|
161
|
+
reponse.writeHead(302, { location: piece.premierEcran });
|
|
162
|
+
reponse.end();
|
|
163
|
+
return;
|
|
164
|
+
}
|
|
165
|
+
suite();
|
|
166
|
+
});
|
|
167
|
+
},
|
|
168
|
+
};
|
|
169
|
+
const config = configuration(dossier, piece.base);
|
|
170
|
+
const serveur = await createServer({
|
|
171
|
+
...config,
|
|
172
|
+
mode: 'development',
|
|
173
|
+
plugins: [...(config.plugins ?? []), racine],
|
|
174
|
+
server: { ...config.server, port: portDeDeveloppement, strictPort: true, proxy: relais({ base: piece.base, core: options.core, app: options.app }) },
|
|
175
|
+
});
|
|
176
|
+
await serveur.listen();
|
|
177
|
+
serveur.printUrls();
|
|
178
|
+
return serveur;
|
|
179
|
+
}
|
|
180
|
+
// Lance les tests du navigateur de la pièce, `tests/espace/**/*.test.tsx`, une fois, par Vitest,
|
|
181
|
+
// dans le DOM de jsdom, avec les dépendances du navigateur et de ses tests résolues depuis la
|
|
182
|
+
// bibliothèque. La bibliothèque passe par Vite, qui lit la feuille qu'importe sa coquille : installée
|
|
183
|
+
// dans `node_modules`, Node la chargerait seule. Un test qui échoue fait échouer la commande.
|
|
184
|
+
export async function testerLaPage(dossier) {
|
|
185
|
+
const vitest = await startVitest([], {
|
|
186
|
+
root: dossier,
|
|
187
|
+
run: true,
|
|
188
|
+
watch: false,
|
|
189
|
+
include: ['tests/espace/**/*.test.tsx'],
|
|
190
|
+
environment: 'jsdom',
|
|
191
|
+
globals: true,
|
|
192
|
+
server: { deps: { inline: [/[\\/]@indos[\\/]bibliotheque[\\/]/] } },
|
|
193
|
+
}, { plugins: [react(), reglesDeLaPage()], cacheDir: join(dossier, 'node_modules/.vite') });
|
|
194
|
+
await vitest.close();
|
|
195
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
{
|
|
2
|
+
"compilerOptions": {
|
|
3
|
+
"target": "esnext",
|
|
4
|
+
"module": "esnext",
|
|
5
|
+
"moduleResolution": "bundler",
|
|
6
|
+
"lib": [
|
|
7
|
+
"esnext",
|
|
8
|
+
"dom",
|
|
9
|
+
"dom.iterable"
|
|
10
|
+
],
|
|
11
|
+
"jsx": "react-jsx",
|
|
12
|
+
"strict": true,
|
|
13
|
+
"noEmit": true,
|
|
14
|
+
"allowImportingTsExtensions": true,
|
|
15
|
+
"erasableSyntaxOnly": true,
|
|
16
|
+
"verbatimModuleSyntax": true,
|
|
17
|
+
"types": [],
|
|
18
|
+
"skipLibCheck": true,
|
|
19
|
+
"noUncheckedSideEffectImports": false,
|
|
20
|
+
"resolveJsonModule": true,
|
|
21
|
+
"paths": {
|
|
22
|
+
"*": [
|
|
23
|
+
"../../@types/*",
|
|
24
|
+
"../../*",
|
|
25
|
+
"./node_modules/@types/*",
|
|
26
|
+
"./node_modules/*"
|
|
27
|
+
]
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|