@vanillaskyai/video 0.1.0

package/dist/social-tweet-5OLCNPPC.js

@@ -0,0 +1,295 @@
+import {
+  stripPipe
+} from "./chunk-S7HFLYNN.js";
+import {
+  SceneBackground,
+  getMediaBackgroundProps
+} from "./chunk-IFOW65Z6.js";
+import {
+  renderWithEmoji
+} from "./chunk-L5BTTCZV.js";
+import {
+  autoTextColor
+} from "./chunk-ABZACD4G.js";
+import {
+  SPRING_SMOOTH,
+  interpolate,
+  spring
+} from "./chunk-XTOXFMLM.js";
+import {
+  resolveTokens
+} from "./chunk-FNAEQ7QO.js";
+
+// src/visual-system/primitives/social/TweetCard.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var CLAMP = { extrapolateLeft: "clamp", extrapolateRight: "clamp" };
+var X = {
+  cardBg: "#16181c",
+  cardBorder: "#2f3336",
+  text: "rgb(230, 230, 230)",
+  muted: "#71767b",
+  verified: "#1d9bf0"
+};
+function formatCount(n) {
+  const abs = Math.abs(n);
+  const sign = n < 0 ? "-" : "";
+  if (abs < 1e3) return n.toLocaleString();
+  if (abs < 1e4) {
+    const v2 = abs / 1e3;
+    const rounded = Number(v2.toFixed(1));
+    if (rounded < 10) return `${sign}${rounded.toString().replace(/\.0$/, "")}K`;
+  }
+  if (abs < 1e6) {
+    const k = Math.round(abs / 1e3);
+    if (k < 1e3) return `${sign}${k}K`;
+  }
+  if (abs < 1e7) {
+    const v2 = abs / 1e6;
+    const rounded = Number(v2.toFixed(1));
+    if (rounded < 10) return `${sign}${rounded.toString().replace(/\.0$/, "")}M`;
+  }
+  if (abs < 1e9) {
+    const m = Math.round(abs / 1e6);
+    if (m < 1e3) return `${sign}${m}M`;
+  }
+  const v = abs / 1e9;
+  return `${sign}${v.toFixed(1).replace(/\.0$/, "")}B`;
+}
+function hashHue(str) {
+  let h = 0;
+  for (let i = 0; i < str.length; i++) h = (h * 31 + str.charCodeAt(i)) % 360;
+  return h;
+}
+function deriveHandle(brandName) {
+  const slug = brandName.toLowerCase().replace(/[^a-z0-9]/g, "");
+  return slug ? `@${slug}` : "";
+}
+var XLogo = ({ size }) => /* @__PURE__ */ jsx("svg", { width: size, height: size, viewBox: "0 0 1200 1227", fill: "none", children: /* @__PURE__ */ jsx(
+  "path",
+  {
+    d: "M714.163 519.284 1160.89 0h-105.86L667.137 450.887 357.328 0H0l468.492 681.821L0 1226.37h105.866l409.625-476.152 327.181 476.152H1200L714.137 519.284h.026ZM569.165 687.828l-47.468-67.894-377.686-540.24h162.604l304.797 435.991 47.468 67.894 396.2 566.721H892.476L569.165 687.854v-.026Z",
+    fill: X.text
+  }
+) });
+var VerifiedBadge = ({ size }) => /* @__PURE__ */ jsx("svg", { width: size, height: size, viewBox: "0 0 22 22", fill: "none", children: /* @__PURE__ */ jsx(
+  "path",
+  {
+    d: "M20.396 11c-.018-.646-.215-1.275-.57-1.816-.354-.54-.852-.972-1.438-1.246.223-.607.27-1.264.14-1.897-.131-.634-.437-1.218-.882-1.687-.47-.445-1.053-.75-1.687-.882-.633-.13-1.29-.083-1.897.14-.273-.587-.704-1.086-1.245-1.44C12.276 1.819 11.647 1.62 11 1.604c-.646.017-1.273.213-1.813.568s-.969.854-1.24 1.44c-.608-.223-1.267-.272-1.902-.14-.635.13-1.22.436-1.69.882-.445.47-.749 1.055-.878 1.688-.13.633-.08 1.29.144 1.896-.587.274-1.087.705-1.443 1.245-.356.54-.555 1.17-.574 1.817.02.647.218 1.276.574 1.817.356.54.856.972 1.443 1.245-.224.606-.274 1.263-.144 1.896.13.634.433 1.218.877 1.688.47.443 1.054.747 1.687.878.633.132 1.29.084 1.897-.136.274.586.705 1.084 1.246 1.439.54.354 1.17.551 1.816.569.647-.016 1.276-.213 1.817-.567s.972-.854 1.245-1.44c.604.239 1.266.296 1.903.164.636-.132 1.22-.447 1.68-.907.46-.46.776-1.044.908-1.681s.075-1.299-.165-1.903c.586-.274 1.084-.705 1.439-1.246.354-.54.551-1.17.569-1.816zM9.662 14.85L6.8 12.46l1.41-1.42 2.262 2.26 4.798-5.23 1.47 1.36-6.198 6.77z",
+    fill: X.verified
+  }
+) });
+var CommentIcon = ({ size }) => /* @__PURE__ */ jsx("svg", { width: size, height: size, viewBox: "0 0 24 24", fill: "none", stroke: X.muted, strokeWidth: 1.8, strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx("path", { d: "M21 11.5a8.38 8.38 0 0 1-.9 3.8 8.5 8.5 0 0 1-7.6 4.7 8.38 8.38 0 0 1-3.8-.9L3 21l1.9-5.7a8.38 8.38 0 0 1-.9-3.8 8.5 8.5 0 0 1 4.7-7.6 8.38 8.38 0 0 1 3.8-.9h.5a8.48 8.48 0 0 1 8 8v.5z" }) });
+var HeartIcon = ({ size }) => /* @__PURE__ */ jsx("svg", { width: size, height: size, viewBox: "0 0 24 24", fill: "none", stroke: X.muted, strokeWidth: 1.8, strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx("path", { d: "M20.84 4.61a5.5 5.5 0 0 0-7.78 0L12 5.67l-1.06-1.06a5.5 5.5 0 0 0-7.78 7.78l1.06 1.06L12 21.23l7.78-7.78 1.06-1.06a5.5 5.5 0 0 0 0-7.78z" }) });
+var TweetCard = ({
+  progress,
+  motionProgress = progress,
+  authorName: rawName,
+  authorHandle: rawHandle,
+  authorVerified,
+  message: rawMessage,
+  targetLikes = 0,
+  targetReplies = 0,
+  accent,
+  width,
+  height,
+  beatIntensity = 0
+}) => {
+  const dim = Math.min(width, height);
+  const s = dim / 1080;
+  const resolvedAccent = accent || `hsl(${hashHue(String(rawName))}, 60%, 55%)`;
+  const authorName = stripPipe(rawName);
+  const customHandle = stripPipe(rawHandle || "").trim();
+  const authorHandle = customHandle || deriveHandle(authorName);
+  const isVerified = authorVerified !== false;
+  const message = stripPipe(rawMessage);
+  const initialChar = authorName.charAt(0).toUpperCase() || "\u2022";
+  const cardScale = spring(interpolate(motionProgress, [0, 0.24], [0, 1], CLAMP), SPRING_SMOOTH);
+  const cardOpacity = interpolate(motionProgress, [0, 0.18], [0, 1], CLAMP);
+  const replyCount = Math.round(interpolate(progress, [0.3, 0.75], [0, targetReplies], CLAMP));
+  const likeCount = Math.round(interpolate(progress, [0.35, 0.8], [0, targetLikes], CLAMP));
+  const replyDisplay = formatCount(replyCount);
+  const likeDisplay = formatCount(likeCount);
+  const replyIsTransient = replyDisplay !== formatCount(Math.round(targetReplies));
+  const likeIsTransient = likeDisplay !== formatCount(Math.round(targetLikes));
+  const beatScale = 1 + beatIntensity * 0.01;
+  const cardWidth = Math.min(width * 0.92, dim * 0.95);
+  const cardPad = dim * 0.05;
+  const cardRadius = dim * 0.026;
+  const avatarSize = dim * 0.09;
+  const xLogoSize = dim * 0.072;
+  const verifiedSize = dim * 0.028;
+  const nameFontSize = dim * 0.04;
+  const handleFontSize = dim * 0.03;
+  const messageFontSize = dim * 0.046;
+  const footerIconSize = dim * 0.032;
+  const footerFontSize = dim * 0.03;
+  const headerToBodyGap = dim * 0.028;
+  const bodyToFooterGap = dim * 0.032;
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      style: {
+        position: "absolute",
+        inset: 0,
+        display: "flex",
+        justifyContent: "center",
+        alignItems: "center"
+      },
+      children: /* @__PURE__ */ jsxs(
+        "div",
+        {
+          style: {
+            width: cardWidth,
+            backgroundColor: X.cardBg,
+            borderRadius: cardRadius,
+            padding: cardPad,
+            border: `1px solid ${X.cardBorder}`,
+            boxShadow: [
+              `0 ${1 * s}px ${3 * s}px 0 rgba(0,0,0,0.1)`,
+              `0 ${1 * s}px ${2 * s}px ${-1 * s}px rgba(0,0,0,0.1)`,
+              `0 ${20 * s}px ${60 * s}px rgba(0,0,0,0.45)`
+            ].join(", "),
+            opacity: cardOpacity,
+            transform: `scale(${cardScale * beatScale})`
+          },
+          children: [
+            /* @__PURE__ */ jsxs("div", { style: { display: "flex", alignItems: "center", gap: dim * 0.018 }, children: [
+              /* @__PURE__ */ jsx(
+                "div",
+                {
+                  style: {
+                    width: avatarSize,
+                    height: avatarSize,
+                    borderRadius: "50%",
+                    flexShrink: 0,
+                    overflow: "hidden",
+                    backgroundColor: resolvedAccent,
+                    display: "flex",
+                    alignItems: "center",
+                    justifyContent: "center"
+                  },
+                  children: /* @__PURE__ */ jsx("span", { style: { color: autoTextColor(resolvedAccent), fontSize: avatarSize * 0.46, fontWeight: 700, letterSpacing: -0.5, lineHeight: 1 }, children: initialChar })
+                }
+              ),
+              /* @__PURE__ */ jsxs("div", { style: { display: "flex", flexDirection: "column", flex: 1, minWidth: 0, gap: dim * 2e-3 }, children: [
+                /* @__PURE__ */ jsxs("div", { style: { display: "flex", alignItems: "center", gap: dim * 6e-3 }, children: [
+                  /* @__PURE__ */ jsx("span", { style: { color: X.text, fontSize: nameFontSize, fontWeight: 700, letterSpacing: -0.3, lineHeight: 1.1, whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis" }, children: authorName }),
+                  isVerified && /* @__PURE__ */ jsx(VerifiedBadge, { size: verifiedSize })
+                ] }),
+                /* @__PURE__ */ jsx("span", { style: { color: X.muted, fontSize: handleFontSize, fontWeight: 400, lineHeight: 1.1, whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis" }, children: authorHandle })
+              ] }),
+              /* @__PURE__ */ jsx("div", { style: { flexShrink: 0 }, children: /* @__PURE__ */ jsx(XLogo, { size: xLogoSize }) })
+            ] }),
+            /* @__PURE__ */ jsx("div", { style: { color: X.text, fontSize: messageFontSize, lineHeight: 1.4, letterSpacing: -0.1, marginTop: headerToBodyGap, wordBreak: "break-word" }, children: renderWithEmoji(message, messageFontSize) }),
+            /* @__PURE__ */ jsxs("div", { style: { display: "flex", alignItems: "center", gap: dim * 0.04, marginTop: bodyToFooterGap }, children: [
+              /* @__PURE__ */ jsxs("div", { style: { display: "flex", alignItems: "center", gap: dim * 8e-3 }, children: [
+                /* @__PURE__ */ jsx(CommentIcon, { size: footerIconSize }),
+                /* @__PURE__ */ jsx(
+                  "span",
+                  {
+                    "data-transition-semantic": replyIsTransient ? "transient" : void 0,
+                    style: {
+                      color: X.muted,
+                      fontSize: footerFontSize,
+                      fontVariantNumeric: "tabular-nums",
+                      ...replyIsTransient ? { visibility: "var(--vanillasky-transition-semantic-visibility,visible)" } : {}
+                    },
+                    children: replyDisplay
+                  }
+                )
+              ] }),
+              /* @__PURE__ */ jsxs("div", { style: { display: "flex", alignItems: "center", gap: dim * 8e-3 }, children: [
+                /* @__PURE__ */ jsx(HeartIcon, { size: footerIconSize }),
+                /* @__PURE__ */ jsx(
+                  "span",
+                  {
+                    "data-transition-semantic": likeIsTransient ? "transient" : void 0,
+                    style: {
+                      color: X.muted,
+                      fontSize: footerFontSize,
+                      fontVariantNumeric: "tabular-nums",
+                      ...likeIsTransient ? { visibility: "var(--vanillasky-transition-semantic-visibility,visible)" } : {}
+                    },
+                    children: likeDisplay
+                  }
+                )
+              ] })
+            ] })
+          ]
+        }
+      )
+    }
+  );
+};
+
+// src/visual-system/scene-templates/social-tweet.tsx
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var SocialTweetTemplate = ({
+  variables,
+  style,
+  progress,
+  motionProgress = progress,
+  beatIntensity,
+  width,
+  height,
+  sceneDuration,
+  isPlaying = true,
+  backgroundEffect
+}) => {
+  const authorName = String(variables.authorName || "Your brand");
+  const message = String(variables.message || "");
+  const { primary } = resolveTokens(style);
+  const seed = (authorName + message).split("").reduce((acc, c) => acc + c.charCodeAt(0), 0);
+  const verifiedRaw = variables.authorVerified;
+  const isVerified = verifiedRaw === true || String(verifiedRaw ?? "").toLowerCase() === "true";
+  return /* @__PURE__ */ jsxs2(
+    "div",
+    {
+      style: {
+        width,
+        height,
+        backgroundColor: "#000",
+        position: "relative",
+        overflow: "hidden",
+        fontFamily: "'Inter', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif"
+      },
+      children: [
+        /* @__PURE__ */ jsx2(
+          SceneBackground,
+          {
+            style,
+            progress,
+            sceneDuration,
+            width,
+            height,
+            ...getMediaBackgroundProps(variables),
+            backgroundEffect,
+            seed,
+            isPlaying,
+            beatIntensity
+          }
+        ),
+        /* @__PURE__ */ jsx2(
+          TweetCard,
+          {
+            progress,
+            motionProgress,
+            authorName,
+            authorHandle: String(variables.authorHandle || ""),
+            authorVerified: isVerified,
+            message,
+            targetLikes: Number(variables.likes) || 0,
+            targetReplies: Number(variables.replies) || 0,
+            accent: primary,
+            width,
+            height,
+            beatIntensity
+          }
+        )
+      ]
+    }
+  );
+};
+export {
+  SocialTweetTemplate
+};

package/dist/state-DZcKuS32.d.ts

@@ -0,0 +1,3 @@
+type VideoStatus = "idle" | "streaming" | "complete" | "error" | "aborted";
+
+export type { VideoStatus as V };

package/dist/system-prompt-A6UXNTPK.js

@@ -0,0 +1,8 @@
+import {
+  DEFAULT_VIDEO_SYSTEM_PROMPT,
+  VIDEO_PLAN_INSTRUCTION
+} from "./chunk-FQ47WXAJ.js";
+export {
+  DEFAULT_VIDEO_SYSTEM_PROMPT,
+  VIDEO_PLAN_INSTRUCTION
+};

package/dist/template-catalog.d.ts

@@ -0,0 +1,24 @@
+import { S as SceneTemplateMetadata, T as TemplateFamily, a as TemplateJob, b as TemplateRegister, c as TemplateTimingMetadata } from './catalog-types-BIhSpOWK.js';
+
+type BuiltinTemplateId = "media" | "reaction" | "confetti" | "emojiBurst" | "bigNumber" | "barChart" | "progressRing" | "phoneMockup" | "webMockup" | "codeEditor" | "terminal" | "tweet" | "notification" | "chatMessenger" | "chatWhatsapp" | "milestone" | "reviewStack" | "testimonial" | "incomingCall" | "brandMessage" | "promptInput" | "beforeAfter" | "tripleStats" | "problemSolution" | "cardList" | "steps" | "ctaLogo" | "ctaMedia";
+interface BuiltinTemplateManifestEntry extends SceneTemplateMetadata {
+    id: BuiltinTemplateId;
+    label: string;
+    description: string;
+    family: TemplateFamily;
+    jobs: TemplateJob[];
+    register: TemplateRegister;
+    useWhen: string;
+    avoidWhen: string;
+    textCanvas: "tight" | "open";
+    minDuration: number;
+    preferredDuration: number;
+    timing: TemplateTimingMetadata;
+}
+/**
+ * Canonical, serializable metadata for every bundled template.
+ * Schemas own defaults; this manifest owns discovery, selection, and timing hints.
+ */
+declare const BUILTIN_TEMPLATE_MANIFEST: readonly BuiltinTemplateManifestEntry[];
+
+export { type BuiltinTemplateId, type BuiltinTemplateManifestEntry as BuiltinTemplateMetadata, BUILTIN_TEMPLATE_MANIFEST as builtinTemplates };

package/dist/template-catalog.js

@@ -0,0 +1,6 @@
+import {
+  BUILTIN_TEMPLATE_MANIFEST
+} from "./chunk-W2XJKG6C.js";
+export {
+  BUILTIN_TEMPLATE_MANIFEST as builtinTemplates
+};

package/dist/templates.d.ts

@@ -0,0 +1,25 @@
+import { I as InferTemplateJsonSchema, S as SceneTemplateProps, a as SceneTemplate } from './kit-BMNcHqa9.js';
+export { T as TemplateRegistry, c as createTemplateRegistry } from './kit-BMNcHqa9.js';
+import { ComponentType } from 'react';
+import { d as TemplateJsonSchema, S as SceneTemplateMetadata } from './catalog-types-BIhSpOWK.js';
+export { T as TemplateFamily, c as TemplateTimingMetadata, e as TemplateTransitionTiming } from './catalog-types-BIhSpOWK.js';
+import './types-B-PZR6G_.js';
+
+interface TemplateExample<Variables extends Record<string, unknown> = Record<string, unknown>> {
+    name: string;
+    variables: Partial<Variables>;
+}
+type OptionalGlobalDefaults = Partial<Pick<SceneTemplateMetadata, "usesGlobalTextEffect" | "usesGlobalTransition" | "usesGlobalBackgroundEffect">>;
+type TemplateDefinitionMetadata = Omit<SceneTemplateMetadata, "id" | "useWhen" | "schema" | keyof OptionalGlobalDefaults> & OptionalGlobalDefaults;
+type TemplateDefinition<Schema extends TemplateJsonSchema = TemplateJsonSchema> = TemplateDefinitionMetadata & {
+    id: string;
+    useWhen: string;
+    schema: Schema;
+    examples?: readonly TemplateExample<InferTemplateJsonSchema<Schema>>[];
+    component: ComponentType<SceneTemplateProps<InferTemplateJsonSchema<Schema>>>;
+};
+declare function defineTemplate<const Schema extends TemplateJsonSchema>(definition: TemplateDefinition<Schema>): SceneTemplate<InferTemplateJsonSchema<Schema>> & {
+    examples?: readonly TemplateExample<InferTemplateJsonSchema<Schema>>[];
+};
+
+export { SceneTemplate, SceneTemplateMetadata, SceneTemplateProps, type TemplateDefinition, type TemplateExample, TemplateJsonSchema, defineTemplate };

package/dist/templates.js

@@ -0,0 +1,19 @@
+import {
+  createTemplateRegistry,
+  defineTemplate
+} from "./chunk-CR7FE7BW.js";
+import "./chunk-2E6T633S.js";
+
+// src/templates.ts
+function defineTemplate2(definition) {
+  if (Object.hasOwn(definition, "duration")) {
+    throw new Error("Template duration is not supported; use preferredDuration");
+  }
+  return defineTemplate(
+    definition
+  );
+}
+export {
+  createTemplateRegistry,
+  defineTemplate2 as defineTemplate
+};

package/dist/test.d.ts

@@ -0,0 +1,149 @@
+import { f as VideoScene, e as VideoOrientation, g as VideoStyle, V as Video, a as VideoAudio, d as VideoInput } from './types-B-PZR6G_.js';
+import { a as VideoWarning, b as VideoFinishReason } from './events-_wfjbmEp.js';
+
+type MockVideoStreamPart = {
+    type: "scene.add";
+    scene: VideoScene;
+} | {
+    type: "scene.patch";
+    sceneId: string;
+    patch: Partial<Omit<VideoScene, "id" | "templateId">>;
+} | {
+    type: "asset.patch";
+    sceneId: string;
+    variables: Record<string, unknown>;
+} | {
+    type: "plan.complete";
+    finishReason?: "stop" | "length" | "content-filter" | "other";
+} | {
+    type: "plan.error";
+    error: {
+        message: string;
+        code?: string;
+        recoverable?: boolean;
+    };
+} | {
+    type: "mock.delay";
+    durationMs: number;
+} | {
+    type: "mock.raw";
+    text: string;
+} | {
+    type: "mock.error";
+    message: string;
+} | {
+    type: "mock.wait-for-abort";
+};
+interface VideoGenerationFixture {
+    input: VideoInput;
+    parts: readonly MockVideoStreamPart[];
+}
+interface MockVideoPlannerContext {
+    request: {
+        requestId: string;
+    };
+    signal: AbortSignal;
+}
+interface MockProviderTextStream {
+    textStream: AsyncIterable<string>;
+    finishReason: Promise<"stop" | "length" | "content-filter">;
+}
+type SimulatedEventEnvelope<TType extends string, TData> = {
+    protocolVersion: "0.4";
+    runId: string;
+    sequence: number;
+    eventId: string;
+    type: TType;
+    data: TData;
+};
+type SimulatedVideoEvent = SimulatedEventEnvelope<"response.start", {
+    requestId: string;
+    format: {
+        orientation: VideoOrientation;
+    };
+    style: VideoStyle;
+    meta?: Video["meta"];
+    capabilities?: {
+        templates?: string[];
+        extensions?: string[];
+    };
+}> | SimulatedEventEnvelope<"audio.set", {
+    audio: VideoAudio;
+}> | SimulatedEventEnvelope<"scene.add", {
+    scene: VideoScene;
+    position: number;
+    revision: number;
+}> | SimulatedEventEnvelope<"scene.patch", {
+    sceneId: string;
+    revision: number;
+    patch: Partial<Omit<VideoScene, "id" | "templateId">>;
+}> | SimulatedEventEnvelope<"asset.patch", {
+    sceneId: string;
+    revision: number;
+    variables: Record<string, unknown>;
+}> | SimulatedEventEnvelope<"response.warning", {
+    warning: VideoWarning;
+}> | SimulatedEventEnvelope<"response.complete", {
+    finishReason: VideoFinishReason;
+    snapshot: Video;
+    checksum: string;
+}> | SimulatedEventEnvelope<"response.error", {
+    error: {
+        code: string;
+        message: string;
+        recoverable: boolean;
+    };
+    terminal: boolean;
+    snapshot?: Video;
+}> | SimulatedEventEnvelope<"response.abort", {
+    reason: string;
+    snapshot?: Video;
+}> | SimulatedEventEnvelope<`data.${string}`, unknown>;
+
+interface MockVideoPlannerOptions {
+    /** Select one of the fixed public scenarios. Defaults to `success`. */
+    scenario?: "success" | "delayed" | "truncated" | "invalidScene" | "providerFailure" | "contentFilter" | "abort" | "timeout";
+    /** Replace the selected scenario with custom structural provider plan parts. */
+    parts?: readonly MockVideoStreamPart[];
+    /** Add a deterministic delay before every emitted provider text chunk. */
+    delayMs?: number;
+}
+/**
+ * Create the structural `streamText` function accepted by `createVideoHandler`.
+ * It emits deterministic provider-style NDJSON and never constructs SDK events.
+ */
+declare function createMockVideoPlanner(options?: MockVideoPlannerOptions): (context: MockVideoPlannerContext) => MockProviderTextStream;
+
+interface SimulatedVideoStreamOptions {
+    /** Grounded input used by the in-process runtime. Defaults to the portrait fixture input. */
+    input?: VideoInput;
+    /** Stable request ID used in response.start. Defaults to `test-request`. */
+    requestId?: string;
+    /** Stable run ID used for event IDs. Defaults to `test-run`. */
+    runId?: string;
+    /** Abort the simulation and emit a partial response.abort event. */
+    signal?: AbortSignal;
+    /** Abort after this deterministic timer delay with the public `Request timed out` reason. */
+    timeoutMs?: number;
+    /** Drop invalid generated parts by default, or make them terminal. */
+    invalidPartBehavior?: "drop" | "fail";
+}
+/** Run provider plan parts through the real protocol runtime without a server. */
+declare function simulateVideoStream(parts: readonly MockVideoStreamPart[], options?: SimulatedVideoStreamOptions): AsyncGenerator<SimulatedVideoEvent>;
+
+declare const videoFixtures: {
+    portrait: VideoGenerationFixture;
+    landscape: VideoGenerationFixture;
+    scenarios: {
+        success: readonly MockVideoStreamPart[];
+        delayed: readonly MockVideoStreamPart[];
+        truncated: readonly MockVideoStreamPart[];
+        invalidScene: readonly MockVideoStreamPart[];
+        providerFailure: readonly MockVideoStreamPart[];
+        contentFilter: readonly MockVideoStreamPart[];
+        abort: readonly MockVideoStreamPart[];
+        timeout: readonly MockVideoStreamPart[];
+    };
+};
+
+export { type MockVideoPlannerOptions, type SimulatedVideoStreamOptions, createMockVideoPlanner, simulateVideoStream, videoFixtures };