mulmocast 2.2.5 → 2.3.0

package/README.md

@@ -207,6 +207,51 @@ MulmoScript configuration (same as OpenAI):
 
 For detailed setup and region availability, see [Azure OpenAI Usage Guide](./docs/azure_openai_usage.md).
 
+### mulmo.config.json
+
+Create a `mulmo.config.json` file to set project-wide defaults. The CLI searches for it in **CWD** first, then **home directory (`~/`)**.
+
+```json
+{
+  "speechParams": {
+    "provider": "elevenlabs"
+  },
+  "imageParams": {
+    "provider": "google"
+  },
+  "audioParams": {
+    "bgm": { "kind": "path", "path": "assets/bgm.mp3" },
+    "bgmVolume": 0.15
+  }
+}
+```
+
+Top-level keys are applied as **defaults** (script values take precedence). Use the `override` key to **force** values over scripts — useful for enterprise branding or TTS provider enforcement:
+
+```json
+{
+  "speechParams": {
+    "provider": "elevenlabs"
+  },
+  "override": {
+    "speechParams": {
+      "provider": "elevenlabs",
+      "model": "eleven_multilingual_v2",
+      "speakers": {
+        "Presenter": { "provider": "elevenlabs", "voiceId": "Rachel" }
+      }
+    }
+  }
+}
+```
+
+Priority chain: `config (defaults)` < `template/style` < `script` < `config.override` < `presentationStyle (-p)`
+
+Verify the merged result with:
+```bash
+mulmo tool info merged --script <script.json>
+```
+
 ## Workflow
 
 1. Create a MulmoScript JSON file with `mulmo tool scripting`

package/lib/cli/commands/tool/info/builder.d.ts

@@ -3,4 +3,6 @@ export declare const builder: (yargs: Argv) => Argv<{
     category: string | undefined;
 } & {
     format: string;
+} & {
+    script: string | undefined;
 }>;

package/lib/cli/commands/tool/info/builder.js

@@ -2,7 +2,7 @@ export const builder = (yargs) => yargs
     .positional("category", {
     describe: "Category to show info for",
     type: "string",
-    choices: ["styles", "bgm", "templates", "voices", "images", "movies", "llm", "themes"],
+    choices: ["styles", "bgm", "templates", "voices", "images", "movies", "llm", "themes", "config", "merged"],
 })
     .option("format", {
     alias: "F",
@@ -10,4 +10,9 @@ export const builder = (yargs) => yargs
     type: "string",
     choices: ["text", "json", "yaml"],
     default: "text",
+})
+    .option("script", {
+    alias: "S",
+    describe: "Script file path (required for 'merged' category)",
+    type: "string",
 });

package/lib/cli/commands/tool/info/handler.d.ts

@@ -1,6 +1,7 @@
 interface InfoCliArgs {
     category?: string;
     format: string;
+    script?: string;
 }
 export declare const handler: (argv: InfoCliArgs) => void;
 export {};

package/lib/cli/commands/tool/info/handler.js

@@ -1,9 +1,12 @@
 /* eslint-disable no-console */
+import path from "path";
 import { getMarkdownStyleNames, getMarkdownCategories, getMarkdownStylesByCategory } from "../../../../data/markdownStyles.js";
 import { bgmAssets } from "../../../../data/bgmAssets.js";
 import { templateDataSet } from "../../../../data/templateDataSet.js";
 import { slideThemes } from "../../../../data/slideThemes.js";
 import { provider2TTSAgent, provider2ImageAgent, provider2MovieAgent, provider2LLMAgent } from "../../../../types/provider2agent.js";
