@bendyline/squisq-video 2.3.10 → 2.3.11

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Doc, Theme, VideoPresentation, VideoPipSize, VideoPipShape, VideoPipPosition, ViewportPreset } from '@bendyline/squisq/schemas';
+import { MediaScheduleOptions, Doc, Theme, VideoPresentation, VideoPipSize, VideoPipShape, VideoPipPosition, ViewportPreset } from '@bendyline/squisq/schemas';
 export { fetchFile } from '@ffmpeg/util';
 
 /**
@@ -191,6 +191,16 @@ interface AudioTimelineClip {
      * authored audio/narration source, whose decode failure remains an error.
      */
     sourceKind?: 'video';
+    /** Clip gain in dB (media-edit recipe). Omitted means unity. */
+    gainDb?: number;
+    /**
+     * Linear fade-in over the first seconds of this clip. Also set to a few
+     * milliseconds on the inner edges of a cut clip's segments, so a cut never
+     * clicks.
+     */
+    fadeInSec?: number;
+    /** Linear fade-out over the last seconds of this clip (see {@link fadeInSec}). */
+    fadeOutSec?: number;
 }
 interface ComputeAudioTimelineOptions {
     /**
@@ -199,6 +209,12 @@ interface ComputeAudioTimelineOptions {
      * explicitly retain the legacy audio-only behavior.
      */
     includeVideoAudio?: boolean;
+    /**
+     * Processed-audio lookup forwarded to `resolveMediaSchedule`. With a render
+     * available, an edited clip's audio comes from its render (and a video's own
+     * audio track is left out). Omitted → original audio everywhere.
+     */
+    processedAudio?: MediaScheduleOptions['processedAudio'];
 }
 /**
  * Flatten a doc's narration + timed-media audio into absolute-timed clips.

package/dist/index.js

@@ -66,6 +66,20 @@ function resolveFfmpegWasmLoad(config, context, defaults) {
 // src/audioTimeline.ts
 import { resolveMediaSchedule } from "@bendyline/squisq/schemas";
 import { flattenRenderableBlocks, materializeBlockLayers } from "@bendyline/squisq/doc";
+var CUT_EDGE_FADE_SEC = 0.01;
+function clipDynamics(clip) {
+  const out = {};
+  if (clip.gain != null && clip.gain !== 0) out.gainDb = clip.gain;
+  let fadeIn = clip.fadeIn ?? 0;
+  let fadeOut = clip.fadeOut ?? 0;
+  if (clip.segment) {
+    if (clip.segment.index > 0) fadeIn = Math.max(fadeIn, CUT_EDGE_FADE_SEC);
+    if (clip.segment.index < clip.segment.count - 1) fadeOut = Math.max(fadeOut, CUT_EDGE_FADE_SEC);
+  }
+  if (fadeIn > 0) out.fadeInSec = fadeIn;
+  if (fadeOut > 0) out.fadeOutSec = fadeOut;
+  return out;
+}
 function computeAudioTimeline(doc, coverPreRoll = 0, options = {}) {
   const preRoll = safeSeconds(coverPreRoll);
   const includeVideoAudio = options.includeVideoAudio ?? true;
@@ -78,8 +92,13 @@ function computeAudioTimeline(doc, coverPreRoll = 0, options = {}) {
     }
     cursor += durationSec;
   }
-  for (const clip of resolveMediaSchedule(doc)) {
+  const schedule = resolveMediaSchedule(
+    doc,
+    options.processedAudio ? { processedAudio: options.processedAudio } : void 0
+  );
+  for (const clip of schedule) {
     if (clip.kind !== "audio" && !includeVideoAudio) continue;
+    if (clip.kind === "video" && clip.audioMuted) continue;
     if (!Number.isFinite(clip.absoluteStart) || !Number.isFinite(clip.absoluteEnd)) continue;
     const durationSec = Math.max(0, clip.absoluteEnd - clip.absoluteStart);
     if (durationSec <= 0 || !clip.src) continue;
@@ -88,7 +107,8 @@ function computeAudioTimeline(doc, coverPreRoll = 0, options = {}) {
       startSec: safeSeconds(clip.absoluteStart) + preRoll,
       sourceInSec: safeSeconds(clip.sourceIn),
       durationSec,
-      ...clip.kind === "video" ? { sourceKind: "video" } : {}
+      ...clip.kind === "video" ? { sourceKind: "video" } : {},
+      ...clipDynamics(clip)
     });
   }
   if (includeVideoAudio) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-video",
-  "version": "2.3.10",
+  "version": "2.3.11",
   "description": "Cross-runtime video and animated-GIF helpers with browser-based ffmpeg.wasm encoding for Squisq documents",
   "license": "MIT",
   "author": "Bendyline",
@@ -48,7 +48,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.11.7",
+    "@bendyline/squisq": "2.11.8",
     "@ffmpeg/ffmpeg": "0.12.15",
     "@ffmpeg/util": "0.12.2"
   },