@nodefony/frontend 10.0.0-beta.1 → 10.0.0-beta.3

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.
Files changed (25) hide show
  1. package/README.md +56 -68
  2. package/dist/_virtual/{_@oxc-project_runtime@0.151.0 → _@oxc-project_runtime@0.153.0}/helpers/esm/decorate.js +1 -1
  3. package/dist/_virtual/{_@oxc-project_runtime@0.151.0 → _@oxc-project_runtime@0.153.0}/helpers/esm/decorateMetadata.js +1 -1
  4. package/dist/index.js +2 -2
  5. package/dist/nodefony/config/config.js +3 -8
  6. package/dist/nodefony/service/FrontendService.js +73 -295
  7. package/dist/nodefony/service/ViteConfigGenerator.js +11 -30
  8. package/dist/nodefony/service/ViteProcessSupervisor.js +17 -12
  9. package/dist/nodefony/service/bootSummary.js +44 -0
  10. package/dist/nodefony/src/isolationGroups.js +27 -32
  11. package/dist/nodefony/src/template/TemplateHelper.js +52 -19
  12. package/dist/types/nodefony/config/config.d.ts +0 -8
  13. package/dist/types/nodefony/interfaces/IFrontBuilder.d.ts +0 -9
  14. package/dist/types/nodefony/interfaces/IFrontendService.d.ts +6 -10
  15. package/dist/types/nodefony/interfaces/IViteSupervisor.d.ts +11 -5
  16. package/dist/types/nodefony/service/FrontendService.d.ts +24 -118
  17. package/dist/types/nodefony/service/ViteConfigGenerator.d.ts +13 -21
  18. package/dist/types/nodefony/service/ViteProcessSupervisor.d.ts +13 -16
  19. package/dist/types/nodefony/service/bootSummary.d.ts +23 -0
  20. package/dist/types/nodefony/src/isolationGroups.d.ts +24 -23
  21. package/dist/types/nodefony/src/template/TemplateHelper.d.ts +23 -7
  22. package/docs/index.md +173 -145
  23. package/package.json +12 -13
  24. package/dist/nodefony/src/remoteDev.js +0 -216
  25. package/dist/types/nodefony/src/remoteDev.d.ts +0 -152
@@ -37,6 +37,30 @@
37
37
  * partager une instance, une clé dédiée pour ce qui doit être isolé).
38
38
  */
39
39
  export declare function isolationGroup(type: string): string;
40
+ /**
41
+ * Espace d'URL réservé aux serveurs Vite de développement, sur l'origine de
42
+ * Nodefony. Chaque famille y a son sous-préfixe (cf {@link devBasePath}).
43
+ */
44
+ export declare const DEV_BASE_ROOT = "/_vite/";
45
+ /**
46
+ * Chemin de base Vite d'une famille en développement (`/_vite/<famille>/`).
47
+ *
48
+ * Vite fabrique ses URLs d'assets RELATIVES AU DOCUMENT : une image importée
49
+ * devient `/<base>/src/logo.png`, que le navigateur résout contre l'origine de
50
+ * la page — servie par Nodefony, pas par Vite. Un préfixe réservé rend ces
51
+ * URLs reconnaissables : Nodefony les relaie (307) vers le serveur Vite, sans
52
+ * collision possible avec les routes de l'application. Un préfixe PAR famille,
53
+ * parce que chaque famille a son instance Vite, sur son port : le relais doit
54
+ * savoir vers laquelle renvoyer.
55
+ *
56
+ * `base` est l'option que Vite honore partout — dev classique, dev bundlé,
57
+ * socket HMR, `@vitejs/plugin-vue`, publicDir —, contrairement à
58
+ * `server.origin`, ignoré en mode bundlé.
59
+ *
60
+ * @param family - clé de famille ({@link isolationGroup})
61
+ * @returns le chemin, `/` en tête et en fin
62
+ */
63
+ export declare function devBasePath(family: string): string;
40
64
  /**
41
65
  * Famille servie sur le port de base (`devPort`). Les autres familles prennent
42
66
  * les blocs de ports suivants. Garder `default` ici garantit que l'instance
@@ -64,26 +88,3 @@ export declare function orderFamilies(families: ReadonlyArray<string>): string[]
64
88
  * @returns map ordonnée `famille → port de base de son bloc`.
65
89
  */
66
90
  export declare function familyPortPlan(devPort: number, families: ReadonlyArray<string>, portRetryAttempts: number): Map<string, number>;
