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
@@ -2,6 +2,9 @@ import { Controller, route, controller } from "@nodefony/framework";
2
2
  import type { ContextType } from "@nodefony/http";
3
3
  import { FrontendService } from "@nodefony/frontend";
4
4
 
5
+ /** L'entry Vite de cette page (`frontend.entries`). */
6
+ const ENTRY_NAME = "<%= it.appName %>";
7
+
5
8
  /**
6
9
  * Sert la page de l'app <%= it.frontend %>. Le HTML ne vit PAS ici : c'est la
7
10
  * coquille `frontend/index.html` (TA page — meta, polices, externals), dans
@@ -28,14 +31,21 @@ class AppController extends Controller {
28
31
  if (!(svc instanceof FrontendService)) {
29
32
  return this.render("<!-- @nodefony/frontend not ready -->");
30
33
  }
34
+ // En développement, les URLs vers Vite sont relatives à la page
35
+ // (`/_vite/<famille>/…`, relayées par Nodefony) : un poste, un conteneur
36
+ // ou un téléphone chargent la MÊME page sans configuration.
37
+ const html = svc.renderDocument(ENTRY_NAME, this.context?.cspNonce);
38
+ // La démo est-elle chargée ? Le serveur le SAIT : il le dit dans la page,
39
+ // que l'accueil lit sans requête — une sonde `/demo` rendait 404 sans la
40
+ // démo, et le navigateur l'inscrivait en erreur de console. Module
41
+ // `policy: "dev"` : absent en production, la balise aussi.
31
42
  return this.render(
32
- // En développement, les URLs vers Vite sont relatives à la page
33
- // (`/_vite/<famille>/…`, relayées par Nodefony) : un poste, un conteneur
34
- // ou un téléphone chargent la MÊME page sans configuration.
35
- svc.renderDocument(
36
- "<%= it.appName %>",
37
- this.context?.cspNonce,
38
- ),
43
+ this.kernel?.getModule("demo") === undefined
44
+ ? html
45
+ : html.replace(
46
+ "</head>",
47
+ '<meta name="nodefony-demo" content="/demo" />\n</head>',
48
+ ),
39
49
  );
40
50
  }
41
51
  }
@@ -1,55 +1,274 @@
1
1
  <script 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
6
- * le compte connecté<% } %>. Rien de plus : ce qui part ici part en PRODUCTION,
7
- * vers 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
6
+ * nom de l'application. Rien de plus en production : ni mot de passe, ni
7
+ * version, ni 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
12
  */
