mulmocast 2.2.1 → 2.2.2

package/lib/slide/layouts/columns.js

@@ -23,13 +23,12 @@ const buildColumnCard = (col) => {
     }
     if (col.content) {
         const centerCls = col.icon ? "text-center" : "";
-        inner.push(`<div class="mt-3 space-y-3 flex-1 min-h-0 overflow-hidden flex flex-col ${centerCls}">`);
+        inner.push(`<div class="mt-4 space-y-4 flex-1 min-h-0 overflow-auto flex flex-col ${centerCls}">`);
         inner.push(renderCardContentBlocks(col.content));
         inner.push(`</div>`);
     }
     if (col.footer) {
-        inner.push(`<div class="flex-1"></div>`);
-        inner.push(`<p class="text-sm text-d-dim font-body mt-3">${escapeHtml(col.footer)}</p>`);
+        inner.push(`<p class="text-sm text-d-dim font-body mt-auto pt-3">${escapeHtml(col.footer)}</p>`);
     }
     return cardWrap(accent, inner.join("\n"), "flex-1");
 };
@@ -43,7 +42,7 @@ export const layoutColumns = (data) => {
             colElements.push(`<div class="flex items-center shrink-0"><span class="text-2xl text-d-dim">\u25B6</span></div>`);
         }
     });
