@nodefony/frontend 10.0.0-beta.5 → 10.0.0-beta.7

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.158.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.158.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.158.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";
@@ -248,6 +248,7 @@ let FrontendService = class FrontendService extends Service {
248
248
  logger: {
249
249
  info: (m) => this.log(`[${family}] ${m}`, "INFO"),
250
250
  error: (m) => this.log(`[${family}] ${m}`, "ERROR"),
251
+ warn: (m) => this.log(`[${family}] ${m}`, "WARNING"),
251
252
  debug: (m) => this.log(`[${family}] ${m}`, "DEBUG")
252
253
  }
253
254
  });
@@ -345,7 +346,7 @@ let FrontendService = class FrontendService extends Service {
345
346
  this.supervisors.clear();
346
347
  this.templateHelpers.clear();
347
348
  this.entryFamily.clear();
348
- (this.container?.get("firewall"))?.unregisterCspOrigins?.("frontend");
349
+ this.get("firewall")?.unregisterCspOrigins?.("frontend");
349
350
  this.fire("frontend:stopped");
350
351
  }
351
352
  /**
@@ -480,7 +481,7 @@ let FrontendService = class FrontendService extends Service {
480
481
  * No-op si security absent (app sans firewall).
481
482
  */
482
483
  #registerCsp() {
