vidspotai-shared 1.0.92 → 1.0.93

package/lib/schemas/demoSpec.schema.js

@@ -0,0 +1,276 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DemoSpecSchema = exports.DemoSceneSchema = exports.ChatTurnSchema = exports.DemoCardSchema = exports.StatSchema = exports.SceneCaptionSchema = exports.DemoStyleSchema = exports.VisualStyleSchema = exports.DemoBrandSchema = exports.DEMO_SPEC_SCHEMA_VERSION = void 0;
+exports.demoSpecDurationMs = demoSpecDurationMs;
+const zod_1 = require("zod");
+const project_schema_1 = require("./project.schema");
+const brandKit_schema_1 = require("./brandKit.schema");
+/**
+ * DemoSpec — the canonical, editable contract for an autonomous SaaS product-demo video.
+ *
+ * This is the single source of truth shared by:
+ *   - the LLM author (Claude produces this via `.structured<DemoSpec>()` from the user's
+ *     brand + features + screenshots + wizard answers)
+ *   - the demo render engine (Remotion scene-template library consumes this -> MP4)
+ *   - the persistence/editor layer (stored on `demoVideoProjects.demoSpec`; "change X"
+ *     requests patch this and re-render — this is the "keep the source so you can edit
+ *     later" requirement, structured instead of exported HTML)
+ *   - the script/voiceover stage (reads the scene timeline + narration hints)
+ *
+ * Two render paths share this one contract (the "hybrid engine" decision):
+ *   - Path A — parametric scene-template components (scene `type` !== "custom")
+ *   - Path B — arbitrary Remotion TSX authored by the LLM (scene `type` === "custom"),
+ *     dynamically bundled + sandboxed. Additive — Path A ignores `custom` scenes' tsx.
+ *
+ * Fields evolve forward only. Add new optional fields; never repurpose existing ones.
+ * Bump DEMO_SPEC_SCHEMA_VERSION on any breaking change.
+ *
+ * See notes/SAAS_DEMO_GENERATOR_PLAN.md for the full plan.
+ */
+exports.DEMO_SPEC_SCHEMA_VERSION = 1;
+// ─── brand (resolved, render-ready) ──────────────────────────────────────────
+// Reuses the BrandKit field shapes but provides concrete fallbacks so the engine
+// never renders an undefined color/font. The author/extraction stage fills these.
+exports.DemoBrandSchema = zod_1.z.object({
+    identity: brandKit_schema_1.BrandIdentitySchema.default({}),
+    colors: brandKit_schema_1.BrandColorsSchema.default({ palette: [] }),
+    fonts: brandKit_schema_1.BrandFontsSchema.default({}),
+});
+// ─── style system (cross-cutting render mode) ────────────────────────────────
+// Derived directly from Claude Design's option taxonomy (the screenshotted wizard).
+// These axes change how EVERY scene looks/moves, independent of scene content — the
+// difference between MyCounsel (clean-ui), LinkedNav (split-headline) and LangEase
+// (kinetic-typography + 3D device mockups). One DemoSpec = one resolved style/version;
+// requesting "N distinct styles to compare" produces N DemoSpecs.
+/** The overarching visual language. */
+exports.VisualStyleSchema = zod_1.z.enum([
+    "clean-ui-walkthrough", // animated real/fake screens + cursor (MyCounsel)
+    "split-headline", // bold headline + isolated UI component, numbered steps (LinkedNav)
+    "kinetic-typography", // big animated words, text-led (value-prop / LangEase intro)
+    "cinematic", // dramatic, slow, atmospheric premium motion graphics
+    "minimal-calm", // lots of whitespace, slow gentle moves
+    "energetic-punchy", // quick cuts, snappy transitions, 3D mockups, celebration beats (LangEase)
+]);
+exports.DemoStyleSchema = zod_1.z.object({
+    visual: exports.VisualStyleSchema.default("clean-ui-walkthrough"),
+    /** Cut rhythm / beat length. */
+    pace: zod_1.z.enum(["fast", "medium", "slow"]).default("medium"),
+    /** Surface treatment + palette resolution strategy. */
+    colorMood: zod_1.z.enum(["light", "dark", "brand-forward"]).default("dark"),
+    /** Guides on-screen TEXT DENSITY (captions-led vs sparse-for-VO vs minimal-for-music). */
+    audioIntent: zod_1.z.enum(["captions", "voiceover", "music"]).default("captions"),
+    /** Motion intensity; usually derived from `visual`+`pace` but explicit for the engine. */
+    motion: zod_1.z.enum(["subtle", "balanced", "dynamic"]).default("balanced"),
+});
+// ─── shared scene primitives ─────────────────────────────────────────────────
+/** A lower-third on-screen caption (VO-ready headline), per the studied Caption component. */
+exports.SceneCaptionSchema = zod_1.z.object({
+    title: zod_1.z.string(),
+    sub: zod_1.z.string().optional(),
+});
+/** Common to every scene regardless of type. */
+const SceneBaseSchema = zod_1.z.object({
+    /** Stable id so edits/patches can target a specific scene. */
+    id: zod_1.z.string(),
+    /** Scene length on the timeline, milliseconds. */
+    durationMs: zod_1.z.number().int().positive(),
+    /** Optional on-screen lower-third caption. */
+    caption: exports.SceneCaptionSchema.optional(),
+    /**
+     * Optional hint for the narration/script stage. The final script is generated
+     * later (timeline-synced), but the author may seed intent per scene.
+     */
+    narrationHint: zod_1.z.string().optional(),
+});
+/** A UI metric/stat chip used across dashboard/stats scenes. */
+exports.StatSchema = zod_1.z.object({
+    label: zod_1.z.string(),
+    /** Numeric value for count-up animation; use `valueText` for non-numeric. */
+    value: zod_1.z.number().optional(),
+    valueText: zod_1.z.string().optional(),
+    suffix: zod_1.z.string().optional(),
+    icon: zod_1.z.string().optional(),
+});
+/** A generic card used in featureShowcase / cardGrid scenes. */
+exports.DemoCardSchema = zod_1.z.object({
+    title: zod_1.z.string(),
+    subtitle: zod_1.z.string().optional(),
+    badge: zod_1.z.string().optional(),
+    badgeKind: zod_1.z.enum(["neutral", "positive", "warning", "danger"]).optional(),
+    icon: zod_1.z.string().optional(),
+});
+/** A single chat turn for the AI-assistant scene. */
+exports.ChatTurnSchema = zod_1.z.object({
+    role: zod_1.z.enum(["user", "assistant"]),
+    text: zod_1.z.string(),
+    /** Optional cited chips (e.g. precedents/sources) under an assistant turn. */
+    chips: zod_1.z.array(zod_1.z.string()).default([]),
+});
+// ─── scene type variants (Path A: template library) ──────────────────────────
+const ProblemSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("problem"),
+    headline: zod_1.z.string(),
+    /** Floating context items (e.g. scattered papers) for the problem montage. */
+    motifs: zod_1.z.array(zod_1.z.string()).default([]),
+});
+const LogoRevealSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("logoReveal"),
+    tagline: zod_1.z.string().optional(),
+});
+const FeatureShowcaseSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("featureShowcase"),
+    /** Feature/page title shown in the fake app. */
+    title: zod_1.z.string(),
+    /**
+     * Which product surface to render. Mirrors the reusable "Mini-UI" registry pattern
+     * observed across the MyCounsel teasers (search/chat/editor/analysis/marketplace),
+     * where one surface component is re-embedded across every style. See plan §2.6 (Layer 0.5).
+     */
+    surface: zod_1.z
+        .enum([
+        "search",
+        "form",
+        "table",
+        "detail",
+        "chat",
+        "editor",
+        "analysis",
+        "marketplace",
+        "dashboard",
+    ])
+        .default("search"),
+    /** Text the animated cursor "types" (typewriter). */
+    cursorTypes: zod_1.z.string().optional(),
+    /** Active sidebar item for the app shell. */
+    activeNav: zod_1.z.string().optional(),
+    cards: zod_1.z.array(exports.DemoCardSchema).default([]),
+    /**
+     * Optional real product screenshot to composite instead of fully fake-coding the
+     * surface. Often MORE accurate + reliable than a coded replica (see plan §2.6).
+     */
+    screenshotUrl: zod_1.z.string().optional(),
+});
+/** Bold headline + an isolated UI component/screenshot beside it (LinkedNav style). */
+const SplitFeatureSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("splitFeature"),
+    headline: zod_1.z.string(),
+    body: zod_1.z.string().optional(),
+    /** Optional "STEP 3 — …" eyebrow label. */
+    stepLabel: zod_1.z.string().optional(),
+    side: zod_1.z.enum(["left", "right"]).default("right"),
+    /** The isolated UI shown beside the headline: a screenshot or a small card set. */
+    screenshotUrl: zod_1.z.string().optional(),
+    cards: zod_1.z.array(exports.DemoCardSchema).default([]),
+});
+/** Large animated words, text-led (kinetic typography / value-prop / LangEase intro). */
+const BigStatementSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("bigStatement"),
+    /** Lines revealed in sequence; an emphasized span may be marked with **double asterisks**. */
+    lines: zod_1.z.array(zod_1.z.string()).min(1),
+    /** Optional small kicker above the statement. */
+    kicker: zod_1.z.string().optional(),
+});
+/** Real screenshot(s) composited into 3D-perspective device frames w/ parallax (LangEase). */
+const DeviceMockupSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("deviceMockup"),
+    device: zod_1.z.enum(["browser", "laptop", "phone", "tablet"]).default("browser"),
+    /** One or more screenshots to showcase (scroll/parallax/zoom across them). */
+    screenshotUrls: zod_1.z.array(zod_1.z.string()).min(1),
+    /** Camera move applied to the mockup. */
+    motion: zod_1.z.enum(["tilt", "parallax", "scroll", "zoom-in", "orbit"]).default("parallax"),
+    headline: zod_1.z.string().optional(),
+});
+const ChatSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("chat"),
+    title: zod_1.z.string().default("AI Assistant"),
+    turns: zod_1.z.array(exports.ChatTurnSchema).min(1),
+});
+const DashboardSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("dashboard"),
+    title: zod_1.z.string(),
+    stats: zod_1.z.array(exports.StatSchema).default([]),
+    /** Optional simple chart series (bar/line) values, 0..1 normalized. */
+    chart: zod_1.z.array(zod_1.z.number()).default([]),
+});
+const DocAnalysisSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("docAnalysis"),
+    title: zod_1.z.string(),
+    /** Insight rows revealed by the scan line. */
+    insights: zod_1.z.array(exports.DemoCardSchema).default([]),
+});
+const CardGridSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("cardGrid"),
+    title: zod_1.z.string(),
+    cards: zod_1.z.array(exports.DemoCardSchema).min(1),
+});
+const StatsSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("stats"),
+    headline: zod_1.z.string().optional(),
+    stats: zod_1.z.array(exports.StatSchema).min(1),
+});
+const CtaSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("cta"),
+    headline: zod_1.z.string(),
+    buttonText: zod_1.z.string().default("Start free"),
+    url: zod_1.z.string().optional(),
+    stats: zod_1.z.array(exports.StatSchema).default([]),
+});
+// ─── scene type variant (Path B: arbitrary codegen — additive, Phase 8) ──────
+const CustomSceneSchema = SceneBaseSchema.extend({
+    type: zod_1.z.literal("custom"),
+    /**
+     * Raw Remotion TSX authored by the LLM. Rendered only by the Path B dynamic
+     * bundler inside a sandbox (no network/fs, whitelisted imports). Path A engines
+     * MUST skip/placeholder these. Empty until Phase 8.
+     */
+    tsx: zod_1.z.string(),
+    /** Optional prop bag injected into the custom component. */
+    props: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).default({}),
+});
+exports.DemoSceneSchema = zod_1.z.discriminatedUnion("type", [
+    ProblemSceneSchema,
+    LogoRevealSceneSchema,
+    FeatureShowcaseSceneSchema,
+    SplitFeatureSceneSchema,
+    BigStatementSceneSchema,
+    DeviceMockupSceneSchema,
+    ChatSceneSchema,
+    DashboardSceneSchema,
+    DocAnalysisSceneSchema,
+    CardGridSceneSchema,
+    StatsSceneSchema,
+    CtaSceneSchema,
+    CustomSceneSchema,
+]);
+// ─── top-level DemoSpec ──────────────────────────────────────────────────────
+exports.DemoSpecSchema = zod_1.z.object({
+    schemaVersion: zod_1.z.literal(exports.DEMO_SPEC_SCHEMA_VERSION).default(exports.DEMO_SPEC_SCHEMA_VERSION),
+    /** Product display name (overlay text, never AI-rendered into pixels). */
+    productName: zod_1.z.string(),
+    /** One-line value proposition. */
+    tagline: zod_1.z.string().optional(),
+    brand: exports.DemoBrandSchema,
+    /** Cross-cutting visual language (style/pace/colorMood/audioIntent). */
+    style: exports.DemoStyleSchema.default({}),
+    /** Output geometry. */
+    aspect: project_schema_1.AspectSchema.default("16:9"),
+    fps: zod_1.z.number().int().positive().default(30),
+    /** Narrative arc the author followed (drives scene ordering + script tone). */
+    narrative: zod_1.z
+        .enum([
+        "problem-solution",
+        "feature-showcase",
+        "day-in-the-life",
+        "hero-workflow",
+        "value-prop",
+    ])
+        .default("problem-solution"),
+    /** Target audience hint for script tone. */
+    audience: zod_1.z.string().optional(),
+    /** Ordered scenes. Total duration = sum of scene.durationMs. */
+    scenes: zod_1.z.array(exports.DemoSceneSchema).min(1),
+});
+/** Sum of scene durations — the canonical total timeline length in ms. */
+function demoSpecDurationMs(spec) {
+    return spec.scenes.reduce((acc, s) => acc + s.durationMs, 0);
+}