13
- <% if (it.hasSecurity) { %> import { onMount } from "svelte";
14
- // La liaison Svelte de la connexion : l'état de session en rune, la page de
13
+ import { onMount } from "svelte";
14
+ <% if (it.complete) { %> // La liaison Svelte de la connexion : l'état de session en rune, la page de
15
15
  // connexion servie par le framework (jamais un formulaire recopié ici).
16
16
  import { nodefonyLogin } from "nodefony/svelte";
17
17
  import { loginPagePath } from "nodefony/client";
18
18
  <% } %> import { NODEFONY_LOGO } from "./brand";
19
+ import { DEV_HOME } from "./devHome";
20
+ import {
21
+ applyDarkTheme,
22
+ findDebugBar,
23
+ findDemo,
24
+ readDarkTheme,
25
+ startPointerLight,
26
+ type IDebugBarHandle,
27
+ } from "./homeEffects";
19
28
  import "./showcase.css";
20
29
  import "./accent.css";
21
- <% if (it.hasSecurity) { %>
30
+
31
+ const dev = DEV_HOME;
32
+
33
+ // Thème clair/sombre : suit le système, un clic l'impose, retenu par ce navigateur.
34
+ const initialDark = readDarkTheme();
35
+ let dark = $state(initialDark);
36
+ applyDarkTheme(initialDark, false);
37
+ function toggleTheme(): void {
38
+ dark = !dark;
39
+ applyDarkTheme(dark);
40
+ }
41
+
42
+ // UN bouton pour la barre de debug : la cacher ou la montrer.
43
+ let bar = $state<IDebugBarHandle | null>(null);
44
+ let barVisible = $state(true);
45
+ function toggleBar(): void {
46
+ if (bar === null) return;
47
+ barVisible = !barVisible;
48
+ bar.setVisible(barVisible);
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 login = nodefonyLogin();
23
55
  const flow = login.flow;
24
56
  const loginHref = loginPagePath(location.pathname + location.search);
25
57
 
26
- // Reprend la session existante au montage (cookie de session, s'il y en a un).
27
- onMount(() => {
28
- void flow.me();
29
- });
30
-
31
58
  async function logout(): Promise<void> {
32
59
  // Session venue d'un fournisseur : suivre son adresse ferme AUSSI la sienne.
33
60
  const providerLogout = await flow.logout();
34
61
  if (providerLogout !== null) window.location.assign(providerLogout);
35
62
  }
36
- <% } %></script>
63
+ <% } %>
64
+ onMount(() => {
65
+ <% if (it.complete) { %> // Reprend la session existante au montage (cookie de session, s'il y en a un).
66
+ void flow.me();
67
+ <% } %> const stopLight = startPointerLight(".nf-card");
68
+ let frame = 0;
69
+ if (dev !== null) {
70
+ // La barre est injectée à côté de la page : sa poignée arrive après le rendu.
71
+ frame = requestAnimationFrame(() => {
72
+ bar = findDebugBar();
73
+ if (bar !== null) barVisible = bar.isVisible();
74
+ });
75
+ }
76
+ return () => {
77
+ stopLight();
78
+ cancelAnimationFrame(frame);
79
+ };
80
+ });
81
+ </script>
37
82
 
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
- {#if login.state.current.step === "authenticated" && login.state.current.user}
43
- <p>
44
- Connecté en tant que
45
- <span class="nf-session" data-open="">{login.state.current.user.identifier}</span>
46
- <button type="button" class="nf-action" onclick={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
+ {#if dev}<span class="nf-tag">développement</span>{/if}
88
+ </a>
89
+ {#if dev}
90
+ <nav class="nf-topnav" aria-label="Liens de développement">
91
+ {#if dev.console}
92
+ <a href={dev.console.href}>{dev.console.label}</a>
93
+ <span class="nf-topnav-sep" aria-hidden="true"></span>
94
+ {/if}
95
+ {#each dev.external as link (link.href)}
96
+ <a class="nf-ext" href={link.href}>{link.label}</a>
97
+ {/each}
98
+ </nav>
99
+ {/if}
100
+ <div class="nf-topbar-tools">
101
+ <div class="nf-tools" role="group" aria-label="Affichage">
102
+ <button
103
+ type="button"
104
+ class="nf-tool"
105
+ aria-pressed={dark}
106
+ aria-label="Thème sombre"
107
+ title="Thème sombre"
108
+ onclick={toggleTheme}
109
+ >
110
+ {#if dark}
111
+ <svg
112
+ viewBox="0 0 24 24"
113
+ fill="none"
114
+ stroke="currentColor"
115
+ stroke-width="2"
116
+ aria-hidden="true"
117
+ >
118
+ <circle cx="12" cy="12" r="4" />
119
+ <path
120
+ 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"
121
+ />
122
+ </svg>
123
+ {:else}
124
+ <svg
125
+ viewBox="0 0 24 24"
126
+ fill="none"
127
+ stroke="currentColor"
128
+ stroke-width="2"
129
+ aria-hidden="true"
130
+ >
131
+ <path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z" />
132
+ </svg>
133
+ {/if}
134
+ </button>
135
+ {#if bar}
136
+ <button
137
+ type="button"
138
+ class="nf-tool"
139
+ aria-pressed={!barVisible}
140
+ aria-label="Cacher la barre de debug"
141
+ title="Cacher la barre de debug"
142
+ onclick={toggleBar}
143
+ >
144
+ <svg
145
+ viewBox="0 0 24 24"
146
+ fill="none"
147
+ stroke="currentColor"
148
+ stroke-width="2"
149
+ stroke-linecap="round"
150
+ aria-hidden="true"
151
+ >
152
+ <path d="M8 2l1.9 1.9M16 2l-1.9 1.9" />
153
+ <rect x="7" y="6" width="10" height="14" rx="5" />
154
+ <path
155
+ d="M12 10v10M3 13h4M17 13h4M4 7l3 2M20 7l-3 2M4 19l3-2M20 19l-3-2"
156
+ />
157
+ </svg>
158
+ </button>
159
+ {/if}
160
+ </div>
161
+ <% if (it.complete) { %> {#if login.state.current.step === "authenticated" && login.state.current.user}
162
+ <span class="nf-account">
163
+ <span class="nf-session">{login.state.current.user.identifier}</span>
164
+ <button type="button" class="nf-account-out" onclick={logout}>
47
165
  Se déconnecter
48
166
  </button>
49
- </p>
167
+ </span>
50
168
  {:else}
51
- <a class="nf-action" href={loginHref}>Se connecter</a>
169
+ <a class="nf-login" href={loginHref}>Se connecter</a>
170
+ {/if}
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
+ {#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}
194
+ {dev.front.version}
195
+ </span>
196
+ {#each dev.hero.badges as badge (badge)}
197
+ <span class="nf-badge">{badge}</span>
198
+ {/each}
199
+ </div>
200
+ <div
201
+ class="nf-install"
202
+ role="img"
203
+ aria-label={`Commande d'installation : ${dev.hero.install.command} ${dev.hero.install.arg}`}
204
+ >
205
+ <span class="nf-p">$</span>
206
+ <span>{dev.hero.install.command} <b>{dev.hero.install.arg}</b></span>
207
+ </div>
208
+ {#if demo !== null}
209
+ <div class="nf-cta">
210
+ <a class="nf-btn nf-primary" href={demo}>{dev.demoLabel}</a>
211
+ </div>
212
+ {:else}
213
+ <p class="nf-learn">
214
+ {dev.learn.label} : <code>{dev.learn.command}</code> — {dev.learn.note}
215
+ </p>
216
+ {/if}
217
+ {:else}
218
+ <h1><%= it.appName %></h1>
52
219
  {/if}
53
220
  </div>
54
- <% } else { %> <p class="nf-dim">Ton application répond. Cette page est la tienne.</p>
55
- <% } %></main>
221
+
222
+ {#each dev?.sections ?? [] as section (section.id)}
223
+ <section
224
+ class={section.band ? "nf-section nf-band" : "nf-section"}
225
+ aria-labelledby={`${section.id}-title`}
226
+ >
227
+ <div class="nf-sec-head">
228
+ <p class="nf-kicker">{section.kicker}</p>
229
+ <h2 id={`${section.id}-title`}>{section.title}</h2>
230
+ <p>{section.intro}</p>
231
+ </div>
232
+ <div class="nf-grid">
233
+ {#each section.cards as card (card.title)}
234
+ <svelte:element
235
+ this={card.href !== null ? "a" : "div"}
236
+ class={card.tone === "safe" ? "nf-card nf-safe" : "nf-card"}
237
+ href={card.href ?? undefined}
238
+ >
239
+ <h3>{card.title}</h3>
240
+ {#if card.creds}
241
+ <p class="nf-creds">
242
+ <code>{card.creds.user}</code>
243
+ {#if card.creds.password !== null}
244
+ / <code>{card.creds.password}</code>
245
+ {/if}
246
+ </p>
247
+ {/if}
248
+ <p>
249
+ {#each card.text as part, i (i)}{#if part.code}<code
250
+ >{part.text}</code
251
+ >{:else}{part.text}{/if}{/each}
252
+ </p>
253
+ {#if card.go}<span class="nf-go">{card.go}</span>{/if}
254
+ {#if card.skins}
255
+ <form class="nf-skins" action={card.skins.action} method="get">
256
+ <select
257
+ name="skin"
258
+ aria-label="Habillage de la page de connexion"
259
+ value={card.skins.selected}
260
+ >
261
+ {#each card.skins.options as skin (skin)}
262
+ <option value={skin}>{skin}</option>
263
+ {/each}
264
+ </select>
265
+ <button type="submit">Voir</button>
266
+ </form>
267
+ {/if}
268
+ </svelte:element>
269
+ {/each}
270
+ </div>
271
+ {#if section.note}<p class="nf-note">{section.note}</p>{/if}
272
+ </section>
273
+ {/each}
274
+ </main>
@@ -1,45 +1,13 @@
1
1
  /*
2
- * Accent Svelte — 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 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
- * Toutes les 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: #ff3e00;
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: #a62c00;
21
- --nf-accent-glow: rgba(255, 62, 0, 0.35);
22
- --nf-accent-wash: rgba(255, 62, 0, 0.14);
23
- --nf-accent-line: rgba(255, 62, 0, 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,26: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 : #ff4f17 → 4,84:1. */
32
- @media (prefers-color-scheme: dark) {
33
- :root {
34
- --nf-accent-ink: #ff4f17;
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
  }