@cueframe/kernel 0.1.3 → 0.1.4

package/dist/media-model/media-kind.js

@@ -1,13 +1,102 @@
-import {
-  ALLOWED_CONTENT_TYPES,
-  IMAGE_CONTENT_TYPES,
-  POOL_EXTENSIONS,
-  contentTypeForUpload,
-  extensionForContentType,
-  mediaKind,
-  mediaKindForFilename
-} from "../chunk-6IU2UQI5.js";
 import "../chunk-2ESYSVXG.js";
+
+// ../data-models/media-model/src/media-kind.ts
+var IMAGE_CONTENT_TYPES = ["image/png", "image/jpeg", "image/webp"];
+var ALLOWED_CONTENT_TYPES = [
+  "video/mp4",
+  "video/quicktime",
+  "video/x-matroska",
+  "video/webm",
+  "audio/mpeg",
+  "audio/wav",
+  "audio/x-wav",
+  "audio/mp4",
+  "audio/aac",
+  "image/png",
+  "image/jpeg",
+  "image/webp",
+  "image/gif",
+  "image/svg+xml",
+  "application/json",
+  "font/ttf",
+  "font/otf",
+  "font/woff",
+  "font/woff2"
+];
+function mediaKind(contentType) {
+  const ct = (contentType || "").toLowerCase();
+  if (ct.startsWith("video/")) return "video";
+  if (ct.startsWith("audio/")) return "audio";
+  if (IMAGE_CONTENT_TYPES.includes(ct)) return "image";
+  return "opaque";
+}
+var EXT = {
+  "video/mp4": "mp4",
+  "audio/mp4": "mp4",
+  "video/quicktime": "mov",
+  "video/x-matroska": "mkv",
+  "video/webm": "webm",
+  "video/x-msvideo": "avi",
+  "audio/mpeg": "mp3",
+  "audio/wav": "wav",
+  "audio/x-wav": "wav",
+  "audio/aac": "aac",
+  "audio/ogg": "ogg",
+  "audio/flac": "flac",
+  "image/png": "png",
+  "image/jpeg": "jpg",
+  "image/webp": "webp",
+  "font/ttf": "ttf",
+  "font/otf": "otf",
+  "font/woff": "woff",
+  "font/woff2": "woff2",
+  "application/json": "json",
+  "image/svg+xml": "svg",
+  "image/gif": "gif"
+};
+function extensionForContentType(contentType) {
+  return EXT[(contentType || "").toLowerCase()] ?? "bin";
+}
+var CONTENT_TYPE_ALIASES = {
+  "audio/mp3": "audio/mpeg",
+  "audio/x-mp3": "audio/mpeg",
+  "audio/x-mpeg": "audio/mpeg",
+  "audio/mpeg3": "audio/mpeg",
+  "audio/x-mpeg-3": "audio/mpeg",
+  "audio/x-m4a": "audio/mp4",
+  "audio/m4a": "audio/mp4",
+  "audio/wave": "audio/wav",
+  "audio/vnd.wave": "audio/wav",
+  "audio/x-aac": "audio/aac",
+  "image/jpg": "image/jpeg",
+  "video/x-quicktime": "video/quicktime",
+  "video/mov": "video/quicktime",
+  "video/x-m4v": "video/mp4",
+  "video/mkv": "video/x-matroska"
+};
+var TYPE_BY_EXTENSION = Object.entries(EXT).reduce(
+  (acc, [contentType, ext]) => {
+    if (!(ext in acc)) acc[ext] = contentType;
+    return acc;
+  },
+  {}
+);
+TYPE_BY_EXTENSION["jpeg"] = "image/jpeg";
+TYPE_BY_EXTENSION["m4a"] = "audio/mp4";
+function mediaKindForFilename(filename) {
+  return mediaKind(contentTypeForUpload(filename, null));
+}
+var POOL_EXTENSIONS = Object.entries(TYPE_BY_EXTENSION).filter(([, contentType]) => mediaKind(contentType) !== "opaque").map(([ext]) => ext);
+function contentTypeForUpload(filename, claimed) {
+  const ct = (claimed ?? "").trim().toLowerCase();
+  const allowed = ALLOWED_CONTENT_TYPES;
+  if (ct && allowed.includes(ct)) return ct;
+  if (ct && CONTENT_TYPE_ALIASES[ct]) return CONTENT_TYPE_ALIASES[ct];
+  const ext = filename.toLowerCase().split(".").pop() ?? "";
+  const byExt = TYPE_BY_EXTENSION[ext];
+  if (byExt) return byExt;
+  return ct;
+}
 export {
   ALLOWED_CONTENT_TYPES,
   IMAGE_CONTENT_TYPES,

package/dist/media-model.js

@@ -22,9 +22,14 @@ import "./chunk-XELS2BGA.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../data-models/media-model/src/api.ts
+import { z as z2 } from "zod";
+
+// ../data-models/media-model/src/opaqueId.ts
 import { z } from "zod";
-import { zid } from "convex-helpers/server/zod3";
-var MediaProcessingPhase = z.enum([
+var OpaqueId = z.string();
+
+// ../data-models/media-model/src/api.ts
+var MediaProcessingPhase = z2.enum([
   "idle",
   "pending_import",
   "pending_upload",
@@ -43,114 +48,114 @@ var MediaProcessingPhase = z.enum([
   "error",
   "cancelled"
 ]);
-var ProxyStatus = z.enum([
+var ProxyStatus = z2.enum([
   "none",
   "generating",
   "ready",
   "failed"
 ]);
-var MediaProcessingStatus = z.object({
+var MediaProcessingStatus = z2.object({
   phase: MediaProcessingPhase,
-  percent: z.number().nullable().optional(),
-  message: z.string().nullable().optional(),
-  error: z.string().nullable().optional()
+  percent: z2.number().nullable().optional(),
+  message: z2.string().nullable().optional(),
+  error: z2.string().nullable().optional()
 });
-var MediaUnderstanding = z.object({
-  summary: z.string().optional(),
-  topics: z.array(z.string()).optional(),
-  language: z.string().optional(),
-  notes: z.string().optional(),
-  extra: z.record(z.string(), z.unknown()).optional()
+var MediaUnderstanding = z2.object({
+  summary: z2.string().optional(),
+  topics: z2.array(z2.string()).optional(),
+  language: z2.string().optional(),
+  notes: z2.string().optional(),
+  extra: z2.record(z2.string(), z2.unknown()).optional()
 });
-var TextToSpeechGeneration = z.object({
-  kind: z.literal("text-to-speech"),
-  provider: z.string().min(1),
-  text: z.string().min(1),
-  voice: z.string().min(1),
-  params: z.record(z.string(), z.unknown()).optional()
+var TextToSpeechGeneration = z2.object({
+  kind: z2.literal("text-to-speech"),
+  provider: z2.string().min(1),
+  text: z2.string().min(1),
+  voice: z2.string().min(1),
+  params: z2.record(z2.string(), z2.unknown()).optional()
 });
-var TextToImageGeneration = z.object({
-  kind: z.literal("text-to-image"),
-  provider: z.string().min(1),
-  prompt: z.string().min(1),
-  params: z.record(z.string(), z.unknown()).optional()
+var TextToImageGeneration = z2.object({
+  kind: z2.literal("text-to-image"),
+  provider: z2.string().min(1),
+  prompt: z2.string().min(1),
+  params: z2.record(z2.string(), z2.unknown()).optional()
 });
-var ImageToVideoGeneration = z.object({
-  kind: z.literal("image-to-video"),
-  provider: z.string().min(1),
-  sourceMediaId: zid("mediaItems"),
-  prompt: z.string().optional(),
-  params: z.record(z.string(), z.unknown()).optional()
+var ImageToVideoGeneration = z2.object({
+  kind: z2.literal("image-to-video"),
+  provider: z2.string().min(1),
+  sourceMediaId: OpaqueId,
+  prompt: z2.string().optional(),
+  params: z2.record(z2.string(), z2.unknown()).optional()
 });
-var ManimGeneration = z.object({
-  kind: z.literal("manim"),
-  scriptId: z.string().optional(),
-  inlineScript: z.string().optional(),
-  params: z.record(z.string(), z.unknown()).optional()
+var ManimGeneration = z2.object({
+  kind: z2.literal("manim"),
+  scriptId: z2.string().optional(),
+  inlineScript: z2.string().optional(),
+  params: z2.record(z2.string(), z2.unknown()).optional()
 });
-var Generation = z.discriminatedUnion("kind", [
+var Generation = z2.discriminatedUnion("kind", [
   TextToSpeechGeneration,
   TextToImageGeneration,
   ImageToVideoGeneration,
   ManimGeneration
 ]);
-var TranscriptRef = z.object({
-  id: z.string().min(1),
-  ready: z.boolean()
+var TranscriptRef = z2.object({
+  id: z2.string().min(1),
+  ready: z2.boolean()
 });
-var FrameAnalysis = z.object({
-  t: z.number().nonnegative(),
-  faces: z.array(
-    z.object({
-      bbox: z.tuple([z.number(), z.number(), z.number(), z.number()]),
-      confidence: z.number().min(0).max(1).optional()
+var FrameAnalysis = z2.object({
+  t: z2.number().nonnegative(),
+  faces: z2.array(
+    z2.object({
+      bbox: z2.tuple([z2.number(), z2.number(), z2.number(), z2.number()]),
+      confidence: z2.number().min(0).max(1).optional()
     })
   ).optional(),
-  primarySubject: z.object({
-    bbox: z.tuple([z.number(), z.number(), z.number(), z.number()])
+  primarySubject: z2.object({
+    bbox: z2.tuple([z2.number(), z2.number(), z2.number(), z2.number()])
   }).optional(),
-  safeRegions: z.array(
-    z.object({
-      bbox: z.tuple([z.number(), z.number(), z.number(), z.number()]),
-      kind: z.string().optional()
+  safeRegions: z2.array(
+    z2.object({
+      bbox: z2.tuple([z2.number(), z2.number(), z2.number(), z2.number()]),
+      kind: z2.string().optional()
     })
   ).optional(),
-  dominantColors: z.array(z.string()).optional()
+  dominantColors: z2.array(z2.string()).optional()
 });
-var Filmstrip = z.object({
-  mediaId: zid("mediaItems"),
-  sheetUrl: z.string().url(),
-  frameCount: z.number().int().positive(),
-  frameInterval: z.number().positive(),
-  frameWidth: z.number().int().positive(),
-  frameHeight: z.number().int().positive(),
-  columns: z.number().int().positive()
+var Filmstrip = z2.object({
+  mediaId: OpaqueId,
+  sheetUrl: z2.string().url(),
+  frameCount: z2.number().int().positive(),
+  frameInterval: z2.number().positive(),
+  frameWidth: z2.number().int().positive(),
+  frameHeight: z2.number().int().positive(),
+  columns: z2.number().int().positive()
 });
-var Perception = z.object({
-  mediaId: zid("mediaItems"),
+var Perception = z2.object({
+  mediaId: OpaqueId,
   filmstrip: Filmstrip.optional(),
-  frameAnalysis: z.array(FrameAnalysis).optional()
+  frameAnalysis: z2.array(FrameAnalysis).optional()
 });
-var MediaItem = z.object({
-  id: zid("mediaItems"),
-  kind: z.enum(["video", "audio", "image"]),
-  filename: z.string().min(1),
-  mimeType: z.string().min(1),
-  size: z.number().int().nonnegative(),
-  duration: z.number().nonnegative().optional(),
+var MediaItem = z2.object({
+  id: OpaqueId,
+  kind: z2.enum(["video", "audio", "image"]),
+  filename: z2.string().min(1),
+  mimeType: z2.string().min(1),
+  size: z2.number().int().nonnegative(),
+  duration: z2.number().nonnegative().optional(),
   // seconds; populated post-transcode
-  width: z.number().int().positive().optional(),
-  height: z.number().int().positive().optional(),
-  fps: z.number().positive().optional(),
+  width: z2.number().int().positive().optional(),
+  height: z2.number().int().positive().optional(),
+  fps: z2.number().positive().optional(),
   status: MediaProcessingPhase,
-  source: z.enum(["upload", "generated"]).optional(),
+  source: z2.enum(["upload", "generated"]).optional(),
   generation: Generation.optional(),
   transcript: TranscriptRef.optional(),
   mediaUnderstanding: MediaUnderstanding.optional(),
   perception: Perception.optional(),
-  createdAt: z.number(),
-  updatedAt: z.number(),
-  ownerOrgId: z.string().optional()
+  createdAt: z2.number(),
+  updatedAt: z2.number(),
+  ownerOrgId: z2.string().optional()
 });
 export {
   ClientRequestId,
@@ -176,6 +181,7 @@ export {
   MediaProcessingPhase,
   MediaProcessingStatus,
   MediaUnderstanding,
+  OpaqueId,
   Perception,
   ProjectHome,
   ProxyStatus,

package/dist/nle-export.js

@@ -1,42 +1,42 @@
-import "./chunk-TXSFYUZH.js";
+import "./chunk-QSDFTYKV.js";
 import {
   getPrimitiveText
-} from "./chunk-HBVAZXYO.js";
+} from "./chunk-YE3F4LNJ.js";
 import "./chunk-H5LMJKZU.js";
-import "./chunk-MFHXCHRI.js";
 import "./chunk-JQMPHKLU.js";
 import "./chunk-MHOQTPOB.js";
 import "./chunk-GULDS3VE.js";
 import "./chunk-YLDMAZZE.js";
-import "./chunk-BKHGL4MB.js";
-import "./chunk-GMD33ZD7.js";
-import "./chunk-SAMQUUO5.js";
-import "./chunk-RP4SXXLJ.js";
-import "./chunk-DYZE7JZA.js";
-import "./chunk-ZSZABOE5.js";
-import "./chunk-UQSOS726.js";
+import "./chunk-MFHXCHRI.js";
+import "./chunk-TMIBBD5E.js";
+import "./chunk-6ABIXGLO.js";
 import "./chunk-DLF4WVSE.js";
 import "./chunk-U4V4FZGE.js";
-import "./chunk-BDMTUEEZ.js";
-import "./chunk-EMGFZ3PR.js";
 import "./chunk-AWT3P5ZN.js";
 import "./chunk-QGAWDLYX.js";
-import "./chunk-G5BFI32U.js";
-import "./chunk-XHGZ2E77.js";
+import "./chunk-THJAY7QS.js";
+import "./chunk-ZSZABOE5.js";
+import "./chunk-XATRRDVG.js";
+import "./chunk-O7GNE4BQ.js";
+import "./chunk-BIBYZJL3.js";
+import "./chunk-BDMTUEEZ.js";
+import "./chunk-EMGFZ3PR.js";
 import "./chunk-ZFEXATWN.js";
+import "./chunk-3PM6VICZ.js";
 import "./chunk-CX2IIQ4R.js";
-import "./chunk-DCVJWGIA.js";
-import "./chunk-NQSMEUJ6.js";
+import "./chunk-XHGZ2E77.js";
+import "./chunk-JY26PIRP.js";
+import "./chunk-RXCEPCAQ.js";
 import "./chunk-QH3YI3ND.js";
-import "./chunk-ZPRBGW4Y.js";
 import "./chunk-23HFEKV7.js";
+import "./chunk-7TQCR7AB.js";
 import "./chunk-VZ7TYX6Z.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-JF4JJAFP.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-AW57IWNW.js";
+import "./chunk-R5BMJ2NX.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../nle-export/src/srt.ts

package/dist/primitives/backgrounds.js

@@ -11,9 +11,9 @@ import {
   VectorField,
   VolumetricRays,
   catalog
-} from "../chunk-G5BFI32U.js";
-import "../chunk-XHGZ2E77.js";
+} from "../chunk-XATRRDVG.js";
 import "../chunk-CX2IIQ4R.js";
+import "../chunk-XHGZ2E77.js";
 import "../chunk-2ESYSVXG.js";
 export {
   AnimatedBarChart,

package/dist/primitives/captions.js

@@ -1,9 +1,9 @@
-import {
-  fillStyle
-} from "../chunk-XLIPPLG3.js";
 import {
   Marker
 } from "../chunk-D2EG7J7X.js";
+import {
+  fillStyle
+} from "../chunk-XLIPPLG3.js";
 import {
   wordPop
 } from "../chunk-ZFEXATWN.js";

package/dist/primitives/effects.js

@@ -10,9 +10,9 @@ import {
   SuccessConfetti,
   Vignette,
   catalog
-} from "../chunk-GMD33ZD7.js";
-import "../chunk-XHGZ2E77.js";
+} from "../chunk-O7GNE4BQ.js";
 import "../chunk-CX2IIQ4R.js";
+import "../chunk-XHGZ2E77.js";
 import "../chunk-2ESYSVXG.js";
 export {
   Blur,

package/dist/primitives/hero-text.js

@@ -1,11 +1,11 @@
 import {
   HeroText,
   catalog
-} from "../chunk-SAMQUUO5.js";
+} from "../chunk-BIBYZJL3.js";
 import "../chunk-BDMTUEEZ.js";
 import "../chunk-EMGFZ3PR.js";
-import "../chunk-XHGZ2E77.js";
 import "../chunk-ZFEXATWN.js";
+import "../chunk-XHGZ2E77.js";
 import "../chunk-2ESYSVXG.js";
 export {
   HeroText,

package/dist/primitives/layouts.js

@@ -7,9 +7,9 @@ import {
   SplitScreen,
   StaggeredBentoGrid,
   catalog
-} from "../chunk-RP4SXXLJ.js";
-import "../chunk-XHGZ2E77.js";
+} from "../chunk-3PM6VICZ.js";
 import "../chunk-CX2IIQ4R.js";
+import "../chunk-XHGZ2E77.js";
 import "../chunk-2ESYSVXG.js";
 export {
   ChatToPreviewLayout,

package/dist/primitives/lib/index.js

@@ -1,16 +1,4 @@
 import "../../chunk-H5LMJKZU.js";
-import {
-  EASING_BY_INTENT,
-  IN_OUT_CUBIC,
-  IN_OUT_QUART,
-  IN_QUART,
-  LINEAR,
-  OUT_BACK,
-  OUT_CUBIC,
-  OUT_EXPO,
-  SOFT,
-  STEP
-} from "../../chunk-MFHXCHRI.js";
 import {
   PrimitivePreview
 } from "../../chunk-JQMPHKLU.js";
@@ -36,6 +24,18 @@ import {
   resolveParams,
   resolveTokenValue
 } from "../../chunk-YLDMAZZE.js";
+import {
+  EASING_BY_INTENT,
+  IN_OUT_CUBIC,
+  IN_OUT_QUART,
+  IN_QUART,
+  LINEAR,
+  OUT_BACK,
+  OUT_CUBIC,
+  OUT_EXPO,
+  SOFT,
+  STEP
+} from "../../chunk-MFHXCHRI.js";
 import {
   palette_exports
 } from "../../chunk-CX2IIQ4R.js";

package/dist/primitives/lib.js

@@ -1,16 +1,4 @@
 import "../chunk-H5LMJKZU.js";
-import {
-  EASING_BY_INTENT,
-  IN_OUT_CUBIC,
-  IN_OUT_QUART,
-  IN_QUART,
-  LINEAR,
-  OUT_BACK,
-  OUT_CUBIC,
-  OUT_EXPO,
-  SOFT,
-  STEP
-} from "../chunk-MFHXCHRI.js";
 import {
   PrimitivePreview
 } from "../chunk-JQMPHKLU.js";
@@ -36,6 +24,18 @@ import {
   resolveParams,
   resolveTokenValue
 } from "../chunk-YLDMAZZE.js";
+import {
+  EASING_BY_INTENT,
+  IN_OUT_CUBIC,
+  IN_OUT_QUART,
+  IN_QUART,
+  LINEAR,
+  OUT_BACK,
+  OUT_CUBIC,
+  OUT_EXPO,
+  SOFT,
+  STEP
+} from "../chunk-MFHXCHRI.js";
 import {
   palette_exports
 } from "../chunk-CX2IIQ4R.js";

package/dist/primitives/scenes.js

@@ -7,9 +7,9 @@ import {
   ProductLaunchTrailer,
   TerminalToBrowserDeploy,
   catalog
-} from "../chunk-DYZE7JZA.js";
-import "../chunk-ZSZABOE5.js";
+} from "../chunk-TMIBBD5E.js";
 import "../chunk-QGAWDLYX.js";
+import "../chunk-ZSZABOE5.js";
 import "../chunk-CX2IIQ4R.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/primitives/text.js

@@ -21,14 +21,14 @@ import {
   TrackingIn,
   Typewriter,
   catalog
-} from "../chunk-UQSOS726.js";
+} from "../chunk-6ABIXGLO.js";
 import "../chunk-DLF4WVSE.js";
 import "../chunk-U4V4FZGE.js";
 import "../chunk-BDMTUEEZ.js";
 import "../chunk-EMGFZ3PR.js";
-import "../chunk-XHGZ2E77.js";
 import "../chunk-ZFEXATWN.js";
 import "../chunk-CX2IIQ4R.js";
+import "../chunk-XHGZ2E77.js";
 import "../chunk-2ESYSVXG.js";
 export {
   BlurReveal,

package/dist/primitives/ui-blocks.js

@@ -30,14 +30,14 @@ import {
   VisualDocsSnippet,
   VoiceWaveform,
   catalog
-} from "../chunk-BKHGL4MB.js";
+} from "../chunk-THJAY7QS.js";
 import {
   DashboardPopulate
 } from "../chunk-ZSZABOE5.js";
 import "../chunk-BDMTUEEZ.js";
 import "../chunk-EMGFZ3PR.js";
-import "../chunk-XHGZ2E77.js";
 import "../chunk-CX2IIQ4R.js";
+import "../chunk-XHGZ2E77.js";
 import "../chunk-2ESYSVXG.js";
 export {
   AIGenerateOverlay,

package/dist/primitives.js

@@ -1,36 +1,36 @@
-import {
-  catalog as catalog6
-} from "./chunk-BKHGL4MB.js";
-import {
-  catalog as catalog2
-} from "./chunk-GMD33ZD7.js";
-import {
-  catalog as catalog8
-} from "./chunk-SAMQUUO5.js";
-import {
-  catalog as catalog4
-} from "./chunk-RP4SXXLJ.js";
 import {
   catalog as catalog7
-} from "./chunk-DYZE7JZA.js";
-import "./chunk-ZSZABOE5.js";
+} from "./chunk-TMIBBD5E.js";
 import {
   catalog
-} from "./chunk-UQSOS726.js";
+} from "./chunk-6ABIXGLO.js";
 import "./chunk-DLF4WVSE.js";
 import "./chunk-U4V4FZGE.js";
-import "./chunk-BDMTUEEZ.js";
-import "./chunk-EMGFZ3PR.js";
 import {
   catalog as catalog3
 } from "./chunk-AWT3P5ZN.js";
 import "./chunk-QGAWDLYX.js";
+import {
+  catalog as catalog6
+} from "./chunk-THJAY7QS.js";
+import "./chunk-ZSZABOE5.js";
 import {
   catalog as catalog5
-} from "./chunk-G5BFI32U.js";
-import "./chunk-XHGZ2E77.js";
+} from "./chunk-XATRRDVG.js";
+import {
+  catalog as catalog2
+} from "./chunk-O7GNE4BQ.js";
+import {
+  catalog as catalog8
+} from "./chunk-BIBYZJL3.js";
+import "./chunk-BDMTUEEZ.js";
+import "./chunk-EMGFZ3PR.js";
 import "./chunk-ZFEXATWN.js";
+import {
+  catalog as catalog4
+} from "./chunk-3PM6VICZ.js";
 import "./chunk-CX2IIQ4R.js";
+import "./chunk-XHGZ2E77.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../execution/primitives/src/index.ts

package/dist/render-harness.js

@@ -739,7 +739,8 @@ async function renderComponentAlpha(opts) {
     browserExecutable,
     chromiumOptions: SOFTWARE_CHROMIUM_OPTIONS
   });
-  const videoPath = join5(cacheDir(opts.ws), `alpha-${opts.id}.${alphaExt(codec)}`);
+  const rangeSuffix = opts.frameRange ? `-${opts.frameRange[0]}-${opts.frameRange[1]}` : "";
+  const videoPath = join5(cacheDir(opts.ws), `alpha-${opts.id}${rangeSuffix}.${alphaExt(codec)}`);
   await renderMedia({
     composition,
     serveUrl,
@@ -748,7 +749,8 @@ async function renderComponentAlpha(opts) {
     outputLocation: videoPath,
     ...alphaRenderConfig(codec),
     chromiumOptions: SOFTWARE_CHROMIUM_OPTIONS,
-    concurrency: 1
+    concurrency: 1,
+    ...opts.frameRange ? { frameRange: opts.frameRange } : {}
   });
   return { videoPath };
 }