@artefact-ci/prototype 0.1.1 → 0.2.0

package/README.md

@@ -1,18 +1,18 @@
 # @artefact-ci/prototype
 
-Maquettes HTML cliquables d'une fonctionnalité, sorties de `pnpm prototype` du boilerplate (`b30bb7b`). C'est la commande `ui.prototype` de `.specify/stack.yml`, lancée par `/speckit-prototype`.
+Le prototype HTML cliquable du produit, sorties de `pnpm prototype` du boilerplate (`b30bb7b`). C'est la commande `ui.prototype` de `.specify/stack.yml`, lancée par `/speckit-prototype`.
 
 ```sh
-npx @artefact-ci/prototype specs/004-checkout            # compile styles.css depuis le thème, vérifie les liens
-npx @artefact-ci/prototype specs/004-checkout --capture  # puis remplace captures/ (desktop et mobile)
-npx @artefact-ci/prototype specs/004-checkout --theme src/app/globals.css  # autre thème que ui.theme
+npx @artefact-ci/prototype            # compile styles.css depuis le thème, vérifie les liens
+npx @artefact-ci/prototype --capture  # puis remplace captures/ (desktop et mobile)
+npx @artefact-ci/prototype --theme src/app/globals.css  # autre thème que ui.theme
 ```
 
-À lancer à la racine du dépôt (Node 24.11 ou plus récent). Les pages vivent à plat dans `specs/NNN-<nom>/prototypes/`, `index.html` en entrée ; la commande affiche l'URL `file://` de `index.html`, à ouvrir sans serveur.
+À lancer à la racine du dépôt (Node 24.11 ou plus récent). Le prototype est global : les pages de toutes les fonctionnalités vivent à plat dans `specs/prototype/`, `index.html` en entrée (les parcours par epic puis par fonctionnalité), et les parcours dans `specs/prototype/journeys/NNN-<nom>.md`. La commande ne prend pas de dossier : elle refuse un argument (un dossier de spec, comme avant la 0.2.0) ; la commande affiche l'URL `file://` de `index.html`, à ouvrir sans serveur.
 
 - **Liens** : un lien vers une page absente fait échouer ; une page vers laquelle rien ne mène est signalée.
 - **Styles** : `styles.css` est compilé par Tailwind 4 depuis le thème du projet (`ui.theme`) et les classes des pages. Les fichiers des paquets importés par le thème (polices `@fontsource`) sont copiés à côté.
-- **Captures** : une par page et par format (1440×900, 390×844) dans `captures/`, pleine page sauf pour une page marquée `data-capture="viewport"` (dialogue, toast). Un échec garde les anciennes.
+- **Captures** : une par page et par format (1440×900, 390×844) dans `specs/prototype/captures/`, pleine page sauf pour une page marquée `data-capture="viewport"` (dialogue, toast). Un échec garde les anciennes.
 
 Le CLI Tailwind (`@tailwindcss/cli`) et Playwright sont pris dans le projet s'il les a, sinon dans ce paquet : les styles compilent avec la version de l'app, et les captures trouvent le Chromium déjà installé pour les parcours.
 

package/dist/cli.mjs

