@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.
- package/README.md +56 -68
- package/dist/_virtual/{_@oxc-project_runtime@0.151.0 → _@oxc-project_runtime@0.153.0}/helpers/esm/decorate.js +1 -1
- package/dist/_virtual/{_@oxc-project_runtime@0.151.0 → _@oxc-project_runtime@0.153.0}/helpers/esm/decorateMetadata.js +1 -1
- package/dist/index.js +2 -2
- package/dist/nodefony/config/config.js +3 -8
- package/dist/nodefony/service/FrontendService.js +73 -295
- package/dist/nodefony/service/ViteConfigGenerator.js +11 -30
- package/dist/nodefony/service/ViteProcessSupervisor.js +17 -12
- package/dist/nodefony/service/bootSummary.js +44 -0
- package/dist/nodefony/src/isolationGroups.js +27 -32
- package/dist/nodefony/src/template/TemplateHelper.js +52 -19
- package/dist/types/nodefony/config/config.d.ts +0 -8
- package/dist/types/nodefony/interfaces/IFrontBuilder.d.ts +0 -9
- package/dist/types/nodefony/interfaces/IFrontendService.d.ts +6 -10
- package/dist/types/nodefony/interfaces/IViteSupervisor.d.ts +11 -5
- package/dist/types/nodefony/service/FrontendService.d.ts +24 -118
- package/dist/types/nodefony/service/ViteConfigGenerator.d.ts +13 -21
- package/dist/types/nodefony/service/ViteProcessSupervisor.d.ts +13 -16
- package/dist/types/nodefony/service/bootSummary.d.ts +23 -0
- package/dist/types/nodefony/src/isolationGroups.d.ts +24 -23
- package/dist/types/nodefony/src/template/TemplateHelper.d.ts +23 -7
- package/docs/index.md +173 -145
- package/package.json +12 -13
- package/dist/nodefony/src/remoteDev.js +0 -216
- 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
|
|
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
|
|
67
|
+
renderDocument(entryName: string, nonce?: string): string;
|
|
52
68
|
/** Injecte `tags` dans `html` (marqueur > `</head>` > `</body>` > append). */
|
|
53
69
|
private injectIntoHtml;
|
|
54
70
|
/**
|