@liustack/pptwise 0.22.0

package/dist/index.d.ts

@@ -0,0 +1,4224 @@
+import { z } from 'zod';
+export { P as PptwisePlatform, R as RasterizedImage, i as installPlatform } from './registry-C0GJH7ZT.js';
+
+declare const VERSION = "0.22.0";
+
+/** Error class thrown by pptwise's public API surface (validation, rendering, export). */
+declare class PptwiseError extends Error {
+}
+
+declare const STRATEGY_VALUES: readonly ["pyramid", "storytelling", "instructional", "showcase", "briefing"];
+declare const PACING_VALUES: readonly ["dense", "balanced", "spacious"];
+declare const AUDIENCE_VALUES: readonly ["executive", "technical", "customer", "public"];
+declare const BEAT_VALUES: readonly ["anchor", "dense", "breathing"];
+
+/**
+ * The v4 IR schema root: theme/meta/assets/brand/branding/background/slide/narrative
+ * and the top-level `PptxIRSchema` a deck document parses against
+ * (`parsePptxIR`). The frozen v3 shape lives in `./legacy-v3.ts`, kept only
+ * for `migrateIrV3ToV4`'s input parsing (spec §9.3).
+ *
+ * **The `ComponentSchema` union below is a pure aggregator (src domain reorg
+ * wave 2, spec §4.3), same discipline as `src/svg/layouts/registry.ts`'s T1d
+ * precedent.** Every one of the component schemas used to live here as a
+ * literal `z.object({...})` entry directly inside the `discriminatedUnion`
+ * array. Each now lives in its own `src/ir/components/<name>.ts` domain file
+ * instead (schema + field aliases + render-trait declaration together, spec
+ * §4.1) — imported below and referenced by name, in the exact union position
+ * its literal used to occupy, so "take one component away whole" is a
+ * single-file operation instead of an edit split across this file,
+ * `field-aliases.ts`, and `component-traits.ts`. This file's own job for
+ * components is now purely computational: import every component schema, construct
+ * `ComponentSchema` via `z.discriminatedUnion`, and derive `COMPONENT_TYPES`
+ * from the result — never a hand-copied literal, never a re-export relay. A
+ * handful of schema fragments genuinely shared by ≥2 components (only the
+ * icon-name enum, as of this wave) live in `src/ir/components/shared.ts`
+ * instead of any one domain file; every other named sub-schema that reads as
+ * "shared" at a glance (e.g. `GanttItemSchema`, `PestQuadrantSchema`,
+ * `SankeyNodeSchema`/`SankeyLinkSchema`) turned out to be single-consumer and
+ * moved into its own component's domain file with it.
+ *
+ * The rest of this module — everything outside the `// ── Components` section
+ * — is unrelated to the component-domain split and was never in its scope:
+ * background/theme/meta/assets/brand/branding/slide/narrative and the top-level
+ * `PptxIRSchema` are genuinely this file's own content, not aggregated from
+ * elsewhere.
+ */
+
+declare const BUILTIN_THEME_IDS: readonly ["consulting", "enterprise", "academic", "insight", "campaign", "classroom", "ink", "tech", "runway", "journal", "luxe", "heritage", "pulse", "terra", "ember", "vermilion", "crayon", "arena", "museum", "stage", "lecture", "swiss", "memo", "playbill"];
+declare const BackgroundSpecSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"color">;
+    value: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"gradient">;
+    from: z.ZodString;
+    to: z.ZodString;
+    direction: z.ZodOptional<z.ZodEnum<{
+        tb: "tb";
+        lr: "lr";
+        diagonal: "diagonal";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"asset">;
+    asset_id: z.ZodString;
+    overlay: z.ZodOptional<z.ZodObject<{
+        color: z.ZodString;
+        opacity: z.ZodNumber;
+    }, z.core.$strict>>;
+    fit: z.ZodOptional<z.ZodEnum<{
+        contain: "contain";
+        cover: "cover";
+    }>>;
+}, z.core.$strict>], "kind">;
+/**
+ * Style-token override (theme.style): deep-partial palette/fonts/shape
+ * merged over the built-in theme (see themes/index.ts resolveStyle). Scope is
+ * deliberately palette-level (spec §11): no defaultBackgrounds or manifest
+ * overrides. gapScale / typeScale ranges mirror the documented sane ranges
+ * in themes/tokens.ts StyleShape.
+ */
+declare const StyleOverrideSchema: z.ZodObject<{
+    colors: z.ZodOptional<z.ZodObject<{
+        bg: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodString>;
+        panel: z.ZodOptional<z.ZodString>;
+        primary: z.ZodOptional<z.ZodString>;
+        accent: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        muted: z.ZodOptional<z.ZodString>;
+        border: z.ZodOptional<z.ZodString>;
+        chartPalette: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        accentPool: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        cardStroke: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    fonts: z.ZodOptional<z.ZodObject<{
+        heading: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        body: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        mono: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    shape: z.ZodOptional<z.ZodObject<{
+        radius: z.ZodOptional<z.ZodNumber>;
+        gapScale: z.ZodOptional<z.ZodNumber>;
+        typeScale: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type StyleOverride = z.infer<typeof StyleOverrideSchema>;
+/**
+ * Brand (logical slide-master) config: branding behavior owned by a theme.
+ * W1 scope was exactly the two flags migrated from the old theme-manifest footer flags;
+ * the ink v3 redesign (2026-08-18) added a third, orthogonal one.
+ * Single source of truth — the TS type is inferred, never hand-written.
+ *
+ * All three are independent switches, not a ladder: a theme may set any
+ * combination, and each names exactly one piece of brand footer. They are
+ * deliberately not collapsed into one "footer style" enum — a theme that
+ * draws its own divider is a different situation from one whose motif
+ * already carries the org/date, and merging them would force one to imply
+ * the other.
+ */
+declare const BrandConfigSchema: z.ZodObject<{
+    suppressFooterOnCardContent: z.ZodOptional<z.ZodBoolean>;
+    suppressFooterRule: z.ZodOptional<z.ZodBoolean>;
+    suppressFooterMeta: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type BrandConfig = z.infer<typeof BrandConfigSchema>;
+declare const ThemeSchema: z.ZodObject<{
+    id: z.ZodDefault<z.ZodString>;
+    style: z.ZodOptional<z.ZodObject<{
+        colors: z.ZodOptional<z.ZodObject<{
+            bg: z.ZodOptional<z.ZodString>;
+            surface: z.ZodOptional<z.ZodString>;
+            panel: z.ZodOptional<z.ZodString>;
+            primary: z.ZodOptional<z.ZodString>;
+            accent: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            muted: z.ZodOptional<z.ZodString>;
+            border: z.ZodOptional<z.ZodString>;
+            chartPalette: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            accentPool: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            cardStroke: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        fonts: z.ZodOptional<z.ZodObject<{
+            heading: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            body: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            mono: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        shape: z.ZodOptional<z.ZodObject<{
+            radius: z.ZodOptional<z.ZodNumber>;
+            gapScale: z.ZodOptional<z.ZodNumber>;
+            typeScale: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    brand: z.ZodOptional<z.ZodObject<{
+        suppressFooterOnCardContent: z.ZodOptional<z.ZodBoolean>;
+        suppressFooterRule: z.ZodOptional<z.ZodBoolean>;
+        suppressFooterMeta: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const MetaSchema: z.ZodObject<{
+    organization: z.ZodOptional<z.ZodString>;
+    authors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        org: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    date: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    confidentiality: z.ZodOptional<z.ZodEnum<{
+        public: "public";
+        internal: "internal";
+        confidential: "confidential";
+        restricted: "restricted";
+    }>>;
+    contact: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        website: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    copyright: z.ZodOptional<z.ZodString>;
+    animation: z.ZodOptional<z.ZodObject<{
+        transition: z.ZodOptional<z.ZodEnum<{
+            push: "push";
+            none: "none";
+            fade: "fade";
+            wipe: "wipe";
+        }>>;
+        elements: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            auto: "auto";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const AssetsSchema: z.ZodObject<{
+    images: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+declare const ComponentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"bullets">;
+    items: z.ZodArray<z.ZodString>;
+    style: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        checklist: "checklist";
+        numbered: "numbered";
+        plain: "plain";
+        divided: "divided";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"paragraph">;
+    text: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"quote">;
+    text: z.ZodString;
+    attribution: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"callout">;
+    variant: z.ZodEnum<{
+        info: "info";
+        warn: "warn";
+        tip: "tip";
+    }>;
+    text: z.ZodString;
+    icon: z.ZodOptional<z.ZodEnum<{
+        [x: string]: string;
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"code">;
+    language: z.ZodString;
+    code: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"kpi_cards">;
+    items: z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        unit: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        delta: z.ZodOptional<z.ZodEnum<{
+            flat: "flat";
+            up: "up";
+            down: "down";
+        }>>;
+        icon: z.ZodOptional<z.ZodEnum<{
+            [x: string]: string;
+        }>>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"chart">;
+    chart_type: z.ZodEnum<{
+        line: "line";
+        donut: "donut";
+        dumbbell: "dumbbell";
+        funnel: "funnel";
+        gauge: "gauge";
+        bar: "bar";
+        pie: "pie";
+        scatter: "scatter";
+        area: "area";
+    }>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        horizontal: "horizontal";
+        vertical: "vertical";
+    }>>;
+    style: z.ZodOptional<z.ZodEnum<{
+        donut: "donut";
+    }>>;
+    center_total: z.ZodOptional<z.ZodBoolean>;
+    gauge: z.ZodOptional<z.ZodObject<{
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    axes: z.ZodOptional<z.ZodObject<{
+        x_title: z.ZodOptional<z.ZodString>;
+        y_title: z.ZodOptional<z.ZodString>;
+        show_grid: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    series: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        data: z.ZodArray<z.ZodObject<{
+            x: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+            y: z.ZodNumber;
+            size: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"flowchart">;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        kind: z.ZodOptional<z.ZodEnum<{
+            rect: "rect";
+            diamond: "diamond";
+            round: "round";
+        }>>;
+    }, z.core.$strict>>;
+    edges: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        TB: "TB";
+        TD: "TD";
+        BT: "BT";
+        LR: "LR";
+        RL: "RL";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"architecture">;
+    layers: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        items: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    direction: z.ZodOptional<z.ZodEnum<{
+        top_down: "top_down";
+        bottom_up: "bottom_up";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"timeline">;
+    layout: z.ZodOptional<z.ZodEnum<{
+        horizontal: "horizontal";
+        vertical: "vertical";
+    }>>;
+    milestones: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        title: z.ZodString;
+        desc: z.ZodOptional<z.ZodString>;
+        highlight: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"comparison">;
+    columns: z.ZodArray<z.ZodString>;
+    rows: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        cells: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"icon_cards">;
+    items: z.ZodArray<z.ZodObject<{
+        icon: z.ZodEnum<{
+            [x: string]: string;
+        }>;
+        title: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"row_cards">;
+    items: z.ZodArray<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodEnum<{
+            [x: string]: string;
+        }>>;
+        title: z.ZodString;
+        text: z.ZodOptional<z.ZodString>;
+        sub: z.ZodOptional<z.ZodString>;
+        highlight: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"steps">;
+    items: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"rings">;
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        desc: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"numbered_cards">;
+    items: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        text: z.ZodOptional<z.ZodString>;
+        sub: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"roadmap">;
+    items: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        period: z.ZodOptional<z.ZodString>;
+        rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"matrix">;
+    x_title: z.ZodOptional<z.ZodString>;
+    y_title: z.ZodOptional<z.ZodString>;
+    cols: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        tag: z.ZodOptional<z.ZodString>;
+        tone: z.ZodOptional<z.ZodEnum<{
+            info: "info";
+            neutral: "neutral";
+            accent: "accent";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"insight_panel">;
+    title: z.ZodString;
+    rows: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strict>>;
+    footnote: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"verdict_banner">;
+    text: z.ZodString;
+    tone: z.ZodEnum<{
+        positive: "positive";
+        warning: "warning";
+        neutral: "neutral";
+    }>;
+    icon: z.ZodOptional<z.ZodEnum<{
+        [x: string]: string;
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"citation">;
+    sources: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    asset_id: z.ZodString;
+    caption: z.ZodOptional<z.ZodString>;
+    fit: z.ZodDefault<z.ZodEnum<{
+        contain: "contain";
+        cover: "cover";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"image_grid">;
+    items: z.ZodArray<z.ZodObject<{
+        asset_id: z.ZodString;
+        caption: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    emphasis: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        first: "first";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"image_compare">;
+    left: z.ZodObject<{
+        asset_id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strict>;
+    right: z.ZodObject<{
+        asset_id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strict>;
+    style: z.ZodOptional<z.ZodEnum<{
+        vs: "vs";
+        before_after: "before_after";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"swot">;
+    strengths: z.ZodArray<z.ZodString>;
+    weaknesses: z.ZodArray<z.ZodString>;
+    opportunities: z.ZodArray<z.ZodString>;
+    threats: z.ZodArray<z.ZodString>;
+    labels: z.ZodOptional<z.ZodObject<{
+        strengths: z.ZodOptional<z.ZodString>;
+        weaknesses: z.ZodOptional<z.ZodString>;
+        opportunities: z.ZodOptional<z.ZodString>;
+        threats: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"bmc">;
+    key_partners: z.ZodArray<z.ZodString>;
+    key_activities: z.ZodArray<z.ZodString>;
+    key_resources: z.ZodArray<z.ZodString>;
+    value_propositions: z.ZodArray<z.ZodString>;
+    customer_relationships: z.ZodArray<z.ZodString>;
+    channels: z.ZodArray<z.ZodString>;
+    customer_segments: z.ZodArray<z.ZodString>;
+    cost_structure: z.ZodArray<z.ZodString>;
+    revenue_streams: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"waterfall">;
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodNumber;
+        kind: z.ZodOptional<z.ZodEnum<{
+            delta: "delta";
+            total: "total";
+        }>>;
+    }, z.core.$strict>>;
+    unit: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"gantt">;
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strict>>;
+    axis_labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"pest">;
+    political: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    economic: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    social: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    technological: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"five_forces">;
+    rivalry: z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
+        intensity: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        items: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    new_entrants: z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
+        intensity: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        items: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    supplier_power: z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
+        intensity: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        items: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    buyer_power: z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
+        intensity: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        items: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    substitutes: z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
+        intensity: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        items: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"heatmap">;
+    x_labels: z.ZodArray<z.ZodString>;
+    y_labels: z.ZodArray<z.ZodString>;
+    values: z.ZodArray<z.ZodArray<z.ZodNumber>>;
+    domain: z.ZodOptional<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+    }, z.core.$strict>>;
+    show_values: z.ZodOptional<z.ZodBoolean>;
+    x_title: z.ZodOptional<z.ZodString>;
+    y_title: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"sankey">;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strict>>;
+    links: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        value: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"data_table">;
+    columns: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        align: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            right: "right";
+            center: "center";
+        }>>;
+    }, z.core.$strict>>;
+    rows: z.ZodArray<z.ZodObject<{
+        cells: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        emphasis: z.ZodOptional<z.ZodEnum<{
+            highlight: "highlight";
+            total: "total";
+        }>>;
+    }, z.core.$strict>>;
+    source: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"device_mockup">;
+    device: z.ZodEnum<{
+        phone: "phone";
+        browser: "browser";
+    }>;
+    asset_id: z.ZodString;
+    caption: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"cycle">;
+    title: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"people_cards">;
+    title: z.ZodOptional<z.ZodString>;
+    people: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        org: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"tag_row">;
+    title: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodString>;
+    emphasis: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        first: "first";
+    }>>;
+}, z.core.$strict>], "type">;
+/**
+ * All component `type` discriminant values, derived from `ComponentSchema`
+ * itself (never hand-copied) so this list can't drift from the union above.
+ * Typed as plain `readonly string[]` rather than `Component["type"][]` —
+ * every consumer of this list (W5's plan `focus` vocabulary gate,
+ * `src/spec/index.ts`) tests membership of an arbitrary author-supplied
+ * string, and TS's `Array.includes` is invariant in its element type, so a
+ * narrower literal-union type would reject that call at the caller.
+ */
+declare const COMPONENT_TYPES: readonly string[];
+declare const SlideSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<{
+        content: "content";
+        cover: "cover";
+        chapter: "chapter";
+        ending: "ending";
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodLiteral<true>>;
+    layout: z.ZodOptional<z.ZodString>;
+    beat: z.ZodOptional<z.ZodEnum<{
+        dense: "dense";
+        anchor: "anchor";
+        breathing: "breathing";
+    }>>;
+    arrangement: z.ZodOptional<z.ZodEnum<{
+        code: "code";
+        quote: "quote";
+        single: "single";
+        two_column: "two_column";
+        kpi_focus: "kpi_focus";
+        image_focus: "image_focus";
+        big_number: "big_number";
+        assertion_evidence: "assertion_evidence";
+        aside: "aside";
+    }>>;
+    heading: z.ZodOptional<z.ZodString>;
+    subheading: z.ZodOptional<z.ZodString>;
+    components: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"bullets">;
+        items: z.ZodArray<z.ZodString>;
+        style: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            checklist: "checklist";
+            numbered: "numbered";
+            plain: "plain";
+            divided: "divided";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"paragraph">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"quote">;
+        text: z.ZodString;
+        attribution: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"callout">;
+        variant: z.ZodEnum<{
+            info: "info";
+            warn: "warn";
+            tip: "tip";
+        }>;
+        text: z.ZodString;
+        icon: z.ZodOptional<z.ZodEnum<{
+            [x: string]: string;
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"code">;
+        language: z.ZodString;
+        code: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"kpi_cards">;
+        items: z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            unit: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            delta: z.ZodOptional<z.ZodEnum<{
+                flat: "flat";
+                up: "up";
+                down: "down";
+            }>>;
+            icon: z.ZodOptional<z.ZodEnum<{
+                [x: string]: string;
+            }>>;
+            source: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"chart">;
+        chart_type: z.ZodEnum<{
+            line: "line";
+            donut: "donut";
+            dumbbell: "dumbbell";
+            funnel: "funnel";
+            gauge: "gauge";
+            bar: "bar";
+            pie: "pie";
+            scatter: "scatter";
+            area: "area";
+        }>;
+        direction: z.ZodOptional<z.ZodEnum<{
+            horizontal: "horizontal";
+            vertical: "vertical";
+        }>>;
+        style: z.ZodOptional<z.ZodEnum<{
+            donut: "donut";
+        }>>;
+        center_total: z.ZodOptional<z.ZodBoolean>;
+        gauge: z.ZodOptional<z.ZodObject<{
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        axes: z.ZodOptional<z.ZodObject<{
+            x_title: z.ZodOptional<z.ZodString>;
+            y_title: z.ZodOptional<z.ZodString>;
+            show_grid: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        series: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            data: z.ZodArray<z.ZodObject<{
+                x: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+                y: z.ZodNumber;
+                size: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"flowchart">;
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodOptional<z.ZodEnum<{
+                rect: "rect";
+                diamond: "diamond";
+                round: "round";
+            }>>;
+        }, z.core.$strict>>;
+        edges: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        direction: z.ZodOptional<z.ZodEnum<{
+            TB: "TB";
+            TD: "TD";
+            BT: "BT";
+            LR: "LR";
+            RL: "RL";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"architecture">;
+        layers: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            items: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        direction: z.ZodOptional<z.ZodEnum<{
+            top_down: "top_down";
+            bottom_up: "bottom_up";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"timeline">;
+        layout: z.ZodOptional<z.ZodEnum<{
+            horizontal: "horizontal";
+            vertical: "vertical";
+        }>>;
+        milestones: z.ZodArray<z.ZodObject<{
+            date: z.ZodString;
+            title: z.ZodString;
+            desc: z.ZodOptional<z.ZodString>;
+            highlight: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"comparison">;
+        columns: z.ZodArray<z.ZodString>;
+        rows: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            cells: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"icon_cards">;
+        items: z.ZodArray<z.ZodObject<{
+            icon: z.ZodEnum<{
+                [x: string]: string;
+            }>;
+            title: z.ZodString;
+            text: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"row_cards">;
+        items: z.ZodArray<z.ZodObject<{
+            icon: z.ZodOptional<z.ZodEnum<{
+                [x: string]: string;
+            }>>;
+            title: z.ZodString;
+            text: z.ZodOptional<z.ZodString>;
+            sub: z.ZodOptional<z.ZodString>;
+            highlight: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"steps">;
+        items: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            text: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"rings">;
+        items: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            desc: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"numbered_cards">;
+        items: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            text: z.ZodOptional<z.ZodString>;
+            sub: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"roadmap">;
+        items: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            period: z.ZodOptional<z.ZodString>;
+            rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"matrix">;
+        x_title: z.ZodOptional<z.ZodString>;
+        y_title: z.ZodOptional<z.ZodString>;
+        cols: z.ZodNumber;
+        items: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            tag: z.ZodOptional<z.ZodString>;
+            tone: z.ZodOptional<z.ZodEnum<{
+                info: "info";
+                neutral: "neutral";
+                accent: "accent";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"insight_panel">;
+        title: z.ZodString;
+        rows: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            text: z.ZodString;
+        }, z.core.$strict>>;
+        footnote: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"verdict_banner">;
+        text: z.ZodString;
+        tone: z.ZodEnum<{
+            positive: "positive";
+            warning: "warning";
+            neutral: "neutral";
+        }>;
+        icon: z.ZodOptional<z.ZodEnum<{
+            [x: string]: string;
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"citation">;
+        sources: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+            ref: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        asset_id: z.ZodString;
+        caption: z.ZodOptional<z.ZodString>;
+        fit: z.ZodDefault<z.ZodEnum<{
+            contain: "contain";
+            cover: "cover";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image_grid">;
+        items: z.ZodArray<z.ZodObject<{
+            asset_id: z.ZodString;
+            caption: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        emphasis: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            first: "first";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"image_compare">;
+        left: z.ZodObject<{
+            asset_id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>;
+        right: z.ZodObject<{
+            asset_id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>;
+        style: z.ZodOptional<z.ZodEnum<{
+            vs: "vs";
+            before_after: "before_after";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"swot">;
+        strengths: z.ZodArray<z.ZodString>;
+        weaknesses: z.ZodArray<z.ZodString>;
+        opportunities: z.ZodArray<z.ZodString>;
+        threats: z.ZodArray<z.ZodString>;
+        labels: z.ZodOptional<z.ZodObject<{
+            strengths: z.ZodOptional<z.ZodString>;
+            weaknesses: z.ZodOptional<z.ZodString>;
+            opportunities: z.ZodOptional<z.ZodString>;
+            threats: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"bmc">;
+        key_partners: z.ZodArray<z.ZodString>;
+        key_activities: z.ZodArray<z.ZodString>;
+        key_resources: z.ZodArray<z.ZodString>;
+        value_propositions: z.ZodArray<z.ZodString>;
+        customer_relationships: z.ZodArray<z.ZodString>;
+        channels: z.ZodArray<z.ZodString>;
+        customer_segments: z.ZodArray<z.ZodString>;
+        cost_structure: z.ZodArray<z.ZodString>;
+        revenue_streams: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"waterfall">;
+        items: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodNumber;
+            kind: z.ZodOptional<z.ZodEnum<{
+                delta: "delta";
+                total: "total";
+            }>>;
+        }, z.core.$strict>>;
+        unit: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"gantt">;
+        items: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strict>>;
+        axis_labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"pest">;
+        political: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        economic: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        social: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        technological: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"five_forces">;
+        rivalry: z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            intensity: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>>;
+            items: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        new_entrants: z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            intensity: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>>;
+            items: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        supplier_power: z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            intensity: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>>;
+            items: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        buyer_power: z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            intensity: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>>;
+            items: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        substitutes: z.ZodObject<{
+            label: z.ZodOptional<z.ZodString>;
+            intensity: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>>;
+            items: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"heatmap">;
+        x_labels: z.ZodArray<z.ZodString>;
+        y_labels: z.ZodArray<z.ZodString>;
+        values: z.ZodArray<z.ZodArray<z.ZodNumber>>;
+        domain: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, z.core.$strict>>;
+        show_values: z.ZodOptional<z.ZodBoolean>;
+        x_title: z.ZodOptional<z.ZodString>;
+        y_title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"sankey">;
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>;
+        links: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            value: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"data_table">;
+        columns: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            align: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                right: "right";
+                center: "center";
+            }>>;
+        }, z.core.$strict>>;
+        rows: z.ZodArray<z.ZodObject<{
+            cells: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            emphasis: z.ZodOptional<z.ZodEnum<{
+                highlight: "highlight";
+                total: "total";
+            }>>;
+        }, z.core.$strict>>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"device_mockup">;
+        device: z.ZodEnum<{
+            phone: "phone";
+            browser: "browser";
+        }>;
+        asset_id: z.ZodString;
+        caption: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"cycle">;
+        title: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"people_cards">;
+        title: z.ZodOptional<z.ZodString>;
+        people: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            org: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"tag_row">;
+        title: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodString>;
+        emphasis: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            first: "first";
+        }>>;
+    }, z.core.$strict>], "type">>>;
+    background: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"color">;
+        value: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"gradient">;
+        from: z.ZodString;
+        to: z.ZodString;
+        direction: z.ZodOptional<z.ZodEnum<{
+            tb: "tb";
+            lr: "lr";
+            diagonal: "diagonal";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"asset">;
+        asset_id: z.ZodString;
+        overlay: z.ZodOptional<z.ZodObject<{
+            color: z.ZodString;
+            opacity: z.ZodNumber;
+        }, z.core.$strict>>;
+        fit: z.ZodOptional<z.ZodEnum<{
+            contain: "contain";
+            cover: "cover";
+        }>>;
+    }, z.core.$strict>], "kind">>;
+    decor: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            big_number: "big_number";
+            corner_tag: "corner_tag";
+            rule_line: "rule_line";
+            quote_marks: "quote_marks";
+            geo_dots: "geo_dots";
+        }>;
+        intensity: z.ZodOptional<z.ZodEnum<{
+            subtle: "subtle";
+            normal: "normal";
+        }>>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    image_side: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        right: "right";
+    }>>;
+    footnote: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const PptxIRSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodLiteral<"4">>;
+    filename: z.ZodDefault<z.ZodString>;
+    narrative: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    theme: z.ZodDefault<z.ZodObject<{
+        id: z.ZodDefault<z.ZodString>;
+        style: z.ZodOptional<z.ZodObject<{
+            colors: z.ZodOptional<z.ZodObject<{
+                bg: z.ZodOptional<z.ZodString>;
+                surface: z.ZodOptional<z.ZodString>;
+                panel: z.ZodOptional<z.ZodString>;
+                primary: z.ZodOptional<z.ZodString>;
+                accent: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                muted: z.ZodOptional<z.ZodString>;
+                border: z.ZodOptional<z.ZodString>;
+                chartPalette: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                accentPool: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                cardStroke: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            fonts: z.ZodOptional<z.ZodObject<{
+                heading: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                body: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                mono: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+            shape: z.ZodOptional<z.ZodObject<{
+                radius: z.ZodOptional<z.ZodNumber>;
+                gapScale: z.ZodOptional<z.ZodNumber>;
+                typeScale: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        brand: z.ZodOptional<z.ZodObject<{
+            suppressFooterOnCardContent: z.ZodOptional<z.ZodBoolean>;
+            suppressFooterRule: z.ZodOptional<z.ZodBoolean>;
+            suppressFooterMeta: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    meta: z.ZodDefault<z.ZodObject<{
+        organization: z.ZodOptional<z.ZodString>;
+        authors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            org: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        date: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        confidentiality: z.ZodOptional<z.ZodEnum<{
+            public: "public";
+            internal: "internal";
+            confidential: "confidential";
+            restricted: "restricted";
+        }>>;
+        contact: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            phone: z.ZodOptional<z.ZodString>;
+            website: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        copyright: z.ZodOptional<z.ZodString>;
+        animation: z.ZodOptional<z.ZodObject<{
+            transition: z.ZodOptional<z.ZodEnum<{
+                push: "push";
+                none: "none";
+                fade: "fade";
+                wipe: "wipe";
+            }>>;
+            elements: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                auto: "auto";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    assets: z.ZodDefault<z.ZodObject<{
+        images: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            src: z.ZodString;
+            alt: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    brand: z.ZodOptional<z.ZodObject<{
+        logo_asset_id: z.ZodOptional<z.ZodString>;
+        position: z.ZodOptional<z.ZodEnum<{
+            tl: "tl";
+            tr: "tr";
+            bl: "bl";
+            br: "br";
+        }>>;
+    }, z.core.$strict>>;
+    branding: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        "cover-only": "cover-only";
+        minimal: "minimal";
+    }>>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    slides: z.ZodArray<z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<{
+            content: "content";
+            cover: "cover";
+            chapter: "chapter";
+            ending: "ending";
+        }>>;
+        id: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodLiteral<true>>;
+        layout: z.ZodOptional<z.ZodString>;
+        beat: z.ZodOptional<z.ZodEnum<{
+            dense: "dense";
+            anchor: "anchor";
+            breathing: "breathing";
+        }>>;
+        arrangement: z.ZodOptional<z.ZodEnum<{
+            code: "code";
+            quote: "quote";
+            single: "single";
+            two_column: "two_column";
+            kpi_focus: "kpi_focus";
+            image_focus: "image_focus";
+            big_number: "big_number";
+            assertion_evidence: "assertion_evidence";
+            aside: "aside";
+        }>>;
+        heading: z.ZodOptional<z.ZodString>;
+        subheading: z.ZodOptional<z.ZodString>;
+        components: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"bullets">;
+            items: z.ZodArray<z.ZodString>;
+            style: z.ZodOptional<z.ZodEnum<{
+                default: "default";
+                checklist: "checklist";
+                numbered: "numbered";
+                plain: "plain";
+                divided: "divided";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"paragraph">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"quote">;
+            text: z.ZodString;
+            attribution: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"callout">;
+            variant: z.ZodEnum<{
+                info: "info";
+                warn: "warn";
+                tip: "tip";
+            }>;
+            text: z.ZodString;
+            icon: z.ZodOptional<z.ZodEnum<{
+                [x: string]: string;
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"code">;
+            language: z.ZodString;
+            code: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"kpi_cards">;
+            items: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                unit: z.ZodOptional<z.ZodString>;
+                label: z.ZodString;
+                delta: z.ZodOptional<z.ZodEnum<{
+                    flat: "flat";
+                    up: "up";
+                    down: "down";
+                }>>;
+                icon: z.ZodOptional<z.ZodEnum<{
+                    [x: string]: string;
+                }>>;
+                source: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"chart">;
+            chart_type: z.ZodEnum<{
+                line: "line";
+                donut: "donut";
+                dumbbell: "dumbbell";
+                funnel: "funnel";
+                gauge: "gauge";
+                bar: "bar";
+                pie: "pie";
+                scatter: "scatter";
+                area: "area";
+            }>;
+            direction: z.ZodOptional<z.ZodEnum<{
+                horizontal: "horizontal";
+                vertical: "vertical";
+            }>>;
+            style: z.ZodOptional<z.ZodEnum<{
+                donut: "donut";
+            }>>;
+            center_total: z.ZodOptional<z.ZodBoolean>;
+            gauge: z.ZodOptional<z.ZodObject<{
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+            axes: z.ZodOptional<z.ZodObject<{
+                x_title: z.ZodOptional<z.ZodString>;
+                y_title: z.ZodOptional<z.ZodString>;
+                show_grid: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            series: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                data: z.ZodArray<z.ZodObject<{
+                    x: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+                    y: z.ZodNumber;
+                    size: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"flowchart">;
+            nodes: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                kind: z.ZodOptional<z.ZodEnum<{
+                    rect: "rect";
+                    diamond: "diamond";
+                    round: "round";
+                }>>;
+            }, z.core.$strict>>;
+            edges: z.ZodArray<z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            direction: z.ZodOptional<z.ZodEnum<{
+                TB: "TB";
+                TD: "TD";
+                BT: "BT";
+                LR: "LR";
+                RL: "RL";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"architecture">;
+            layers: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>;
+            direction: z.ZodOptional<z.ZodEnum<{
+                top_down: "top_down";
+                bottom_up: "bottom_up";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"timeline">;
+            layout: z.ZodOptional<z.ZodEnum<{
+                horizontal: "horizontal";
+                vertical: "vertical";
+            }>>;
+            milestones: z.ZodArray<z.ZodObject<{
+                date: z.ZodString;
+                title: z.ZodString;
+                desc: z.ZodOptional<z.ZodString>;
+                highlight: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"comparison">;
+            columns: z.ZodArray<z.ZodString>;
+            rows: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                cells: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"icon_cards">;
+            items: z.ZodArray<z.ZodObject<{
+                icon: z.ZodEnum<{
+                    [x: string]: string;
+                }>;
+                title: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"row_cards">;
+            items: z.ZodArray<z.ZodObject<{
+                icon: z.ZodOptional<z.ZodEnum<{
+                    [x: string]: string;
+                }>>;
+                title: z.ZodString;
+                text: z.ZodOptional<z.ZodString>;
+                sub: z.ZodOptional<z.ZodString>;
+                highlight: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"steps">;
+            items: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"rings">;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                desc: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"numbered_cards">;
+            items: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                text: z.ZodOptional<z.ZodString>;
+                sub: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"roadmap">;
+            items: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                period: z.ZodOptional<z.ZodString>;
+                rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    value: z.ZodString;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"matrix">;
+            x_title: z.ZodOptional<z.ZodString>;
+            y_title: z.ZodOptional<z.ZodString>;
+            cols: z.ZodNumber;
+            items: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                tag: z.ZodOptional<z.ZodString>;
+                tone: z.ZodOptional<z.ZodEnum<{
+                    info: "info";
+                    neutral: "neutral";
+                    accent: "accent";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"insight_panel">;
+            title: z.ZodString;
+            rows: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+            footnote: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"verdict_banner">;
+            text: z.ZodString;
+            tone: z.ZodEnum<{
+                positive: "positive";
+                warning: "warning";
+                neutral: "neutral";
+            }>;
+            icon: z.ZodOptional<z.ZodEnum<{
+                [x: string]: string;
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"citation">;
+            sources: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+                ref: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            asset_id: z.ZodString;
+            caption: z.ZodOptional<z.ZodString>;
+            fit: z.ZodDefault<z.ZodEnum<{
+                contain: "contain";
+                cover: "cover";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image_grid">;
+            items: z.ZodArray<z.ZodObject<{
+                asset_id: z.ZodString;
+                caption: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            emphasis: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                first: "first";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image_compare">;
+            left: z.ZodObject<{
+                asset_id: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>;
+            right: z.ZodObject<{
+                asset_id: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>;
+            style: z.ZodOptional<z.ZodEnum<{
+                vs: "vs";
+                before_after: "before_after";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"swot">;
+            strengths: z.ZodArray<z.ZodString>;
+            weaknesses: z.ZodArray<z.ZodString>;
+            opportunities: z.ZodArray<z.ZodString>;
+            threats: z.ZodArray<z.ZodString>;
+            labels: z.ZodOptional<z.ZodObject<{
+                strengths: z.ZodOptional<z.ZodString>;
+                weaknesses: z.ZodOptional<z.ZodString>;
+                opportunities: z.ZodOptional<z.ZodString>;
+                threats: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"bmc">;
+            key_partners: z.ZodArray<z.ZodString>;
+            key_activities: z.ZodArray<z.ZodString>;
+            key_resources: z.ZodArray<z.ZodString>;
+            value_propositions: z.ZodArray<z.ZodString>;
+            customer_relationships: z.ZodArray<z.ZodString>;
+            channels: z.ZodArray<z.ZodString>;
+            customer_segments: z.ZodArray<z.ZodString>;
+            cost_structure: z.ZodArray<z.ZodString>;
+            revenue_streams: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"waterfall">;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodNumber;
+                kind: z.ZodOptional<z.ZodEnum<{
+                    delta: "delta";
+                    total: "total";
+                }>>;
+            }, z.core.$strict>>;
+            unit: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"gantt">;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strict>>;
+            axis_labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"pest">;
+            political: z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            economic: z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            social: z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            technological: z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"five_forces">;
+            rivalry: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                }>>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            new_entrants: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                }>>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            supplier_power: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                }>>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            buyer_power: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                }>>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            substitutes: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                }>>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"heatmap">;
+            x_labels: z.ZodArray<z.ZodString>;
+            y_labels: z.ZodArray<z.ZodString>;
+            values: z.ZodArray<z.ZodArray<z.ZodNumber>>;
+            domain: z.ZodOptional<z.ZodObject<{
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+            }, z.core.$strict>>;
+            show_values: z.ZodOptional<z.ZodBoolean>;
+            x_title: z.ZodOptional<z.ZodString>;
+            y_title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"sankey">;
+            nodes: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>>;
+            links: z.ZodArray<z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+                value: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"data_table">;
+            columns: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                align: z.ZodOptional<z.ZodEnum<{
+                    left: "left";
+                    right: "right";
+                    center: "center";
+                }>>;
+            }, z.core.$strict>>;
+            rows: z.ZodArray<z.ZodObject<{
+                cells: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                emphasis: z.ZodOptional<z.ZodEnum<{
+                    highlight: "highlight";
+                    total: "total";
+                }>>;
+            }, z.core.$strict>>;
+            source: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"device_mockup">;
+            device: z.ZodEnum<{
+                phone: "phone";
+                browser: "browser";
+            }>;
+            asset_id: z.ZodString;
+            caption: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"cycle">;
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"people_cards">;
+            title: z.ZodOptional<z.ZodString>;
+            people: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                role: z.ZodOptional<z.ZodString>;
+                org: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"tag_row">;
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodString>;
+            emphasis: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                first: "first";
+            }>>;
+        }, z.core.$strict>], "type">>>;
+        background: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"color">;
+            value: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"gradient">;
+            from: z.ZodString;
+            to: z.ZodString;
+            direction: z.ZodOptional<z.ZodEnum<{
+                tb: "tb";
+                lr: "lr";
+                diagonal: "diagonal";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"asset">;
+            asset_id: z.ZodString;
+            overlay: z.ZodOptional<z.ZodObject<{
+                color: z.ZodString;
+                opacity: z.ZodNumber;
+            }, z.core.$strict>>;
+            fit: z.ZodOptional<z.ZodEnum<{
+                contain: "contain";
+                cover: "cover";
+            }>>;
+        }, z.core.$strict>], "kind">>;
+        decor: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                big_number: "big_number";
+                corner_tag: "corner_tag";
+                rule_line: "rule_line";
+                quote_marks: "quote_marks";
+                geo_dots: "geo_dots";
+            }>;
+            intensity: z.ZodOptional<z.ZodEnum<{
+                subtle: "subtle";
+                normal: "normal";
+            }>>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        image_side: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            right: "right";
+        }>>;
+        footnote: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type PptxIR = z.infer<typeof PptxIRSchema>;
+type Component = z.infer<typeof ComponentSchema>;
+type BackgroundSpec = z.infer<typeof BackgroundSpecSchema>;
+type Slide = z.infer<typeof SlideSchema>;
+type Assets = z.infer<typeof AssetsSchema>;
+type Meta = z.infer<typeof MetaSchema>;
+
+interface ValidationIssue {
+    path: string;
+    message: string;
+    /** 1-based slide number when the issue is scoped to a slide. */
+    page?: number;
+    /**
+     * The offending slide's own `id` (`Slide.id`, `ir/index.ts`) — W5
+     * whole-branch review finding 2: the README already claimed "validation
+     * error messages reference [a slide] by [its] id"; this is what makes
+     * that true. Set by every page-scoped issue producer
+     * ({@link checkLayoutApplicability}, {@link checkBoundaryPageContent},
+     * the content-quality-gate translation in {@link validateIr},
+     * {@link checkDuplicateSlideIds}, {@link checkUnofferedSparsePins})
+     * when the slide in question has an `id` — absent when the slide has
+     * none (bare, pre-W5 IR) or the issue is deck-level, not scoped to any
+     * single slide. {@link formatIssues} appends it in parens after the page
+     * number.
+     */
+    slideId?: string;
+}
+interface ValidateResult {
+    ok: boolean;
+    ir?: PptxIR;
+    errors: ValidationIssue[];
+    /**
+     * Human-readable "`path`: `alias` → `canonical`" entries for every
+     * deterministic field-alias rewrite `validateIr` applied before parsing
+     * (W5 task 4, `ir/field-aliases.ts`'s `normalizeComponentAliases`) — e.g. a
+     * kpi item's `title` silently adopted as `label`. Present only when at
+     * least one rewrite happened; informational, never gates `ok` on its own.
+     */
+    normalized?: string[];
+    /**
+     * Backward-compatible addition (borrow wave, Task 2 — dual-threshold
+     * severity recalibration): warn-severity {@link checkIrQuality} findings
+     * (editorial-budget codes — `missing_heading`/`long_heading`/`density`/
+     * `bullets_overflow`/`bullet_item_long`/`big_number_no_kpi`) plus
+     * {@link checkAssetReferences}'s dangling-`asset_id` findings (borrow wave,
+     * Task 2, B5 — a reference to an `assets.images` key that doesn't exist),
+     * formatted the same shape {@link formatIssues} already prints for `errors`
+     * (page/id/path all included). Present only when at least one warn-severity
+     * finding exists, and never gates `ok` on its own — that is exactly what
+     * moved these findings off `errors` and onto here. Can be present alongside
+     * a failing (`ok:false`) result too, whenever `checkIrQuality`/
+     * `checkAssetReferences` themselves ran (an *earlier* hard gate — schema,
+     * theme id, layout applicability, full-body exclusivity, boundary-page
+     * content, duplicate ids, asset bytes, narrative — short-circuits before
+     * either runs at all, so a deck rejected by one of those never reaches
+     * this field either way, see `validateIr`'s own body for the exact gate
+     * order). {@link formatWarnings} renders this array as CLI-ready
+     * `"warning: ..."` lines.
+     */
+    warnings?: ValidationIssue[];
+}
+/**
+ * Validate raw JSON against the IR schema, then — once it parses — resolve
+ * `narrative` (`resolveNarrative`, spec §5: an unrecognized preset name is a
+ * `narrative`-path error, page-less) and run the content-quality gate
+ * (`checkIrQuality`, passed the resolved axes) against the parsed IR. Every
+ * hard-gate stage (schema, theme id, layout applicability, full-body
+ * exclusivity, boundary-page content, duplicate ids, asset bytes, narrative)
+ * must pass for `ok: true`, same as before. Quality findings are reported
+ * the same way as schema errors (page-scoped, 1-based).
+ *
+ * Dual-threshold severity (borrow wave, Task 2 — recalibrated from the prior
+ * "any finding blocks" design): `checkIrQuality`'s own "warn" vs "error" tag
+ * is now respected, not flattened. Only "error"-severity findings
+ * (`empty_deck`, `bullet_item_overflow` — content genuinely lost: an empty
+ * deck, or a bullet item long enough to hit `bullets.tsx`'s MIN_FONT floor
+ * and actually get truncated) gate `ok`. "warn"-severity findings — the
+ * editorial-budget codes (`missing_heading`/`long_heading`/`density`/
+ * `bullets_overflow`/`bullet_item_long`/`big_number_no_kpi`) — surface on
+ * {@link ValidateResult.warnings} instead: visible to every caller (the SDK,
+ * the CLI's `validate`/`render` pre-flight), never blocking. This reverses
+ * the prior posture (this comment used to read "any finding blocks... not
+ * only 'error'-severity ones") because the evidence behind it did not hold:
+ * a boundary scan (borrow-wave fact-report, Q3) found the editorial bullets
+ * threshold blocking content roughly 3.5x below where `bullets.tsx`'s own
+ * render safety net (2-line wrap, shrink to a 14px floor) actually starts
+ * losing characters — so the hard gate was rejecting deck content that
+ * would have rendered with zero visible defect, and a tight hard gate on an
+ * editorial (not geometric) threshold taught truncate-content-to-pass
+ * workarounds rather than catching real loss. `generatePptx`'s default path
+ * inherits this unchanged (`if (!v.ok) throw`) — it already only ever
+ * blocked on `ok`, never inspected `errors`/`warnings` directly.
+ *
+ * Before any of that, two deterministic pre-parse rewrite passes run, each
+ * threading its rewrite notes onto `ValidateResult.normalized` on *every*
+ * return path below via `withNormalized`, success or failure alike — neither
+ * ever gates `ok` on its own:
+ *  - {@link normalizeComponentAliases} (W5 task 4): the component
+ *    field-name synonym rescue (kpi `title`→`label`, quote `content`→`text`,
+ *    …), scoped to `slides[]`. Only rewrites where the canonical key is
+ *    absent, so the schema parse below never sees an alias as an
+ *    "unrecognized key" in the first place.
+ *  - {@link normalizeNarrativeShape} (`./narrative`, T0b bench-evidence fix
+ *    2 — see its own doc comment for the full rationale): the root-level
+ *    `narrative: {id: <preset>}` shape rescue. A model that just wrote
+ *    `theme: {id: "consulting"}` a few lines above pattern-matches the same
+ *    wrapper shape onto `narrative`; this rewrites it to the bare preset
+ *    string `resolveNarrative`'s string branch actually expects. Fires only
+ *    when `id` is the object's sole narrative-relevant key (none of
+ *    strategy/pacing/audience alongside it) — a mixed shape stays
+ *    unrescued, ambiguous, and hard-errors exactly as it did before this
+ *    pass existed.
+ *
+ * Both are the same class of fix — a weak-model *synonym* rescue (a name
+ * drift for the component-alias pass, a *shape* drift for the narrative
+ * pass) — which is the actual boundary the next paragraph's "no
+ * old-vocabulary rescue" draws, not "no rewrite ever touches `narrative`."
+ *
+ * There is still deliberately no *old-vocabulary* rescue (spec §16,
+ * reversing the now-superseded §15.4): a v4 document that still spells its
+ * pre-rename vocabulary — `scenario` instead of `narrative`, `mode`/
+ * `delivery` instead of `strategy`/`pacing`, or the old enum values
+ * `"text"`/`"presentation"`/`"narrative"` — is not old-vocabulary
+ * *compatibility*, it is exactly the vocabulary this rename retired, so it
+ * hard-errors like any other unknown key or value: `scenario` fails the
+ * schema's `.strict()` parse below as an unrecognized key, and an old enum
+ * value (or the axis-key names `mode`/`delivery` inside `narrative`, which
+ * the schema itself leaves open) fails `resolveNarrative`'s own runtime
+ * check, listing the current values. `{id: <preset>}` was never a v3
+ * `scenario` shape, so `normalizeNarrativeShape` above does not reopen this
+ * door — it rescues a shape weak models invent by analogy to `theme.id`, not
+ * a shape the pre-rename vocabulary ever spoke. `pptwise migrate`
+ * (`ir/migrate.ts`) remains the sanctioned bridge for a genuine v3 document —
+ * see the v3 hard reject below, which points there. Hard-erroring is not the
+ * same as leaving the error message unhelpful, though: the schema-parse
+ * branch below appends a rename hint to `scenario` and the rest of the
+ * documented v2/v3 rename map (`blocks`/`variant`/`theme.override` —
+ * `./ir/rename-hints.ts`, borrow-wave task 3) whenever the offending key
+ * matches one, and a generic "belongs inside components[]" hint for any
+ * other slide-level unrecognized key — message-layer annotation only, never
+ * a second, silent rewrite path alongside the two passes above.
+ *
+ * Both pre-parse passes only ever run for a document already headed for the
+ * v4 schema — an explicit `version: "2"` or `version: "3"` is hard-rejected
+ * first, below, before either pass or any schema parse (spec §9.3: a v2/v3
+ * document is never silently reinterpreted as v4).
+ */
+declare function validateIr(input: unknown): ValidateResult;
+/**
+ * `"page 2 (p-kpi) — path: message"` when the issue carries both a `page`
+ * and a `slideId` (W5 whole-branch review finding 2 — the README's own
+ * claim that a validation error "references [a slide] by [its] id", made
+ * true) — the parenthesized id is appended only alongside a `page` number,
+ * never on its own: a deck-level issue that happens to set a representative
+ * `slideId` with no `page` ({@link checkDuplicateSlideIds} above) keeps its
+ * pre-existing, unchanged format. Every other combination — `page` with no
+ * `slideId` (an id-less slide), or neither — is byte-identical to before
+ * this task.
+ */
+declare function formatIssues(errors: ValidationIssue[]): string;
+interface ThemeInfo {
+    id: string;
+    label: string;
+    colors: Record<string, unknown>;
+}
+/** Built-in theme catalog with labels and style color tokens. */
+declare function listThemes(): ThemeInfo[];
+/** JSON Schema for the IR — feed this to a model before it writes IR. */
+declare function irJsonSchema(): Record<string, unknown>;
+/** JSON Schema for style-token overrides (IR theme.style, --style files, config "style"). */
+declare function styleJsonSchema(): Record<string, unknown>;
+
+/**
+ * Public API surface: validateIr's own logic lives in `./validate-core`
+ * (P2 browser-distribution wave, task 1 — see that file's own doc comment
+ * for why) and is re-exported below unchanged, so every existing consumer
+ * of this module keeps working exactly as before. `renderSlideSvg` and
+ * `generatePptx` stay defined here — this is the one file allowed to reach
+ * into `./svg/render-slide` and `./pptx/generate` (react-dom/server, jszip,
+ * pptxgenjs).
+ */
+
+/** Render a single slide to standalone SVG markup (preview / self-check). */
+declare function renderSlideSvg(ir: PptxIR, slideIndex: number): string;
+/**
+ * Full pipeline: validate → SVG → DrawingML → animation patches → pptx bytes.
+ *
+ * Two export gates, both "refuse to hand over a deliverable the caller
+ * cannot see is broken, unless they say they know": `draft` skips the
+ * unfilled-placeholder gate above, `allowDroppedContent` skips the
+ * content-drop gate (`checkContentDropGate` in `./pptx/generate` — it lives
+ * there because only a real layout can answer it, and the export renders
+ * every slide there already).
+ */
+declare function generatePptx(input: unknown, opts?: {
+    draft?: boolean;
+    allowDroppedContent?: boolean;
+}): Promise<Uint8Array>;
+
+/**
+ * The frozen IR v3 top-level shape (vocabulary-v4 rename, task 1 — spec
+ * §9.3: "v3 已冻结... 顶层字段和枚举改名必须进入新的 IR 版本，不能在 v3
+ * 内静默改变含义"). `./index.ts`'s `PptxIRSchema` is v4 now — this module
+ * exists only so a genuinely v3-shaped document still has somewhere to parse
+ * against: `migrateIrV3ToV4`'s input type (`./migrate.ts`), and the
+ * v3-hard-reject path's own tests (constructing a *valid* v3 IR to prove the
+ * reject fires on version alone, not on some other schema defect).
+ *
+ * `validateIr` (`src/api.ts`) never calls this schema itself — an incoming
+ * v3 document (`version === "3"`) is hard-rejected before any schema parse
+ * runs at all (spec §9.3), full stop. This schema is a migration-tooling and
+ * test fixture, not a second accepted input shape.
+ *
+ * Every field but `version` and `scenario` is byte-identical to `./index.ts`'s
+ * v4 `PptxIRSchema` (spec §9.1: "其余 IR 字段保持不变") — reuses the exact
+ * same `ThemeSchema`/`MetaSchema`/`AssetsSchema`/`BrandSchema`/`SlideSchema`
+ * instances rather than redefining them, so there is no way for this frozen
+ * shape to silently drift from the fields it shares with v4.
+ */
+declare const PptxIRV3Schema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodLiteral<"3">>;
+    filename: z.ZodDefault<z.ZodString>;
+    scenario: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    theme: z.ZodDefault<z.ZodObject<{
+        id: z.ZodDefault<z.ZodString>;
+        style: z.ZodOptional<z.ZodObject<{
+            colors: z.ZodOptional<z.ZodObject<{
+                bg: z.ZodOptional<z.ZodString>;
+                surface: z.ZodOptional<z.ZodString>;
+                panel: z.ZodOptional<z.ZodString>;
+                primary: z.ZodOptional<z.ZodString>;
+                accent: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+                muted: z.ZodOptional<z.ZodString>;
+                border: z.ZodOptional<z.ZodString>;
+                chartPalette: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                accentPool: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                cardStroke: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            fonts: z.ZodOptional<z.ZodObject<{
+                heading: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                body: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                mono: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+            shape: z.ZodOptional<z.ZodObject<{
+                radius: z.ZodOptional<z.ZodNumber>;
+                gapScale: z.ZodOptional<z.ZodNumber>;
+                typeScale: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        brand: z.ZodOptional<z.ZodObject<{
+            suppressFooterOnCardContent: z.ZodOptional<z.ZodBoolean>;
+            suppressFooterRule: z.ZodOptional<z.ZodBoolean>;
+            suppressFooterMeta: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    meta: z.ZodDefault<z.ZodObject<{
+        organization: z.ZodOptional<z.ZodString>;
+        authors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            org: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        date: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        confidentiality: z.ZodOptional<z.ZodEnum<{
+            public: "public";
+            internal: "internal";
+            confidential: "confidential";
+            restricted: "restricted";
+        }>>;
+        contact: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            phone: z.ZodOptional<z.ZodString>;
+            website: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        copyright: z.ZodOptional<z.ZodString>;
+        animation: z.ZodOptional<z.ZodObject<{
+            transition: z.ZodOptional<z.ZodEnum<{
+                push: "push";
+                none: "none";
+                fade: "fade";
+                wipe: "wipe";
+            }>>;
+            elements: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                auto: "auto";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    assets: z.ZodDefault<z.ZodObject<{
+        images: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            src: z.ZodString;
+            alt: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    brand: z.ZodOptional<z.ZodObject<{
+        logo_asset_id: z.ZodOptional<z.ZodString>;
+        position: z.ZodOptional<z.ZodEnum<{
+            tl: "tl";
+            tr: "tr";
+            bl: "bl";
+            br: "br";
+        }>>;
+    }, z.core.$strict>>;
+    chrome: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        "cover-only": "cover-only";
+        minimal: "minimal";
+    }>>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    slides: z.ZodArray<z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<{
+            content: "content";
+            cover: "cover";
+            chapter: "chapter";
+            ending: "ending";
+        }>>;
+        id: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodLiteral<true>>;
+        layout: z.ZodOptional<z.ZodString>;
+        beat: z.ZodOptional<z.ZodEnum<{
+            dense: "dense";
+            anchor: "anchor";
+            breathing: "breathing";
+        }>>;
+        arrangement: z.ZodOptional<z.ZodEnum<{
+            code: "code";
+            quote: "quote";
+            single: "single";
+            two_column: "two_column";
+            kpi_focus: "kpi_focus";
+            image_focus: "image_focus";
+            big_number: "big_number";
+            assertion_evidence: "assertion_evidence";
+            aside: "aside";
+        }>>;
+        heading: z.ZodOptional<z.ZodString>;
+        subheading: z.ZodOptional<z.ZodString>;
+        components: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"bullets">;
+            items: z.ZodArray<z.ZodString>;
+            style: z.ZodOptional<z.ZodEnum<{
+                default: "default";
+                checklist: "checklist";
+                numbered: "numbered";
+                plain: "plain";
+                divided: "divided";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"paragraph">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"quote">;
+            text: z.ZodString;
+            attribution: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"callout">;
+            variant: z.ZodEnum<{
+                info: "info";
+                warn: "warn";
+                tip: "tip";
+            }>;
+            text: z.ZodString;
+            icon: z.ZodOptional<z.ZodEnum<{
+                [x: string]: string;
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"code">;
+            language: z.ZodString;
+            code: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"kpi_cards">;
+            items: z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                unit: z.ZodOptional<z.ZodString>;
+                label: z.ZodString;
+                delta: z.ZodOptional<z.ZodEnum<{
+                    flat: "flat";
+                    up: "up";
+                    down: "down";
+                }>>;
+                icon: z.ZodOptional<z.ZodEnum<{
+                    [x: string]: string;
+                }>>;
+                source: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"chart">;
+            chart_type: z.ZodEnum<{
+                line: "line";
+                donut: "donut";
+                dumbbell: "dumbbell";
+                funnel: "funnel";
+                gauge: "gauge";
+                bar: "bar";
+                pie: "pie";
+                scatter: "scatter";
+                area: "area";
+            }>;
+            direction: z.ZodOptional<z.ZodEnum<{
+                horizontal: "horizontal";
+                vertical: "vertical";
+            }>>;
+            style: z.ZodOptional<z.ZodEnum<{
+                donut: "donut";
+            }>>;
+            center_total: z.ZodOptional<z.ZodBoolean>;
+            gauge: z.ZodOptional<z.ZodObject<{
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+            axes: z.ZodOptional<z.ZodObject<{
+                x_title: z.ZodOptional<z.ZodString>;
+                y_title: z.ZodOptional<z.ZodString>;
+                show_grid: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            series: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                data: z.ZodArray<z.ZodObject<{
+                    x: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+                    y: z.ZodNumber;
+                    size: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"flowchart">;
+            nodes: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                kind: z.ZodOptional<z.ZodEnum<{
+                    rect: "rect";
+                    diamond: "diamond";
+                    round: "round";
+                }>>;
+            }, z.core.$strict>>;
+            edges: z.ZodArray<z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            direction: z.ZodOptional<z.ZodEnum<{
+                TB: "TB";
+                TD: "TD";
+                BT: "BT";
+                LR: "LR";
+                RL: "RL";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"architecture">;
+            layers: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>;
+            direction: z.ZodOptional<z.ZodEnum<{
+                top_down: "top_down";
+                bottom_up: "bottom_up";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"timeline">;
+            layout: z.ZodOptional<z.ZodEnum<{
+                horizontal: "horizontal";
+                vertical: "vertical";
+            }>>;
+            milestones: z.ZodArray<z.ZodObject<{
+                date: z.ZodString;
+                title: z.ZodString;
+                desc: z.ZodOptional<z.ZodString>;
+                highlight: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"comparison">;
+            columns: z.ZodArray<z.ZodString>;
+            rows: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                cells: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"icon_cards">;
+            items: z.ZodArray<z.ZodObject<{
+                icon: z.ZodEnum<{
+                    [x: string]: string;
+                }>;
+                title: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"row_cards">;
+            items: z.ZodArray<z.ZodObject<{
+                icon: z.ZodOptional<z.ZodEnum<{
+                    [x: string]: string;
+                }>>;
+                title: z.ZodString;
+                text: z.ZodOptional<z.ZodString>;
+                sub: z.ZodOptional<z.ZodString>;
+                highlight: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"steps">;
+            items: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"rings">;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                desc: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"numbered_cards">;
+            items: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                text: z.ZodOptional<z.ZodString>;
+                sub: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"roadmap">;
+            items: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                period: z.ZodOptional<z.ZodString>;
+                rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    value: z.ZodString;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"matrix">;
+            x_title: z.ZodOptional<z.ZodString>;
+            y_title: z.ZodOptional<z.ZodString>;
+            cols: z.ZodNumber;
+            items: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                tag: z.ZodOptional<z.ZodString>;
+                tone: z.ZodOptional<z.ZodEnum<{
+                    info: "info";
+                    neutral: "neutral";
+                    accent: "accent";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"insight_panel">;
+            title: z.ZodString;
+            rows: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+            footnote: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"verdict_banner">;
+            text: z.ZodString;
+            tone: z.ZodEnum<{
+                positive: "positive";
+                warning: "warning";
+                neutral: "neutral";
+            }>;
+            icon: z.ZodOptional<z.ZodEnum<{
+                [x: string]: string;
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"citation">;
+            sources: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+                ref: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            asset_id: z.ZodString;
+            caption: z.ZodOptional<z.ZodString>;
+            fit: z.ZodDefault<z.ZodEnum<{
+                contain: "contain";
+                cover: "cover";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image_grid">;
+            items: z.ZodArray<z.ZodObject<{
+                asset_id: z.ZodString;
+                caption: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            emphasis: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                first: "first";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image_compare">;
+            left: z.ZodObject<{
+                asset_id: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>;
+            right: z.ZodObject<{
+                asset_id: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>;
+            style: z.ZodOptional<z.ZodEnum<{
+                vs: "vs";
+                before_after: "before_after";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"swot">;
+            strengths: z.ZodArray<z.ZodString>;
+            weaknesses: z.ZodArray<z.ZodString>;
+            opportunities: z.ZodArray<z.ZodString>;
+            threats: z.ZodArray<z.ZodString>;
+            labels: z.ZodOptional<z.ZodObject<{
+                strengths: z.ZodOptional<z.ZodString>;
+                weaknesses: z.ZodOptional<z.ZodString>;
+                opportunities: z.ZodOptional<z.ZodString>;
+                threats: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"bmc">;
+            key_partners: z.ZodArray<z.ZodString>;
+            key_activities: z.ZodArray<z.ZodString>;
+            key_resources: z.ZodArray<z.ZodString>;
+            value_propositions: z.ZodArray<z.ZodString>;
+            customer_relationships: z.ZodArray<z.ZodString>;
+            channels: z.ZodArray<z.ZodString>;
+            customer_segments: z.ZodArray<z.ZodString>;
+            cost_structure: z.ZodArray<z.ZodString>;
+            revenue_streams: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"waterfall">;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodNumber;
+                kind: z.ZodOptional<z.ZodEnum<{
+                    delta: "delta";
+                    total: "total";
+                }>>;
+            }, z.core.$strict>>;
+            unit: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"gantt">;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strict>>;
+            axis_labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"pest">;
+            political: z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            economic: z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            social: z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            technological: z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"five_forces">;
+            rivalry: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                }>>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            new_entrants: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                }>>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            supplier_power: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                }>>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            buyer_power: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                }>>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            substitutes: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                intensity: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    medium: "medium";
+                    high: "high";
+                }>>;
+                items: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"heatmap">;
+            x_labels: z.ZodArray<z.ZodString>;
+            y_labels: z.ZodArray<z.ZodString>;
+            values: z.ZodArray<z.ZodArray<z.ZodNumber>>;
+            domain: z.ZodOptional<z.ZodObject<{
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+            }, z.core.$strict>>;
+            show_values: z.ZodOptional<z.ZodBoolean>;
+            x_title: z.ZodOptional<z.ZodString>;
+            y_title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"sankey">;
+            nodes: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>>;
+            links: z.ZodArray<z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+                value: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"data_table">;
+            columns: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                align: z.ZodOptional<z.ZodEnum<{
+                    left: "left";
+                    right: "right";
+                    center: "center";
+                }>>;
+            }, z.core.$strict>>;
+            rows: z.ZodArray<z.ZodObject<{
+                cells: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+                emphasis: z.ZodOptional<z.ZodEnum<{
+                    highlight: "highlight";
+                    total: "total";
+                }>>;
+            }, z.core.$strict>>;
+            source: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"device_mockup">;
+            device: z.ZodEnum<{
+                phone: "phone";
+                browser: "browser";
+            }>;
+            asset_id: z.ZodString;
+            caption: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"cycle">;
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"people_cards">;
+            title: z.ZodOptional<z.ZodString>;
+            people: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                role: z.ZodOptional<z.ZodString>;
+                org: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"tag_row">;
+            title: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodString>;
+            emphasis: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                first: "first";
+            }>>;
+        }, z.core.$strict>], "type">>>;
+        background: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"color">;
+            value: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"gradient">;
+            from: z.ZodString;
+            to: z.ZodString;
+            direction: z.ZodOptional<z.ZodEnum<{
+                tb: "tb";
+                lr: "lr";
+                diagonal: "diagonal";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"asset">;
+            asset_id: z.ZodString;
+            overlay: z.ZodOptional<z.ZodObject<{
+                color: z.ZodString;
+                opacity: z.ZodNumber;
+            }, z.core.$strict>>;
+            fit: z.ZodOptional<z.ZodEnum<{
+                contain: "contain";
+                cover: "cover";
+            }>>;
+        }, z.core.$strict>], "kind">>;
+        decor: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                big_number: "big_number";
+                corner_tag: "corner_tag";
+                rule_line: "rule_line";
+                quote_marks: "quote_marks";
+                geo_dots: "geo_dots";
+            }>;
+            intensity: z.ZodOptional<z.ZodEnum<{
+                subtle: "subtle";
+                normal: "normal";
+            }>>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        image_side: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            right: "right";
+        }>>;
+        footnote: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type PptxIRV3 = z.infer<typeof PptxIRV3Schema>;
+
+/**
+ * Deterministic, pure IR v3 → v4 migration (spec §9.1). Field-for-field,
+ * value-for-value per the mapping in {@link migrateNarrativeInput}'s
+ * docstring — every field this function doesn't touch (`filename`, `theme`,
+ * `meta`, `assets`, `brand`, `seed`, `slides`) carries across by the exact
+ * same reference it came in with, unchanged (spec §9.1: "其余 IR 字段保持不
+ * 变"; spec §10: no weight/budget/selection/render change is in scope for
+ * this migration, ever).
+ *
+ * Exported from the SDK surface (`src/index.ts`) as the deterministic
+ * migration primitive the `pptwise migrate` CLI command (task 2) wraps —
+ * this function itself does no I/O and never runs a model, per spec §9.3's
+ * "只做已声明的结构映射，不运行模型，不重写内容，不重新选择 layout".
+ *
+ * Takes an already-parsed `PptxIRV3` (i.e. `PptxIRV3Schema.parse(...)`'s
+ * output, defaults already applied) rather than raw `unknown` JSON — schema
+ * validation of the v3 input is the caller's job (the CLI parses-then-
+ * migrates; `validateIr`'s own v3 path hard-rejects before ever reaching
+ * this function, spec §9.3, so `validateIr` itself never calls this).
+ */
+declare function migrateIrV3ToV4(v3: PptxIRV3): PptxIR;
+
+type LayoutType = "cover" | "chapter" | "content" | "ending";
+interface StyleColors {
+    bg: string;
+    surface: string;
+    panel?: string;
+    primary: string;
+    accent: string;
+    text: string;
+    muted: string;
+    border?: string;
+    chartPalette: string[];
+    /**
+     * Optional accent color pool for themes whose layout grammar cycles through
+     * multiple accent colors (e.g. tech card corner stripes). Themes that
+     * only use a single accent color can omit this.
+     */
+    accentPool?: string[];
+    /**
+     * Optional hairline stroke color for the shared "surface card" shells
+     * (kpi_cards / icon_cards / callout — see components/kpi.tsx,
+     * components/icon-cards.tsx, components/callout.tsx). Those component renderers are
+     * shared across every theme and must stay theme-agnostic (no
+     * `if (themeId === ...)` branching), so a theme that wants its cards
+     * outlined sets this token instead — the renderers just consult it and add
+     * a 1px stroke when it's defined. Omitted (`undefined`, the default) draws
+     * no stroke, so every theme that doesn't set it keeps its current
+     * fill-only card unchanged.
+     */
+    cardStroke?: string;
+    /**
+     * Optional semantic-role colors — the "this is an error", "this is a
+     * caution", "this is a good result" trio that shared component renderers
+     * used to bake in as literal hexes (`callout`'s warn rule and icon in
+     * components/callout.tsx, `kpi_cards`' delta arrow in components/kpi.tsx).
+     * Same reasoning as `cardStroke` above: those renderers are shared across
+     * every theme and must stay theme-agnostic (no `if (themeId === ...)`
+     * branching), so a theme that wants its own red or green sets these tokens
+     * and the renderers read them through `resolveSemanticColor`
+     * (`src/svg/ink.ts`), which owns the fallback order.
+     *
+     * All three are optional on the type, and an omitted role resolves to
+     * exactly the hex its renderers baked in before this channel existed —
+     * `#DC2626` for `danger`, `#16A34A` for `success`, and `warning` follows
+     * whatever `danger` resolves to. So a theme that sets none of them renders
+     * byte-for-byte as it did before the tokens were added.
+     *
+     * Every one of the 22 built-in themes does set all three (visual review
+     * round 4 ruled that the alert color must belong to the theme's own
+     * palette, not be one universal red), so in practice only a `--theme-file`
+     * brand theme reaches the fallbacks. `danger` and `success` are calibrated
+     * to clear 4.5:1 on their own theme's `surface` — they render as the kpi
+     * delta arrow's *text*, which `accessibleInk` would otherwise demote to
+     * neutral ink — while `warning` only has to clear the 3:1 non-text floor,
+     * since `callout` paints it as a rule and an icon. Both floors are pinned
+     * in `svg/audit/full-matrix-contrast.test.ts`.
+     */
+    danger?: string;
+    warning?: string;
+    success?: string;
+}
+interface StyleFonts {
+    heading: string[];
+    body: string[];
+    mono?: string[];
+}
+interface StyleTokens {
+    id: string;
+    allowCustomBackground?: boolean;
+    colors: StyleColors;
+    fonts: StyleFonts;
+    shape?: StyleShape;
+    defaultBackgrounds: Record<LayoutType, BackgroundSpec>;
+}
+/**
+ * 主题细节 shape token（2026-07-10 用户立项，spec：
+ * .issues/specs/2026-07-10-pptx-theme-detail-tokens-design.md）。
+ * 全部可选——缺省时各消费点沿用自己的 baked 值（零观感）。
+ */
+interface StyleShape {
+    /** 卡片/横幅圆角 px（统一值）。缺省=各消费点原 baked 值（kpi 8/architecture 6/白卡 14 等）。 */
+    radius?: number;
+    /** 块间距缩放（1=现 BLOCK_GAP）。建议范围 [0.8, 1.3]。 */
+    gapScale?: number;
+    /**
+     * Heading and display size multiplier. Applied to the layout's designed
+     * max size *before* heading-fit shrinks to the box (`fitHeadingLines` /
+     * `fitHeadingPt`, `src/svg/heading-fit.ts`). Cover, chapter, ending, and
+     * pin-only speech pages pass it through. Content layouts that share the
+     * page with a body stack omit it, so density still holds. Body, meta,
+     * kicker, and footnote sizes are untouched. Omit (or `1`) for a
+     * byte-identical no-op. Fit still owns the floor: `minPt` is not scaled,
+     * so a long title still shrinks instead of overflowing. Suggested range
+     * `[0.8, 1.6]`.
+     */
+    typeScale?: number;
+    /**
+     * Optional cover-layout knobs. Layouts read these. They never branch on
+     * theme id. Omit every field and the layout uses its own file constants
+     * (`band-title`: y=260, h=200, start, no mark, no wave.
+     * `corner-wedge`: peakY=340, startX=980, middle, meta on paper.
+     * `poster-center`: no kicker, primary bar, centered meta.
+     * `left-anchor`: corner triangle on, title vertically centered.
+     * `constellation`: last line on y520, 84×4 bar.
+     * `tone-adaptive-header`: title 92, right-bottom date shown.
+     * `editorial-masthead`: middle anchor, no kicker).
+     * Not part of `StyleOverrideSchema`. IR overrides stay
+     * `{ radius, gapScale, typeScale }`.
+     */
+    cover?: {
+        textAnchor?: "start" | "middle";
+        bandY?: number;
+        bandH?: number;
+        /** Small accent square on the band (enterprise). */
+        bandMark?: boolean;
+        /** Accent q-curve under the band (classroom). */
+        bandWave?: boolean;
+        wedgePeakY?: number;
+        wedgeStartX?: number;
+        /** Meta in readableOn(primary) inside the wedge (ember). */
+        metaInWedge?: boolean;
+        /** Independent kicker row above the title. Default false. poster-center + editorial-masthead. */
+        showKicker?: boolean;
+        /** Short bar fill. Default "primary". poster-center. */
+        barFill?: "primary" | "accent";
+        /** Merged meta placement. Default "center". poster-center. */
+        metaPlacement?: "center" | "bottom-left" | "bottom-right" | "top" | "none";
+        /** Corner triangle on the color block. Default true. left-anchor. */
+        showCornerTriangle?: boolean;
+        /** Title vertical alignment inside the block. Default "center". left-anchor. */
+        titleBlockAlign?: "center" | "upper";
+        /** Org as in-block kicker. Default false. left-anchor. */
+        showInBlockKicker?: boolean;
+        /** Pin last title line to y520. Default true. constellation. */
+        titleBottomAnchor?: boolean;
+        /** Rule under the title. Default "bar". constellation. */
+        ruleStyle?: "bar" | "star-chain";
+        /** Cover title size in px. Default 92. tone-adaptive-header. */
+        titleSize?: number;
+        /** Hide the right-bottom date/version slot. Default false. tone-adaptive-header. */
+        hideRightMeta?: boolean;
+        /** verdict-index. Omit for the restore-wave-1 constants. */
+        verdictTitleY?: number;
+        verdictTitleSize?: number;
+        verdictKickerY?: number;
+        verdictColNumY?: number;
+        verdictColBodyY?: number;
+        verdictFootY?: number;
+        verdictFootRule?: boolean;
+        /** corner-wedge inner overlay (ember dual wedge). Omit for the single overlay. */
+        wedgeInnerStartX?: number;
+        wedgeInnerPeakY?: number;
+    };
+}
+
+type MotifId = "banner-motif" | "rail-motif" | "poster-motif" | "constellation-motif" | "corner-ornament-motif" | "tone-adaptive-motif" | "campaign-motif" | "classroom-motif" | "ink-motif" | "luxe-motif" | "enterprise-motif" | "heritage-motif" | "pulse-motif" | "terra-motif" | "ember-motif" | "vermilion-motif" | "crayon-motif" | "arena-motif" | "lecture-motif" | "swiss-motif" | "memo-motif" | "playbill-motif";
+
+/**
+ * A theme = distributable bundle: `style` (style tokens) + `brand` (brand
+ * frame) + affinity tags (filled in W4).
+ *
+ * `id` is a plain `string`, not `CanonicalThemeId` — the 13 builtins satisfy
+ * this (`CanonicalThemeId` is a subtype of `string`), but `registerTheme`
+ * below (W3 task 4's SDK registration seam) must also accept ids outside that
+ * closed union.
+ */
+interface ThemeDefinition {
+    id: string;
+    style: StyleTokens;
+    brand: BrandConfig;
+    tags: readonly string[];
+    /**
+     * 主题的「选择权」配置（spec §3 theme.layouts 命名裁决；W2 任务 2 由
+     * src/themes/manifest.ts〔已删除〕的旧选择权类型原地迁居于此）——四页型
+     * 各自允许哪些 layout 参与自动选型。排印/色彩在 style，这里只放集合。
+     * **W4 全集放开**（spec §3「缺省 = 全集，策展收窄塑造个性」，design
+     * decision 7）：十三内置主题四页型默认均为 {@link fullLayoutSet} 的
+     * 全集。design decision 7/8 曾经的六处对比度策展排除（luxe/campaign/
+     * classroom 的 content 排除 banner-heading、tech 的 cover/content、
+     * consulting 的 chapter）已在 W4 fix round 随对比度自适应 ink helper
+     * （`src/svg/ink.ts`）的根因修复全部撤销。fix round 自身新发现的两处
+     * （classroom/heritage 的 chapter 排除 fashion-chapter）也已在
+     * post-v0.3 W8 fix round 随 `readableOn` 两墨实测对比度取优的根因修复一并
+     * 撤销（backlog item 2）——十三主题四页型现在均为不折不扣的全集，无任何
+     * 排除残留。页型空集 = 该页型回落调用侧兜底（十三主题四页型均非空，
+     * `definitions.test.ts` 锁死）。id 是通用 string（不再按页型区分
+     * layout id 联合类型）。
+     */
+    layouts: Record<Slide["type"], readonly string[]>;
+    /** Motif：单值，非 allowed-set（spec §3 示意）。undefined = 该主题无 motif 装饰（十三主题中 runway 留空，其余均已设）。 */
+    motif?: MotifId;
+    /**
+     * A theme's own structural personality (theme-structure wave, task T1 —
+     * `.issues/2026-07-26-theme-structure/plan.md`'s 控制器设计裁定 2): per
+     * page type, the layout ids this theme's author wants `resolveLayoutId`
+     * (`src/svg/layout-selection.ts`) to lean toward. Shape mirrors
+     * `StrategyDefinition.layoutTendencies` (`@/narrative`) — the same "named
+     * ids get a soft weight bump, everyone else stays at the floor" contract —
+     * but declared **per slide type** rather than content-only: a strategy's
+     * `layoutTendencies` is content-only, so on cover/chapter/ending a theme
+     * competes only with `StrategyDefinition.identityTendencies` (which
+     * `tendencyIdsFor` does consult for those three types — an earlier draft
+     * of this comment wrongly claimed no strategy signal reached them at all).
+     * **Consequence worth knowing when declaring:** because `weightOf`
+     * composes via `Math.max`, a theme tendency naming an id the active
+     * strategy's `identityTendencies` already names adds no differential pull
+     * for that id under that strategy (max(3,3) = 3) — a theme's structural
+     * character therefore reads most clearly on ids the strategies do not
+     * already favor. Content can carry both a strategy tendency
+     * and a theme tendency at once; `weightOf` composes every live layer via
+     * `Math.max`, never multiplication (same ruling `BEAT_TENDENCY_WEIGHT`'s
+     * doc comment already argues for: agreement between layers corroborates
+     * the same preference dimension, it does not square the pull).
+     *
+     * **Soft weight, not a whitelist — `layouts` above stays the one hard
+     * boundary.** A slide type's candidate pool is built from `layouts[slideType]`
+     * *before* any tendency is ever consulted (`resolveLayoutId`'s own
+     * `pool` construction), so an id this record names for a page type it is
+     * not also present in that same page type's `layouts` set can never be
+     * scored — it is invisible to `weightOf`, not merely down-weighted. That
+     * silent no-op is exactly why it counts as a theme-author mistake rather
+     * than a legal (if unusual) declaration — `definitions.test.ts`'s
+     * consistency sweep over the 13 builtins, and `registerTheme`'s own
+     * validation below for any future custom theme, both fail loudly the
+     * moment a `layoutTendencies` entry names an id outside its own page
+     * type's `layouts` set, so the mistake surfaces at registration/test time
+     * instead of silently doing nothing at render time.
+     *
+     * Optional at every level (the whole field, and independently each of its
+     * four page-type entries) — **omission is not a lesser default, it is
+     * today's exact behavior**: a page type this record doesn't cover (key
+     * absent, or the field itself `undefined`) contributes a uniform weight of
+     * 1 to every candidate, the same "no theme-layer opinion" no-op floor
+     * `beatTendencies === undefined` already gives beat. None of the 13
+     * builtins declare this field yet (theme-structure wave task T1 is the
+     * mechanism only — task T2 is where individual builtins pick up a
+     * personality), so every one of them renders byte-identically to before
+     * this field existed.
+     */
+    layoutTendencies?: Partial<Record<Slide["type"], readonly string[]>>;
+    /**
+     * Which sparse climax pins this theme is willing to honour. This is not a
+     * curated auto-pick pool: pinOnly sparse ids never enter `layouts[slideType]`
+     * (`fullLayoutSet` / `excludePinOnly` already drop them), so a list here
+     * does not make `resolveLayoutId` sample them. It is the offer table for
+     * an explicit `slide.layout` pin — the only road that can ever reach a
+     * sparse page.
+     *
+     * **Three shapes, none of them a defaulted array:**
+     * - omitted / `undefined`: this theme offers every id in
+     *   {@link SPARSE_LAYOUT_IDS}. Builtins that have not boarded a face still
+     *   render the generic content face (`sparseFace` miss → `content-*.tsx`).
+     *   Custom themes registered via {@link registerTheme} get the same
+     *   omitted-means-all contract; do not default the field to `[]` or the
+     *   six-id list on the way in (`getThemeDefinition` round-trips the
+     *   registration object).
+     * - `[]`: this theme offers none. An explicit pin of any sparse id warns
+     *   at `validateIr` (`ok` stays true) and render falls back to auto-pick
+     *   from the ordinary content (or chapter, for `verse-chapter`) pool.
+     * - a list: only those ids. A listed id must be one of the six sparse
+     *   ids (`registerTheme` throws {@link PptwiseError} otherwise). It does
+     *   **not** have to sit in `layouts[slideType]` — those pools exclude
+     *   pinOnly members by construction.
+     *
+     * {@link themeOffersSparse} is the only offer check. Renderers must not
+     * branch on theme id. A pin this theme does not offer is stripped
+     * (`effectiveRequestedLayout`) *before* `resolveLayoutId`'s pin
+     * short-circuit, so fallback reuses the existing auto-pick path instead
+     * of teaching selection about this table.
+     */
+    sparseLayouts?: readonly string[];
+}
+/**
+ * `registerTheme`'s input shape (W4, spec §3 "缺省 = 全集"): identical to
+ * {@link ThemeDefinition} except `layouts` is optional, and — when present —
+ * each of its four slide-type entries is independently optional too. A
+ * slide type this theme doesn't narrow (its own key omitted, or the whole
+ * `layouts` object omitted) defaults to that type's full registered-
+ * layout set ({@link FULL_LAYOUTS}) — the exact same default every
+ * builtin theme in `LAYOUTS` above resolves to for a slide type it doesn't
+ * curate away from. `getThemeDefinition`/`REGISTERED_THEMES` still only ever
+ * hold the fully-resolved `ThemeDefinition` shape (`layouts` total over all
+ * four types) — `registerTheme` performs the defaulting once, here, so
+ * every downstream reader (`resolveLayoutId` foremost) can keep assuming
+ * a total record and never re-derive "was this slide type curated or
+ * defaulted".
+ */
+type ThemeRegistration = Omit<ThemeDefinition, "layouts"> & {
+    layouts?: Partial<Record<Slide["type"], readonly string[]>>;
+};
+/**
+ * Register a theme at runtime (SDK seam, not the v0.4 distribution
+ * protocol). Validates just enough to keep the render chain from silently
+ * breaking on a malformed registration — not a full schema:
+ *
+ * - `id` must not collide with a builtin or an already-registered theme.
+ * - each of the four slide types, once defaulted ({@link ThemeRegistration}),
+ *   must have at least one layout id that is both registered in
+ *   `LAYOUT_REGISTRY` and valid for that slide type (the same registry
+ *   `resolveLayoutId`/`FullSlideSvg` select from — a theme never ships
+ *   new render code, only a curated subset of the existing 30 layouts +
+ *   4 takeovers, per `docs/architecture.md`'s "Adding a theme" section). An
+ *   *explicit* empty array for a slide type still fails this check (the
+ *   default only kicks in when the key — or `layouts` itself — is omitted
+ *   entirely, `undefined`, never for a caller-supplied `[]`).
+ * - `style` must be present (a JS caller can bypass the TS type).
+ * - `style.colors.text`/`style.colors.muted` must each clear the
+ *   {@link CONTRAST_FLOOR} against a {@link CONTRAST_CHECKED_SLIDE_TYPES}
+ *   slide type's own resolved default background — see
+ *   {@link assertContrastFloor}'s own doc comment.
+ * - `sparseLayouts`, when present, may be empty (offers none) or a list of
+ *   {@link SPARSE_LAYOUT_IDS} members. A listed non-sparse id throws. The
+ *   field is not defaulted when omitted (`undefined` = offer all six).
+ *
+ * Also `console.warn`s (never throws) once for each of `style.fonts.heading`/
+ * `style.fonts.body` that resolves to a face with no exact width table — see
+ * {@link warnUnmeasuredFace}'s own doc comment. Fires only for a
+ * registration that clears every check above (i.e. one that is actually
+ * about to succeed).
+ *
+ * Once registered, the theme participates in `getInstalledThemeIds`,
+ * `getThemeDefinition` (hence `layout-selection.ts`/`FullSlideSvg`'s
+ * selection and `resolveBrand`), and `themes/index.ts`'s `resolveStyle` —
+ * every internal theme lookup, with no separate "registered theme" branch
+ * for callers to remember.
+ */
+declare function registerTheme(def: ThemeRegistration): void;
+/** Every installed theme id: the 13 builtins, then registered themes in registration order. */
+declare function getInstalledThemeIds(): readonly string[];
+/**
+ * Resolve a theme id to its full definition — a registered theme first, then
+ * the builtin fallback (`THEME_DEFINITIONS[resolveThemeId(id)]`, which itself
+ * folds an unrecognized id to consulting). The one lookup every internal
+ * consumer that used to read `THEME_DEFINITIONS[resolveThemeId(id)]`
+ * directly (`layout-selection.ts`, `full-slide-svg.tsx`) now calls instead, so
+ * a registered theme's curated layouts actually drive selection end-to-end.
+ */
+declare function getThemeDefinition(id: string): ThemeDefinition;
+
+/** The theme-file JSON shape written by `pptwise brand extract` / SDK
+ *  {@link extractBrandTheme}, and read back by `--theme-file` /
+ *  `brand-theme-file.ts`'s `registerBrandThemeFile`. Pure data (裁定 3): no
+ *  `layouts`/`motif`/`layoutTendencies` — those default to the full set,
+ *  same as any other `registerTheme` caller that omits them. `label` is
+ *  informational only (a human-readable name for the CLI/UI to show); the
+ *  render chain never reads it — the theme's own `id` is what everything
+ *  else keys off. */
+interface BrandThemeFile {
+    id: string;
+    label: string;
+    style: StyleTokens;
+    brand: BrandConfig;
+    tags: string[];
+}
+interface ExtractBrandThemeOptions {
+    /** Theme id — defaults to a slug of {@link ExtractBrandThemeOptions.label},
+     *  or (when that's also absent) a slug of the source theme part's own
+     *  `<a:clrScheme name="…">`. The CLI (`pptwise brand extract`) always
+     *  passes one explicitly (`--id`, or a slug of the `-o` filename — 裁定
+     *  4) — this default only ever fires for a bare SDK caller. */
+    id?: string;
+    /** Human-readable label — defaults to the source theme part's own
+     *  `<a:clrScheme name="…">`. */
+    label?: string;
+}
+/**
+ * Extract a {@link BrandThemeFile} from raw OOXML package bytes (a
+ * `.thmx`/`.potx`/`.pptx` file's own bytes — this function only ever reads
+ * the theme part inside, nothing else in the package). Deterministic: the
+ * same bytes always produce the same output (no randomness, no wall-clock
+ * read) — required for this wave's fixture tests' double-run-equality
+ * assertions.
+ *
+ * Throws {@link PptwiseError} for two *structural* failures — data this
+ * function has no reasonable default for:
+ * - no theme part found in the package at all
+ * - a theme part with no `dk1`/`lt1` (nothing to derive `bg`/`text` from) or
+ *   no accent color at all (nothing to derive `primary`/`chartPalette` from)
+ *
+ * Everything else degrades gracefully rather than throwing — a missing
+ * `lt2` falls back to `bg` (no distinct surface tone available), a missing
+ * `accent1` falls back to `dk2` then to the first available chart color, a
+ * missing font falls back to a Windows-safe generic stack — so a real-world
+ * theme missing a slot or two (this wave's own fixture matrix covers
+ * several) still produces a usable, if plainer, theme. A palette that
+ * degrades all the way into unreadable territory (near-identical
+ * text/bg/muted tones) is *not* rejected here — that's `registerTheme`'s
+ * own `assertContrastFloor` (`./definitions.ts`) job, at load time, with a
+ * message naming the actual failing token/ratio (see `brand-theme-file.ts`).
+ */
+declare function extractBrandTheme(bytes: Uint8Array | ArrayBuffer, opts?: ExtractBrandThemeOptions): Promise<BrandThemeFile>;
+
+/**
+ * Load an on-disk {@link BrandThemeFile} (`./brand-extract.ts`'s output, or
+ * a hand-authored equivalent) into the theme registry (brand-extract wave,
+ * 裁定 3: "装载走 registerTheme"). Split from `brand-extract.ts` because this
+ * module's job is untrusted-input validation + registration — a theme file
+ * is user-editable JSON, not something `extractBrandTheme`'s own return
+ * value needs re-validated against when it's the one producing it — while
+ * that module's job is the pure OOXML→tokens derivation. Both stay
+ * browser-safe (no Node-only import), same as every other file under
+ * `src/themes/` (`AGENTS.md`'s dependency-closure rule): the actual file
+ * read (`readFile`) happens in `src/cli/commands.ts`, which hands this
+ * module already-parsed JSON.
+ */
+
+declare const BrandThemeFileSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    style: z.ZodObject<{
+        id: z.ZodString;
+        allowCustomBackground: z.ZodOptional<z.ZodBoolean>;
+        colors: z.ZodObject<{
+            bg: z.ZodString;
+            surface: z.ZodString;
+            panel: z.ZodOptional<z.ZodString>;
+            primary: z.ZodString;
+            accent: z.ZodString;
+            text: z.ZodString;
+            muted: z.ZodString;
+            border: z.ZodOptional<z.ZodString>;
+            chartPalette: z.ZodArray<z.ZodString>;
+            accentPool: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            cardStroke: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        fonts: z.ZodObject<{
+            heading: z.ZodArray<z.ZodString>;
+            body: z.ZodArray<z.ZodString>;
+            mono: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+        shape: z.ZodOptional<z.ZodObject<{
+            radius: z.ZodOptional<z.ZodNumber>;
+            gapScale: z.ZodOptional<z.ZodNumber>;
+            typeScale: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        defaultBackgrounds: z.ZodObject<{
+            cover: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"color">;
+                value: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"gradient">;
+                from: z.ZodString;
+                to: z.ZodString;
+                direction: z.ZodOptional<z.ZodEnum<{
+                    tb: "tb";
+                    lr: "lr";
+                    diagonal: "diagonal";
+                }>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"asset">;
+                asset_id: z.ZodString;
+                overlay: z.ZodOptional<z.ZodObject<{
+                    color: z.ZodString;
+                    opacity: z.ZodNumber;
+                }, z.core.$strict>>;
+                fit: z.ZodOptional<z.ZodEnum<{
+                    contain: "contain";
+                    cover: "cover";
+                }>>;
+            }, z.core.$strict>], "kind">;
+            chapter: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"color">;
+                value: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"gradient">;
+                from: z.ZodString;
+                to: z.ZodString;
+                direction: z.ZodOptional<z.ZodEnum<{
+                    tb: "tb";
+                    lr: "lr";
+                    diagonal: "diagonal";
+                }>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"asset">;
+                asset_id: z.ZodString;
+                overlay: z.ZodOptional<z.ZodObject<{
+                    color: z.ZodString;
+                    opacity: z.ZodNumber;
+                }, z.core.$strict>>;
+                fit: z.ZodOptional<z.ZodEnum<{
+                    contain: "contain";
+                    cover: "cover";
+                }>>;
+            }, z.core.$strict>], "kind">;
+            content: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"color">;
+                value: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"gradient">;
+                from: z.ZodString;
+                to: z.ZodString;
+                direction: z.ZodOptional<z.ZodEnum<{
+                    tb: "tb";
+                    lr: "lr";
+                    diagonal: "diagonal";
+                }>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"asset">;
+                asset_id: z.ZodString;
+                overlay: z.ZodOptional<z.ZodObject<{
+                    color: z.ZodString;
+                    opacity: z.ZodNumber;
+                }, z.core.$strict>>;
+                fit: z.ZodOptional<z.ZodEnum<{
+                    contain: "contain";
+                    cover: "cover";
+                }>>;
+            }, z.core.$strict>], "kind">;
+            ending: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"color">;
+                value: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"gradient">;
+                from: z.ZodString;
+                to: z.ZodString;
+                direction: z.ZodOptional<z.ZodEnum<{
+                    tb: "tb";
+                    lr: "lr";
+                    diagonal: "diagonal";
+                }>>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"asset">;
+                asset_id: z.ZodString;
+                overlay: z.ZodOptional<z.ZodObject<{
+                    color: z.ZodString;
+                    opacity: z.ZodNumber;
+                }, z.core.$strict>>;
+                fit: z.ZodOptional<z.ZodEnum<{
+                    contain: "contain";
+                    cover: "cover";
+                }>>;
+            }, z.core.$strict>], "kind">;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    brand: z.ZodOptional<z.ZodObject<{
+        suppressFooterOnCardContent: z.ZodOptional<z.ZodBoolean>;
+        suppressFooterRule: z.ZodOptional<z.ZodBoolean>;
+        suppressFooterMeta: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/** Parse+validate raw JSON (already `JSON.parse`d by the caller — see
+ *  `src/cli/load-ir.ts`'s `loadIrFile`) as a {@link BrandThemeFile}. `source`
+ *  names the file in the thrown message (a path, or another caller-chosen
+ *  label) — mirrors `loadStyleFile`'s (`src/cli/commands.ts`) own
+ *  "invalid <kind> file <path>:\n<detail>" shape so a theme-file error reads
+ *  exactly like every other config-file validation error in this CLI. */
+declare function parseBrandThemeFile(raw: unknown, source: string): BrandThemeFile;
+/**
+ * Register a parsed {@link BrandThemeFile} (`registerTheme`, `./definitions.ts`
+ * — 裁定 3: this is the *only* loading path, so its contrast floor
+ * automatically gates every custom theme). Two collision outcomes, per 裁定
+ * 4:
+ *
+ * - `file.id` names a builtin (`CANONICAL_THEME_IDS`) → always a hard error,
+ *   regardless of whether this exact file was already loaded once — a
+ *   custom theme must never shadow a builtin id (determinism: which
+ *   `layouts`/`layoutTendencies` "consulting" resolves to must never depend
+ *   on whether some unrelated `--theme-file` ran first).
+ * - `file.id` is already registered (not a builtin) → a silent no-op, not a
+ *   second error. `registerTheme` itself throws unconditionally on *any*
+ *   id collision, builtin or not — this idempotent skip exists because
+ *   `pptwise serve`'s rebuild loop (`src/cli/serve.ts`) calls this on every
+ *   file-watch rebuild for the *same* deck, and the theme-file/deck-dir
+ *   `theme.json` it re-reads each time resolves to the same id every time.
+ *   (A theme file edited *between* two rebuilds keeps whichever version
+ *   registered first for that process's lifetime — no live-reload for a
+ *   theme file's own content, only for deck content; out of this wave's
+ *   scope.)
+ *
+ * Returns `file.id` so a caller can fold it into the deck's own
+ * theme-resolution precedence chain (`applyDeckConfig`, `src/cli/commands.ts`).
+ */
+declare function registerBrandThemeFile(file: BrandThemeFile): string;
+
+/**
+ * Narrative argument style (spec §5's five-way strategy classification,
+ * renamed from "mode" — spec §8.1). Each strategy carries a
+ * component/layout tendency set (soft-weight material, consumed by W4's
+ * weighted selection — nothing consumes it this wave) and a beat policy
+ * (renamed from "rhythm policy" — spec §2.3's deck/page beat split; consumed
+ * by W5's spec-validate rotation gate).
+ */
+type Strategy = (typeof STRATEGY_VALUES)[number];
+/**
+ * Content density budget + typographic baseline (spec §5 pacing table,
+ * renamed from "delivery" — spec §8.1). See {@link PacingBudget} for the
+ * dual-attribute capacity split this axis is one half of.
+ */
+type Pacing = (typeof PACING_VALUES)[number];
+/**
+ * Tone anchor only (spec §5: audience is tone-anchoring only, no rendering
+ * effect on the IR yet). Reserved for a future lint pass (e.g. executive ×
+ * long paragraphs → suggest kpi_cards/verdict_banner instead). The rule set
+ * itself is explicitly out of scope this wave (spec §10 open questions).
+ * Name unchanged by the vocabulary-v4 rename (spec §4.3: "audience 保持不变").
+ */
+type Audience = (typeof AUDIENCE_VALUES)[number];
+interface NarrativeProfile {
+    readonly strategy: Strategy;
+    readonly pacing: Pacing;
+    readonly audience: Audience;
+}
+
+interface StrategyDefinition {
+    id: Strategy;
+    /**
+     * Layout/component tendency set (soft-weight material). Filled row-for-row
+     * from spec §5's strategy table for W4's weighted selection step (spec §6
+     * step 4: in-set candidates get ×3 weight, out-of-set ×1 floor — not
+     * implemented yet, this module only stores the data).
+     *
+     * The set deliberately mixes two different vocabularies: component `type`
+     * names (e.g. "kpi_cards", "chart" — see the `Component` discriminated
+     * union in `ir/index.ts`) and layout `id`s (e.g. "image-split" — see
+     * `LAYOUT_REGISTRY` in `svg/layouts/registry.ts`). This is intentional,
+     * not an oversight: W4's weighting step resolves each entry against
+     * whichever vocabulary it belongs to (component types when scoring a
+     * candidate's components, layout ids when scoring the candidate layout
+     * itself). Nothing in this wave (W3) reads this field.
+     */
+    tendencies: readonly string[];
+    /**
+     * Content-layout soft-weight set for W4's weighted layout selection
+     * (spec §6 step 4: in-set candidates get `TENDENCY_WEIGHT` (×3), out-of-set
+     * get the `BASE_WEIGHT` floor (×1) — both named constants live in
+     * `svg/layout-selection.ts`, next to `resolveLayoutId`, the sole
+     * consumer). Deliberately a separate field from {@link tendencies} above,
+     * not a reinterpretation of it: `tendencies` mixes component-type names and
+     * layout ids drawn from spec §5's strategy table verbatim and also feeds W5's
+     * spec `focus` vocabulary gate, so narrowing its meaning here would be a
+     * breaking change to an existing consumer. This field holds only
+     * `LAYOUT_REGISTRY` content-layout ids (`svg/layouts/registry.ts`'s
+     * `CONTENT_LAYOUT_DEFS` keys) — cover/chapter/ending ids never appear in this
+     * field's list, `resolveLayoutId` reads {@link identityTendencies}
+     * below for those three slide types instead, so the two fields' id
+     * namespaces stay disjoint by construction rather than by convention.
+     * `tone-adaptive-content` appears in no strategy's list here (spec's "万金
+     * 油" call-out: it is the one content layout meant to read as
+     * strategy-neutral, so it always gets the ×1 floor).
+     *
+     * **`image-lead-split` (content-layout expansion wave, task T3) joins
+     * it, deliberately, as this field's third permanently-neutral member** — a
+     * decision, not an oversight (T1's own review flagged its absence here as
+     * looking accidental, so this note exists to close that off explicitly).
+     * Its defining trait is an *asset-availability* choice, not an
+     * *argument-style* one: the unconditional visual/text split depends on
+     * whether the deck's author actually has a chart/photo worth leading with
+     * (see `content-image-lead-split.tsx`'s own file header) — a pyramid deck,
+     * a storytelling deck, a showcase deck, and a briefing deck can equally
+     * have (or lack) a strong image to lead with, so no single strategy's
+     * rhetorical register (MECE evidence-first, editorial restraint,
+     * step-by-step procedure, glossy visual punch, plain scannability) owns
+     * this composition more than another's. **Reconsidered specifically
+     * against `showcase`** (the wave's final review, see `split-band`'s own
+     * entry in `showcase.layoutTendencies` below): showcase's register is
+     * visual *punch* (bold color blocks, opaque highlight panels), not visual
+     * *presence* — having an image at all doesn't say anything about how
+     * loudly the page asserts itself, so this layout's asset-dependence
+     * still doesn't map onto showcase's own membership criterion the way
+     * `split-band`'s full-bleed color band does. It still went back to
+     * neutral, not out of inertia. It *does* carry a beat-level personality
+     * instead (`BEAT_TENDENCIES`, `svg/layout-selection.ts` — `breathing`) —
+     * that axis measures page-level density character, a question this
+     * field's argument-style axis doesn't ask.
+     *
+     * **`split-band` (same wave, same task) does NOT join this field** — it
+     * was originally proposed here on the same "frame, not argument" theory
+     * above, but the wave's final review refuted that specific claim with
+     * in-file evidence: `split-band`'s defining feature, a full-bleed
+     * (x=0, w=1280) `colors.primary` header band, is the "bold opaque color
+     * block" idiom that earns `showcase.layoutTendencies` membership (the
+     * retired `side-highlight` panel used to share that register), and
+     * showcase's identity picks (`fashion-masthead`/`fashion-chapter`/
+     * `fashion-ending`) are themselves built from full-bleed color blocks —
+     * visual weight *is* showcase's rhetorical register, not a
+     * register-neutral frame choice. `split-band` is listed in
+     * `showcase.layoutTendencies` below instead of here.
+     *
+     * **Historical note (corrected P1 variety wave, task 3):** this field's
+     * doc comment used to claim cover/chapter/ending stayed uniformly sampled
+     * because "身份页个性来自 theme 不来自 strategy" — that claim was already
+     * false when written (`theme.layouts` only curates the candidate *pool*,
+     * spec §6 step 3 — the 13 built-in themes' pools are all the full registry
+     * set for every slide type, so `theme.id` contributes zero shaping either —
+     * see `.issues/.../dr/c-diversity.md`'s §1.1 measurement). Identity pages
+     * now get their own strategy-driven soft weighting via
+     * {@link identityTendencies} — theme's role stays exactly what step 3
+     * always said it was — pool curation, not per-layout preference — for
+     * both content and identity slides alike.
+     */
+    layoutTendencies: readonly string[];
+    /**
+     * Cover/chapter/ending soft-weight sets (P1 variety wave, task 3 — "身份页
+     * strategy 软加权"), one per identity slide type. Same ×3/×1 mechanics as
+     * {@link layoutTendencies} (`TENDENCY_WEIGHT`/`BASE_WEIGHT`,
+     * `svg/layout-selection.ts`) and the same consumer (`resolveLayoutId`),
+     * just scoped to a disjoint id namespace: this field holds only
+     * `LAYOUT_REGISTRY` cover/chapter/ending layout ids
+     * (`svg/layouts/registry.ts`'s `COVER_LAYOUT_DEFS`/`CHAPTER_LAYOUT_DEFS`/
+     * `ENDING_LAYOUT_DEFS` keys), never a content id — `resolveLayoutId` picks
+     * this field or {@link layoutTendencies} based on the slide type being
+     * resolved, never both for the same candidate.
+     *
+     * Deliberately small (2-3 members per page type, out of a 7-8-id pool) —
+     * spec: "映射表提案是内容决策...权重不是排除", so every non-member layout
+     * still stays reachable at the `BASE_WEIGHT` floor, just less often. Each
+     * member's rationale is documented next to its own strategy entry below,
+     * grounded in that layout's own body comment in
+     * `svg/layouts/registry.ts` (`COVER_LAYOUT_DEFS`/`CHAPTER_LAYOUT_DEFS`/
+     * `ENDING_LAYOUT_DEFS`), not its name alone.
+     *
+     * `tone-adaptive-header`/`tone-adaptive-chapter`/`tone-adaptive-ending`
+     * never appear in any strategy's set here, mirroring
+     * `tone-adaptive-content`'s absence from every {@link layoutTendencies}
+     * list: each is its page type's "万金油" (registry.ts's own convention),
+     * the one layout each identity slide type is meant to keep reading as
+     * strategy-neutral.
+     *
+     * Supersedes the old design note this field replaces (formerly recorded
+     * on {@link layoutTendencies} below, now corrected there): identity pages
+     * were never actually reading `theme.id` for their character either
+     * (`theme.layouts` only curates the *pool*, spec §6 step 3 — it was never
+     * a per-layout weighting signal, for content or identity slides alike)
+     * — this field is what now gives cover/chapter/ending a strategy-driven
+     * personality, the same soft-weight mechanism content pages have had since
+     * W4.
+     */
+    identityTendencies: {
+        readonly cover: readonly string[];
+        readonly chapter: readonly string[];
+        readonly ending: readonly string[];
+    };
+    /**
+     * Beat template descriptor (spec §5's per-strategy beat-default column,
+     * renamed from "rhythm" — spec §2.3), parameterized by strategy for W5's
+     * spec-validate rotation gate — e.g. briefing is exempt from a generic
+     * "three same-beat pages in a row is an error" rule because uniform-dense
+     * *is* briefing's correct default, not a violation of it (spec §5's
+     * spec-gate section calls out that a generic same-beat-streak rule would
+     * reject briefing's own default). Not consumed this wave.
+     */
+    beatPolicy: "anchor-open" | "alternate" | "repetition-ok" | "anchor-sparse" | "uniform-dense";
+}
+declare const STRATEGY_DEFINITIONS: Record<Strategy, StrategyDefinition>;
+
+interface PacingBudget {
+    /**
+     * Body-text baseline, in px, at 1280×720 slide geometry (spec §5 pacing
+     * table's body-baseline column). Wired into rendering as of W4 task 3
+     * (design decision 9): `src/svg/full-slide-svg.tsx` resolves
+     * `PACING_BUDGETS[resolveNarrative(ir.narrative).pacing].bodyBaselinePx`
+     * once and passes it into `buildCtx`, which stores it as
+     * `ComponentCtx.bodyFontPx` — the sole font-size input for the
+     * paragraph/bullets/callout trio ("正文" = continuous running text).
+     * Every other component's own bespoke type scale, the heading system, and
+     * quote's fixed 26px attribution line don't read this field. Since
+     * `balanced` (24px) is the narrative default, an omitted-narrative deck
+     * now renders body text at 24px, not the previous fixed 20px — the
+     * one-time, spec-sanctioned snapshot re-pin that landed alongside this
+     * wiring (W4 task 3, unchanged since — vocabulary-v4 only renames this
+     * table, it doesn't touch any of its numbers, spec §10).
+     */
+    bodyBaselinePx: number;
+    /**
+     * Per-slide editorial budget (component count) — content discipline
+     * ("how many things belong on this slide"), not geometry. Spec §5's
+     * dual-attribute capacity split keeps *physical* capacity ("how many
+     * things fit in this layout's slots") on the layout registry's body-slot
+     * `capacity` metadata (`svg/layouts/registry.ts`). The W3 quality gate
+     * takes `min(this budget, the resolved layout's body capacity)`.
+     */
+    maxComponentsPerSlide: number;
+    bullets: {
+        maxItems: number;
+        /**
+         * Same "unit" concept the deleted `CAPACITY.bullets` used
+         * (`measureTextUnits`, CJK weight = 1.0) — a visual-width-weighted
+         * character count, not a raw `.length`. The old physical ceiling (53,
+         * derived from render geometry) was deleted in W3 without a replacement
+         * check because every pacing's editorial budget here (30/40/48) is
+         * already strictly tighter than it — the quality gate now applies
+         * exactly this one number per pacing.
+         */
+        maxUnitsPerItem: number;
+    };
+}
+/**
+ * Pinned to spec §5's pacing table (`bodyBaselinePx` / editorial budget /
+ * bullets budget columns): dense 20/5/6×48, balanced 24/4/5×40, spacious
+ * 32/3/4×30 — same three rows as the pre-rename `text`/`balanced`/
+ * `presentation` delivery table, values byte-for-byte unchanged (spec §10).
+ */
+declare const PACING_BUDGETS: Record<Pacing, PacingBudget>;
+
+interface NarrativePreset {
+    id: string;
+    axes: NarrativeProfile;
+    /**
+     * Soft theme recommendations — a suggestion, never a hard constraint
+     * (spec §5). Surfaced in workflow step ① so an agent can open with a
+     * themed proposal — the user may still pick any theme. Every entry here
+     * must be a real `BUILTIN_THEME_IDS` member (`ir/index.ts`) — enforced by
+     * this module's test suite, which imports and tests against it.
+     */
+    themeRecommendations: readonly string[];
+}
+/**
+ * Pinned to spec §5's 7 named presets and their theme recommendation table.
+ * Preset ids are unchanged by the vocabulary-v4 rename (spec §5: "预设 ID
+ * 保持不变") — only each preset's internal axes keys/values follow the
+ * strategy/pacing rename (e.g. `annual-review`'s `mode: "narrative"` is now
+ * `strategy: "storytelling"`, spec §5's own worked example).
+ */
+declare const NARRATIVE_PRESETS: Record<string, NarrativePreset>;
+/**
+ * = `NARRATIVE_PRESETS.general.axes` (briefing × balanced × public) — the
+ * global default when narrative is omitted entirely (spec §5's defaults
+ * chain).
+ */
+declare const DEFAULT_NARRATIVE: NarrativeProfile;
+/**
+ * Resolve a narrative input down to concrete axes, per spec §5's design
+ * principle "omission gets the default, a typo is a hard error" (weak-model
+ * friendly: a model that leaves a field out gets a sane deck, a model that
+ * misspells a value gets a loud, actionable error instead of a silently
+ * wrong deck):
+ *
+ * - `undefined` → {@link DEFAULT_NARRATIVE} (the `general` preset's axes)
+ * - a preset id string → that preset's axes (unknown id throws
+ *   {@link PptwiseError}, listing the available preset ids)
+ * - a partial axes object → each axis defaults independently
+ *   (strategy → "briefing", pacing → "balanced", audience → "public" — these
+ *   happen to equal `DEFAULT_NARRATIVE`'s values because `general` *is* that
+ *   exact combination, but the fallback here is per-axis, not "any omitted
+ *   axis falls back to the whole default object")
+ * - an `{id: <preset>}` object (T0b fix 2, scope-extended — see
+ *   {@link rescueIdShape}) → silently treated as that bare preset-id string,
+ *   the same weak-model shape slip `theme: {id: "consulting"}` invites by
+ *   analogy. Folded directly into this function's own entry (not just a
+ *   pre-parse pass two of its six call sites happen to run) so every caller
+ *   — `validateIr`, `validateSpec`, `layout-selection.ts`,
+ *   `full-slide-svg.tsx`, `ir-quality.ts`, `cli/commands.ts` alike — gets
+ *   this tolerance for free, present and future. Silent here (no rewrite
+ *   note — this is a pure resolver with no reporting channel, and adding one
+ *   would ripple into every one of those call sites' own return-shape
+ *   expectations); `validateIr`/`validateSpec` additionally run
+ *   {@link normalizeNarrativeShape} on their own raw pre-parse input first,
+ *   specifically to report + persist the rewrite into what they return.
+ *
+ * An unknown axis value, or an unknown key on the partial axes object,
+ * always throws {@link PptwiseError} (never silently ignored or dropped) —
+ * omission and a typo are different intents, and only the former has a
+ * reasonable default. A mixed `{id, strategy}`-style shape is exactly this
+ * case ({@link rescueIdShape} declines it): `id` is simply an unrecognized
+ * key, so it hard-errors the same as any other typo.
+ *
+ * Renamed from `resolveScenario` (spec §8.1). Callers that still hold a
+ * pre-rename `mode`/`delivery` shaped input (e.g. a v3 IR's `scenario`
+ * field) must migrate it first — see `migrateIrV3ToV4`
+ * (`src/ir/migrate.ts`) for the deterministic field/value mapping. A
+ * v4-track document that still writes the old field/value spelling gets no
+ * such rescue (spec §16, reversing the now-superseded §15.4): this function
+ * hard-errors on it, same as any other unknown axis key or value. The
+ * `{id}` shape above is not that — it was never a v3 `scenario` shape, just
+ * a new confusion weak models invent by analogy to `theme.id`.
+ */
+declare function resolveNarrative(input: string | Partial<NarrativeProfile> | undefined): NarrativeProfile;
+
+/**
+ * Deck spec schema + validation (spec §5 "plan artifact and hard gates", W5
+ * task 2 — renamed to "Deck Spec" per the vocabulary-v4 rename, spec §6/§8.1;
+ * "spec §N" citations throughout this file that predate this rename still
+ * point at that original W5 design doc, not this rename's own spec — left
+ * as historical citations, not renumbered). That rename originally covered
+ * the exported concepts and CLI vocabulary only — this module's own
+ * directory stayed `src/plan` for a while after, a known stale name the
+ * src domain-reorg wave's task T1c closed by moving it to `src/spec`
+ * (mechanical `git mv`, every exported symbol unchanged): the path now
+ * matches the vocabulary this header already used throughout.
+ *
+ * A deck spec is a workflow artifact, not a render prerequisite (spec §5's
+ * "escape hatch": a bare IR v3 renders directly, `spec validate` is a
+ * separate, optional gate for the spec-authoring stage of the six-phase
+ * workflow). This module stays pure and Node-free — no `fs`, no CLI concerns
+ * — so it can sit in `src/index.ts`'s dependency closure exactly like
+ * `src/ir` and `src/narrative` already do (`AGENTS.md`'s layout rule).
+ * `src/cli/commands.ts` owns the one Node-touching wrapper
+ * (`runSpecValidate`: read file, call {@link validateSpec}, format the
+ * result).
+ *
+ * Design mirrors `api.ts`'s `validateIr`/`ValidateResult` throughout
+ * (structural zod pass first, then a sequential chain of hard-gate
+ * categories, each short-circuiting the chain on its own failure — see
+ * {@link validateSpec}'s own comment for why): same overall shape, adapted
+ * for spec pages being keyed by an author-assigned `id` instead of IR's
+ * positional slide index.
+ */
+
+/**
+ * Mirrors `SlideSchema.type` / `SlideType` (`ir/index.ts`,
+ * `svg/layouts/registry.ts`) exactly. Kept as an independent literal tuple
+ * here (not imported from either) — a page spec's `type` is a 4-value enum
+ * on its own schema, not a re-export of IR's — but the `satisfies` clause
+ * makes any future drift between the two a compile error instead of a
+ * silent mismatch.
+ */
+declare const PAGE_TYPES: readonly ["cover", "chapter", "content", "ending"];
+type PageSpecType = (typeof PAGE_TYPES)[number];
+type PageBeat = (typeof BEAT_VALUES)[number];
+/**
+ * A single page spec (spec §5, §6). `type`/`heading` are required — unlike
+ * IR's own `SlideSchema` (where both default/omit for weak-model
+ * friendliness), a deck spec is the authoring artifact those fields get
+ * *locked* from at assemble time (W5 task 3), so leaving either implicit
+ * here would defeat the point. `beat`/`focus`/`summary` stay optional per
+ * spec §5's defaults chain ("beat omitted → auto-rotates by page position —
+ * focus/summary/layout/slot can all be omitted").
+ */
+declare const PageSpecSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        content: "content";
+        cover: "cover";
+        chapter: "chapter";
+        ending: "ending";
+    }>;
+    heading: z.ZodString;
+    beat: z.ZodOptional<z.ZodEnum<{
+        dense: "dense";
+        anchor: "anchor";
+        breathing: "breathing";
+    }>>;
+    focus: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type PageSpec = z.infer<typeof PageSpecSchema>;
+/**
+ * Top-level deck spec shape (spec §5, §6). `narrative`/`theme` deliberately
+ * have no schema-level `.default(...)` — same reasoning as `PptxIRSchema`'s
+ * own `narrative` field (`ir/index.ts`): the resolved value is never baked
+ * back into the parsed shape, {@link validateSpec} (here) and, later,
+ * assemble (W5 task 3) each resolve it themselves. `seed` is accepted but
+ * entirely unexamined by this module — "not validateSpec's concern" (spec's
+ * own wording): assemble generates and suggests writing one back on first
+ * materialization.
+ *
+ * `version` stays the literal `"1"` (unchanged value) but now carries an
+ * independent Deck Spec versioning scheme (spec §6: "`deck.spec.json` 使用
+ * 独立的 spec 版本 1。它是新工件，不继承 `deck.plan.json` 的版本号语义") —
+ * this "1" is the Deck Spec artifact's own first version, not a continuation
+ * of the old deck-plan artifact's version counter, even though the digit is
+ * the same.
+ */
+declare const DeckSpecSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodLiteral<"1">>;
+    narrative: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    theme: z.ZodOptional<z.ZodString>;
+    filename: z.ZodOptional<z.ZodString>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    meta: z.ZodDefault<z.ZodObject<{
+        organization: z.ZodOptional<z.ZodString>;
+        authors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodString>;
+            org: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        date: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        confidentiality: z.ZodOptional<z.ZodEnum<{
+            public: "public";
+            internal: "internal";
+            confidential: "confidential";
+            restricted: "restricted";
+        }>>;
+        contact: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            email: z.ZodOptional<z.ZodString>;
+            phone: z.ZodOptional<z.ZodString>;
+            website: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        copyright: z.ZodOptional<z.ZodString>;
+        animation: z.ZodOptional<z.ZodObject<{
+            transition: z.ZodOptional<z.ZodEnum<{
+                push: "push";
+                none: "none";
+                fade: "fade";
+                wipe: "wipe";
+            }>>;
+            elements: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                auto: "auto";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    brand: z.ZodOptional<z.ZodObject<{
+        logo_asset_id: z.ZodOptional<z.ZodString>;
+        position: z.ZodOptional<z.ZodEnum<{
+            tl: "tl";
+            tr: "tr";
+            bl: "bl";
+            br: "br";
+        }>>;
+    }, z.core.$strict>>;
+    branding: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        "cover-only": "cover-only";
+        minimal: "minimal";
+    }>>;
+    pages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            content: "content";
+            cover: "cover";
+            chapter: "chapter";
+            ending: "ending";
+        }>;
+        heading: z.ZodString;
+        beat: z.ZodOptional<z.ZodEnum<{
+            dense: "dense";
+            anchor: "anchor";
+            breathing: "breathing";
+        }>>;
+        focus: z.ZodOptional<z.ZodString>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type DeckSpec = z.infer<typeof DeckSpecSchema>;
+/** JSON Schema for the deck spec — feed this to a model before it writes one (see `pptwise schema --spec`). */
+declare function specJsonSchema(): Record<string, unknown>;
+interface SpecValidationIssue {
+    path: string;
+    message: string;
+    /** The offending page's `id`, when the issue is scoped to one specific
+     *  page and that page's `id` could be determined — absent for deck-level
+     *  issues (e.g. "pages non-empty") and for structural issues on a page
+     *  whose own `id` itself failed to parse. */
+    pageId?: string;
+}
+interface SpecValidateResult {
+    ok: boolean;
+    spec?: DeckSpec;
+    errors: SpecValidationIssue[];
+    /**
+     * Same shape and channel as `ValidateResult.normalized` (`../validate-core.ts`)
+     * — human-readable `path: alias → canonical`-style rewrite entries for every
+     * deterministic pre-parse rewrite `validateSpec` applied before parsing.
+     * Sources: `normalizeDeckRootAliases` (`chrome` → `branding`) and
+     * `normalizeNarrativeShape` (`../narrative`, T0b fix 2): a top-level
+     * `narrative: {id: "<preset>"}` shape rewritten to the bare preset string.
+     * Present only when at least one rewrite happened; informational, never
+     * gates `ok` on its own.
+     * `cli/commands.ts`'s `runSpecValidate` prints this through the same
+     * `normalizedNote` helper `runValidate`/`runRender` already use for the
+     * bare-IR path's own component field-alias notes.
+     */
+    normalized?: string[];
+}
+declare function formatSpecIssues(errors: SpecValidationIssue[]): string;
+/**
+ * Deck-spec-level theme default (spec §5's defaults chain: "theme omitted →
+ * consulting") — the same default IR's own `theme.id` field carries
+ * (`ThemeSchema` in `ir/index.ts`). Exported so a caller already holding a
+ * validated {@link DeckSpec} (the CLI's OK-summary line) doesn't re-derive
+ * the fallback itself.
+ */
+declare function resolveSpecThemeId(spec: DeckSpec): string;
+/**
+ * Deck-level page-count range per pacing (spec §5's pacing table,
+ * initial values — "dense 8-30 / balanced 6-24 / spacious 4-16", not yet
+ * tuned against real usage). Independent of `PACING_BUDGETS`
+ * (`narrative/index.ts`, per-slide component-count/bullets editorial
+ * budget) — this is a separate, deck-wide page-count concern the spec calls
+ * out as its own hard gate ("page count vs. pacing recommended range").
+ * Message wording renamed from "delivery" to "pacing" (vocabulary-v4
+ * residual, routed from the task 1 review) — the axis itself was already
+ * `Pacing` at the type level, this closes the last stale word in the
+ * error text.
+ */
+declare const SPEC_PAGE_COUNT_RANGE: Record<Pacing, {
+    min: number;
+    max: number;
+}>;
+/**
+ * Validate raw JSON against the spec schema, then — once it parses — run the
+ * spec §5 hard-gate chain. Mirrors `validateIr`'s (`api.ts`) overall shape: a
+ * structural zod pass first, then a sequence of isolated hard-gate
+ * categories, each short-circuiting the whole chain on its own failure
+ * (rather than accumulating errors across categories) so a later category
+ * never has to guess at what an earlier, already-broken one would have
+ * meant — e.g. beat-rotation and page-count both need a resolved
+ * narrative, so nothing past the narrative/theme stage runs until that
+ * resolves cleanly. Every spec-gate philosophy here is "hard block, no soft
+ * warning" (spec §5's "escape hatch" section — a spec that doesn't fit this shape
+ * should be authored as bare IR instead, not warned-and-shipped).
+ *
+ * Before the schema parse, {@link normalizeNarrativeShape} (`../narrative`,
+ * T0b fix 2 scope extension) runs on the raw input, exactly mirroring
+ * `validateIr`'s own pre-parse pass (`../validate-core.ts`) — a top-level
+ * `narrative: {id: "<preset>"}` shape is rewritten to the bare preset
+ * string before `DeckSpecSchema.safeParse` ever sees it, so the correction
+ * lands in the returned `spec` itself (read again by `checkBeatRotation`/
+ * `checkFocusVocabulary`/`checkPageCount` below, and by `runSpecValidate`'s
+ * own OK-summary line, `../cli/commands.ts`), not just this function's own
+ * local `resolveNarrative` call below. Every return path is wrapped in
+ * `withNormalized` so the rewrite note (`SpecValidateResult.normalized`)
+ * surfaces on success *or* failure, success or failure alike — same
+ * "informational, never gates `ok`" contract `ValidateResult.normalized`
+ * has.
+ */
+declare function validateSpec(input: unknown): SpecValidateResult;
+
+/**
+ * One page's fillable content — everything a page spec's `id` does *not*
+ * already lock in. Deliberately excludes `type`/`heading` (spec-owned, see
+ * {@link assembleDeck}'s locked-field gate) and `subheading`/`decor`
+ * (legitimate `Slide` fields, but outside this record's shape by spec §7's
+ * own layout — "pages/<id>.json contains only components" — a spec/pages deck can't
+ * author either one — a hand-authored bare IR still can). Every field here is
+ * a same-name, same-shape subset of `Slide`'s own optional fields
+ * (`../ir`'s `SlideSchema`) — reused, not redeclared, so the two can't drift.
+ */
+interface PageContent {
+    components?: Component[];
+    layout?: string;
+    arrangement?: NonNullable<Slide["arrangement"]>;
+    background?: BackgroundSpec;
+    image_side?: "left" | "right";
+    footnote?: string;
+    notes?: string;
+}
+interface AssembleResult {
+    ir: PptxIR;
+    /**
+     * Set only when `spec.seed` was absent and {@link assembleDeck} generated
+     * one deterministically (see the seed section of this function's doc
+     * comment) — `undefined` when `spec.seed` was already present and simply
+     * passed through. The CLI shell (W5 task 5) is the one that acts on this:
+     * suggest writing the value back into the spec file, never rewrite it
+     * itself (assemble stays a pure function, no fs side effects here).
+     */
+    generatedSeed?: number;
+    /**
+     * Count of pages whose `layout` field this call filled in via
+     * {@link materializeEffectiveLayouts} (W4 design decision 10) —
+     * `undefined` when zero, same "absent means nothing to report" posture as
+     * {@link generatedSeed} just above (a page with an explicit pin already in
+     * its page file, or every omitted page landing on the image-cover
+     * takeover's `null` bypass, both leave this unset). Purely informational:
+     * the CLI shell (`runAssemble`, `../cli/commands.ts`) surfaces it as a
+     * one-line note, nothing here or downstream acts on the number itself.
+     */
+    materializedLayoutCount?: number;
+}
+/**
+ * Assemble a validated deck spec plus a per-page content record into a
+ * renderable IR. See this module's own top comment for the overall shape.
+ * Step numbers below match the W5 task-3 brief's own numbered "inject
+ * semantics" list verbatim — kept in that exact order because two of them
+ * (locked-field vs. orphan) both throw and their relative order is
+ * otherwise unobservable from either doc comment alone.
+ *
+ * 1. `spec` is `unknown` (same boundary `validateSpec` itself has — a spec
+ *    is almost always freshly `JSON.parse`d off disk by the caller) —
+ *    invalid shape or a failed hard gate throws {@link PptwiseError} with
+ *    `validateSpec`'s own formatted issue list, not a re-derived message.
+ * 2. Shape guard + locked-field protection: a `pages[id]` entry must first be
+ *    a plain object — not `null`, an array, or a primitive — else throws.
+ *    `pages` is `unknown`-shaped off disk same as `spec` itself (step 1), so
+ *    a JSON `null`/string/array content value is a real possibility, not
+ *    just a type-system hole, and `Object.hasOwn` throws its own
+ *    uninformative native `TypeError` on `null` (and silently no-ops on a
+ *    string/array/number) rather than this gate's own readable message.
+ *    Once that holds, a `pages[id]` entry that carries a `type` or `heading`
+ *    *key* — even set to `undefined` — throws. `Object.hasOwn`, not a
+ *    `!== undefined` read, is what makes that "even `undefined`" case
+ *    catchable: `PageContent` itself never declares either field, but a
+ *    page file freshly parsed off disk is `unknown` before it reaches this
+ *    function's declared `PageContent` parameter type, so a stray
+ *    `"heading": null`-turned-`undefined` or a copy-pasted empty key is
+ *    exactly the drift this gate exists to catch instead of silently
+ *    ignoring.
+ * 3. Orphan keys: a `pages` entry whose id isn't any spec page's id. Listed
+ *    together with a fix suggestion, checked only after every present page
+ *    has cleared the locked-field gate (step 2) — an orphan file that
+ *    *also* happens to redeclare `heading` reports as locked-field first.
+ * 4. Missing pages (a spec id with no `pages` entry) become a placeholder
+ *    slide — never an error. Spec §7's own words: "assemble's precise
+ *    semantics — a missing page always succeeds (placeholder), a structural
+ *    contradiction (orphan file / bad spec / id conflict) errors". A
+ *    declared `summary` becomes the placeholder's `subheading` so a
+ *    `--draft` preview of an unfilled deck still reads as more than a bare
+ *    "Untitled". Step 5 preserves the same visible line for filled boundary
+ *    pages while keeping it fill-only on filled content pages. A declared
+ *    `beat` carries straight into the
+ *    placeholder's own `Slide.beat` too (P1 variety wave, task 1 — see step
+ *    5's note below). A placeholder page still participates in this
+ *    function's own layout materialization below, so its beat still needs
+ *    to reach the IR for that weighting to see it once the page is filled
+ *    in later without re-materializing.
+ * 5. Present pages become a full slide: `id`/`type`/`heading` from the page
+ *    spec (never the content record — see step 2), plus whichever of
+ *    {@link PageContent}'s seven fields the content record actually set.
+ *    `beat` now carries straight into the IR's own `Slide.beat` field too —
+ *    reached from `PageSpec`, not `PageContent` (same source as `id`/`type`/
+ *    `heading`, since `beat` is spec-owned, not per-page content) — as of
+ *    the P1 variety wave's task 1. Previously dropped here as a spec-only
+ *    authoring anchor, `SlideSchema.beat`'s own doc comment
+ *    (`../ir/index.ts`) has the full accounting of what it now does
+ *    downstream. `focus` remains a spec-only authoring anchor. A filled
+ *    boundary page (`cover`, `chapter`, or `ending`) carries `summary` into
+ *    `subheading`, because its page file has no body-content field that can
+ *    express the line after filling. A filled `content` page keeps summary
+ *    spec-only, so its fill prompt does not become duplicate visible slide
+ *    content.
+ * 6. Top-level: `version` is always the literal `"4"` (IR's own version,
+ *    unrelated to the deck spec's own `version: "1"`) — the deck spec's own
+ *    `narrative` field (renamed this task from `scenario`, spec §8.1's
+ *    `DeckPlan`→`DeckSpec` rename, task 2) carries across into the v4 IR's
+ *    own `narrative` field, its value already in the new strategy/pacing
+ *    vocabulary (vocabulary-v4 rename, task 1 — `spec/index.ts`'s own
+ *    `resolveNarrative` call already validates it against that vocabulary
+ *    before this function ever runs).
+ *    `theme`/`filename`/`brand`/`branding`/`meta`/`seed` (step 7) carry over from the spec when
+ *    present. When absent, this function omits the field from the raw
+ *    object it hands to {@link PptxIRSchema} rather than re-deriving IR's
+ *    own default value a second time — one default source of truth, the
+ *    schema itself (e.g. `theme` omitted here becomes `{ id: "consulting" }`,
+ *    exactly like a bare hand-authored IR that never mentions theme at all —
+ *    not a value this function needs to know). `branding` is the same omit
+ *    posture: a spec that never sets it produces an IR that never sets it,
+ *    and the renderer treats that as `"cover-only"`. This function must not
+ *    infer branding from narrative.
+ * 7. Seed: `spec.seed` present → passed through, `generatedSeed` stays
+ *    `undefined` on the result. Absent → {@link generateSeed} derives one
+ *    from `filename` + the spec's own ordered page-id list (never page
+ *    *content* — see that function's own doc comment for why), written to
+ *    `ir.seed` *and* returned as `generatedSeed` so a CLI shell can suggest
+ *    writing it back into the spec file (this function never touches disk
+ *    itself).
+ * 8. Idempotence: every step above is a pure function of its inputs (no
+ *    randomness, no wall-clock, no reliance on unordered iteration) — two
+ *    calls with structurally-equal `spec`/`pages` produce deep-equal
+ *    results, `generatedSeed` included. Exercised directly by this module's
+ *    test suite rather than asserted here.
+ */
+declare function assembleDeck(spec: unknown, pages: Record<string, PageContent>): AssembleResult;
+/**
+ * Inverse of {@link assembleDeck}: reconstructs `{ spec, pages }` from an
+ * existing IR well enough that `assembleDeck(...disassembleDeck(ir))`
+ * reproduces the deck-project content surface. The map is not lossless for
+ * fields that the spec/pages format cannot represent. The known losses and
+ * recoveries are:
+ *
+ * - `focus` never appears on any produced {@link PageSpec} — it is a
+ *   spec-only authoring anchor with no corresponding `Slide` field at all
+ *   (see {@link assembleDeck} step 5's doc comment). Nothing here could
+ *   recover a value that was never written anywhere. `beat` used to share
+ *   this fate but no longer does (P1 variety wave, task 1): it is now a
+ *   plain passthrough on both sides, exactly like `layout`/`heading` below —
+ *   `assembleDeck` step 5/6 reads `pageSpec.beat` into `slide.beat`, this
+ *   function reads `slide.beat` straight back below.
+ * - `summary` is recovered from `subheading` for every placeholder slide and
+ *   for filled boundary slides (`cover`, `chapter`, and `ending`). This
+ *   reverses steps 4 and 5 without losing their visible subtitle. A filled
+ *   content slide's own `subheading` remains a separate authored field. It
+ *   has no {@link PageContent} field to land in, and treating it as summary
+ *   would turn visible slide copy into a fill-only prompt, so it is dropped.
+ *   Same for `decor`: a real `Slide` field absent from `PageContent`.
+ * - `theme.style` / `theme.brand` overrides collapse to a bare theme-id
+ *   string (`DeckSpecSchema.theme` has no shape for either) — only `theme.id`
+ *   survives. That `theme.brand` is `ThemeSchema.brand` (`BrandConfigSchema`
+ *   — `suppressFooterOnCardContent`/`suppressFooterRule`/`suppressFooterMeta`,
+ *   brand-footer flags owned by the *theme*) — not to be confused with the deck-level
+ *   `brand` field below, a different, unrelated schema despite the shared
+ *   name.
+ * - `ir.assets.images` is not part of this function's return value at all —
+ *   `{ spec, pages }` has no `assets` field, and this module stays zero-fs
+ *   by design (this file's own top comment), so it has no way to write an
+ *   `assets/` directory itself. Any `asset_id` reference inside a copied
+ *   `components`/`background` survives untouched ({@link extractPageContent}
+ *   copies both as-is), but the underlying image bytes are deliberately left
+ *   for the caller: the CLI shell closes that gap. `runDisassemble`
+ *   (`../cli/commands.ts`) walks the *input* IR's `ir.assets.images` itself
+ *   and materializes every entry into `<outDir>/assets/<id>.<ext>`
+ *   (`writeDeckAssets`, `../cli/deck-dir.ts`) so a later `readDeckDir`'s
+ *   `scanAssets` re-registers them exactly like any other deck-directory
+ *   asset. Skipping that shell-side step is not a doc-comment nuance — it
+ *   reproduces as a real bug: an image deck disassembles with every
+ *   `asset_id` left dangling, then re-assembles and renders with the image
+ *   silently missing.
+ *
+ * Round-trip-safe despite the above, worth calling out because of that name
+ * collision: the top-level `brand` field (`BrandSchema` — `logo_asset_id` /
+ * `position`, the deck logo/position `Branding` reads,
+ * `src/svg/branding.tsx`) is a plain passthrough on both sides
+ * ({@link assembleDeck} step 6 reads `spec.brand` into `ir.brand` — this
+ * function reads `ir.brand` back into `spec.brand` below) — carried through
+ * unmodified, same as `narrative`/`filename`/`seed`/`branding`, never
+ * synthesized or dropped.
+ *
+ * `layout` deserves a different kind of callout: it round-trips as plain
+ * content like any other field ({@link extractPageContent} copies
+ * `slide.layout` into `PageContent.layout` whenever the slide has one, no
+ * special case) — but a `deck.json` produced by {@link assembleDeck} now
+ * carries a `layout` on nearly every slide (W4 design decision 10's
+ * materialization, see that function's own doc comment), even on pages whose
+ * *original page file* never set one. Nothing on `Slide` marks which is
+ * which — `layout` is just a string either way — so disassembling an
+ * already-assembled `deck.json` writes every materialized pick into the
+ * regenerated page file as if it had been an explicit pin all along, and a
+ * later re-`assembleDeck` call skips materialization for that page from then
+ * on, same as any hand-authored pin. Accepted, not a bug: `disassembleDeck`
+ * is a one-time bare-IR importer into an editable project directory, not a
+ * round-trip channel for `deck.json` itself. A deck project's own
+ * `pages/<id>.json` files are the durable, edit-in-place artifacts —
+ * `deck.json` is downstream output, and feeding it back through
+ * `disassembleDeck` (instead of editing the project directory that produced
+ * it) is what actually costs those pages their revision-stability
+ * re-selection eligibility going forward. A real, user-visible narrowing,
+ * worth knowing about here, not worth adding code to guard against for a
+ * usage pattern nothing in this codebase actually exercises.
+ *
+ * Two structural fields are synthesized rather than copied when the source
+ * slide omits them, each documented where it is generated:
+ * {@link UNTITLED_HEADING} for a missing/blank `heading`, and a positional
+ * `p-<1-based-ordinal>-<type>` scheme for a missing `id` (stable across
+ * repeated calls on the same IR — it is a pure function of slide position
+ * and type — but, unlike a spec-assigned id, *not* stable across inserting
+ * or reordering slides — out of scope here, since a bare IR with no `id` at
+ * all has no stabler identity to fall back to in the first place).
+ *
+ * That generated `p-<ordinal>-<type>` id is safe by construction as a
+ * page/asset file-name segment (W5 whole-branch review finding 1, verified
+ * — not just asserted — rather than also routing it through
+ * `assertSafeFileSegment`, `../cli/deck-dir.ts`): `<ordinal>` is
+ * `index + 1`, always a plain non-negative integer, and `<type>` is a
+ * `Slide["type"]`, a closed schema enum (`"cover" | "chapter" | "content" |
+ * "ending"`, `SlideSchema.type` in `../ir/index.ts`) — neither half can ever
+ * contain a `/`, a `\`, or resolve to `".."`, so the joined id can't either.
+ * A carried-over `slide.id` (the `??` branch's other side) has no such
+ * guarantee — that is the one this function passes straight through
+ * unchecked, same as every other field {@link extractPageContent} copies —
+ * which is exactly why the write-time gate in `../cli/deck-dir.ts` (not this
+ * function) is what actually closes the vulnerability.
+ */
+declare function disassembleDeck(ir: PptxIR): {
+    spec: DeckSpec;
+    pages: Record<string, PageContent>;
+};
+
+declare function migrateDeckPlanToSpec(raw: unknown): unknown;
+
+/**
+ * `pptwise audit` finding shape (v0.3 W6, spec §7 workflow ④). `page` is
+ * 1-based (matches `ValidationIssue.page` in `api.ts`); `slideId` is set
+ * whenever the offending slide has a stable `id` (assemble-stamped or
+ * author-supplied), same "page + optional id" convention `formatIssues`
+ * already uses for validate errors.
+ */
+interface AuditFinding {
+    page: number;
+    slideId?: string;
+    code: "overflow" | "out-of-bounds" | "low-contrast" | "overlap" | "content-truncated" | "content-dropped";
+    message: string;
+    detail?: Record<string, unknown>;
+}
+/**
+ * Which check families actually ran (audit-v2 phase B, spec §4.2/§11.6) —
+ * the one piece of the spec's original metrics design that survives into
+ * this wave (§11.6: metrics itself deferred, "唯一现值是 checks 结构"). This
+ * is the wave's own spirit made literal: a field can only ever be
+ * `"completed"` once its check family genuinely ran over every audited
+ * page, never a default that silently reads as "passed". `svg` has no
+ * `"not-requested"` state — the deterministic SVG audit always runs, so it
+ * is always `"completed"`. `pixels` starts `"not-requested"` and only ever
+ * becomes `"completed"`; there is deliberately no `"failed"` value — a
+ * failed pixel audit throws (spec §11.7's "契约层"), it never reports
+ * itself as a completed check that happens to carry no findings.
+ */
+interface AuditChecks {
+    svg: "completed";
+    pixels: "not-requested" | "completed";
+}
+interface AuditReport {
+    findings: AuditFinding[];
+    pagesAudited: number;
+    pagesSkipped: number;
+    checks: AuditChecks;
+}
+/** `auditDeck`'s second parameter (audit-v2 phase B) — see that function's
+ *  own doc comment for the overload contract this shape backs. */
+interface AuditDeckOptions {
+    pixels?: boolean;
+}
+/**
+ * The SDK entry point. Advisory, not a hard gate: `validateIr` already
+ * rejects structurally invalid or over-dense decks before a caller ever
+ * gets this far; this function looks for the visual problems that can still
+ * slip through a valid deck at render time (an author-chosen near-background
+ * text color, two components whose combined content happens to collide, a
+ * card list that had to drop an item to fit). A non-empty `findings` array
+ * is a prompt for a human/agent to look, not a rejection.
+ *
+ * Placeholder pages (`slide.placeholder === true`) are skipped — assemble's
+ * stand-in for content nobody has written yet has nothing to audit, same
+ * reasoning `checkIrQuality` already uses to skip them (`ir-quality.ts`).
+ *
+ * `auditDeck` itself never calls `installNodePlatform()`; that's the
+ * caller's job (the CLI does it automatically).
+ *
+ * `opts.pixels` (audit-v2 phase B, spec §4.3/§11.7) opts into the optional
+ * pixel-level contrast audit over image-backed text (`../svg/audit/pixel-audit.ts`)
+ * — overloaded so the far more common omitted/`false` case keeps returning
+ * a plain, synchronous `AuditReport` (spec §11.7's "语义层": the default
+ * audit stays pure TS with zero added latency or Promise-wrapping), while
+ * `pixels: true` returns a `Promise<AuditReport>` that resolves once the
+ * rasterization pass completes. A caller holding a non-literal
+ * `{ pixels: someBoolean }` won't match either overload directly (TypeScript
+ * can't narrow it to one specific branch) — branch on the boolean first and
+ * call this function with a literal in each arm, e.g. `opts.pixels ? await
+ * auditDeck(ir, { pixels: true }) : auditDeck(ir)` (`cli/commands.ts`'s
+ * `runAudit` does exactly this).
+ */
+declare function auditDeck(ir: PptxIR, opts?: {
+    pixels?: false;
+}): AuditReport;
+declare function auditDeck(ir: PptxIR, opts: {
+    pixels: true;
+}): Promise<AuditReport>;
+
+/**
+ * Real rendered frame for one image slot, in canvas px (0-1280 × 0-720 —
+ * `../constants`'s `CANVAS_W_PX`/`CANVAS_H_PX`). This is the whole point of
+ * this module (asset-brief plan, 裁定 1): it comes from parsing an actual
+ * render pass's SVG output, never from hand-copying `image.tsx`'s
+ * `w * 0.5`/`MAX_IMAGE_H` constants — those change independently of this
+ * file, and a shadow copy would silently start lying the day they do.
+ */
+interface AssetBriefFrame {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** e.g. "2:1" when w:h reduces to a small clean ratio, else "1.63:1". */
+    aspect: string;
+}
+interface AssetBriefFit {
+    mode: "cover" | "contain";
+    /** One sentence: crop behavior + safe-zone guidance for a generator. */
+    note: string;
+}
+interface AssetBriefPalette {
+    /** Deduplicated theme hex values, in `StyleColors`' own field order. */
+    hexes: string[];
+    primary: string;
+    accent: string;
+}
+interface AssetBriefMood {
+    /** `ThemeDefinition.tags` passed through as-is (empty for every one of
+     *  the 13 builtins today — none has adopted this field yet — but a
+     *  registered custom theme may set it). */
+    tags: readonly string[];
+    /** One sentence assembled from the theme's own label/motif — never a
+     *  hand-written per-theme paragraph (asset-brief plan 裁定: "不新写 13 段
+     *  文案"). */
+    description: string;
+}
+interface AssetBriefPage {
+    index: number;
+    id?: string;
+    type: Slide["type"];
+    heading?: string;
+}
+interface AssetBriefItem {
+    page: AssetBriefPage;
+    asset_id: string;
+    /** `ir.assets.images[asset_id].alt` passed straight through (A11Y-01 alt
+     *  chain wave, task 1) — this is already a per-asset structure, so a
+     *  generator agent filling in `missing`/`suggested_prompt` items sees
+     *  right alongside them which ids already have an accessibility
+     *  description written and which don't. Omitted (not an empty string)
+     *  when the asset has no `alt` — same "don't fabricate a value that
+     *  isn't there" discipline the rest of this file already follows for
+     *  `frame`/`suggested_pixels`. */
+    alt?: string;
+    /** Discriminant reserved for v2 (asset-brief plan 裁定 4): only `"image"`
+     *  is produced today (one `AssetBriefItem` per `image` component, or per
+     *  shared frame — see `shared` below). `"background"` is the documented
+     *  extension slot for background asset specs, deliberately not built in
+     *  v1 (no `background` geometry extraction exists yet) — this field lets
+     *  a future v2 add it without a breaking shape change for consumers that
+     *  already switch on `kind`. */
+    kind: "image";
+    /** No usable `src` in `ir.assets.images` for this `asset_id` — this is a
+     *  generation to-do item, not a defect (asset-brief plan 裁定 2). */
+    missing: boolean;
+    /** `false` when the selected layout dropped this image component
+     *  entirely (e.g. an overflow guard) — still listed rather than silently
+     *  dropped (task brief's explicit requirement). `frame`/`suggested_pixels`
+     *  are omitted in that case; there is no real geometry to report. */
+    rendered: boolean;
+    frame?: AssetBriefFrame;
+    /** 2× the frame's own pixel dimensions — omitted alongside `frame` when `rendered` is false. */
+    suggested_pixels?: {
+        w: number;
+        h: number;
+    };
+    fit: AssetBriefFit;
+    palette: AssetBriefPalette;
+    mood: AssetBriefMood;
+    /** One English paragraph, paste-ready for an image-generation tool. */
+    suggested_prompt: string;
+    /** True when this item's `frame` cannot be attributed to one specific
+     *  `image` component: `occurrenceCount` (>=2) `image` components on this
+     *  same page share this `asset_id`. Because a shared `asset_id` resolves
+     *  to the exact same dummy href in the render-only pass, every occurrence
+     *  produces an *identical* `<image>` `href` in the rendered SVG — there is
+     *  no signal left to tell which `<image>` element came from which
+     *  component, in principle, not just in this implementation. Rather than
+     *  guess (see `buildAssetBrief`'s own doc comment for the bug this
+     *  replaced), every real rendered frame for the shared `asset_id` gets its
+     *  own item, all flagged `shared: true`, none claiming a specific
+     *  component. Omitted (not `false`) for the single-occurrence case — the
+     *  overwhelmingly common one — so that path's output shape is byte-for-
+     *  byte what it was before this field existed. */
+    shared?: true;
+    /** Present iff `shared` is true: how many `image` components on this page
+     *  reference this same `asset_id`. */
+    occurrenceCount?: number;
+}
+interface AssetBrief {
+    theme: string;
+    items: AssetBriefItem[];
+}
+/**
+ * Build an image-generation brief for every `image` component in a deck: the
+ * real rendered frame (from an actual render pass — see `extractImageFrames`),
+ * fit/crop mode with a safe-zone note, suggested generation pixels (2× the
+ * frame), the resolved theme's palette/mood, and a paste-ready English
+ * `suggested_prompt`. Pure function of `ir` (same input → same output, proven
+ * by `asset-brief.test.ts`'s double-call check) — like `auditDeck`, it never
+ * mutates its argument and never touches the filesystem or network.
+ *
+ * v1 scope (asset-brief plan 裁定 4): only `image`-typed components — not
+ * `image_grid`/`image_compare` (separate component types with their own
+ * asset_id arrays), and not `background` asset specs. Both are natural v2
+ * extensions of this same shape and are deliberately left off `AssetBrief`
+ * rather than bolted on half-done.
+ *
+ * Missing-asset handling (裁定 2): every `image` component's `asset_id`,
+ * present or not, gets overridden to the same dummy 1×1 PNG (tagged with a
+ * `#<asset_id>` fragment) in an in-memory copy of `ir` used *only* for this
+ * function's own extraction render pass — `ir` itself, and the real render/
+ * export path, never see this override. `missing` below is decided from the
+ * real `ir.assets.images` (before the override), so it still accurately
+ * reports "nothing usable was ever supplied here" even though the
+ * extraction render always has *something* to draw. Overriding every
+ * asset_id uniformly (not just the missing ones) is what makes the fragment
+ * a reliable identifier regardless of whether the real asset was already
+ * resolved — the alternative (leaving resolved assets' real `src` alone)
+ * would have no way to tell two different real images' hrefs apart when a
+ * page has more than one.
+ *
+ * Known limitation: an `asset_id` shared between an `image` component and a
+ * `background` asset spec on the same page would get the same dummy
+ * fragment on both, which could ambiguate which rendered `<image>` this
+ * function attributes to the component — rare in practice (v1 doesn't cover
+ * background geometry at all, see above) and left as a documented gap
+ * rather than engineered around.
+ *
+ * Shared-`asset_id` handling (task reviewer finding, fixed after v1's first
+ * pass): the IR schema places no uniqueness constraint on `asset_id`
+ * (`src/ir/index.ts`) — two different `image` components on the same page
+ * legally reference the same one. Because the override above (deliberately)
+ * maps a shared `asset_id` to one shared dummy href, both occurrences render
+ * an *identical* `<image href>` — the rendered SVG carries no signal left to
+ * tell them apart. (v1's first pass tried anyway: a FIFO queue keyed by
+ * `asset_id`, drained in `slide.components` order under the assumption that
+ * extraction order would match — it doesn't in general, e.g.
+ * `content-image-lead-split.tsx` renders its narrow-column body *before*
+ * its visual-lead column in the JSX it returns, so the queue was backwards
+ * and every frame ended up attributed to the wrong occurrence. Not a fixable
+ * ordering bug: no ordering convention could be relied on across every
+ * layout's own JSX emission order, present and future.) The honest fix:
+ * per page, group `image` components by `asset_id` first. A group of size 1
+ * (the overwhelmingly common case) keeps the exact single-item shape this
+ * function always produced. A group of size >1 abandons per-component
+ * attribution entirely — it emits one item per *real rendered frame* for
+ * that `asset_id` (not per component), each flagged `shared: true` with the
+ * group's `occurrenceCount`, so every real frame is still reported (nothing
+ * silently dropped) without asserting a specific component<->frame pairing
+ * that cannot be known. If fewer frames render than there are occurrences
+ * (e.g. the layout dropped one), the shortfall is padded with `rendered:
+ * false` shared items so the count of components sharing the id is still
+ * fully visible to a reader of the brief.
+ */
+declare function buildAssetBrief(ir: PptxIR): AssetBrief;
+
+export { AUDIENCE_VALUES, type AssembleResult, type AssetBrief, type AssetBriefFit, type AssetBriefFrame, type AssetBriefItem, type AssetBriefMood, type AssetBriefPage, type AssetBriefPalette, type Assets, type Audience, type AuditChecks, type AuditDeckOptions, type AuditFinding, type AuditReport, BUILTIN_THEME_IDS, type BackgroundSpec, type BrandConfig, BrandConfigSchema, type BrandThemeFile, BrandThemeFileSchema, COMPONENT_TYPES, type Component, DEFAULT_NARRATIVE, type DeckSpec, DeckSpecSchema, type ExtractBrandThemeOptions, type Meta, NARRATIVE_PRESETS, type NarrativePreset, type NarrativeProfile, PACING_BUDGETS, PACING_VALUES, type Pacing, type PacingBudget, type PageBeat, type PageContent, type PageSpec, PageSpecSchema, type PageSpecType, PptwiseError, type PptxIR, PptxIRSchema, type PptxIRV3, PptxIRV3Schema, SPEC_PAGE_COUNT_RANGE, STRATEGY_DEFINITIONS, STRATEGY_VALUES, type Slide, type SpecValidateResult, type SpecValidationIssue, type Strategy, type StrategyDefinition, type StyleOverride, StyleOverrideSchema, type ThemeDefinition, type ThemeInfo, type ThemeRegistration, ThemeSchema, VERSION, type ValidateResult, type ValidationIssue, assembleDeck, auditDeck, buildAssetBrief, disassembleDeck, extractBrandTheme, formatIssues, formatSpecIssues, generatePptx, getInstalledThemeIds, getThemeDefinition, irJsonSchema, listThemes, migrateDeckPlanToSpec, migrateIrV3ToV4, parseBrandThemeFile, registerBrandThemeFile, registerTheme, renderSlideSvg, resolveNarrative, resolveSpecThemeId, specJsonSchema, styleJsonSchema, validateIr, validateSpec };