mulmocast 2.1.24 → 2.1.26

package/lib/data/styles.js

@@ -0,0 +1,284 @@
+export const styles = [
+    {
+        filename: 'akira_comic',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                images: {
+                    girl: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/akira_presenter.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>AKIRA aesthetic.</style>'
+            }
+        }
+    },
+    {
+        filename: 'ani',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            audioParams: {
+                bgm: {
+                    kind: 'url',
+                    url: 'https://github.com/receptron/mulmocast-media/raw/refs/heads/main/bgms/morning001.mp3'
+                }
+            },
+            canvasSize: {
+                height: 1536,
+                width: 1024
+            },
+            imageParams: {
+                images: {
+                    ani: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ani.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                model: 'gemini-2.5-flash-image',
+                provider: 'google',
+                style: '<style>A highly polished 2D digital illustration in anime and manga style, featuring clean linework, soft shading, vivid colors, and expressive facial detailing. The composition emphasizes clarity and visual impact with a minimalistic background and a strong character focus. The lighting is even and bright, giving the image a crisp and energetic feel, reminiscent of high-quality character art used in Japanese visual novels or mobile games.</style>'
+            },
+            movieParams: {
+                model: 'bytedance/seedance-1-lite',
+                provider: 'replicate'
+            },
+            speechParams: {
+                speakers: {
+                    Presenter: {
+                        provider: 'gemini',
+                        speechOptions: {
+                            instruction: 'Speak in a slightly high-pitched, curt tone with sudden flustered shifts—like a tsundere anime girl.'
+                        },
+                        voiceId: 'Leda'
+                    }
+                }
+            }
+        }
+    },
+    {
+        filename: 'children_book',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                style: 'A hand-drawn style illustration with a warm, nostalgic atmosphere. The background is rich with natural scenery—lush forests, cloudy skies, and traditional Japanese architecture. Characters have expressive eyes, soft facial features, and are portrayed with gentle lighting and subtle shading. The color palette is muted yet vivid, using earthy tones and watercolor-like textures. The overall scene feels magical and peaceful, with a sense of quiet wonder and emotional depth, reminiscent of classic 1980s and 1990s Japanese animation.'
+            }
+        }
+    },
+    {
+        filename: 'comic_strips',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                style: '<style>A multi panel comic strips. 1990s American workplace humor. Clean, minimalist line art with muted colors. One character is a nerdy office worker with glasses</style>'
+            }
+        }
+    },
+    {
+        filename: 'drslump_comic',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                images: {
+                    girl: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/slump_presenter.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>Dragon Ball/Dr. Slump aesthetic.</style>'
+            }
+        }
+    },
+    {
+        filename: 'ghibli_comic',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                images: {
+                    presenter: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ghibli_presenter.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>Ghibli style</style>'
+            }
+        }
+    },
+    {
+        filename: 'ghibli_shorts',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1536,
+                width: 1024
+            },
+            imageParams: {
+                images: {
+                    presenter: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ghibli_presenter.jpg'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>Ghibli style</style>'
+            },
+            speechParams: {
+                provider: 'openai',
+                speakers: {
+                    Presenter: {
+                        speechOptions: {
+                            instruction: 'speak very fast'
+                        },
+                        voiceId: 'shimmer'
+                    }
+                }
+            }
+        }
+    },
+    {
+        filename: 'ghost_comic',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                images: {
+                    optimus: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/optimus.png'
+                        },
+                        type: 'image'
+                    },
+                    presenter: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/ghost_presenter.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>Ghost in the shell aesthetic.</style>'
+            }
+        }
+    },
+    {
+        filename: 'leda',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            audioParams: {
+                bgm: {
+                    kind: 'url',
+                    url: 'https://github.com/receptron/mulmocast-media/raw/refs/heads/main/bgms/morning001.mp3'
+                }
+            },
+            canvasSize: {
+                height: 1536,
+                width: 1024
+            },
+            imageParams: {
+                model: 'gemini-2.5-flash-image',
+                provider: 'google'
+            },
+            speechParams: {
+                speakers: {
+                    Presenter: {
+                        provider: 'gemini',
+                        speechOptions: {
+                            instruction: 'Speak like a professional news presenter.'
+                        },
+                        voiceId: 'Leda'
+                    }
+                }
+            }
+        }
+    },
+    {
+        filename: 'onepiece_comic',
+        presentationStyle: {
+            '$mulmocast': {
+                credit: 'closing',
+                version: '1.1'
+            },
+            canvasSize: {
+                height: 1024,
+                width: 1536
+            },
+            imageParams: {
+                images: {
+                    presenter: {
+                        source: {
+                            kind: 'url',
+                            url: 'https://raw.githubusercontent.com/receptron/mulmocast-media/refs/heads/main/characters/onepiece_presenter.png'
+                        },
+                        type: 'image'
+                    }
+                },
+                style: '<style>One Piece aesthetic.</style>'
+            }
+        }
+    }
+];

