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
@@ -0,0 +1,75 @@
1
+ /**
2
+ * Le bloc « Pour commencer » qui FERME la sortie de `create app` — PURE.
3
+ *
4
+ * Une génération écrit une trentaine de lignes : installation, build,
5
+ * migration, licences, skills, câblage MCP, état de l'application. Les trois
6
+ * gestes qui comptent pour la personne devant son terminal — démarrer, se
7
+ * connecter, brancher son agent — s'y perdaient : le mot de passe vivait en
8
+ * commentaire au milieu d'une ligne, la porte MCP en dernière ligne d'outils,
9
+ * et la démo n'était nommée nulle part une fois la question passée.
10
+ *
11
+ * Ce bloc est donc la DERNIÈRE chose écrite, numérotée, et chaque étape tient
12
+ * en une commande et sa raison. Il n'a pas de bord droit : une destination ou
13
+ * un mot de passe plus longs que prévu ne le déforment jamais.
14
+ */
15
+ import type { packageManagerCommandLines } from "./packageManager.js";
16
+ /** Les lignes de commande dans la syntaxe du gestionnaire de l'application. */
17
+ export type StartPanelCommands = ReturnType<typeof packageManagerCommandLines>;
18
+ /** Où en est la porte MCP de l'application après la génération. */
19
+ export type StartPanelAgent =
20
+ /** Aucun agent choisi, ou app non construite : le geste se NOMME. */
21
+ {
22
+ readonly kind: "to-wire";
23
+ }
24
+ /** Porte câblée chez les agents choisis, jeton posé dans `.env`. */
25
+ | {
26
+ readonly kind: "wired";
27
+ }
28
+ /** Porte câblée, jeton NON posé (base injoignable, émission ratée). */
29
+ | {
30
+ readonly kind: "token-missing";
31
+ };
32
+ /** Ce que le bloc affiche — tout est déjà décidé par l'appelant. */
33
+ export interface IStartPanelInput {
34
+ /** Dossier de l'application, relatif au répertoire courant (`.` sur place). */
35
+ readonly relDest: string;
36
+ readonly commands: StartPanelCommands;
37
+ /** `false` : l'installation reste à faire (`--no-install`, échec). */
38
+ readonly installed: boolean;
39
+ /** `false` : le build reste à faire. */
40
+ readonly built: boolean;
41
+ /** Base docker à lancer avant le premier démarrage, sinon `null`. */
42
+ readonly infra: string | null;
43
+ /** La migration initiale reste à écrire ET à appliquer. */
44
+ readonly migrationPending: boolean;
45
+ /** Le compte de développement (préset complet), sinon `null`. */
46
+ readonly admin: {
47
+ readonly user: string;
48
+ readonly password: string;
49
+ } | null;
50
+ /**
51
+ * Les moteurs que `create front` sait poser, quand l'app n'a pas
52
+ * d'interface web ; `null` sinon.
53
+ */
54
+ readonly addFrontend: readonly string[] | null;
55
+ readonly agent: StartPanelAgent;
56
+ /**
57
+ * La démo : son adresse quand elle est installée, sinon la commande d'une
58
+ * application JETABLE qui la porte — elle sert à apprendre, pas à rester.
59
+ */
60
+ readonly demo: {
61
+ readonly installed: true;
62
+ } | {
63
+ readonly installed: false;
64
+ readonly command: string;
65
+ };
66
+ }
67
+ /**
68
+ * Rend le bloc « Pour commencer ».
69
+ *
70
+ * @param input - l'état de l'application générée
71
+ * @param bold - mise en relief du titre et des intitulés (identité par
72
+ * défaut : la sortie reste lisible sans couleur, et testable)
73
+ * @returns le bloc, filets compris, terminé par un saut de ligne
74
+ */
75
+ export declare function renderStartPanel(input: IStartPanelInput, bold?: (text: string) => string): string;
package/man/nodefony.1 CHANGED
@@ -1,4 +1,4 @@
1
- .TH NODEFONY 1 "" "nodefony 10.0.0" "Nodefony Manual"
1
+ .TH NODEFONY 1 "" "nodefony 10.0.1" "Nodefony Manual"
2
2
  .SH NAME
