@nodefony/frontend 10.0.0-beta.4 → 10.0.0-beta.6

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.
@@ -1,4 +1,4 @@
1
- // \0@oxc-project+runtime@0.155.0/helpers/esm/decorate.js
1
+ // \0@oxc-project+runtime@0.157.0/helpers/esm/decorate.js
2
2
  function __decorate(decorators, target, key, desc) {
3
3
  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
4
  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
package/dist/index.js CHANGED
@@ -1,21 +1,21 @@
1
1
  import config, { frontendConfigSchema } from "./nodefony/config/config.js";
2
2
  import { defineFrontendConfig, frontendConfigJsonSchema } from "./nodefony/config/defineModuleConfig.js";
3
- import { FrontendError, FrontendNoEntriesError, FrontendPresetUnknownError, FrontendSupervisorStartError } from "./nodefony/src/errors/FrontendError.js";
4
- import react19Preset from "./nodefony/src/presets/react19-vite.js";
5
- import vue3Preset from "./nodefony/src/presets/vue3-vite.js";
6
- import angularPreset from "./nodefony/src/presets/angular-vite.js";
7
- import vanillaPreset from "./nodefony/src/presets/vanilla-vite.js";
8
- import svelte5Preset from "./nodefony/src/presets/svelte5-vite.js";
9
- import { ViteBuilder } from "./nodefony/src/builders/ViteBuilder.js";
10
- import { ViteConfigGenerator } from "./nodefony/service/ViteConfigGenerator.js";
11
- import { ViteProcessSupervisor } from "./nodefony/service/ViteProcessSupervisor.js";
12
- import { TemplateHelper } from "./nodefony/src/template/TemplateHelper.js";
13
- import __decorate from "./_virtual/_@oxc-project_runtime@0.155.0/helpers/esm/decorate.js";
14
3
  import FrontendService_default from "./nodefony/service/FrontendService.js";
15
4
  import { buildFrontendStatus, createFrontendAdminApi } from "./nodefony/src/FrontendAdminApi.js";
16
5
  import FrontendBuild from "./nodefony/command/frontend-build.js";
17
6
  import FrontendDev from "./nodefony/command/frontend-dev.js";
18
7
  import FrontendStatus from "./nodefony/command/frontend-status.js";
8
+ import __decorate from "./_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.js";
9
+ import { ViteBuilder } from "./nodefony/src/builders/ViteBuilder.js";
10
+ import { ViteProcessSupervisor } from "./nodefony/service/ViteProcessSupervisor.js";
11
+ import { ViteConfigGenerator } from "./nodefony/service/ViteConfigGenerator.js";
12
+ import { TemplateHelper } from "./nodefony/src/template/TemplateHelper.js";
13
+ import react19Preset from "./nodefony/src/presets/react19-vite.js";
14
+ import vue3Preset from "./nodefony/src/presets/vue3-vite.js";
15
+ import angularPreset from "./nodefony/src/presets/angular-vite.js";
16
+ import vanillaPreset from "./nodefony/src/presets/vanilla-vite.js";
17
+ import svelte5Preset from "./nodefony/src/presets/svelte5-vite.js";
18
+ import { FrontendError, FrontendNoEntriesError, FrontendPresetUnknownError, FrontendSupervisorStartError } from "./nodefony/src/errors/FrontendError.js";
19
19
  import { Module, services } from "nodefony";
20
20
  // index.ts
21
21
  let Frontend = class Frontend extends Module {
@@ -1,11 +1,11 @@
1
- import config from "../config/config.js";
2
- import { FrontendNoEntriesError, FrontendSupervisorStartError } from "../src/errors/FrontendError.js";
3
1
  import { ViteBuilder } from "../src/builders/ViteBuilder.js";
4
2
  import { ViteProcessSupervisor } from "./ViteProcessSupervisor.js";
5
3
  import { TemplateHelper } from "../src/template/TemplateHelper.js";
4
+ import { FrontendNoEntriesError, FrontendSupervisorStartError } from "../src/errors/FrontendError.js";
6
5
  import { devBasePath, familyPortPlan, isolationGroup } from "../src/isolationGroups.js";
6
+ import config from "../config/config.js";
7
7
  import { summarizeFrontendBoot } from "./bootSummary.js";
8
- import __decorate from "../../_virtual/_@oxc-project_runtime@0.155.0/helpers/esm/decorate.js";
8
+ import __decorate from "../../_virtual/_@oxc-project_runtime@0.157.0/helpers/esm/decorate.js";
9
9
  import { FRONTEND_CHOICES, Service, extend, injectable, stripTrailingSlashes } from "nodefony";
10
10
  import path from "node:path";
11
11
  import fs from "node:fs";
@@ -291,7 +291,8 @@ let FrontendService = class FrontendService extends Service {
291
291
  target: () => helper.devTarget(),
292
292
  websocket: true,
293
293
  methods: ["GET", "HEAD"],
294
- stripHeaders: ["cookie", "authorization"]
294
+ stripHeaders: ["cookie", "authorization"],
295
+ accessLog: "errors"
295
296
  });
296
297
  }