@@ -8,10 +8,10 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     return path;
 };
 /**
- * Prototype d'une fonctionnalité (/speckit-prototype), pages HTML dans specs/NNN-<nom>/prototypes/,
- * à lancer à la racine du dépôt :
- *   artefact-prototype specs/004-checkout             → compile styles.css depuis le thème (ui.theme)
- *   artefact-prototype specs/004-checkout --capture   → puis remplace captures/ (desktop et mobile)
+ * Prototype global du produit (/speckit-prototype), pages HTML dans specs/prototype/, que chaque
+ * fonctionnalité complète, à lancer à la racine du dépôt :
+ *   artefact-prototype             → vérifie les liens, compile styles.css depuis le thème (ui.theme)
+ *   artefact-prototype --capture   → puis remplace captures/ (desktop et mobile, toutes les pages)
  * Affiche l'URL de index.html, à ouvrir dans le navigateur : aucun serveur.
  * Tailwind (`@tailwindcss/cli`) et Playwright sont pris dans le projet s'il les a, sinon dans ce
  * paquet : la maquette compile avec la même version que l'app, et les captures trouvent le Chromium
@@ -22,10 +22,10 @@ import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameS
 import { createRequire } from 'node:module';
 import { basename, dirname, join, relative, resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { VIEWPORTS, captureTargets, capturesViewportOnly, entryCss, linkProblems, localUrls, packageImports, pageFiles, prototypesDir, } from "./core.mjs";
+import { VIEWPORTS, captureTargets, capturesViewportOnly, entryCss, linkProblems, localUrls, packageImports, pageFiles, PROTOTYPE_DIR, prototypeArgs, } from "./core.mjs";
 import { binOf, chromiumInstallHint, themeOf } from "./stack.mjs";
 const STACK_FILE = join('.specify', 'stack.yml');
-const USAGE = 'Usage : artefact-prototype <specs/NNN-nom> [--capture] [--theme <fichier css>]';
+const USAGE = 'Usage : artefact-prototype [--capture] [--theme <fichier css>]';
 const args = process.argv.slice(2);
 if (args.includes('--help') || args.includes('-h')) {
     console.log(USAGE);
@@ -37,23 +37,16 @@ if (themeAt >= 0 && (!themeArg || themeArg.startsWith('--'))) {
     console.error(`--theme attend le fichier de thème du projet.\n${USAGE}`);
     process.exit(1);
 }
-const capture = args.includes('--capture');
-const unknownOption = args.find((arg) => arg.startsWith('--') && arg !== '--capture');
-if (unknownOption) {
-    console.error(`Option inconnue : ${unknownOption}\n${USAGE}`);
-    process.exit(1);
-}
-const featurePath = args.find((arg) => !arg.startsWith('--')) ?? '';
-// Le dossier de la feature d'abord : sans argument, l'usage s'affiche avant tout le reste.
-let dir;
+const dir = PROTOTYPE_DIR;
+let capture;
 let pages;
 try {
-    dir = prototypesDir(featurePath);
+    ({ capture } = prototypeArgs(args));
     pages = pageFiles(readdirSync(dir));
 }
 catch (error) {
     const message = error.code === 'ENOENT'
-        ? `${featurePath} n'a pas de dossier prototypes/.`
+        ? `${dir}/ n'existe pas : /speckit-prototype le crée.`
         : error.message;
     console.error(`${USAGE}\n${message}`);
     process.exit(1);
@@ -193,6 +186,8 @@ if (capture) {
             await page.screenshot({
                 path: join(fresh, basename(target.file)),
                 fullPage: !capturesViewportOnly(html[target.page]),
+                // Une animation (spinner) figée : une page inchangée donne la même capture d'une fois à l'autre.
+                animations: 'disabled',
             });
             await page.close();
         }

package/dist/core.mjs

@@ -1,21 +1,28 @@
 /**
- * Prototype d'une fonctionnalité (/speckit-prototype) : pages HTML statiques à plat dans
- * specs/NNN-<nom>/prototypes/, index.html en entrée, styles.css compilé depuis le vrai thème du
- * projet (`ui.theme` de .specify/stack.yml), captures par page et par format dans captures/.
- * Logique pure ; les fichiers, la compilation et les captures sont dans cli.mts.
+ * Prototype du produit (/speckit-prototype) : un seul, global, que chaque fonctionnalité complète.
+ * Pages HTML statiques à plat dans specs/prototype/, index.html en entrée (par epic et parcours),
+ * parcours de chaque fonctionnalité dans journeys/NNN-<nom>.md, styles.css compilé depuis le vrai
+ * thème du projet (`ui.theme` de .specify/stack.yml), captures par page et par format dans
+ * captures/. Logique pure ; les fichiers, la compilation et les captures sont dans cli.mts.
  */
 /** Formats des captures : un écran de bureau courant et un téléphone courant. */
 export const VIEWPORTS = {
     desktop: { width: 1440, height: 900 },
     mobile: { width: 390, height: 844 },
 };
-/** Dossier des prototypes d'une fonctionnalité, à partir de son dossier ou de celui des prototypes. */
-export function prototypesDir(featurePath) {
-    const match = /^(specs\/\d{3}-[a-z0-9-]+?)(?:\/prototypes)?\/?$/.exec(featurePath);
-    if (!match) {
-        throw new Error(`« ${featurePath} » n'est pas le dossier d'une fonctionnalité : specs/NNN-<name> attendu.`);
+/** Arguments de `pnpm prototype` : `--capture` seulement, le prototype n'a qu'un dossier. */
+/** Dossier du prototype global. */
+export const PROTOTYPE_DIR = 'specs/prototype';
+/** Arguments hors `--theme` : `--capture` seulement, le prototype n'a qu'un dossier. */
+export function prototypeArgs(args) {
+    for (const arg of args) {
+        if (arg === '--capture')
+            continue;
+        throw new Error(arg.startsWith('--')
+            ? `Option inconnue : ${arg}.`
+            : `« ${arg} » : le prototype est global, dans ${PROTOTYPE_DIR}/ ; la commande ne prend plus de dossier.`);
     }
-    return `${match[1]}/prototypes`;
+    return { capture: args.includes('--capture') };
 }
 /** Feuille d'entrée de Tailwind : le thème de l'app, et les classes des pages du prototype. */
 export function entryCss(themeRelativePath) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artefact-ci/prototype",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Maquettes HTML cliquables d'une spec, compilées depuis le thème du projet (méthode artefact-sdd)",
   "license": "MIT",
   "repository": {