483
- (this.container?.get("firewall"))?.registerCspOrigins?.("frontend", this.#viteCspFragment());
484
+ this.get("firewall")?.registerCspOrigins?.("frontend", this.#viteCspFragment());
484
485
  }
485
486
  /**
486
487
  * Fragment CSP des besoins Vite DEV — sans aucune origine : modules,
@@ -503,10 +504,7 @@ let FrontendService = class FrontendService extends Service {
503
504
  "img-src": [
504
505
  "'self'",
505
506
  "data:",
506
- "blob:",
507
- "https://www.gravatar.com",
508
- "https://*.googleusercontent.com",
509
- "https://avatars.githubusercontent.com"
507
+ "blob:"
510
508
  ],
511
509
  "font-src": ["'self'", "data:"],
512
510
  "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
  },
@@ -94,6 +94,22 @@ function isPortInUseMessage(text) {
94
94
  return /EADDRINUSE/i.test(text) || /address already in use/i.test(text) || /port\s+\d+\s+is\s+already\s+in use/i.test(text);
95
95
  }
96
96
  /**
97
+ * Une ligne que Vite écrit sur sa sortie d'ERREUR est-elle un avertissement sur
98
+ * un démarrage RÉUSSI ?
99
+ *
100
+ * Vite émet `Port X is in use on a wildcard address, but H:X is available…` par
101
+ * `logger.warn` (donc sur stderr) après un `listen` qui a RÉUSSI (cf
102
+ * {@link isPortInUseMessage}). Relayée en ERROR, elle laissait une ligne rouge
103
+ * dans un démarrage sain. Vu sous Windows, où la pile réseau signale ce cas
104
+ * quand un autre serveur écoute sur la même plage de ports.
105
+ *
106
+ * @param line - une ligne de sortie, sans codes ANSI ni préfixe `[vite]`.
107
+ * @returns `true` si la ligne doit partir en avertissement, pas en erreur.
108
+ */
109
+ function isViteNonFatalWarning(line) {
110
+ return /port\s+\d+\s+is\s+in use on a wildcard address/i.test(line);
111
+ }
112
+ /**
97
113
  * Message d'échec d'un boot qui n'a jamais rendu la main dans le temps imparti —
98
114
  * en y REPORTANT ce que vite avait déjà dit.
99
115
  *
@@ -118,6 +134,22 @@ function startupTimeoutMessage(timeoutMs, observed) {
118
134
  return isPortInUseMessage(observed) ? `EADDRINUSE: ${base} — vite a annoncé un port occupé sans rendre la main` : base;
119
135
  }
120
136
  /**
137
+ * Message d'un vite sorti AVANT d'annoncer son adresse : le code de sortie, suivi de la
138
+ * fin de ce qu'il a écrit. Sans cette fin, la cause (config illisible, dépendance
139
+ * absente, port pris) reste muette — vécu en intégration continue, un rouge que rien ne
140
+ * permettait d'instruire.
141
+ *
142
+ * @param code - code de sortie du process, `null` s'il a été tué par un signal.
143
+ * @param signal - signal qui l'a terminé, s'il y en a un.
144
+ * @param observed - sortie (stdout + stderr) accumulée avant l'arrêt, sans codes ANSI.
145
+ * @returns le message, borné à {@link EXIT_OUTPUT_TAIL_CHARS} caractères de sortie.
146
+ */
147
+ function exitBeforeReadyMessage(code, signal, observed) {
148
+ const base = `vite exited (code=${code}, signal=${signal}) before ready`;
149
+ const tail = observed.trim().slice(-800);
150
+ return tail === "" ? base : `${base} — sortie de vite :\n${tail}`;
151
+ }
152
+ /**
121
153
  * Superviseur Vite résilient — branche POC `poc/frontend-child`.
122
154
  *
123
155
  * Garanties :
@@ -243,7 +275,7 @@ var ViteProcessSupervisor = class {
243
275
  } catch (e) {
244
276
  lastErr = e instanceof Error ? e : new Error(String(e));
245
277
  if (this.isPortInUseError(lastErr) && i < maxAttempts) {
246
- this.opts.logger.info(`port ${port} unavailable — retrying on ${port + 1}`);
278
+ this.opts.logger.info(`port ${port} déjà occupé — Vite relancé sur ${port + 1}`);
247
279
  this.portRetries += 1;
248
280
  continue;
249
281
  }
@@ -331,6 +363,7 @@ var ViteProcessSupervisor = class {
331
363
  if (resolved) return;
332
364
  resolved = true;
333
365
  this.state = "errored";
366
+ flushStderr();
334
367
  if (child.exitCode === null && child.signalCode === null) this.signalTree(child, "SIGKILL");
335
368
  const msg = startupTimeoutMessage(this.opts.startupTimeoutMs, buffer);
336
369
  this.lastError = msg;
@@ -340,13 +373,21 @@ var ViteProcessSupervisor = class {
340
373
  const ansiRe = /\x1b\[[0-9;]*m/g;
341
374
  const viteOwnPrefixRe = /^\d{1,2}:\d{2}:\d{2}\s+\[vite\]\s*|^\[vite\]\s*/;
342
375
  let buffer = "";
376
+ let heldStderr = "";
377
+ const flushStderr = () => {
378
+ if (heldStderr !== "") pipeClean(heldStderr, "error");
379
+ heldStderr = "";
380
+ };
343
381
  const pipeClean = (raw, level) => {
344
382
  if (!this.opts.pipeLogs) return;
345
383
  for (const line of raw.split(/\r?\n/)) {
346
384
  const stripped = line.replace(ansiRe, "").replace(viteOwnPrefixRe, "").trim();
347
385
  if (!stripped) continue;
348
- if (level === "error") this.opts.logger.error(`[vite] ${stripped}`);
349
- else this.opts.logger.info(`[vite] ${stripped}`);
386
+ const logger = this.opts.logger;
387
+ if (level === "info") logger.info(`[vite] ${stripped}`);
388
+ else if (!isViteNonFatalWarning(stripped)) logger.error(`[vite] ${stripped}`);
389
+ else if (logger.warn) logger.warn(`[vite] ${stripped}`);
390
+ else logger.info(`[vite] ${stripped}`);
350
391
  }
351
392
  };
352
393
  const onStdout = (chunk) => {
@@ -361,14 +402,18 @@ var ViteProcessSupervisor = class {
361
402
  this.healthFailures = 0;
362
403
  resolved = true;
363
404
  buffer = "";
405
+ flushStderr();
364
406
  clearTimeout(timeout);
365
407
  resolve();
366
408
  }
367
409
  };
368
410
  const onStderr = (chunk) => {
369
411
  const txt = chunk.toString();
370
- pipeClean(txt, "error");
371
- if (resolved) return;
412
+ if (resolved) {
413
+ pipeClean(txt, "error");
414
+ return;
415
+ }
416
+ heldStderr += txt;
372
417
  buffer += txt.replace(ansiRe, "");
373
418
  const [, , port] = buffer.match(localRe) ?? [];
374
419
  if (port !== void 0) {
@@ -377,6 +422,7 @@ var ViteProcessSupervisor = class {
377
422
  this.healthFailures = 0;
378
423
  resolved = true;
379
424
  buffer = "";
425
+ flushStderr();
380
426
  clearTimeout(timeout);
381
427
  resolve();
382
428
  }
@@ -386,21 +432,28 @@ var ViteProcessSupervisor = class {
386
432
  resolved = true;
387
433
  clearTimeout(timeout);
388
434
  if (this.willingShutdown) {
435
+ heldStderr = "";
389
436
  this.state = "stopped";
390
437
  this.lastError = null;
391
438
  reject(new FrontendSupervisorStartError("arrêt demandé pendant le boot de vite (shutdown, pas une panne)"));
392
439
  return;
393
440
  }
394
- const msg = `vite exited (code=${code}, signal=${signal}) before ready`;
441
+ const msg = exitBeforeReadyMessage(code, signal, buffer);
395
442
  this.state = "errored";
396
443
  this.lastError = msg;
397
- if (isPortInUseMessage(buffer)) reject(new FrontendSupervisorStartError("EADDRINUSE: " + msg));
398
- else reject(new FrontendSupervisorStartError(msg));
444
+ if (isPortInUseMessage(buffer)) {
445
+ heldStderr = "";
446
+ reject(new FrontendSupervisorStartError("EADDRINUSE: " + msg));
447
+ } else {
448
+ flushStderr();
449
+ reject(new FrontendSupervisorStartError(msg));
450
+ }
399
451
  }
400
452
  };
401
453
  const onError = (err) => {
402
454
  if (resolved) return;
403
455
  resolved = true;
456
+ flushStderr();
404
457
  clearTimeout(timeout);
405
458
  this.state = "errored";
406
459
  this.lastError = err.message;
@@ -617,4 +670,4 @@ var ViteProcessSupervisor = class {
617
670
  this.childListeners = [];
618
671
  }
619
672
  };
620
- export { ViteProcessSupervisor, ViteProcessSupervisor as default, browserReachableHost, isPortInUseMessage, startupTimeoutMessage };
673
+ export { ViteProcessSupervisor, ViteProcessSupervisor as default, browserReachableHost, exitBeforeReadyMessage, isPortInUseMessage, isViteNonFatalWarning, 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, RequestContext, escapeRegExp, isPlainObject } 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
@@ -111,10 +111,13 @@ var TemplateHelper = class {
111
111
  * @param entryName nom logique de l'entrée (matche `entryName` dans IResolvedFrontendEntry)
112
112
  * @param nonce nonce CSP de la requête (`Context.cspNonce`) — posé sur les `<script>`
113
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.
114
117
  */
115
118
  renderTags(entryName, nonce) {
116
- if (this.mode === "development") return this.renderDevTags(entryName, nonce);
117
- 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;
118
121
  }
119
122
  /**
120
123
  * Document HTML complet pour une entrée : lit l'`index.html` du module (le dev
@@ -17,6 +17,11 @@ export declare function browserReachableHost(listenHost: string): string;
17
17
  export interface IViteSupervisorLogger {
18
18
  info(msg: string): void;
19
19
  error(msg: string): void;
20
+ /**
21
+ * Avertissement NON fatal de Vite (cf {@link isViteNonFatalWarning}).
22
+ * Absent → la ligne part en `info`, jamais en `error`.
23
+ */
24
+ warn?(msg: string): void;
20
25
  debug?(msg: string): void;
21
26
  }
22
27
  export interface ViteSupervisorOptions {
@@ -102,6 +107,20 @@ export interface ViteSupervisorOptions {
102
107
  * tenaient en 300 à 700 ms.
103
108
  */
104
109
  export declare function isPortInUseMessage(text: string): boolean;
110
+ /**
111
+ * Une ligne que Vite écrit sur sa sortie d'ERREUR est-elle un avertissement sur
112
+ * un démarrage RÉUSSI ?
113
+ *
114
+ * Vite émet `Port X is in use on a wildcard address, but H:X is available…` par
115
+ * `logger.warn` (donc sur stderr) après un `listen` qui a RÉUSSI (cf
116
+ * {@link isPortInUseMessage}). Relayée en ERROR, elle laissait une ligne rouge
117
+ * dans un démarrage sain. Vu sous Windows, où la pile réseau signale ce cas
118
+ * quand un autre serveur écoute sur la même plage de ports.
119
+ *
120
+ * @param line - une ligne de sortie, sans codes ANSI ni préfixe `[vite]`.
121
+ * @returns `true` si la ligne doit partir en avertissement, pas en erreur.
122
+ */
123
+ export declare function isViteNonFatalWarning(line: string): boolean;
105
124
  /**
106
125
  * Message d'échec d'un boot qui n'a jamais rendu la main dans le temps imparti —
107
126
  * en y REPORTANT ce que vite avait déjà dit.
@@ -123,6 +142,18 @@ export declare function isPortInUseMessage(text: string): boolean;
123
142
  * @returns message d'erreur, préfixé `EADDRINUSE:` si un port occupé est dénoncé.
124
143
  */
125
144
  export declare function startupTimeoutMessage(timeoutMs: number, observed: string): string;
145
+ /**
146
+ * Message d'un vite sorti AVANT d'annoncer son adresse : le code de sortie, suivi de la
147
+ * fin de ce qu'il a écrit. Sans cette fin, la cause (config illisible, dépendance
148
+ * absente, port pris) reste muette — vécu en intégration continue, un rouge que rien ne
149
+ * permettait d'instruire.
150
+ *
151
+ * @param code - code de sortie du process, `null` s'il a été tué par un signal.
152
+ * @param signal - signal qui l'a terminé, s'il y en a un.
153
+ * @param observed - sortie (stdout + stderr) accumulée avant l'arrêt, sans codes ANSI.
154
+ * @returns le message, borné à {@link EXIT_OUTPUT_TAIL_CHARS} caractères de sortie.
155
+ */
156
+ export declare function exitBeforeReadyMessage(code: number | null, signal: string | null, observed: string): string;
126
157
  /**
127
158
  * Superviseur Vite résilient — branche POC `poc/frontend-child`.
128
159
  *
@@ -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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nodefony/frontend",
3
- "version": "10.0.0-beta.5",
3
+ "version": "10.0.0-beta.7",
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,28 +36,28 @@
36
36
  "esm"
37
37
  ],
38
38
  "peerDependencies": {
39
- "@nodefony/framework": "^10.0.0-beta.5",
40
- "@nodefony/http": "^10.0.0-beta.5",
41
- "nodefony": "^10.0.0-beta.5",
39
+ "@nodefony/framework": "^10.0.0-beta.7",
40
+ "@nodefony/http": "^10.0.0-beta.7",
41
+ "nodefony": "^10.0.0-beta.7",
42
42
  "zod": "^4.6.7"
43
43
  },
44
44
  "devDependencies": {
45
- "@nodefony/framework": "^10.0.0-beta.5",
46
- "@nodefony/http": "^10.0.0-beta.5",
45
+ "@nodefony/framework": "^10.0.0-beta.7",
46
+ "@nodefony/http": "^10.0.0-beta.7",
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.5",
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.7",
51
+ "vite": "8.3.8",
52
+ "vitest": "5.1.0"
53
53
  },
54
54
  "private": false,
55
55
  "engines": {
56
- "node": ">=24.14.0"
56
+ "node": "^24.16.0 || >=26.0.0"
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",
@@ -71,7 +71,7 @@
71
71
  "url": "git+https://github.com/nodefony/nodefony-core.git",
72
72
  "directory": "src/packages/@nodefony/frontend"
73
73
  },
74
- "homepage": "https://nodefony.github.io/nodefony-core/",
74
+ "homepage": "https://nodefony.net/",
75
75
  "bugs": {
76
76
  "url": "https://github.com/nodefony/nodefony-core/issues"
77
77
  }