+import { findConfigFile, loadMulmoConfig, mergeConfigWithScript } from "../../../../utils/mulmo_config.js";
+import { readMulmoScriptFile } from "../../../../utils/file.js";
 import YAML from "yaml";
 const formatOutput = (data, format) => {
     if (format === "json") {
@@ -170,6 +173,78 @@ const printThemesText = () => {
     }
     console.log("");
 };
+const getConfigInfo = () => {
+    const baseDirPath = process.cwd();
+    const configPath = findConfigFile(baseDirPath);
+    if (!configPath) {
+        return { configFile: null, config: null };
+    }
+    const config = loadMulmoConfig(baseDirPath);
+    return { configFile: configPath, config };
+};
+const printConfigText = () => {
+    const baseDirPath = process.cwd();
+    const configPath = findConfigFile(baseDirPath);
+    console.log("\n📄 mulmo.config.json\n");
+    if (!configPath) {
+        console.log("  No mulmo.config.json found.");
+        console.log("  Searched: CWD → ~\n");
+        return;
+    }
+    console.log(`  Active config: ${configPath}\n`);
+    const config = loadMulmoConfig(baseDirPath);
+    if (config) {
+        console.log(JSON.stringify(config, null, 2));
+    }
+    console.log("");
+};
+const readScriptFile = (scriptPath) => {
+    const result = readMulmoScriptFile(scriptPath, `Error: File not found: ${scriptPath}`);
+    if (!result) {
+        console.error(`Error: Could not read script file: ${scriptPath}`);
+        process.exit(1);
+    }
+    return result.mulmoData;
+};
+const getMergedInfo = (scriptPath) => {
+    if (!scriptPath) {
+        console.error("Error: --script <file> is required for 'merged' category");
+        process.exit(1);
+    }
+    const baseDirPath = process.cwd();
+    const configResult = loadMulmoConfig(baseDirPath);
+    const script = readScriptFile(scriptPath);
+    if (!configResult) {
+        return { configFile: null, merged: script };
+    }
+    const configPath = findConfigFile(baseDirPath);
+    const merged = mergeConfigWithScript(configResult, script);
+    return { configFile: configPath, defaults: configResult.defaults, override: configResult.override, merged };
+};
+const printMergedText = (scriptPath) => {
+    if (!scriptPath) {
+        console.error("Error: --script <file> is required for 'merged' category");
+        console.error("Usage: mulmo tool info merged --script <script.json>");
+        process.exit(1);
+    }
+    const baseDirPath = process.cwd();
+    const configResult = loadMulmoConfig(baseDirPath);
+    const script = readScriptFile(scriptPath);
+    console.log("\n📋 Merged Script Result\n");
+    console.log(`  Script: ${path.resolve(scriptPath)}`);
+    if (!configResult) {
+        console.log("  Config: (none)\n");
+        console.log(JSON.stringify(script, null, 2));
+        console.log("");
+        return;
+    }
+    const configPath = findConfigFile(baseDirPath);
+    console.log(`  Config: ${configPath}`);
+    console.log(`  Override: ${configResult.override ? "yes" : "no"}\n`);
+    const merged = mergeConfigWithScript(configResult, script);
+    console.log(JSON.stringify(merged, null, 2));
+    console.log("");
+};
 const printAllCategories = () => {
     console.log("\n📚 Available Info Categories\n");
     console.log("  Usage: mulmo tool info <category> [--format json|yaml]\n");
@@ -181,14 +256,16 @@ const printAllCategories = () => {
     console.log("    images     - Image generation providers and models");
     console.log("    movies     - Movie generation providers and models");
     console.log("    llm        - LLM providers and models");
-    console.log("    themes     - Slide themes and color palettes\n");
+    console.log("    themes     - Slide themes and color palettes");
+    console.log("    config     - Active mulmo.config.json location and contents");
+    console.log("    merged     - Show script merged with mulmo.config.json (--script <file>)\n");
 };
-const validCategories = ["styles", "bgm", "templates", "voices", "images", "movies", "llm", "themes"];
+const validCategories = ["styles", "bgm", "templates", "voices", "images", "movies", "llm", "themes", "config", "merged"];
 const isValidCategory = (category) => {
     return validCategories.includes(category);
 };
 export const handler = (argv) => {
-    const { category, format = "text" } = argv;
+    const { category, format = "text", script: scriptPath } = argv;
     if (!category) {
         if (format === "text") {
             printAllCategories();
@@ -216,6 +293,8 @@ export const handler = (argv) => {
         movies: getMoviesInfo,
         llm: getLlmInfo,
         themes: getThemesInfo,
+        config: getConfigInfo,
+        merged: () => getMergedInfo(scriptPath),
     };
     const textPrinters = {
         styles: printStylesText,
@@ -226,6 +305,8 @@ export const handler = (argv) => {
         movies: printMoviesText,
         llm: printLlmText,
         themes: printThemesText,
+        config: printConfigText,
+        merged: () => printMergedText(scriptPath),
     };
     if (format === "text") {
         textPrinters[category]();

package/lib/cli/commands/tool/info/index.d.ts

@@ -1,4 +1,4 @@
 export declare const command = "info [category]";
-export declare const desc = "Show available options (styles, bgm, templates, voices, images, movies, llm, themes)";
+export declare const desc = "Show available options (styles, bgm, templates, voices, images, movies, llm, themes, config, merged)";
 export { builder } from "./builder.js";
 export { handler } from "./handler.js";

package/lib/cli/commands/tool/info/index.js

@@ -1,4 +1,4 @@
 export const command = "info [category]";
-export const desc = "Show available options (styles, bgm, templates, voices, images, movies, llm, themes)";
+export const desc = "Show available options (styles, bgm, templates, voices, images, movies, llm, themes, config, merged)";
 export { builder } from "./builder.js";
 export { handler } from "./handler.js";

package/lib/slide/index.d.ts

@@ -1,5 +1,6 @@
 export { generateSlideHTML } from "./render.js";
+export type { ResolvedBranding } from "./render.js";
 export { renderSlideContent } from "./layouts/index.js";
 export { renderContentBlock, renderContentBlocks } from "./blocks.js";
-export { mulmoSlideMediaSchema, slideLayoutSchema, slideThemeSchema, contentBlockSchema, imageRefBlockSchema, chartBlockSchema, mermaidBlockSchema, accentColorKeySchema, } from "./schema.js";
-export type { MulmoSlideMedia, SlideLayout, SlideTheme, SlideThemeColors, SlideThemeFonts, ContentBlock, ImageRefBlock, ChartBlock, MermaidBlock, AccentColorKey, TitleSlide, ColumnsSlide, ComparisonSlide, GridSlide, BigQuoteSlide, StatsSlide, TimelineSlide, SplitSlide, MatrixSlide, TableSlide, FunnelSlide, Card, CalloutBar, SlideStyle, } from "./schema.js";
+export { mulmoSlideMediaSchema, slideLayoutSchema, slideThemeSchema, contentBlockSchema, imageRefBlockSchema, chartBlockSchema, mermaidBlockSchema, accentColorKeySchema, slideBrandingLogoSchema, slideBrandingSchema, } from "./schema.js";
+export type { MulmoSlideMedia, SlideLayout, SlideTheme, SlideThemeColors, SlideThemeFonts, ContentBlock, ImageRefBlock, ChartBlock, MermaidBlock, AccentColorKey, TitleSlide, ColumnsSlide, ComparisonSlide, GridSlide, BigQuoteSlide, StatsSlide, TimelineSlide, SplitSlide, MatrixSlide, TableSlide, FunnelSlide, Card, CalloutBar, SlideStyle, SlideBrandingLogo, SlideBranding, } from "./schema.js";

package/lib/slide/index.js

@@ -4,4 +4,4 @@ export { generateSlideHTML } from "./render.js";
 export { renderSlideContent } from "./layouts/index.js";
 export { renderContentBlock, renderContentBlocks } from "./blocks.js";
 // Schemas
-export { mulmoSlideMediaSchema, slideLayoutSchema, slideThemeSchema, contentBlockSchema, imageRefBlockSchema, chartBlockSchema, mermaidBlockSchema, accentColorKeySchema, } from "./schema.js";
+export { mulmoSlideMediaSchema, slideLayoutSchema, slideThemeSchema, contentBlockSchema, imageRefBlockSchema, chartBlockSchema, mermaidBlockSchema, accentColorKeySchema, slideBrandingLogoSchema, slideBrandingSchema, } from "./schema.js";

package/lib/slide/render.d.ts

@@ -1,3 +1,17 @@
 import type { SlideTheme, SlideLayout } from "./schema.js";
+/** Pre-resolved branding data (all sources converted to data URLs) */
+export type ResolvedBranding = {
+    logo?: {
+        dataUrl: string;
+        position: string;
+        width: number;
+    };
+    backgroundImage?: {
+        dataUrl: string;
+        size: string;
+        opacity: number;
+        bgOpacity?: number;
+    };
+};
 /** Generate a complete HTML document for a single slide */
-export declare const generateSlideHTML: (theme: SlideTheme, slide: SlideLayout, reference?: string) => string;
+export declare const generateSlideHTML: (theme: SlideTheme, slide: SlideLayout, reference?: string, branding?: ResolvedBranding) => string;

package/lib/slide/render.js

@@ -21,18 +21,56 @@ const buildCdnScripts = (theme, slide) => {
     }
     return scripts.join("\n");
 };
+/** Map branding logo position to Tailwind CSS classes */
+const logoPositionClasses = {
+    "top-left": "top-5 left-6",
+    "top-right": "top-5 right-6",
+    "bottom-left": "bottom-5 left-6",
+    "bottom-right": "bottom-5 right-6",
+};
+/**
+ * Render branding background layers.
+ * - Without bgOpacity: image overlaid on slide bg at given opacity
+ * - With bgOpacity: image at full opacity, then slide bg color as semi-transparent overlay
+ */
+const renderBrandingBackground = (branding, bgHex) => {
+    if (!branding.backgroundImage)
+        return "";
+    const { dataUrl, size, opacity, bgOpacity } = branding.backgroundImage;
+    const bgSize = size === "fill" ? "100% 100%" : size;
+    if (bgOpacity !== undefined) {
+        const parts = [];
+        parts.push(`<div class="absolute inset-0 z-0" style="background-image:url('${dataUrl}');background-size:${bgSize};background-position:center;background-repeat:no-repeat;opacity:${opacity}"></div>`);
+        parts.push(`<div class="absolute inset-0 z-0" style="background-color:#${bgHex};opacity:${bgOpacity}"></div>`);
+        return parts.join("\n");
+    }
+    return `<div class="absolute inset-0 z-0" style="background-image:url('${dataUrl}');background-size:${bgSize};background-position:center;background-repeat:no-repeat;opacity:${opacity}"></div>`;
+};
+/** Render branding logo element */
+const renderBrandingLogo = (branding) => {
+    if (!branding.logo)
+        return "";
+    const { dataUrl, position, width } = branding.logo;
+    const posClasses = logoPositionClasses[position] ?? logoPositionClasses["top-right"];
+    return `<img class="absolute ${posClasses} z-10" src="${dataUrl}" width="${width}" alt="" style="pointer-events:none">`;
+};
 /** Generate a complete HTML document for a single slide */
-export const generateSlideHTML = (theme, slide, reference) => {
+export const generateSlideHTML = (theme, slide, reference, branding) => {
     const content = renderSlideContent(slide);
     const twConfig = buildTailwindConfig(theme);
     const cdnScripts = buildCdnScripts(theme, slide);
     const slideStyle = slide.style;
-    const bgCls = slideStyle?.bgColor ? "" : "bg-d-bg";
-    const inlineStyle = slideStyle?.bgColor ? ` style="background-color:#${sanitizeHex(slideStyle.bgColor)}"` : "";
+    const hasBgOpacity = branding?.backgroundImage?.bgOpacity !== undefined;
+    const bgCls = hasBgOpacity || slideStyle?.bgColor ? "" : "bg-d-bg";
+    const bgColorStyle = slideStyle?.bgColor ? ` style="background-color:#${sanitizeHex(slideStyle.bgColor)}"` : "";
+    const inlineStyle = hasBgOpacity ? "" : bgColorStyle;
     const footer = slideStyle?.footer ? `<p class="absolute bottom-2 right-4 text-xs text-d-dim font-body">${escapeHtml(slideStyle.footer)}</p>` : "";
     const referenceHtml = reference
         ? `<div class="mt-auto px-4 pb-2"><p class="text-sm text-d-muted font-body opacity-80">${escapeHtml(reference)}</p></div>`
         : "";
+    const bgHex = sanitizeHex(slideStyle?.bgColor ?? theme.colors.bg);
+    const brandingBg = branding ? renderBrandingBackground(branding, bgHex) : "";
+    const brandingLogo = branding ? renderBrandingLogo(branding) : "";
     return `<!DOCTYPE html>
 <html lang="en" class="h-full">
 <head>
@@ -47,10 +85,14 @@ ${cdnScripts}
 </head>
 <body class="h-full">
 <div class="relative overflow-hidden ${bgCls} w-full h-full flex flex-col"${inlineStyle}>
+${brandingBg}
+<div class="relative z-[1] flex flex-col flex-1">
 ${content}
 ${referenceHtml}
 ${footer}
 </div>
+${brandingLogo}
+</div>
 </body>
 </html>`;
 };

package/lib/slide/schema.d.ts

@@ -4351,6 +4351,66 @@ export declare const funnelSlideSchema: z.ZodObject<{
     }, z.core.$strip>>;
     layout: z.ZodLiteral<"funnel">;
 }, z.core.$strip>;
+export declare const slideBrandingLogoSchema: z.ZodObject<{
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodURL;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"base64">;
+        data: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        path: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    position: z.ZodDefault<z.ZodEnum<{
+        "top-left": "top-left";
+        "top-right": "top-right";
+        "bottom-left": "bottom-left";
+        "bottom-right": "bottom-right";
+    }>>;
+    width: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const slideBrandingSchema: z.ZodObject<{
+    logo: z.ZodOptional<z.ZodObject<{
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"url">;
+            url: z.ZodURL;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"base64">;
+            data: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+        }, z.core.$strict>], "kind">;
+        position: z.ZodDefault<z.ZodEnum<{
+            "top-left": "top-left";
+            "top-right": "top-right";
+            "bottom-left": "bottom-left";
+            "bottom-right": "bottom-right";
+        }>>;
+        width: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    backgroundImage: z.ZodOptional<z.ZodObject<{
+        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"url">;
+            url: z.ZodURL;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"base64">;
+            data: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"path">;
+            path: z.ZodString;
+        }, z.core.$strict>], "kind">;
+        size: z.ZodOptional<z.ZodEnum<{
+            contain: "contain";
+            cover: "cover";
+            fill: "fill";
+            auto: "auto";
+        }>>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        bgOpacity: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
 export declare const slideLayoutSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     title: z.ZodString;
     subtitle: z.ZodOptional<z.ZodString>;
@@ -8985,6 +9045,47 @@ export declare const mulmoSlideMediaSchema: z.ZodObject<{
         layout: z.ZodLiteral<"funnel">;
     }, z.core.$strip>], "layout">;
     reference: z.ZodOptional<z.ZodString>;
+    branding: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        logo: z.ZodOptional<z.ZodObject<{
+            source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodURL;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"base64">;
+                data: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+            }, z.core.$strict>], "kind">;
+            position: z.ZodDefault<z.ZodEnum<{
+                "top-left": "top-left";
+                "top-right": "top-right";
+                "bottom-left": "bottom-left";
+                "bottom-right": "bottom-right";
+            }>>;
+            width: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+        backgroundImage: z.ZodOptional<z.ZodObject<{
+            source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodURL;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"base64">;
+                data: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+            }, z.core.$strict>], "kind">;
+            size: z.ZodOptional<z.ZodEnum<{
+                contain: "contain";
+                cover: "cover";
+                fill: "fill";
+                auto: "auto";
+            }>>;
+            opacity: z.ZodOptional<z.ZodNumber>;
+            bgOpacity: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 export type AccentColorKey = z.infer<typeof accentColorKeySchema>;
 export type SlideThemeColors = z.infer<typeof slideThemeColorsSchema>;
@@ -9027,4 +9128,6 @@ export type TableCellValue = z.infer<typeof tableCellValueSchema>;
 export type TableSlide = z.infer<typeof tableSlideSchema>;
 export type FunnelStage = z.infer<typeof funnelStageSchema>;
 export type FunnelSlide = z.infer<typeof funnelSlideSchema>;
+export type SlideBrandingLogo = z.infer<typeof slideBrandingLogoSchema>;
+export type SlideBranding = z.infer<typeof slideBrandingSchema>;
 export type MulmoSlideMedia = z.infer<typeof mulmoSlideMediaSchema>;

package/lib/slide/schema.js

@@ -358,6 +358,37 @@ export const funnelSlideSchema = z.object({
     callout: calloutBarSchema.optional(),
 });
 // ═══════════════════════════════════════════════════════════
+// Branding — logo & background image overlay
+// ═══════════════════════════════════════════════════════════
+/**
+ * Media source for branding assets (self-contained definition to avoid
+ * circular dependency with src/types/schema.ts).
+ */
+const slideMediaSourceSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("url"), url: z.url() }).strict(),
+    z.object({ kind: z.literal("base64"), data: z.string().min(1) }).strict(),
+    z.object({ kind: z.literal("path"), path: z.string().min(1) }).strict(),
+]);
+const slideBackgroundImageSourceSchema = z.object({
+    source: slideMediaSourceSchema,
+    size: z.enum(["cover", "contain", "fill", "auto"]).optional(),
+    opacity: z.number().min(0).max(1).optional(),
+    bgOpacity: z.number().min(0).max(1).optional(),
+});
+export const slideBrandingLogoSchema = z
+    .object({
+    source: slideMediaSourceSchema,
+    position: z.enum(["top-left", "top-right", "bottom-left", "bottom-right"]).default("top-right"),
+    width: z.number().positive().default(120),
+})
+    .strict();
+export const slideBrandingSchema = z
+    .object({
+    logo: slideBrandingLogoSchema.optional(),
+    backgroundImage: slideBackgroundImageSourceSchema.optional(),
+})
+    .strict();
+// ═══════════════════════════════════════════════════════════
 // Slide Union & Media Schema
 // ═══════════════════════════════════════════════════════════
 export const slideLayoutSchema = z.discriminatedUnion("layout", [
@@ -380,5 +411,6 @@ export const mulmoSlideMediaSchema = z
     theme: slideThemeSchema.optional(),
     slide: slideLayoutSchema,
     reference: z.string().optional(),
+    branding: slideBrandingSchema.nullable().optional(),
 })
     .strict();

