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
|
@@ -1,53 +1,280 @@
|
|
|
1
1
|
<script setup lang="ts">
|
|
2
2
|
/**
|
|
3
|
-
* Page d'accueil de <%= it.appName %> —
|
|
3
|
+
* Page d'accueil de <%= it.appName %> — c'est TA page.
|
|
4
4
|
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
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
|
-
*
|
|
11
|
-
*
|
|
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
|
-
|
|
14
|
-
|
|
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
|
-
|
|
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
|
-
<% }
|
|
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
|
-
<
|
|
39
|
-
<
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
<
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
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
|
-
</
|
|
49
|
-
<a v-else class="nf-
|
|
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
|
-
|
|
52
|
-
|
|
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
|
-
*
|
|
3
|
-
*
|
|
4
|
-
*
|
|
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
|
|
10
|
-
*
|
|
11
|
-
*
|
|
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-
|
|
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,
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
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
|
-
*
|
|
21
|
-
*
|
|
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
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
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
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
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
|
+
"&": "&",
|
|
35
|
+
"<": "<",
|
|
36
|
+
">": ">",
|
|
37
|
+
'"': """,
|
|
38
|
+
"'": "'",
|
|
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
|
|
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
|
|
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
|
|
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")
|