simple-ffmpegjs 0.5.2 → 0.5.4

package/src/lib/utils.js

@@ -49,7 +49,7 @@ function parseFFmpegProgress(line, totalDuration) {
     if (totalDuration > 0) {
       progress.percent = Math.min(
         100,
-        Math.round((progress.timeProcessed / totalDuration) * 100)
+        Math.round((progress.timeProcessed / totalDuration) * 100),
       );
     }
   }
@@ -146,7 +146,7 @@ function runFFmpeg({ command, totalDuration = 0, onProgress, signal, onLog }) {
         new FFmpegError(`FFmpeg process error: ${error.message}`, {
           stderr,
           command,
-        })
+        }),
       );
     });
 
@@ -162,7 +162,7 @@ function runFFmpeg({ command, totalDuration = 0, onProgress, signal, onLog }) {
             stderr,
             command,
             exitCode: code,
-          })
+          }),
         );
         return;
       }
@@ -205,7 +205,7 @@ function parseFFmpegCommand(command) {
       } else {
         current += char;
       }
-    } else if (char === '"' || char === "'") {
+    } else if (char === "\"" || char === "'") {
       inQuote = true;
       quoteChar = char;
     } else if (char === " " || char === "\t") {

package/src/loaders.js

@@ -20,7 +20,7 @@ async function loadVideo(project, clipObj) {
               message: `cutFrom exceeds source duration`,
             },
           ],
-        }
+        },
       );
     }
   }
@@ -37,7 +37,7 @@ async function loadVideo(project, clipObj) {
       console.warn(
         `Video clip overruns source by ${(
           requestedDuration - maxAvailable
-        ).toFixed(3)}s. Clamping end from ${clipObj.end}s to ${clampedEnd}s.`
+        ).toFixed(3)}s. Clamping end from ${clipObj.end}s to ${clampedEnd}s.`,
       );
       clipObj.end = clampedEnd;
     }
@@ -65,7 +65,7 @@ async function loadAudio(project, clipObj) {
               message: `cutFrom exceeds source duration`,
             },
           ],
-        }
+        },
       );
     }
   }
@@ -82,7 +82,7 @@ async function loadAudio(project, clipObj) {
       console.warn(
         `Audio clip overruns source by ${(
           requestedDuration - maxAvailable
-        ).toFixed(3)}s. Clamping end from ${clipObj.end}s to ${clampedEnd}s.`
+        ).toFixed(3)}s. Clamping end from ${clipObj.end}s to ${clampedEnd}s.`,
       );
       clipObj.end = clampedEnd;
     }
@@ -126,7 +126,7 @@ async function loadBackgroundAudio(project, clipObj) {
               message: `cutFrom exceeds source duration`,
             },
           ],
-        }
+        },
       );
     }
   }
@@ -143,7 +143,7 @@ async function loadBackgroundAudio(project, clipObj) {
       console.warn(
         `Background audio overruns source by ${(
           requestedDuration - maxAvailable
-        ).toFixed(3)}s. Clamping end from ${clip.end}s to ${clampedEnd}s.`
+        ).toFixed(3)}s. Clamping end from ${clip.end}s to ${clampedEnd}s.`,
       );
       clip.end = clampedEnd;
     }
@@ -206,7 +206,7 @@ function loadSubtitle(project, clipObj) {
             message: `Unsupported subtitle format '${ext}'`,
           },
         ],
-      }
+      },
     );
   }
 
@@ -237,7 +237,7 @@ async function loadColor(project, clipObj) {
 
     const tempPath = path.join(
       project.options.tempDir || os.tmpdir(),
-      `simpleffmpeg-gradient-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.ppm`
+      `simpleffmpeg-gradient-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.ppm`,
     );
     fs.writeFileSync(tempPath, ppmBuffer);
 

package/src/schema/formatter.js

@@ -97,7 +97,7 @@ function formatSchema(modules, options = {}) {
   lines.push("# SIMPLEFFMPEG — Clip Schema");
   lines.push("");
   lines.push(
-    "Compose a video by defining an array of clips passed to `load(clips)`. Each clip has a `type` that determines its role."
+    "Compose a video by defining an array of clips passed to `load(clips)`. Each clip has a `type` that determines its role.",
   );
   lines.push("");
 
@@ -105,22 +105,22 @@ function formatSchema(modules, options = {}) {
   lines.push("### Timeline");
   lines.push("");
   lines.push(
-    "- All times are in **seconds**. `position` = when the clip starts, `end` = when it ends."
+    "- All times are in **seconds**. `position` = when the clip starts, `end` = when it ends.",
   );
   lines.push(
-    "- **`duration`** can be used instead of `end`: the library computes `end = position + duration`. Cannot use both."
+    "- **`duration`** can be used instead of `end`: the library computes `end = position + duration`. Cannot use both.",
   );
   lines.push(
-    "- **Auto-sequencing:** For video, image, and audio clips, `position` can be omitted. The clip will be placed immediately after the previous clip on its track. The first clip defaults to position 0."
+    "- **Auto-sequencing:** For video, image, and audio clips, `position` can be omitted. The clip will be placed immediately after the previous clip on its track. The first clip defaults to position 0.",
   );
   lines.push(
-    "- Video/image clips form the visual timeline. Audio, text, and music are layered on top."
+    "- Video/image clips form the visual timeline. Audio, text, and music are layered on top.",
   );
   lines.push(
-    "- When video clips overlap with a transition, the overlapping time is shared — a 0.5s fade means the total video is 0.5s shorter."
+    "- When video clips overlap with a transition, the overlapping time is shared — a 0.5s fade means the total video is 0.5s shorter.",
   );
   lines.push(
-    "- Text and subtitle positions represent **visual time** (what the viewer sees). Transition compression is handled automatically."
+    "- Text and subtitle positions represent **visual time** (what the viewer sees). Transition compression is handled automatically.",
   );
   lines.push("");
 
@@ -140,14 +140,14 @@ function formatSchema(modules, options = {}) {
 
   // Clip type summary
   const typeMap = {
-    video: '"video"',
-    audio: '"audio"',
-    image: '"image"',
-    color: '"color"',
-    effect: '"effect"',
-    text: '"text"',
-    subtitle: '"subtitle"',
-    music: '"music" or "backgroundAudio"',
+    video: "\"video\"",
+    audio: "\"audio\"",
+    image: "\"image\"",
+    color: "\"color\"",
+    effect: "\"effect\"",
+    text: "\"text\"",
+    subtitle: "\"subtitle\"",
+    music: "\"music\" or \"backgroundAudio\"",
   };
   const availableTypes = modules
     .filter((m) => typeMap[m.id])

package/src/schema/index.js

@@ -51,8 +51,8 @@ function resolveModules(options = {}) {
       if (!ALL_MODULES[id]) {
         throw new Error(
           `Unknown schema module "${id}". Available modules: ${ALL_MODULE_IDS.join(
-            ", "
-          )}`
+            ", ",
+          )}`,
         );
       }
     }
