@fasl-work/caos-app-shell 0.13.0 → 0.13.1

package/bin/caos-shell-gate.mjs

@@ -1,72 +1,72 @@
-#!/usr/bin/env node
-// caos-shell-gate: the measured web baseline of a CAOS product (ADR-0071, ADR-0017, ADR-0016, ADR-0078).
-// The checks and the traps each one embeds are listed in gate/run.mjs; the self-test (npm run test:gate in the
-// shell repository) plants one defect per check and requires each to fail.
-//
-// Usage:
-//   npx caos-shell-gate --serve dist --expect-brand "Contraste"            a Pages-faithful server over the build
-//   npx caos-shell-gate --url https://contraste.fasl-work.com --expect-brand "Contraste"     the deployed origin
-// Options:
-//   --base-path /Repo/           the site's base path with --serve (a project page); default /
-//   --routes /,/methodology      the routes; default: read from the header navigation
-//   --workbench /app             the routes that carry the case workbench; default /app
-//   --sizes 390x844,...,2560x1440  --themes light,dark  --langs en,es
-//   --case-sample id1,id2        cases walked outside the primary mode; default the first and the last
-//   --single-case                the workbench has one case and no case control
-//   --idle-ms 3000  --settle-ms 15000  --text-floor 400  --instrument-min 0.5  --stage-fill-min 0.3  --stage-floor 140
-//   --wide-font-sizes 390x844,1280x800   the sizes of the wide-font pass (G10); --no-wide-font skips it
-//   --out gate-output            report (gate-report.json), screenshots (shots/) and the capture index (index.html)
-// Needs `playwright` in the consuming project (optional peer dependency). Exit 1 on any failure, 2 on misuse.
-
-import { runGate } from '../gate/run.mjs';
-
-const FLAGS = new Set(['single-case', 'no-wide-font']);
-const args = {};
-const argv = process.argv.slice(2);
-for (let i = 0; i < argv.length; i += 1) {
-  const a = argv[i];
-  if (!a.startsWith('--')) continue;
-  const key = a.slice(2);
-  if (FLAGS.has(key)) args[key] = true;
-  else args[key] = argv[i + 1];
-  if (!FLAGS.has(key)) i += 1;
-}
-const num = (k) => (args[k] === undefined ? undefined : Number(args[k]));
-const options = {
-  url: args.url,
-  serve: args.serve,
-  basePath: args['base-path'],
-  expectBrand: args['expect-brand'],
-  routes: args.routes,
-  workbench: args.workbench,
-  sizes: args.sizes,
-  themes: args.themes,
-  langs: args.langs,
-  caseSample: args['case-sample'],
-  singleCase: args['single-case'] === true,
-  idleMs: num('idle-ms'),
-  settleMs: num('settle-ms'),
-  textFloor: num('text-floor'),
-  instrumentMin: num('instrument-min'),
-  stageFillMin: num('stage-fill-min'),
-  stageFloor: num('stage-floor'),
-  wideFontSizes: args['wide-font-sizes'],
-  wideFont: args['no-wide-font'] === true ? false : undefined,
-  out: args.out,
-};
-for (const k of Object.keys(options)) if (options[k] === undefined) delete options[k];
-
-let report;
-try {
-  report = await runGate(options);
-} catch (e) {
-  console.error(e.message);
-  process.exit(2);
-}
-const shown = report.failures.slice(0, 80);
-for (const f of shown) console.log(`FAIL [${f.check}] ${f.route} ${f.mode}${f.trail ? ` (${f.trail})` : ''}: ${f.message}`);
-if (report.failures.length > shown.length) console.log(`... and ${report.failures.length - shown.length} more in ${options.out ?? 'gate-output'}/gate-report.json`);
-for (const w of report.waivers ?? []) console.log(`WAIVER ${w.route} (${w.lang}) ${w.floor}: ${w.reason}${w.valid ? '' : ' [refused]'}`);
-const counts = Object.entries(report.checks).map(([k, n]) => `${k} ${n}`).join(', ');
-console.log(report.ok ? `caos-shell-gate: OK, ${report.states} measured states` : `caos-shell-gate: ${report.failures.length} failure(s) in ${report.states} measured states (${counts})`);
-process.exit(report.ok ? 0 : 1);
+#!/usr/bin/env node
+// caos-shell-gate: the measured web baseline of a CAOS product (ADR-0071, ADR-0017, ADR-0016, ADR-0078).
+// The checks and the traps each one embeds are listed in gate/run.mjs; the self-test (npm run test:gate in the
+// shell repository) plants one defect per check and requires each to fail.
+//
+// Usage:
+//   npx caos-shell-gate --serve dist --expect-brand "Contraste"            a Pages-faithful server over the build
+//   npx caos-shell-gate --url https://contraste.fasl-work.com --expect-brand "Contraste"     the deployed origin
+// Options:
+//   --base-path /Repo/           the site's base path with --serve (a project page); default /
+//   --routes /,/methodology      the routes; default: read from the header navigation
+//   --workbench /app             the routes that carry the case workbench; default /app
+//   --sizes 390x844,...,2560x1440  --themes light,dark  --langs en,es
+//   --case-sample id1,id2        cases walked outside the primary mode; default the first and the last
+//   --single-case                the workbench has one case and no case control
+//   --idle-ms 3000  --settle-ms 15000  --text-floor 400  --instrument-min 0.5  --stage-fill-min 0.3  --stage-floor 140
+//   --wide-font-sizes 390x844,1280x800   the sizes of the wide-font pass (G10); --no-wide-font skips it
+//   --out gate-output            report (gate-report.json), screenshots (shots/) and the capture index (index.html)
+// Needs `playwright` in the consuming project (optional peer dependency). Exit 1 on any failure, 2 on misuse.
+
+import { runGate } from '../gate/run.mjs';
+
+const FLAGS = new Set(['single-case', 'no-wide-font']);
+const args = {};
+const argv = process.argv.slice(2);
+for (let i = 0; i < argv.length; i += 1) {
+  const a = argv[i];
+  if (!a.startsWith('--')) continue;
+  const key = a.slice(2);
+  if (FLAGS.has(key)) args[key] = true;
+  else args[key] = argv[i + 1];
+  if (!FLAGS.has(key)) i += 1;
+}
+const num = (k) => (args[k] === undefined ? undefined : Number(args[k]));
+const options = {
+  url: args.url,
+  serve: args.serve,
+  basePath: args['base-path'],
+  expectBrand: args['expect-brand'],
+  routes: args.routes,
+  workbench: args.workbench,
+  sizes: args.sizes,
+  themes: args.themes,
+  langs: args.langs,
+  caseSample: args['case-sample'],
+  singleCase: args['single-case'] === true,
+  idleMs: num('idle-ms'),
+  settleMs: num('settle-ms'),
+  textFloor: num('text-floor'),
+  instrumentMin: num('instrument-min'),
+  stageFillMin: num('stage-fill-min'),
+  stageFloor: num('stage-floor'),
+  wideFontSizes: args['wide-font-sizes'],
+  wideFont: args['no-wide-font'] === true ? false : undefined,
+  out: args.out,
+};
+for (const k of Object.keys(options)) if (options[k] === undefined) delete options[k];
+
+let report;
+try {
+  report = await runGate(options);
+} catch (e) {
+  console.error(e.message);
+  process.exit(2);
+}
+const shown = report.failures.slice(0, 80);
+for (const f of shown) console.log(`FAIL [${f.check}] ${f.route} ${f.mode}${f.trail ? ` (${f.trail})` : ''}: ${f.message}`);
+if (report.failures.length > shown.length) console.log(`... and ${report.failures.length - shown.length} more in ${options.out ?? 'gate-output'}/gate-report.json`);
+for (const w of report.waivers ?? []) console.log(`WAIVER ${w.route} (${w.lang}) ${w.floor}: ${w.reason}${w.valid ? '' : ' [refused]'}`);
+const counts = Object.entries(report.checks).map(([k, n]) => `${k} ${n}`).join(', ');
+console.log(report.ok ? `caos-shell-gate: OK, ${report.states} measured states` : `caos-shell-gate: ${report.failures.length} failure(s) in ${report.states} measured states (${counts})`);
+process.exit(report.ok ? 0 : 1);