-    parts.push(`<div class="flex gap-4 px-12 mt-5 flex-1 min-h-0 items-stretch">`);
+    parts.push(`<div class="flex gap-4 px-12 mt-5 flex-1 min-h-0 items-start">`);
     parts.push(colElements.join("\n"));
     parts.push(`</div>`);
     if (data.callout) {

package/lib/slide/layouts/comparison.js

@@ -5,20 +5,18 @@ const buildPanel = (panel) => {
     const inner = [];
     inner.push(`<h3 class="text-xl font-bold text-${c(accent)} font-body">${escapeHtml(panel.title)}</h3>`);
     if (panel.content) {
-        inner.push(`<div class="mt-4 space-y-3 flex-1 min-h-0 overflow-hidden flex flex-col">`);
+        inner.push(`<div class="mt-5 space-y-4 flex-1 min-h-0 overflow-auto flex flex-col">`);
         inner.push(renderContentBlocks(panel.content));
         inner.push(`</div>`);
     }
     if (panel.footer) {
-        if (!panel.content)
-            inner.push(`<div class="flex-1"></div>`);
-        inner.push(`<p class="text-sm text-d-dim font-body mt-3">${escapeHtml(panel.footer)}</p>`);
+        inner.push(`<p class="text-sm text-d-dim font-body mt-auto pt-3">${escapeHtml(panel.footer)}</p>`);
     }
     return cardWrap(accent, inner.join("\n"), "flex-1");
 };
 export const layoutComparison = (data) => {
     const parts = [slideHeader(data)];
-    parts.push(`<div class="flex gap-5 px-12 mt-5 flex-1 min-h-0 items-stretch">`);
+    parts.push(`<div class="flex gap-5 px-12 mt-5 flex-1 min-h-0 items-start">`);
     parts.push(buildPanel(data.left));
     parts.push(buildPanel(data.right));
     parts.push(`</div>`);

package/lib/slide/layouts/grid.js

@@ -8,7 +8,7 @@ export const layoutGrid = (data) => {
     parts.push(`<div class="px-12 pt-5 shrink-0">`);
     parts.push(`  <h2 class="text-[42px] leading-tight font-title font-bold text-d-text">${nl2br(data.title)}</h2>`);
     parts.push(`</div>`);
-    parts.push(`<div class="grid grid-cols-${nCols} gap-4 px-12 mt-5 flex-1 min-h-0 overflow-hidden content-start">`);
+    parts.push(`<div class="grid grid-cols-${nCols} gap-4 px-12 mt-5 flex-1 min-h-0 overflow-hidden content-center">`);
     (data.items || []).forEach((item) => {
         const itemAccent = item.accentColor || "primary";
         const inner = [];

package/lib/slide/layouts/stats.js

@@ -1,21 +1,34 @@
-import { escapeHtml, c, slideHeader, renderCalloutBar } from "../utils.js";
+import { escapeHtml, nl2br, c, renderCalloutBar } from "../utils.js";
 export const layoutStats = (data) => {
-    const parts = [slideHeader(data)];
+    const accent = data.accentColor || "primary";
     const stats = data.stats || [];
-    parts.push(`<div class="flex gap-6 px-12 mt-8 flex-1 items-start">`);
+    const parts = [];
+    parts.push(`<div class="h-[3px] bg-${c(accent)} shrink-0"></div>`);
+    parts.push(`<div class="flex-1 flex flex-col justify-center px-12 min-h-0">`);
+    // Header inside centering wrapper
+    if (data.stepLabel) {
+        parts.push(`<p class="text-sm font-bold text-${c(accent)} font-body">${escapeHtml(data.stepLabel)}</p>`);
+    }
+    parts.push(`<h2 class="text-[42px] leading-tight font-title font-bold text-d-text">${nl2br(data.title)}</h2>`);
+    if (data.subtitle) {
+        parts.push(`<p class="text-[15px] text-d-dim mt-2 font-body">${nl2br(data.subtitle)}</p>`);
+    }
+    // Stats cards
+    parts.push(`<div class="flex gap-6 mt-10">`);
     stats.forEach((stat) => {
         const color = stat.color || data.accentColor || "primary";
-        parts.push(`<div class="flex-1 bg-d-card rounded-lg shadow-lg p-8 text-center">`);
+        parts.push(`<div class="flex-1 bg-d-card rounded-lg shadow-lg p-10 text-center">`);
         parts.push(`  <div class="h-[3px] bg-${c(color)} rounded-full w-12 mx-auto mb-6"></div>`);
-        parts.push(`  <p class="text-[48px] font-bold text-${c(color)} font-body leading-none">${escapeHtml(stat.value)}</p>`);
-        parts.push(`  <p class="text-base text-d-muted font-body mt-3">${escapeHtml(stat.label)}</p>`);
+        parts.push(`  <p class="text-[52px] font-bold text-${c(color)} font-body leading-none">${escapeHtml(stat.value)}</p>`);
+        parts.push(`  <p class="text-lg text-d-muted font-body mt-4">${escapeHtml(stat.label)}</p>`);
         if (stat.change) {
             const changeColor = stat.change.startsWith("+") ? "success" : "danger";
-            parts.push(`  <p class="text-sm font-bold text-${c(changeColor)} font-body mt-2">${escapeHtml(stat.change)}</p>`);
+            parts.push(`  <p class="text-base font-bold text-${c(changeColor)} font-body mt-3">${escapeHtml(stat.change)}</p>`);
         }
         parts.push(`</div>`);
     });
     parts.push(`</div>`);
+    parts.push(`</div>`);
     if (data.callout) {
         parts.push(`<div class="mt-auto pb-4">${renderCalloutBar(data.callout)}</div>`);
     }

package/lib/slide/layouts/timeline.js

@@ -1,9 +1,21 @@
-import { escapeHtml, nl2br, c, slideHeader } from "../utils.js";
+import { escapeHtml, nl2br, c } from "../utils.js";
 export const layoutTimeline = (data) => {
-    const parts = [slideHeader(data)];
+    const accent = data.accentColor || "primary";
+    const parts = [];
     const items = data.items || [];
-    parts.push(`<div class="flex items-start px-12 mt-8 flex-1 relative">`);
-    parts.push(`<div class="absolute left-16 right-16 top-[52px] h-[2px] bg-d-alt"></div>`);
+    parts.push(`<div class="h-[3px] bg-${c(accent)} shrink-0"></div>`);
+    parts.push(`<div class="flex-1 flex flex-col justify-center px-12 min-h-0">`);
+    // Header inside centering wrapper
+    if (data.stepLabel) {
+        parts.push(`<p class="text-sm font-bold text-${c(accent)} font-body">${escapeHtml(data.stepLabel)}</p>`);
+    }
+    parts.push(`<h2 class="text-[42px] leading-tight font-title font-bold text-d-text">${nl2br(data.title)}</h2>`);
+    if (data.subtitle) {
+        parts.push(`<p class="text-[15px] text-d-dim mt-2 font-body">${nl2br(data.subtitle)}</p>`);
+    }
+    // Timeline items
+    parts.push(`<div class="flex items-start mt-10 relative">`);
+    parts.push(`<div class="absolute left-4 right-4 top-[52px] h-[2px] bg-d-alt"></div>`);
     items.forEach((item) => {
         const color = item.color || data.accentColor || "primary";
         const dotBorder = item.done ? `bg-${c(color)}` : `bg-d-alt`;
@@ -20,5 +32,6 @@ export const layoutTimeline = (data) => {
         parts.push(`</div>`);
     });
     parts.push(`</div>`);
+    parts.push(`</div>`);
     return parts.join("\n");
 };

package/lib/slide/render.d.ts

@@ -1,3 +1,3 @@
 import type { SlideTheme, SlideLayout } from "./schema.js";
 /** Generate a complete HTML document for a single slide */
-export declare const generateSlideHTML: (theme: SlideTheme, slide: SlideLayout) => string;
+export declare const generateSlideHTML: (theme: SlideTheme, slide: SlideLayout, reference?: string) => string;

package/lib/slide/render.js

@@ -22,7 +22,7 @@ const buildCdnScripts = (theme, slide) => {
     return scripts.join("\n");
 };
 /** Generate a complete HTML document for a single slide */
-export const generateSlideHTML = (theme, slide) => {
+export const generateSlideHTML = (theme, slide, reference) => {
     const content = renderSlideContent(slide);
     const twConfig = buildTailwindConfig(theme);
     const cdnScripts = buildCdnScripts(theme, slide);
@@ -30,6 +30,9 @@ export const generateSlideHTML = (theme, slide) => {
     const bgCls = slideStyle?.bgColor ? "" : "bg-d-bg";
     const inlineStyle = slideStyle?.bgColor ? ` style="background-color:#${sanitizeHex(slideStyle.bgColor)}"` : "";
     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>`
+        : "";
     return `<!DOCTYPE html>
 <html lang="en" class="h-full">
 <head>
@@ -45,6 +48,7 @@ ${cdnScripts}
 <body class="h-full">
 <div class="relative overflow-hidden ${bgCls} w-full h-full flex flex-col"${inlineStyle}>
 ${content}
+${referenceHtml}
 ${footer}
 </div>
 </body>

package/lib/slide/schema.d.ts

@@ -4421,6 +4421,7 @@ export declare const mulmoSlideMediaSchema: z.ZodObject<{
         }, z.core.$strip>>;
         layout: z.ZodLiteral<"funnel">;
     }, z.core.$strip>], "layout">;
+    reference: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type AccentColorKey = z.infer<typeof accentColorKeySchema>;
 export type SlideThemeColors = z.infer<typeof slideThemeColorsSchema>;

package/lib/slide/schema.js

@@ -345,5 +345,6 @@ export const mulmoSlideMediaSchema = z
     type: z.literal("slide"),
     theme: slideThemeSchema.optional(),
     slide: slideLayoutSchema,
+    reference: z.string().optional(),
 })
     .strict();

package/lib/types/schema.d.ts

@@ -1740,6 +1740,7 @@ export declare const mulmoImageAssetSchema: z.ZodUnion<readonly [z.ZodObject<{
         }, z.core.$strip>>;
         layout: z.ZodLiteral<"funnel">;
     }, z.core.$strip>], "layout">;
+    reference: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>]>;
 export declare const mulmoAudioAssetSchema: z.ZodUnion<readonly [z.ZodObject<{
     type: z.ZodLiteral<"audio">;
@@ -3566,6 +3567,7 @@ export declare const mulmoBeatSchema: z.ZodObject<{
             }, z.core.$strip>>;
             layout: z.ZodLiteral<"funnel">;
         }, z.core.$strip>], "layout">;
+        reference: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>]>>;
     audio: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"audio">;
@@ -6093,6 +6095,7 @@ export declare const mulmoScriptSchema: z.ZodObject<{
                 }, z.core.$strip>>;
                 layout: z.ZodLiteral<"funnel">;
             }, z.core.$strip>], "layout">;
+            reference: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>]>>;
         audio: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
             type: z.ZodLiteral<"audio">;