297
298
  /**
@@ -344,7 +345,7 @@ let FrontendService = class FrontendService extends Service {
344
345
  this.supervisors.clear();
345
346
  this.templateHelpers.clear();
346
347
  this.entryFamily.clear();
347
- (this.container?.get("firewall"))?.unregisterCspOrigins?.("frontend");
348
+ this.get("firewall")?.unregisterCspOrigins?.("frontend");
348
349
  this.fire("frontend:stopped");
349
350
  }
350
351
  /**
@@ -479,7 +480,7 @@ let FrontendService = class FrontendService extends Service {
479
480
  * No-op si security absent (app sans firewall).
480
481
  */
481
482
  #registerCsp() {
482
- (this.container?.get("firewall"))?.registerCspOrigins?.("frontend", this.#viteCspFragment());
483
+ this.get("firewall")?.registerCspOrigins?.("frontend", this.#viteCspFragment());
483
484
  }
484
485
  /**
485
486
  * Fragment CSP des besoins Vite DEV — sans aucune origine : modules,
@@ -502,10 +503,7 @@ let FrontendService = class FrontendService extends Service {
502
503
  "img-src": [
503
504
  "'self'",
504
505
  "data:",
505
- "blob:",
506
- "https://www.gravatar.com",
507
- "https://*.googleusercontent.com",
508
- "https://avatars.githubusercontent.com"
506
+ "blob:"
509
507
  ],
510
508
  "font-src": ["'self'", "data:"],
511
509
  "connect-src": [
@@ -106,7 +106,7 @@ ${optimizeLines}
106
106
  outDir: ${JSON.stringify(outDir)},
107
107
  manifest: true,
108
108
  emptyOutDir: true,
109
- rollupOptions: {
109
+ rolldownOptions: {
110
110
  input: {
111
111
  ${inputLines}
112
112
  },
@@ -118,6 +118,22 @@ function startupTimeoutMessage(timeoutMs, observed) {
118
118
  return isPortInUseMessage(observed) ? `EADDRINUSE: ${base} — vite a annoncé un port occupé sans rendre la main` : base;
119
119
  }
120
120
  /**
121
+ * Message d'un vite sorti AVANT d'annoncer son adresse : le code de sortie, suivi de la
122
+ * fin de ce qu'il a écrit. Sans cette fin, la cause (config illisible, dépendance
123
+ * absente, port pris) reste muette — vécu en intégration continue, un rouge que rien ne
124
+ * permettait d'instruire.
125
+ *
126
+ * @param code - code de sortie du process, `null` s'il a été tué par un signal.
127
+ * @param signal - signal qui l'a terminé, s'il y en a un.
128
+ * @param observed - sortie (stdout + stderr) accumulée avant l'arrêt, sans codes ANSI.
129
+ * @returns le message, borné à {@link EXIT_OUTPUT_TAIL_CHARS} caractères de sortie.
130
+ */
131
+ function exitBeforeReadyMessage(code, signal, observed) {
132
+ const base = `vite exited (code=${code}, signal=${signal}) before ready`;
133
+ const tail = observed.trim().slice(-800);
134
+ return tail === "" ? base : `${base} — sortie de vite :\n${tail}`;
135
+ }
136
+ /**
121
137
  * Superviseur Vite résilient — branche POC `poc/frontend-child`.
122
138
  *
123
139
  * Garanties :
@@ -391,7 +407,7 @@ var ViteProcessSupervisor = class {
391
407
  reject(new FrontendSupervisorStartError("arrêt demandé pendant le boot de vite (shutdown, pas une panne)"));
392
408
  return;
393
409
  }
394
- const msg = `vite exited (code=${code}, signal=${signal}) before ready`;
410
+ const msg = exitBeforeReadyMessage(code, signal, buffer);
395
411
  this.state = "errored";
396
412
  this.lastError = msg;
397
413
  if (isPortInUseMessage(buffer)) reject(new FrontendSupervisorStartError("EADDRINUSE: " + msg));
@@ -617,4 +633,4 @@ var ViteProcessSupervisor = class {
617
633
  this.childListeners = [];
618
634
  }
619
635
  };
620
- export { ViteProcessSupervisor, ViteProcessSupervisor as default, browserReachableHost, isPortInUseMessage, startupTimeoutMessage };
636
+ export { ViteProcessSupervisor, ViteProcessSupervisor as default, browserReachableHost, exitBeforeReadyMessage, isPortInUseMessage, startupTimeoutMessage };
@@ -4,6 +4,7 @@ import vue3Preset from "../presets/vue3-vite.js";
4
4
  import angularPreset from "../presets/angular-vite.js";
5
5
  import vanillaPreset from "../presets/vanilla-vite.js";
6
6
  import svelte5Preset from "../presets/svelte5-vite.js";
7
+ import { buildReportDevtools } from "nodefony";
7
8
  import path from "node:path";
8
9
  // nodefony/src/builders/ViteBuilder.ts
9
10
  /**
@@ -103,7 +104,10 @@ var ViteBuilder = class {
103
104
  build: {
104
105
  outDir,
105
106
  manifest: true,
106
- rollupOptions: { input },
107
+ rolldownOptions: {
108
+ input,
109
+ devtools: buildReportDevtools()
110
+ },
107
111
  emptyOutDir: true
108
112
  },
109
113
  server: {
@@ -6,28 +6,34 @@
6
6
  * les familles distinctes tournent dans des **process Vite séparés** (multi-
7
7
  * supervisor).
8
8
  *
9
- * **Le motif est toujours le même : un plugin qui transforme ce qui ne lui
10
- * appartient pas.** Deux familles le paient aujourd'hui.
9
+ * Deux familles sont isolées, pour deux raisons différentes.
11
10
  *
12
- * Angular : son plugin (`@analogjs/vite-plugin-angular`) transforme **tout**
13
- * fichier `.ts` du serveur de développement — y compris ceux des autres bundles
14
- * (ex. stores MobX à décorateurs). Mélangé aux autres, il throw sur des fichiers
15
- * hors de son tsconfig → erreurs de compilation + boucle de rechargement.
11
+ * Angular : historiquement, son plugin (`@analogjs/vite-plugin-angular`)
12
+ * transformait **tout** `.ts` du serveur et levait sur ceux des autres bundles
13
+ * (stores MobX de Studio) — erreurs + boucle de rechargement. Ce n'est plus le
14
+ * cas (analogjs 2.9.6, Vite 8.3.6 : dans l'instance partagée, HMR à chaud sur
15
+ * React, Svelte, Angular, une page ET un store de Studio, sans erreur ni
16
+ * boucle). Il reste isolé pour le COÛT : son compilateur rend l'instance prête
17
+ * en ~2,6 s au lieu de 0,5-0,7 s, et le superviseur relance les Vite à chaque
18
+ * modification du backend — Studio et React attendraient ~2 s de plus à chaque
19
+ * fois, pour un process et ~100 Mo économisés. Isolé, il démarre en parallèle.
16
20
  *
17
- * Vue : le compilateur de composants monofichiers sert le bloc script sous un
18
- * identifiant qui se TERMINE par `.ts`
19
- * (`App.vue?vue&type=script&setup=true&lang.ts`). Le filtre de
20
- * `@vitejs/plugin-react` y mord — il est élargi aux identifiants portant une
21
- * query — et injecte son `$RefreshSig$()`, que rien ne définit sur une page sans
22
- * préambule React : la vitrine Vue ne se montait plus du tout
23
- * (`ReferenceError: $RefreshSig$ is not defined`).
21
+ * Vue : `@vitejs/plugin-react` pose une option oxc GLOBALE
22
+ * (`oxc.jsx.refresh: true`) que le compilateur de Vite neutralise lui-même sur
23
+ * tout fichier qui n'est pas du JSX. `@vitejs/plugin-vue` contourne cette
24
+ * garde : il compile le TypeScript d'un composant en appelant directement
25
+ * `transformWithOxc(…, { ...devServer.config.oxc, lang: "ts" })` (sa fonction
26
+ * `transformMain`), option brute comprise. oxc injecte alors `$RefreshSig$()`
27
+ * dans les fonctions de forme hook du `setup` — que rien ne définit sur une
28
+ * page sans préambule React : la vitrine Vue ne se monte plus
29
+ * (`ReferenceError: $RefreshSig$ is not defined`). Défaut de plugin-vue, suivi
30
+ * en amont : https://github.com/vitejs/vite-plugin-vue/issues/798 (constaté
31
+ * sur plugin-vue 6.0.10, plugin-react 6.2.1, Vite 8.3.6).
24
32
  *
25
- * ⚠️ Il a longtemps été écrit ici que « React / Vue / vanilla ciblent des
26
- * extensions disjointes ». C'était faux, et c'est ce qui a fait chercher
27
- * ailleurs. Passer `exclude: [/\.vue/]` à `@vitejs/plugin-react` **ne suffit
28
- * pas** : mesuré sur Vite 8.2.2, l'injection persiste jusqu'à `exclude: [/./]`
29
- * inclus — l'option ne borne pas ce chemin. Seule l'isolation en process
30
- * distinct l'arrête.
33
+ * ⚠️ Aucun filtre du greffon React n'y peut rien (`exclude: [/./]` compris) :
34
+ * l'option est globale, et couper `refresh` casserait le HMR de React. Seule
35
+ * l'isolation en process distinct l'arrête. À lever quand l'amont corrige :
36
+ * la sentinelle `tests/integration/vueRefreshSentinel.test.ts` rougit ce jour-là.
31
37
  *
32
38
  * Svelte, lui, cohabite sans dommage (constaté) : son bloc script n'est pas
33
39
  * servi sous un identifiant qui finit par `.ts`.
@@ -1,5 +1,5 @@
1
1
  import { createRequire } from "node:module";
2
- import { Nodefony, PLATFORM_EVENTS, escapeRegExp } from "nodefony";
2
+ import { Nodefony, PLATFORM_EVENTS, RequestContext, cspNonceMetaTag, escapeRegExp, isPlainObject } from "nodefony";
3
3
  import path from "node:path";
4
4
  import fs from "node:fs";
5
5
  // nodefony/src/template/TemplateHelper.ts
@@ -18,6 +18,31 @@ function basePathOf(status) {
18
18
  * (`nodefony/debugbar`). `undefined` = pas encore tenté, `null` = irrésolu.
19
19
  */
20
20
  let debugbarFile;
21
+ const isStringArray = (v) => Array.isArray(v) && v.every((x) => typeof x === "string");
22
+ /**
23
+ * Lit la forme d'un `manifest.json` de Vite relu sur disque : un objet dont chaque
24
+ * valeur porte au moins `file`.
25
+ *
26
+ * Une entrée mal formée est écartée — elle rendrait une balise sans fichier ; un
27
+ * document qui n'est pas un objet rend `null`, traité comme un manifeste ABSENT
28
+ * (jamais caché, donc relu au rendu suivant).
29
+ *
30
+ * @param value - le JSON parsé, de forme inconnue.
31
+ * @returns le manifeste réduit aux champs lus par le rendu, ou `null`.
32
+ */
33
+ function toViteManifest(value) {
34
+ if (!isPlainObject(value)) return null;
35
+ const manifest = {};
36
+ for (const [key, raw] of Object.entries(value)) {
37
+ if (!isPlainObject(raw) || typeof raw.file !== "string") continue;
38
+ const chunk = { file: raw.file };
39
+ if (typeof raw.isEntry === "boolean") chunk.isEntry = raw.isEntry;
40
+ if (isStringArray(raw.css)) chunk.css = raw.css;
41
+ if (isStringArray(raw.imports)) chunk.imports = raw.imports;
42
+ manifest[key] = chunk;
43
+ }
44
+ return manifest;
45
+ }
21
46
  /** Marqueur optionnel dans l'`index.html` du module où injecter les tags. */
22
47
  const FRONTEND_MARKER = "<!--nodefony:frontend-->";
23
48
  /** Échappe une string pour usage littéral dans une RegExp. */
@@ -86,10 +111,13 @@ var TemplateHelper = class {
86
111
  * @param entryName nom logique de l'entrée (matche `entryName` dans IResolvedFrontendEntry)
87
112
  * @param nonce nonce CSP de la requête (`Context.cspNonce`) — posé sur les `<script>`
88
113
  * pour satisfaire `script-src 'nonce-…'` (preamble inline dev + entrée prod).
114
+ * Les balises sont précédées de `<meta property="csp-nonce">` (ADR-0024 §C2) : le client de
115
+ * Vite y lit le nonce des `<style>` du rechargement à chaud, `readCspNonce`
116
+ * (`nodefony/client`) celui des styles créés à l'exécution.
89
117
  */
90
118
  renderTags(entryName, nonce) {
91
- if (this.mode === "development") return this.renderDevTags(entryName, nonce);
92
- return this.renderProdTags(entryName, nonce);
119
+ const tags = this.mode === "development" ? this.renderDevTags(entryName, nonce) : this.renderProdTags(entryName, nonce);
120
+ return nonce ? `${cspNonceMetaTag(nonce)}\n${tags}` : tags;
93
121
  }
94
122
  /**
95
123
  * Document HTML complet pour une entrée : lit l'`index.html` du module (le dev
@@ -163,10 +191,10 @@ window.$RefreshSig$ = () => (type) => type;
163
191
  window.__vite_plugin_react_preamble_installed__ = true;
164
192
  <\/script>`);
165
193
  tags.push(`<script type="module"${n} src="${baseUrl}/@vite/client"><\/script>`);
166
- tags.push(`<script type="module"${n} src="${entryUrl}"><\/script>`);
167
- tags.push(this.hmrBridgeTag(baseUrl, n));
168
194
  const dbg = this.debugBarTag(baseUrl, entry.type, entryName, n);
169
195
  if (dbg) tags.push(dbg);
196
+ tags.push(`<script type="module"${n} src="${entryUrl}"><\/script>`);
197
+ tags.push(this.hmrBridgeTag(baseUrl, n));
170
198
  return tags.join("\n");
171
199
  }
172
200
  /**
@@ -210,13 +238,15 @@ try {
210
238
  if (!debugbarFile) return `<!-- @nodefony/frontend: debugbar unresolved -->`;
211
239
  const norm = debugbarFile.replace(/\\/g, "/");
212
240
  const fsUrl = `${baseUrl}${norm.startsWith("/") ? `/@fs${norm}` : `/@fs/${norm}`}`;
241
+ const requestId = RequestContext.getRequestId();
213
242
  const opts = JSON.stringify({
214
243
  frontend: {
215
244
  framework,
216
245
  name: entryName,
217
246
  viteOrigin: baseUrl
218
247
  },
219
- env: Nodefony.getKernel()?.environment ?? ""
248
+ env: Nodefony.getKernel()?.environment ?? "",
249
+ ...requestId ? { page: { requestId } } : {}
220
250
  });
221
251
  return `<script type="module"${nonceAttr}>
222
252
  import { mountDebugBar } from ${JSON.stringify(fsUrl)};
@@ -263,8 +293,8 @@ mountDebugBar(${opts});
263
293
  let parsed = null;
264
294
  for (const rel of [".vite/manifest.json", "manifest.json"]) try {
265
295
  const raw = fs.readFileSync(path.join(outDir, rel), "utf8");
266
- parsed = JSON.parse(raw);
267
- break;
296
+ parsed = toViteManifest(JSON.parse(raw));
297
+ if (parsed !== null) break;
268
298
  } catch {}
269
299
  if (parsed !== null) this.manifestCache.set(outDir, parsed);
270
300
  return parsed;
@@ -123,6 +123,18 @@ export declare function isPortInUseMessage(text: string): boolean;
123
123
  * @returns message d'erreur, préfixé `EADDRINUSE:` si un port occupé est dénoncé.
124
124
  */
125
125
  export declare function startupTimeoutMessage(timeoutMs: number, observed: string): string;
126
+ /**
127
+ * Message d'un vite sorti AVANT d'annoncer son adresse : le code de sortie, suivi de la
128
+ * fin de ce qu'il a écrit. Sans cette fin, la cause (config illisible, dépendance
129
+ * absente, port pris) reste muette — vécu en intégration continue, un rouge que rien ne
130
+ * permettait d'instruire.
131
+ *
132
+ * @param code - code de sortie du process, `null` s'il a été tué par un signal.
133
+ * @param signal - signal qui l'a terminé, s'il y en a un.
134
+ * @param observed - sortie (stdout + stderr) accumulée avant l'arrêt, sans codes ANSI.
135
+ * @returns le message, borné à {@link EXIT_OUTPUT_TAIL_CHARS} caractères de sortie.
136
+ */
137
+ export declare function exitBeforeReadyMessage(code: number | null, signal: string | null, observed: string): string;
126
138
  /**
127
139
  * Superviseur Vite résilient — branche POC `poc/frontend-child`.
128
140
  *
@@ -5,28 +5,34 @@
5
5
  * les familles distinctes tournent dans des **process Vite séparés** (multi-
6
6
  * supervisor).
7
7
  *
8
- * **Le motif est toujours le même : un plugin qui transforme ce qui ne lui
9
- * appartient pas.** Deux familles le paient aujourd'hui.
8
+ * Deux familles sont isolées, pour deux raisons différentes.
10
9
  *
11
- * Angular : son plugin (`@analogjs/vite-plugin-angular`) transforme **tout**
12
- * fichier `.ts` du serveur de développement — y compris ceux des autres bundles
13
- * (ex. stores MobX à décorateurs). Mélangé aux autres, il throw sur des fichiers
14
- * hors de son tsconfig → erreurs de compilation + boucle de rechargement.
10
+ * Angular : historiquement, son plugin (`@analogjs/vite-plugin-angular`)
11
+ * transformait **tout** `.ts` du serveur et levait sur ceux des autres bundles
12
+ * (stores MobX de Studio) — erreurs + boucle de rechargement. Ce n'est plus le
13
+ * cas (analogjs 2.9.6, Vite 8.3.6 : dans l'instance partagée, HMR à chaud sur
14
+ * React, Svelte, Angular, une page ET un store de Studio, sans erreur ni
15
+ * boucle). Il reste isolé pour le COÛT : son compilateur rend l'instance prête
16
+ * en ~2,6 s au lieu de 0,5-0,7 s, et le superviseur relance les Vite à chaque
17
+ * modification du backend — Studio et React attendraient ~2 s de plus à chaque
18
+ * fois, pour un process et ~100 Mo économisés. Isolé, il démarre en parallèle.
15
19
  *
16
- * Vue : le compilateur de composants monofichiers sert le bloc script sous un
17
- * identifiant qui se TERMINE par `.ts`
18
- * (`App.vue?vue&type=script&setup=true&lang.ts`). Le filtre de
19
- * `@vitejs/plugin-react` y mord — il est élargi aux identifiants portant une
20
- * query — et injecte son `$RefreshSig$()`, que rien ne définit sur une page sans
21
- * préambule React : la vitrine Vue ne se montait plus du tout
22
- * (`ReferenceError: $RefreshSig$ is not defined`).
20
+ * Vue : `@vitejs/plugin-react` pose une option oxc GLOBALE
21
+ * (`oxc.jsx.refresh: true`) que le compilateur de Vite neutralise lui-même sur
22
+ * tout fichier qui n'est pas du JSX. `@vitejs/plugin-vue` contourne cette
23
+ * garde : il compile le TypeScript d'un composant en appelant directement
24
+ * `transformWithOxc(…, { ...devServer.config.oxc, lang: "ts" })` (sa fonction
25
+ * `transformMain`), option brute comprise. oxc injecte alors `$RefreshSig$()`
26
+ * dans les fonctions de forme hook du `setup` — que rien ne définit sur une
27
+ * page sans préambule React : la vitrine Vue ne se monte plus
28
+ * (`ReferenceError: $RefreshSig$ is not defined`). Défaut de plugin-vue, suivi
29
+ * en amont : https://github.com/vitejs/vite-plugin-vue/issues/798 (constaté
30
+ * sur plugin-vue 6.0.10, plugin-react 6.2.1, Vite 8.3.6).
23
31
  *
24
- * ⚠️ Il a longtemps été écrit ici que « React / Vue / vanilla ciblent des
25
- * extensions disjointes ». C'était faux, et c'est ce qui a fait chercher
26
- * ailleurs. Passer `exclude: [/\.vue/]` à `@vitejs/plugin-react` **ne suffit
27
- * pas** : mesuré sur Vite 8.2.2, l'injection persiste jusqu'à `exclude: [/./]`
28
- * inclus — l'option ne borne pas ce chemin. Seule l'isolation en process
29
- * distinct l'arrête.
32
+ * ⚠️ Aucun filtre du greffon React n'y peut rien (`exclude: [/./]` compris) :
33
+ * l'option est globale, et couper `refresh` casserait le HMR de React. Seule
34
+ * l'isolation en process distinct l'arrête. À lever quand l'amont corrige :
35
+ * la sentinelle `tests/integration/vueRefreshSentinel.test.ts` rougit ce jour-là.
30
36
  *
31
37
  * Svelte, lui, cohabite sans dommage (constaté) : son bloc script n'est pas
32
38
  * servi sous un identifiant qui finit par `.ts`.
@@ -53,6 +53,9 @@ export declare class TemplateHelper {
53
53
  * @param entryName nom logique de l'entrée (matche `entryName` dans IResolvedFrontendEntry)
54
54
  * @param nonce nonce CSP de la requête (`Context.cspNonce`) — posé sur les `<script>`
55
55
  * pour satisfaire `script-src 'nonce-…'` (preamble inline dev + entrée prod).
56
+ * Les balises sont précédées de `<meta property="csp-nonce">` (ADR-0024 §C2) : le client de
57
+ * Vite y lit le nonce des `<style>` du rechargement à chaud, `readCspNonce`
58
+ * (`nodefony/client`) celui des styles créés à l'exécution.
56
59
  */
57
60
  renderTags(entryName: string, nonce?: string): string;
58
61
  /**
package/docs/index.md CHANGED
@@ -690,6 +690,33 @@ Ce qui est injecté en développement (`TemplateHelper.renderDevTags()`, `Templa
690
690
  Quand Vite n'est pas prêt, le rendu ne lève **jamais** : il renvoie un commentaire HTML disant
691
691
  l'état. Une page dégradée reste une page.
692
692
 
693
+ ### Une route profonde, et la touche F5
694
+
695
+ Ton application monopage navigue côté navigateur : `/commandes/42` n'est qu'un état de l'écran. Mais
696
+ au premier chargement — un lien partagé, un F5 —, c'est le **serveur** qui reçoit ce chemin, et sans
697
+ route qui rende la page il répond 404. Le contrôleur de la page doit donc servir aussi les chemins
698
+ profonds, par une route de **repli** :
699
+
700
+ ```ts ignore
701
+ // Dans le contrôleur qui rend la page (AppController d'une application générée)
702
+ @route("route-app-commandes", {
703
+ path: "/commandes/*",
704
+ method: "GET",
705
+ fallback: true,
706
+ })
707
+ renderDeep(): unknown {
708
+ return this.renderApp();
709
+ }
710
+ ```
711
+
712
+ `fallback: true` range la route **après toutes les autres** (`Route.ts#RouteOptions.fallback`) : une
713
+ route d'API de même forme, déclarée par n'importe quel module, garde la priorité — voir
714
+ [l'ordre de résolution](../../framework/docs/routing.md#-ordre-de-résolution--trois-situations).
715
+ Deux détails : `/commandes/*` n'attrape pas `/commandes` lui-même (la barre oblique est requise),
716
+ qui demande sa propre route ; et un repli à la **racine** (`/*`) transformerait toute faute de
717
+ frappe — une URL d'API, un fichier absent — en page HTML servie en 200. Borne le repli aux
718
+ préfixes de ton application.
719
+
693
720
  ### Les helpers de vue
694
721
 
695
722
  Si tu rends une vue Eta plutôt qu'une chaîne, trois helpers sont déjà dans tes variables locales
@@ -903,6 +930,10 @@ apparaisse avant le « prêt ».
903
930
  | `Refused to load the script` (politique de sécurité) | page rendue avant que Vite soit prêt : le fragment de développement n'est pas encore déclaré | recharger une fois Vite prêt ; vérifier que le nonce est bien propagé |
904
931
  | Commentaire `prod manifest missing` dans la page | les bundles n'ont pas été construits, et Vite n'était pas là pour le faire au démarrage | `npm run build` (ou `npx nodefony frontend:build`) puis **recharge la page** — l'absence de manifeste n'est jamais mise en cache (`loadManifest()`, `TemplateHelper.ts#TemplateHelper.loadManifest`), le serveur voit le build sans redémarrer |
905
932
  | Les assets répondent 404 en production | le serveur statique est absent ou le préfixe ne correspond pas | vérifier le montage journalisé au démarrage, et `publicPath` |
933
+ | Après un `frontend:build` lancé serveur démarré, la page demande des fichiers en 404 | un manifeste TROUVÉ est gardé pour toute la vie du processus (`loadManifest()`, `TemplateHelper.ts#TemplateHelper.loadManifest`), et le build vide le dossier de sortie : la page désigne des fichiers effacés | redémarrer après tout build en production ; en déploiement réel, le build se fait à l'image, avant le démarrage |
934
+ | Après un redéploiement, un onglet resté ouvert casse au changement d'écran (`Failed to fetch dynamically imported module`) | il demande les morceaux de la génération précédente, dont les noms hachés n'existent plus | écouter l'événement `vite:preloadError` et recharger la page **une** fois, avec une garde anti-boucle — ce que fait la console d'administration (`staleChunk.ts#lazyRoute`) |
935
+ | Un import hors du dossier front est refusé par Vite (403) | le serveur de développement n'ouvre que le dossier de l'application, la racine de chaque entrée et la barre de débogage (`ViteConfigGenerator.toMjs()`, `ViteConfigGenerator.ts#ViteConfigGenerator.toMjs`) | placer la ressource sous l'une de ces racines |
936
+ | F5 sur une page profonde de l'application rend 404 | aucune route serveur ne rend la page pour ce chemin | une route de repli — voir [Une route profonde, et la touche F5](#une-route-profonde-et-la-touche-f5) |
906
937
  | Un module à interface est invisible de `listEntries()` | il est en mode `static` — il n'appelle jamais `registerEntry` | attendu ; regarder la molette `ui` et le mode journalisé au démarrage |
907
938
  | Modifications du front sans effet | `vite.config.generated.mjs` édité à la main | ne jamais l'éditer : il est réécrit à chaque démarrage |
908
939
  | Angular recharge la page entière au lieu du composant | son greffon ne fait pas de remplacement à chaud | attendu — c'est le comportement du greffon Angular |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nodefony/frontend",
3
- "version": "10.0.0-beta.4",
3
+ "version": "10.0.0-beta.6",
4
4
  "description": "Construction et rechargement à chaud des frontends de chaque module Nodefony — Vite intégré, multi-framework (React, Vue, Angular, Svelte)",
5
5
  "author": "Christophe CAMENSULI <ccamensuli@gmail.com>",
6
6
  "type": "module",
@@ -36,20 +36,20 @@
36
36
  "esm"
37
37
  ],
38
38
  "peerDependencies": {
39
- "@nodefony/framework": "^10.0.0-beta.4",
40
- "@nodefony/http": "^10.0.0-beta.4",
41
- "nodefony": "^10.0.0-beta.4",
39
+ "@nodefony/framework": "^10.0.0-beta.6",
40
+ "@nodefony/http": "^10.0.0-beta.6",
41
+ "nodefony": "^10.0.0-beta.6",
42
42
  "zod": "^4.6.7"
43
43
  },
44
44
  "devDependencies": {
45
- "@nodefony/framework": "^10.0.0-beta.4",
46
- "@nodefony/http": "^10.0.0-beta.4",
45
+ "@nodefony/framework": "^10.0.0-beta.6",
46
+ "@nodefony/http": "^10.0.0-beta.6",
47
47
  "@types/chai": "5.2.3",
48
- "@types/node": "26.6.5",
49
- "@vitest/coverage-v8": "5.0.5",
50
- "nodefony": "^10.0.0-beta.4",
51
- "vite": "8.3.5",
52
- "vitest": "5.0.5"
48
+ "@types/node": "26.6.6",
49
+ "@vitest/coverage-v8": "5.1.0",
50
+ "nodefony": "^10.0.0-beta.6",
51
+ "vite": "8.3.6",
52
+ "vitest": "5.1.0"
53
53
  },
54
54
  "private": false,
55
55
  "engines": {
@@ -57,7 +57,7 @@
57
57
  },
58
58
  "license": "Apache-2.0",
59
59
  "dependencies": {
60
- "tslib": "2.8.1"
60
+ "tslib": "2.9.1"
61
61
  },
62
62
  "files": [
63
63
  "dist",