@gannochenko/staticstripes 0.0.21 → 0.0.23

package/src/sequence.ts

@@ -16,13 +16,14 @@ import {
   Stream,
   VisualFilter,
 } from './stream';
-import { Output, SequenceDefinition } from './type';
+import { Output, SequenceDefinition, FragmentDebugInfo } from './type';
 
 export class Sequence {
   private time: number = 0; // time is absolute
 
   private videoStream!: Stream;
   private audioStream!: Stream;
+  private debugInfo: FragmentDebugInfo[] = []; // Collect debug info during build
 
   constructor(
     private buf: FilterBuffer,
@@ -44,6 +45,11 @@ export class Sequence {
         this.expressionContext,
       );
 
+      const calculatedDuration = calculateFinalValue(
+        fragment.duration,
+        this.expressionContext,
+      );
+
       if (fragment.id === 'outro_message') {
         debugger;
       }
@@ -51,7 +57,7 @@ export class Sequence {
       const timeContext: TimeData = {
         start: 0,
         end: 0,
-        duration: fragment.duration,
+        duration: calculatedDuration,
       };
 
       const asset = this.assetManager.getAssetByName(fragment.assetName);
@@ -69,7 +75,7 @@ export class Sequence {
       } else {
         // Create blank transparent video stream for audio-only assets
         currentVideoStream = makeBlankStream(
-          fragment.duration,
+          calculatedDuration,
           this.output.resolution.width,
           this.output.resolution.height,
           this.output.fps,
@@ -78,36 +84,40 @@ export class Sequence {
       }
 
       // Create audio stream: use actual audio if available, otherwise create silent stream
+      // If fragment has -sound: off, always use silence
       let currentAudioStream: Stream;
-      if (asset.hasAudio) {
+      if (fragment.sound === 'off') {
+        // Force silent audio when -sound: off
+        currentAudioStream = makeSilentStream(calculatedDuration, this.buf);
+      } else if (asset.hasAudio) {
         currentAudioStream = makeStream(
           this.assetManager.getAudioInputLabelByAssetName(fragment.assetName),
           this.buf,
         );
       } else {
         // Create silent audio stream matching the video duration
-        currentAudioStream = makeSilentStream(fragment.duration, this.buf);
+        currentAudioStream = makeSilentStream(calculatedDuration, this.buf);
       }
 
       // duration and clipping adjustment
-      if (fragment.trimLeft != 0 || fragment.duration < asset.duration) {
+      if (fragment.trimLeft != 0 || calculatedDuration < asset.duration) {
         // console.log('fragment.trimLeft=' + fragment.trimLeft);
-        // console.log('fragment.duration=' + fragment.duration);
+        // console.log('fragment.duration=' + calculatedDuration);
         // console.log('asset.duration=' + asset.duration);
 
         // Only trim video if it came from an actual source
         if (asset.hasVideo) {
           currentVideoStream.trim(
             fragment.trimLeft,
-            fragment.trimLeft + fragment.duration,
+            fragment.trimLeft + calculatedDuration,
           );
         }
 
-        // Only trim audio if it came from an actual source
-        if (asset.hasAudio) {
+        // Only trim audio if it came from an actual source AND sound is not off
+        if (asset.hasAudio && fragment.sound !== 'off') {
           currentAudioStream.trim(
             fragment.trimLeft,
-            fragment.trimLeft + fragment.duration,
+            fragment.trimLeft + calculatedDuration,
           );
         }
       }
@@ -124,12 +134,12 @@ export class Sequence {
 
       if (
         asset.duration === 0 &&
-        fragment.duration > 0 &&
+        calculatedDuration > 0 &&
         asset.type === 'image'
       ) {
         // special case for images - extend static image to desired duration
         currentVideoStream.tPad({
-          start: fragment.duration,
+          start: calculatedDuration,
           startMode: 'clone',
         });
       }
@@ -202,7 +212,7 @@ export class Sequence {
           fades: [
             {
               type: 'out',
-              startTime: fragment.duration - fragment.transitionOutDuration,
+              startTime: calculatedDuration - fragment.transitionOutDuration,
               duration: fragment.transitionOutDuration,
             },
           ],
@@ -211,7 +221,7 @@ export class Sequence {
           fades: [
             {
               type: 'out',
-              startTime: fragment.duration - fragment.transitionOutDuration,
+              startTime: calculatedDuration - fragment.transitionOutDuration,
               duration: fragment.transitionOutDuration,
             },
           ],
@@ -239,7 +249,7 @@ export class Sequence {
 
           // console.log('this.time=' + this.time);
           // console.log('streamDuration=' + this.time);
-          // console.log('otherStreamDuration=' + fragment.duration);
+          // console.log('otherStreamDuration=' + calculatedDuration);
           // console.log('otherStreamOffsetLeft=' + otherStreamOffsetLeft);
 
           // use overlay
@@ -247,14 +257,14 @@ export class Sequence {
             flipLayers: fragment.overlayZIndex < 0,
             offset: {
               streamDuration: this.time,
-              otherStreamDuration: fragment.duration,
+              otherStreamDuration: calculatedDuration,
               otherStreamOffsetLeft: otherStreamOffsetLeft,
             },
           });
           this.audioStream.overlayStream(currentAudioStream, {
             offset: {
               streamDuration: this.time,
-              otherStreamDuration: fragment.duration,
+              otherStreamDuration: calculatedDuration,
               otherStreamOffsetLeft: otherStreamOffsetLeft,
             },
           });
@@ -291,13 +301,25 @@ export class Sequence {
       }
 
       timeContext.start = this.time + calculatedOverlayLeft;
-      timeContext.end = this.time + fragment.duration + calculatedOverlayLeft;
-      this.time += fragment.duration + calculatedOverlayLeft;
+      timeContext.end = this.time + calculatedDuration + calculatedOverlayLeft;
+      this.time += calculatedDuration + calculatedOverlayLeft;
 
       this.expressionContext.fragments.set(fragment.id, {
         time: timeContext,
       });
 
+      // Collect debug info
+      this.debugInfo.push({
+        id: fragment.id,
+        assetName: fragment.assetName,
+        startTime: timeContext.start,
+        endTime: timeContext.end,
+        duration: calculatedDuration,
+        trimLeft: fragment.trimLeft,
+        overlayLeft: calculatedOverlayLeft,
+        enabled: fragment.enabled,
+      });
+
       // console.log('new time=' + this.time);
 
       firstOne = false;
@@ -327,4 +349,12 @@ export class Sequence {
   public getAudioStream(): Stream {
     return this.audioStream;
   }
+
+  public getDebugInfo(): FragmentDebugInfo[] {
+    return this.debugInfo;
+  }
+
+  public getTotalDuration(): number {
+    return this.time;
+  }
 }

package/src/type.ts

@@ -47,7 +47,7 @@ export type Fragment = {
   id: string;
   enabled: boolean;
   assetName: string;
-  duration: number; // calculated, in seconds (can come from CSS or from the asset's duration)
+  duration: number | CompiledExpression; // calculated, in seconds (can come from CSS or from the asset's duration, or be a calc() expression)
   trimLeft: number; // in seconds (skip first N seconds of asset via -trim-start)
   overlayLeft: number | CompiledExpression; // amount of seconds to overlay with the previous fragment (normalized from margin-left + prev margin-right)
   overlayZIndex: number;
@@ -66,6 +66,7 @@ export type Fragment = {
   chromakeySimilarity: number;
   chromakeyColor: string;
   visualFilter?: string; // Optional visual filter (e.g., 'instagram-nashville')
+  sound: 'on' | 'off'; // Whether to use asset audio or replace with silence (default: 'on')
   container?: Container; // Optional container attached to this fragment
   app?: App; // Optional app attached to this fragment
   timecodeLabel?: string; // Optional label for timecode (from data-timecode attribute)
@@ -75,6 +76,23 @@ export type SequenceDefinition = {
   fragments: Fragment[];
 };
 
+export type FragmentDebugInfo = {
+  id: string;
+  assetName: string;
+  startTime: number; // absolute start time in seconds
+  endTime: number; // absolute end time in seconds
+  duration: number; // fragment duration in seconds
+  trimLeft: number; // trim from asset start in seconds
+  overlayLeft: number; // overlay with previous fragment in seconds
+  enabled: boolean;
+};
+
+export type SequenceDebugInfo = {
+  sequenceIndex: number;
+  totalDuration: number; // total duration of the sequence in seconds
+  fragments: FragmentDebugInfo[];
+};
+
 export type Output = {
   name: string; // e.g. "youtube"
   path: string; // e.g. "./output/video.mp4"
@@ -118,6 +136,7 @@ export type Upload = {
     thumbOffset?: number; // Thumbnail frame location in milliseconds
     coverUrl?: string; // Optional cover image URL
     videoUrl?: string; // Public URL to video (if not auto-generated from S3)
+    locationId?: string; // Facebook Page location ID for geotagging
   };
 };