@@ -8281,6 +8284,7 @@ export declare const mulmoStudioSchema: z.ZodObject<{
                     }, z.core.$strip>>;
                     layout: z.ZodLiteral<"funnel">;
                 }, z.core.$strip>], "layout">;
+                reference: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>]>>;
             audio: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
                 type: z.ZodLiteral<"audio">;

package/lib/types/slide.d.ts

@@ -4421,6 +4421,7 @@ export declare const mulmoSlideMediaSchema: z.ZodObject<{
         }, z.core.$strip>>;
         layout: z.ZodLiteral<"funnel">;
     }, z.core.$strip>], "layout">;
+    reference: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type AccentColorKey = z.infer<typeof accentColorKeySchema>;
 export type SlideThemeColors = z.infer<typeof slideThemeColorsSchema>;

package/lib/types/slide.js

@@ -345,5 +345,6 @@ export const mulmoSlideMediaSchema = z
     type: z.literal("slide"),
     theme: slideThemeSchema.optional(),
     slide: slideLayoutSchema,
+    reference: z.string().optional(),
 })
     .strict();

package/lib/utils/context.d.ts

@@ -909,6 +909,7 @@ export declare const createStudioData: (_mulmoScript: MulmoScript, fileName: str
                         mono: string;
                     };
                 } | undefined;
+                reference?: string | undefined;
             } | {
                 type: "image";
                 source: {
@@ -2292,6 +2293,7 @@ export declare const initializeContextFromFiles: (files: FileObject, raiseError:
                             mono: string;
                         };
                     } | undefined;
+                    reference?: string | undefined;
                 } | {
                     type: "image";
                     source: {

package/lib/utils/image_plugins/slide.js

@@ -117,7 +117,8 @@ const processSlide = async (params) => {
         return;
     const theme = resolveTheme(params);
     const slide = resolveSlide(params, toFileUrl);
-    const html = generateSlideHTML(theme, slide);
+    const reference = beat.image.reference;
+    const html = generateSlideHTML(theme, slide, reference);
     await renderHTMLToImage(html, imagePath, canvasSize.width, canvasSize.height);
     return imagePath;
 };
@@ -127,7 +128,8 @@ const dumpHtml = async (params) => {
         return;
     const theme = resolveTheme(params);
     const slide = resolveSlide(params);
-    return generateSlideHTML(theme, slide);
+    const reference = beat.image.reference;
+    return generateSlideHTML(theme, slide, reference);
 };
 export const process = processSlide;
 export const path = parrotingImagePath;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mulmocast",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "description": "",
   "type": "module",
   "main": "lib/index.node.js",
@@ -23,6 +23,9 @@
       "default": "./lib/tools/complete_script.js"
     }
   },
+  "resolutions": {
+    "minimatch": "^10.2.2"
+  },
   "bin": {
     "mulmo": "lib/cli/bin.js",
     "mulmo-mcp": "lib/mcp/server.js"
@@ -107,7 +110,7 @@
     "marked": "^17.0.3",
     "mulmocast-vision": "^1.0.8",
     "ora": "^9.3.0",
-    "puppeteer": "^24.37.4",
+    "puppeteer": "^24.37.5",
     "replicate": "^1.4.0",
     "yaml": "^2.8.2",
     "yargs": "^18.0.0",
@@ -121,7 +124,7 @@
     "@types/jsdom": "^27.0.0",
     "@types/yargs": "^17.0.35",
     "cross-env": "^10.1.0",
-    "eslint": "^10.0.0",
+    "eslint": "^10.0.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-sonarjs": "^4.0.0",

package/scripts/test/test_slide_image_ref_en.json

@@ -280,7 +280,8 @@
             "text": "5σ means the probability of a fluke is 1 in 3.5 million — the threshold for 'discovery' in particle physics.",
             "color": "warning"
           }
-        }
+        },
+        "reference": "Source: CERN Annual Report 2024 — https://home.cern/resources/report"
       }
     }
   ]

package/scripts/test/test_slide_image_ref_gemini_en.json