3
3
  nodefony \- framework fullstack Node.js : HTTP, WebSocket, ORM, agents
4
4
  .SH SYNOPSIS
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nodefony",
3
- "version": "10.0.0",
3
+ "version": "10.0.1",
4
4
  "description": "Noyau du framework Nodefony : modules, injection de dépendances, configuration validée au démarrage, journalisation structurée corrélée, CLI — et le client temps réel partagé avec le navigateur, avec ses hooks React, Vue, Svelte et Angular",
5
5
  "type": "module",
6
6
  "nodefony": {
@@ -167,9 +167,9 @@
167
167
  }
168
168
  },
169
169
  "devDependencies": {
170
- "@angular/compiler": "~22.2.6",
171
- "@angular/core": "~22.2.6",
172
- "@angular/platform-browser": "~22.2.6",
170
+ "@angular/compiler": "~22.3.0",
171
+ "@angular/core": "~22.3.0",
172
+ "@angular/platform-browser": "~22.3.0",
173
173
  "@types/mime-types": "3.0.1",
174
174
  "@types/node": "26.6.6",
175
175
  "@types/react": "^19.3.0",
@@ -183,10 +183,10 @@
183
183
  "react": "^19.3.1",
184
184
  "react-dom": "^19.3.1",
185
185
  "rolldown": "1.3.3",
186
- "svelte": "^5.58.0",
186
+ "svelte": "^5.58.1",
187
187
  "tsx": "4.23.15",
188
188
  "vitest": "5.1.1",
189
- "vue": "^3.5.45",
189
+ "vue": "^3.5.46",
190
190
  "ws": "8.23.0",
191
191
  "zod": "^4.6.7"
192
192
  },
@@ -140,7 +140,7 @@ npm run infra:up # docker : Redis + <%= it.db.label %> — AVANT l'app<% } %
140
140
  npm run dev
