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

package/README.md

@@ -282,7 +282,7 @@ Le `TemplateHelper` injecte automatiquement le preamble React Fast Refresh pour
 
 ### Vite démarre sur un autre port que `devPort`
 
-Le port configuré est pris. Le supervisor retry automatiquement sur `port+1`, `port+2` (option `portRetryAttempts`). Vérifie le port résolu via `svc.status().port`.
+Le port configuré est pris. Le supervisor retry automatiquement sur `port+1`, `port+2` (option `portRetryAttempts`). Vérifie le port résolu via `svc.status().port` — il vaut `null` tant qu'aucun port n'a été résolu, jamais le port demandé : un port qu'on espère n'est pas un port qui sert.
 
 ### Le browser refuse le cert HTTPS de Vite (`https: true`)
 

package/dist/_virtual/{_@oxc-project_runtime@0.149.0 → _@oxc-project_runtime@0.150.0}/helpers/esm/decorate.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.150.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);

package/dist/_virtual/{_@oxc-project_runtime@0.149.0 → _@oxc-project_runtime@0.150.0}/helpers/esm/decorateMetadata.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.150.0/helpers/esm/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }

package/dist/index.js

@@ -10,8 +10,8 @@ import { ViteBuilder } from "./nodefony/src/builders/ViteBuilder.js";
 import { ViteConfigGenerator } from "./nodefony/service/ViteConfigGenerator.js";
 import { ViteProcessSupervisor } from "./nodefony/service/ViteProcessSupervisor.js";
 import { TemplateHelper } from "./nodefony/src/template/TemplateHelper.js";
-import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "./_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
+import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "./_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
 import FrontendService_default from "./nodefony/service/FrontendService.js";
 import { buildFrontendStatus, createFrontendAdminApi } from "./nodefony/src/FrontendAdminApi.js";
 import FrontendBuild from "./nodefony/command/frontend-build.js";

package/dist/nodefony/service/FrontendService.js