package/dist/chart.js

@@ -1,5 +1,5 @@
-import { useShellLang, useThemeStore, useStageSize, pick, resolveToken, NBSP, formatNumber, formatTicks } from './chunk-3QYQCWSZ.js';
-import './chunk-YVVDBSAC.js';
+import { useShellLang, useThemeStore, useStageSize, pick, resolveToken, NBSP, formatNumber, formatTicks } from './chunk-YECZXGVG.js';
+import './chunk-33WTUQ7Q.js';
 import { useRef, useCallback, useState, useMemo, useEffect } from 'react';
 import uPlot from 'uplot';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{chunk-3QYQCWSZ.js → chunk-YECZXGVG.js}

@@ -1,4 +1,4 @@
-import { LANG_STORAGE_KEY, THEME_STORAGE_KEY } from './chunk-YVVDBSAC.js';
+import { LANG_STORAGE_KEY, THEME_STORAGE_KEY } from './chunk-33WTUQ7Q.js';
 import { create } from 'zustand';
 import { useMemo, useState, useRef, useCallback, useEffect } from 'react';
 import { jsx } from 'react/jsx-runtime';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as APP_ROUTE, a as AppShell, b as ArchTab, c as ArchitectureConfig, d as ArchitectureModal, L as LANDING_ROUTE, e as LANG_STORAGE_KEY, S as STANDARD_ROUTES, f as ShellConfig, g as ShellRoute, T as THEME_BOOT_SCRIPT, h as THEME_STORAGE_KEY, v as validateArchitectureConfig } from './keys-CTQZafOf.js';
