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
@@ -3,8 +3,14 @@ import { NODEFONY_LOGO } from "./brand";
3
3
  import { DEMOS, type IDemoEntry } from "../../demos";
4
4
  import { DEMO_ABOUT_PATH, docsVersion, docUrl, type IDemoAbout, parseDemoAbout, REPO_URL } from "./about";
5
5
  import { Catalogue } from "./Catalogue";
6
- import { debugBarControl, type IDebugBarControl } from "./debugBar";
7
- import { useCurrentSection, usePointerLight } from "./effects";
6
+ import { useCurrentSection } from "./effects";
7
+ import {
8
+ applyDarkTheme,
9
+ findDebugBar,
10
+ readDarkTheme,
11
+ startPointerLight,
12
+ type IDebugBarHandle,
13
+ } from "./homeEffects";
8
14
  import { ChatLesson } from "./chat/ChatLesson";
9
15
  import { FirstStepsLesson } from "./first/FirstStepsLesson";
10
16
  import { GrpcLesson } from "./grpc/GrpcLesson";
@@ -17,14 +23,17 @@ import { SseLesson } from "./sse/SseLesson";
17
23
  import { VideoLesson } from "./video/VideoLesson";
18
24
  import { UploadLesson } from "./upload/UploadLesson";
19
25
  import { Account } from "./kit/Account";
20
- import { applyTheme, readTheme, type DemoTheme } from "./kit/theme";
21
26
  import { PartnerLesson } from "./partner/PartnerLesson";
22
27
  import { RoleTabs } from "./RoleTabs";
23
28
  import { usePulse } from "./usePulse";
29
+ // La feuille de l'accueil d'abord — jetons, en-tête, effets, partagés avec
30
+ // l'accueil de l'application —, puis ce qui n'appartient qu'à la démo.
31
+ import "./showcase.css";
24
32
  import "./demo.css";
25
33
 
26
- // Le thème AVANT le premier rendu : sombre par défaut, sinon le choix retenu.
27
- applyTheme(readTheme());
34
+ // Le thème AVANT le premier rendu : le choix retenu, sinon celui du système.
35
+ // Même clé que l'accueil de l'application : un choix vaut pour les deux.
36
+ applyDarkTheme(readDarkTheme(), false);
28
37
 
29
38
  /** Les sections que la barre du haut permet d'atteindre, dans l'ordre. */
