nodefony 10.0.0 → 10.0.1

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 (51) hide show
  1. package/.ai/symbols.json +91 -30
  2. package/CHANGELOG.md +25 -0
  3. package/assets/login.css +26 -1
  4. package/dist/bin/nodefony.js +1 -1
  5. package/dist/client/client/debugbar/DebugBar.js +2 -2
  6. package/dist/client/debugbar.standalone.js +2 -2
  7. package/dist/login/login.css +26 -1
  8. package/dist/node/cli/create.js +30 -10
  9. package/dist/node/cli/installCommand.js +13 -1
  10. package/dist/node/cli/scaffold/engine.js +134 -26
  11. package/dist/node/cli/scaffold/invisibleChars.js +52 -0
  12. package/dist/node/cli/scaffold/versions.js +7 -7
  13. package/dist/node/cli/startPanel.js +70 -0
  14. package/dist/node/index.js +1 -1
  15. package/dist/node/kernel/checks/packageDeps.js +11 -1
  16. package/dist/node/package.json.js +1 -1
  17. package/dist/types/cli/installCommand.d.ts +10 -0
  18. package/dist/types/cli/scaffold/engine.d.ts +47 -9
  19. package/dist/types/cli/scaffold/invisibleChars.d.ts +10 -0
  20. package/dist/types/cli/startPanel.d.ts +75 -0
  21. package/man/nodefony.1 +1 -1
  22. package/package.json +6 -6
  23. package/templates/app/base/README.md.tpl +1 -1
  24. package/templates/app/base/env.ts.tpl +7 -4
  25. package/templates/app/base/nodefony.config.ts.tpl +12 -3
  26. package/templates/app/complete/env.example.tpl +4 -4
  27. package/templates/app/frontend/angular/frontend/src/accent.css.tpl +7 -39
  28. package/templates/app/frontend/angular/frontend/src/app/app.component.ts.tpl +276 -25
  29. package/templates/app/frontend/react/frontend/src/App.tsx.tpl +313 -44
  30. package/templates/app/frontend/react/frontend/src/accent.css.tpl +7 -35
  31. package/templates/app/frontend/shared/frontend/src/brand.ts.tpl +12 -9
  32. package/templates/app/frontend/shared/frontend/src/devHome.ts.tpl +45 -0
  33. package/templates/app/frontend/shared/frontend/src/homeContent.ts.tpl +229 -0
  34. package/templates/app/frontend/shared/frontend/src/homeEffects.ts.tpl +115 -0
  35. package/templates/app/frontend/shared/frontend/src/showcase.css.tpl +729 -205
  36. package/templates/app/frontend/shared/nodefony/controllers/AppController.ts.tpl +17 -7
  37. package/templates/app/frontend/svelte/frontend/src/App.svelte.tpl +248 -29
  38. package/templates/app/frontend/svelte/frontend/src/accent.css.tpl +7 -39
  39. package/templates/app/frontend/vue/frontend/src/App.vue.tpl +255 -28
  40. package/templates/app/frontend/vue/frontend/src/accent.css.tpl +7 -39
  41. package/templates/app/home/nodefony/controllers/HomeController.ts.tpl +40 -25
  42. package/templates/app/home/nodefony/home/homePage.ts.tpl +163 -0
  43. package/templates/controller/duplex/nodefony/controllers/__NAME__.ts.tpl +1 -1
  44. package/templates/controller/realtime/nodefony/controllers/__NAME__.ts.tpl +1 -1
  45. package/templates/controller/rest/nodefony/controllers/__NAME__.ts.tpl +1 -1
  46. package/templates/demo/front/frontend/src/App.tsx.tpl +57 -84
  47. package/templates/demo/front/frontend/src/demo.css.tpl +12 -134
  48. package/templates/demo/front/frontend/src/effects.ts.tpl +5 -36
  49. package/templates/entity/controller/nodefony/controllers/__PASCAL__Controller.ts.tpl +1 -1
  50. package/templates/demo/front/frontend/src/debugBar.ts.tpl +0 -56
  51. package/templates/demo/front/frontend/src/kit/theme.ts.tpl +0 -51
@@ -1,53 +1,280 @@
1
1
  <script setup lang="ts">
