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.
- package/.ai/symbols.json +91 -30
- package/CHANGELOG.md +25 -0
- package/assets/login.css +26 -1
- package/dist/bin/nodefony.js +1 -1
- package/dist/client/client/debugbar/DebugBar.js +2 -2
- package/dist/client/debugbar.standalone.js +2 -2
- package/dist/login/login.css +26 -1
- package/dist/node/cli/create.js +30 -10
- package/dist/node/cli/installCommand.js +13 -1
- package/dist/node/cli/scaffold/engine.js +134 -26
- package/dist/node/cli/scaffold/invisibleChars.js +52 -0
- package/dist/node/cli/scaffold/versions.js +7 -7
- package/dist/node/cli/startPanel.js +70 -0
- package/dist/node/index.js +1 -1
- package/dist/node/kernel/checks/packageDeps.js +11 -1
- package/dist/node/package.json.js +1 -1
- package/dist/types/cli/installCommand.d.ts +10 -0
- package/dist/types/cli/scaffold/engine.d.ts +47 -9
- package/dist/types/cli/scaffold/invisibleChars.d.ts +10 -0
- package/dist/types/cli/startPanel.d.ts +75 -0
- package/man/nodefony.1 +1 -1
- package/package.json +6 -6
- package/templates/app/base/README.md.tpl +1 -1
- package/templates/app/base/env.ts.tpl +7 -4
- package/templates/app/base/nodefony.config.ts.tpl +12 -3
- package/templates/app/complete/env.example.tpl +4 -4
- package/templates/app/frontend/angular/frontend/src/accent.css.tpl +7 -39
- package/templates/app/frontend/angular/frontend/src/app/app.component.ts.tpl +276 -25
- package/templates/app/frontend/react/frontend/src/App.tsx.tpl +313 -44
- package/templates/app/frontend/react/frontend/src/accent.css.tpl +7 -35
- package/templates/app/frontend/shared/frontend/src/brand.ts.tpl +12 -9
- package/templates/app/frontend/shared/frontend/src/devHome.ts.tpl +45 -0
- package/templates/app/frontend/shared/frontend/src/homeContent.ts.tpl +229 -0
- package/templates/app/frontend/shared/frontend/src/homeEffects.ts.tpl +115 -0
- package/templates/app/frontend/shared/frontend/src/showcase.css.tpl +729 -205
- package/templates/app/frontend/shared/nodefony/controllers/AppController.ts.tpl +17 -7
- package/templates/app/frontend/svelte/frontend/src/App.svelte.tpl +248 -29
- package/templates/app/frontend/svelte/frontend/src/accent.css.tpl +7 -39
- package/templates/app/frontend/vue/frontend/src/App.vue.tpl +255 -28
- package/templates/app/frontend/vue/frontend/src/accent.css.tpl +7 -39
- package/templates/app/home/nodefony/controllers/HomeController.ts.tpl +40 -25
- package/templates/app/home/nodefony/home/homePage.ts.tpl +163 -0
- package/templates/controller/duplex/nodefony/controllers/__NAME__.ts.tpl +1 -1
- package/templates/controller/realtime/nodefony/controllers/__NAME__.ts.tpl +1 -1
- package/templates/controller/rest/nodefony/controllers/__NAME__.ts.tpl +1 -1
- package/templates/demo/front/frontend/src/App.tsx.tpl +57 -84
- package/templates/demo/front/frontend/src/demo.css.tpl +12 -134
- package/templates/demo/front/frontend/src/effects.ts.tpl +5 -36
- package/templates/entity/controller/nodefony/controllers/__PASCAL__Controller.ts.tpl +1 -1
- package/templates/demo/front/frontend/src/debugBar.ts.tpl +0 -56
- package/templates/demo/front/frontend/src/kit/theme.ts.tpl +0 -51
|
@@ -0,0 +1,229 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Les textes de l'accueil en DÉVELOPPEMENT : la présentation du framework, les
|
|
3
|
+
* liens vers la console et la documentation, le compte de ton poste, et où
|
|
4
|
+
* personnaliser la page.
|
|
5
|
+
*
|
|
6
|
+
* Données pures, sans dépendance au moteur de rendu : la même source sert la
|
|
7
|
+
* page<% if (it.front) { %> du front (par `devHome.ts`, qui les retire du build de production)<% } else { %> rendue par le serveur (`homePage.ts`, en développement seulement)<% } %>.
|
|
8
|
+
*
|
|
9
|
+
* C'est TA page : retire ce fichier (et ses usages) quand tu n'en as plus
|
|
10
|
+
* besoin.
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
/** Un fragment de texte de l'accueil : du texte simple, ou du code. */
|
|
14
|
+
export interface IHomeText {
|
|
15
|
+
readonly text: string;
|
|
16
|
+
readonly code: boolean;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/** Une carte de l'accueil, lien ou non. */
|
|
20
|
+
export interface IHomeCard {
|
|
21
|
+
readonly title: string;
|
|
22
|
+
readonly text: readonly IHomeText[];
|
|
23
|
+
/** Adresse si la carte est un lien, sinon `null`. */
|
|
24
|
+
readonly href: string | null;
|
|
25
|
+
/** Invitation affichée au pied d'une carte-lien (« Ouvrir /nodefony → »). */
|
|
26
|
+
readonly go: string | null;
|
|
27
|
+
/** Identifiant et mot de passe à recopier (`null` = mot de passe inconnu ici). */
|
|
28
|
+
readonly creds: {
|
|
29
|
+
readonly user: string;
|
|
30
|
+
readonly password: string | null;
|
|
31
|
+
} | null;
|
|
32
|
+
/** Teinte de la carte : `safe` = la garantie de production, en vert. */
|
|
33
|
+
readonly tone: "safe" | null;
|
|
34
|
+
/**
|
|
35
|
+
* Sélecteur d'habillages de la page de connexion : un formulaire `GET` vers
|
|
36
|
+
* `action`, qui marche sans JavaScript. `null` = pas de sélecteur.
|
|
37
|
+
*/
|
|
38
|
+
readonly skins: {
|
|
39
|
+
readonly action: string;
|
|
40
|
+
readonly options: readonly string[];
|
|
41
|
+
readonly selected: string;
|
|
42
|
+
} | null;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** Une section de l'accueil : un titre, une accroche, des cartes. */
|
|
46
|
+
export interface IHomeSection {
|
|
47
|
+
readonly id: string;
|
|
48
|
+
readonly kicker: string;
|
|
49
|
+
readonly title: string;
|
|
50
|
+
readonly intro: string;
|
|
51
|
+
/** `true` = bande pleine largeur, sur le fond adouci. */
|
|
52
|
+
readonly band: boolean;
|
|
53
|
+
readonly cards: readonly IHomeCard[];
|
|
54
|
+
readonly note: string | null;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/** Tout le contenu de développement de l'accueil. */
|
|
58
|
+
export interface IHomeContent {
|
|
59
|
+
/** Console d'administration, ou `null` quand l'application n'en a pas. */
|
|
60
|
+
readonly console: { readonly label: string; readonly href: string } | null;
|
|
61
|
+
/** Liens qui SORTENT de l'application (documentation, sources). */
|
|
62
|
+
readonly external: readonly {
|
|
63
|
+
readonly label: string;
|
|
64
|
+
readonly href: string;
|
|
65
|
+
}[];
|
|
66
|
+
/** Le bouton de la démo, montré seulement si elle est chargée. */
|
|
67
|
+
readonly demoLabel: string;
|
|
68
|
+
/**
|
|
69
|
+
* Sinon, la démo se NOMME : la commande d'une application jetable qui la
|
|
70
|
+
* porte — la question de `create app` passe vite, cette page reste.
|
|
71
|
+
*/
|
|
72
|
+
readonly learn: {
|
|
73
|
+
readonly label: string;
|
|
74
|
+
readonly command: string;
|
|
75
|
+
readonly note: string;
|
|
76
|
+
};
|
|
77
|
+
readonly hero: {
|
|
78
|
+
/** Le premier badge, mis en avant. */
|
|
79
|
+
readonly lead: string;
|
|
80
|
+
readonly title: string;
|
|
81
|
+
readonly sub: string;
|
|
82
|
+
readonly sig: string;
|
|
83
|
+
readonly badges: readonly string[];
|
|
84
|
+
readonly install: { readonly command: string; readonly arg: string };
|
|
85
|
+
};
|
|
86
|
+
readonly sections: readonly IHomeSection[];
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* Compose un texte d'accueil : les valeurs interpolées deviennent du code.
|
|
91
|
+
* rich`Celui de l'onglet : ${"public/favicon.ico"}.`
|
|
92
|
+
*/
|
|
93
|
+
function rich(
|
|
94
|
+
strings: TemplateStringsArray,
|
|
95
|
+
...codes: readonly string[]
|
|
96
|
+
): IHomeText[] {
|
|
97
|
+
const out: IHomeText[] = [];
|
|
98
|
+
strings.forEach((text, i) => {
|
|
99
|
+
if (text !== "") out.push({ text, code: false });
|
|
100
|
+
// `at()` : `undefined` après la dernière valeur, quelle que soit la
|
|
101
|
+
// configuration de l'index (`noUncheckedIndexedAccess`).
|
|
102
|
+
const code = codes.at(i);
|
|
103
|
+
if (code !== undefined) out.push({ text: code, code: true });
|
|
104
|
+
});
|
|
105
|
+
return out;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/**
|
|
109
|
+
* Le contenu de développement de l'accueil. Une FONCTION, pas une constante :
|
|
110
|
+
* jamais appelée, elle disparaît du bundle de production avec tout ce qu'elle
|
|
111
|
+
* porte — mot de passe compris.
|
|
112
|
+
*
|
|
113
|
+
* @returns un contenu neuf à chaque appel
|
|
114
|
+
*/
|
|
115
|
+
export function homeContent(): IHomeContent {
|
|
116
|
+
return {
|
|
117
|
+
console: <%= it.complete ? '{ label: "Console", href: "/nodefony" }' : "null" %>,
|
|
118
|
+
external: [
|
|
119
|
+
{ label: "Documentation", href: "https://nodefony.net/" },
|
|
120
|
+
{ label: "GitHub", href: "https://github.com/nodefony/nodefony-core" },
|
|
121
|
+
],
|
|
122
|
+
demoLabel: "Voir les démos",
|
|
123
|
+
learn: {
|
|
124
|
+
label: "Pour apprendre",
|
|
125
|
+
command: "<%= it.learnCommand %>",
|
|
126
|
+
note: "une app jetable avec les démos commentées",
|
|
127
|
+
},
|
|
128
|
+
hero: {
|
|
129
|
+
lead: "Agentic ready",
|
|
130
|
+
title: "Le framework Node.js fullstack",
|
|
131
|
+
sub: "Temps réel natif · développement agentic-ready · socle TypeScript isomorphe",
|
|
132
|
+
sig: "Une action de contrôleur. Deux transports. La même session, la même sécurité, le même code.",
|
|
133
|
+
badges: [
|
|
134
|
+
"Node.js <%= it.nodeRange %>",
|
|
135
|
+
"TypeScript strict",
|
|
136
|
+
"ESM only",
|
|
137
|
+
"Licence Apache 2.0",
|
|
138
|
+
],
|
|
139
|
+
install: { command: "<%= it.installCommand %>", arg: "mon-app" },
|
|
140
|
+
},
|
|
141
|
+
sections: [
|
|
142
|
+
<% if (it.complete) { %> {
|
|
143
|
+
id: "nf-start",
|
|
144
|
+
kicker: "Développement",
|
|
145
|
+
title: "Pour commencer",
|
|
146
|
+
intro: "Le compte de ton poste et la console d'administration.",
|
|
147
|
+
band: true,
|
|
148
|
+
cards: [
|
|
149
|
+
{
|
|
150
|
+
title: "Compte de développement",
|
|
151
|
+
<% if (it.devAdminPassword) { %> text: rich`Défini dans ${"nodefony/security/provisionUsers.ts"}, tiré au hasard pour cette application. Créé au premier démarrage — si ${"NF_ADMIN_PASSWORD"} figurait alors dans ${".env"}, c'est lui le mot de passe.`,
|
|
152
|
+
creds: { user: "admin", password: "<%= it.devAdminPassword %>" },
|
|
153
|
+
<% } else { %> text: rich`Son mot de passe est ${"DEV_ADMIN_PASSWORD"} dans ${"nodefony/security/provisionUsers.ts"}, tiré au hasard à la création de l'application — sauf si ${"NF_ADMIN_PASSWORD"} figurait dans ${".env"} au premier démarrage.`,
|
|
154
|
+
creds: { user: "admin", password: null },
|
|
155
|
+
<% } %> href: null,
|
|
156
|
+
go: null,
|
|
157
|
+
tone: null,
|
|
158
|
+
skins: null,
|
|
159
|
+
},
|
|
160
|
+
{
|
|
161
|
+
title: "Console d'administration",
|
|
162
|
+
text: rich`L'état réel de l'application : routes, services, configuration effective, journal.`,
|
|
163
|
+
href: "/nodefony",
|
|
164
|
+
go: "Ouvrir /nodefony →",
|
|
165
|
+
creds: null,
|
|
166
|
+
tone: null,
|
|
167
|
+
skins: null,
|
|
168
|
+
},
|
|
169
|
+
{
|
|
170
|
+
title: "En production",
|
|
171
|
+
text: rich`Aucun mot de passe par défaut (staging compris) : ${"admin"} n'est créé que si ${"NF_ADMIN_PASSWORD"} est posé. Sans lui, aucun compte — un avertissement au démarrage renvoie à ${"npx nodefony security:user:add admin --admin"}. Le démarrage n'est jamais bloqué.`,
|
|
172
|
+
href: null,
|
|
173
|
+
go: null,
|
|
174
|
+
creds: null,
|
|
175
|
+
tone: "safe",
|
|
176
|
+
skins: null,
|
|
177
|
+
},
|
|
178
|
+
],
|
|
179
|
+
note: null,
|
|
180
|
+
},
|
|
181
|
+
<% } %> {
|
|
182
|
+
id: "nf-custom",
|
|
183
|
+
kicker: "Personnaliser",
|
|
184
|
+
title: "C'est ta page",
|
|
185
|
+
intro: "Où changer l'accueil, la marque<%= it.complete ? ' et la page de connexion' : '' %>.",
|
|
186
|
+
band: false,
|
|
187
|
+
cards: [
|
|
188
|
+
{
|
|
189
|
+
title: "Accueil",
|
|
190
|
+
<% if (it.front) { %> text: rich`${"<%= it.front.pageFile %>"} pour le contenu, ${"frontend/src/showcase.css"} pour le style, ${"frontend/src/homeContent.ts"} pour ces sections de développement.`,
|
|
191
|
+
<% } else { %> text: rich`${"nodefony/home/homePage.ts"} pour le contenu, ${"public/showcase.css"} pour le style, ${"nodefony/home/homeContent.ts"} pour ces sections de développement.`,
|
|
192
|
+
<% } %> href: null,
|
|
193
|
+
go: null,
|
|
194
|
+
creds: null,
|
|
195
|
+
tone: null,
|
|
196
|
+
skins: null,
|
|
197
|
+
},
|
|
198
|
+
{
|
|
199
|
+
title: "Logo",
|
|
200
|
+
<% if (it.front) { %> text: rich`Celui de la page : ${"frontend/src/brand.ts"}. Celui de l'onglet : ${"public/favicon.ico"}.`,
|
|
201
|
+
<% } else { %> text: rich`Celui de la page : ${"public/nodefony-logo.png"}. Celui de l'onglet : ${"public/favicon.ico"}.`,
|
|
202
|
+
<% } %> href: null,
|
|
203
|
+
go: null,
|
|
204
|
+
creds: null,
|
|
205
|
+
tone: null,
|
|
206
|
+
skins: null,
|
|
207
|
+
},
|
|
208
|
+
<% if (it.complete) { %> {
|
|
209
|
+
title: "Page de connexion",
|
|
210
|
+
text: rich`${"loginPage"} dans ${"nodefony/config/security.ts"} : ${"title"}, ${"logo"}, ${"stylesheet"}, ${"skin"}. Choisis un habillage pour le voir :`,
|
|
211
|
+
href: null,
|
|
212
|
+
go: null,
|
|
213
|
+
creds: null,
|
|
214
|
+
tone: null,
|
|
215
|
+
skins: {
|
|
216
|
+
action: "<%= it.loginPage.path %>",
|
|
217
|
+
options: [
|
|
218
|
+
<% for (const skin of it.loginPage.skins) { %> <%= JSON.stringify(skin) %>,
|
|
219
|
+
<% } %> ],
|
|
220
|
+
selected: "horizon",
|
|
221
|
+
},
|
|
222
|
+
},
|
|
223
|
+
<% } %> ],
|
|
224
|
+
<% if (it.front) { %> note: "Ces sections n'existent qu'en développement : le build de production les retire.",
|
|
225
|
+
<% } else { %> note: "Ces sections n'existent qu'en développement : le serveur ne les rend pas en production.",
|
|
226
|
+
<% } %> },
|
|
227
|
+
],
|
|
228
|
+
};
|
|
229
|
+
}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Les gestes de l'accueil, écrits UNE fois pour tous les fronts : le thème
|
|
3
|
+
* clair/sombre, la lumière qui suit le pointeur sur les cartes, la barre de
|
|
4
|
+
* debug, la présence de la démo. La page de chaque front ne fait que les
|
|
5
|
+
* brancher sur son cycle de vie.
|
|
6
|
+
*
|
|
7
|
+
* Le reste du mouvement (halos, apparition au défilement, ombre de l'en-tête)
|
|
8
|
+
* est en CSS pur, dans `showcase.css`, et s'éteint quand l'utilisateur a
|
|
9
|
+
* demandé à réduire les animations.
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
const THEME_KEY = "nf-theme";
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* Le thème à appliquer : celui choisi dans ce navigateur, sinon celui du système.
|
|
16
|
+
*
|
|
17
|
+
* @returns `true` pour le thème sombre
|
|
18
|
+
*/
|
|
19
|
+
export function readDarkTheme(): boolean {
|
|
20
|
+
try {
|
|
21
|
+
const saved = localStorage.getItem(THEME_KEY);
|
|
22
|
+
if (saved !== null) return saved === "dark";
|
|
23
|
+
} catch {
|
|
24
|
+
// Stockage refusé (navigation privée, politique) : on suit le système.
|
|
25
|
+
}
|
|
26
|
+
return matchMedia("(prefers-color-scheme: dark)").matches;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* Applique un thème à la page et le retient pour ce navigateur.
|
|
31
|
+
*
|
|
32
|
+
* @param dark - `true` pour le thème sombre
|
|
33
|
+
* @param remember - `false` pour l'appliquer sans le retenir (premier rendu)
|
|
34
|
+
*/
|
|
35
|
+
export function applyDarkTheme(dark: boolean, remember = true): void {
|
|
36
|
+
document.documentElement.dataset["theme"] = dark ? "dark" : "light";
|
|
37
|
+
if (!remember) return;
|
|
38
|
+
try {
|
|
39
|
+
localStorage.setItem(THEME_KEY, dark ? "dark" : "light");
|
|
40
|
+
} catch {
|
|
41
|
+
// Stockage refusé : le choix vaut pour cette page seulement.
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* Lumière qui suit le pointeur sur les cartes : UN écouteur pour toute la page,
|
|
47
|
+
* un calcul par image au plus.
|
|
48
|
+
*
|
|
49
|
+
* @param selector - les éléments éclairés (`.nf-card`)
|
|
50
|
+
* @returns la fonction qui retire l'écouteur
|
|
51
|
+
*/
|
|
52
|
+
export function startPointerLight(selector: string): () => void {
|
|
53
|
+
let frame = 0;
|
|
54
|
+
let target: HTMLElement | null = null;
|
|
55
|
+
let x = 0;
|
|
56
|
+
let y = 0;
|
|
57
|
+
const paint = (): void => {
|
|
58
|
+
frame = 0;
|
|
59
|
+
if (target === null) return;
|
|
60
|
+
const box = target.getBoundingClientRect();
|
|
61
|
+
target.style.setProperty("--mx", `${x - box.left}px`);
|
|
62
|
+
target.style.setProperty("--my", `${y - box.top}px`);
|
|
63
|
+
};
|
|
64
|
+
const onMove = (event: PointerEvent): void => {
|
|
65
|
+
const found =
|
|
66
|
+
event.target instanceof Element ? event.target.closest(selector) : null;
|
|
67
|
+
target = found instanceof HTMLElement ? found : null;
|
|
68
|
+
x = event.clientX;
|
|
69
|
+
y = event.clientY;
|
|
70
|
+
if (target !== null && frame === 0) frame = requestAnimationFrame(paint);
|
|
71
|
+
};
|
|
72
|
+
document.addEventListener("pointermove", onMove, { passive: true });
|
|
73
|
+
return () => {
|
|
74
|
+
document.removeEventListener("pointermove", onMove);
|
|
75
|
+
cancelAnimationFrame(frame);
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/** La barre de debug du développement, vue de la page. */
|
|
80
|
+
export interface IDebugBarHandle {
|
|
81
|
+
isVisible(): boolean;
|
|
82
|
+
setVisible(visible: boolean): void;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* La poignée que publie la barre de debug (développement), vérifiée avant usage.
|
|
87
|
+
*
|
|
88
|
+
* @returns la poignée, ou `null` hors développement ou avant son injection
|
|
89
|
+
*/
|
|
90
|
+
export function findDebugBar(): IDebugBarHandle | null {
|
|
91
|
+
const handle: unknown = Reflect.get(globalThis, "__NODEFONY_DEBUGBAR__");
|
|
92
|
+
if (typeof handle !== "object" || handle === null) return null;
|
|
93
|
+
if (!("isVisible" in handle) || !("setVisible" in handle)) return null;
|
|
94
|
+
const { isVisible, setVisible } = handle;
|
|
95
|
+
if (typeof isVisible !== "function" || typeof setVisible !== "function") {
|
|
96
|
+
return null;
|
|
97
|
+
}
|
|
98
|
+
return {
|
|
99
|
+
isVisible: () => isVisible.call(handle) === true,
|
|
100
|
+
setVisible: (visible) => void setVisible.call(handle, visible),
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* La page de la démo, si elle est chargée — CONSTATÉ par le serveur, qui la
|
|
106
|
+
* nomme dans la page (`<meta name="nodefony-demo">`, posée par
|
|
107
|
+
* `AppController`). Suit l'ajout ou le retrait du module, sans requête :
|
|
108
|
+
* une sonde HTTP qui échoue s'inscrit en erreur dans la console du navigateur.
|
|
109
|
+
*
|
|
110
|
+
* @returns l'adresse de la démo, ou `null` si elle n'est pas chargée
|
|
111
|
+
*/
|
|
112
|
+
export function findDemo(): string | null {
|
|
113
|
+
const meta = document.querySelector('meta[name="nodefony-demo"]');
|
|
114
|
+
return meta?.getAttribute("content") ?? null;
|
|
115
|
+
}
|