@starterlib/cli 0.11.0 → 0.11.1

package/README.md

@@ -54,7 +54,7 @@ Codes de sortie : `0` conforme ; `1` une etape a echoue ; `2` la commande ne peu
 | `versions`       | tous     | Versions exactes de la matrice, greffon de federation lie a Angular, pnpm, Node, train du socle                                                                                                                                                                                             |
 | `navigateurs`    | tous     | La liste browserslist de la SPA (`.browserslistrc`, ou `browserslist` de `package.json`) est celle du plancher de la matrice : ni absente, ni plus basse, ni plus large (lot 276)                                                                                                           |
 | `dependances`    | tous     | Dependances de production revues, paquets interdits, aucun outil du socle recopie sous `tools/`                                                                                                                                                                                             |
-| `jetons`         | tous     | Chaque `var(--st-*)` sans repli existe dans `@starterlib/tokens` (feuilles et styles en ligne)                                                                                                                                                                                              |
+| `jetons`         | tous     | Chaque `var(--st-*)` sans repli existe dans `@starterlib/tokens` (feuilles et styles en ligne) ; la marque de la SPA (`marque.json`, `.ts` ou `.mjs`), rejouee par le moteur installe ; sa feuille versionnee (`starterWeb.feuilleDeMarque`), identique a celle qu'il engendre              |
 | `format`         | tous     | `prettier --check .`                                                                                                                                                                                                                                                                        |
 | `lint`           | tous     | Prefixe des selecteurs (jamais `st-`), `eslint .`, puis stylelint (configuration du socle exigee)                                                                                                                                                                                           |
 | `i18n`           | tous     | Memes cles et arguments en fr et en, messages lisibles, cles appelees presentes, aide de chaque page (`<perimetre>.aide.<page>`), types a jour, formulations interdites par l'application (`starterWeb.formulationsInterdites`)                                                             |
@@ -100,6 +100,10 @@ par un point d'entree vide dans la configuration `production`).
   `raison`, une `date`) ; l'etape `i18n` y cherche chaque texte sans casse ni accents et en mots
   entiers, chaque motif tel quel (format detaille : `src/etapes/formulations.mjs`). Sans reglage,
   rien n'est cherche : le socle ne connait aucune formulation ;
+- la feuille de marque que la SPA versionne : `starterWeb.feuilleDeMarque`, chemin relatif a sa racine
+  (`marque/starter-tokens-<nom>.css`, ecrite par `starter-web jetons --sortie marque`) ; l'etape
+  `jetons` la veut identique a celle que le moteur installe engendre de sa marque, fins de ligne mises
+  a part. Sans reglage, seule la marque est jugee ;
 - le prefixe des selecteurs : `prefix` du projet d'`angular.json` (ou `starterWeb.prefixe`) ;
 - le dossier livre : `outputPath` de la cible `@angular/build:application`, plus `browser` ;
 - le train requis et le socle construit : `remoteEntry.json`, ce que la federation a reellement

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starterlib/cli",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "Chaine de verification et de construction des SPA du socle frontal starter : starter-web verify, construire, sprite, manifeste, precompresser. Jamais en dependance de production.",
   "license": "UNLICENSED",
   "type": "module",

package/src/etapes/budget.mjs

@@ -25,8 +25,8 @@ import { natureDesFichiers } from '../livraison.mjs';
 export const BUDGETS_DU_REMOTE = { pageKo: 60, totalKo: 250, catalogueKo: 30 };
 
 /**
- * Les seuils de l'hote, en Ko brotli (ADR 0031) : 309 pour le premier ecran reel, 288 pour la
- * charge initiale (ADR web 0005, D167). Leur histoire : ramenes au socle 0.10.0 (releves dans
+ * Les seuils de l'hote, en Ko brotli (ADR 0031) : 313 pour le premier ecran reel, 289 pour la
+ * charge initiale (ADR web 0005, D168). Leur histoire : ramenes au socle 0.10.0 (releves dans
  * l'ADR 0031) ; la charge initiale passee de 280 a 281 le 2026-09-29, decision du proprietaire :
  * 280,4 Ko mesures avec le socle 0.10.9, dont les controles d'empreinte S05 du lot 272 tournent au
  * demarrage. Puis, le meme jour, 282 et 301 (decision de l'orchestrateur sur autorisation du
@@ -35,13 +35,16 @@ export const BUDGETS_DU_REMOTE = { pageKo: 60, totalKo: 250, catalogueKo: 30 };
  * marque, demarrage determine, amorce). Puis 288 et 309 le 2026-10-07 : la coquille d'Aplomb
  * mesuree contre la 0.11.0 construite, avant publication, 286,96 et 307,86 Ko (+5,1 et +6,2 Ko sur
  * la 0.10.14 : barre inferieure, action critique et raccourci, ressource rafraichie, tronc), puis
- * 287,4 et 308,3 Ko avec sa feuille de marque et la feuille de sa police de titre (+0,44 Ko).
+ * 287,4 et 308,3 Ko avec sa feuille de marque et la feuille de sa police de titre (+0,44 Ko). Puis
+ * 289 et 313 le 2026-10-07 : la coquille d'Aplomb refaite sur ses maquettes (menu en haut, barre
+ * inferieure, bandeau du compte simule, pied, accueil de simulation), mesuree contre la 0.11.1
+ * construite, avant publication, 288,2 et 312,2 Ko (tronc a 47 410 octets, D168).
  *
  * ⚠️ Ce ne sont pas la cible du plan SPA §2.8 (170 Ko). L'ecart restant est STRUCTUREL : un paquet
  * partage en singleton part ENTIER, parce que n'importe quel remote peut en avoir besoin. Un seuil
  * se baisse ; il ne se leve jamais sans mesure ecrite et sans date.
  */