@@ -5,9 +5,9 @@ import { allowedHostPatternForTemplate, detectRemoteDev, isLoopbackHostname, isV
 import { ViteProcessSupervisor } from "./ViteProcessSupervisor.js";
 import { TemplateHelper } from "../src/template/TemplateHelper.js";
 import { familyPortBlocks, familyPortPlan, isolationGroup } from "../src/isolationGroups.js";
-import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
-import { Module, Service, extend, injectable, stripTrailingSlashes } from "nodefony";
+import __decorateMetadata from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import { FRONTEND_CHOICES, Module, Service, extend, injectable, stripTrailingSlashes } from "nodefony";
 import path from "node:path";
 import fs from "node:fs";
 //#region nodefony/service/FrontendService.ts
@@ -102,7 +102,8 @@ let FrontendService = class FrontendService extends Service {
 			const env = this.kernel?.environment;
 			if (env === "development" && this.cfg.autoStartInDevelopment) {
 				if (this.entries.length === 0) {
-					this.log("no frontend entries declared — Vite supervisor not started", "INFO");
+					const engines = FRONTEND_CHOICES.filter((c) => c !== "none").join("|");
+					this.log(`aucune interface web n'est déclarée — le serveur de développement Vite ne démarre pas. Pour en poser une : \`nodefony create front [nom] --frontend <${engines}>\``, "WARNING");
 					return;
 				}
 				const names = this.entries.map((e) => e.entryName);

package/dist/nodefony/service/ViteProcessSupervisor.js

@@ -49,17 +49,38 @@ const DEFAULTS = {
 	portRetryAttempts: 3
 };
 /**
-* Un texte (message d'erreur OU sortie brute de Vite) dénonce-t-il un port occupé ?
+* Un texte (message d'erreur OU sortie brute de Vite) dénonce-t-il un conflit de
+* port FATAL — c'est-à-dire un port que vite n'a PAS pu prendre ?
 *
 * **Source UNIQUE** de cette décision. Elle était dupliquée en deux regex qui ont
 * divergé : l'une cherchait `port X is in use`, alors que Vite écrit
 * `Port 5173 is ALREADY in use`. Résultat, le retry de port ne se déclenchait
 * jamais et la seconde app perdait tout son frontend — un conflit de port pourtant
-* parfaitement rattrapable. On tolère donc les deux formulations, et on ne
-* l'écrit qu'ici (deux implémentations d'une même règle = dérive garantie).
+* parfaitement rattrapable. On ne l'écrit donc qu'ici (deux implémentations d'une
+* même règle = dérive garantie).
+*
+* 🔴 **`already` est OBLIGATOIRE, et c'est tout le sujet.** Vite émet trois textes
+* qui contiennent « in use », et un seul signifie qu'il a échoué — vérifié au
+* SOURCE de `httpServerStart` (vite 8.3.0, `dist/node/chunks/node.js`) :
+*
+*  - `Port X is already in use` → `throw` : vite MEURT. Seul cas rattrapable par
+*    un repli sur `port + 1`.
+*  - `Port X is in use, trying another one…` → `logger.info` : vite cherche
+*    lui-même le port suivant et annoncera son `Local:`. Rien à rattraper.
+*  - `Port X is in use on a wildcard address, but H:X is available…` →
+*    `logger.warn` sur un `listen` **RÉUSSI** : vite sert sur le port demandé.
+*
+* Rendre `already` optionnel confondait les trois. La conséquence ne se voyait
+* pas sur un poste, où vite meurt vite : elle se voyait sur un agent partagé et
+* lent, via `startupTimeoutMessage`. Un démarrage qui avait seulement AVERTI
+* (wildcard) puis dépassé l'échéance sortait sous un libellé `EADDRINUSE:`, donc
+* `spawnWithPortRetry` repliait — et chaque repli repayait l'échéance entière.
+* Mesuré sur la forge : le cas d'intégration du décalage de port tué à 60 s
+* (`4 tentatives × startupTimeoutMs`) quand les cinq autres du même fichier
+* tenaient en 300 à 700 ms.
 */
 function isPortInUseMessage(text) {
-	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);
+	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);
 }
 /**
 * Message d'échec d'un boot qui n'a jamais rendu la main dans le temps imparti —
@@ -183,7 +204,7 @@ var ViteProcessSupervisor = class {
 			state: this.state,
 			host: this.opts.devHost,
 			origin: this.resolvedOrigin,
-			port: this.resolvedPort ?? this.opts.devPort,
+			port: this.resolvedPort,
 			pid: this.child?.pid ?? null,
 			lastError: this.lastError,
 			entries: this.entries,
@@ -201,6 +222,7 @@ var ViteProcessSupervisor = class {
 		const maxAttempts = this.cfg.portRetryAttempts;
 		let lastErr = null;
 		this.portRetries = 0;
+		this.resolvedPort = null;
 		for (let i = 0; i <= maxAttempts; i++) {
 			const port = this.opts.devPort + i;
 			try {
@@ -475,7 +497,11 @@ var ViteProcessSupervisor = class {
 	*/
 	pingVite() {
 		return new Promise((resolve, reject) => {
-			const port = this.resolvedPort ?? this.opts.devPort;
+			const port = this.resolvedPort;
+			if (port === null) {
+				reject(/* @__PURE__ */ new Error("aucun port résolu — rien à sonder"));
+				return;
+			}
 			const req = (this.opts.https ? https : http).request({
 				hostname: browserReachableHost(this.opts.devHost),
 				port,

package/dist/types/nodefony/service/ViteProcessSupervisor.d.ts

@@ -74,14 +74,35 @@ export interface ViteSupervisorOptions {
     readonly portRetryAttempts?: number;
 }
 /**
- * Un texte (message d'erreur OU sortie brute de Vite) dénonce-t-il un port occupé ?
+ * Un texte (message d'erreur OU sortie brute de Vite) dénonce-t-il un conflit de
+ * port FATAL — c'est-à-dire un port que vite n'a PAS pu prendre ?
  *
  * **Source UNIQUE** de cette décision. Elle était dupliquée en deux regex qui ont
  * divergé : l'une cherchait `port X is in use`, alors que Vite écrit
  * `Port 5173 is ALREADY in use`. Résultat, le retry de port ne se déclenchait
  * jamais et la seconde app perdait tout son frontend — un conflit de port pourtant
- * parfaitement rattrapable. On tolère donc les deux formulations, et on ne
- * l'écrit qu'ici (deux implémentations d'une même règle = dérive garantie).
+ * parfaitement rattrapable. On ne l'écrit donc qu'ici (deux implémentations d'une
+ * même règle = dérive garantie).
+ *
+ * 🔴 **`already` est OBLIGATOIRE, et c'est tout le sujet.** Vite émet trois textes
+ * qui contiennent « in use », et un seul signifie qu'il a échoué — vérifié au
+ * SOURCE de `httpServerStart` (vite 8.3.0, `dist/node/chunks/node.js`) :
+ *
+ *  - `Port X is already in use` → `throw` : vite MEURT. Seul cas rattrapable par
+ *    un repli sur `port + 1`.
+ *  - `Port X is in use, trying another one…` → `logger.info` : vite cherche
+ *    lui-même le port suivant et annoncera son `Local:`. Rien à rattraper.
+ *  - `Port X is in use on a wildcard address, but H:X is available…` →
+ *    `logger.warn` sur un `listen` **RÉUSSI** : vite sert sur le port demandé.
+ *
+ * Rendre `already` optionnel confondait les trois. La conséquence ne se voyait
+ * pas sur un poste, où vite meurt vite : elle se voyait sur un agent partagé et
+ * lent, via `startupTimeoutMessage`. Un démarrage qui avait seulement AVERTI
+ * (wildcard) puis dépassé l'échéance sortait sous un libellé `EADDRINUSE:`, donc
+ * `spawnWithPortRetry` repliait — et chaque repli repayait l'échéance entière.
+ * Mesuré sur la forge : le cas d'intégration du décalage de port tué à 60 s
+ * (`4 tentatives × startupTimeoutMs`) quand les cinq autres du même fichier
+ * tenaient en 300 à 700 ms.
  */
 export declare function isPortInUseMessage(text: string): boolean;
 /**

package/docs/index.md

@@ -558,7 +558,7 @@ garde le port habituel (`PRIMARY_FAMILY`, `isolationGroups.ts:56`).
 
 **Les familles démarrent indépendamment.** Si Angular échoue, React continue de fonctionner : le
 démarrage n'échoue que si **aucune** famille n'a pu démarrer (`FrontendService.startDev()`,
-`FrontendService.ts:316`).
+`FrontendService.ts:339`).
 
 ### Résilience — ce qui se passe quand Vite tombe
 
@@ -567,11 +567,11 @@ les processus meurent.
 
 | Situation                  | Réponse                                                                                               |
 | -------------------------- | ----------------------------------------------------------------------------------------------------- |
-| Port occupé au lancement   | essai sur le port suivant, jusqu'à `portRetryAttempts` (`ViteProcessSupervisor.ts:276`)               |
+| Port occupé au lancement   | essai sur le port suivant, jusqu'à `portRetryAttempts` (`ViteProcessSupervisor.ts:297`)               |
 | Vite plante                | relance avec délai exponentiel plafonné (`scheduleRestart()`, `ViteProcessSupervisor.ts:674`)         |
 | Vite ne répond plus (gelé) | sonde périodique ; après N échecs, Vite est tué pour être relancé (`ViteProcessSupervisor.ts:599`)    |
 | Deux `start()` concurrents | la promesse en cours est partagée — jamais deux processus                                             |
-| Ctrl+C au terminal         | le signal marque un arrêt **voulu** : pas de relance (`markShutdown`, `ViteProcessSupervisor.ts:245`) |
+| Ctrl+C au terminal         | le signal marque un arrêt **voulu** : pas de relance (`markShutdown`, `ViteProcessSupervisor.ts:266`) |
 | Arrêt du kernel            | `SIGINT`, puis `SIGKILL` après 3 s — aucun zombie ne bloque le port (`ViteProcessSupervisor.ts:26`)   |
 
 Deux subtilités valent d'être connues, parce qu'elles expliquent des comportements sinon
@@ -581,12 +581,16 @@ incompréhensibles :
   marquage du signal reçu par le processus serveur, un simple Ctrl+C ferait apparaître un
   « redémarrage échoué » en erreur, sur un arrêt parfaitement normal.
 - **La détection d'un port occupé est écrite à un seul endroit** (`isPortInUseMessage()`,
-  `ViteProcessSupervisor.ts:164`), et tolère les deux formulations de Vite (« is in use » comme « is
-  **already** in use »). Deux implémentations de la même règle avaient divergé : la reprise sur port
-  ne se déclenchait jamais, et la seconde application perdait toute son interface.
+  `ViteProcessSupervisor.ts:185`), et elle reconnaît un conflit **FATAL**, pas la simple présence de
+  « in use ». Vite écrit trois textes qui contiennent ces mots, et un seul signifie qu'il a échoué :
+  « Port X is **already** in use » (il meurt — le seul cas où reprendre sur un autre port a un sens),
+  « Port X is in use, **trying another one…** » (il se décale lui-même) et « Port X is in use **on a
+  wildcard address**, but H:X is available… » (il a pris le port demandé et se contente d'avertir).
+  Les confondre faisait reprendre sur un autre port un démarrage qui n'avait aucun conflit, en
+  repayant l'attente de démarrage à chaque essai.
 
 Les écouteurs attachés au processus enfant sont suivis puis retirés à chaque mort
-(`cleanupChildListeners()`, `ViteProcessSupervisor.ts:922`) : sans cela, les relances successives les
+(`cleanupChildListeners()`, `ViteProcessSupervisor.ts:971`) : sans cela, les relances successives les
 accumuleraient jusqu'à l'avertissement de fuite.
 
 ## 🧰 API publique
@@ -685,7 +689,7 @@ Dans une application générée par `nodefony create app`, tu n'as pas à y pens
 **`npm run build` construit l'application entière** — le backend (rolldown) puis le front (il
 chaîne `nodefony frontend:build`). Un seul geste avant `npm start` ou dans un pipeline.
 
-`FrontendService.build()` (`FrontendService.ts:761`) appelle Vite **entrée par entrée**, et non une
+`FrontendService.build()` (`FrontendService.ts:799`) appelle Vite **entrée par entrée**, et non une
 fois pour toutes. Ce n'est pas un détail : chaque bundle a sa racine, son dossier de sortie, sa base
 et son manifeste — c'est ce qui rend le multi-modules possible et ce qui isole Angular.
 
@@ -821,7 +825,7 @@ Sur le chemin chaud du rendu, trois précautions :
 - le **manifeste** est lu une fois par dossier de sortie, jamais par requête ;
 - l'**`index.html`** est mis en cache en production (relu en développement, où la fraîcheur prime) ;
 - les **écouteurs** du processus enfant sont suivis et retirés à chaque mort
-  (`trackListener()`, `ViteProcessSupervisor.ts:912`) — sans quoi les relances les accumuleraient.
+  (`trackListener()`, `ViteProcessSupervisor.ts:961`) — sans quoi les relances les accumuleraient.
 
 La sonde de vie coûte une requête HTTP toutes les trente secondes par famille. Elle est désactivable
 (`healthCheckIntervalMs: 0`) si ce budget te gêne, au prix de la détection d'un Vite gelé.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodefony/frontend",
-  "version": "10.0.0-alpha.5",
+  "version": "10.0.0-alpha.7",
   "description": "Construction et rechargement à chaud des frontends de chaque module Nodefony — Vite intégré, multi-framework (React, Vue, Angular, Svelte)",
   "author": "Christophe CAMENSULI <ccamensuli@gmail.com>",
   "type": "module",
@@ -36,22 +36,22 @@
     "esm"
   ],
   "peerDependencies": {
-    "@nodefony/framework": "^10.0.0-alpha.5",
-    "@nodefony/http": "^10.0.0-alpha.5",
-    "nodefony": "^10.0.0-alpha.5",
-    "zod": "^4.6.1"
+    "@nodefony/framework": "^10.0.0-alpha.7",
+    "@nodefony/http": "^10.0.0-alpha.7",
+    "nodefony": "^10.0.0-alpha.7",
+    "zod": "^4.6.5"
   },
   "devDependencies": {
-    "@nodefony/framework": "^10.0.0-alpha.5",
-    "@nodefony/http": "^10.0.0-alpha.5",
+    "@nodefony/framework": "^10.0.0-alpha.7",
+    "@nodefony/http": "^10.0.0-alpha.7",
     "@types/chai": "5.2.3",
-    "@types/node": "26.5.1",
-    "@vitest/coverage-v8": "5.0.0",
+    "@types/node": "26.6.1",
+    "@vitest/coverage-v8": "5.0.1",
     "chai": "6.2.2",
-    "nodefony": "^10.0.0-alpha.5",
+    "nodefony": "^10.0.0-alpha.7",
     "rimraf": "6.1.3",
     "vite": "8.3.0",
-    "vitest": "5.0.0"
+    "vitest": "5.0.1"
   },
   "private": false,
   "engines": {