@@ -64,8 +64,8 @@ function resolveModules(options = {}) {
       if (!ALL_MODULES[id]) {
         throw new Error(
           `Unknown schema module "${id}". Available modules: ${ALL_MODULE_IDS.join(
-            ", "
-          )}`
+            ", ",
+          )}`,
         );
       }
     }

package/src/schema/modules/effect.js

@@ -8,9 +8,10 @@ module.exports = {
   effect: "vignette" | "filmGrain" | "gaussianBlur" | "colorAdjust"
         | "sepia" | "blackAndWhite" | "sharpen" | "chromaticAberration"
         | "letterbox";                      // Required: effect kind
-  position: number;                         // Required: start time on timeline (seconds)
-  end?: number;                             // End time on timeline (seconds). Use end OR duration, not both.
-  duration?: number;                        // Duration in seconds (alternative to end). end = position + duration.
+  position?: number;                        // Start time on timeline (seconds). Required unless fullDuration is true.
+  end?: number;                             // End time on timeline (seconds). Use end OR duration, not both. Mutually exclusive with fullDuration.
+  duration?: number;                        // Duration in seconds (alternative to end). end = position + duration. Mutually exclusive with fullDuration.
+  fullDuration?: boolean;                   // When true, spans the full visual timeline. Mutually exclusive with end and duration.
   fadeIn?: number;                          // Optional: seconds to ramp in from 0 to full intensity
   fadeOut?: number;                         // Optional: seconds to ramp out from full intensity to 0
   params: EffectParams;                     // Required: effect-specific parameters
@@ -116,7 +117,7 @@ module.exports = {
     "Effect clips are adjustment layers: they modify underlying video during their active window.",
     "Effects do not satisfy visual timeline continuity checks and do not fill gaps.",
     "Use duration instead of end to specify length: end = position + duration. Cannot use both.",
-    "position is required for effect clips (no auto-sequencing).",
+    "position is required unless fullDuration: true is set, which spans the entire visual timeline.",
     "fadeIn/fadeOut are optional linear envelope controls that avoid abrupt on/off changes.",
     "params.amount is a normalized blend amount from 0 to 1 (default: 1).",
     "filmGrain: use params.strength (0-1) for noise intensity, params.amount for blend alpha.",

package/src/schema/modules/music.js

@@ -24,7 +24,7 @@ module.exports = {
     },
   ],
   notes: [
-    'The type can be either "music" or "backgroundAudio" — both work identically.',
+    "The type can be either \"music\" or \"backgroundAudio\" — both work identically.",
     "Default volume is 0.2 (20%), so background music doesn't overpower speech or main audio.",
     "When loop is true, the track repeats seamlessly to fill the video duration. position/end are not required with loop.",
   ],

package/src/schema/modules/text.js

@@ -5,9 +5,10 @@ module.exports = {
     "Render text overlays on the video with multiple display modes, positioning, styling, and animations.",
   schema: `{
   type: "text";                   // Required: clip type identifier
-  position: number;               // Required: start time on timeline (seconds)
-  end?: number;                   // End time on timeline (seconds). Use end OR duration, not both.
-  duration?: number;              // Duration in seconds (alternative to end). end = position + duration.
+  position?: number;              // Start time on timeline (seconds). Required unless fullDuration is true.
+  end?: number;                   // End time on timeline (seconds). Use end OR duration, not both. Mutually exclusive with fullDuration.
+  duration?: number;              // Duration in seconds (alternative to end). end = position + duration. Mutually exclusive with fullDuration.
+  fullDuration?: boolean;         // When true, spans the full visual timeline. Mutually exclusive with end and duration.
 
   // Content
   text?: string;                  // Text content (required for "static" mode)