@cueframe/kernel 0.0.1

package/dist/_members/composition/graphics-plan/schemas.d.ts

@@ -0,0 +1,1672 @@
+/**
+ * Graphics-plan IR — the structure-first authoring contract (plan
+ * 2026-07-07-structure-first-graphics-pipeline). Instead of the designer
+ * authoring Remotion JSX blind, it produces these three inspectable,
+ * versioned artifacts; a compiler turns them into brand-bound, animatable
+ * Remotion. The SAME schema is the client-agent CHECKPOINT payload AND the
+ * compiler input — no translation layer to drift.
+ *
+ * Split by concern so each stage boundary is a review/edit point:
+ *   ContentPlan  — WHAT to say (editorial, text-owned; never pixels).
+ *   LayoutPlan   — WHERE it sits (spatial structure, content-aware: element
+ *                  boxes are solved CLEAR of the face keep-outs the
+ *                  composition-floor already computes → text-over-face is
+ *                  impossible by construction, not by prompt).
+ *   MotionPlan   — HOW it animates (entrance / emphasis / exit intent).
+ *
+ * `styleRole` binds to brand tokens (never a raw hex/font) so off-brand
+ * output is impossible; the compiler resolves it via the same `$brand:`
+ * mechanism as packages/authoring/src/tools/brandTokens.ts.
+ */
+import { z } from "zod";
+/** Bump when a field's meaning changes; the compiler + checkpoint clients
+ *  branch on it. Kept a literal so an old client sees a hard mismatch, not a
+ *  silent misread. */
+export declare const GRAPHICS_PLAN_VERSION = "gp-1";
+/** A rect in output-frame fractions [0,1] — the SAME placement vocabulary as
+ *  the composition-floor `Rect` and the wire `Region` (reused so a plan box and
+ *  a rendered layer can never disagree about coordinates). */
+export declare const PlanRect: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}, {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}>;
+export type PlanRect = z.infer<typeof PlanRect>;
+/**
+ * What the beat must COMMUNICATE. An EDITORIAL vocabulary — deliberately not a list of
+ * primitive names.
+ *
+ * The first six are named after primitive families, and that was the bug: the DESIGNER's
+ * decision (which component draws this) had leaked into the PLANNER's schema. It meant the
+ * vocabulary could only grow by adding primitive names, so it could never keep up with the
+ * catalog — and on 2026-07-13 a brief demanding a chain-trace, comparison bars and a
+ * three-item build got exactly ONE lower-third, because a lower-third was close to the most
+ * the planner was ABLE to say. It was not being lazy. It had no word for what the brief wanted.
+ *
+ * The last three are the fix, and they name a JOB, not a picture:
+ *   the planner says "this beat must show a sequence"; the DESIGNER decides whether that is
+ *   `reasoning-trace`, `tool-call-stack`, or something it writes itself.
+ *
+ * Closed on purpose (the critics and the layout solver switch on it) — but closed around
+ * editorial intent, which is a small and stable set, instead of around a 103-component catalog,
+ * which is neither.
+ */
+export declare const GraphicRole: z.ZodEnum<["title-card", "stat", "lower-third", "pull-quote", "hero", "logo-tag", "enumeration", "sequence", "comparison"]>;
+export type GraphicRole = z.infer<typeof GraphicRole>;
+/**
+ * The words for a beat — ALWAYS plan-owned (a text-to-image model can't spell; the Remotion code
+ * renders these crisply). All optional; a role uses the subset it needs
+ * (stat → value+label; title-card → headline+sub; enumeration/sequence → items; comparison → series).
+ *
+ * `items` and `series` exist because the plan OWNS the words, and a role it cannot supply the
+ * words for is a role it cannot actually request. Four scalars could not carry a list or a
+ * labelled series, so even a widened role vocabulary would have had nowhere to put its content —
+ * the second half of the same 2026-07-13 bug, and the one that would have silently defeated the
+ * fix for the first half.
+ */
+export declare const Copy: z.ZodObject<{
+    headline: z.ZodOptional<z.ZodString>;
+    sub: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    /** Ordered short items — an `enumeration`'s bullets, a `sequence`'s steps. */
+    items: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Labelled values for a `comparison`.
+     *
+     * `value` is a STRING, deliberately — not `number | string`. The plan owns the words, and a
+     * comparison's words include their units: a planner writes "10 min", "98%", "$4.2M", never
+     * 600. A number would have to be re-unitised downstream by someone who doesn't know what it
+     * meant.
+     *
+     * It is also a hard constraint: `submit_compose_plan` is a STRICT Anthropic tool
+     * (`strict: true`, schemas.ts), and a `z.union` here becomes an `anyOf` in the tool schema.
+     * That is what stalled the planner on 2026-07-13 — it ran, could not satisfy the schema, and
+     * never called the tool at all. Keep every field in this schema a single concrete type.
+     */
+    series: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+    }, {
+        value: string;
+        label: string;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    value?: string | undefined;
+    sub?: string | undefined;
+    headline?: string | undefined;
+    label?: string | undefined;
+    items?: string[] | undefined;
+    series?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+}, {
+    value?: string | undefined;
+    sub?: string | undefined;
+    headline?: string | undefined;
+    label?: string | undefined;
+    items?: string[] | undefined;
+    series?: {
+        value: string;
+        label: string;
+    }[] | undefined;
+}>;
+export type Copy = z.infer<typeof Copy>;
+export declare const ContentBeat: z.ZodObject<{
+    id: z.ZodString;
+    /** Clip-relative seconds. */
+    atSec: z.ZodNumber;
+    durSec: z.ZodNumber;
+    role: z.ZodEnum<["title-card", "stat", "lower-third", "pull-quote", "hero", "logo-tag", "enumeration", "sequence", "comparison"]>;
+    copy: z.ZodObject<{
+        headline: z.ZodOptional<z.ZodString>;
+        sub: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        /** Ordered short items — an `enumeration`'s bullets, a `sequence`'s steps. */
+        items: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * Labelled values for a `comparison`.
+         *
+         * `value` is a STRING, deliberately — not `number | string`. The plan owns the words, and a
+         * comparison's words include their units: a planner writes "10 min", "98%", "$4.2M", never
+         * 600. A number would have to be re-unitised downstream by someone who doesn't know what it
+         * meant.
+         *
+         * It is also a hard constraint: `submit_compose_plan` is a STRICT Anthropic tool
+         * (`strict: true`, schemas.ts), and a `z.union` here becomes an `anyOf` in the tool schema.
+         * That is what stalled the planner on 2026-07-13 — it ran, could not satisfy the schema, and
+         * never called the tool at all. Keep every field in this schema a single concrete type.
+         */
+        series: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+        }, {
+            value: string;
+            label: string;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        value?: string | undefined;
+        sub?: string | undefined;
+        headline?: string | undefined;
+        label?: string | undefined;
+        items?: string[] | undefined;
+        series?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+    }, {
+        value?: string | undefined;
+        sub?: string | undefined;
+        headline?: string | undefined;
+        label?: string | undefined;
+        items?: string[] | undefined;
+        series?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+    }>;
+    /** Editorial WHY — the beat this graphic serves (for review + the judge). */
+    intent: z.ZodString;
+    /** Higher = more important; drives drop order under budget. */
+    priority: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    intent: string;
+    atSec: number;
+    durSec: number;
+    role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+    copy: {
+        value?: string | undefined;
+        sub?: string | undefined;
+        headline?: string | undefined;
+        label?: string | undefined;
+        items?: string[] | undefined;
+        series?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+    };
+    priority: number;
+}, {
+    id: string;
+    intent: string;
+    atSec: number;
+    durSec: number;
+    role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+    copy: {
+        value?: string | undefined;
+        sub?: string | undefined;
+        headline?: string | undefined;
+        label?: string | undefined;
+        items?: string[] | undefined;
+        series?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+    };
+    priority?: number | undefined;
+}>;
+export type ContentBeat = z.infer<typeof ContentBeat>;
+export declare const ContentPlan: z.ZodObject<{
+    version: z.ZodLiteral<"gp-1">;
+    beats: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        /** Clip-relative seconds. */
+        atSec: z.ZodNumber;
+        durSec: z.ZodNumber;
+        role: z.ZodEnum<["title-card", "stat", "lower-third", "pull-quote", "hero", "logo-tag", "enumeration", "sequence", "comparison"]>;
+        copy: z.ZodObject<{
+            headline: z.ZodOptional<z.ZodString>;
+            sub: z.ZodOptional<z.ZodString>;
+            value: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            /** Ordered short items — an `enumeration`'s bullets, a `sequence`'s steps. */
+            items: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /**
+             * Labelled values for a `comparison`.
+             *
+             * `value` is a STRING, deliberately — not `number | string`. The plan owns the words, and a
+             * comparison's words include their units: a planner writes "10 min", "98%", "$4.2M", never
+             * 600. A number would have to be re-unitised downstream by someone who doesn't know what it
+             * meant.
+             *
+             * It is also a hard constraint: `submit_compose_plan` is a STRICT Anthropic tool
+             * (`strict: true`, schemas.ts), and a `z.union` here becomes an `anyOf` in the tool schema.
+             * That is what stalled the planner on 2026-07-13 — it ran, could not satisfy the schema, and
+             * never called the tool at all. Keep every field in this schema a single concrete type.
+             */
+            series: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                label: string;
+            }, {
+                value: string;
+                label: string;
+            }>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        }, {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        }>;
+        /** Editorial WHY — the beat this graphic serves (for review + the judge). */
+        intent: z.ZodString;
+        /** Higher = more important; drives drop order under budget. */
+        priority: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        intent: string;
+        atSec: number;
+        durSec: number;
+        role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+        copy: {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        };
+        priority: number;
+    }, {
+        id: string;
+        intent: string;
+        atSec: number;
+        durSec: number;
+        role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+        copy: {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        };
+        priority?: number | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    version: "gp-1";
+    beats: {
+        id: string;
+        intent: string;
+        atSec: number;
+        durSec: number;
+        role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+        copy: {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        };
+        priority: number;
+    }[];
+}, {
+    version: "gp-1";
+    beats: {
+        id: string;
+        intent: string;
+        atSec: number;
+        durSec: number;
+        role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+        copy: {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        };
+        priority?: number | undefined;
+    }[];
+}>;
+export type ContentPlan = z.infer<typeof ContentPlan>;
+/** The role of ONE element within a graphic — maps to a primitive slot. */
+export declare const ElementRole: z.ZodEnum<["headline", "value", "label", "sublabel", "logo", "accent-shape", "backdrop"]>;
+export type ElementRole = z.infer<typeof ElementRole>;
+/** Semantic style binding → resolved to `$brand:` refs by the compiler; NEVER a
+ *  raw hex/font. This is the guarantee that on-brand is the only option.
+ *  Mapping (compiler): heading→fonts.heading+colors.text, accent→colors.accent,
+ *  body→fonts.body+colors.text, surface→colors.surface/background,
+ *  on-accent→colors.textOnAccent, on-surface→colors.textOnSurface. */
+export declare const StyleRole: z.ZodEnum<["heading", "body", "accent", "surface", "on-accent", "on-surface"]>;
+export type StyleRole = z.infer<typeof StyleRole>;
+/** Depth plane — matches OverlayClipSource.zPlane. `behind-subject` is the
+ *  intentional hero look (the subject cut-out bites the letters). */
+export declare const ZPlane: z.ZodEnum<["front", "behind-subject"]>;
+export type ZPlane = z.infer<typeof ZPlane>;
+export declare const LayoutElement: z.ZodObject<{
+    elId: z.ZodString;
+    role: z.ZodEnum<["headline", "value", "label", "sublabel", "logo", "accent-shape", "backdrop"]>;
+    /** Solved CLEAR of `keepOut` (except intentional behind-subject heroes). */
+    box: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }, {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+    styleRole: z.ZodEnum<["heading", "body", "accent", "surface", "on-accent", "on-surface"]>;
+    z: z.ZodDefault<z.ZodEnum<["front", "behind-subject"]>>;
+    /** The text this element renders (from the ContentPlan). Omitted for
+     *  logo / accent-shape / backdrop. */
+    text: z.ZodOptional<z.ZodString>;
+    /** Index into the editorial type scale (mirrors composition-floor
+     *  Treatment.typeScaleStep) — a SCALE STEP, not a raw px guess. */
+    typeScaleStep: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+    elId: string;
+    box: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+    z: "front" | "behind-subject";
+    text?: string | undefined;
+    typeScaleStep?: number | undefined;
+}, {
+    role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+    elId: string;
+    box: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+    text?: string | undefined;
+    z?: "front" | "behind-subject" | undefined;
+    typeScaleStep?: number | undefined;
+}>;
+export type LayoutElement = z.infer<typeof LayoutElement>;
+export declare const LayoutPlan: z.ZodEffects<z.ZodObject<{
+    version: z.ZodLiteral<"gp-1">;
+    beatId: z.ZodString;
+    /** Output aspect context (pixels); placement itself is in [0,1] fractions. */
+    frame: z.ZodObject<{
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        w: number;
+        h: number;
+    }, {
+        w: number;
+        h: number;
+    }>;
+    /** INPUT (not authored): face keep-out rects at this beat, from the
+     *  composition-floor. The layout stage MUST place `front` elements clear of
+     *  these — carried on the plan so a reviewer/compiler can verify it. */
+    keepOut: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }, {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>, "many">;
+    /** INPUT: safe-zone insets (title-safe / action-safe fractions). */
+    safe: z.ZodObject<{
+        titleSafe: z.ZodNumber;
+        actionSafe: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        titleSafe: number;
+        actionSafe: number;
+    }, {
+        titleSafe: number;
+        actionSafe: number;
+    }>;
+    elements: z.ZodArray<z.ZodObject<{
+        elId: z.ZodString;
+        role: z.ZodEnum<["headline", "value", "label", "sublabel", "logo", "accent-shape", "backdrop"]>;
+        /** Solved CLEAR of `keepOut` (except intentional behind-subject heroes). */
+        box: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }, {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }>;
+        styleRole: z.ZodEnum<["heading", "body", "accent", "surface", "on-accent", "on-surface"]>;
+        z: z.ZodDefault<z.ZodEnum<["front", "behind-subject"]>>;
+        /** The text this element renders (from the ContentPlan). Omitted for
+         *  logo / accent-shape / backdrop. */
+        text: z.ZodOptional<z.ZodString>;
+        /** Index into the editorial type scale (mirrors composition-floor
+         *  Treatment.typeScaleStep) — a SCALE STEP, not a raw px guess. */
+        typeScaleStep: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+        elId: string;
+        box: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+        z: "front" | "behind-subject";
+        text?: string | undefined;
+        typeScaleStep?: number | undefined;
+    }, {
+        role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+        elId: string;
+        box: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+        text?: string | undefined;
+        z?: "front" | "behind-subject" | undefined;
+        typeScaleStep?: number | undefined;
+    }>, "many">;
+    /** Set when the solver could NOT place a beat's graphic legally (e.g. the
+     *  face fills the legal area). Makes a drop OBSERVABLE — distinct from a
+     *  beat that legitimately had no copy (both yield elements:[]). The producer
+     *  can surface it; the compiler skips it. */
+    dropped: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        reason: string;
+    }, {
+        reason: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    version: "gp-1";
+    beatId: string;
+    frame: {
+        w: number;
+        h: number;
+    };
+    keepOut: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }[];
+    safe: {
+        titleSafe: number;
+        actionSafe: number;
+    };
+    elements: {
+        role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+        elId: string;
+        box: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+        z: "front" | "behind-subject";
+        text?: string | undefined;
+        typeScaleStep?: number | undefined;
+    }[];
+    dropped?: {
+        reason: string;
+    } | undefined;
+}, {
+    version: "gp-1";
+    beatId: string;
+    frame: {
+        w: number;
+        h: number;
+    };
+    keepOut: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }[];
+    safe: {
+        titleSafe: number;
+        actionSafe: number;
+    };
+    elements: {
+        role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+        elId: string;
+        box: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+        text?: string | undefined;
+        z?: "front" | "behind-subject" | undefined;
+        typeScaleStep?: number | undefined;
+    }[];
+    dropped?: {
+        reason: string;
+    } | undefined;
+}>, {
+    version: "gp-1";
+    beatId: string;
+    frame: {
+        w: number;
+        h: number;
+    };
+    keepOut: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }[];
+    safe: {
+        titleSafe: number;
+        actionSafe: number;
+    };
+    elements: {
+        role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+        elId: string;
+        box: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+        z: "front" | "behind-subject";
+        text?: string | undefined;
+        typeScaleStep?: number | undefined;
+    }[];
+    dropped?: {
+        reason: string;
+    } | undefined;
+}, {
+    version: "gp-1";
+    beatId: string;
+    frame: {
+        w: number;
+        h: number;
+    };
+    keepOut: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }[];
+    safe: {
+        titleSafe: number;
+        actionSafe: number;
+    };
+    elements: {
+        role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+        elId: string;
+        box: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+        text?: string | undefined;
+        z?: "front" | "behind-subject" | undefined;
+        typeScaleStep?: number | undefined;
+    }[];
+    dropped?: {
+        reason: string;
+    } | undefined;
+}>;
+export type LayoutPlan = z.infer<typeof LayoutPlan>;
+export declare const EnterType: z.ZodEnum<["reveal", "fade", "rise", "count-up", "wipe"]>;
+export type EnterType = z.infer<typeof EnterType>;
+export declare const EmphasisType: z.ZodEnum<["pulse", "underline", "color-shift"]>;
+export type EmphasisType = z.infer<typeof EmphasisType>;
+export declare const ExitType: z.ZodEnum<["fade", "fall", "wipe", "cut"]>;
+export type ExitType = z.infer<typeof ExitType>;
+/** Ease vocabulary → compiler maps to real spring/interpolate. Named, not raw
+ *  bezier/ms, so the brand's motion pace stays a decision not a magic number. */
+export declare const Ease: z.ZodEnum<["spring", "ease-out", "ease-in-out", "linear"]>;
+export type Ease = z.infer<typeof Ease>;
+export declare const EnterMotion: z.ZodObject<{
+    type: z.ZodEnum<["reveal", "fade", "rise", "count-up", "wipe"]>;
+    atMs: z.ZodNumber;
+    durMs: z.ZodNumber;
+    ease: z.ZodDefault<z.ZodEnum<["spring", "ease-out", "ease-in-out", "linear"]>>;
+    /** Per-child stagger (ms) for multi-part reveals. */
+    stagger: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+    ease: "linear" | "spring" | "ease-out" | "ease-in-out";
+    atMs: number;
+    durMs: number;
+    stagger?: number | undefined;
+}, {
+    type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+    atMs: number;
+    durMs: number;
+    ease?: "linear" | "spring" | "ease-out" | "ease-in-out" | undefined;
+    stagger?: number | undefined;
+}>;
+export declare const EmphasisMotion: z.ZodObject<{
+    type: z.ZodEnum<["pulse", "underline", "color-shift"]>;
+    atMs: z.ZodNumber;
+    durMs: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    type: "underline" | "pulse" | "color-shift";
+    atMs: number;
+    durMs: number;
+}, {
+    type: "underline" | "pulse" | "color-shift";
+    atMs: number;
+    durMs: number;
+}>;
+export declare const ExitMotion: z.ZodObject<{
+    type: z.ZodEnum<["fade", "fall", "wipe", "cut"]>;
+    atMs: z.ZodNumber;
+    durMs: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    type: "fade" | "wipe" | "fall" | "cut";
+    atMs: number;
+    durMs: number;
+}, {
+    type: "fade" | "wipe" | "fall" | "cut";
+    atMs: number;
+    durMs: number;
+}>;
+export declare const MotionElement: z.ZodObject<{
+    elId: z.ZodString;
+    enter: z.ZodObject<{
+        type: z.ZodEnum<["reveal", "fade", "rise", "count-up", "wipe"]>;
+        atMs: z.ZodNumber;
+        durMs: z.ZodNumber;
+        ease: z.ZodDefault<z.ZodEnum<["spring", "ease-out", "ease-in-out", "linear"]>>;
+        /** Per-child stagger (ms) for multi-part reveals. */
+        stagger: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+        ease: "linear" | "spring" | "ease-out" | "ease-in-out";
+        atMs: number;
+        durMs: number;
+        stagger?: number | undefined;
+    }, {
+        type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+        atMs: number;
+        durMs: number;
+        ease?: "linear" | "spring" | "ease-out" | "ease-in-out" | undefined;
+        stagger?: number | undefined;
+    }>;
+    emphasis: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["pulse", "underline", "color-shift"]>;
+        atMs: z.ZodNumber;
+        durMs: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        type: "underline" | "pulse" | "color-shift";
+        atMs: number;
+        durMs: number;
+    }, {
+        type: "underline" | "pulse" | "color-shift";
+        atMs: number;
+        durMs: number;
+    }>>;
+    exit: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["fade", "fall", "wipe", "cut"]>;
+        atMs: z.ZodNumber;
+        durMs: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        type: "fade" | "wipe" | "fall" | "cut";
+        atMs: number;
+        durMs: number;
+    }, {
+        type: "fade" | "wipe" | "fall" | "cut";
+        atMs: number;
+        durMs: number;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    elId: string;
+    enter: {
+        type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+        ease: "linear" | "spring" | "ease-out" | "ease-in-out";
+        atMs: number;
+        durMs: number;
+        stagger?: number | undefined;
+    };
+    emphasis?: {
+        type: "underline" | "pulse" | "color-shift";
+        atMs: number;
+        durMs: number;
+    } | undefined;
+    exit?: {
+        type: "fade" | "wipe" | "fall" | "cut";
+        atMs: number;
+        durMs: number;
+    } | undefined;
+}, {
+    elId: string;
+    enter: {
+        type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+        atMs: number;
+        durMs: number;
+        ease?: "linear" | "spring" | "ease-out" | "ease-in-out" | undefined;
+        stagger?: number | undefined;
+    };
+    emphasis?: {
+        type: "underline" | "pulse" | "color-shift";
+        atMs: number;
+        durMs: number;
+    } | undefined;
+    exit?: {
+        type: "fade" | "wipe" | "fall" | "cut";
+        atMs: number;
+        durMs: number;
+    } | undefined;
+}>;
+export type MotionElement = z.infer<typeof MotionElement>;
+export declare const MotionPlan: z.ZodObject<{
+    version: z.ZodLiteral<"gp-1">;
+    beatId: z.ZodString;
+    elements: z.ZodArray<z.ZodObject<{
+        elId: z.ZodString;
+        enter: z.ZodObject<{
+            type: z.ZodEnum<["reveal", "fade", "rise", "count-up", "wipe"]>;
+            atMs: z.ZodNumber;
+            durMs: z.ZodNumber;
+            ease: z.ZodDefault<z.ZodEnum<["spring", "ease-out", "ease-in-out", "linear"]>>;
+            /** Per-child stagger (ms) for multi-part reveals. */
+            stagger: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+            ease: "linear" | "spring" | "ease-out" | "ease-in-out";
+            atMs: number;
+            durMs: number;
+            stagger?: number | undefined;
+        }, {
+            type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+            atMs: number;
+            durMs: number;
+            ease?: "linear" | "spring" | "ease-out" | "ease-in-out" | undefined;
+            stagger?: number | undefined;
+        }>;
+        emphasis: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<["pulse", "underline", "color-shift"]>;
+            atMs: z.ZodNumber;
+            durMs: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            type: "underline" | "pulse" | "color-shift";
+            atMs: number;
+            durMs: number;
+        }, {
+            type: "underline" | "pulse" | "color-shift";
+            atMs: number;
+            durMs: number;
+        }>>;
+        exit: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<["fade", "fall", "wipe", "cut"]>;
+            atMs: z.ZodNumber;
+            durMs: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            type: "fade" | "wipe" | "fall" | "cut";
+            atMs: number;
+            durMs: number;
+        }, {
+            type: "fade" | "wipe" | "fall" | "cut";
+            atMs: number;
+            durMs: number;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        elId: string;
+        enter: {
+            type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+            ease: "linear" | "spring" | "ease-out" | "ease-in-out";
+            atMs: number;
+            durMs: number;
+            stagger?: number | undefined;
+        };
+        emphasis?: {
+            type: "underline" | "pulse" | "color-shift";
+            atMs: number;
+            durMs: number;
+        } | undefined;
+        exit?: {
+            type: "fade" | "wipe" | "fall" | "cut";
+            atMs: number;
+            durMs: number;
+        } | undefined;
+    }, {
+        elId: string;
+        enter: {
+            type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+            atMs: number;
+            durMs: number;
+            ease?: "linear" | "spring" | "ease-out" | "ease-in-out" | undefined;
+            stagger?: number | undefined;
+        };
+        emphasis?: {
+            type: "underline" | "pulse" | "color-shift";
+            atMs: number;
+            durMs: number;
+        } | undefined;
+        exit?: {
+            type: "fade" | "wipe" | "fall" | "cut";
+            atMs: number;
+            durMs: number;
+        } | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    version: "gp-1";
+    beatId: string;
+    elements: {
+        elId: string;
+        enter: {
+            type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+            ease: "linear" | "spring" | "ease-out" | "ease-in-out";
+            atMs: number;
+            durMs: number;
+            stagger?: number | undefined;
+        };
+        emphasis?: {
+            type: "underline" | "pulse" | "color-shift";
+            atMs: number;
+            durMs: number;
+        } | undefined;
+        exit?: {
+            type: "fade" | "wipe" | "fall" | "cut";
+            atMs: number;
+            durMs: number;
+        } | undefined;
+    }[];
+}, {
+    version: "gp-1";
+    beatId: string;
+    elements: {
+        elId: string;
+        enter: {
+            type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+            atMs: number;
+            durMs: number;
+            ease?: "linear" | "spring" | "ease-out" | "ease-in-out" | undefined;
+            stagger?: number | undefined;
+        };
+        emphasis?: {
+            type: "underline" | "pulse" | "color-shift";
+            atMs: number;
+            durMs: number;
+        } | undefined;
+        exit?: {
+            type: "fade" | "wipe" | "fall" | "cut";
+            atMs: number;
+            durMs: number;
+        } | undefined;
+    }[];
+}>;
+export type MotionPlan = z.infer<typeof MotionPlan>;
+/** The full graphics plan for a compose run: one ContentPlan, and a
+ *  Layout+Motion pair per beat (keyed by beatId). This is the object a
+ *  checkpoint returns and the compiler consumes. */
+export declare const GraphicsPlan: z.ZodObject<{
+    version: z.ZodLiteral<"gp-1">;
+    content: z.ZodObject<{
+        version: z.ZodLiteral<"gp-1">;
+        beats: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            /** Clip-relative seconds. */
+            atSec: z.ZodNumber;
+            durSec: z.ZodNumber;
+            role: z.ZodEnum<["title-card", "stat", "lower-third", "pull-quote", "hero", "logo-tag", "enumeration", "sequence", "comparison"]>;
+            copy: z.ZodObject<{
+                headline: z.ZodOptional<z.ZodString>;
+                sub: z.ZodOptional<z.ZodString>;
+                value: z.ZodOptional<z.ZodString>;
+                label: z.ZodOptional<z.ZodString>;
+                /** Ordered short items — an `enumeration`'s bullets, a `sequence`'s steps. */
+                items: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                /**
+                 * Labelled values for a `comparison`.
+                 *
+                 * `value` is a STRING, deliberately — not `number | string`. The plan owns the words, and a
+                 * comparison's words include their units: a planner writes "10 min", "98%", "$4.2M", never
+                 * 600. A number would have to be re-unitised downstream by someone who doesn't know what it
+                 * meant.
+                 *
+                 * It is also a hard constraint: `submit_compose_plan` is a STRICT Anthropic tool
+                 * (`strict: true`, schemas.ts), and a `z.union` here becomes an `anyOf` in the tool schema.
+                 * That is what stalled the planner on 2026-07-13 — it ran, could not satisfy the schema, and
+                 * never called the tool at all. Keep every field in this schema a single concrete type.
+                 */
+                series: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    value: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    value: string;
+                    label: string;
+                }, {
+                    value: string;
+                    label: string;
+                }>, "many">>;
+            }, "strict", z.ZodTypeAny, {
+                value?: string | undefined;
+                sub?: string | undefined;
+                headline?: string | undefined;
+                label?: string | undefined;
+                items?: string[] | undefined;
+                series?: {
+                    value: string;
+                    label: string;
+                }[] | undefined;
+            }, {
+                value?: string | undefined;
+                sub?: string | undefined;
+                headline?: string | undefined;
+                label?: string | undefined;
+                items?: string[] | undefined;
+                series?: {
+                    value: string;
+                    label: string;
+                }[] | undefined;
+            }>;
+            /** Editorial WHY — the beat this graphic serves (for review + the judge). */
+            intent: z.ZodString;
+            /** Higher = more important; drives drop order under budget. */
+            priority: z.ZodDefault<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            id: string;
+            intent: string;
+            atSec: number;
+            durSec: number;
+            role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+            copy: {
+                value?: string | undefined;
+                sub?: string | undefined;
+                headline?: string | undefined;
+                label?: string | undefined;
+                items?: string[] | undefined;
+                series?: {
+                    value: string;
+                    label: string;
+                }[] | undefined;
+            };
+            priority: number;
+        }, {
+            id: string;
+            intent: string;
+            atSec: number;
+            durSec: number;
+            role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+            copy: {
+                value?: string | undefined;
+                sub?: string | undefined;
+                headline?: string | undefined;
+                label?: string | undefined;
+                items?: string[] | undefined;
+                series?: {
+                    value: string;
+                    label: string;
+                }[] | undefined;
+            };
+            priority?: number | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        version: "gp-1";
+        beats: {
+            id: string;
+            intent: string;
+            atSec: number;
+            durSec: number;
+            role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+            copy: {
+                value?: string | undefined;
+                sub?: string | undefined;
+                headline?: string | undefined;
+                label?: string | undefined;
+                items?: string[] | undefined;
+                series?: {
+                    value: string;
+                    label: string;
+                }[] | undefined;
+            };
+            priority: number;
+        }[];
+    }, {
+        version: "gp-1";
+        beats: {
+            id: string;
+            intent: string;
+            atSec: number;
+            durSec: number;
+            role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+            copy: {
+                value?: string | undefined;
+                sub?: string | undefined;
+                headline?: string | undefined;
+                label?: string | undefined;
+                items?: string[] | undefined;
+                series?: {
+                    value: string;
+                    label: string;
+                }[] | undefined;
+            };
+            priority?: number | undefined;
+        }[];
+    }>;
+    layouts: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        version: z.ZodLiteral<"gp-1">;
+        beatId: z.ZodString;
+        /** Output aspect context (pixels); placement itself is in [0,1] fractions. */
+        frame: z.ZodObject<{
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            w: number;
+            h: number;
+        }, {
+            w: number;
+            h: number;
+        }>;
+        /** INPUT (not authored): face keep-out rects at this beat, from the
+         *  composition-floor. The layout stage MUST place `front` elements clear of
+         *  these — carried on the plan so a reviewer/compiler can verify it. */
+        keepOut: z.ZodArray<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }, {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }>, "many">;
+        /** INPUT: safe-zone insets (title-safe / action-safe fractions). */
+        safe: z.ZodObject<{
+            titleSafe: z.ZodNumber;
+            actionSafe: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            titleSafe: number;
+            actionSafe: number;
+        }, {
+            titleSafe: number;
+            actionSafe: number;
+        }>;
+        elements: z.ZodArray<z.ZodObject<{
+            elId: z.ZodString;
+            role: z.ZodEnum<["headline", "value", "label", "sublabel", "logo", "accent-shape", "backdrop"]>;
+            /** Solved CLEAR of `keepOut` (except intentional behind-subject heroes). */
+            box: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            }, {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            }>;
+            styleRole: z.ZodEnum<["heading", "body", "accent", "surface", "on-accent", "on-surface"]>;
+            z: z.ZodDefault<z.ZodEnum<["front", "behind-subject"]>>;
+            /** The text this element renders (from the ContentPlan). Omitted for
+             *  logo / accent-shape / backdrop. */
+            text: z.ZodOptional<z.ZodString>;
+            /** Index into the editorial type scale (mirrors composition-floor
+             *  Treatment.typeScaleStep) — a SCALE STEP, not a raw px guess. */
+            typeScaleStep: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+            elId: string;
+            box: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+            styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+            z: "front" | "behind-subject";
+            text?: string | undefined;
+            typeScaleStep?: number | undefined;
+        }, {
+            role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+            elId: string;
+            box: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+            styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+            text?: string | undefined;
+            z?: "front" | "behind-subject" | undefined;
+            typeScaleStep?: number | undefined;
+        }>, "many">;
+        /** Set when the solver could NOT place a beat's graphic legally (e.g. the
+         *  face fills the legal area). Makes a drop OBSERVABLE — distinct from a
+         *  beat that legitimately had no copy (both yield elements:[]). The producer
+         *  can surface it; the compiler skips it. */
+        dropped: z.ZodOptional<z.ZodObject<{
+            reason: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            reason: string;
+        }, {
+            reason: string;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        version: "gp-1";
+        beatId: string;
+        frame: {
+            w: number;
+            h: number;
+        };
+        keepOut: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }[];
+        safe: {
+            titleSafe: number;
+            actionSafe: number;
+        };
+        elements: {
+            role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+            elId: string;
+            box: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+            styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+            z: "front" | "behind-subject";
+            text?: string | undefined;
+            typeScaleStep?: number | undefined;
+        }[];
+        dropped?: {
+            reason: string;
+        } | undefined;
+    }, {
+        version: "gp-1";
+        beatId: string;
+        frame: {
+            w: number;
+            h: number;
+        };
+        keepOut: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }[];
+        safe: {
+            titleSafe: number;
+            actionSafe: number;
+        };
+        elements: {
+            role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+            elId: string;
+            box: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+            styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+            text?: string | undefined;
+            z?: "front" | "behind-subject" | undefined;
+            typeScaleStep?: number | undefined;
+        }[];
+        dropped?: {
+            reason: string;
+        } | undefined;
+    }>, {
+        version: "gp-1";
+        beatId: string;
+        frame: {
+            w: number;
+            h: number;
+        };
+        keepOut: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }[];
+        safe: {
+            titleSafe: number;
+            actionSafe: number;
+        };
+        elements: {
+            role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+            elId: string;
+            box: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+            styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+            z: "front" | "behind-subject";
+            text?: string | undefined;
+            typeScaleStep?: number | undefined;
+        }[];
+        dropped?: {
+            reason: string;
+        } | undefined;
+    }, {
+        version: "gp-1";
+        beatId: string;
+        frame: {
+            w: number;
+            h: number;
+        };
+        keepOut: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }[];
+        safe: {
+            titleSafe: number;
+            actionSafe: number;
+        };
+        elements: {
+            role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+            elId: string;
+            box: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+            styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+            text?: string | undefined;
+            z?: "front" | "behind-subject" | undefined;
+            typeScaleStep?: number | undefined;
+        }[];
+        dropped?: {
+            reason: string;
+        } | undefined;
+    }>, "many">;
+    motions: z.ZodArray<z.ZodObject<{
+        version: z.ZodLiteral<"gp-1">;
+        beatId: z.ZodString;
+        elements: z.ZodArray<z.ZodObject<{
+            elId: z.ZodString;
+            enter: z.ZodObject<{
+                type: z.ZodEnum<["reveal", "fade", "rise", "count-up", "wipe"]>;
+                atMs: z.ZodNumber;
+                durMs: z.ZodNumber;
+                ease: z.ZodDefault<z.ZodEnum<["spring", "ease-out", "ease-in-out", "linear"]>>;
+                /** Per-child stagger (ms) for multi-part reveals. */
+                stagger: z.ZodOptional<z.ZodNumber>;
+            }, "strict", z.ZodTypeAny, {
+                type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+                ease: "linear" | "spring" | "ease-out" | "ease-in-out";
+                atMs: number;
+                durMs: number;
+                stagger?: number | undefined;
+            }, {
+                type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+                atMs: number;
+                durMs: number;
+                ease?: "linear" | "spring" | "ease-out" | "ease-in-out" | undefined;
+                stagger?: number | undefined;
+            }>;
+            emphasis: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<["pulse", "underline", "color-shift"]>;
+                atMs: z.ZodNumber;
+                durMs: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                type: "underline" | "pulse" | "color-shift";
+                atMs: number;
+                durMs: number;
+            }, {
+                type: "underline" | "pulse" | "color-shift";
+                atMs: number;
+                durMs: number;
+            }>>;
+            exit: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<["fade", "fall", "wipe", "cut"]>;
+                atMs: z.ZodNumber;
+                durMs: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                type: "fade" | "wipe" | "fall" | "cut";
+                atMs: number;
+                durMs: number;
+            }, {
+                type: "fade" | "wipe" | "fall" | "cut";
+                atMs: number;
+                durMs: number;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            elId: string;
+            enter: {
+                type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+                ease: "linear" | "spring" | "ease-out" | "ease-in-out";
+                atMs: number;
+                durMs: number;
+                stagger?: number | undefined;
+            };
+            emphasis?: {
+                type: "underline" | "pulse" | "color-shift";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+            exit?: {
+                type: "fade" | "wipe" | "fall" | "cut";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+        }, {
+            elId: string;
+            enter: {
+                type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+                atMs: number;
+                durMs: number;
+                ease?: "linear" | "spring" | "ease-out" | "ease-in-out" | undefined;
+                stagger?: number | undefined;
+            };
+            emphasis?: {
+                type: "underline" | "pulse" | "color-shift";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+            exit?: {
+                type: "fade" | "wipe" | "fall" | "cut";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        version: "gp-1";
+        beatId: string;
+        elements: {
+            elId: string;
+            enter: {
+                type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+                ease: "linear" | "spring" | "ease-out" | "ease-in-out";
+                atMs: number;
+                durMs: number;
+                stagger?: number | undefined;
+            };
+            emphasis?: {
+                type: "underline" | "pulse" | "color-shift";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+            exit?: {
+                type: "fade" | "wipe" | "fall" | "cut";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+        }[];
+    }, {
+        version: "gp-1";
+        beatId: string;
+        elements: {
+            elId: string;
+            enter: {
+                type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+                atMs: number;
+                durMs: number;
+                ease?: "linear" | "spring" | "ease-out" | "ease-in-out" | undefined;
+                stagger?: number | undefined;
+            };
+            emphasis?: {
+                type: "underline" | "pulse" | "color-shift";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+            exit?: {
+                type: "fade" | "wipe" | "fall" | "cut";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+        }[];
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    version: "gp-1";
+    content: {
+        version: "gp-1";
+        beats: {
+            id: string;
+            intent: string;
+            atSec: number;
+            durSec: number;
+            role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+            copy: {
+                value?: string | undefined;
+                sub?: string | undefined;
+                headline?: string | undefined;
+                label?: string | undefined;
+                items?: string[] | undefined;
+                series?: {
+                    value: string;
+                    label: string;
+                }[] | undefined;
+            };
+            priority: number;
+        }[];
+    };
+    layouts: {
+        version: "gp-1";
+        beatId: string;
+        frame: {
+            w: number;
+            h: number;
+        };
+        keepOut: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }[];
+        safe: {
+            titleSafe: number;
+            actionSafe: number;
+        };
+        elements: {
+            role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+            elId: string;
+            box: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+            styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+            z: "front" | "behind-subject";
+            text?: string | undefined;
+            typeScaleStep?: number | undefined;
+        }[];
+        dropped?: {
+            reason: string;
+        } | undefined;
+    }[];
+    motions: {
+        version: "gp-1";
+        beatId: string;
+        elements: {
+            elId: string;
+            enter: {
+                type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+                ease: "linear" | "spring" | "ease-out" | "ease-in-out";
+                atMs: number;
+                durMs: number;
+                stagger?: number | undefined;
+            };
+            emphasis?: {
+                type: "underline" | "pulse" | "color-shift";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+            exit?: {
+                type: "fade" | "wipe" | "fall" | "cut";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+        }[];
+    }[];
+}, {
+    version: "gp-1";
+    content: {
+        version: "gp-1";
+        beats: {
+            id: string;
+            intent: string;
+            atSec: number;
+            durSec: number;
+            role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+            copy: {
+                value?: string | undefined;
+                sub?: string | undefined;
+                headline?: string | undefined;
+                label?: string | undefined;
+                items?: string[] | undefined;
+                series?: {
+                    value: string;
+                    label: string;
+                }[] | undefined;
+            };
+            priority?: number | undefined;
+        }[];
+    };
+    layouts: {
+        version: "gp-1";
+        beatId: string;
+        frame: {
+            w: number;
+            h: number;
+        };
+        keepOut: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        }[];
+        safe: {
+            titleSafe: number;
+            actionSafe: number;
+        };
+        elements: {
+            role: "value" | "headline" | "label" | "sublabel" | "logo" | "accent-shape" | "backdrop";
+            elId: string;
+            box: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+            styleRole: "heading" | "body" | "accent" | "surface" | "on-accent" | "on-surface";
+            text?: string | undefined;
+            z?: "front" | "behind-subject" | undefined;
+            typeScaleStep?: number | undefined;
+        }[];
+        dropped?: {
+            reason: string;
+        } | undefined;
+    }[];
+    motions: {
+        version: "gp-1";
+        beatId: string;
+        elements: {
+            elId: string;
+            enter: {
+                type: "fade" | "reveal" | "rise" | "count-up" | "wipe";
+                atMs: number;
+                durMs: number;
+                ease?: "linear" | "spring" | "ease-out" | "ease-in-out" | undefined;
+                stagger?: number | undefined;
+            };
+            emphasis?: {
+                type: "underline" | "pulse" | "color-shift";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+            exit?: {
+                type: "fade" | "wipe" | "fall" | "cut";
+                atMs: number;
+                durMs: number;
+            } | undefined;
+        }[];
+    }[];
+}>;
+export type GraphicsPlan = z.infer<typeof GraphicsPlan>;