141
141
  ```
142
142
 
143
- <% if (it.front) { %>- `http://127.0.0.1:5151/` — ton application <%= it.frontend %>, rechargée à chaud pendant que tu écris.<% } else { %>- `http://127.0.0.1:5151/` — ta racine : `{ "app": "<%= it.appName %>" }`, le nom et rien d'autre.<% } %><% if (it.complete) { %>
143
+ <% if (it.front) { %>- `http://127.0.0.1:5151/` — ton application <%= it.frontend %>, rechargée à chaud pendant que tu écris.<% } else { %>- `http://127.0.0.1:5151/` — ta page d'accueil dans un navigateur ; un programme (`curl`) y reçoit `{ "app": "<%= it.appName %>" }`, le nom et rien d'autre.<% } %><% if (it.complete) { %>
144
144
  - `http://127.0.0.1:5151/nodefony` — **Studio**, la console d'administration.<% } %>
145
145
 
146
146
  <% if (it.complete) { %>> **Le compte d'administration existe déjà** : `admin` / `<%= it.devAdminPassword %>`. Il
@@ -220,8 +220,10 @@ export const env = defineEnv({
220
220
 
221
221
  /**
222
222
  * Mot de passe du compte admin seedé au premier boot (voir
223
- * `nodefony/security/users.ts`). DEV : défaut `<%= it.devAdminPassword %>` (compte admin/<%= it.devAdminPassword %>,
224
- * comme Grafana — pratique, LOCAL uniquement). PROD : OBLIGATOIRE — sans lui
223
+ * `nodefony/security/provisionUsers.ts`). DEV : défaut tiré au hasard à la
224
+ * création de l'application (`DEV_ADMIN_PASSWORD` de ce fichier, recopié dans
225
+ * `.env` et le README — pratique, LOCAL uniquement). La valeur n'est PAS
226
+ * écrite ici : ce catalogue nourrit `.env.example`, une notice commune. PROD : OBLIGATOIRE — sans lui
225
227
  * le seed refuse (jamais de mot de passe par défaut en production).
226
228
  *
227
229
  * Pas de `requiredIn` : l'exigence ne vaut qu'au PREMIER démarrage. Une fois
@@ -233,8 +235,9 @@ export const env = defineEnv({
233
235
  section: "Comptes créés au démarrage",
234
236
  title: "Mot de passe administrateur",
235
237
  description:
236
- "Le compte « admin » est créé au premier démarrage avec ce mot de passe. En développement, un mot de passe connu s'applique si tu ne mets rien. En production, aucun : sans cette variable, aucun compte n'est créé. Une fois le compte créé, la variable ne sert plus.",
237
- defaultNote: "<%= it.devAdminPassword %> en développement ; aucun en production",
238
+ "Le compte « admin » est créé au premier démarrage avec ce mot de passe. En développement, le mot de passe tiré à la création de l'application s'applique si tu ne mets rien. En production, aucun : sans cette variable, aucun compte n'est créé. Une fois le compte créé, la variable ne sert plus.",
239
+ defaultNote:
240
+ "tiré à la création (voir .env) en développement ; aucun en production",
238
241
  }),
239
242
 
240
243
  /**
@@ -84,9 +84,18 @@ export default defineConfig<typeof env>((ctx) => ({
84
84
  * Trois conséquences : du TLS qui ne protège rien mais en a l'air, une
85
85
  * écriture disque qui interdit `readOnlyRootFilesystem` en Kubernetes, et un
86
86
  * port que le `EXPOSE` de l'image ne publie même pas.
87
- * En cloud-native le TLS se termine à l'ingress ou au proxy frontal. Qui en
88
- * veut vraiment DANS le conteneur pose `NF_PORT_HTTPS` et fournit un vrai
89
- * certificat (`certificates.strategy: "explicit"`), il n'est pas empêché.
87
+ * Où se termine le TLS est un choix de DÉPLOIEMENT, pas une règle du
88
+ * cloud-native. Trois modes existent :
89
+ * - à l'ingress ou au proxy frontal, le pod en clair derrière (le cas
90
+ * que suppose l'objet Ingress de Kubernetes) ;
91
+ * - jusqu'au pod : Gateway API en _passthrough_, ou rechiffré par la
92
+ * passerelle (`BackendTLSPolicy`) — le conteneur sert alors HTTPS ;
93
+ * - par un maillage de services (mTLS entre pods) : l'application reste
94
+ * en clair, le maillage chiffre.
95
+ * Une politique zéro confiance (NIST SP 800-207) exige l'un des deux
96
+ * derniers. Pour servir HTTPS ici : poser `NF_PORT_HTTPS` et fournir un
97
+ * VRAI certificat (`certificates.strategy: "explicit"`, ses `key` et
98
+ * `cert`), jamais un auto-signé fabriqué au démarrage.
90
99
  * - Inspecter ou regénérer le certificat : `npx nodefony http:certificates`.
91
100
  */
92
101
  servers: {
@@ -310,14 +310,14 @@
310
310
  # ─── Mot de passe administrateur ────────────────────────────────────────────
311
311
  #
312
312
  # Le compte « admin » est créé au premier démarrage avec ce mot de passe. En
313
- # développement, un mot de passe connu s'applique si tu ne mets rien. En
314
- # production, aucun : sans cette variable, aucun compte n'est créé. Une fois
315
- # le compte créé, la variable ne sert plus.
313
+ # développement, le mot de passe tiré à la création de l'application
314
+ # s'applique si tu ne mets rien. En production, aucun : sans cette variable,
315
+ # aucun compte n'est créé. Une fois le compte créé, la variable ne sert plus.
316
316
  #
317
317
  # @optional
318
318
  # @sensitive
319
319
  # @placement=secrets
320
- # @default="<%= it.devAdminPassword %> en développement ; aucun en production"
320
+ # @default="tiré à la création (voir .env) en développement ; aucun en production"
321
321
  # NF_ADMIN_PASSWORD=
322
322
 
323
323
 
@@ -1,45 +1,13 @@
1
1
  /*
2
- * Accent Angular — 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: #dd0031;
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: #a30024;
21
- --nf-accent-glow: rgba(221, 0, 49, 0.28);
22
- --nf-accent-wash: rgba(221, 0, 49, 0.1);
23
- --nf-accent-line: rgba(221, 0, 49, 0.3);
24
- --nf-logo-anim: nf-pulse 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,15: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 : #e84f71 → 4,82:1. */
32
- @media (prefers-color-scheme: dark) {
33
- :root {
34
- --nf-accent-ink: #e84f71;
35
- }
36
- }
37
- @keyframes nf-pulse {
38
- 0%,
39
- 100% {
40
- transform: scale(1);
41
- }
42
- 50% {
43
- transform: scale(1.07);
44
- }
12
+ --nf-front: <%= it.front.badge.color %>;
45
13
  }
@@ -1,57 +1,308 @@
1
- import { Component<% if (it.hasSecurity) { %>, type OnInit<% } %> } from "@angular/core";
2
- <% if (it.hasSecurity) { %>// La liaison Angular de la connexion : l'état de session en signal, la page de
1
+ import { NgTemplateOutlet } from "@angular/common";
2
+ import { Component, type OnDestroy, type OnInit, signal } from "@angular/core";
3
+ <% if (it.complete) { %>// La liaison Angular de la connexion : l'état de session en signal, la page de
3
4
  // connexion servie par le framework (jamais un formulaire recopié ici).
4
5
  import { injectNodefonyLogin } from "nodefony/angular";
5
6
  import { loginPagePath } from "nodefony/client";
6
7
  <% } %>import { NODEFONY_LOGO } from "../brand";
8
+ import { DEV_HOME, type IHomeCard } from "../devHome";
9
+ import {
10
+ applyDarkTheme,
11
+ findDebugBar,
12
+ findDemo,
13
+ readDarkTheme,
14
+ startPointerLight,
15
+ type IDebugBarHandle,
16
+ } from "../homeEffects";
7
17
  import "../showcase.css";
8
18
  import "../accent.css";
9
19
 
10
20
  /**
11
- * Page d'accueil de <%= it.appName %> — MINIMALE, et c'est voulu : c'est TA page.
21
+ * Page d'accueil de <%= it.appName %> — c'est TA page.
12
22
  *
13
- * Elle dit quelle application répond<% if (it.hasSecurity) { %>, propose la connexion et nomme le
14
- * compte connecté<% } %>. Rien de plus : ce qui part ici part en PRODUCTION, vers
15
- * n'importe qui — ni mot de passe, ni version, ni lien vers la console
16
- * d'administration.
23
+ * Ce que voit tout visiteur : la marque, le thème<% if (it.complete) { %>, la session<% } %>, puis le nom
24
+ * de l'application. Rien de plus en production : ni mot de passe, ni version,
25
+ * ni lien vers la console d'administration.
17
26
  *
18
- * Pour VOIR ce que le framework sait faire, installe la démo : elle se copie
19
- * dans l'application et se lit comme ton propre code.
27
+ * En DÉVELOPPEMENT seulement : la présentation du framework, les liens utiles
28
+ * et où personnaliser la page. Ce contenu vit dans `devHome.ts`, qui vaut
29
+ * `null` dans le build de production — c'est là qu'est la garde, pas ici :
30
+ * Angular compile les textes de ce gabarit dans le bundle, affichés ou non.
20
31
  */
21
32
  @Component({
22
33
  selector: "app-root",
23
34
  standalone: true,
35
+ imports: [NgTemplateOutlet],
24
36
  template: `
25
- <main class="nf-main">
26
- <img class="nf-fwlogo" [src]="logo" alt="" width="48" height="48" />
27
- <h1><%= it.appName %></h1>
28
- <% if (it.hasSecurity) { %> <div class="nf-card" role="status">
29
- @if (login.state().step === "authenticated" && login.state().user; as user) {
30
- <p>
31
- Connecté en tant que
32
- <span class="nf-session" data-open="">{{ user.identifier }}</span>
33
- <button type="button" class="nf-action" (click)="logout()">
37
+ <header class="nf-topbar">
38
+ <a class="nf-brand" href="/">
39
+ <img [src]="logo" alt="" width="30" height="30" />
40
+ <span><%= it.appName %></span>
41
+ @if (dev) {
42
+ <span class="nf-tag">développement</span>
43
+ }
44
+ </a>
45
+ @if (dev) {
46
+ <nav class="nf-topnav" aria-label="Liens de développement">
47
+ @if (dev.console) {
48
+ <a [href]="dev.console.href">{{ dev.console.label }}</a>
49
+ <span class="nf-topnav-sep" aria-hidden="true"></span>
50
+ }
51
+ @for (link of dev.external; track link.href) {
52
+ <a class="nf-ext" [href]="link.href">{{ link.label }}</a>
53
+ }
54
+ </nav>
55
+ }
56
+ <div class="nf-topbar-tools">
57
+ <div class="nf-tools" role="group" aria-label="Affichage">
58
+ <button
59
+ type="button"
60
+ class="nf-tool"
61
+ [attr.aria-pressed]="dark()"
62
+ aria-label="Thème sombre"
63
+ title="Thème sombre"
64
+ (click)="toggleTheme()"
65
+ >
66
+ @if (dark()) {
67
+ <svg
68
+ viewBox="0 0 24 24"
69
+ fill="none"
70
+ stroke="currentColor"
71
+ stroke-width="2"
72
+ aria-hidden="true"
73
+ >
74
+ <circle cx="12" cy="12" r="4" />
75
+ <path
76
+ 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"
77
+ />
78
+ </svg>
79
+ } @else {
80
+ <svg
81
+ viewBox="0 0 24 24"
82
+ fill="none"
83
+ stroke="currentColor"
84
+ stroke-width="2"
85
+ aria-hidden="true"
86
+ >
87
+ <path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z" />
88
+ </svg>
89
+ }
90
+ </button>
91
+ @if (bar()) {
92
+ <button
93
+ type="button"
94
+ class="nf-tool"
95
+ [attr.aria-pressed]="!barVisible()"
96
+ aria-label="Cacher la barre de debug"
97
+ title="Cacher la barre de debug"
98
+ (click)="toggleBar()"
99
+ >
100
+ <svg
101
+ viewBox="0 0 24 24"
102
+ fill="none"
103
+ stroke="currentColor"
104
+ stroke-width="2"
105
+ stroke-linecap="round"
106
+ aria-hidden="true"
107
+ >
108
+ <path d="M8 2l1.9 1.9M16 2l-1.9 1.9" />
109
+ <rect x="7" y="6" width="10" height="14" rx="5" />
110
+ <path
111
+ d="M12 10v10M3 13h4M17 13h4M4 7l3 2M20 7l-3 2M4 19l3-2M20 19l-3-2"
112
+ />
113
+ </svg>
114
+ </button>
115
+ }
116
+ </div>
117
+ <% if (it.complete) { %> @if (
118
+ login.state().step === "authenticated" && login.state().user;
119
+ as user
120
+ ) {
121
+ <span class="nf-account">
122
+ <span class="nf-session">{{ user.identifier }}</span>
123
+ <button type="button" class="nf-account-out" (click)="logout()">
34
124
  Se déconnecter
35
125
  </button>
36
- </p>
126
+ </span>
37
127
  } @else {
38
- <a class="nf-action" [href]="loginHref">Se connecter</a>
128
+ <a class="nf-login" [href]="loginHref">Se connecter</a>
129
+ }
130
+ <% } %> </div>
131
+ </header>
132
+
133
+ <main class="nf-main">
134
+ <div class="nf-hero">
135
+ <img class="nf-hero-logo" [src]="logo" alt="" width="80" height="80" />
136
+ @if (dev) {
137
+ <h1>{{ dev.hero.title }}</h1>
138
+ <p class="nf-sub">{{ dev.hero.sub }}</p>
139
+ <p class="nf-sig">{{ dev.hero.sig }}</p>
140
+ <div class="nf-badges">
141
+ <span class="nf-badge nf-agentic">{{ dev.hero.lead }}</span>
142
+ <span class="nf-badge nf-front">
143
+ <svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
144
+ <path [attr.d]="dev.front.logo" />
145
+ </svg>
146
+ {{ dev.front.name }} {{ dev.front.version }}
147
+ </span>
148
+ @for (badge of dev.hero.badges; track badge) {
149
+ <span class="nf-badge">{{ badge }}</span>
150
+ }
151
+ </div>
152
+ <div
153
+ class="nf-install"
154
+ role="img"
155
+ [attr.aria-label]="
156
+ 'Commande d\\'installation : ' +
157
+ dev.hero.install.command +
158
+ ' ' +
159
+ dev.hero.install.arg
160
+ "
161
+ >
162
+ <span class="nf-p">$</span>
163
+ <span
164
+ >{{ dev.hero.install.command }}
165
+ <b>{{ dev.hero.install.arg }}</b></span
166
+ >
167
+ </div>
168
+ @if (demo; as demoHref) {
169
+ <div class="nf-cta">
170
+ <a class="nf-btn nf-primary" [href]="demoHref">{{
171
+ dev.demoLabel
172
+ }}</a>
173
+ </div>
174
+ } @else {
175
+ <p class="nf-learn">
176
+ {{ dev.learn.label }} : <code>{{ dev.learn.command }}</code> —
177
+ {{ dev.learn.note }}
178
+ </p>
179
+ }
180
+ } @else {
181
+ <h1><%= it.appName %></h1>
39
182
  }
40
183
  </div>
41
- <% } else { %> <p class="nf-dim">Ton application répond. Cette page est la tienne.</p>
42
- <% } %> </main>
184
+
185
+ @for (section of dev?.sections ?? []; track section.id) {
186
+ <section
187
+ [class]="section.band ? 'nf-section nf-band' : 'nf-section'"
188
+ [attr.aria-labelledby]="section.id + '-title'"
189
+ >
190
+ <div class="nf-sec-head">
191
+ <p class="nf-kicker">{{ section.kicker }}</p>
192
+ <h2 [id]="section.id + '-title'">{{ section.title }}</h2>
193
+ <p>{{ section.intro }}</p>
194
+ </div>
195
+ <div class="nf-grid">
196
+ @for (card of section.cards; track card.title) {
197
+ @if (card.href !== null) {
198
+ <a [class]="cardClass(card)" [href]="card.href">
199
+ <ng-container
200
+ *ngTemplateOutlet="cardBody; context: { $implicit: card }"
201
+ ></ng-container>
202
+ </a>
203
+ } @else {
204
+ <div [class]="cardClass(card)">
205
+ <ng-container
206
+ *ngTemplateOutlet="cardBody; context: { $implicit: card }"
207
+ ></ng-container>
208
+ </div>
209
+ }
210
+ }
211
+ </div>
212
+ @if (section.note) {
213
+ <p class="nf-note">{{ section.note }}</p>
214
+ }
215
+ </section>
216
+ }
217
+ </main>
218
+
219
+ <ng-template #cardBody let-card>
220
+ <h3>{{ card.title }}</h3>
221
+ @if (card.creds) {
222
+ <p class="nf-creds">
223
+ <code>{{ card.creds.user }}</code>
224
+ @if (card.creds.password !== null) {
225
+ / <code>{{ card.creds.password }}</code>
226
+ }
227
+ </p>
228
+ }
229
+ <p>
230
+ @for (part of card.text; track $index) {
231
+ @if (part.code) {
232
+ <code>{{ part.text }}</code>
233
+ } @else {
234
+ <ng-container>{{ part.text }}</ng-container>
235
+ }
236
+ }
237
+ </p>
238
+ @if (card.go) {
239
+ <span class="nf-go">{{ card.go }}</span>
240
+ }
241
+ @if (card.skins) {
242
+ <form class="nf-skins" [action]="card.skins.action" method="get">
243
+ <select name="skin" aria-label="Habillage de la page de connexion">
244
+ @for (skin of card.skins.options; track skin) {
245
+ <option [value]="skin" [selected]="skin === card.skins.selected">
246
+ {{ skin }}
247
+ </option>
248
+ }
249
+ </select>
250
+ <button type="submit">Voir</button>
251
+ </form>
252
+ }
253
+ </ng-template>
43
254
  `,
44
255
  })
45
- export class AppComponent<% if (it.hasSecurity) { %> implements OnInit<% } %> {
256
+ export class AppComponent implements OnInit, OnDestroy {
46
257
  readonly logo = NODEFONY_LOGO;
47
- <% if (it.hasSecurity) { %> readonly login = injectNodefonyLogin();
258
+ readonly dev = DEV_HOME;
259
+ /** Thème clair/sombre : suit le système, un clic l'impose, retenu par ce navigateur. */
260
+ readonly dark = signal(readDarkTheme());
261
+ /** UN bouton pour la barre de debug : la cacher ou la montrer. */
262
+ readonly bar = signal<IDebugBarHandle | null>(null);
263
+ readonly barVisible = signal(true);
264
+ /** La démo est-elle chargée ? Le serveur le dit dans la page (développement). */
265
+ readonly demo = DEV_HOME === null ? null : findDemo();
266
+ <% if (it.complete) { %> readonly login = injectNodefonyLogin();
48
267
  readonly loginHref = loginPagePath(location.pathname + location.search);
268
+ <% } %> #stopLight: (() => void) | null = null;
269
+ #frame = 0;
49
270
 
50
- /** Reprend la session existante (cookie de session, s'il y en a un). */
51
271
  ngOnInit(): void {
272
+ applyDarkTheme(this.dark(), false);
273
+ <% if (it.complete) { %> // Reprend la session existante (cookie de session, s'il y en a un).
52
274
  void this.login.flow.me();
275
+ <% } %> this.#stopLight = startPointerLight(".nf-card");
276
+ if (this.dev === null) return;
277
+ // La barre est injectée à côté de la page : sa poignée arrive après le rendu.
278
+ this.#frame = requestAnimationFrame(() => {
279
+ const found = findDebugBar();
280
+ this.bar.set(found);
281
+ if (found !== null) this.barVisible.set(found.isVisible());
282
+ });
283
+ }
284
+
285
+ ngOnDestroy(): void {
286
+ this.#stopLight?.();
287
+ cancelAnimationFrame(this.#frame);
288
+ }
289
+
290
+ toggleTheme(): void {
291
+ this.dark.update((dark) => !dark);
292
+ applyDarkTheme(this.dark());
293
+ }
294
+
295
+ toggleBar(): void {
296
+ const bar = this.bar();
297
+ if (bar === null) return;
298
+ this.barVisible.update((visible) => !visible);
299
+ bar.setVisible(this.barVisible());
53
300
  }
54
301
 
302
+ cardClass(card: IHomeCard): string {
303
+ return card.tone === "safe" ? "nf-card nf-safe" : "nf-card";
304
+ }
305
+ <% if (it.complete) { %>
55
306
  async logout(): Promise<void> {
56
307
  // Session venue d'un fournisseur : suivre son adresse ferme AUSSI la sienne.
57
308
  const providerLogout = await this.login.flow.logout();