@@ -0,0 +1,289 @@
+{
+  "$mulmocast": { "version": "1.1" },
+  "lang": "en",
+  "title": "The Higgs Boson — Exploring the Origin of Mass",
+  "slideParams": {
+    "theme": {
+      "colors": {
+        "bg": "0B1120",
+        "bgCard": "162032",
+        "bgCardAlt": "1E2D45",
+        "text": "F0F4F8",
+        "textMuted": "A0AEC0",
+        "textDim": "4A5568",
+        "primary": "63B3ED",
+        "accent": "B794F4",
+        "success": "68D391",
+        "warning": "F6AD55",
+        "danger": "FC8181",
+        "info": "4FD1C5",
+        "highlight": "F687B3"
+      },
+      "fonts": { "title": "Georgia", "body": "Calibri", "mono": "Consolas" }
+    }
+  },
+  "imageParams": {
+    "provider": "google",
+    "model": "gemini-3-pro-image-preview",
+    "images": {
+      "detector": {
+        "type": "imagePrompt",
+        "prompt": "A massive cylindrical particle detector at CERN, showing intricate layers of sensors and electronics in warm orange and gold lighting, photorealistic, wide-angle view from inside the detector barrel"
+      },
+      "lhc": {
+        "type": "imagePrompt",
+        "prompt": "The Large Hadron Collider tunnel at CERN, a long curved underground tunnel with blue superconducting magnets stretching into the distance, cool blue lighting, photorealistic"
+      },
+      "higgs_event": {
+        "type": "imagePrompt",
+        "prompt": "A colorful particle collision event display from the CMS detector at CERN, showing radiating particle tracks in green, red and blue lines emanating from a central collision point on a dark background, scientific visualization style"
+      }
+    }
+  },
+  "beats": [
+    {
+      "text": "What is the Higgs boson? Let's look back at the history of its discovery.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "title",
+          "title": "The Higgs Boson",
+          "subtitle": "A Journey to the Origin of Mass",
+          "author": "Introduction to Particle Physics"
+        }
+      }
+    },
+    {
+      "text": "The Higgs boson holds a special place in the Standard Model.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "columns",
+          "title": "Particles of the Standard Model",
+          "subtitle": "17 Elementary Particles",
+          "columns": [
+            {
+              "title": "Fermions",
+              "accentColor": "primary",
+              "content": [
+                { "type": "imageRef", "ref": "detector", "alt": "Fermion interactions" },
+                { "type": "bullets", "items": ["Quarks (6 types)", "Leptons (6 types)"], "icon": "⚛" },
+                { "type": "text", "value": "Particles that make up matter", "dim": true }
+              ]
+            },
+            {
+              "title": "Bosons",
+              "accentColor": "accent",
+              "content": [
+                { "type": "imageRef", "ref": "lhc", "alt": "LHC tunnel" },
+                { "type": "bullets", "items": ["Photon", "W & Z bosons", "Gluon"], "icon": "⚡" },
+                { "type": "text", "value": "Force-carrying particles", "dim": true }
+              ]
+            },
+            {
+              "title": "Higgs Boson",
+              "accentColor": "highlight",
+              "content": [
+                { "type": "imageRef", "ref": "higgs_event", "alt": "Higgs boson decay" },
+                { "type": "text", "value": "Origin of Mass", "bold": true, "color": "highlight" },
+                { "type": "text", "value": "The only scalar particle. Discovered at CERN in 2012.", "dim": true }
+              ]
+            }
+          ]
+        }
+      }
+    },
+    {
+      "text": "Let's look at the Higgs boson decay event captured by the LHC detector.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "split",
+          "left": {
+            "title": "CMS Detector Event",
+            "content": [{ "type": "imageRef", "ref": "detector", "alt": "CMS detector event display", "fit": "cover" }]
+          },
+          "right": {
+            "title": "What Are We Seeing?",
+            "content": [
+              { "type": "text", "value": "Protons are collided at near light speed, and the resulting particle tracks are captured by the detector." },
+              {
+                "type": "callout",
+                "text": "The Higgs boson cannot be observed directly — its existence is inferred from pairs of decay particles.",
+                "label": "Key Point",
+                "color": "info",
+                "style": "info"
+              },
+              { "type": "metric", "value": "125 GeV", "label": "Mass of the Higgs boson" }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "text": "A comparison of the ATLAS and CMS experiments.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "comparison",
+          "title": "Two Experiments, One Discovery",
+          "subtitle": "Each independently achieved 5σ significance",
+          "left": {
+            "title": "ATLAS Experiment",
+            "accentColor": "primary",
+            "content": [
+              { "type": "imageRef", "ref": "detector", "alt": "ATLAS detector" },
+              { "type": "metric", "value": "5.9σ", "label": "Statistical significance", "color": "primary" },
+              { "type": "text", "value": "25m diameter, 46m long. About 3,000 physicists participated." }
+            ]
+          },
+          "right": {
+            "title": "CMS Experiment",
+            "accentColor": "accent",
+            "content": [
+              { "type": "imageRef", "ref": "lhc", "alt": "CMS detector" },
+              { "type": "metric", "value": "5.0σ", "label": "Statistical significance", "color": "accent" },
+              { "type": "text", "value": "More compact but equipped with a superconducting solenoid magnet. About 4,000 participants." }
+            ]
+          },
+          "callout": {
+            "text": "The simultaneous confirmation by two independent experiments dramatically increased confidence in the result",
+            "color": "success"
+          }
+        }
+      }
+    },
+    {
+      "text": "Here's a grid overview of CERN's key facilities.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "grid",
+          "title": "CERN Experimental Facilities",
+          "subtitle": "The world's largest particle physics laboratory on the Swiss-French border",
+          "gridColumns": 2,
+          "items": [
+            {
+              "title": "LHC Accelerator",
+              "accentColor": "primary",
+              "content": [
+                { "type": "imageRef", "ref": "lhc", "alt": "LHC tunnel", "fit": "cover" },
+                { "type": "text", "value": "27km circumference, 100m underground", "dim": true }
+              ]
+            },
+            {
+              "title": "ATLAS Detector",
+              "accentColor": "accent",
+              "content": [
+                { "type": "imageRef", "ref": "detector", "alt": "ATLAS detector overview", "fit": "cover" },
+                { "type": "text", "value": "25m diameter, weighing 7,000 tonnes", "dim": true }
+              ]
+            },
+            {
+              "title": "CMS Detector",
+              "accentColor": "info",
+              "content": [
+                { "type": "imageRef", "ref": "higgs_event", "alt": "CMS detector", "fit": "cover" },
+                { "type": "text", "value": "Features superconducting solenoid", "dim": true }
+              ]
+            },
+            {
+              "title": "CERN Control Centre",
+              "accentColor": "warning",
+              "content": [
+                { "type": "imageRef", "ref": "detector", "alt": "CERN control room", "fit": "cover" },
+                { "type": "text", "value": "24/7 accelerator monitoring", "dim": true }
+              ]
+            }
+          ]
+        }
+      }
+    },
+    {
+      "text": "Here are the key milestones leading to the discovery.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "timeline",
+          "title": "Road to Discovery",
+          "items": [
+            { "date": "1964", "title": "Higgs Mechanism Proposed", "description": "P. Higgs et al. published the mass acquisition theory", "done": true },
+            { "date": "1983", "title": "W & Z Bosons Discovered", "description": "Confirmed at CERN's SPS experiments", "done": true, "color": "accent" },
+            {
+              "date": "2008",
+              "title": "LHC Begins Operation",
+              "description": "The world's largest particle accelerator starts up",
+              "done": true,
+              "color": "info"
+            },
+            {
+              "date": "2012.7.4",
+              "title": "Higgs Boson Discovered",
+              "description": "ATLAS and CMS experiments announce simultaneously",
+              "done": true,
+              "color": "highlight"
+            },
+            { "date": "2013", "title": "Nobel Prize in Physics", "description": "Awarded to Higgs and Englert", "done": true, "color": "success" }
+          ]
+        }
+      }
+    },
+    {
+      "text": "Let's explore the relationship between the Higgs field and mass.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "split",
+          "left": {
+            "title": "Visualizing the Higgs Field",
+            "content": [
+              { "type": "imageRef", "ref": "higgs_event", "alt": "Higgs field concept", "fit": "contain" },
+              { "type": "text", "value": "A field that fills all of space", "dim": true, "align": "center" }
+            ]
+          },
+          "right": {
+            "title": "Why Does Mass Arise?",
+            "content": [
+              {
+                "type": "callout",
+                "text": "The Higgs field exists everywhere in the universe. Particles acquire mass by interacting with this field.",
+                "style": "quote"
+              },
+              { "type": "divider", "color": "accent" },
+              {
+                "type": "bullets",
+                "items": [
+                  "Photon: no interaction with Higgs field → zero mass",
+                  "W boson: strong interaction → heavy",
+                  "Top quark: strongest interaction → heaviest"
+                ],
+                "icon": "→"
+              },
+              { "type": "callout", "text": "Mass = strength of coupling to the Higgs field", "label": "Key Insight", "color": "highlight" }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "text": "Let's look at the statistical significance of the discovery in numbers.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "stats",
+          "title": "The Higgs Discovery in Numbers",
+          "stats": [
+            { "value": "5σ", "label": "Statistical significance", "color": "highlight" },
+            { "value": "125.25 GeV", "label": "Measured mass" },
+            { "value": "~10⁻²² s", "label": "Lifetime" },
+            { "value": "10,000+", "label": "Researchers involved", "color": "info" }
+          ],
+          "callout": {
+            "text": "5σ means the probability of a fluke is 1 in 3.5 million — the threshold for 'discovery' in particle physics.",
+            "color": "warning"
+          }
+        }
+      }
+    }
+  ]
+}