+export { A as APP_ROUTE, a as AppShell, b as ArchTab, c as ArchitectureConfig, d as ArchitectureModal, L as LANDING_ROUTE, e as LANG_STORAGE_KEY, S as STANDARD_ROUTES, f as ShellConfig, g as ShellRoute, T as THEME_BOOT_SCRIPT, h as THEME_STORAGE_KEY, v as validateArchitectureConfig } from './keys-DDQGijwQ.js';
 import * as react from 'react';
 import { ReactNode, Component, ErrorInfo } from 'react';
 import * as zustand from 'zustand';
@@ -406,9 +406,10 @@ declare function ReferenceList({ ids, heading }: {
 
 /**
  * A documentation route (Introduction, Methodology, Implementation, Experiments, Benchmark): the page head with
- * its title and lede, then sections. `wide` for a route with a sub-tab rail (ADR-0071 rule 2, amended
- * 2026-09-04); a single prose column keeps the reading width and is centred (ADR-0017 §1). Text takes the full width
- * of the column, and the references of its sections are listed once at the end of the page (ADR-0017 §4).
+ * its title and lede, then sections. Every documentation route takes the full width of the page, the Introduction
+ * included (Felipe, 2026-10-13: the Introduction did not use the full width while Methodology, Implementation,
+ * Experiments and Benchmark did; 0.13.1). `wide` is kept for compatibility and changes nothing. Text takes the full
+ * width of the column, and the references of its sections are listed once at the end of the page (ADR-0017 section 4).
  */
 /**
  * The areas a section may declare, per documentation route (ADR-0017 section 2.1). The gate's table (`gate/areas.mjs`)
@@ -424,6 +425,7 @@ declare const DOC_AREAS: {
 interface DocPageProps {
     title: BiText;
     lede: ReactNode;
+    /** Kept for compatibility (0.13.1): every documentation route is full width, so this changes nothing. */
     wide?: boolean;
     /**
      * The required areas this page cannot carry, each with the reason (ADR-0017 section 2.1): rendered as
@@ -436,7 +438,7 @@ interface DocPageProps {
     }>;
     children: ReactNode;
 }
-declare function DocPage({ title, lede, wide, floorWaivers, children }: DocPageProps): react.JSX.Element;
+declare function DocPage({ title, lede, floorWaivers, children }: DocPageProps): react.JSX.Element;
 interface DocSectionProps {
     title: BiText;
     id?: string;

package/dist/index.js

@@ -1,7 +1,7 @@
-import { useThemeStore, useShellLang, useLangStore, SHELL_TOKENS, pick, useStageSize, NOT_AVAILABLE, formatTicks, formatNumber, NBSP } from './chunk-3QYQCWSZ.js';
-export { NBSP, NOT_AVAILABLE, SCIENTIFIC_BELOW, SHELL_TOKENS, Stage, applyTheme, formatNumber, formatTicks, pick, readTheme, resolveToken, useFormat, useLangStore, useShellLang, useStageSize, useThemeStore, useThemeTokens } from './chunk-3QYQCWSZ.js';
-import { APP_ROUTE, LANDING_ROUTE } from './chunk-YVVDBSAC.js';
-export { APP_ROUTE, LANDING_ROUTE, LANG_STORAGE_KEY, STANDARD_ROUTES, THEME_BOOT_SCRIPT, THEME_STORAGE_KEY } from './chunk-YVVDBSAC.js';
+import { useThemeStore, useShellLang, useLangStore, SHELL_TOKENS, pick, useStageSize, NOT_AVAILABLE, formatTicks, formatNumber, NBSP } from './chunk-YECZXGVG.js';
+export { NBSP, NOT_AVAILABLE, SCIENTIFIC_BELOW, SHELL_TOKENS, Stage, applyTheme, formatNumber, formatTicks, pick, readTheme, resolveToken, useFormat, useLangStore, useShellLang, useStageSize, useThemeStore, useThemeTokens } from './chunk-YECZXGVG.js';
+import { APP_ROUTE, LANDING_ROUTE } from './chunk-33WTUQ7Q.js';
+export { APP_ROUTE, LANDING_ROUTE, LANG_STORAGE_KEY, STANDARD_ROUTES, THEME_BOOT_SCRIPT, THEME_STORAGE_KEY } from './chunk-33WTUQ7Q.js';
 import { createContext, Component, useState, useRef, useId, useEffect, useCallback, useContext, useMemo, useLayoutEffect, Children } from 'react';
 import { useInRouterContext, NavLink, useLocation, Navigate, Link } from 'react-router';
 import { Sun, Moon, Languages, Boxes, CodeXml, Globe, Briefcase, Info } from 'lucide-react';
@@ -1149,10 +1149,10 @@ var DOC_AREAS = {
   "/experiments": ["question", "metrics", "protocol", "datasets"],
   "/benchmark": ["results", "comparison", "robustness", "live", "provenance", "caveat"]
 };
-function DocPage({ title, lede, wide, floorWaivers, children }) {
+function DocPage({ title, lede, floorWaivers, children }) {
   const lang = useShellLang();
   const waivers = (floorWaivers ?? []).map((w) => `${w.floor}: ${pick(w.reason, lang)}`).join("; ");
-  return /* @__PURE__ */ jsxs("div", { className: wide ? "page-body wide prose caos-doc" : "page-body prose caos-doc", "data-doc-page": "", "data-floor-waiver": waivers || void 0, children: [
+  return /* @__PURE__ */ jsxs("div", { className: "page-body wide prose caos-doc", "data-doc-page": "", "data-floor-waiver": waivers || void 0, children: [
     /* @__PURE__ */ jsxs("div", { className: "page-head", children: [
       /* @__PURE__ */ jsx("h1", { children: pick(title, lang) }),
       /* @__PURE__ */ jsx("p", { className: "lede", children: lede })

package/dist/{keys-CTQZafOf.d.ts → keys-DDQGijwQ.d.ts}

@@ -115,9 +115,11 @@ declare const LANDING_ROUTE = "/introduction";
 /** The route of the App (the tool); it was the root before 0.13.0 (the `Landing` component forwards old links). */
 declare const APP_ROUTE = "/app";
 /**
- * The six routes every CAOS product carries, in this order (ADR-0016 s3, ADR-0069 s7, the product quality bar):
- * the Introduction (the landing, executive view first), the App (the tool) and the four other documentation routes. One
- * definition, so the header, the router and the gate read the same list and no product retypes it.
+ * The six routes every CAOS product carries, ALWAYS in this order (Felipe, 2026-10-13): App, Introduction,
+ * Methodology, Implementation, Experiments, Benchmark. The App stays the leftmost tab; the product lands on the
+ * Introduction (its executive view first) through `Landing`, which never changes the order (0.13.0 had moved the
+ * Introduction first; 0.13.1 restores the App). One definition, so the header, the router and the gate read the same
+ * list and no product retypes it.
  */
 declare const STANDARD_ROUTES: ShellRoute[];
 

package/dist/keys.d.ts

@@ -1,4 +1,4 @@
-export { A as APP_ROUTE, L as LANDING_ROUTE, e as LANG_STORAGE_KEY, S as STANDARD_ROUTES, T as THEME_BOOT_SCRIPT, h as THEME_STORAGE_KEY } from './keys-CTQZafOf.js';
+export { A as APP_ROUTE, L as LANDING_ROUTE, e as LANG_STORAGE_KEY, S as STANDARD_ROUTES, T as THEME_BOOT_SCRIPT, h as THEME_STORAGE_KEY } from './keys-DDQGijwQ.js';
 import 'react';
 import './text-BlY47nIt.js';
 import 'zustand';

package/dist/keys.js

@@ -1 +1 @@
-export { APP_ROUTE, LANDING_ROUTE, LANG_STORAGE_KEY, STANDARD_ROUTES, THEME_BOOT_SCRIPT, THEME_STORAGE_KEY } from './chunk-YVVDBSAC.js';
+export { APP_ROUTE, LANDING_ROUTE, LANG_STORAGE_KEY, STANDARD_ROUTES, THEME_BOOT_SCRIPT, THEME_STORAGE_KEY } from './chunk-33WTUQ7Q.js';