vidspotai-shared 1.0.100 → 1.0.101

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

@@ -27,6 +27,7 @@ export declare const DemoBrandSchema: z.ZodObject<{
         brandName: z.ZodOptional<z.ZodString>;
         wordmark: z.ZodOptional<z.ZodString>;
         logoUrl: z.ZodOptional<z.ZodString>;
+        siteUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     colors: z.ZodDefault<z.ZodObject<{
         primary: z.ZodOptional<z.ZodString>;
@@ -62,8 +63,8 @@ export declare const DemoStyleSchema: z.ZodObject<{
         "energetic-punchy": "energetic-punchy";
     }>>;
     pace: z.ZodDefault<z.ZodEnum<{
-        medium: "medium";
         fast: "fast";
+        medium: "medium";
         slow: "slow";
     }>>;
     colorMood: z.ZodDefault<z.ZodEnum<{
@@ -108,6 +109,8 @@ export declare const DemoCardSchema: z.ZodObject<{
         danger: "danger";
     }>>;
     icon: z.ZodOptional<z.ZodString>;
+    imageUrl: z.ZodOptional<z.ZodString>;
+    clipUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /** A single chat turn for the AI-assistant scene. */
 export declare const ChatTurnSchema: z.ZodObject<{
@@ -150,9 +153,9 @@ export declare const DemoSceneSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"featureShowcase">;
     title: z.ZodString;
     surface: z.ZodDefault<z.ZodEnum<{
-        detail: "detail";
         search: "search";
         table: "table";
+        detail: "detail";
         form: "form";
         chat: "chat";
         editor: "editor";
@@ -173,6 +176,8 @@ export declare const DemoSceneSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             danger: "danger";
         }>>;
         icon: z.ZodOptional<z.ZodString>;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        clipUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     screenshotUrl: z.ZodOptional<z.ZodString>;
     videoUrl: z.ZodOptional<z.ZodString>;
@@ -205,6 +210,8 @@ export declare const DemoSceneSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             danger: "danger";
         }>>;
         icon: z.ZodOptional<z.ZodString>;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        clipUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
@@ -227,6 +234,7 @@ export declare const DemoSceneSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     narrationHint: z.ZodOptional<z.ZodString>;
     type: z.ZodLiteral<"deviceMockup">;
     device: z.ZodDefault<z.ZodEnum<{
+        none: "none";
         phone: "phone";
         browser: "browser";
         laptop: "laptop";
@@ -234,6 +242,7 @@ export declare const DemoSceneSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>>;
     screenshotUrls: z.ZodDefault<z.ZodArray<z.ZodString>>;
     videoUrl: z.ZodOptional<z.ZodString>;
+    clipUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
     motion: z.ZodDefault<z.ZodEnum<{
         parallax: "parallax";
         tilt: "tilt";
@@ -317,6 +326,8 @@ export declare const DemoSceneSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             danger: "danger";
         }>>;
         icon: z.ZodOptional<z.ZodString>;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        clipUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
@@ -339,6 +350,8 @@ export declare const DemoSceneSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             danger: "danger";
         }>>;
         icon: z.ZodOptional<z.ZodString>;
+        imageUrl: z.ZodOptional<z.ZodString>;
+        clipUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
@@ -402,10 +415,15 @@ export declare const GEN_ASSET_URI_PREFIX: "gen://";
 export declare const DemoGeneratedAssetSchema: z.ZodObject<{
     id: z.ZodString;
     kind: z.ZodEnum<{
-        image: "image";
         video: "video";
+        image: "image";
     }>;
+    source: z.ZodDefault<z.ZodEnum<{
+        generated: "generated";
+        stock: "stock";
+    }>>;
     prompt: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
     purpose: z.ZodOptional<z.ZodString>;
     aspect: z.ZodOptional<z.ZodEnum<{
         "9:16": "9:16";
@@ -432,6 +450,7 @@ export declare const DemoSpecSchema: z.ZodObject<{
             brandName: z.ZodOptional<z.ZodString>;
             wordmark: z.ZodOptional<z.ZodString>;
             logoUrl: z.ZodOptional<z.ZodString>;
+            siteUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         colors: z.ZodDefault<z.ZodObject<{
             primary: z.ZodOptional<z.ZodString>;
@@ -456,8 +475,8 @@ export declare const DemoSpecSchema: z.ZodObject<{
             "energetic-punchy": "energetic-punchy";
         }>>;
         pace: z.ZodDefault<z.ZodEnum<{
-            medium: "medium";
             fast: "fast";
+            medium: "medium";
             slow: "slow";
         }>>;
         colorMood: z.ZodDefault<z.ZodEnum<{
@@ -523,9 +542,9 @@ export declare const DemoSpecSchema: z.ZodObject<{
         type: z.ZodLiteral<"featureShowcase">;
         title: z.ZodString;
         surface: z.ZodDefault<z.ZodEnum<{
-            detail: "detail";
             search: "search";
             table: "table";
+            detail: "detail";
             form: "form";
             chat: "chat";
             editor: "editor";
@@ -546,6 +565,8 @@ export declare const DemoSpecSchema: z.ZodObject<{
                 danger: "danger";
             }>>;
             icon: z.ZodOptional<z.ZodString>;
+            imageUrl: z.ZodOptional<z.ZodString>;
+            clipUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         screenshotUrl: z.ZodOptional<z.ZodString>;
         videoUrl: z.ZodOptional<z.ZodString>;
@@ -578,6 +599,8 @@ export declare const DemoSpecSchema: z.ZodObject<{
                 danger: "danger";
             }>>;
             icon: z.ZodOptional<z.ZodString>;
+            imageUrl: z.ZodOptional<z.ZodString>;
+            clipUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
@@ -600,6 +623,7 @@ export declare const DemoSpecSchema: z.ZodObject<{
         narrationHint: z.ZodOptional<z.ZodString>;
         type: z.ZodLiteral<"deviceMockup">;
         device: z.ZodDefault<z.ZodEnum<{
+            none: "none";
             phone: "phone";
             browser: "browser";
             laptop: "laptop";
@@ -607,6 +631,7 @@ export declare const DemoSpecSchema: z.ZodObject<{
         }>>;
         screenshotUrls: z.ZodDefault<z.ZodArray<z.ZodString>>;
         videoUrl: z.ZodOptional<z.ZodString>;
+        clipUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
         motion: z.ZodDefault<z.ZodEnum<{
             parallax: "parallax";
             tilt: "tilt";
@@ -690,6 +715,8 @@ export declare const DemoSpecSchema: z.ZodObject<{
                 danger: "danger";
             }>>;
             icon: z.ZodOptional<z.ZodString>;
+            imageUrl: z.ZodOptional<z.ZodString>;
+            clipUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
@@ -712,6 +739,8 @@ export declare const DemoSpecSchema: z.ZodObject<{
                 danger: "danger";
             }>>;
             icon: z.ZodOptional<z.ZodString>;
+            imageUrl: z.ZodOptional<z.ZodString>;
+            clipUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
@@ -765,10 +794,15 @@ export declare const DemoSpecSchema: z.ZodObject<{
     generatedAssets: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
-            image: "image";
             video: "video";
+            image: "image";
         }>;
+        source: z.ZodDefault<z.ZodEnum<{
+            generated: "generated";
+            stock: "stock";
+        }>>;
         prompt: z.ZodString;
+        query: z.ZodOptional<z.ZodString>;
         purpose: z.ZodOptional<z.ZodString>;
         aspect: z.ZodOptional<z.ZodEnum<{
             "9:16": "9:16";

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

@@ -1 +1 @@
-{"version":3,"file":"demoSpec.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/demoSpec.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,wBAAwB,EAAG,CAAU,CAAC;AAMnD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AASxD,uCAAuC;AACvC,eAAO,MAAM,iBAAiB;;;;;;;EAO5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAiBH,gEAAgE;AAChE,eAAO,MAAM,UAAU;;;;;;iBAOrB,CAAC;AAEH,gEAAgE;AAChE,eAAO,MAAM,cAAc;;;;;;;;;;;iBAMzB,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,cAAc;;;;;;;iBAKzB,CAAC;AA6LH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAe1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAI9C;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAG,QAAiB,CAAC;AAEtD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;iBAoBnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyCzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,CAEzE"}
+{"version":3,"file":"demoSpec.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/demoSpec.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,wBAAwB,EAAG,CAAU,CAAC;AAMnD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AASxD,uCAAuC;AACvC,eAAO,MAAM,iBAAiB;;;;;;;EAO5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAiBH,gEAAgE;AAChE,eAAO,MAAM,UAAU;;;;;;iBAOrB,CAAC;AAEH,gEAAgE;AAChE,eAAO,MAAM,cAAc;;;;;;;;;;;;;iBAgBzB,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,cAAc;;;;;;;iBAKzB,CAAC;AA+MH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAe1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAI9C;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAG,QAAiB,CAAC;AAEtD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqCnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyCzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,CAEzE"}

package/lib/schemas/demoSpec.schema.js

@@ -98,6 +98,16 @@ exports.DemoCardSchema = zod_1.z.object({
     badge: zod_1.z.string().optional(),
     badgeKind: zod_1.z.enum(["neutral", "positive", "warning", "danger"]).optional(),
     icon: zod_1.z.string().optional(),
+    /**
+     * Optional leading media for the card — a real thumbnail (poster/image) or a
+     * looping product CLIP. Used by list/grid surfaces (e.g. search results, a
+     * library grid) so a row shows real content instead of a gradient glyph.
+     * Sourced the same way as scene media: a real user/product asset, a resolved
+     * `gen://` AI asset, or a `stock://` library asset. Renders muted + cover-fit
+     * and degrades to the gradient glyph on load failure. NEVER a fabricated URL.
+     */
+    imageUrl: zod_1.z.string().optional(),
+    clipUrl: zod_1.z.string().optional(),
 });
 /** A single chat turn for the AI-assistant scene. */
 exports.ChatTurnSchema = zod_1.z.object({
@@ -183,7 +193,17 @@ const BigStatementSceneSchema = SceneBaseSchema.extend({
 /** 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"),
+    /**
+     * Device chrome drawn around the media. `"none"` presents the capture
+     * FULL-BLEED with no frame at all — the right choice when the footage already
+     * contains the product's own window/app chrome and a second frame around it
+     * would read as chrome-inside-chrome.
+     *
+     * `"none"` fits the media rather than cropping it (see DeviceFrame `fit`), so
+     * a capture whose aspect differs from the composition keeps every edge — a
+     * product UI loses its meaning when its top bar or toolbar is cropped away.
+     */
+    device: zod_1.z.enum(["browser", "laptop", "phone", "tablet", "none"]).default("browser"),
     /**
      * Screenshots to showcase (scroll/parallax/zoom across them). May be empty when
      * `videoUrl` supplies the media instead — the canonical way to play a user's
@@ -197,6 +217,14 @@ const DeviceMockupSceneSchema = SceneBaseSchema.extend({
      * `inputs.mediaAssets`, rendered via `<OffthreadVideo>` (muted, loops to fill).
      */
     videoUrl: zod_1.z.string().optional(),
+    /**
+     * Optional set of real video CLIPS to show as a LIBRARY GRID inside the frame
+     * (2×2+). When two or more are given the frame renders a product-library screen
+     * — each clip a looping, cover-fit card with a duration chip + title — instead
+     * of a single cycling screenshot. The canonical "here are the videos it made"
+     * beat. Clips loop muted; a dead URL degrades that one card to a poster glyph.
+     */
+    clipUrls: zod_1.z.array(zod_1.z.string()).optional(),
     /** 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(),
@@ -306,12 +334,29 @@ exports.DemoGeneratedAssetSchema = zod_1.z.object({
     /** Stable id scenes reference as `gen://<id>`. */
     id: zod_1.z.string(),
     kind: zod_1.z.enum(["image", "video"]),
+    /**
+     * How the asset is resolved:
+     *   - "generated" (default): the AI provider renders it from `prompt`.
+     *   - "stock": the stock-asset stage searches a real library (Pexels → Pixabay
+     *     → Unsplash) for `query` and fills `url` with a real photo/clip. Free +
+     *     instant + real — preferred over generation for generic real-world subjects
+     *     (a laptop on a desk, a city street, a coffee shop) where a licensed stock
+     *     shot beats a synthesized one. Both kinds are referenced the same way
+     *     (`gen://<id>`) and flow through the same substitution + media guard.
+     */
+    source: zod_1.z.enum(["generated", "stock"]).default("generated"),
     /**
      * The full generation prompt, written by the PLANNER for THIS product:
      * concrete subject + composition + lighting/mood + brand palette accents.
      * Never contains readable text/UI copy (AI-rendered text artifacts).
+     * Required for `source:"generated"`; ignored for stock (use `query`).
      */
     prompt: zod_1.z.string(),
+    /**
+     * Stock-search terms (2–5 plain words describing the subject, no brand names,
+     * no UI copy) — used when `source:"stock"`. e.g. "founder laptop cafe".
+     */
+    query: zod_1.z.string().optional(),
     /** Why this asset exists / which beat it serves — audit + revise context. */
     purpose: zod_1.z.string().optional(),
     /** Output geometry; defaults to the spec aspect at generation time. */

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

@@ -227,6 +227,16 @@ export declare const ImageClipSchema: z.ZodObject<{
         saturation: z.ZodDefault<z.ZodNumber>;
         warmth: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    box: z.ZodOptional<z.ZodObject<{
+        left: z.ZodNumber;
+        top: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    fit: z.ZodOptional<z.ZodEnum<{
+        cover: "cover";
+        contain: "contain";
+    }>>;
     id: z.ZodString;
     trackId: z.ZodString;
     display: z.ZodObject<{
@@ -529,6 +539,16 @@ export declare const ClipSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         saturation: z.ZodDefault<z.ZodNumber>;
         warmth: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    box: z.ZodOptional<z.ZodObject<{
+        left: z.ZodNumber;
+        top: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    fit: z.ZodOptional<z.ZodEnum<{
+        cover: "cover";
+        contain: "contain";
+    }>>;
     id: z.ZodString;
     trackId: z.ZodString;
     display: z.ZodObject<{
@@ -748,8 +768,8 @@ export declare const ClipSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>], "type">;
 export declare const TrackKindSchema: z.ZodEnum<{
-    audio: "audio";
     video: "video";
+    audio: "audio";
     text: "text";
     caption: "caption";
     fx: "fx";
@@ -757,8 +777,8 @@ export declare const TrackKindSchema: z.ZodEnum<{
 export declare const TrackSchema: z.ZodObject<{
     id: z.ZodString;
     kind: z.ZodEnum<{
-        audio: "audio";
         video: "video";
+        audio: "audio";
         text: "text";
         caption: "caption";
         fx: "fx";
@@ -808,8 +828,8 @@ export declare const ProjectSchema: z.ZodObject<{
     tracks: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
-            audio: "audio";
             video: "video";
+            audio: "audio";
             text: "text";
             caption: "caption";
             fx: "fx";
@@ -903,6 +923,16 @@ export declare const ProjectSchema: z.ZodObject<{
             saturation: z.ZodDefault<z.ZodNumber>;
             warmth: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
+        box: z.ZodOptional<z.ZodObject<{
+            left: z.ZodNumber;
+            top: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        fit: z.ZodOptional<z.ZodEnum<{
+            cover: "cover";
+            contain: "contain";
+        }>>;
         id: z.ZodString;
         trackId: z.ZodString;
         display: z.ZodObject<{

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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,sBAAsB,EAAG,CAAU,CAAC;AAIjD,eAAO,MAAM,UAAU;;;iBAGrB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;EAAyC,CAAC;AAEnE,eAAO,MAAM,eAAe;;;iBAK1B,CAAC;AAEH,eAAO,MAAM,UAAU;;;iBAIrB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;iBAO1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;iBAK3B,CAAC;AAIH,mDAAmD;AACnD,eAAO,MAAM,UAAU;;;;;EAAmC,CAAC;AAE3D,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;iBAqB3B,CAAC;AAIH,eAAO,MAAM,YAAY;;;;;iBAOvB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;iBAkC3B,CAAC;AAIH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;EAO3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;EAK9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,eAAO,MAAM,iBAAiB;;;;iBAK5B,CAAC;AAmBH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiB1B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkC1B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBzB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe5B,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAMrB,CAAC;AAIH,eAAO,MAAM,eAAe;;;;;;EAM1B,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;iBAkBtB,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;2BAIlC,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmCxB,CAAC;AAIH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/lib/schemas/project.schema.js

@@ -205,6 +205,28 @@ exports.ImageClipSchema = zod_1.z.object({
     })
         .optional(),
     colorGrade: exports.ColorGradeSchema.optional(),
+    /**
+     * Optional fixed layout box in composition PIXELS. Used for overlay images
+     * pinned to a region — e.g. a brand logo in a corner (Reach per-recipient
+     * enrichment). When ABSENT the image fills the frame exactly as before (no
+     * behavior change for scene visuals). `left`/`top` are the box's top-left
+     * corner; `width`/`height` its size. Consumed by projectToDesign → the
+     * renderer's container/media styles.
+     */
+    box: zod_1.z
+        .object({
+        left: zod_1.z.number(),
+        top: zod_1.z.number(),
+        width: zod_1.z.number().positive(),
+        height: zod_1.z.number().positive(),
+    })
+        .optional(),
+    /**
+     * object-fit for the image within its box (or the frame). Default "cover"
+     * (unchanged legacy behavior). Overlay logos use "contain" so a wide/tall
+     * logo is letterboxed inside its box rather than cropped.
+     */
+    fit: zod_1.z.enum(["cover", "contain"]).optional(),
 });
 exports.AudioClipSchema = zod_1.z.object({
     ...ClipBase,

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

@@ -37,8 +37,8 @@ export declare const SocialInboxReplySchema: z.ZodObject<{
 /** Body for PATCH /v1/social/inbox/:id — update handling state / moderation. */
 export declare const SocialInboxUpdateSchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodEnum<{
-        read: "read";
         hidden: "hidden";
+        read: "read";
         unread: "unread";
         replied: "replied";
     }>>;

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

@@ -84,8 +84,8 @@ export declare const TransitionKindSchema: z.ZodEnum<{
  * - label:       in-frame label for an object or person (anchored to frame area)
  */
 export declare const TextRoleSchema: z.ZodEnum<{
-    body: "body";
     watermark: "watermark";
+    body: "body";
     cta: "cta";
     headline: "headline";
     subheadline: "subheadline";
@@ -93,8 +93,8 @@ export declare const TextRoleSchema: z.ZodEnum<{
     label: "label";
 }>;
 export declare const TextPositionSchema: z.ZodEnum<{
-    center: "center";
     top: "top";
+    center: "center";
     "top-left": "top-left";
     "top-right": "top-right";
     "top-banner": "top-banner";
@@ -106,8 +106,8 @@ export declare const TextPositionSchema: z.ZodEnum<{
     "caption-strip": "caption-strip";
 }>;
 export declare const TextAnimationSchema: z.ZodEnum<{
-    type: "type";
     pop: "pop";
+    type: "type";
     none: "none";
     fade: "fade";
     "slide-up": "slide-up";
@@ -138,8 +138,8 @@ export declare const TextBgStyleSchema: z.ZodEnum<{
 export declare const TextOverlaySchema: z.ZodObject<{
     text: z.ZodString;
     role: z.ZodEnum<{
-        body: "body";
         watermark: "watermark";
+        body: "body";
         cta: "cta";
         headline: "headline";
         subheadline: "subheadline";
@@ -147,8 +147,8 @@ export declare const TextOverlaySchema: z.ZodObject<{
         label: "label";
     }>;
     position: z.ZodOptional<z.ZodEnum<{
-        center: "center";
         top: "top";
+        center: "center";
         "top-left": "top-left";
         "top-right": "top-right";
         "top-banner": "top-banner";
@@ -167,10 +167,10 @@ export declare const TextOverlaySchema: z.ZodObject<{
     fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodNumber]>>;
     sizePct: z.ZodOptional<z.ZodNumber>;
     weight: z.ZodOptional<z.ZodEnum<{
-        regular: "regular";
         bold: "bold";
-        black: "black";
         medium: "medium";
+        regular: "regular";
+        black: "black";
     }>>;
     color: z.ZodOptional<z.ZodString>;
     bgColor: z.ZodOptional<z.ZodString>;
@@ -182,8 +182,8 @@ export declare const TextOverlaySchema: z.ZodObject<{
         outline: "outline";
     }>>;
     animation: z.ZodOptional<z.ZodEnum<{
-        type: "type";
         pop: "pop";
+        type: "type";
         none: "none";
         fade: "fade";
         "slide-up": "slide-up";
@@ -322,8 +322,8 @@ export declare const PlannedSceneSchema: z.ZodObject<{
     overlays: z.ZodOptional<z.ZodArray<z.ZodObject<{
         text: z.ZodString;
         role: z.ZodEnum<{
-            body: "body";
             watermark: "watermark";
+            body: "body";
             cta: "cta";
             headline: "headline";
             subheadline: "subheadline";
@@ -331,8 +331,8 @@ export declare const PlannedSceneSchema: z.ZodObject<{
             label: "label";
         }>;
         position: z.ZodOptional<z.ZodEnum<{
-            center: "center";
             top: "top";
+            center: "center";
             "top-left": "top-left";
             "top-right": "top-right";
             "top-banner": "top-banner";
@@ -351,10 +351,10 @@ export declare const PlannedSceneSchema: z.ZodObject<{
         fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodNumber]>>;
         sizePct: z.ZodOptional<z.ZodNumber>;
         weight: z.ZodOptional<z.ZodEnum<{
-            regular: "regular";
             bold: "bold";
-            black: "black";
             medium: "medium";
+            regular: "regular";
+            black: "black";
         }>>;
         color: z.ZodOptional<z.ZodString>;
         bgColor: z.ZodOptional<z.ZodString>;
@@ -366,8 +366,8 @@ export declare const PlannedSceneSchema: z.ZodObject<{
             outline: "outline";
         }>>;
         animation: z.ZodOptional<z.ZodEnum<{
-            type: "type";
             pop: "pop";
+            type: "type";
             none: "none";
             fade: "fade";
             "slide-up": "slide-up";
@@ -427,8 +427,8 @@ export declare const PlannedSceneSchema: z.ZodObject<{
     broll: z.ZodOptional<z.ZodArray<z.ZodObject<{
         assetUrl: z.ZodString;
         kind: z.ZodDefault<z.ZodEnum<{
-            image: "image";
             video: "video";
+            image: "image";
         }>>;
         startMs: z.ZodDefault<z.ZodNumber>;
         durationMs: z.ZodOptional<z.ZodNumber>;
@@ -557,8 +557,8 @@ export declare const VideoPlanSchema: z.ZodObject<{
         overlays: z.ZodOptional<z.ZodArray<z.ZodObject<{
             text: z.ZodString;
             role: z.ZodEnum<{
-                body: "body";
                 watermark: "watermark";
+                body: "body";
                 cta: "cta";
                 headline: "headline";
                 subheadline: "subheadline";
@@ -566,8 +566,8 @@ export declare const VideoPlanSchema: z.ZodObject<{
                 label: "label";
             }>;
             position: z.ZodOptional<z.ZodEnum<{
-                center: "center";
                 top: "top";
+                center: "center";
                 "top-left": "top-left";
                 "top-right": "top-right";
                 "top-banner": "top-banner";
@@ -586,10 +586,10 @@ export declare const VideoPlanSchema: z.ZodObject<{
             fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodNumber]>>;
             sizePct: z.ZodOptional<z.ZodNumber>;
             weight: z.ZodOptional<z.ZodEnum<{
-                regular: "regular";
                 bold: "bold";
-                black: "black";
                 medium: "medium";
+                regular: "regular";
+                black: "black";
             }>>;
             color: z.ZodOptional<z.ZodString>;
             bgColor: z.ZodOptional<z.ZodString>;
@@ -601,8 +601,8 @@ export declare const VideoPlanSchema: z.ZodObject<{
                 outline: "outline";
             }>>;
             animation: z.ZodOptional<z.ZodEnum<{
-                type: "type";
                 pop: "pop";
+                type: "type";
                 none: "none";
                 fade: "fade";
                 "slide-up": "slide-up";
@@ -662,8 +662,8 @@ export declare const VideoPlanSchema: z.ZodObject<{
         broll: z.ZodOptional<z.ZodArray<z.ZodObject<{
             assetUrl: z.ZodString;
             kind: z.ZodDefault<z.ZodEnum<{
-                image: "image";
                 video: "video";
+                image: "image";
             }>>;
             startMs: z.ZodDefault<z.ZodNumber>;
             durationMs: z.ZodOptional<z.ZodNumber>;
@@ -699,7 +699,9 @@ export declare const VideoPlanSchema: z.ZodObject<{
     }, z.core.$strip>>;
     voiceId: z.ZodOptional<z.ZodString>;
     voiceStyle: z.ZodOptional<z.ZodString>;
+    outputLanguage: z.ZodOptional<z.ZodString>;
     notes: z.ZodOptional<z.ZodString>;
+    brandLogoUrl: z.ZodOptional<z.ZodString>;
     captionStyle: z.ZodOptional<z.ZodObject<{
         fontFamily: z.ZodOptional<z.ZodString>;
         fontSize: z.ZodOptional<z.ZodNumber>;

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

@@ -1 +1 @@
-{"version":3,"file":"videoPlan.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/videoPlan.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;;;;;iBAc5B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;iBASjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;EASnC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;EAS/B,CAAC;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc;;;;;;;;EAQzB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAY7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;EAQ9B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsC5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;iBAqC5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;;;GAUG;AACH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;;EAM9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAQ7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+I7B,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAa/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;;;;iBAkBxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;;;iBASvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgK1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"videoPlan.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/videoPlan.schema.ts"],"names":[],"mappings":"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"}

package/lib/schemas/videoPlan.schema.js

@@ -550,8 +550,27 @@ exports.VideoPlanSchema = zod_1.z.object({
      * into every consumer — executor validates at use-time.
      */
     voiceStyle: zod_1.z.string().optional(),
+    /**
+     * Language of the viewer-facing text in this plan (voiceoverLine,
+     * onScreenText, overlays, title). ISO 639-1 / "zh-cn". ORCHESTRATOR-ONLY:
+     * stamped from `brief.outputLanguage` post-parse, not filled by the LLM.
+     *
+     * The executor forwards it to TTS as `languageCode` and to caption ASR as a
+     * decode hint, so the spoken audio and the burned-in captions agree with the
+     * script instead of each independently guessing. Absent = English.
+     */
+    outputLanguage: zod_1.z.string().optional(),
     /** Free-form planner notes — e.g. why a particular tier mix was chosen. */
     notes: zod_1.z.string().optional(),
+    /**
+     * Reach per-recipient enrichment — URL of a brand logo to pin as a small
+     * corner overlay across the whole video ("product-aware" personalization).
+     * ORCHESTRATOR-ONLY: the planner LLM must NOT set this; the outreach fan-out
+     * injects the recipient's `logoUrl` post-plan (see resolvePlaceholdersDeep /
+     * outreachCampaignProcessor). When present, planToProject emits a contained
+     * logo ImageClip on the dedicated logo track. Absent → no logo overlay.
+     */
+    brandLogoUrl: zod_1.z.string().url().optional(),
     /**
      * CH-8 — caption styling applied to every CaptionClip at planToProject time.
      * Set by the chat `change_caption_style` tool; absent → renderer defaults