package/scripts/test/test_slide_image_ref_gemini_en.json~

@@ -0,0 +1,289 @@
+{
+  "$mulmocast": { "version": "1.1" },
+  "lang": "en",
+  "title": "The Higgs Boson — Exploring the Origin of Mass",
+  "slideParams": {
+    "theme": {
+      "colors": {
+        "bg": "0B1120",
+        "bgCard": "162032",
+        "bgCardAlt": "1E2D45",
+        "text": "F0F4F8",
+        "textMuted": "A0AEC0",
+        "textDim": "4A5568",
+        "primary": "63B3ED",
+        "accent": "B794F4",
+        "success": "68D391",
+        "warning": "F6AD55",
+        "danger": "FC8181",
+        "info": "4FD1C5",
+        "highlight": "F687B3"
+      },
+      "fonts": { "title": "Georgia", "body": "Calibri", "mono": "Consolas" }
+    }
+  },
+  "imageParams": {
+    "provider": "genai",
+    "model": "gemini-3-pro-image-preview",
+    "images": {
+      "detector": {
+        "type": "imagePrompt",
+        "prompt": "A massive cylindrical particle detector at CERN, showing intricate layers of sensors and electronics in warm orange and gold lighting, photorealistic, wide-angle view from inside the detector barrel"
+      },
+      "lhc": {
+        "type": "imagePrompt",
+        "prompt": "The Large Hadron Collider tunnel at CERN, a long curved underground tunnel with blue superconducting magnets stretching into the distance, cool blue lighting, photorealistic"
+      },
+      "higgs_event": {
+        "type": "imagePrompt",
+        "prompt": "A colorful particle collision event display from the CMS detector at CERN, showing radiating particle tracks in green, red and blue lines emanating from a central collision point on a dark background, scientific visualization style"
+      }
+    }
+  },
+  "beats": [
+    {
+      "text": "What is the Higgs boson? Let's look back at the history of its discovery.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "title",
+          "title": "The Higgs Boson",
+          "subtitle": "A Journey to the Origin of Mass",
+          "author": "Introduction to Particle Physics"
+        }
+      }
+    },
+    {
+      "text": "The Higgs boson holds a special place in the Standard Model.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "columns",
+          "title": "Particles of the Standard Model",
+          "subtitle": "17 Elementary Particles",
+          "columns": [
+            {
+              "title": "Fermions",
+              "accentColor": "primary",
+              "content": [
+                { "type": "imageRef", "ref": "detector", "alt": "Fermion interactions" },
+                { "type": "bullets", "items": ["Quarks (6 types)", "Leptons (6 types)"], "icon": "⚛" },
+                { "type": "text", "value": "Particles that make up matter", "dim": true }
+              ]
+            },
+            {
+              "title": "Bosons",
+              "accentColor": "accent",
+              "content": [
+                { "type": "imageRef", "ref": "lhc", "alt": "LHC tunnel" },
+                { "type": "bullets", "items": ["Photon", "W & Z bosons", "Gluon"], "icon": "⚡" },
+                { "type": "text", "value": "Force-carrying particles", "dim": true }
+              ]
+            },
+            {
+              "title": "Higgs Boson",
+              "accentColor": "highlight",
+              "content": [
+                { "type": "imageRef", "ref": "higgs_event", "alt": "Higgs boson decay" },
+                { "type": "text", "value": "Origin of Mass", "bold": true, "color": "highlight" },
+                { "type": "text", "value": "The only scalar particle. Discovered at CERN in 2012.", "dim": true }
+              ]
+            }
+          ]
+        }
+      }
+    },
+    {
+      "text": "Let's look at the Higgs boson decay event captured by the LHC detector.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "split",
+          "left": {
+            "title": "CMS Detector Event",
+            "content": [{ "type": "imageRef", "ref": "detector", "alt": "CMS detector event display", "fit": "cover" }]
+          },
+          "right": {
+            "title": "What Are We Seeing?",
+            "content": [
+              { "type": "text", "value": "Protons are collided at near light speed, and the resulting particle tracks are captured by the detector." },
+              {
+                "type": "callout",
+                "text": "The Higgs boson cannot be observed directly — its existence is inferred from pairs of decay particles.",
+                "label": "Key Point",
+                "color": "info",
+                "style": "info"
+              },
+              { "type": "metric", "value": "125 GeV", "label": "Mass of the Higgs boson" }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "text": "A comparison of the ATLAS and CMS experiments.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "comparison",
+          "title": "Two Experiments, One Discovery",
+          "subtitle": "Each independently achieved 5σ significance",
+          "left": {
+            "title": "ATLAS Experiment",
+            "accentColor": "primary",
+            "content": [
+              { "type": "imageRef", "ref": "detector", "alt": "ATLAS detector" },
+              { "type": "metric", "value": "5.9σ", "label": "Statistical significance", "color": "primary" },
+              { "type": "text", "value": "25m diameter, 46m long. About 3,000 physicists participated." }
+            ]
+          },
+          "right": {
+            "title": "CMS Experiment",
+            "accentColor": "accent",
+            "content": [
+              { "type": "imageRef", "ref": "lhc", "alt": "CMS detector" },
+              { "type": "metric", "value": "5.0σ", "label": "Statistical significance", "color": "accent" },
+              { "type": "text", "value": "More compact but equipped with a superconducting solenoid magnet. About 4,000 participants." }
+            ]
+          },
+          "callout": {
+            "text": "The simultaneous confirmation by two independent experiments dramatically increased confidence in the result",
+            "color": "success"
+          }
+        }
+      }
+    },
+    {
+      "text": "Here's a grid overview of CERN's key facilities.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "grid",
+          "title": "CERN Experimental Facilities",
+          "subtitle": "The world's largest particle physics laboratory on the Swiss-French border",
+          "gridColumns": 2,
+          "items": [
+            {
+              "title": "LHC Accelerator",
+              "accentColor": "primary",
+              "content": [
+                { "type": "imageRef", "ref": "lhc", "alt": "LHC tunnel", "fit": "cover" },
+                { "type": "text", "value": "27km circumference, 100m underground", "dim": true }
+              ]
+            },
+            {
+              "title": "ATLAS Detector",
+              "accentColor": "accent",
+              "content": [
+                { "type": "imageRef", "ref": "detector", "alt": "ATLAS detector overview", "fit": "cover" },
+                { "type": "text", "value": "25m diameter, weighing 7,000 tonnes", "dim": true }
+              ]
+            },
+            {
+              "title": "CMS Detector",
+              "accentColor": "info",
+              "content": [
+                { "type": "imageRef", "ref": "higgs_event", "alt": "CMS detector", "fit": "cover" },
+                { "type": "text", "value": "Features superconducting solenoid", "dim": true }
+              ]
+            },
+            {
+              "title": "CERN Control Centre",
+              "accentColor": "warning",
+              "content": [
+                { "type": "imageRef", "ref": "detector", "alt": "CERN control room", "fit": "cover" },
+                { "type": "text", "value": "24/7 accelerator monitoring", "dim": true }
+              ]
+            }
+          ]
+        }
+      }
+    },
+    {
+      "text": "Here are the key milestones leading to the discovery.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "timeline",
+          "title": "Road to Discovery",
+          "items": [
+            { "date": "1964", "title": "Higgs Mechanism Proposed", "description": "P. Higgs et al. published the mass acquisition theory", "done": true },
+            { "date": "1983", "title": "W & Z Bosons Discovered", "description": "Confirmed at CERN's SPS experiments", "done": true, "color": "accent" },
+            {
+              "date": "2008",
+              "title": "LHC Begins Operation",
+              "description": "The world's largest particle accelerator starts up",
+              "done": true,
+              "color": "info"
+            },
+            {
+              "date": "2012.7.4",
+              "title": "Higgs Boson Discovered",
+              "description": "ATLAS and CMS experiments announce simultaneously",
+              "done": true,
+              "color": "highlight"
+            },
+            { "date": "2013", "title": "Nobel Prize in Physics", "description": "Awarded to Higgs and Englert", "done": true, "color": "success" }
+          ]
+        }
+      }
+    },
+    {
+      "text": "Let's explore the relationship between the Higgs field and mass.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "split",
+          "left": {
+            "title": "Visualizing the Higgs Field",
+            "content": [
+              { "type": "imageRef", "ref": "higgs_event", "alt": "Higgs field concept", "fit": "contain" },
+              { "type": "text", "value": "A field that fills all of space", "dim": true, "align": "center" }
+            ]
+          },
+          "right": {
+            "title": "Why Does Mass Arise?",
+            "content": [
+              {
+                "type": "callout",
+                "text": "The Higgs field exists everywhere in the universe. Particles acquire mass by interacting with this field.",
+                "style": "quote"
+              },
+              { "type": "divider", "color": "accent" },
+              {
+                "type": "bullets",
+                "items": [
+                  "Photon: no interaction with Higgs field → zero mass",
+                  "W boson: strong interaction → heavy",
+                  "Top quark: strongest interaction → heaviest"
+                ],
+                "icon": "→"
+              },
+              { "type": "callout", "text": "Mass = strength of coupling to the Higgs field", "label": "Key Insight", "color": "highlight" }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "text": "Let's look at the statistical significance of the discovery in numbers.",
+      "image": {
+        "type": "slide",
+        "slide": {
+          "layout": "stats",
+          "title": "The Higgs Discovery in Numbers",
+          "stats": [
+            { "value": "5σ", "label": "Statistical significance", "color": "highlight" },
+            { "value": "125.25 GeV", "label": "Measured mass" },
+            { "value": "~10⁻²² s", "label": "Lifetime" },
+            { "value": "10,000+", "label": "Researchers involved", "color": "info" }
+          ],
+          "callout": {
+            "text": "5σ means the probability of a fluke is 1 in 3.5 million — the threshold for 'discovery' in particle physics.",
+            "color": "warning"
+          }
+        }
+      }
+    }
+  ]
+}

