@mostajs/wagon-engine 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 **Auteur** : Dr Hamid MADANI <drmdh@msn.com>
 Format : Keep a Changelog ; versions : SemVer.
 
+## [0.3.0] — 2026-10-27
+
+### Ajouté
+- Les **dispositions** de `@mostajs/wagon-ui` 0.10 : une page de la charge choisit son cadre par
+  `ctx.page({ disposition: 'application' | 'console' | 'nu' | <fournie>, application, console })` ; les pages du wagon
+  (tarifs, connexion, compte…) restent en `vitrine`. Le moteur transmet `config.jetons` (rayon, police, ombre, fond),
+  le logo de `config.marque` (`logo`, `logoClair`) et `charge.dispositions` (dispositions fournies). Essai T-ENG-8.
+- `charge.accueil` peut être une **fonction** `async (ctx) => ({ titre, contenu, disposition, … })` : l'application
+  rend son propre accueil (la maquette de Speaking ouvre sur « Rejoindre mon groupe »). La fiche de données
+  `{ fr: { titre, lede, actions, preuves } }` marche toujours. Essai T-ENG-9.
+
+### Modifié
+- Dépend de `@mostajs/wagon-ui` `^0.10.0`.
+
 ## [0.2.0] — 2026-10-26
 
 ### Ajouté

package/llms.txt

@@ -22,12 +22,13 @@ PAYPAL_WEBHOOK_ID · PAIEMENT_<STRIPE|CHARGILY|SATIM|PAYPAL>=off (coupe le moyen
 Moyen ACTIF = clés présentes ET commutateur ≠ off (ET, pour une banque prépayée, proposée par config.paiement.prepaye).
 
 ## CONTRAT DE LA CHARGE (charge/index.mjs)
-liens · ressources (quota { cle, limite, periode } | plafond { cle, limite, plafond: true }) · accueil · textes ·
+liens · ressources (quota { cle, limite, periode } | plafond { cle, limite, plafond: true }) · accueil (fiche { fr: { titre, lede, actions, preuves } }, ou 0.3 : async (ctx) => ({ titre, contenu, disposition, application, console })) · dispositions (0.3 : { nom: (p) => corps }) · textes ·
 routes(req, res, ctx) (passent en premier ; true si servie) · conformite (essai de quota T-WAG-3) · amorcer() (base au
 démarrage) · exporterCompte(id), effacerCompte(id) (RGPD) · sitemap() · sauvegarde() · permissions (0.11 :
 { '/page': { microphone: 'self' }, '/dossier/*': … }, garde-http ≥ 0.2).
 ctx : chemin, methode, lang, t, ui, page({ titre, contenu }), envoyer, json, rediriger, formulaire, corpsJson({ strict }),
 compte, consommer(cle), refuser(v), palier({ compte? }), plafond(cle, n, { compte? }), courriel({ to, subject, text, html? }) → bool, admin.
+  0.3 : ctx.page({ disposition: 'vitrine'|'application'|'console'|'nu'|<fournie>, application: { retour, titre, avatar, onglets, langues }, console: { menu, contexte, utilisateur } }) (wagon-ui 0.10) ; config.jetons { rayon, police, policeTitres, ombre, fond } ; config.marque.logo / logoClair (SVG en ligne ou chemin /…).
   0.2 : { compte } = identifiant d'un compte DÉSIGNÉ (requête sans session bornée par le palier d'un compte rattaché par la charge).
 
 ## PIÈGES

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/wagon-engine",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Le wagon d'un SaaS, une fois pour toutes : comptes, connexion, paliers, quotas, paiement (Stripe, Chargily, SATIM), espace client, administration, pages légales, fr/en/ar. Une greffe n'apporte que wagon.config.mjs, charge/, legal/ et son .env ; la suite de conformité publiée juge la greffe.",
   "keywords": [
     "mostajs",
@@ -52,7 +52,7 @@
     "@mostajs/orm": "^2.12.1",
     "@mostajs/payment": "^2.6.0",
     "@mostajs/subscriptions-plan": "^0.9.0",
-    "@mostajs/wagon-ui": "^0.9.1",
+    "@mostajs/wagon-ui": "^0.10.0",
     "better-sqlite3": "^12.11.1",
     "stripe": "^17.7.0"
   },

package/src/wagon.mjs

@@ -187,7 +187,10 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
     // 0.9 (wagon-ui 0.6) — la feuille de style de l'application, de confiance, posée sur toutes les pages.
     css: typeof config.css === 'string' ? config.css : '',
     // 0.5 (wagon-ui 0.5) — en-tête collant, bouton d'appel, langue en menu déroulant : déclarés par wagon.config.mjs.
-    collant: config.collant === true, appel: config.appel ?? null, selecteurLangue: config.selecteurLangue ?? 'liens' });
+    collant: config.collant === true, appel: config.appel ?? null, selecteurLangue: config.selecteurLangue ?? 'liens',
+    // 0.3 (wagon-ui 0.10) — les jetons de forme, et les dispositions que la charge fournit (une page choisit son cadre
+    // par ctx.page({ disposition }) ; le logo vient de config.marque).
+    jetons: config.jetons ?? {}, dispositions: charge.dispositions ?? {} });
   const sessions = magasinSessions({ dialect: d, schema: S.Session, nom: 'wagon_session', jours: 30 });
   // 0.5 — les sessions expirées se purgent au démarrage puis toutes les six heures (auth-plug 0.3) ; les inscriptions
   // sont freinées par adresse (config.freinInscription, défaut : 10 puis 1 par minute).
@@ -555,6 +558,11 @@ export async function creerWagon({ config, charge, sgbd, baseUrl, stripe = null,
 
     // ── Les pages du wagon ──
     if (chemin === '/' && methode === 'GET') {
+      // 0.3 — l'accueil peut être une FONCTION de la charge : elle rend la page entière (titre, contenu, disposition).
+      if (typeof charge.accueil === 'function') {
+        const p = (await charge.accueil(ctx)) ?? {};
+        return envoyer(200, page({ actif: '/', ...p, titre: p.titre ?? config.marque.nom }));
+      }
       const a = charge.accueil?.[lang] ?? charge.accueil?.fr ?? { titre: config.marque.nom };
       return envoyer(200, page({ actif: '/', titre: config.marque.nom, contenu: ui.accueil({ lang, ...a }) }));
     }