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

package/dist/index.d.ts

@@ -401,7 +401,7 @@ declare function ReferenceList({ ids, heading }: {
  * holds each area's rule; `test/docFloors.test.ts` keeps these names equal to that table's.
  */
 declare const DOC_AREAS: {
-    readonly '/introduction': readonly ["initiative", "outcomes", "positioning", "credibility", "problem", "principles", "math", "pipeline", "honesty"];
+    readonly '/introduction': readonly ["problem", "principles", "math", "pipeline", "honesty"];
     readonly '/methodology': readonly ["method"];
     readonly '/implementation': readonly ["architecture", "reproducibility", "engine", "lanes", "contract", "deployment"];
     readonly '/experiments': readonly ["question", "metrics", "protocol", "datasets"];
@@ -467,6 +467,94 @@ interface StatProps {
  */
 declare function Stat({ value, unit, source }: StatProps): react.JSX.Element;
 
+interface ExecutiveViewProps {
+    /** The parsed `content/executive.json` of the product (validated against `executive.schema.json` in the page). */
+    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;
+}
+/**
+ * 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.
+ */
+declare function ExecutiveView({ data, base }: 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.
+ */
+declare const FOUR_CS: readonly string[];
+interface BiTextValue {
+    en: string;
+    es: string;
+}
+interface ExecutiveFigure {
+    value: BiTextValue;
+    unit: BiTextValue;
+}
+interface ExecutiveOutcome {
+    capability: BiTextValue;
+    outcome: BiTextValue;
+    proof: ExecutiveFigure & {
+        statement: BiTextValue;
+    };
+}
+interface ExecutiveIllustration {
+    /** The SVG file (a path under the site root), or one per language. */
+    file: string | BiTextValue;
+    caption: BiTextValue;
+}
+interface ExecutiveData {
+    executive: BiTextValue;
+    organisation: BiTextValue;
+    initiative: BiTextValue;
+    why_now: {
+        figure: ExecutiveFigure;
+        deadline: 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;
+    };
+    sources: Array<{
+        field: string;
+        source: BiTextValue;
+    }>;
+}
+interface ExecutiveProblem {
+    /** The field path, for example `outcomes[1].proof.unit` (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`).
+ */
+declare function validateExecutive(data: unknown, opts?: {
+    fourCs?: readonly string[];
+}): ExecutiveProblem[];
+
 interface QuestionProps {
     /** The business question the executive would ask. */
     question: ReactNode;
@@ -918,4 +1006,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, Equation, 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, 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, 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 };