package/lib/tools/complete_script.d.ts

@@ -1,6 +1,6 @@
 import { type ZodSafeParseResult } from "zod";
 import type { MulmoScript } from "../types/type.js";
-type PartialMulmoScript = Record<string, unknown>;
+export type PartialMulmoScript = Record<string, unknown>;
 /**
  * Add $mulmocast version if not present
  */
@@ -17,6 +17,7 @@ export type CompleteScriptResult = ZodSafeParseResult<MulmoScript>;
 type CompleteScriptOptions = {
     templateName?: string;
     styleName?: string;
+    baseDirPath?: string;
 };
 /**
  * Complete a partial MulmoScript with schema defaults, optional style or template

package/lib/tools/complete_script.js

@@ -4,6 +4,7 @@ import { mulmoScriptSchema } from "../types/schema.js";
 import { getScriptFromPromptTemplate } from "../utils/file.js";
 import { currentMulmoScriptVersion } from "../types/const.js";
 import { promptTemplates } from "../data/index.js";
+import { loadMulmoConfig } from "../utils/mulmo_config.js";
 /**
  * Add $mulmocast version if not present
  */
@@ -16,7 +17,7 @@ export const addMulmocastVersion = (data) => {
         $mulmocast: { version: currentMulmoScriptVersion },
     };
 };
