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

package/bin/caos-shell-gate.mjs

@@ -9,7 +9,7 @@
 // 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 /                the routes that carry the case workbench; default /
+//   --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

package/dist/chart.js

@@ -1,5 +1,5 @@
-import { useShellLang, useThemeStore, useStageSize, pick, resolveToken, NBSP, formatNumber, formatTicks } from './chunk-DX36XRD5.js';
-import './chunk-X6Y5CDUD.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-X6Y5CDUD.js → chunk-33WTUQ7Q.js}

@@ -1,7 +1,9 @@
 // src/shell/routes.ts
+var LANDING_ROUTE = "/introduction";
+var APP_ROUTE = "/app";
 var STANDARD_ROUTES = [
-  { path: "/", en: "App", es: "App" },
-  { path: "/introduction", en: "Introduction", es: "Introducci\xF3n" },
+  { path: APP_ROUTE, en: "App", es: "App" },
+  { path: LANDING_ROUTE, en: "Introduction", es: "Introducci\xF3n" },
   { path: "/methodology", en: "Methodology", es: "Metodolog\xEDa" },
   { path: "/implementation", en: "Implementation", es: "Implementaci\xF3n" },
   { path: "/experiments", en: "Experiments", es: "Experimentos" },
@@ -13,4 +15,4 @@ var THEME_STORAGE_KEY = "caos.theme";
 var LANG_STORAGE_KEY = "caos.lang";
 var THEME_BOOT_SCRIPT = `(function(){try{var t=localStorage.getItem('${THEME_STORAGE_KEY}');if(t!=='light'&&t!=='dark'){t=matchMedia('(prefers-color-scheme: light)').matches?'light':'dark'}document.documentElement.dataset.theme=t;var l=localStorage.getItem('${LANG_STORAGE_KEY}');document.documentElement.lang=l==='es'?'es':'en'}catch(e){document.documentElement.dataset.theme='dark'}})();`;
 
-export { LANG_STORAGE_KEY, STANDARD_ROUTES, THEME_BOOT_SCRIPT, THEME_STORAGE_KEY };
+export { APP_ROUTE, LANDING_ROUTE, LANG_STORAGE_KEY, STANDARD_ROUTES, THEME_BOOT_SCRIPT, THEME_STORAGE_KEY };

package/dist/{chunk-DX36XRD5.js → chunk-YECZXGVG.js}

@@ -1,4 +1,4 @@
-import { LANG_STORAGE_KEY, THEME_STORAGE_KEY } from './chunk-X6Y5CDUD.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 AppShell, a as ArchTab, b as ArchitectureConfig, c as ArchitectureModal, L as LANG_STORAGE_KEY, S as STANDARD_ROUTES, d as ShellConfig, e as ShellRoute, T as THEME_BOOT_SCRIPT, f as THEME_STORAGE_KEY, v as validateArchitectureConfig } from './keys-CnvqkckF.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';
@@ -7,6 +7,20 @@ export { N as NBSP, a as NOT_AVAILABLE, b as SCIENTIFIC_BELOW, c as SHELL_TOKENS
 import { L as Lang, B as BiText } from './text-BlY47nIt.js';
 export { p as pick, u as useLangStore, a as useShellLang } from './text-BlY47nIt.js';
 
+/**
+ * The landing route of a product (shell 0.13.0, Felipe 2026-10-13: "the shell and the apps must land at the Introduction,
+ * executive view"). Mount it on the root path and on the catch-all path:
+ *
+ *     <Route path="/" element={<Landing />} />
+ *     <Route path="/app" element={<App />} />
+ *     <Route path="*" element={<Landing />} />
+ *
+ * The root and any unknown entry open the Introduction, whose executive view is its first and default view. An old link
+ * to the App, which was the root (`/?case=B2`, with a query string or a hash), is forwarded to the App route with the query
+ * string and the hash kept, so a link in a paper or a bookmark still reaches its case.
+ */
+declare function Landing(): react.JSX.Element;
+
 /** One authenticated workbench destination rendered by the shared responsive navigation frame. */
 interface WorkbenchRoute {
     path: string;
@@ -392,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`)
@@ -410,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
@@ -422,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;
@@ -472,88 +488,170 @@ interface ExecutiveViewProps {
     data: unknown;
     /** Where the product's site is served from; the illustration files are fetched from here (default `/`; a Pages site passes its base URL). */
     base?: string;
+    /** Opens the technical view of the Introduction (default: selects the sibling tab `technical` of the tab that holds the view). */
+    onOpenTechnical?: () => void;
 }
 /**
- * The executive view of an Introduction (CAOS_MANAGE conventions/problem-context-first.md, Felipe 2026-10-12): the four
- * sections of the executive-pitch rubric in order, the three illustrations in their places, the sources as numbered
- * notes. A product fills `content/executive.json`; it does not design this view, so the component takes no children.
- * Invalid data renders an error state that lists each field path, never a blank.
+ * The executive view of an Introduction (CAOS_MANAGE conventions/problem-context-first.md, Felipe 2026-10-12 and
+ * 2026-10-13): the industry's problem framed for a decision maker. Above the sub-tabs, the landing block (the title, the key
+ * statement, two or three headline figures); then the five sections of `EXEC_SECTION_DEFS` as the sub-tabs of `SubTabs`, the
+ * first selected, each opening with its key message line; below them the numbered linked sources and two onward links (the
+ * technical view, the App). General, never a client, never a pitch. A product fills `content/executive.json`; it does not
+ * design this view, so the component takes no children. Invalid data renders an error state that lists each field path,
+ * never a blank.
  */
-declare function ExecutiveView({ data, base }: ExecutiveViewProps): react.JSX.Element;
+declare function ExecutiveView({ data, base, onOpenTechnical }: ExecutiveViewProps): react.JSX.Element;
 
 /**
- * The executive view standard (CAOS_MANAGE conventions/problem-context-first.md, Felipe 2026-10-12): the types of the
- * data file `content/executive.json`, its validator and its writing limits. The structure lives ONLY in
- * `executive.schema.json` (this module interprets it); the rules a schema cannot say (the limits, the 4 C's, the
- * sources by field) are here. `gate/areas.mjs` keeps the same limits for the rendered page; a unit test keeps them equal.
- */
-declare const EXECUTIVE_SCHEMA_VERSION = "1.0.0";
-/**
- * The names of the 4 C's, in the order of the 4Cs Positioning section. EMPTY ON PURPOSE: the names and the order are
- * Felipe's to give (problem-context-first.md, open item). While it is empty `four_cs` must be absent from every data
- * file and section 3 renders its declared pending state; once it holds 4 names `four_cs` is required in that order.
+ * The executive view standard (CAOS_MANAGE conventions/problem-context-first.md, Felipe 2026-10-12 and 2026-10-13): the
+ * types of the data file `content/executive.json`, its validator, its floors and its writing limits. The structure lives
+ * ONLY in `executive.schema.json` (this module interprets it); the rules a schema cannot say (the limits, the 4 C's, the
+ * sources by id, the owners that are roles, the wording) are here. `gate/areas.mjs` keeps the same limits and floors for
+ * the rendered page; a unit test keeps them equal.
  */
-declare const FOUR_CS: readonly string[];
+declare const EXECUTIVE_SCHEMA_VERSION = "2.0.0";
 interface BiTextValue {
     en: string;
     es: string;
 }
+interface FourC {
+    name: BiTextValue;
+    definition: BiTextValue;
+}
+/**
+ * The 4 C's of the proposal (sub-tab 5), in order, with the names and definitions Felipe gave on 2026-10-13 (verbatim,
+ * English and Spanish). `proposal.four_cs` is required in every data file with exactly these four rows in this order, each
+ * `c` equal to the name and each with what the C means for the proposal (`applies`); the view shows the definition in small
+ * type beside the name. `gate/areas.mjs` EXEC_FOUR_CS holds the same values; a unit test keeps them equal.
+ */
+declare const FOUR_CS: readonly FourC[];
+type Direction = 'rising' | 'easing' | 'steady';
+type TrendKind = 'regulatory' | 'technological' | 'market' | 'practice';
+type Horizon = 'now' | 'two_years' | 'ten_years';
+type Confidence = 'low' | 'medium' | 'high';
 interface ExecutiveFigure {
+    heading: BiTextValue;
     value: BiTextValue;
     unit: BiTextValue;
-}
-interface ExecutiveOutcome {
-    capability: BiTextValue;
-    outcome: BiTextValue;
-    proof: ExecutiveFigure & {
-        statement: BiTextValue;
-    };
+    /** The id of an entry of `sources`. */
+    source: string;
 }
 interface ExecutiveIllustration {
     /** The SVG file (a path under the site root), or one per language. */
     file: string | BiTextValue;
     caption: BiTextValue;
 }
+interface ExecutiveSource {
+    id: string;
+    /** The publication, in plain words. */
+    title: BiTextValue;
+    /** The page or document itself: an https link. */
+    url: string;
+    /** At most one sentence (for example a page number). */
+    note?: BiTextValue;
+}
 interface ExecutiveData {
-    executive: BiTextValue;
-    organisation: BiTextValue;
-    initiative: BiTextValue;
-    why_now: {
-        figure: ExecutiveFigure;
-        deadline: BiTextValue;
+    title: BiTextValue;
+    key_statement: BiTextValue;
+    headline_figures: ExecutiveFigure[];
+    pain: {
+        key_message: BiTextValue;
+        paragraphs: BiTextValue[];
+        bearers: Array<{
+            who: BiTextValue;
+            cost: BiTextValue;
+            measure: BiTextValue;
+        }>;
+        figures: ExecutiveFigure[];
+        causes: Array<{
+            cause: BiTextValue;
+            weight: number;
+        }>;
+    };
+    context: {
+        key_message: BiTextValue;
+        paragraphs: BiTextValue[];
+        setting: BiTextValue;
+        forces: Array<{
+            force: BiTextValue;
+            direction: Direction;
+        }>;
+        evidence: Array<{
+            statement: BiTextValue;
+            source: string;
+        }>;
+    };
+    situation: {
+        key_message: BiTextValue;
+        roles: Array<{
+            role: BiTextValue;
+            decides: BiTextValue;
+            needs: BiTextValue;
+        }>;
+        interaction: BiTextValue;
+        state_of_the_art: Array<{
+            approach: BiTextValue;
+            achieves: BiTextValue;
+            falls_short: BiTextValue;
+            source: string;
+        }>;
+        status: {
+            heading: BiTextValue;
+            value: BiTextValue;
+            unit: BiTextValue;
+            date: BiTextValue;
+            source: string;
+        };
+    };
+    trends: {
+        key_message: BiTextValue;
+        items: Array<{
+            trend: BiTextValue;
+            kind: TrendKind;
+            direction: Direction;
+            horizon: Horizon;
+            signal: {
+                statement: BiTextValue;
+                source: string;
+            };
+            effect: BiTextValue;
+            confidence: Confidence;
+        }>;
+    };
+    proposal: {
+        key_message: BiTextValue;
+        paragraphs: BiTextValue[];
+        four_cs: Array<{
+            c: BiTextValue;
+            applies: BiTextValue;
+        }>;
+        actions: Array<{
+            action: BiTextValue;
+            owner: BiTextValue;
+            horizon: BiTextValue;
+            check: BiTextValue;
+        }>;
+        risks: BiTextValue[];
+        unknowns: BiTextValue[];
+        handoff?: BiTextValue;
     };
-    vision: BiTextValue;
-    outcomes: ExecutiveOutcome[];
-    four_cs?: Array<{
-        c: BiTextValue;
-        exec_problem: BiTextValue;
-    }>;
-    dialogue: Array<{
-        question: BiTextValue;
-        answer: BiTextValue;
-    }>;
     illustrations: {
-        initiative: ExecutiveIllustration;
-        problem: ExecutiveIllustration;
-        solution: ExecutiveIllustration;
+        pain: ExecutiveIllustration;
+        situation: ExecutiveIllustration;
+        proposal: ExecutiveIllustration;
     };
-    sources: Array<{
-        field: string;
-        source: BiTextValue;
-    }>;
+    sources: ExecutiveSource[];
 }
 interface ExecutiveProblem {
-    /** The field path, for example `outcomes[1].proof.unit` (empty for the document itself). */
+    /** The field path, for example `pain.bearers[1].cost.en` (empty for the document itself). */
     path: string;
     message: string;
 }
 /**
  * Validates a product's `content/executive.json` against `executive.schema.json` and the rules on top of it. Pure; an
- * empty array means valid. `fourCs` is the set of names the 4Cs Positioning section expects (default `FOUR_CS`).
+ * empty array means valid.
  */
-declare function validateExecutive(data: unknown, opts?: {
-    fourCs?: readonly string[];
-}): ExecutiveProblem[];
+declare function validateExecutive(data: unknown): ExecutiveProblem[];
 
 interface QuestionProps {
     /** The business question the executive would ask. */
@@ -1006,4 +1104,4 @@ interface ViewsRowProps {
  */
 declare function ViewsRow({ children, shares }: ViewsRowProps): react.JSX.Element;
 
-export { BREAKPOINTS, BarChart, type BarChartProps, type BarDatum, BiText, Callout, type CaseDef, type CaseGroup, type CaseKind, CaseSelector, type CaseSelectorProps, type CaseSelectorText, CaseWorkbench, type CaseWorkbenchProps, ChipGroup, type ChipGroupProps, type ChipOption, type Citation, CitationsProvider, Cite, DOC_AREAS, DocPage, type DocPageProps, DocReferences, DocRefsScope, DocSection, type DocSectionProps, EXECUTIVE_SCHEMA_VERSION, Equation, type ExecutiveData, type ExecutiveProblem, ExecutiveView, type ExecutiveViewProps, FOUR_CS, Figure, type FittedLabel, FocusShell, type FocusShellProps, FormatOptions, Gauge, type GaugeProps, type GaugeZone, Glossary, type GlossaryEntry, InlineMath, Knob, type KnobProps, type Lane, LaneBadge, Lang, LanguageToggle, MAX_PEER_TABS, MAX_WORKBENCH_GROUPS, PanelBoundary, type PausedVizController, PlotCard, type PlotCardProps, type Provenance, Question, type QuestionProps, type RailSection, Readout, type ReadoutItem, type ReadoutProps, ReferenceList, Refs, Stage, type StageSize, Stat, type StatProps, type SubTabDef, SubTabs, type SubTabsProps, SurfacePage, type SurfacePageProps, type TabDef, type TabGroupDef, TabGroups, type TabGroupsProps, Tabs, type TabsProps, type Theme, ThemeToggle, type Tone, type UsePausedVizOptions, VariantBar, type VariantBarProps, type VariantDef, Verdict, type VerdictProps, ViewsRow, type ViewsRowProps, type VizFrame, type VizLoop, type VizLoopDeps, type VizLoopOptions, type WorkbenchGroup, WorkbenchLayout, type WorkbenchLayoutProps, type WorkbenchRoute, WorkbenchShell, type WorkbenchShellProps, type WorkbenchState, WorkbenchStateContext, applyTheme, caseKind, caseTooltip, casesInSource, createVizLoop, firstAppearance, fitLabel, fontFamily, groupByCategory, isStale, makeStateKey, niceStep, niceTicks, readCaseParam, readTheme, replaceQueryParam, sourcesPresent, textWidth, usePausedViz, useStageSize, useThemeStore, useUrlView, useWorkbenchState, validateExecutive, viewParamOf, widestLabel, withCaseParam };
+export { BREAKPOINTS, BarChart, type BarChartProps, type BarDatum, BiText, Callout, type CaseDef, type CaseGroup, type CaseKind, CaseSelector, type CaseSelectorProps, type CaseSelectorText, CaseWorkbench, type CaseWorkbenchProps, ChipGroup, type ChipGroupProps, type ChipOption, type Citation, CitationsProvider, Cite, DOC_AREAS, DocPage, type DocPageProps, DocReferences, DocRefsScope, DocSection, type DocSectionProps, EXECUTIVE_SCHEMA_VERSION, Equation, type ExecutiveData, type ExecutiveProblem, ExecutiveView, type ExecutiveViewProps, FOUR_CS, Figure, type FittedLabel, FocusShell, type FocusShellProps, FormatOptions, Gauge, type GaugeProps, type GaugeZone, Glossary, type GlossaryEntry, InlineMath, Knob, type KnobProps, Landing, type Lane, LaneBadge, Lang, LanguageToggle, MAX_PEER_TABS, MAX_WORKBENCH_GROUPS, PanelBoundary, type PausedVizController, PlotCard, type PlotCardProps, type Provenance, Question, type QuestionProps, type RailSection, Readout, type ReadoutItem, type ReadoutProps, ReferenceList, Refs, Stage, type StageSize, Stat, type StatProps, type SubTabDef, SubTabs, type SubTabsProps, SurfacePage, type SurfacePageProps, type TabDef, type TabGroupDef, TabGroups, type TabGroupsProps, Tabs, type TabsProps, type Theme, ThemeToggle, type Tone, type UsePausedVizOptions, VariantBar, type VariantBarProps, type VariantDef, Verdict, type VerdictProps, ViewsRow, type ViewsRowProps, type VizFrame, type VizLoop, type VizLoopDeps, type VizLoopOptions, type WorkbenchGroup, WorkbenchLayout, type WorkbenchLayoutProps, type WorkbenchRoute, WorkbenchShell, type WorkbenchShellProps, type WorkbenchState, WorkbenchStateContext, applyTheme, caseKind, caseTooltip, casesInSource, createVizLoop, firstAppearance, fitLabel, fontFamily, groupByCategory, isStale, makeStateKey, niceStep, niceTicks, readCaseParam, readTheme, replaceQueryParam, sourcesPresent, textWidth, usePausedViz, useStageSize, useThemeStore, useUrlView, useWorkbenchState, validateExecutive, viewParamOf, widestLabel, withCaseParam };