30
39
  const SECTIONS = [
@@ -43,7 +52,7 @@ const SECTION_IDS = SECTIONS.map((section) => section.id);
43
52
  *
44
53
  * Guide pour un agent : la page lit son identité à `/demo/api/about`
45
54
  * (`DemoController`, type partagé `IDemoAbout`) et pilote la barre de debug
46
- * par sa poignée publiée (`debugBar.ts`), sans importer le widget. Le
55
+ * par sa poignée publiée (`homeEffects.ts`, partagé avec l'accueil), sans importer le widget. Le
47
56
  * catalogue et les onglets de métier lisent l'index `modules/demo/demos.ts`
48
57
  * — une démo s'ajoute là, jamais dans la page.
49
58
  */
@@ -107,7 +116,7 @@ export function App() {
107
116
  /** L'accueil : le haut de page, les métiers, le catalogue vivant, le socle. */
108
117
  function Home({ about }: { about: IDemoAbout | null }) {
109
118
  const version = docsVersion(about);
110
- usePointerLight(".card");
119
+ useEffect(() => startPointerLight(".card"), []);
111
120
  const pulse = usePulse();
112
121
  return (
113
122
  <>
@@ -163,7 +172,8 @@ function Topbar({ about, home }: { about: IDemoAbout | null; home: boolean }) {
163
172
  // l'opacité, jamais sur `visibility`, qui retirerait une identité du nom.
164
173
  return (
165
174
  <header className="topbar">
166
- <a className="brand" href="/demo">
175
+ {/* La marque mène à l'accueil de l'APPLICATION, comme partout. */}
176
+ <a className="brand" href="/">
167
177
  <span className="id id-app">
168
178
  {/* Espaces entre les éléments : sans eux, le texte lu est
169
179
  « mon-appdémov0.1.0 » et ne correspond plus au nom accessible. */}
@@ -207,7 +217,7 @@ function Topbar({ about, home }: { about: IDemoAbout | null; home: boolean }) {
207
217
  <div className="topbar-tools">
208
218
  <div className="tools" role="group" aria-label="Affichage">
209
219
  <ThemeButton />
210
- <DebugBarButtons />
220
+ <DebugBarButton />
211
221
  </div>
212
222
  {/* Place RÉSERVÉE dès le premier rendu : la session se lit après, et
213
223
  l'apparition du compte faisait passer l'en-tête sur deux lignes —
@@ -222,10 +232,8 @@ function Topbar({ about, home }: { about: IDemoAbout | null; home: boolean }) {
222
232
 
223
233
  /** Sombre ou clair : le choix est retenu par le navigateur. */
224
234
  function ThemeButton() {
225
- const [theme, setTheme] = useState<DemoTheme>(readTheme);
226
- const next: DemoTheme = theme === "dark" ? "light" : "dark";
227
- const label =
228
- next === "light" ? "Passer en thème clair" : "Passer en thème sombre";
235
+ const [dark, setDark] = useState(readDarkTheme);
236
+ const label = dark ? "Passer en thème clair" : "Passer en thème sombre";
229
237
  return (
230
238
  <button
231
239
  type="button"
@@ -233,11 +241,11 @@ function ThemeButton() {
233
241
  aria-label={label}
234
242
  title={label}
235
243
  onClick={() => {
236
- applyTheme(next, true);
237
- setTheme(next);
244
+ applyDarkTheme(!dark);
245
+ setDark(!dark);
238
246
  }}
239
247
  >
240
- {theme === "dark" ? (
248
+ {dark ? (
241
249
  <svg
242
250
  viewBox="0 0 24 24"
243
251
  fill="none"
@@ -268,86 +276,51 @@ function ThemeButton() {
268
276
  }
269
277
 
270
278
  /**
271
- * Les deux boutons de la barre de debug — afficher/cacher, réduire en
272
- * pastille. Rendus seulement si la barre est montée (développement).
279
+ * UN bouton pour la barre de debug : la cacher ou la montrer — le même geste
280
+ * que l'accueil de l'application. Rendu seulement si la barre est montée
281
+ * (développement) ; la réduire en pastille se fait sur la barre elle-même.
273
282
  */
274
- function DebugBarButtons() {
275
- const [control, setControl] = useState<IDebugBarControl | null>(null);
283
+ function DebugBarButton() {
284
+ const [bar, setBar] = useState<IDebugBarHandle | null>(null);
276
285
  const [visible, setVisible] = useState(true);
277
- const [minimized, setMinimized] = useState(false);
278
286
  useEffect(() => {
279
287
  // La barre est injectée par le serveur à côté de la page : elle peut
280
288
  // publier sa poignée juste après le premier rendu.
281
289
  const frame = requestAnimationFrame(() => {
282
- const found = debugBarControl();
283
- setControl(found);
290
+ const found = findDebugBar();
291
+ setBar(found);
284
292
  if (found) setVisible(found.isVisible());
285
293
  });
286
294
  return () => cancelAnimationFrame(frame);
287
295
  }, []);
288
- if (control === null) return null;
296
+ if (bar === null) return null;
289
297
  return (
290
- <>
291
- <button
292
- type="button"
293
- className="dbg-btn"
294
- aria-pressed={visible}
295
- aria-label="Afficher ou cacher la barre de debug"
296
- title="Afficher ou cacher la barre de debug"
297
- onClick={() => {
298
- control.setVisible(!visible);
299
- setVisible(!visible);
300
- }}
301
- >
302
- <svg
303
- viewBox="0 0 24 24"
304
- fill="none"
305
- stroke="currentColor"
306
- strokeWidth="2"
307
- strokeLinecap="round"
308
- strokeLinejoin="round"
309
- aria-hidden="true"
310
- >
311
- <path d="M8 2l1.9 1.9M16 2l-1.9 1.9" />
312
- <path d="M9 7.1V6a3 3 0 0 1 6 0v1.1" />
313
- <path d="M12 20c-3.3 0-6-2.7-6-6v-3a4 4 0 0 1 4-4h4a4 4 0 0 1 4 4v3c0 3.3-2.7 6-6 6z" />
314
- <path d="M12 20v-9M6.5 9H3M6 13H2M6 17H3M17.5 9H21M18 13h4M18 17h3" />
315
- </svg>
316
- </button>
317
- <button
318
- type="button"
319
- className="dbg-btn"
320
- disabled={!visible}
321
- aria-pressed={minimized}
322
- aria-label={
323
- minimized
324
- ? "Déplier la barre de debug"
325
- : "Réduire la barre de debug en pastille"
326
- }
327
- title={
328
- minimized
329
- ? "Déplier la barre de debug"
330
- : "Réduire la barre de debug en pastille"
331
- }
332
- onClick={() => {
333
- if (minimized) control.restore();
334
- else control.minimize();
335
- setMinimized(!minimized);
336
- }}
298
+ <button
299
+ type="button"
300
+ className="dbg-btn"
301
+ aria-pressed={!visible}
302
+ aria-label="Cacher la barre de debug"
303
+ title="Cacher la barre de debug"
304
+ onClick={() => {
305
+ bar.setVisible(!visible);
306
+ setVisible(!visible);
307
+ }}
308
+ >
309
+ <svg
310
+ viewBox="0 0 24 24"
311
+ fill="none"
312
+ stroke="currentColor"
313
+ strokeWidth="2"
314
+ strokeLinecap="round"
315
+ strokeLinejoin="round"
316
+ aria-hidden="true"
337
317
  >
338
- <svg
339
- viewBox="0 0 24 24"
340
- fill="none"
341
- stroke="currentColor"
342
- strokeWidth="2"
343
- strokeLinecap="round"
344
- strokeLinejoin="round"
345
- aria-hidden="true"
346
- >
347
- <path d="M4 14h6v6M20 10h-6V4M14 10l7-7M3 21l7-7" />
348
- </svg>
349
- </button>
350
- </>
318
+ <path d="M8 2l1.9 1.9M16 2l-1.9 1.9" />
319
+ <path d="M9 7.1V6a3 3 0 0 1 6 0v1.1" />
320
+ <path d="M12 20c-3.3 0-6-2.7-6-6v-3a4 4 0 0 1 4-4h4a4 4 0 0 1 4 4v3c0 3.3-2.7 6-6 6z" />
321
+ <path d="M12 20v-9M6.5 9H3M6 13H2M6 17H3M17.5 9H21M18 13h4M18 17h3" />
322
+ </svg>
323
+ </button>
351
324
  );
352
325
  }
353
326
 
@@ -1,23 +1,15 @@
1
1
  /*
2
- * Feuille de la démo — reprise de la maquette validée (#747) : mêmes jetons
3
- * que l’accueil du cœur. Le logo arrive par `--demo-logo`, posé par la page
4
- * depuis le paquet (`brand.ts`) : jamais une copie embarquée ici.
5
- */
6
- /* Mise en page : celle de l'accueil du cœur (nodefony/views/index.eta), mêmes jetons ;
7
- le catalogue des démos remplace les quatre fronts et Studio. */
8
- /*
9
- * Thème clair : les trois couleurs du LOGO (bleu #0067ba, cyan #00a0f2,
10
- * vert #448438) sur un fond teinté de leur bleu — jamais un blanc nu. Le bleu
11
- * est celui du logo, tel quel ; le cyan et le vert sont assombris juste assez
12
- * pour tenir 4,5:1 en texte sur le fond, la carte ET la bande douce.
2
+ * Feuille de la démo — reprise de la maquette validée (#747). Le logo arrive
3
+ * par `--demo-logo`, posé par la page depuis le paquet (`brand.ts`) : jamais
4
+ * une copie embarquée ici.
5
+ *
6
+ * Les jetons (couleurs des deux thèmes, ombres, ressort), la page (police,
7
+ * fond, liens, focus) et les effets de l'accueil viennent de `showcase.css`,
8
+ * la feuille de l'accueil de l'application, chargée AVANT celle-ci : une seule
9
+ * source, la démo et l'application ne peuvent plus diverger. Ne vivent ici que
10
+ * les jetons propres à la démo.
13
11
  */
14
12
  :root {
15
- --blue: #0067ba;
16
- /* Bleu d'un TEXTE (lien, bouton sans fond) : `--blue` remplit, et ne tient
17
- pas 4,5:1 en texte sur le fond sombre. */
18
- --link: var(--blue);
19
- --cyan: #00699f;
20
- --green: #3b7430;
21
13
  --amber: #8a5a10;
22
14
  --violet: #6b3fb0;
23
15
  /* Un refus, une erreur (leçon MCP) — jamais une série de graphe. */
@@ -29,36 +21,15 @@
29
21
  /* Séries des graphes du fil (validées CVD) : CBOR, texte. */
30
22
  --wire-cbor: #0067ba;
31
23
  --wire-text: #8a5a10;
32
- --bg: #e9f0f8;
33
- --bg-soft: #dde7f3;
34
- --fg: #0a2440;
35
- --muted: #3d5571;
36
- --card: #f7fafd;
37
- --border: #c4d4e6;
38
- --code-bg: #0a2440;
39
- --code-fg: #d9e6f5;
40
- /* Le halo du haut de page : le bleu et le vert du logo. */
41
- --wash-blue: rgba(0, 160, 242, 0.16);
42
- --wash-green: rgba(68, 132, 56, 0.1);
43
24
  /* Le pied de page : un bandeau marine, celui du bleu du logo. */
44
25
  --footer-bg: #0a2440;
45
26
  --footer-fg: #c9d6e8;
46
27
  --footer-link: #8fcdf7;
47
- --shadow:
48
- 0 1px 2px rgba(10, 36, 64, 0.06), 0 8px 24px rgba(0, 103, 186, 0.08);
49
- --shadow-hover:
50
- 0 2px 4px rgba(10, 36, 64, 0.08), 0 14px 34px rgba(0, 103, 186, 0.2);
51
28
  }
52
29
  @media (prefers-color-scheme: dark) {
53
30
  :root:not([data-theme="light"]) {
54
- --blue: #096bbf;
55
- --link: color-mix(in srgb, var(--blue) 50%, var(--fg));
56
- --cyan: #1ea0ec;
57
- --green: #4a8b3e;
58
31
  --amber: #b7791f;
59
32
  --violet: #7c4dbd;
60
- --wash-blue: rgba(30, 160, 236, 0.08);
61
- --wash-green: rgba(74, 139, 62, 0.06);
62
33
  --footer-bg: #060a14;
63
34
  --footer-fg: #c9d6e8;
64
35
  --footer-link: #8fcdf7;
@@ -67,74 +38,20 @@
67
38
  /* Ma bulle en sombre : l'accent DÉSATURÉ par la surface (Material, thème
68
39
  sombre) — plein, il éblouissait. Le blanc y garde un contraste élevé. */
69
40
  --accent-bubble: color-mix(in srgb, var(--blue) 30%, transparent);
70
- --bg: #0a0f1c;
71
- --bg-soft: #0e1524;
72
- --fg: #e8edf6;
73
- --muted: #93a1ba;
74
- --card: #111828;
75
- --border: #223046;
76
- --code-bg: #0b1220;
77
- --code-fg: #cfe0f2;
78
41
  --wire-cbor: #3d9be6;
79
- --shadow: 0 1px 2px rgba(0, 0, 0, 0.3), 0 8px 24px rgba(0, 0, 0, 0.35);
80
- --shadow-hover:
81
- 0 2px 4px rgba(0, 0, 0, 0.3), 0 14px 34px rgba(30, 160, 236, 0.18);
82
- color-scheme: dark;
83
42
  }
84
43
  }
85
44
  :root[data-theme="dark"] {
86
- --blue: #096bbf;
87
- --link: color-mix(in srgb, var(--blue) 50%, var(--fg));
88
- --cyan: #1ea0ec;
89
- --green: #4a8b3e;
90
45
  --amber: #b7791f;
91
46
  --violet: #7c4dbd;
92
- --wash-blue: rgba(30, 160, 236, 0.08);
93
- --wash-green: rgba(74, 139, 62, 0.06);
94
47
  --footer-bg: #060a14;
95
48
  --footer-fg: #c9d6e8;
96
49
  --footer-link: #8fcdf7;
97
50
  --wire-cbor: #3d9be6;
98
- --bg: #0a0f1c;
99
51
  --danger: #e0646a;
100
52
  --on-danger: #1b0a0b;
101
53
  /* Ma bulle en sombre : un voile plus dense, toujours translucide. */
102
54
  --accent-bubble: color-mix(in srgb, var(--blue) 30%, transparent);
103
- --bg-soft: #0e1524;
104
- --fg: #e8edf6;
105
- --muted: #93a1ba;
106
- --card: #111828;
107
- --border: #223046;
108
- --code-bg: #0b1220;
109
- --code-fg: #cfe0f2;
110
- --shadow: 0 1px 2px rgba(0, 0, 0, 0.3), 0 8px 24px rgba(0, 0, 0, 0.35);
111
- --shadow-hover:
112
- 0 2px 4px rgba(0, 0, 0, 0.3), 0 14px 34px rgba(30, 160, 236, 0.18);
113
- color-scheme: dark;
114
- }
115
- * {
116
- box-sizing: border-box;
117
- }
118
- body {
119
- margin: 0;
120
- font-family:
121
- ui-sans-serif,
122
- system-ui,
123
- -apple-system,
124
- "Segoe UI",
125
- Roboto,
126
- sans-serif;
127
- color: var(--fg);
128
- background:
129
- radial-gradient(
130
- 1100px 520px at 30% -12%,
131
- var(--wash-blue),
132
- transparent 62%
133
- ),
134
- radial-gradient(900px 460px at 78% -8%, var(--wash-green), transparent 60%),
135
- var(--bg);
136
- line-height: 1.6;
137
- font-size: 15px;
138
55
  }
139
56
  body::before {
140
57
  content: "";
@@ -144,15 +61,6 @@ body::before {
144
61
  z-index: 30;
145
62
  background: var(--bg);
146
63
  }
147
- a {
148
- color: var(--link);
149
- }
150
- a:focus-visible,
151
- button:focus-visible {
152
- outline: 2px solid var(--cyan);
153
- outline-offset: 3px;
154
- border-radius: 4px;
155
- }
156
64
  code {
157
65
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
158
66
  font-size: 0.85em;
@@ -711,48 +619,18 @@ footer a,
711
619
  footer code {
712
620
  color: var(--footer-link);
713
621
  }
714
- /* Barre de debug (développement) : fixée en bas, elle publie sa hauteur dans
715
- --nodefony-debugbar-height (0px réduite ou en haut) ; la page la réserve. */
716
- body {
717
- padding-bottom: var(--nodefony-debugbar-height, 0px);
718
- }
719
- /* ═══ Effets — CSS natif, piloté par le défilement (aucun écouteur de scroll) ═══ */
720
- @property --spin {
721
- syntax: "<angle>";
722
- inherits: false;
723
- initial-value: 0deg;
724
- }
725
- :root {
726
- --spring: linear(
727
- 0,
728
- 0.009,
729
- 0.035 2.1%,
730
- 0.141 4.4%,
731
- 0.723 12.9%,
732
- 0.938 16.7%,
733
- 1.017 19.4%,
734
- 1.067,
735
- 1.084 26.3%,
736
- 1.077 29.4%,
737
- 1.006 41.1%,
738
- 0.993 46.5%,
739
- 1
740
- );
741
- }
622
+ /* ═══ Effets — CSS natif, piloté par le défilement (aucun écouteur de scroll).
623
+ `--spin`, `--spring` et la place de la barre de debug viennent de
624
+ `showcase.css`. ═══ */
742
625
  html {
743
626
  scroll-behavior: smooth;
744
627
  scroll-padding-top: 84px;
745
- scrollbar-gutter: stable;
746
628
  scrollbar-width: thin;
747
629
  scrollbar-color: color-mix(in srgb, var(--muted) 45%, transparent) transparent;
748
630
  }
749
631
  ::selection {
750
632
  background: color-mix(in srgb, var(--cyan) 30%, transparent);
751
633
  }
752
- p,
753
- li {
754
- text-wrap: pretty;
755
- }
756
634
  pre {
757
635
  overscroll-behavior-x: contain;
758
636
  scrollbar-width: thin;
@@ -1,44 +1,13 @@
1
1
  import { useEffect, useState } from "react";
2
2
 
3
3
  /**
4
- * Les deux comportements animés de l'accueil, tous deux bornés. Le reste
5
- * (fil de lecture, apparition des blocs, ombre de la barre) est du CSS
6
- * piloté par le défilement, dans `demo.css`.
4
+ * Ce que seule la démo anime : la section en cours de lecture et la navigation
5
+ * au clavier dans les onglets. Les gestes de l'accueil — thème, lumière sous le
6
+ * pointeur, barre de debug — viennent de `homeEffects.ts`, partagé avec
7
+ * l'accueil de l'application ; le reste du mouvement est du CSS piloté par le
8
+ * défilement, dans `showcase.css` et `demo.css`.
7
9
  */
8
10
 
9
- /**
10
- * Lumière qui suit le pointeur sur les cartes : UN écouteur délégué sur le
11
- * document, au plus un calcul par image. La feuille lit `--mx`/`--my`.
12
- */
13
- export function usePointerLight(selector: string): void {
14
- useEffect(() => {
15
- let frame = 0;
16
- let target: HTMLElement | null = null;
17
- let x = 0;
18
- let y = 0;
19
- const paint = () => {
20
- frame = 0;
21
- if (target === null) return;
22
- const box = target.getBoundingClientRect();
23
- target.style.setProperty("--mx", `${x - box.left}px`);
24
- target.style.setProperty("--my", `${y - box.top}px`);
25
- };
26
- const onMove = (event: PointerEvent) => {
27
- const found =
28
- event.target instanceof Element ? event.target.closest(selector) : null;
29
- target = found instanceof HTMLElement ? found : null;
30
- x = event.clientX;
31
- y = event.clientY;
32
- if (target !== null && frame === 0) frame = requestAnimationFrame(paint);
33
- };
34
- document.addEventListener("pointermove", onMove, { passive: true });
35
- return () => {
36
- document.removeEventListener("pointermove", onMove);
37
- cancelAnimationFrame(frame);
38
- };
39
- }, [selector]);
40
- }
41
-
42
11
  /**
43
12
  * Touche → index de l'onglet visé, relatif à l'onglet courant (patron WAI-ARIA
44
13
  * « tabs » : flèches, Début, Fin). Partagé par tous les onglets de la démo.
@@ -367,7 +367,7 @@ class <%= it.pascal %>Controller extends ResourceController<<%= it.pascal %>Row>
367
367
  <% if (it.hasSecurity) { %> * **Réservée à `ROLE_ADMIN`** : `@IsGranted` refuse AVANT même d'entrer dans
368
368
  * l'action. C'est la seule route de ce contrôleur qui DÉTRUISE — la laisser
369
369
  * ouverte reviendrait à livrer une application où n'importe qui efface les
370
- * données d'autrui. En développement, `admin/<%= it.devAdminPassword %>` porte ce rôle.
370
+ * données d'autrui. En développement, le compte `admin` semé à la création (`nodefony/security/provisionUsers.ts`) porte ce rôle.
371
371
  *
372
372
  * Pour ouvrir davantage (une équipe, un rôle métier), change le rôle ici, ou
373
373
  * déclare une zone dans `security.areas` qui couvre `<%= it.route %>` — les
@@ -1,56 +0,0 @@
1
- /**
2
- * Pilote la barre de debug que Nodefony injecte en développement.
3
- *
4
- * La barre publie sa poignée sur `globalThis.__NODEFONY_DEBUGBAR__`
5
- * (`DebugBarHandle` de `nodefony/debugbar`) ; on la lit ici SANS importer le
6
- * widget, qui entrerait sinon dans le bundle de la page. Absente (production,
7
- * barre non montée) : `null`, et la page cache ses boutons.
8
- */
9
- export interface IDebugBarControl {
10
- isVisible(): boolean;
11
- setVisible(visible: boolean): void;
12
- minimize(): void;
13
- restore(): void;
14
- }
15
-
16
- /** Clé sous laquelle la barre publie sa poignée. */
17
- const HANDLE_KEY = "__NODEFONY_DEBUGBAR__";
18
-
19
- /**
20
- * Rend la poignée de la barre de debug, vérifiée méthode par méthode.
21
- *
22
- * @returns la poignée, ou `null` si la barre n'est pas montée
23
- */
24
- export function debugBarControl(): IDebugBarControl | null {
25
- const handle: unknown = Reflect.get(globalThis, HANDLE_KEY);
26
- if (typeof handle !== "object" || handle === null) return null;
27
- if (
28
- !("isVisible" in handle) ||
29
- !("setVisible" in handle) ||
30
- !("minimize" in handle) ||
31
- !("restore" in handle)
32
- ) {
33
- return null;
34
- }
35
- const { isVisible, setVisible, minimize, restore } = handle;
36
- if (
37
- typeof isVisible !== "function" ||
38
- typeof setVisible !== "function" ||
39
- typeof minimize !== "function" ||
40
- typeof restore !== "function"
41
- ) {
42
- return null;
43
- }
44
- return {
45
- isVisible: () => isVisible.call(handle) === true,
46
- setVisible: (visible) => {
47
- setVisible.call(handle, visible);
48
- },
49
- minimize: () => {
50
- minimize.call(handle);
51
- },
52
- restore: () => {
53
- restore.call(handle);
54
- },
55
- };
56
- }
@@ -1,51 +0,0 @@
1
- /**
2
- * Le thème de la démo : celui du SYSTÈME par défaut, l'autre au choix du
3
- * visiteur, et ce choix retenu par le navigateur (`localStorage`) — un réglage
4
- * d'affichage n'a rien à faire en session serveur, et un visiteur n'en a pas
5
- * toujours une.
6
- *
7
- * Guide pour un agent : brique du KIT. La feuille lit `data-theme` sur
8
- * `<html>` (jetons `:root[data-theme="dark"]`) ; `applyTheme()` le pose
9
- * AVANT le premier rendu (appelé à l'import de `App.tsx`), sans quoi la
10
- * page clignoterait en clair. Le stockage peut manquer (navigation privée,
11
- * données bloquées) : le thème marche alors pour la page, sans mémoire.
12
- */
13
-
14
- export type DemoTheme = "dark" | "light";
15
-
16
- /** La clé du choix dans `localStorage`. */
17
- export const THEME_KEY = "nodefony-demo-theme";
18
-
19
- /** Le thème retenu par le visiteur, sinon celui du système. */
20
- export function readTheme(): DemoTheme {
21
- try {
22
- const stored = window.localStorage.getItem(THEME_KEY);
23
- if (stored === "light" || stored === "dark") return stored;
24
- } catch {
25
- // Stockage indisponible : on suit le système.
26
- }
27
- return systemTheme();
28
- }
29
-
30
- /** Le thème que demande le système (`prefers-color-scheme`). */
31
- function systemTheme(): DemoTheme {
32
- return window.matchMedia("(prefers-color-scheme: dark)").matches
33
- ? "dark"
34
- : "light";
35
- }
36
-
37
- /**
38
- * Pose le thème sur la page, et le retient quand `remember` est vrai.
39
- *
40
- * @param theme - le thème à afficher
41
- * @param remember - le garder pour les visites suivantes
42
- */
43
- export function applyTheme(theme: DemoTheme, remember = false): void {
44
- document.documentElement.dataset.theme = theme;
45
- if (!remember) return;
46
- try {
47
- window.localStorage.setItem(THEME_KEY, theme);
48
- } catch {
49
- // Stockage indisponible : le choix vaut pour cette page seulement.
50
- }
51
- }