package/scripts/test/test_tts_speed.json

@@ -0,0 +1,252 @@
+{
+  "$mulmocast": {
+    "version": "1.1"
+  },
+  "canvasSize": {
+    "width": 720,
+    "height": 720
+  },
+  "speechParams": {
+    "speakers": {
+      "OpenAISlow": {
+        "voiceId": "shimmer",
+        "speechOptions": {
+          "speed": 0.5
+        },
+        "provider": "openai"
+      },
+      "OpenAINormal": {
+        "voiceId": "shimmer",
+        "speechOptions": {
+          "speed": 1
+        },
+        "provider": "openai"
+      },
+      "OpenAI2x": {
+        "voiceId": "shimmer",
+        "speechOptions": {
+          "speed": 2
+        },
+        "provider": "openai"
+      },
+      "OpenAIMax": {
+        "voiceId": "shimmer",
+        "speechOptions": {
+          "speed": 4
+        },
+        "provider": "openai"
+      },
+      "GoogleSlow": {
+        "voiceId": "en-US-Standard-F",
+        "speechOptions": {
+          "speed": 0.5
+        },
+        "provider": "google"
+      },
+      "GoogleNormal": {
+        "voiceId": "en-US-Standard-F",
+        "speechOptions": {
+          "speed": 1
+        },
+        "provider": "google"
+      },
+      "GoogleMax": {
+        "voiceId": "en-US-Standard-F",
+        "speechOptions": {
+          "speed": 2
+        },
+        "provider": "google"
+      },
+      "ElevenLabsSlow": {
+        "voiceId": "3JDquces8E8bkmvbh6Bc",
+        "speechOptions": {
+          "speed": 0.7
+        },
+        "provider": "elevenlabs"
+      },
+      "ElevenLabsNormal": {
+        "voiceId": "3JDquces8E8bkmvbh6Bc",
+        "speechOptions": {
+          "speed": 1
+        },
+        "provider": "elevenlabs"
+      },
+      "ElevenLabsMax": {
+        "voiceId": "3JDquces8E8bkmvbh6Bc",
+        "speechOptions": {
+          "speed": 1.2
+        },
+        "provider": "elevenlabs"
+      },
+      "GeminiSlow": {
+        "voiceId": "Kore",
+        "speechOptions": {
+          "instruction": "Speak very slowly and deliberately, with long pauses between words. Take your time with each syllable."
+        },
+        "provider": "gemini"
+      },
+      "GeminiNormal": {
+        "voiceId": "Kore",
+        "provider": "gemini"
+      },
+      "GeminiFast": {
+        "voiceId": "Kore",
+        "speechOptions": {
+          "instruction": "Speak at a very fast pace, like a rapid-fire news anchor delivering breaking news. Rush through the words quickly."
+        },
+        "provider": "gemini"
+      }
+    }
+  },
+  "imageParams": {
+    "provider": "openai",
+    "images": {}
+  },
+  "movieParams": {
+    "provider": "replicate"
+  },
+  "soundEffectParams": {
+    "provider": "replicate"
+  },
+  "textSlideParams": {
+    "cssStyles": ["body { display: flex; flex-direction: column; justify-content: center; align-items: center; height: 100vh; text-align: center; }"]
+  },
+  "audioParams": {
+    "padding": 0.3,
+    "introPadding": 1,
+    "closingPadding": 0.8,
+    "outroPadding": 1,
+    "bgmVolume": 0.2,
+    "audioVolume": 1,
+    "suppressSpeech": false
+  },
+  "title": "TTS Speed Parameter Test",
+  "lang": "en",
+  "beats": [
+    {
+      "speaker": "OpenAISlow",
+      "text": "The quick brown fox jumps over the lazy dog. OpenAI at half speed.",
+      "id": "d67a8f87-013a-4016-b4cd-528c04cbc297",
+      "image": {
+        "type": "markdown",
+        "markdown": ["## OpenAI", "## speed: 0.5 (slow)"]
+      }
+    },
+    {
+      "speaker": "OpenAINormal",
+      "text": "The quick brown fox jumps over the lazy dog. OpenAI at normal speed.",
+      "id": "36119196-a206-4aed-8674-cc9bad47ef0c",
+      "image": {
+        "type": "markdown",
+        "markdown": ["## OpenAI", "## speed: 1.0 (normal)"]
+      }
+    },
+    {
+      "speaker": "OpenAI2x",
+      "text": "The quick brown fox jumps over the lazy dog. OpenAI at double speed.",
+      "id": "970e7d58-d497-4eea-9861-f04e848db10b",
+      "image": {
+        "type": "markdown",
+        "markdown": ["## OpenAI", "## speed: 2.0 (2x)"]
+      }
+    },
+    {
+      "speaker": "OpenAIMax",
+      "text": "The quick brown fox jumps over the lazy dog. OpenAI at maximum speed.",
+      "id": "3ca5d27e-82af-48de-97e9-1a43f739f79b",
+      "image": {
+        "type": "markdown",
+        "markdown": ["## OpenAI", "## speed: 4.0 (max)"]
+      }
+    },
+    {
+      "speaker": "GoogleSlow",
+      "text": "The quick brown fox jumps over the lazy dog. Google Cloud at half speed.",
+      "id": "04628574-8b75-4ca8-b6a5-6c37713c0c0e",
+      "image": {
+        "type": "markdown",
+        "markdown": ["## Google", "## speed: 0.5 (slow)"]
+      }
+    },
+    {
+      "speaker": "GoogleNormal",
+      "text": "The quick brown fox jumps over the lazy dog. Google Cloud at normal speed.",
+      "id": "4716cafe-3b5f-4d23-b6e9-716f44b14171",
+      "image": {
+        "type": "markdown",
+        "markdown": ["## Google", "## speed: 1.0 (normal)"]
+      }
+    },
+    {
+      "speaker": "GoogleMax",
+      "text": "The quick brown fox jumps over the lazy dog. Google Cloud at maximum speed.",
+      "id": "dc98f3a6-4394-4c14-a88e-7308ddace081",
+      "image": {
+        "type": "markdown",
+        "markdown": ["## Google", "## speed: 2.0 (max)"]
+      }
+    },
+    {
+      "speaker": "ElevenLabsSlow",
+      "text": "The quick brown fox jumps over the lazy dog. ElevenLabs at minimum speed.",
+      "id": "d8a72016-c51d-45d4-9e14-bc5889066cdc",
+      "image": {
+        "type": "markdown",
+        "markdown": ["## ElevenLabs", "## speed: 0.7 (slow)"]
+      }
+    },
+    {
+      "speaker": "ElevenLabsNormal",
+      "text": "The quick brown fox jumps over the lazy dog. ElevenLabs at normal speed.",
+      "id": "cad52e62-9981-44cd-ae26-70c230fdf850",
+      "image": {
+        "type": "markdown",
+        "markdown": ["## ElevenLabs", "## speed: 1.0 (normal)"]
+      }
+    },
+    {
+      "speaker": "ElevenLabsMax",
+      "text": "The quick brown fox jumps over the lazy dog. ElevenLabs at maximum speed.",
+      "id": "a13cbd67-2fd7-4f97-90fb-82d5dcd40bcb",
+      "image": {
+        "type": "markdown",
+        "markdown": ["## ElevenLabs", "## speed: 1.2 (max)"]
+      }
+    },
+    {
+      "speaker": "GeminiSlow",
+      "text": "The quick brown fox jumps over the lazy dog. Gemini with slow prompt.",
+      "id": "14e932ae-9bcb-4d17-802e-902a7dec9aad",
+      "image": {
+        "type": "markdown",
+        "markdown": [
+          "## Gemini slow",
+          "### instruction (prompt):",
+          "### Speak very slowly and deliberately, with long pauses between words. Take your time with each syllable."
+        ]
+      }
+    },
+    {
+      "speaker": "GeminiNormal",
+      "text": "The quick brown fox jumps over the lazy dog. Gemini at normal speed.",
+      "id": "c223b046-65dc-4425-987f-3ea3f36e7b27",
+      "image": {
+        "type": "markdown",
+        "markdown": ["## Gemini normal", "### instruction (prompt):", "### (no instruction)"]
+      }
+    },
+    {
+      "speaker": "GeminiFast",
+      "text": "The quick brown fox jumps over the lazy dog. Gemini with fast prompt.",
+      "id": "88db419f-bf6d-42f7-8d04-02131806c3a5",
+      "image": {
+        "type": "markdown",
+        "markdown": [
+          "## Gemini fast",
+          "### instruction (prompt):",
+          "### Speak at a very fast pace, like a rapid-fire news anchor delivering breaking news. Rush through the words quickly."
+        ]
+      }
+    }
+  ]
+}