package/lib/tools/complete_script.d.ts

@@ -0,0 +1,52 @@
+import { type ZodSafeParseResult } from "zod";
+import type { MulmoScript } from "../types/type.js";
+type PartialMulmoScript = Record<string, unknown>;
+/**
+ * Add $mulmocast version if not present
+ */
+export declare const addMulmocastVersion: (data: PartialMulmoScript) => PartialMulmoScript;
+/**
+ * Merge base with override (override takes precedence)
+ */
+export declare const mergeScripts: (base: PartialMulmoScript, override: PartialMulmoScript) => PartialMulmoScript;
+/**
+ * Get style by name or file path
+ */
+export declare const getStyle: (style: string) => PartialMulmoScript | undefined;
+export type CompleteScriptResult = ZodSafeParseResult<MulmoScript>;
+type CompleteScriptOptions = {
+    templateName?: string;
+    styleName?: string;
+};
+/**
+ * Complete a partial MulmoScript with schema defaults, optional style or template
+ *
+ * @param data - Partial MulmoScript to complete (highest precedence)
+ * @param options - Optional template or style to use as base
+ * @param options.templateName - Template name (e.g., "children_book"). Mutually exclusive with styleName.
+ * @param options.styleName - Style name or file path. Mutually exclusive with templateName.
+ * @returns Zod safe parse result with completed MulmoScript or validation errors
+ * @throws Error if both templateName and styleName are specified
+ *
+ * @example
+ * // With template
+ * completeScript(data, { templateName: "children_book" })
+ *
+ * @example
+ * // With style
+ * completeScript(data, { styleName: "ghibli_comic" })
+ *
+ * @example
+ * // With style from file
+ * completeScript(data, { styleName: "./my-style.json" })
+ */
+export declare const completeScript: (data: PartialMulmoScript, options?: CompleteScriptOptions) => CompleteScriptResult;
+/**
+ * Check if template exists
+ */
+export declare const templateExists: (templateName: string) => boolean;
+/**
+ * Check if style exists (by name or file path)
+ */
+export declare const styleExists: (style: string) => boolean;
+export {};

package/lib/tools/complete_script.js