-export const BUDGETS_DE_L_HOTE = { premierEcranKo: 309, chargeInitialeKo: 288, cibleDuPlanKo: 170 };
+export const BUDGETS_DE_L_HOTE = { premierEcranKo: 313, chargeInitialeKo: 289, cibleDuPlanKo: 170 };
 
 /** Les imports DYNAMIQUES d'un module : les pages qu'il charge a la demande. */
 const IMPORT_DYNAMIQUE = /\bimport\s*\(\s*["']([^"']+)["']\s*\)/g;

package/src/etapes/jetons.mjs

@@ -14,12 +14,19 @@
  *
  * La MARQUE de la SPA (niveau 2 bis : `marque.json`, `marque.ts` ou `marque.mjs` a la racine) est
  * rejouee ici a chaque verification, par le moteur des jetons installe : une valeur reprise qui fait
- * tomber une paire sous son seuil rougit `verify`, paire nommee, avant la construction.
+ * tomber une paire sous son seuil rougit `verify`, paire nommee, avant la construction. Sa feuille
+ * versionnee, si la SPA la declare (`starterWeb.feuilleDeMarque`), doit etre celle que ce moteur
+ * engendre : une feuille perimee rougit aussi.
  */
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { fichiers, relatif } from '../commun.mjs';
-import { fichierDeMarque, jugerLaMarque } from '../marque.mjs';
+import {
+  FICHIERS_DE_MARQUE,
+  deriveDeLaFeuille,
+  fichierDeMarque,
+  jugerLaMarque,
+} from '../marque.mjs';
 
 /** Poses a l'execution par un composant du socle, donc absents des feuilles engendrees. */
 const POSES_A_L_EXECUTION = new Set([
@@ -110,11 +117,24 @@ export default {
     const { defauts, lues } = jugerLesJetons(feuilles, definis);
     let marque = '';
     const chemin = fichierDeMarque(projet.racine);
+    const versionnee = projet.paquet?.starterWeb?.feuilleDeMarque;
     if (chemin !== null) {
       const nom = relatif(projet.racine, chemin);
       const juge = await jugerLaMarque(projet.racine, chemin);
       for (const defaut of juge.defauts) defauts.push(`${nom} : ${defaut}`);
-      if (juge.defauts.length === 0) marque = ` ; marque ${String(juge.valeurs.nom)} conforme`;
+      if (juge.defauts.length === 0) {
+        marque = ` ; marque ${String(juge.valeurs.nom)} conforme`;
+        if (versionnee !== undefined) {
+          const attendue = juge.moteur.feuilleDeMarque(juge.valeurs);
+          const derive = deriveDeLaFeuille(projet.racine, versionnee, juge.valeurs.nom, attendue);
+          if (derive === null) marque += `, ${String(versionnee)} a jour`;
+          else defauts.push(derive);
+        }
+      }
+    } else if (versionnee !== undefined) {
+      defauts.push(
+        `package.json : starterWeb.feuilleDeMarque sans fichier de marque (${FICHIERS_DE_MARQUE.join(', ')}).`,
+      );
     }
     return {
       defauts,

package/src/marque.mjs

@@ -7,9 +7,13 @@
  *
  * Fichier de marque : `marque.json`, ou un module `marque.ts` / `marque.mjs` qui exporte la table
  * (`export default`, ou `export const marque`). Forme : `ValeursDeMarque` du moteur (README des jetons).
+ *
+ * Une SPA qui VERSIONNE sa feuille (chargee par `angular.json`, relue a la revue) la declare dans
+ * `starterWeb.feuilleDeMarque` : l'etape `jetons` la confronte alors a celle que le moteur installe
+ * engendre, et la refuse si elle a derive (P09-01 d'Aplomb, qui la gardait par un script a lui).
  */
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join, resolve } from 'node:path';
+import { basename, dirname, join, resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { dossierInstalle } from './socle-installe.mjs';
 
@@ -76,3 +80,27 @@ export async function ecrireLaFeuilleDeMarque(racine, chemin, sortie) {
   writeFileSync(feuille, moteur.feuilleDeMarque(valeurs));
   return { valeurs, defauts, feuille };
 }
+
+/**
+ * La feuille VERSIONNEE d'une SPA (`versionnee` : `starterWeb.feuilleDeMarque`, relatif a sa racine),
+ * confrontee a la feuille `attendue` que le moteur installe engendre de sa marque `nom` : `null` si elle
+ * est a jour, le defaut sinon. Les fins de ligne ne comptent pas (une copie de travail sous Windows les
+ * convertit).
+ */
+export function deriveDeLaFeuille(racine, versionnee, nom, attendue) {
+  if (typeof versionnee !== 'string' || versionnee === '') {
+    return 'package.json : starterWeb.feuilleDeMarque, le chemin de la feuille versionnee, est attendu.';
+  }
+  const fichier = `starter-tokens-${nom}.css`;
+  if (basename(versionnee) !== fichier) {
+    return `starterWeb.feuilleDeMarque : ${versionnee}, la feuille de la marque ${nom} se nomme ${fichier}.`;
+  }
+  const regenerer = `starter-web jetons --sortie ${dirname(versionnee)}`;
+  const chemin = resolve(racine, versionnee);
+  if (!existsSync(chemin)) return `${versionnee} absente : ${regenerer}.`;
+  const lf = (texte) => texte.replace(/\r\n/g, '\n');
+  if (lf(readFileSync(chemin, 'utf8')) !== lf(attendue)) {
+    return `${versionnee} perimee : ${regenerer}, puis la relire et la commiter.`;
+  }
+  return null;
+}