67
- /**
68
- * Bloc de ports de chaque famille : tous les ports que SON instance Vite peut
69
- * prendre, port-retry compris.
70
- *
71
- * Le plan seul ne dit que le port ESPÉRÉ ; sur `EADDRINUSE` le superviseur
72
- * glisse dans son bloc. Un CSP construit sur le seul port espéré laisse la page
73
- * sans rechargement à chaud dès que le port de base est pris — et il l'est dès
74
- * qu'un second projet tourne sur la machine.
75
- *
76
- * Rendu par famille, et non à plat : le consommateur remplace le bloc d'une
77
- * famille par son port RÉEL dès qu'il est connu. Déclarer les douze ports d'un
78
- * poste à trois familles coûte un en-tête CSP de ~8 Ko sur chaque réponse
79
- * (mesuré) — la plage est le prix d'une incertitude, elle ne doit pas survivre
80
- * à sa levée.
81
- *
82
- * Dérivé du plan plutôt que recalculé depuis `devPort` : la règle des blocs
83
- * disjoints n'est écrite qu'à un endroit, `familyPortPlan`.
84
- *
85
- * @param plan - `famille → port de base`, tel que rendu par `familyPortPlan`.
86
- * @param portRetryAttempts - tentatives de port-retry par instance (bloc = +1).
87
- * @returns `famille → ports du bloc`, croissants.
88
- */
89
- export declare function familyPortBlocks(plan: ReadonlyMap<string, number>, portRetryAttempts: number): Map<string, number[]>;
@@ -27,18 +27,34 @@ export declare class TemplateHelper {
27
27
  * prod émises ; `""` = origine Nodefony (chemins relatifs).
28
28
  */
29
29
  constructor(supervisor: IViteSupervisor | null, mode: "development" | "production", entries?: ReadonlyArray<IResolvedFrontendEntry>, assetBaseUrl?: string);
30
+ /**
31
+ * Origine LOCALE du serveur Vite — la cible du proxy inverse que Nodefony
32
+ * monte sur `/_vite/<famille>/` (#528). Jamais annoncée au navigateur : la
33
+ * page ne connaît que sa propre origine, Vite reste sur la boucle locale.
34
+ *
35
+ * 🔴 Seul un Vite qui SERT (`ready`, `compiling`) est une cible. Un port
36
+ * retenu par une instance tombée ou en redémarrage peut avoir été repris
37
+ * par le Vite d'une AUTRE application de la machine (même préfixe
38
+ * `/_vite/<famille>/`) : relayer vers lui servirait les sources de l'autre
39
+ * application à cette page. Le superviseur quitte `ready` dès l'`exit` de
40
+ * son processus — avant qu'un autre ne puisse reprendre le port.
41
+ *
42
+ * @returns l'origine (`http://127.0.0.1:5173`), ou `undefined` sans
43
+ * superviseur, tant que Vite n'a pas résolu son port, ou quand il ne sert
44
+ * pas (amont pas prêt : le relais répond `503`, avant tout `101` pour la
45
+ * socket — le client Vite ne recharge la page qu'une fois Vite revenu)
46
+ */
47
+ devTarget(): string | undefined;
30
48
  /**
31
49
  * Tags à injecter dans `<head>` (ou avant `</body>`) pour une entrée donnée.
50
+ * En développement, toutes les URLs vers Vite sont relatives à la page
51
+ * (`/_vite/<famille>/…`) : Nodefony les relaie, la page n'a qu'une origine.
52
+ *
32
53
  * @param entryName nom logique de l'entrée (matche `entryName` dans IResolvedFrontendEntry)
33
54
  * @param nonce nonce CSP de la requête (`Context.cspNonce`) — posé sur les `<script>`
34
55
  * pour satisfaire `script-src 'nonce-…'` (preamble inline dev + entrée prod).
35
- * @param requestHost nom d'hôte par lequel le client a demandé la PAGE
36
- * (`Context.domain`, sans port). Dev : l'origine des assets est réécrite
37
- * sur ce nom (scheme et port restent ceux de Vite) → poste et conteneur
38
- * servis par la même instance. Prod : **ignoré** — les URLs du manifest
39
- * sont relatives au document, elles suivent déjà l'hôte de la page.
40
56
  */
41
- renderTags(entryName: string, nonce?: string, requestHost?: string): string;
57
+ renderTags(entryName: string, nonce?: string): string;
42
58
  /**
43
59
  * Document HTML complet pour une entrée : lit l'`index.html` du module (le dev
44
60
  * y met SES meta/polices/scripts externes), retire le `<script type=module>`
@@ -48,7 +64,7 @@ export declare class TemplateHelper {
48
64
  *
49
65
  * @param entryName nom logique de l'entrée
50
66
  */
51
- renderDocument(entryName: string, nonce?: string, requestHost?: string): string;
67
+ renderDocument(entryName: string, nonce?: string): string;
52
68
  /** Injecte `tags` dans `html` (marqueur > `</head>` > `</body>` > append). */
53
69
  private injectIntoHtml;
54
70
  /**