@@ -0,0 +1,118 @@
+import { readFileSync, existsSync } from "fs";
+import path from "path";
+import { mulmoScriptSchema } from "../types/schema.js";
+import { getScriptFromPromptTemplate } from "../utils/file.js";
+import { currentMulmoScriptVersion } from "../types/const.js";
+import { promptTemplates } from "../data/index.js";
+/**
+ * Add $mulmocast version if not present
+ */
+export const addMulmocastVersion = (data) => {
+    if (data.$mulmocast) {
+        return data;
+    }
+    return {
+        ...data,
+        $mulmocast: { version: currentMulmoScriptVersion },
+    };
+};
+const deepMergeKeys = ["speechParams", "imageParams", "movieParams", "audioParams"];
+/**
+ * Merge base with override (override takes precedence)
+ */
+export const mergeScripts = (base, override) => {
+    const merged = { ...base, ...override };
+    deepMergeKeys.forEach((key) => {
+        if (base[key] && override[key]) {
+            merged[key] = { ...base[key], ...override[key] };
+        }
+    });
+    return merged;
+};
+/**
+ * Check if style specifier is a file path
+ */
+const isFilePath = (style) => {
+    return style.endsWith(".json") || style.includes("/") || style.includes("\\");
+};
+/**
+ * Get style by name from promptTemplates
+ */
+const getStyleByName = (styleName) => {
+    const template = promptTemplates.find((t) => t.filename === styleName);
+    return template?.presentationStyle;
+};
+/**
+ * Get style from file path
+ */
+const getStyleFromFile = (filePath) => {
+    const resolvedPath = path.resolve(filePath);
+    if (!existsSync(resolvedPath)) {
+        return undefined;
+    }
+    const content = readFileSync(resolvedPath, "utf-8");
+    return JSON.parse(content);
+};
+/**
+ * Get style by name or file path
+ */
+export const getStyle = (style) => {
+    return isFilePath(style) ? getStyleFromFile(style) : getStyleByName(style);
+};
+/**
+ * Complete a partial MulmoScript with schema defaults, optional style or template
+ *
+ * @param data - Partial MulmoScript to complete (highest precedence)
+ * @param options - Optional template or style to use as base
+ * @param options.templateName - Template name (e.g., "children_book"). Mutually exclusive with styleName.
+ * @param options.styleName - Style name or file path. Mutually exclusive with templateName.
+ * @returns Zod safe parse result with completed MulmoScript or validation errors
+ * @throws Error if both templateName and styleName are specified
+ *
+ * @example
+ * // With template
+ * completeScript(data, { templateName: "children_book" })
+ *
+ * @example
+ * // With style
+ * completeScript(data, { styleName: "ghibli_comic" })
+ *
+ * @example
+ * // With style from file
+ * completeScript(data, { styleName: "./my-style.json" })
+ */
+export const completeScript = (data, options = {}) => {
+    const { templateName, styleName } = options;
+    // template and style are mutually exclusive
+    if (templateName && styleName) {
+        throw new Error("Cannot specify both templateName and styleName. They are mutually exclusive.");
+    }
+    // Get base config from template or style
+    const getBase = () => {
+        if (templateName) {
+            return getScriptFromPromptTemplate(templateName);
+        }
+        if (styleName) {
+            return getStyle(styleName);
+        }
+        return undefined;
+    };
+    const base = getBase();
+    // Merge base with input data (input data has highest precedence)
+    const merged = base ? mergeScripts(base, data) : data;
+    // Add version if not present
+    const withVersion = addMulmocastVersion(merged);
+    return mulmoScriptSchema.safeParse(withVersion);
+};
+/**
+ * Check if template exists
+ */
+export const templateExists = (templateName) => {
+    return getScriptFromPromptTemplate(templateName) !== undefined;
+};
+/**
+ * Check if style exists (by name or file path)
+ */
+export const styleExists = (style) => {
+    return getStyle(style) !== undefined;
+};

package/lib/tools/create_mulmo_script_from_url.js

@@ -14,7 +14,7 @@ import { browserlessCacheGenerator } from "../utils/filters.js";
 import { mulmoScriptSchema, urlsSchema } from "../types/schema.js";
 import { cliLoadingPlugin } from "../utils/plugins.js";
 import { graphDataScriptFromUrlPrompt } from "../utils/prompt.js";
-import { llmPair } from "../utils/utils.js";
+import { llmPair, settings2GraphAIConfig } from "../utils/utils.js";
 import { readFileSync } from "fs";
 dotenv.config({ quiet: true });
 const vanillaAgents = agents.default ?? agents;
@@ -220,6 +220,7 @@ export const createMulmoScriptFromUrl = async ({ urls, templateName, outDirPath,
         },
     ];
     const { agent, model, max_tokens } = llmPair(llm, llm_model);
+    const config = settings2GraphAIConfig(undefined, process.env);
     const graph = new GraphAI(graphData, {
         ...vanillaAgents,
         openAIAgent,
@@ -229,7 +230,7 @@ export const createMulmoScriptFromUrl = async ({ urls, templateName, outDirPath,
         browserlessAgent,
         validateSchemaAgent,
         fileWriteAgent,
-    }, { agentFilters });
+    }, { agentFilters, config });
     graph.injectValue("urls", parsedUrls);
     graph.injectValue("systemPrompt", readTemplatePrompt(templateName));
     graph.injectValue("outdir", outDirPath);