-const deepMergeKeys = ["speechParams", "imageParams", "movieParams", "audioParams"];
+const deepMergeKeys = ["speechParams", "imageParams", "movieParams", "audioParams", "slideParams"];
 /**
  * Merge base with override (override takes precedence)
  */
@@ -82,11 +83,13 @@ export const getStyle = (style) => {
  * completeScript(data, { styleName: "./my-style.json" })
  */
 export const completeScript = (data, options = {}) => {
-    const { templateName, styleName } = options;
+    const { templateName, styleName, baseDirPath } = options;
     // template and style are mutually exclusive
     if (templateName && styleName) {
         throw new Error("Cannot specify both templateName and styleName. They are mutually exclusive.");
     }
+    // Load mulmo.config.json
+    const configResult = baseDirPath ? loadMulmoConfig(baseDirPath) : null;
     // Get base config from template or style
     const getBase = () => {
         if (templateName) {
@@ -97,9 +100,12 @@ export const completeScript = (data, options = {}) => {
         }
         return undefined;
     };
-    const base = getBase();
-    // Merge base with input data (input data has highest precedence)
-    const merged = base ? mergeScripts(base, data) : data;
+    const templateOrStyle = getBase();
+    // Merge chain: config.defaults < template/style < input data < config.override
+    const defaults = configResult?.defaults;
+    const withDefaults = defaults && templateOrStyle ? mergeScripts(defaults, templateOrStyle) : (templateOrStyle ?? defaults);
+    const withData = withDefaults ? mergeScripts(withDefaults, data) : data;
+    const merged = configResult?.override ? mergeScripts(withData, configResult.override) : withData;
     // Add version if not present
     const withVersion = addMulmocastVersion(merged);
     return mulmoScriptSchema.safeParse(withVersion);