2
2
  /**
3
- * Page d'accueil de <%= it.appName %> — MINIMALE, et c'est voulu : c'est TA page.
3
+ * Page d'accueil de <%= it.appName %> — c'est TA page.
4
4
  *
5
- * Elle dit quelle application répond<% if (it.hasSecurity) { %>, propose la connexion et nomme le
6
- * compte connecté<% } %>. Rien de plus : ce qui part ici part en PRODUCTION, vers
7
- * n'importe qui — ni mot de passe, ni version, ni lien vers la console
8
- * d'administration.
5
+ * Ce que voit tout visiteur : la marque, le thème<% if (it.complete) { %>, la session<% } %>, puis le nom de
6
+ * l'application. Rien de plus en production : ni mot de passe, ni version, ni
7
+ * lien vers la console d'administration.
9
8
  *
10
- * Pour VOIR ce que le framework sait faire, installe la démo : elle se copie
11
- * dans l'application et se lit comme ton propre code.
9
+ * En DÉVELOPPEMENT seulement : la présentation du framework, les liens utiles
10
+ * et où personnaliser la page. Ce contenu vit dans `devHome.ts`, qui vaut
11
+ * `null` dans le build de production — c'est là qu'est la garde, pas ici :
12
+ * Vue compile les textes de ce gabarit dans le bundle, affichés ou non.
12
13
  */