@@ -251,6 +252,7 @@ export const createMulmoScriptFromFile = async (fileName, { templateName, outDir
     const filePath = path.resolve(process.cwd(), fileName);
     const text = readFileSync(filePath, "utf-8");
     const { agent, model, max_tokens } = llmPair(llm, llm_model);
+    const config = settings2GraphAIConfig(undefined, process.env);
     const graph = new GraphAI(graphDataText, {
         ...vanillaAgents,
         openAIAgent,
@@ -259,7 +261,7 @@ export const createMulmoScriptFromFile = async (fileName, { templateName, outDir
         groqAgent,
         validateSchemaAgent,
         fileWriteAgent,
-    });
+    }, { config });
     graph.injectValue("sourceText", { text });
     graph.injectValue("systemPrompt", readTemplatePrompt(templateName));
     graph.injectValue("outdir", outDirPath);

package/lib/tools/create_mulmo_script_interactively.js

@@ -13,7 +13,7 @@ import { browserlessCacheGenerator } from "../utils/filters.js";
 import { mulmoScriptSchema } from "../types/index.js";
 import { browserlessAgent } from "@graphai/browserless_agent";
 import validateSchemaAgent from "../agents/validate_schema_agent.js";
-import { llmPair } from "../utils/utils.js";
+import { llmPair, settings2GraphAIConfig } from "../utils/utils.js";
 import { interactiveClarificationPrompt, prefixPrompt } from "../utils/prompt.js";
 // import { cliLoadingPlugin } from "../utils/plugins.js";
 dotenv.config({ quiet: true });
@@ -231,7 +231,8 @@ export const createMulmoScriptInteractively = async ({ outDirPath, cacheDirPath,
             nodeIds: ["chatAgent"],
         },
     ];
-    const graph = new GraphAI(graphData, { ...vanillaAgents, anthropicAgent, geminiAgent, groqAgent, openAIAgent, textInputAgent, fileWriteAgent, validateSchemaAgent }, { agentFilters });
+    const config = settings2GraphAIConfig(undefined, process.env);
+    const graph = new GraphAI(graphData, { ...vanillaAgents, anthropicAgent, geminiAgent, groqAgent, openAIAgent, textInputAgent, fileWriteAgent, validateSchemaAgent }, { agentFilters, config });
     const prompt = readTemplatePrompt(templateName);
     graph.injectValue("messages", [
         {

package/lib/tools/story_to_script.js

@@ -9,7 +9,7 @@ import * as agents from "@graphai/vanilla";
 import { graphDataScriptGeneratePrompt, sceneToBeatsPrompt, storyToScriptInfoPrompt, storyToScriptPrompt } from "../utils/prompt.js";
 import { fileWriteAgent } from "@graphai/vanilla_node_agents";
 import validateSchemaAgent from "../agents/validate_schema_agent.js";
-import { llmPair } from "../utils/utils.js";
+import { llmPair, settings2GraphAIConfig } from "../utils/utils.js";
 import { storyToScriptGenerateMode } from "../types/const.js";
 import { cliLoadingPlugin } from "../utils/plugins.js";
 const vanillaAgents = agents.default ?? agents;
@@ -255,7 +255,8 @@ export const storyToScript = async ({ story, beatsPerScene, templateName, outdir
     const scriptInfoPrompt = await generateScriptInfoPrompt(template, story);
     const scriptPrompt = await generateScriptPrompt(template, beatsPerScene, story);
     const graphData = generateMode === storyToScriptGenerateMode.stepWise ? stepWiseGraphData : oneStepGraphData;
-    const graph = new GraphAI(graphData, { ...vanillaAgents, openAIAgent, anthropicAgent, geminiAgent, groqAgent, fileWriteAgent, validateSchemaAgent });
+    const config = settings2GraphAIConfig(undefined, process.env);
+    const graph = new GraphAI(graphData, { ...vanillaAgents, openAIAgent, anthropicAgent, geminiAgent, groqAgent, fileWriteAgent, validateSchemaAgent }, { config });
     if (generateMode === storyToScriptGenerateMode.stepWise) {
         graph.injectValue("scenes", story.scenes);
         graph.injectValue("beatsPrompt", beatsPrompt);

package/lib/types/schema.d.ts

@@ -216,7 +216,7 @@ export declare const textSplitSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>], "type">;
 export declare const mulmoCaptionParamsSchema: z.ZodObject<{
     lang: z.ZodOptional<z.ZodString>;
-    styles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
     captionSplit: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
         none: "none";
         estimate: "estimate";
@@ -1180,7 +1180,7 @@ export declare const mulmoBeatSchema: z.ZodObject<{
     }, z.core.$strict>>;
     captionParams: z.ZodOptional<z.ZodObject<{
         lang: z.ZodOptional<z.ZodString>;
-        styles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
         captionSplit: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
             none: "none";
             estimate: "estimate";
@@ -1555,7 +1555,7 @@ export declare const mulmoPresentationStyleSchema: z.ZodObject<{
     }, z.core.$strict>>;
     captionParams: z.ZodOptional<z.ZodObject<{
         lang: z.ZodOptional<z.ZodString>;
-        styles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
         captionSplit: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
             none: "none";
             estimate: "estimate";
@@ -1926,7 +1926,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
     }, z.core.$strict>>;
     captionParams: z.ZodOptional<z.ZodObject<{
         lang: z.ZodOptional<z.ZodString>;
-        styles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
         captionSplit: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
             none: "none";
             estimate: "estimate";
@@ -2364,7 +2364,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
         }, z.core.$strict>>;
         captionParams: z.ZodOptional<z.ZodObject<{
             lang: z.ZodOptional<z.ZodString>;
-            styles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
             captionSplit: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
                 none: "none";
                 estimate: "estimate";
@@ -2814,7 +2814,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
         }, z.core.$strict>>;
         captionParams: z.ZodOptional<z.ZodObject<{
             lang: z.ZodOptional<z.ZodString>;
-            styles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
             captionSplit: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
                 none: "none";
                 estimate: "estimate";
@@ -3252,7 +3252,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
             }, z.core.$strict>>;
             captionParams: z.ZodOptional<z.ZodObject<{
                 lang: z.ZodOptional<z.ZodString>;
-                styles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+                styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 captionSplit: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
                     none: "none";
                     estimate: "estimate";
@@ -3638,7 +3638,7 @@ export declare const mulmoPromptTemplateSchema: z.ZodObject<{
         }, z.core.$strict>>;
         captionParams: z.ZodOptional<z.ZodObject<{
             lang: z.ZodOptional<z.ZodString>;
-            styles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
             captionSplit: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
                 none: "none";
                 estimate: "estimate";
@@ -4003,7 +4003,7 @@ export declare const mulmoPromptTemplateFileSchema: z.ZodObject<{
         }, z.core.$strict>>;
         captionParams: z.ZodOptional<z.ZodObject<{
             lang: z.ZodOptional<z.ZodString>;
-            styles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            styles: z.ZodOptional<z.ZodArray<z.ZodString>>;
             captionSplit: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
                 none: "none";
                 estimate: "estimate";

package/lib/types/schema.js

@@ -132,7 +132,7 @@ export const textSplitSchema = z.discriminatedUnion("type", [
 export const mulmoCaptionParamsSchema = z
     .object({
     lang: langSchema.optional(),
-    styles: z.array(z.string()).optional().default([]), // css styles
+    styles: z.array(z.string()).optional(), // css styles
     captionSplit: captionSplitSchema.optional(), // how to determine caption timing
     textSplit: textSplitSchema.optional(), // how to split text into segments (default: none)
 })

package/lib/utils/context.d.ts

@@ -570,8 +570,8 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                 cssStyles: string | string[];
             } | undefined;
             captionParams?: {
-                styles: string[];
                 lang?: string | undefined;
+                styles?: string[] | undefined;
                 captionSplit?: "none" | "estimate" | undefined;
                 textSplit?: {
                     type: "none";
@@ -605,8 +605,8 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
             cssStyles: string | string[];
         } | undefined;
         captionParams?: {
-            styles: string[];
             lang?: string | undefined;
+            styles?: string[] | undefined;
             captionSplit?: "none" | "estimate" | undefined;
             textSplit?: {
                 type: "none";
@@ -1226,8 +1226,8 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                     cssStyles: string | string[];
                 } | undefined;
                 captionParams?: {
-                    styles: string[];
                     lang?: string | undefined;
+                    styles?: string[] | undefined;
                     captionSplit?: "none" | "estimate" | undefined;
                     textSplit?: {
                         type: "none";
@@ -1261,8 +1261,8 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                 cssStyles: string | string[];
             } | undefined;
             captionParams?: {
-                styles: string[];
                 lang?: string | undefined;
+                styles?: string[] | undefined;
                 captionSplit?: "none" | "estimate" | undefined;
                 textSplit?: {
                     type: "none";
@@ -1584,8 +1584,8 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
             cssStyles: string | string[];
         } | undefined;
         captionParams?: {
-            styles: string[];
             lang?: string | undefined;
+            styles?: string[] | undefined;
             captionSplit?: "none" | "estimate" | undefined;
             textSplit?: {
                 type: "none";