mulmocast 2.7.1 → 2.7.2

package/lib/methods/index.d.ts

@@ -1,5 +1,5 @@
 export * from "./mulmo_presentation_style.js";
 export * from "./mulmo_studio_context.js";
 export * from "./mulmo_media_source.js";
-export * from "./mulmo_beat.js";
+export * from "./mulmo_beat_node.js";
 export * from "./mulmo_script.js";

package/lib/methods/index.js

@@ -1,5 +1,7 @@
 export * from "./mulmo_presentation_style.js";
 export * from "./mulmo_studio_context.js";
 export * from "./mulmo_media_source.js";
-export * from "./mulmo_beat.js";
+// Node-only MulmoBeatMethods (includes getPlugin). The browser-safe subset lives in
+// ./mulmo_beat.js and is re-exported by ../index.common.js for mulmocast/browser.
+export * from "./mulmo_beat_node.js";
 export * from "./mulmo_script.js";

package/lib/methods/mulmo_beat.d.ts

@@ -9,13 +9,6 @@ export declare const MulmoBeatMethods: {
     isAnimatedHtmlTailwind: (beat: MulmoBeat) => boolean;
     isMovieMode: (animation: unknown) => boolean;
     getHtmlPrompt(beat: MulmoBeat): string | undefined;
-    getPlugin(beat: MulmoBeat): {
-        imageType: string;
-        process: (params: import("../types/type.js").ImageProcessorParams) => Promise<string | undefined> | void;
-        path: (params: import("../types/type.js").ImageProcessorParams) => string | undefined;
-        markdown?: (params: import("../types/type.js").ImageProcessorParams) => string | undefined;
-        html?: (params: import("../types/type.js").ImageProcessorParams) => Promise<string | undefined>;
-    };
     getImageReferenceForImageGenerator(beat: MulmoBeat, imageRefs: Record<string, string>): string[];
 };
 export {};

package/lib/methods/mulmo_beat.js

@@ -1,4 +1,3 @@
-import { findImagePlugin } from "../utils/image_plugins/index.js";
 /** Type guard: checks if animation value is an object config like { fps: 30 } */
 const isAnimationObject = (animation) => {
     return typeof animation === "object" && animation !== null && !Array.isArray(animation);
@@ -29,13 +28,6 @@ export const MulmoBeatMethods = {
         }
         return beat?.htmlPrompt?.prompt;
     },
-    getPlugin(beat) {
-        const plugin = findImagePlugin(beat?.image?.type);
-        if (!plugin) {
-            throw new Error(`invalid beat image type: ${beat.image}`); // TODO: cause
-        }
-        return plugin;
-    },
     getImageReferenceForImageGenerator(beat, imageRefs) {
         const imageNames = beat.imageNames ?? Object.keys(imageRefs); // use all images if imageNames is not specified
         const sources = imageNames.map((name) => imageRefs[name]);

package/lib/methods/mulmo_beat_node.d.ts

@@ -0,0 +1,22 @@
+import { MulmoBeat } from "../types/index.js";
+export declare const MulmoBeatMethods: {
+    getPlugin(beat: MulmoBeat): {
+        imageType: string;
+        process: (params: import("../types/type.js").ImageProcessorParams) => Promise<string | undefined> | void;
+        path: (params: import("../types/type.js").ImageProcessorParams) => string | undefined;
+        markdown?: (params: import("../types/type.js").ImageProcessorParams) => string | undefined;
+        html?: (params: import("../types/type.js").ImageProcessorParams) => Promise<string | undefined>;
+    };
+    isAnimationEnabled: (animation: unknown) => animation is true | {
+        fps?: number;
+        movie?: boolean;
+    };
+    isAnimationObject: (animation: unknown) => animation is {
+        fps?: number;
+        movie?: boolean;
+    };
+    isAnimatedHtmlTailwind: (beat: MulmoBeat) => boolean;
+    isMovieMode: (animation: unknown) => boolean;
+    getHtmlPrompt(beat: MulmoBeat): string | undefined;
+    getImageReferenceForImageGenerator(beat: MulmoBeat, imageRefs: Record<string, string>): string[];
+};

package/lib/methods/mulmo_beat_node.js

@@ -0,0 +1,10 @@
+import { MulmoBeatMethods as MulmoBeatMethodsBrowser } from "./mulmo_beat.js";
+import { getBeatPlugin } from "../utils/image_plugins/index.js";
+// Node-only extension of MulmoBeatMethods. Kept out of methods/mulmo_beat.ts so
+// browser bundles (mulmocast/browser) do not pull in image_plugins → mulmocast-vision → puppeteer.
+export const MulmoBeatMethods = {
+    ...MulmoBeatMethodsBrowser,
+    getPlugin(beat) {
+        return getBeatPlugin(beat);
+    },
+};

package/lib/types/schema.js

@@ -423,8 +423,16 @@ export const audioParamsSchema = z
     .object({
     padding: z.number().optional().default(0.3).describe("Padding between beats"), // seconds
     introPadding: z.number().optional().default(1.0).describe("Padding at the beginning of the audio"), // seconds
-    closingPadding: z.number().optional().default(0.8).describe("Padding before the last beat"), // seconds
-    outroPadding: z.number().optional().default(1.0).describe("Padding at the end of the audio"), // seconds
+    closingPadding: z
+        .number()
+        .optional()
+        .default(0.8)
+        .describe("Padding before the last beat (typically the closing credit). For padding after the last beat, use outroPadding"), // seconds
+    outroPadding: z
+        .number()
+        .optional()
+        .default(1.0)
+        .describe("Padding after the last beat, at the very end of the audio where the BGM fades out (distinct from closingPadding, which comes before the last beat)"), // seconds
     bgm: mediaSourceSchema.optional(),
     bgmVolume: z.number().optional().default(0.2).describe("Volume of the background music"),
     audioVolume: z.number().optional().default(1.0).describe("Volume of the audio"),

package/lib/utils/image_plugins/index.d.ts

@@ -1,4 +1,4 @@
-import { ImageProcessorParams } from "../../types/index.js";
+import { ImageProcessorParams, MulmoBeat } from "../../types/index.js";
 export declare const findImagePlugin: (imageType?: string) => {
     imageType: string;
     process: (params: ImageProcessorParams) => Promise<string | undefined> | void;
@@ -6,3 +6,10 @@ export declare const findImagePlugin: (imageType?: string) => {
     markdown?: (params: ImageProcessorParams) => string | undefined;
     html?: (params: ImageProcessorParams) => Promise<string | undefined>;
 } | undefined;
+export declare const getBeatPlugin: (beat: MulmoBeat) => {
+    imageType: string;
+    process: (params: ImageProcessorParams) => Promise<string | undefined> | void;
+    path: (params: ImageProcessorParams) => string | undefined;
+    markdown?: (params: ImageProcessorParams) => string | undefined;
+    html?: (params: ImageProcessorParams) => Promise<string | undefined>;
+};

package/lib/utils/image_plugins/index.js

@@ -25,3 +25,10 @@ const imagePlugins = [
 export const findImagePlugin = (imageType) => {
     return imagePlugins.find((plugin) => plugin.imageType === imageType);
 };
+export const getBeatPlugin = (beat) => {
+    const plugin = findImagePlugin(beat?.image?.type);
+    if (!plugin) {
+        throw new Error(`invalid beat image type: ${beat.image}`);
+    }
+    return plugin;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mulmocast",
-  "version": "2.7.1",
+  "version": "2.7.2",
   "description": "",
   "type": "module",
   "main": "lib/index.node.js",