package/lib/schemas/index.d.ts

@@ -2,6 +2,7 @@ export * from "./project.schema";
 export * from "./brief.schema";
 export * from "./videoPlan.schema";
 export * from "./brandKit.schema";
+export * from "./demoSpec.schema";
 export * from "./agentPersona.schema";
 export * from "./agentRunJob.schema";
 export * from "./social.schema";

package/lib/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

package/lib/schemas/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./project.schema"), exports);
 __exportStar(require("./brief.schema"), exports);
 __exportStar(require("./videoPlan.schema"), exports);
 __exportStar(require("./brandKit.schema"), exports);
+__exportStar(require("./demoSpec.schema"), exports);
 __exportStar(require("./agentPersona.schema"), exports);
 __exportStar(require("./agentRunJob.schema"), exports);
 __exportStar(require("./social.schema"), exports);

package/lib/schemas/project.schema.d.ts

@@ -107,6 +107,39 @@ export declare const TransitionSchema: z.ZodObject<{
         "from-bottom-left": "from-bottom-left";
     }>>;
 }, z.core.$strip>;
+/**
+ * Named animation preset for a TextClip. Each id maps 1:1 to a React sub-
+ * component in `vidspotai-remotion-components/src/presets` that owns the
+ * clip's *animation* (the shared shell still owns layout / safe-area /
+ * background decoration). Because the same registry is imported by both the
+ * editor `@remotion/player` preview and the server `renderMedia`, a preset
+ * looks identical in preview and export by construction.
+ *
+ * Additive: when `preset` is absent the renderer falls back to the legacy
+ * `metadata.animation` enum, so old plans/projects keep working unchanged.
+ * Adding a preset = add its id here AND register its component — keep the two
+ * in lock-step.
+ */
+export declare const TextPresetSchema: z.ZodEnum<{
+    none: "none";
+    "fade-soft": "fade-soft";
+    "kinetic-pop": "kinetic-pop";
+    "editorial-wipe": "editorial-wipe";
+    "bold-slam": "bold-slam";
+    "type-on": "type-on";
+}>;
+export type TextPreset = z.infer<typeof TextPresetSchema>;
+/**
+ * Named animation preset for a CaptionClip (word-timed). Drives the active-
+ * word highlight style. Same registry/parity guarantees as TextPresetSchema.
+ */
+export declare const CaptionPresetSchema: z.ZodEnum<{
+    none: "none";
+    "tiktok-word": "tiktok-word";
+    "karaoke-fill": "karaoke-fill";
+    "block-cut": "block-cut";
+}>;
+export type CaptionPreset = z.infer<typeof CaptionPresetSchema>;
 export declare const CaptionWordSchema: z.ZodObject<{
     word: z.ZodString;
     start: z.ZodNumber;
@@ -303,6 +336,14 @@ export declare const TextClipSchema: z.ZodObject<{
     }>>;
     backgroundColor: z.ZodOptional<z.ZodString>;
     shadow: z.ZodOptional<z.ZodString>;
+    preset: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        "fade-soft": "fade-soft";
+        "kinetic-pop": "kinetic-pop";
+        "editorial-wipe": "editorial-wipe";
+        "bold-slam": "bold-slam";
+        "type-on": "type-on";
+    }>>;
     id: z.ZodString;
     trackId: z.ZodString;
     display: z.ZodObject<{
@@ -359,6 +400,12 @@ export declare const CaptionClipSchema: z.ZodObject<{
     color: z.ZodDefault<z.ZodString>;
     highlightColor: z.ZodOptional<z.ZodString>;
     language: z.ZodDefault<z.ZodString>;
+    preset: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        "tiktok-word": "tiktok-word";
+        "karaoke-fill": "karaoke-fill";
+        "block-cut": "block-cut";
+    }>>;
     id: z.ZodString;
     trackId: z.ZodString;
     display: z.ZodObject<{
@@ -589,6 +636,14 @@ export declare const ClipSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>>;
     backgroundColor: z.ZodOptional<z.ZodString>;
     shadow: z.ZodOptional<z.ZodString>;
+    preset: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        "fade-soft": "fade-soft";
+        "kinetic-pop": "kinetic-pop";
+        "editorial-wipe": "editorial-wipe";
+        "bold-slam": "bold-slam";
+        "type-on": "type-on";
+    }>>;
     id: z.ZodString;
     trackId: z.ZodString;
     display: z.ZodObject<{
@@ -644,6 +699,12 @@ export declare const ClipSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     color: z.ZodDefault<z.ZodString>;
     highlightColor: z.ZodOptional<z.ZodString>;
     language: z.ZodDefault<z.ZodString>;
+    preset: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        "tiktok-word": "tiktok-word";
+        "karaoke-fill": "karaoke-fill";
+        "block-cut": "block-cut";
+    }>>;
     id: z.ZodString;
     trackId: z.ZodString;
     display: z.ZodObject<{
@@ -703,6 +764,7 @@ export declare const TrackSchema: z.ZodObject<{
         fx: "fx";
     }>;
     name: z.ZodOptional<z.ZodString>;
+    sourceTrackId: z.ZodOptional<z.ZodString>;
     index: z.ZodNumber;
     muted: z.ZodDefault<z.ZodBoolean>;
     hidden: z.ZodDefault<z.ZodBoolean>;
@@ -753,6 +815,7 @@ export declare const ProjectSchema: z.ZodObject<{
             fx: "fx";
         }>;
         name: z.ZodOptional<z.ZodString>;
+        sourceTrackId: z.ZodOptional<z.ZodString>;
         index: z.ZodNumber;
         muted: z.ZodDefault<z.ZodBoolean>;
         hidden: z.ZodDefault<z.ZodBoolean>;
@@ -947,6 +1010,14 @@ export declare const ProjectSchema: z.ZodObject<{
         }>>;
         backgroundColor: z.ZodOptional<z.ZodString>;
         shadow: z.ZodOptional<z.ZodString>;
+        preset: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            "fade-soft": "fade-soft";
+            "kinetic-pop": "kinetic-pop";
+            "editorial-wipe": "editorial-wipe";
+            "bold-slam": "bold-slam";
+            "type-on": "type-on";
+        }>>;
         id: z.ZodString;
         trackId: z.ZodString;
         display: z.ZodObject<{
@@ -1002,6 +1073,12 @@ export declare const ProjectSchema: z.ZodObject<{
         color: z.ZodDefault<z.ZodString>;
         highlightColor: z.ZodOptional<z.ZodString>;
         language: z.ZodDefault<z.ZodString>;
+        preset: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            "tiktok-word": "tiktok-word";
+            "karaoke-fill": "karaoke-fill";
+            "block-cut": "block-cut";
+        }>>;
         id: z.ZodString;
         trackId: z.ZodString;
         display: z.ZodObject<{
@@ -1070,6 +1147,7 @@ export declare const ProjectSchema: z.ZodObject<{
             "from-bottom-left": "from-bottom-left";
         }>>;
     }, z.core.$strip>>>;
+    masterVolume: z.ZodDefault<z.ZodNumber>;
     agentRunId: z.ZodOptional<z.ZodString>;
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     createdAt: z.ZodString;

package/lib/schemas/project.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/project.schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/project.schema.ts"],"names":[],"mappings":"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"}

package/lib/schemas/project.schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProjectSchema = exports.ProjectBackgroundSchema = exports.TrackSchema = exports.TrackKindSchema = exports.ClipSchema = exports.CaptionClipSchema = exports.TextClipSchema = exports.AudioClipSchema = exports.ImageClipSchema = exports.VideoClipSchema = exports.CaptionWordSchema = exports.TransitionSchema = exports.EffectSchema = exports.ProvenanceSchema = exports.TierSchema = exports.ColorGradeSchema = exports.TransformSchema = exports.TrimSchema = exports.TimeRangeSchema = exports.AspectSchema = exports.SizeSchema = exports.PROJECT_SCHEMA_VERSION = void 0;
+exports.ProjectSchema = exports.ProjectBackgroundSchema = exports.TrackSchema = exports.TrackKindSchema = exports.ClipSchema = exports.CaptionClipSchema = exports.TextClipSchema = exports.AudioClipSchema = exports.ImageClipSchema = exports.VideoClipSchema = exports.CaptionWordSchema = exports.CaptionPresetSchema = exports.TextPresetSchema = exports.TransitionSchema = exports.EffectSchema = exports.ProvenanceSchema = exports.TierSchema = exports.ColorGradeSchema = exports.TransformSchema = exports.TrimSchema = exports.TimeRangeSchema = exports.AspectSchema = exports.SizeSchema = exports.PROJECT_SCHEMA_VERSION = void 0;
 const zod_1 = require("zod");
 /**
  * Canonical Project JSON schema.
@@ -121,6 +121,38 @@ exports.TransitionSchema = zod_1.z.object({
     ])
         .optional(),
 });
+// ─── animated text / caption presets ──────────────────────────────────────
+/**
+ * Named animation preset for a TextClip. Each id maps 1:1 to a React sub-
+ * component in `vidspotai-remotion-components/src/presets` that owns the
+ * clip's *animation* (the shared shell still owns layout / safe-area /
+ * background decoration). Because the same registry is imported by both the
+ * editor `@remotion/player` preview and the server `renderMedia`, a preset
+ * looks identical in preview and export by construction.
+ *
+ * Additive: when `preset` is absent the renderer falls back to the legacy
+ * `metadata.animation` enum, so old plans/projects keep working unchanged.
+ * Adding a preset = add its id here AND register its component — keep the two
+ * in lock-step.
+ */
+exports.TextPresetSchema = zod_1.z.enum([
+    "none", // static — no entrance animation
+    "fade-soft", // gentle fade + tiny rise (the historical default, named)
+    "kinetic-pop", // per-word spring scale + rise
+    "editorial-wipe", // clip-path mask reveal, left-to-right
+    "bold-slam", // oversized weight slams down to rest scale
+    "type-on", // typewriter reveal with caret
+]);
+/**
+ * Named animation preset for a CaptionClip (word-timed). Drives the active-
+ * word highlight style. Same registry/parity guarantees as TextPresetSchema.
+ */
+exports.CaptionPresetSchema = zod_1.z.enum([
+    "none", // all words shown, active word recolored (legacy default)
+    "tiktok-word", // active word scales + recolors with a pop
+    "karaoke-fill", // left-to-right fill of the active word
+    "block-cut", // 1–3 word hard-cut pages (no carry-over text)
+]);
 // ─── caption sub-shape ───────────────────────────────────────────────────
 exports.CaptionWordSchema = zod_1.z.object({
     word: zod_1.z.string(),
@@ -196,6 +228,13 @@ exports.TextClipSchema = zod_1.z.object({
     align: zod_1.z.enum(["left", "center", "right"]).default("center"),
     backgroundColor: zod_1.z.string().optional(),
     shadow: zod_1.z.string().optional(),
+    /**
+     * Named animation preset (see TextPresetSchema). First-class on the clip so
+     * the editor and round-trip (storeToProject) carry it explicitly rather than
+     * burying it in metadata. When absent the renderer falls back to
+     * metadata.animation. Authoritative over metadata.animation when both set.
+     */
+    preset: exports.TextPresetSchema.optional(),
 });
 exports.CaptionClipSchema = zod_1.z.object({
     ...ClipBase,
@@ -210,6 +249,8 @@ exports.CaptionClipSchema = zod_1.z.object({
     color: zod_1.z.string().default("#ffffff"),
     highlightColor: zod_1.z.string().optional(),
     language: zod_1.z.string().default("en"),
+    /** Named caption animation preset (see CaptionPresetSchema). Absent → "none". */
+    preset: exports.CaptionPresetSchema.optional(),
 });
 exports.ClipSchema = zod_1.z.discriminatedUnion("type", [
     exports.VideoClipSchema,
@@ -230,6 +271,13 @@ exports.TrackSchema = zod_1.z.object({
     id: zod_1.z.string(),
     kind: exports.TrackKindSchema,
     name: zod_1.z.string().optional(),
+    /**
+     * For a caption track: the id of the SOURCE track whose clips it captions
+     * (its "caption group"). The editor reads this to route regenerated/added
+     * captions back onto the right caption row, and to keep one caption track per
+     * source group. Absent on non-caption tracks.
+     */
+    sourceTrackId: zod_1.z.string().optional(),
     /** Track stacking order; lower = behind. */
     index: zod_1.z.number().int().nonnegative(),
     muted: zod_1.z.boolean().default(false),
@@ -259,6 +307,12 @@ exports.ProjectSchema = zod_1.z.object({
     tracks: zod_1.z.array(exports.TrackSchema),
     clips: zod_1.z.array(exports.ClipSchema),
     transitions: zod_1.z.array(exports.TransitionSchema).default([]),
+    /**
+     * Project-level master volume multiplier (0–1, 1 = unchanged). Scales every
+     * audio/video clip's volume in the render. Must be declared here or Zod's
+     * object parse strips it before the project reaches the renderer.
+     */
+    masterVolume: zod_1.z.number().min(0).max(1).default(1),
     /** Top-level provenance: which agent run produced this project, if any. */
     agentRunId: zod_1.z.string().optional(),
     /** Free-form per-app metadata. Renderer ignores. */