13
- <% if (it.hasSecurity) { %>import { onMounted } from "vue";
14
- // La liaison Vue de la connexion : l'état de session en composable, la page de
14
+ import { onMounted, onUnmounted, ref, shallowRef } from "vue";
15
+ <% if (it.complete) { %>// La liaison Vue de la connexion : l'état de session en composable, la page de
15
16
  // connexion servie par le framework (jamais un formulaire recopié ici).
16
17
  import { useNodefonyLogin } from "nodefony/vue";
17
18
  import { loginPagePath } from "nodefony/client";
18
19
  <% } %>import { NODEFONY_LOGO } from "./brand";
20
+ import { DEV_HOME } from "./devHome";
21
+ import {
22
+ applyDarkTheme,
23
+ findDebugBar,
24
+ findDemo,
25
+ readDarkTheme,
26
+ startPointerLight,
27
+ type IDebugBarHandle,
28
+ } from "./homeEffects";
19
29
  import "./showcase.css";
20
30
  import "./accent.css";
21
- <% if (it.hasSecurity) { %>
31
+
32
+ const dev = DEV_HOME;
33
+
34
+ // Thème clair/sombre : suit le système, un clic l'impose, retenu par ce navigateur.
35
+ const dark = ref(readDarkTheme());
36
+ applyDarkTheme(dark.value, false);
37
+ function toggleTheme(): void {
38
+ dark.value = !dark.value;
39
+ applyDarkTheme(dark.value);
40
+ }
41
+
42
+ // UN bouton pour la barre de debug : la cacher ou la montrer.
43
+ const bar = shallowRef<IDebugBarHandle | null>(null);
44
+ const barVisible = ref(true);
45
+ function toggleBar(): void {
46
+ if (bar.value === null) return;
47
+ barVisible.value = !barVisible.value;
48
+ bar.value.setVisible(barVisible.value);
49
+ }
50
+
51
+ // La démo est-elle chargée ? Le serveur le dit dans la page (développement).
52
+ const demo = dev === null ? null : findDemo();
53
+ <% if (it.complete) { %>
22
54
  const { state: login, flow } = useNodefonyLogin();
23
55
  const loginHref = loginPagePath(location.pathname + location.search);
24
56
 
25
- // Reprend la session existante au montage (cookie de session, s'il y en a un).
26
- onMounted(() => {
27
- void flow.me();
28
- });
29
-
30
57
  async function logout(): Promise<void> {
31
58
  // Session venue d'un fournisseur : suivre son adresse ferme AUSSI la sienne.
32
59
  const providerLogout = await flow.logout();
33
60
  if (providerLogout !== null) window.location.assign(providerLogout);
34
61
  }
35
- <% } %></script>
62
+ <% } %>
63
+ let stopLight: (() => void) | null = null;
64
+ let frame = 0;
65
+ onMounted(() => {
66
+ <% if (it.complete) { %> // Reprend la session existante au montage (cookie de session, s'il y en a un).
67
+ void flow.me();
68
+ <% } %> stopLight = startPointerLight(".nf-card");
69
+ if (dev === null) return;
70
+ // La barre est injectée à côté de la page : sa poignée arrive après le rendu.
71
+ frame = requestAnimationFrame(() => {
72
+ bar.value = findDebugBar();
73
+ if (bar.value !== null) barVisible.value = bar.value.isVisible();
74
+ });
75
+ });
76
+ onUnmounted(() => {
77
+ stopLight?.();
78
+ cancelAnimationFrame(frame);
79
+ });
80
+ </script>
36
81
 
37
82
  <template>
38
- <main class="nf-main">
39
- <img class="nf-fwlogo" :src="NODEFONY_LOGO" alt="" width="48" height="48" />
40
- <h1><%= it.appName %></h1>
41
- <% if (it.hasSecurity) { %> <div class="nf-card" role="status">
42
- <p v-if="login.step === 'authenticated' && login.user">
43
- Connecté en tant que
44
- <span class="nf-session" data-open="">{{ login.user.identifier }}</span>
45
- <button type="button" class="nf-action" @click="logout">
83
+ <header class="nf-topbar">
84
+ <a class="nf-brand" href="/">
85
+ <img :src="NODEFONY_LOGO" alt="" width="30" height="30" />
86
+ <span><%= it.appName %></span>
87
+ <span v-if="dev" class="nf-tag">développement</span>
88
+ </a>
89
+ <nav v-if="dev" class="nf-topnav" aria-label="Liens de développement">
90
+ <template v-if="dev.console">
91
+ <a :href="dev.console.href">{{ dev.console.label }}</a>
92
+ <span class="nf-topnav-sep" aria-hidden="true"></span>
93
+ </template>
94
+ <a
95
+ v-for="link in dev.external"
96
+ :key="link.href"
97
+ class="nf-ext"
98
+ :href="link.href"
99
+ >{{ link.label }}</a
100
+ >
101
+ </nav>
102
+ <div class="nf-topbar-tools">
103
+ <div class="nf-tools" role="group" aria-label="Affichage">
104
+ <button
105
+ type="button"
106
+ class="nf-tool"
107
+ :aria-pressed="dark"
108
+ aria-label="Thème sombre"
109
+ title="Thème sombre"
110
+ @click="toggleTheme"
111
+ >
112
+ <svg
113
+ v-if="dark"
114
+ viewBox="0 0 24 24"
115
+ fill="none"
116
+ stroke="currentColor"
117
+ stroke-width="2"
118
+ aria-hidden="true"
119
+ >
120
+ <circle cx="12" cy="12" r="4" />
121
+ <path
122
+ d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"
123
+ />
124
+ </svg>
125
+ <svg
126
+ v-else
127
+ viewBox="0 0 24 24"
128
+ fill="none"
129
+ stroke="currentColor"
130
+ stroke-width="2"
131
+ aria-hidden="true"
132
+ >
133
+ <path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z" />
134
+ </svg>
135
+ </button>
136
+ <button
137
+ v-if="bar"
138
+ type="button"
139
+ class="nf-tool"
140
+ :aria-pressed="!barVisible"
141
+ aria-label="Cacher la barre de debug"
142
+ title="Cacher la barre de debug"
143
+ @click="toggleBar"
144
+ >
145
+ <svg
146
+ viewBox="0 0 24 24"
147
+ fill="none"
148
+ stroke="currentColor"
149
+ stroke-width="2"
150
+ stroke-linecap="round"
151
+ aria-hidden="true"
152
+ >
153
+ <path d="M8 2l1.9 1.9M16 2l-1.9 1.9" />
154
+ <rect x="7" y="6" width="10" height="14" rx="5" />
155
+ <path
156
+ d="M12 10v10M3 13h4M17 13h4M4 7l3 2M20 7l-3 2M4 19l3-2M20 19l-3-2"
157
+ />
158
+ </svg>
159
+ </button>
160
+ </div>
161
+ <% if (it.complete) { %> <span
162
+ v-if="login.step === 'authenticated' && login.user"
163
+ class="nf-account"
164
+ >
165
+ <span class="nf-session">{{ login.user.identifier }}</span>
166
+ <button type="button" class="nf-account-out" @click="logout">
46
167
  Se déconnecter
47
168
  </button>
48
- </p>
49
- <a v-else class="nf-action" :href="loginHref">Se connecter</a>
169
+ </span>
170
+ <a v-else class="nf-login" :href="loginHref">Se connecter</a>
171
+ <% } %> </div>
172
+ </header>
173
+
174
+ <main class="nf-main">
175
+ <div class="nf-hero">
176
+ <img
177
+ class="nf-hero-logo"
178
+ :src="NODEFONY_LOGO"
179
+ alt=""
180
+ width="80"
181
+ height="80"
182
+ />
183
+ <template v-if="dev">
184
+ <h1>{{ dev.hero.title }}</h1>
185
+ <p class="nf-sub">{{ dev.hero.sub }}</p>
186
+ <p class="nf-sig">{{ dev.hero.sig }}</p>
187
+ <div class="nf-badges">
188
+ <span class="nf-badge nf-agentic">{{ dev.hero.lead }}</span>
189
+ <span class="nf-badge nf-front">
190
+ <svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
191
+ <path :d="dev.front.logo" />
192
+ </svg>
193
+ {{ dev.front.name }} {{ dev.front.version }}
194
+ </span>
195
+ <span
196
+ v-for="badge in dev.hero.badges"
197
+ :key="badge"
198
+ class="nf-badge"
199
+ >{{ badge }}</span
200
+ >
201
+ </div>
202
+ <div
203
+ class="nf-install"
204
+ role="img"
205
+ :aria-label="`Commande d'installation : ${dev.hero.install.command} ${dev.hero.install.arg}`"
206
+ >
207
+ <span class="nf-p">$</span>
208
+ <span
209
+ >{{ dev.hero.install.command }}
210
+ <b>{{ dev.hero.install.arg }}</b></span
211
+ >
212
+ </div>
213
+ <div v-if="demo !== null" class="nf-cta">
214
+ <a class="nf-btn nf-primary" :href="demo">{{ dev.demoLabel }}</a>
215
+ </div>
216
+ <p v-else class="nf-learn">
217
+ {{ dev.learn.label }} : <code>{{ dev.learn.command }}</code> —
218
+ {{ dev.learn.note }}
219
+ </p>
220
+ </template>
221
+ <h1 v-else><%= it.appName %></h1>
50
222
  </div>
51
- <% } else { %> <p class="nf-dim">Ton application répond. Cette page est la tienne.</p>
52
- <% } %> </main>
223
+
224
+ <section
225
+ v-for="section in dev?.sections ?? []"
226
+ :key="section.id"
227
+ :class="section.band ? 'nf-section nf-band' : 'nf-section'"
228
+ :aria-labelledby="`${section.id}-title`"
229
+ >
230
+ <div class="nf-sec-head">
231
+ <p class="nf-kicker">{{ section.kicker }}</p>
232
+ <h2 :id="`${section.id}-title`">{{ section.title }}</h2>
233
+ <p>{{ section.intro }}</p>
234
+ </div>
235
+ <div class="nf-grid">
236
+ <component
237
+ :is="card.href !== null ? 'a' : 'div'"
238
+ v-for="card in section.cards"
239
+ :key="card.title"
240
+ :class="card.tone === 'safe' ? 'nf-card nf-safe' : 'nf-card'"
241
+ :href="card.href ?? undefined"
242
+ >
243
+ <h3>{{ card.title }}</h3>
244
+ <p v-if="card.creds" class="nf-creds">
245
+ <code>{{ card.creds.user }}</code>
246
+ <template v-if="card.creds.password !== null">
247
+ / <code>{{ card.creds.password }}</code>
248
+ </template>
249
+ </p>
250
+ <p>
251
+ <template v-for="(part, i) in card.text" :key="i">
252
+ <code v-if="part.code">{{ part.text }}</code>
253
+ <template v-else>{{ part.text }}</template>
254
+ </template>
255
+ </p>
256
+ <span v-if="card.go" class="nf-go">{{ card.go }}</span>
257
+ <form
258
+ v-if="card.skins"
259
+ class="nf-skins"
260
+ :action="card.skins.action"
261
+ method="get"
262
+ >
263
+ <select name="skin" aria-label="Habillage de la page de connexion">
264
+ <option
265
+ v-for="skin in card.skins.options"
266
+ :key="skin"
267
+ :value="skin"
268
+ :selected="skin === card.skins.selected"
269
+ >
270
+ {{ skin }}
271
+ </option>
272
+ </select>
273
+ <button type="submit">Voir</button>
274
+ </form>
275
+ </component>
276
+ </div>
277
+ <p v-if="section.note" class="nf-note">{{ section.note }}</p>
278
+ </section>
279
+ </main>
53
280
  </template>
@@ -1,45 +1,13 @@
1
1
  /*
2
- * Accent Vue — sa couleur et l'animation de son logo.
3
- *
4
- * La mise en page et la palette de la démonstration vivent dans
5
- * `showcase.css`, PARTAGÉE par les trois vitrines : seules ces variables
6
- * changent d'un framework à l'autre.
2
+ * La couleur du front de cette page — la SEULE chose qui change d'un front à
3
+ * l'autre. La mise en page, la palette et le mouvement vivent dans
4
+ * `showcase.css`, partagée, qui lit `--nf-front` pour le badge du front.
7
5
  *
8
6
  * Pourquoi un fichier CSS et non le bloc de styles du composant : Angular
9
- * renomme les `@keyframes` déclarés dans `styles: [...]` (encapsulation de
10
- * vue) — l'animation nommée par la variable ne serait alors plus trouvée.
11
- * Les trois vitrines utilisent donc le même mécanisme, un import CSS que
12
- * Vite injecte globalement.
7
+ * renomme ce qu'il déclare dans `styles: [...]` (encapsulation de vue). Les
8
+ * quatre fronts utilisent donc le même mécanisme, un import CSS que Vite
9
+ * injecte globalement.
13
10
  */
14
-
15
11
  :root {
16
- --nf-accent: #41b883;
17
- /* Encre : la MÊME teinte, assez foncée pour être lue SUR le lavis.
18
- La couleur de marque ne se négocie pas ; sa luminosité, si — écrire
19
- `--nf-accent` sur `--nf-accent-wash` donnait 2,78:1, sous le seuil AA. */
20
- --nf-accent-ink: #17714b;
21
- --nf-accent-glow: rgba(66, 184, 131, 0.35);
22
- --nf-accent-wash: rgba(66, 184, 131, 0.14);
23
- --nf-accent-line: rgba(66, 184, 131, 0.35);
24
- --nf-logo-anim: nf-float 4s ease-in-out infinite;
25
- }
26
- /* 🔴 L'encre du THÈME SOMBRE. La correction d'origine n'avait couvert qu'un
27
- seul des deux thèmes : sur fond sombre, le lavis devient foncé et cette
28
- encre-là, choisie pour être lue sur du clair, tombait à 2,41:1 — bien
29
- plus bas que le 2,78:1 qui avait motivé sa création. Mesuré sur une
30
- application générée, pas déduit du CSS.
31
- Sur un fond sombre il faut une encre CLAIRE (la couleur de marque elle-même) : #41b883 → 5,80:1. */
32
- @media (prefers-color-scheme: dark) {
33
- :root {
34
- --nf-accent-ink: #41b883;
35
- }
36
- }
37
- @keyframes nf-float {
38
- 0%,
39
- 100% {
40
- transform: translateY(0);
41
- }
42
- 50% {
43
- transform: translateY(-6px);
44
- }
12
+ --nf-front: <%= it.front.badge.color %>;
45
13
  }
@@ -1,24 +1,29 @@
1
1
  import { route, controller, Controller } from "@nodefony/framework";
2
2
  import type { ContextType } from "@nodefony/http";
3
+ <% if (it.complete) { %>import { loginPagePath } from "nodefony";
4
+ <% } %>import { renderHomePage } from "../home/homePage";
5
+
6
+ /** Un client qui DEMANDE du HTML le nomme ; `*\/*` (curl, un programme) n'en est pas un. */
7
+ const WANTS_HTML = /\btext\/html\b/u;
3
8
 
4
9
  /**
5
10
  * Accueil `GET /` — la racine de TON application.
6
11
  *
7
12
  * Sans frontend, une racine muette répond 404 : la première URL qu'on ouvre
8
- * après `npm run dev` dirait « rien ici ». Cette route dit QUI répond, et rien
9
- * de plus. Elle n'est générée que pour une app SANS frontend — avec un front,
10
- * c'est `AppController` qui tient `/`.
11
- *
12
- * ⚠️ **Volontairement sobre, et c'est une décision de sécurité.** Ce que cette
13
- * réponse contient part en PRODUCTION, vers n'importe qui. Énumérer les routes
14
- * internes, la console d'administration ou les chemins de documentation
15
- * décrirait ton architecture à qui la demande : c'est une divulgation, pas une
16
- * fonctionnalité. Ces informations se demandent au TERMINAL, où seul celui qui
17
- * a déjà la main les obtient : `npx nodefony card` (et sa porte HTTP de
18
- * développement, `@nodefony/devkit`, `policy: "dev"`, absente de la production).
13
+ * après `npm run dev` dirait « rien ici ». Cette route dit QUI répond, sous la
14
+ * forme que le client demande (négociation de contenu, RFC 9110 §12) :
15
+ * - un navigateur (`Accept: text/html`) reçoit la page d'accueil
16
+ * (`nodefony/home/homePage.ts`) ;
17
+ * - tout autre client — un programme, `curl` — reçoit `{ "app": … }`, comme
18
+ * avant : rien ne change pour lui.
19
+ * `Vary: Accept` dit aux caches que la réponse dépend de cet en-tête.
19
20
  *
20
- * Tu ajoutes un frontend plus tard (`nodefony create front`) ? Sa page vivra
21
- * sous sa propre route ; garde cet accueil JSON ou remplace-le, c'est TA racine.
21
+ * ⚠️ **Volontairement sobre en production, et c'est une décision de sécurité.**
22
+ * Ce que cette réponse contient part vers n'importe qui : le NOM, rien d'autre.
23
+ * Énumérer les routes internes, la console d'administration ou les chemins de
24
+ * documentation décrirait ton architecture à qui la demande. Les sections de
25
+ * développement de la page ne sont rendues qu'en développement ; ailleurs, ces
26
+ * informations se demandent au TERMINAL : `npx nodefony card`.
22
27
  */
23
28
  @controller("")
24
29
  class HomeController extends Controller {
@@ -28,19 +33,29 @@ class HomeController extends Controller {
28
33
 
29
34
  @route("app-home", { path: "/", method: "GET" })
30
35
  async home() {
31
- <% if (it.demo) { %> // Sans front choisi, l'accueil n'a pas de page : tant que la démo est
32
- // chargée, il y mène. Elle est `policy: "dev"` — la production la retire,
33
- // et ce JSON reprend sa place, sans rien à défaire le jour où tu supprimes
34
- // le module. (Avec un front, `/` sert TA page, démo ou pas.)
35
- if (this.kernel?.getModule("demo") !== undefined) {
36
- this.redirect("/demo");
37
- return;
36
+ const vary = { vary: "Accept" };
37
+ if (!WANTS_HTML.test(this.request?.headers.accept ?? "")) {
38
+ // Le NOM, rien d'autre. Pas de version du framework : une version
39
+ // exposée est une empreinte offerte à qui cherche une faille connue.
40
+ return this.renderJson({ app: "<%= it.appName %>" }, 200, vary);
38
41
  }
39
- <% } %> // Le NOM, rien d'autre. Pas de version du framework : un littéral figé à
40
- // la création deviendrait faux à la première mise à jour, et une version
41
- // exposée est une empreinte offerte à qui cherche une faille connue. La
42
- // vraie version se demande au terminal : `npx nodefony card`.
43
- return this.renderJson({ app: "<%= it.appName %>" });
42
+ const development = this.kernel?.isDev === true;
43
+ const html = renderHomePage({
44
+ appName: "<%= it.appName %>",
45
+ development,
46
+ // La démo est `policy: "dev"` : chargée, elle est proposée ; la
47
+ // production la retire, et le bouton avec elle.
48
+ demo:
49
+ development && this.kernel?.getModule("demo") !== undefined
50
+ ? "/demo"
51
+ : null,
52
+ <% if (it.complete) { %> user: this.user?.identifier ?? null,
53
+ loginHref: loginPagePath("/"),
54
+ <% } %> });
55
+ return this.render(html, "utf8", 200, {
56
+ ...vary,
57
+ "content-type": "text/html; charset=utf-8",
58
+ });
44
59
  }
45
60
  }
46
61
 
@@ -0,0 +1,163 @@
1
+ /**
2
+ * La page d'accueil HTML de <%= it.appName %> — c'est TA page.
3
+ *
4
+ * Rendue par le serveur (l'application n'a pas de front) avec la MÊME feuille
5
+ * que les accueils des fronts (`public/showcase.css`), et sans JavaScript : le
6
+ * thème suit celui du système.
7
+ *
8
+ * Ce que voit tout visiteur : la marque<% if (it.complete) { %>, la session<% } %>, puis le nom de
9
+ * l'application. En DÉVELOPPEMENT seulement : la présentation du framework, les
10
+ * liens utiles et où personnaliser la page (`homeContent.ts`) — le serveur ne
11
+ * les rend jamais en production.
12
+ */
13
+ import {
14
+ homeContent,
15
+ type IHomeCard,
16
+ type IHomeSection,
17
+ type IHomeText,
18
+ } from "./homeContent";
19
+
20
+ /** Ce que la page affiche pour CETTE requête. */
21
+ export interface IHomePageView {
22
+ readonly appName: string;
23
+ /** `true` en développement : les sections de `homeContent.ts` sont rendues. */
24
+ readonly development: boolean;
25
+ /** Adresse de la démo si elle est chargée, sinon `null`. */
26
+ readonly demo: string | null;
27
+ <% if (it.complete) { %> /** Identifiant du compte connecté, ou `null`. */
28
+ readonly user: string | null;
29
+ /** La page de connexion, avec le retour vers l'accueil. */
30
+ readonly loginHref: string;
31
+ <% } %>}
32
+
33
+ const ESCAPES: Readonly<Record<string, string>> = {
34
+ "&": "&amp;",
35
+ "<": "&lt;",
36
+ ">": "&gt;",
37
+ '"': "&quot;",
38
+ "'": "&#39;",
39
+ };
40
+
41
+ /** Échappe un texte pour le HTML — contenu comme valeur d'attribut. */
42
+ function esc(value: string): string {
43
+ return value.replace(/[&<>"']/gu, (c) => ESCAPES[c] ?? c);
44
+ }
45
+
46
+ function rich(text: readonly IHomeText[]): string {
47
+ return text
48
+ .map((part) =>
49
+ part.code ? `<code>${esc(part.text)}</code>` : esc(part.text),
50
+ )
51
+ .join("");
52
+ }
53
+
54
+ function card(item: IHomeCard): string {
55
+ const tag = item.href === null ? "div" : "a";
56
+ const href = item.href === null ? "" : ` href="${esc(item.href)}"`;
57
+ const tone = item.tone === "safe" ? " nf-safe" : "";
58
+ const creds =
59
+ item.creds === null
60
+ ? ""
61
+ : `<p class="nf-creds"><code>${esc(item.creds.user)}</code>${
62
+ item.creds.password === null
63
+ ? ""
64
+ : ` / <code>${esc(item.creds.password)}</code>`
65
+ }</p>`;
66
+ const go =
67
+ item.go === null ? "" : `<span class="nf-go">${esc(item.go)}</span>`;
68
+ const picker = item.skins;
69
+ const skins =
70
+ picker === null
71
+ ? ""
72
+ : `<form class="nf-skins" action="${esc(picker.action)}" method="get">` +
73
+ `<select name="skin" aria-label="Habillage de la page de connexion">${picker.options
74
+ .map(
75
+ (skin) =>
76
+ `<option value="${esc(skin)}"${skin === picker.selected ? " selected" : ""}>${esc(skin)}</option>`,
77
+ )
78
+ .join("")}</select><button type="submit">Voir</button></form>`;
79
+ return `<${tag} class="nf-card${tone}"${href}><h3>${esc(item.title)}</h3>${creds}<p>${rich(item.text)}</p>${go}${skins}</${tag}>`;
80
+ }
81
+
82
+ function section(item: IHomeSection): string {
83
+ const band = item.band ? " nf-band" : "";
84
+ const note =
85
+ item.note === null ? "" : `<p class="nf-note">${esc(item.note)}</p>`;
86
+ return (
87
+ `<section class="nf-section${band}" aria-labelledby="${item.id}-title">` +
88
+ `<div class="nf-sec-head"><p class="nf-kicker">${esc(item.kicker)}</p>` +
89
+ `<h2 id="${item.id}-title">${esc(item.title)}</h2><p>${esc(item.intro)}</p></div>` +
90
+ `<div class="nf-grid">${item.cards.map(card).join("")}</div>${note}</section>`
91
+ );
92
+ }
93
+
94
+ /**
95
+ * Rend la page d'accueil complète.
96
+ *
97
+ * @param view - ce que la page affiche pour cette requête
98
+ * @returns le document HTML
99
+ */
100
+ export function renderHomePage(view: IHomePageView): string {
101
+ const name = esc(view.appName);
102
+ const dev = view.development ? homeContent() : null;
103
+ const tag = dev === null ? "" : `<span class="nf-tag">développement</span>`;
104
+ const nav =
105
+ dev === null
106
+ ? ""
107
+ : `<nav class="nf-topnav" aria-label="Liens de développement">${
108
+ dev.console === null
109
+ ? ""
110
+ : `<a href="${esc(dev.console.href)}">${esc(dev.console.label)}</a><span class="nf-topnav-sep" aria-hidden="true"></span>`
111
+ }${dev.external
112
+ .map(
113
+ (link) =>
114
+ `<a class="nf-ext" href="${esc(link.href)}">${esc(link.label)}</a>`,
115
+ )
116
+ .join("")}</nav>`;
117
+ <% if (it.complete) { %> const session =
118
+ view.user === null
119
+ ? `<a class="nf-login" href="${esc(view.loginHref)}">Se connecter</a>`
120
+ : `<span class="nf-account"><span class="nf-session">${esc(view.user)}</span></span>`;
121
+ <% } else { %> const session = "";
122
+ <% } %> const hero =
123
+ dev === null
124
+ ? `<h1>${name}</h1>`
125
+ : `<h1>${esc(dev.hero.title)}</h1><p class="nf-sub">${esc(dev.hero.sub)}</p>` +
126
+ `<p class="nf-sig">${esc(dev.hero.sig)}</p>` +
127
+ `<div class="nf-badges"><span class="nf-badge nf-agentic">${esc(dev.hero.lead)}</span>${dev.hero.badges
128
+ .map((badge) => `<span class="nf-badge">${esc(badge)}</span>`)
129
+ .join("")}</div>` +
130
+ `<div class="nf-install" role="img" aria-label="Commande d'installation : ${esc(
131
+ `${dev.hero.install.command} ${dev.hero.install.arg}`,
132
+ )}"><span class="nf-p">$</span><span>${esc(dev.hero.install.command)} <b>${esc(
133
+ dev.hero.install.arg,
134
+ )}</b></span></div>` +
135
+ (view.demo === null
136
+ ? `<p class="nf-learn">${esc(dev.learn.label)} : <code>${esc(dev.learn.command)}</code> — ${esc(dev.learn.note)}</p>`
137
+ : `<div class="nf-cta"><a class="nf-btn nf-primary" href="${esc(view.demo)}">${esc(dev.demoLabel)}</a></div>`);
138
+ const sections = dev === null ? "" : dev.sections.map(section).join("");
139
+ return `<!doctype html>
140
+ <html lang="fr">
141
+ <head>
142
+ <meta charset="utf-8" />
143
+ <meta name="viewport" content="width=device-width,initial-scale=1" />
144
+ <title>${name}</title>
145
+ <meta name="description" content="${name} — application Nodefony." />
146
+ <meta name="color-scheme" content="light dark" />
147
+ <link rel="icon" href="/favicon.ico" />
148
+ <link rel="stylesheet" href="/showcase.css" />
149
+ </head>
150
+ <body>
151
+ <header class="nf-topbar">
152
+ <a class="nf-brand" href="/"><img src="/nodefony-logo.png" alt="" width="30" height="30" /><span>${name}</span>${tag}</a>
153
+ ${nav}
154
+ <div class="nf-topbar-tools">${session}</div>
155
+ </header>
156
+ <main class="nf-main">
157
+ <div class="nf-hero"><img class="nf-hero-logo" src="/nodefony-logo.png" alt="" width="80" height="80" fetchpriority="high" />${hero}</div>
158
+ ${sections}
159
+ </main>
160
+ </body>
161
+ </html>
162
+ `;
163
+ }
@@ -166,7 +166,7 @@ interface IItem {
166
166
  * la MÊME garde pour les DEUX portes : en
167
167
  * HTTP `@IsGranted` refuse (403) AVANT l'action ; par la socket, le pont
168
168
  * `api.request` re-traverse le MÊME pipeline (le token du handshake voyage
169
- * dans l'ALS) → même refus. En dev, `admin/<%= it.devAdminPassword %>` a le rôle.
169
+ * dans l'ALS) → même refus. En dev, le compte `admin` semé à la création (`nodefony/security/provisionUsers.ts`) a le rôle.
170
170
  */
171
171
  @route("<%= it.kebab %>-delete", {
172
172
  path: "/{id}",
@@ -100,7 +100,7 @@ let publishToChannel: RealtimePublish | null = null;
100
100
  * Action PROTÉGÉE par rôle (policy inline) : vue d'exploitation réservée —
101
101
  * sans `ROLE_ADMIN`, le voter refuse la frame AVANT d'entrer ici et
102
102
  * l'appelant reçoit une erreur JSON-RPC générique, jamais le détail
103
- * (Zero Trust). En dev, le compte seedé `admin/<%= it.devAdminPassword %>` a le rôle.
103
+ * (Zero Trust). En dev, le compte `admin` semé à la création (`nodefony/security/provisionUsers.ts`) a le rôle.
104
104
  */
105
105
  @RealtimeAction("<%= it.channel %>:snapshot", { roles: ["ROLE_ADMIN"] })
106
106
  snapshot() {
@@ -173,7 +173,7 @@ const itemPatch = itemBody.partial();
173
173
 
174
174
  <% if (it.hasSecurity) { %> /**
175
175
  * `DELETE <%= it.route %>/{id}` — protégée par rôle : `@IsGranted` refuse
176
- * (403) AVANT d'entrer dans l'action. En dev, `admin/<%= it.devAdminPassword %>` a le rôle.
176
+ * (403) AVANT d'entrer dans l'action. En dev, le compte `admin` semé à la création (`nodefony/security/provisionUsers.ts`) a le rôle.
177
177
  */
178
178
  @Delete("/{id}", { schema: { params: idParams } })
179
179
  @IsGranted("ROLE_ADMIN")