react-native-video-trim 6.0.13 → 6.2.0

package/android/src/main/java/com/videotrim/widgets/VideoTrimmerView.java

@@ -21,6 +21,7 @@ import android.util.AttributeSet;
 import android.util.Log;
 import android.util.TypedValue;
 import android.view.LayoutInflater;
+import android.view.GestureDetector;
 import android.view.MotionEvent;
 import android.view.View;
 import android.widget.FrameLayout;
@@ -104,6 +105,13 @@ public class VideoTrimmerView extends FrameLayout implements IVideoTrimmerView {
   private long zoomedInRangeDuration = 0;
   private boolean isTrimmingLeading = false;
 
+  // range drag
+  private boolean isRangeDragging = false;
+  private float rangeDragInitialRawX = 0;
+  private long rangeDragInitialStartTime = 0;
+  private long rangeDragInitialEndTime = 0;
+  private GestureDetector rangeDragGestureDetector;
+
   // thumbnail caching for zoom functionality
   private final java.util.List<ImageView> cachedFullViewThumbnails = new java.util.ArrayList<>();
   private volatile boolean isGeneratingThumbnails = false;
@@ -155,9 +163,24 @@ public class VideoTrimmerView extends FrameLayout implements IVideoTrimmerView {
     initializeViews();
     configure(config);
     setUpListeners();
+    initRangeDragDetector();
     setProgressIndicatorTouchListener();
   }
 
+  private void initRangeDragDetector() {
+    rangeDragGestureDetector = new GestureDetector(mContext, new GestureDetector.SimpleOnGestureListener() {
+      @Override
+      public void onLongPress(MotionEvent e) {
+        isRangeDragging = true;
+        rangeDragInitialRawX = e.getRawX();
+        rangeDragInitialStartTime = startTime;
+        rangeDragInitialEndTime = endTime;
+        playHapticFeedback(true);
+        fadeOutProgressIndicator();
+      }
+    });
+  }
+
   private void initializeViews() {
     mThumbnailContainer = findViewById(R.id.thumbnailContainer);
     mVideoView = findViewById(R.id.video_loader);
@@ -486,11 +509,11 @@ public class VideoTrimmerView extends FrameLayout implements IVideoTrimmerView {
 
   private void configure(ReadableMap config) {
     if (config.hasKey("maxDuration") && config.getDouble("maxDuration") > 0) {
-      mMaxDuration = (long) Math.max(0, config.getDouble("maxDuration") * 1000L);
+      mMaxDuration = (long) Math.max(0, config.getDouble("maxDuration"));
     }
 
     if (config.hasKey("minDuration") && config.getDouble("minDuration") > 0) {
-      mMinDuration = (long) Math.max(1000L, config.getDouble("minDuration") * 1000L);
+      mMinDuration = (long) Math.max(1000L, config.getDouble("minDuration"));
     }
 
     cancelBtn.setText(config.getString("cancelButtonText"));
@@ -664,17 +687,29 @@ public class VideoTrimmerView extends FrameLayout implements IVideoTrimmerView {
 
   private void setProgressIndicatorTouchListener() {
     trimmerContainerBg.setOnTouchListener((view, event) -> {
+      rangeDragGestureDetector.onTouchEvent(event);
+
       switch (event.getAction()) {
         case MotionEvent.ACTION_DOWN:
+          isRangeDragging = false;
           didClampWhilePanning = false;
           onMediaPause();
           onTrimmerContainerPanned(event);
           playHapticFeedback(true);
           break;
         case MotionEvent.ACTION_MOVE:
-          onTrimmerContainerPanned(event);
+          if (isRangeDragging) {
+            onRangeDrag(event);
+          } else {
+            onTrimmerContainerPanned(event);
+          }
           break;
         case MotionEvent.ACTION_UP:
+          if (isRangeDragging) {
+            isRangeDragging = false;
+            fadeInProgressIndicator();
+            updateCurrentTime(true);
+          }
           view.performClick();
           break;
         default:
@@ -730,6 +765,45 @@ public class VideoTrimmerView extends FrameLayout implements IVideoTrimmerView {
     seekTo(newVideoPosition, false);
   }
 
+  private void onRangeDrag(MotionEvent event) {
+    float deltaX = event.getRawX() - rangeDragInitialRawX;
+    float containerWidth = trimmerContainerBg.getWidth();
+    if (containerWidth <= 0) return;
+
+    long rangeDuration = rangeDragInitialEndTime - rangeDragInitialStartTime;
+    long deltaTime;
+    if (isZoomedIn) {
+      deltaTime = (long) (deltaX / containerWidth * zoomedInRangeDuration);
+    } else {
+      deltaTime = (long) (deltaX / containerWidth * mDuration);
+    }
+
+    long newStart = rangeDragInitialStartTime + deltaTime;
+    long newEnd = newStart + rangeDuration;
+
+    boolean didClamp = false;
+    if (newStart < 0) {
+      newStart = 0;
+      newEnd = rangeDuration;
+      didClamp = true;
+    }
+    if (newEnd > mDuration) {
+      newEnd = mDuration;
+      newStart = newEnd - rangeDuration;
+      didClamp = true;
+    }
+
+    if (didClamp && !didClampWhilePanning) {
+      playHapticFeedback(false);
+    }
+    didClampWhilePanning = didClamp;
+
+    startTime = newStart;
+    endTime = newEnd;
+    updateHandlePositions();
+    seekTo(startTime, false);
+  }
+
   private void setHandleTouchListener(View handle, boolean isLeading) {
     handle.setOnTouchListener((view, event) -> {
       boolean draggingDisabled = mDuration < mMinDuration; // if the video is shorter than the minimum duration, disable dragging

package/ios/VideoTrimmer.swift

@@ -26,6 +26,11 @@ import AVFoundation
     static let progressChanged = UIControl.Event(rawValue:      0b00010000 << 24)
     static let didEndScrubbing = UIControl.Event(rawValue:      0b00100000 << 24)
     
+    // events for dragging the entire selected range
+    static let didBeginDraggingRange = UIControl.Event(rawValue: 0b01000000 << 24)
+    static let rangeDragChanged = UIControl.Event(rawValue:      0b10000000 << 24)
+    static let didEndDraggingRange = UIControl.Event(rawValue:   1 << 25)
+    
     private struct Thumbnail {
         let uuid = UUID()
         let imageView: UIImageView
@@ -249,6 +254,12 @@ import AVFoundation
     private (set) var trailingGestureRecognizer: UILongPressGestureRecognizer!
     private (set) var progressGestureRecognizer: UILongPressGestureRecognizer!
     private (set) var thumbnailInteractionGestureRecognizer: UILongPressGestureRecognizer!
+    private (set) var rangeDragGestureRecognizer: UILongPressGestureRecognizer!
+    
+    // range drag state
+    private(set) var isDraggingRange = false
+    private var rangeDragInitialRange: CMTimeRange = .zero
+    private var rangeDragInitialLocationX: CGFloat = 0
     
     // private stuff
     private var grabberOffset = CGFloat(0)
@@ -369,11 +380,18 @@ import AVFoundation
         progressGestureRecognizer.require(toFail: trailingGestureRecognizer)
         progressIndicatorControl.addGestureRecognizer(progressGestureRecognizer)
         
+        // Range drag: platform-default long press (0.5s hold, 10pt allowable movement)
+        rangeDragGestureRecognizer = UILongPressGestureRecognizer(target: self, action: #selector(rangeDragPanned(_:)))
+        rangeDragGestureRecognizer.require(toFail: leadingGestureRecognizer)
+        rangeDragGestureRecognizer.require(toFail: trailingGestureRecognizer)
+        thumbView.addGestureRecognizer(rangeDragGestureRecognizer)
+        
         thumbnailInteractionGestureRecognizer = UILongPressGestureRecognizer(target: self, action: #selector(thumbnailPanned(_:)))
         thumbnailInteractionGestureRecognizer.allowableMovement = CGFloat.greatestFiniteMagnitude
         thumbnailInteractionGestureRecognizer.minimumPressDuration = 0
         thumbnailInteractionGestureRecognizer.require(toFail: leadingGestureRecognizer)
         thumbnailInteractionGestureRecognizer.require(toFail: trailingGestureRecognizer)
+        thumbnailInteractionGestureRecognizer.require(toFail: rangeDragGestureRecognizer)
         thumbView.addGestureRecognizer(thumbnailInteractionGestureRecognizer)
     }
     
@@ -583,9 +601,10 @@ import AVFoundation
             setNeedsLayout()
             
         case .hiddenOnlyWhenTrimming:
-            progressIndicator.alpha = (trimmingState == .none ? 1 : 0)
-            progressIndicatorControl.isUserInteractionEnabled = (trimmingState == .none)
-            if trimmingState == .none {
+            let shouldShow = trimmingState == .none && !isDraggingRange
+            progressIndicator.alpha = (shouldShow ? 1 : 0)
+            progressIndicatorControl.isUserInteractionEnabled = shouldShow
+            if shouldShow {
                 setNeedsLayout()
                 if UIView.inheritedAnimationDuration > 0 {
                     UIView.performWithoutAnimation {
@@ -780,6 +799,86 @@ import AVFoundation
         }
     }
     
+    
+    @objc private func rangeDragPanned(_ sender: UILongPressGestureRecognizer) {
+        switch sender.state {
+        case .began:
+            isDraggingRange = true
+            rangeDragInitialRange = selectedRange
+            rangeDragInitialLocationX = sender.location(in: self).x
+            didClampWhilePanning = false
+            
+            if enableHapticFeedback {
+                UISelectionFeedbackGenerator().selectionChanged()
+                impactFeedbackGenerator = UIImpactFeedbackGenerator(style: .heavy)
+                impactFeedbackGenerator?.prepare()
+            }
+            
+            UIView.animate(withDuration: 0.25, delay: 0, options: [.beginFromCurrentState, .allowUserInteraction], animations: {
+                self.updateProgressIndicator()
+            })
+            sendActions(for: Self.didBeginDraggingRange)
+            
+        case .changed:
+            let currentX = sender.location(in: self).x
+            let deltaX = currentX - rangeDragInitialLocationX
+            let inset = thumbView.chevronWidth + horizontalInset
+            let availableWidth = bounds.width - inset * 2
+            let visibleDurationInSeconds = CGFloat(visibleRange.duration.seconds)
+            guard availableWidth > 0 && visibleDurationInSeconds > 0 else { return }
+            
+            let deltaTime = CMTime(
+                seconds: Double(deltaX / availableWidth) * Double(visibleDurationInSeconds),
+                preferredTimescale: 600
+            )
+            let duration = rangeDragInitialRange.duration
+            var newStart = CMTimeAdd(rangeDragInitialRange.start, deltaTime)
+            var newEnd = CMTimeAdd(newStart, duration)
+            
+            var didClamp = false
+            if CMTimeCompare(newStart, range.start) == -1 {
+                newStart = range.start
+                newEnd = CMTimeAdd(newStart, duration)
+                didClamp = true
+            }
+            if CMTimeCompare(newEnd, range.end) == 1 {
+                newEnd = range.end
+                newStart = CMTimeSubtract(newEnd, duration)
+                didClamp = true
+            }
+            
+            if didClamp && !didClampWhilePanning {
+                impactFeedbackGenerator?.impactOccurred()
+            }
+            didClampWhilePanning = didClamp
+            
+            selectedRange = CMTimeRange(start: newStart, end: newEnd)
+            setNeedsLayout()
+            sendActions(for: Self.rangeDragChanged)
+            
+        case .ended:
+            isDraggingRange = false
+            impactFeedbackGenerator = nil
+            UIView.animate(withDuration: 0.25, delay: 0, options: [.beginFromCurrentState, .allowUserInteraction], animations: {
+                self.updateProgressIndicator()
+            })
+            sendActions(for: Self.didEndDraggingRange)
+            
+        case .cancelled:
+            isDraggingRange = false
+            impactFeedbackGenerator = nil
+            UIView.animate(withDuration: 0.25, delay: 0, options: [.beginFromCurrentState, .allowUserInteraction], animations: {
+                self.updateProgressIndicator()
+            })
+            
+        case .possible, .failed:
+            break
+            
+        @unknown default:
+            break
+        }
+    }
+    
     // MARK: - UIView
     
     override var intrinsicContentSize: CGSize {

package/ios/VideoTrimmerViewController.swift

@@ -131,6 +131,20 @@ class VideoTrimmerViewController: UIViewController {
         handleTrimmingEnd(false)
     }
     
+    @objc private func didBeginDraggingRange(_ sender: VideoTrimmer) {
+        handleBeforeProgressChange()
+    }
+    
+    @objc private func rangeDragChanged(_ sender: VideoTrimmer) {
+        handleProgressChanged(time: trimmer.selectedRange.start)
+    }
+    
+    @objc private func didEndDraggingRange(_ sender: VideoTrimmer) {
+        self.trimmer.progress = trimmer.selectedRange.start
+        updateLabels()
+        seek(to: trimmer.progress)
+    }
+    
     @objc private func didBeginScrubbing(_ sender: VideoTrimmer) {
         handleBeforeProgressChange()
     }
@@ -332,7 +346,7 @@ class VideoTrimmerViewController: UIViewController {
         trimmer.zoomOnWaitingDuration = zoomOnWaitingDuration
         
         if let maxDuration = maximumDuration {
-            trimmer.maximumDuration = CMTime(seconds: max(1, Double(maxDuration)), preferredTimescale: 600)
+            trimmer.maximumDuration = CMTime(seconds: max(1, Double(maxDuration) / 1000.0), preferredTimescale: 600)
             if trimmer.maximumDuration > asset!.duration {
                 trimmer.maximumDuration = asset!.duration
             }
@@ -340,7 +354,7 @@ class VideoTrimmerViewController: UIViewController {
         }
         
         if let minDuration = minimumDuration {
-            trimmer.minimumDuration = CMTime(seconds: max(1, Double(minDuration)), preferredTimescale: 600)
+            trimmer.minimumDuration = CMTime(seconds: max(1, Double(minDuration) / 1000.0), preferredTimescale: 600)
         }
         
         trimmer.addTarget(self, action: #selector(didBeginScrubbing(_:)), for: VideoTrimmer.didBeginScrubbing)
@@ -354,6 +368,10 @@ class VideoTrimmerViewController: UIViewController {
         trimmer.addTarget(self, action: #selector(didBeginTrimmingFromEnd(_:)), for: VideoTrimmer.didBeginTrimmingFromEnd)
         trimmer.addTarget(self, action: #selector(trailingGrabberChanged(_:)), for: VideoTrimmer.trailingGrabberChanged)
         trimmer.addTarget(self, action: #selector(didEndTrimmingFromEnd(_:)), for: VideoTrimmer.didEndTrimmingFromEnd)
+        
+        trimmer.addTarget(self, action: #selector(didBeginDraggingRange(_:)), for: VideoTrimmer.didBeginDraggingRange)
+        trimmer.addTarget(self, action: #selector(rangeDragChanged(_:)), for: VideoTrimmer.rangeDragChanged)
+        trimmer.addTarget(self, action: #selector(didEndDraggingRange(_:)), for: VideoTrimmer.didEndDraggingRange)
         trimmer.alpha = 0
         view.addSubview(trimmer)
         trimmer.translatesAutoresizingMaskIntoConstraints = false

package/lib/module/NativeVideoTrim.js

@@ -1,5 +1,30 @@
 "use strict";
 
 import { TurboModuleRegistry } from 'react-native';
+
+/**
+ * Base options shared by both the editor and headless trim operations.
+ */
+
+/**
+ * Configuration for the video trimmer editor UI.
+ */
+
+/**
+ * Options for headless (non-UI) trim operations.
+ */
+
+/**
+ * Result returned by {@link Spec.isValidFile}.
+ */
+
+/**
+ * Result returned by a trim operation (both editor and headless).
+ */
+
+/**
+ * TurboModule spec for the native VideoTrim module.
+ */
+
 export default TurboModuleRegistry.getEnforcing('VideoTrim');
 //# sourceMappingURL=NativeVideoTrim.js.map

package/lib/module/NativeVideoTrim.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeVideoTrim.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AA0IlD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,WAAW,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeVideoTrim.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;;AAGlD;AACA;AACA;;AAkBA;AACA;AACA;;AAgGA;AACA;AACA;;AAQA;AACA;AACA;;AAUA;AACA;AACA;;AAcA;AACA;AACA;;AAmEA,eAAeA,mBAAmB,CAACC,YAAY,CAAO,WAAW,CAAC","ignoreList":[]}

package/lib/typescript/src/NativeVideoTrim.d.ts

@@ -1,115 +1,202 @@
 import type { TurboModule } from 'react-native';
 import type { EventEmitter } from 'react-native/Libraries/Types/CodegenTypes';
+/**
+ * Base options shared by both the editor and headless trim operations.
+ */
 export interface BaseOptions {
+    /** Whether to save the output file to the device's photo library. */
     saveToPhoto: boolean;
+    /** Media type: `"video"` or `"audio"`. */
     type: string;
+    /** Output file extension (e.g. `"mp4"`, `"wav"`). */
     outputExt: string;
+    /** Whether to remove the output file after it has been saved to the photo library. */
     removeAfterSavedToPhoto: boolean;
+    /** Whether to remove the output file if saving to the photo library fails. */
     removeAfterFailedToSavePhoto: boolean;
+    /** Whether to enable video rotation during trimming. */
     enableRotation: boolean;
+    /** Rotation angle in degrees (e.g. `90`, `180`, `270`). Only used when `enableRotation` is `true`. */
     rotationAngle: number;
 }
+/**
+ * Configuration for the video trimmer editor UI.
+ */
 export interface EditorConfig extends BaseOptions {
+    /** Whether to enable haptic feedback when interacting with the trimmer. */
     enableHapticFeedback: boolean;
+    /** Maximum allowed duration for the trimmed clip in milliseconds. Set to `-1` for no limit. */
     maxDuration: number;
+    /** Minimum allowed duration for the trimmed clip in milliseconds. Set to `-1` for no limit. */
     minDuration: number;
+    /** Whether to open the system documents/files app after trimming finishes. */
     openDocumentsOnFinish: boolean;
+    /** Whether to open the share sheet after trimming finishes. */
     openShareSheetOnFinish: boolean;
+    /** Whether to remove the output file after it has been saved to documents. */
     removeAfterSavedToDocuments: boolean;
+    /** Whether to remove the output file if saving to documents fails. */
     removeAfterFailedToSaveDocuments: boolean;
+    /** Whether to remove the output file after it has been shared. */
     removeAfterShared: boolean;
+    /** Whether to remove the output file if sharing fails. */
     removeAfterFailedToShare: boolean;
+    /** Text for the cancel button. */
     cancelButtonText: string;
+    /** Text for the save button. */
     saveButtonText: string;
+    /** Whether to show a confirmation dialog when the cancel button is pressed. */
     enableCancelDialog: boolean;
+    /** Title of the cancel confirmation dialog. */
     cancelDialogTitle: string;
+    /** Message of the cancel confirmation dialog. */
     cancelDialogMessage: string;
+    /** Text for the dismiss button in the cancel confirmation dialog. */
     cancelDialogCancelText: string;
+    /** Text for the confirm button in the cancel confirmation dialog. */
     cancelDialogConfirmText: string;
+    /** Whether to show a confirmation dialog when the save button is pressed. */
     enableSaveDialog: boolean;
+    /** Title of the save confirmation dialog. */
     saveDialogTitle: string;
+    /** Message of the save confirmation dialog. */
     saveDialogMessage: string;
+    /** Text for the dismiss button in the save confirmation dialog. */
     saveDialogCancelText: string;
+    /** Text for the confirm button in the save confirmation dialog. */
     saveDialogConfirmText: string;
+    /** Text displayed while the video is being trimmed (e.g. `"Trimming video..."`). */
     trimmingText: string;
+    /** iOS only. Whether to present the editor as a full-screen modal. */
     fullScreenModalIOS: boolean;
+    /** Whether to auto-play the video when the editor opens. */
     autoplay: boolean;
+    /** Position in milliseconds to seek to when the editor loads. Set to `-1` to disable. */
     jumpToPositionOnLoad: number;
+    /** Whether to automatically close the editor when trimming finishes. */
     closeWhenFinish: boolean;
+    /** Whether to allow the user to cancel an in-progress trim operation. */
     enableCancelTrimming: boolean;
+    /** Text for the cancel-trimming button. */
     cancelTrimmingButtonText: string;
+    /** Whether to show a confirmation dialog when cancelling an in-progress trim. */
     enableCancelTrimmingDialog: boolean;
+    /** Title of the cancel-trimming confirmation dialog. */
     cancelTrimmingDialogTitle: string;
+    /** Message of the cancel-trimming confirmation dialog. */
     cancelTrimmingDialogMessage: string;
+    /** Text for the dismiss button in the cancel-trimming dialog. */
     cancelTrimmingDialogCancelText: string;
+    /** Text for the confirm button in the cancel-trimming dialog. */
     cancelTrimmingDialogConfirmText: string;
+    /** Custom header text displayed at the top of the editor. */
     headerText: string;
+    /** Font size of the header text in sp/pt. */
     headerTextSize: number;
+    /** Color of the header text as a `processColor` value. */
     headerTextColor: number;
+    /** Whether to show an alert dialog when the media file fails to load. */
     alertOnFailToLoad: boolean;
+    /** Title of the fail-to-load alert. */
     alertOnFailTitle: string;
+    /** Message of the fail-to-load alert. */
     alertOnFailMessage: string;
+    /** Text for the close button of the fail-to-load alert. */
     alertOnFailCloseText: string;
-    /**
-     * Android only
-     * Update status bar to black background color when editor is opened
-     */
+    /** Android only. Whether to update the status bar to a black background when the editor opens. */
     changeStatusBarColorOnOpen?: boolean;
-    /**
-     * Color of the trimmer bar
-     */
+    /** Color of the trimmer bar as a `processColor` value. */
     trimmerColor?: number;
-    /**
-     * Color of the trimmer left/right handle icons
-     */
+    /** Color of the trimmer left/right handle icons as a `processColor` value. */
     handleIconColor?: number;
     /**
-     * Duration for zoom-on-waiting feature in milliseconds (default: 5000)
-     * When user pauses while dragging trim handles, the view will zoom to show
-     * this duration around the current trim position for more precise editing
+     * Duration for the zoom-on-waiting feature in milliseconds (default: `5000`).
+     * When the user pauses while dragging trim handles, the view zooms to show
+     * this duration around the current trim position for more precise editing.
      */
     zoomOnWaitingDuration?: number;
 }
+/**
+ * Options for headless (non-UI) trim operations.
+ */
 export interface TrimOptions extends BaseOptions {
+    /** Start time of the trim range in milliseconds. */
     startTime: number;
+    /** End time of the trim range in milliseconds. */
     endTime: number;
 }
+/**
+ * Result returned by {@link Spec.isValidFile}.
+ */
 export interface FileValidationResult {
+    /** Whether the file is a valid audio or video file. */
     isValid: boolean;
+    /** Detected file type (e.g. `"video"`, `"audio"`, `"unknown"`). */
     fileType: string;
+    /** Duration of the media file in milliseconds, or `-1` if invalid. */
     duration: number;
 }
+/**
+ * Result returned by a trim operation (both editor and headless).
+ */
 export interface TrimResult {
+    /** Start time of the trimmed range in milliseconds. */
     startTime: number;
+    /** End time of the trimmed range in milliseconds. */
     endTime: number;
+    /** Duration of the trimmed clip in milliseconds. */
     duration: number;
+    /** Absolute path to the trimmed output file. */
     outputPath: string;
+    /** Whether the trim operation completed successfully. */
     success: boolean;
 }
+/**
+ * TurboModule spec for the native VideoTrim module.
+ */
 export interface Spec extends TurboModule {
+    /** Open the video trimmer editor for the given file. */
     showEditor(filePath: string, config: EditorConfig): void;
+    /** List all output files generated by past trim operations. */
     listFiles(): Promise<string[]>;
+    /** Delete all output files generated by past trim operations. Returns the number of files removed. */
     cleanFiles(): Promise<number>;
+    /** Delete a single file at the given path. Resolves `true` on success. */
     deleteFile(filePath: string): Promise<boolean>;
+    /** Programmatically close the editor if it is currently open. */
     closeEditor(): void;
+    /** Check whether the given URL points to a valid audio or video file. */
     isValidFile(url: string): Promise<FileValidationResult>;
+    /** Perform a headless trim (no UI) on the given URL with the specified options. */
     trim(url: string, options: TrimOptions): Promise<TrimResult>;
+    /** Emitted when the trim operation starts. */
     readonly onStartTrimming: EventEmitter<void>;
+    /** Emitted when the user cancels an in-progress trim operation. */
     readonly onCancelTrimming: EventEmitter<void>;
+    /** Emitted when the user dismisses the editor without trimming. */
     readonly onCancel: EventEmitter<void>;
+    /** Emitted when the editor is hidden. */
     readonly onHide: EventEmitter<void>;
+    /** Emitted when the editor is shown. */
     readonly onShow: EventEmitter<void>;
+    /** Emitted when trimming completes successfully. All time values are in milliseconds. */
     readonly onFinishTrimming: EventEmitter<{
+        /** Absolute path to the trimmed output file. */
         outputPath: string;
+        /** Start time of the trimmed range in milliseconds. */
         startTime: number;
+        /** End time of the trimmed range in milliseconds. */
         endTime: number;
+        /** Duration of the trimmed clip in milliseconds. */
         duration: number;
     }>;
+    /** Emitted with FFmpeg log output during trimming. */
     readonly onLog: EventEmitter<{
         level: string;
         message: string;
         sessionId: number;
     }>;
+    /** Emitted with FFmpeg encoding statistics during trimming. */
     readonly onStatistics: EventEmitter<{
         sessionId: number;
         videoFrameNumber: number;
@@ -120,11 +207,14 @@ export interface Spec extends TurboModule {
         bitrate: number;
         speed: number;
     }>;
+    /** Emitted when an error occurs during trimming or file loading. */
     readonly onError: EventEmitter<{
         message: string;
         errorCode: string;
     }>;
+    /** Emitted when the media file has finished loading in the editor. */
     readonly onLoad: EventEmitter<{
+        /** Duration of the loaded media in milliseconds. */
         duration: number;
     }>;
 }

package/lib/typescript/src/NativeVideoTrim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeVideoTrim.d.ts","sourceRoot":"","sources":["../../../src/NativeVideoTrim.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NativeVideoTrim.d.ts","sourceRoot":"","sources":["../../../src/NativeVideoTrim.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-video-trim",
-  "version": "6.0.13",
+  "version": "6.2.0",
   "description": "Video trimmer for your React Native app",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -91,7 +91,7 @@
   "workspaces": [
     "example"
   ],
-  "packageManager": "yarn@1.2.2",
+  "packageManager": "yarn@4.13.0",
   "jest": {
     "preset": "react-native",
     "modulePathIgnorePatterns": [

package/src/NativeVideoTrim.ts

@@ -2,122 +2,209 @@ import type { TurboModule } from 'react-native';
 import { TurboModuleRegistry } from 'react-native';
 import type { EventEmitter } from 'react-native/Libraries/Types/CodegenTypes';
 
+/**
+ * Base options shared by both the editor and headless trim operations.
+ */
 export interface BaseOptions {
+  /** Whether to save the output file to the device's photo library. */
   saveToPhoto: boolean;
+  /** Media type: `"video"` or `"audio"`. */
   type: string;
+  /** Output file extension (e.g. `"mp4"`, `"wav"`). */
   outputExt: string;
+  /** Whether to remove the output file after it has been saved to the photo library. */
   removeAfterSavedToPhoto: boolean;
+  /** Whether to remove the output file if saving to the photo library fails. */
   removeAfterFailedToSavePhoto: boolean;
+  /** Whether to enable video rotation during trimming. */
   enableRotation: boolean;
+  /** Rotation angle in degrees (e.g. `90`, `180`, `270`). Only used when `enableRotation` is `true`. */
   rotationAngle: number;
 }
 
+/**
+ * Configuration for the video trimmer editor UI.
+ */
 export interface EditorConfig extends BaseOptions {
+  /** Whether to enable haptic feedback when interacting with the trimmer. */
   enableHapticFeedback: boolean;
+  /** Maximum allowed duration for the trimmed clip in milliseconds. Set to `-1` for no limit. */
   maxDuration: number;
+  /** Minimum allowed duration for the trimmed clip in milliseconds. Set to `-1` for no limit. */
   minDuration: number;
+  /** Whether to open the system documents/files app after trimming finishes. */
   openDocumentsOnFinish: boolean;
+  /** Whether to open the share sheet after trimming finishes. */
   openShareSheetOnFinish: boolean;
+  /** Whether to remove the output file after it has been saved to documents. */
   removeAfterSavedToDocuments: boolean;
+  /** Whether to remove the output file if saving to documents fails. */
   removeAfterFailedToSaveDocuments: boolean;
+  /** Whether to remove the output file after it has been shared. */
   removeAfterShared: boolean;
+  /** Whether to remove the output file if sharing fails. */
   removeAfterFailedToShare: boolean;
+  /** Text for the cancel button. */
   cancelButtonText: string;
+  /** Text for the save button. */
   saveButtonText: string;
+  /** Whether to show a confirmation dialog when the cancel button is pressed. */
   enableCancelDialog: boolean;
+  /** Title of the cancel confirmation dialog. */
   cancelDialogTitle: string;
+  /** Message of the cancel confirmation dialog. */
   cancelDialogMessage: string;
+  /** Text for the dismiss button in the cancel confirmation dialog. */
   cancelDialogCancelText: string;
+  /** Text for the confirm button in the cancel confirmation dialog. */
   cancelDialogConfirmText: string;
+  /** Whether to show a confirmation dialog when the save button is pressed. */
   enableSaveDialog: boolean;
+  /** Title of the save confirmation dialog. */
   saveDialogTitle: string;
+  /** Message of the save confirmation dialog. */
   saveDialogMessage: string;
+  /** Text for the dismiss button in the save confirmation dialog. */
   saveDialogCancelText: string;
+  /** Text for the confirm button in the save confirmation dialog. */
   saveDialogConfirmText: string;
+  /** Text displayed while the video is being trimmed (e.g. `"Trimming video..."`). */
   trimmingText: string;
+  /** iOS only. Whether to present the editor as a full-screen modal. */
   fullScreenModalIOS: boolean;
+  /** Whether to auto-play the video when the editor opens. */
   autoplay: boolean;
+  /** Position in milliseconds to seek to when the editor loads. Set to `-1` to disable. */
   jumpToPositionOnLoad: number;
+  /** Whether to automatically close the editor when trimming finishes. */
   closeWhenFinish: boolean;
+  /** Whether to allow the user to cancel an in-progress trim operation. */
   enableCancelTrimming: boolean;
+  /** Text for the cancel-trimming button. */
   cancelTrimmingButtonText: string;
+  /** Whether to show a confirmation dialog when cancelling an in-progress trim. */
   enableCancelTrimmingDialog: boolean;
+  /** Title of the cancel-trimming confirmation dialog. */
   cancelTrimmingDialogTitle: string;
+  /** Message of the cancel-trimming confirmation dialog. */
   cancelTrimmingDialogMessage: string;
+  /** Text for the dismiss button in the cancel-trimming dialog. */
   cancelTrimmingDialogCancelText: string;
+  /** Text for the confirm button in the cancel-trimming dialog. */
   cancelTrimmingDialogConfirmText: string;
+  /** Custom header text displayed at the top of the editor. */
   headerText: string;
+  /** Font size of the header text in sp/pt. */
   headerTextSize: number;
+  /** Color of the header text as a `processColor` value. */
   headerTextColor: number;
+  /** Whether to show an alert dialog when the media file fails to load. */
   alertOnFailToLoad: boolean;
+  /** Title of the fail-to-load alert. */
   alertOnFailTitle: string;
+  /** Message of the fail-to-load alert. */
   alertOnFailMessage: string;
+  /** Text for the close button of the fail-to-load alert. */
   alertOnFailCloseText: string;
-  /**
-   * Android only
-   * Update status bar to black background color when editor is opened
-   */
+  /** Android only. Whether to update the status bar to a black background when the editor opens. */
   changeStatusBarColorOnOpen?: boolean;
-  /**
-   * Color of the trimmer bar
-   */
+  /** Color of the trimmer bar as a `processColor` value. */
   trimmerColor?: number;
-  /**
-   * Color of the trimmer left/right handle icons
-   */
+  /** Color of the trimmer left/right handle icons as a `processColor` value. */
   handleIconColor?: number;
   /**
-   * Duration for zoom-on-waiting feature in milliseconds (default: 5000)
-   * When user pauses while dragging trim handles, the view will zoom to show
-   * this duration around the current trim position for more precise editing
+   * Duration for the zoom-on-waiting feature in milliseconds (default: `5000`).
+   * When the user pauses while dragging trim handles, the view zooms to show
+   * this duration around the current trim position for more precise editing.
    */
   zoomOnWaitingDuration?: number;
 }
 
+/**
+ * Options for headless (non-UI) trim operations.
+ */
 export interface TrimOptions extends BaseOptions {
+  /** Start time of the trim range in milliseconds. */
   startTime: number;
+  /** End time of the trim range in milliseconds. */
   endTime: number;
 }
 
+/**
+ * Result returned by {@link Spec.isValidFile}.
+ */
 export interface FileValidationResult {
+  /** Whether the file is a valid audio or video file. */
   isValid: boolean;
+  /** Detected file type (e.g. `"video"`, `"audio"`, `"unknown"`). */
   fileType: string;
+  /** Duration of the media file in milliseconds, or `-1` if invalid. */
   duration: number;
 }
 
+/**
+ * Result returned by a trim operation (both editor and headless).
+ */
 export interface TrimResult {
+  /** Start time of the trimmed range in milliseconds. */
   startTime: number;
+  /** End time of the trimmed range in milliseconds. */
   endTime: number;
+  /** Duration of the trimmed clip in milliseconds. */
   duration: number;
+  /** Absolute path to the trimmed output file. */
   outputPath: string;
+  /** Whether the trim operation completed successfully. */
   success: boolean;
 }
 
+/**
+ * TurboModule spec for the native VideoTrim module.
+ */
 export interface Spec extends TurboModule {
+  /** Open the video trimmer editor for the given file. */
   showEditor(filePath: string, config: EditorConfig): void;
+  /** List all output files generated by past trim operations. */
   listFiles(): Promise<string[]>;
+  /** Delete all output files generated by past trim operations. Returns the number of files removed. */
   cleanFiles(): Promise<number>;
+  /** Delete a single file at the given path. Resolves `true` on success. */
   deleteFile(filePath: string): Promise<boolean>;
+  /** Programmatically close the editor if it is currently open. */
   closeEditor(): void;
+  /** Check whether the given URL points to a valid audio or video file. */
   isValidFile(url: string): Promise<FileValidationResult>;
+  /** Perform a headless trim (no UI) on the given URL with the specified options. */
   trim(url: string, options: TrimOptions): Promise<TrimResult>;
 
+  /** Emitted when the trim operation starts. */
   readonly onStartTrimming: EventEmitter<void>;
+  /** Emitted when the user cancels an in-progress trim operation. */
   readonly onCancelTrimming: EventEmitter<void>;
+  /** Emitted when the user dismisses the editor without trimming. */
   readonly onCancel: EventEmitter<void>;
+  /** Emitted when the editor is hidden. */
   readonly onHide: EventEmitter<void>;
+  /** Emitted when the editor is shown. */
   readonly onShow: EventEmitter<void>;
+  /** Emitted when trimming completes successfully. All time values are in milliseconds. */
   readonly onFinishTrimming: EventEmitter<{
+    /** Absolute path to the trimmed output file. */
     outputPath: string;
+    /** Start time of the trimmed range in milliseconds. */
     startTime: number;
+    /** End time of the trimmed range in milliseconds. */
     endTime: number;
+    /** Duration of the trimmed clip in milliseconds. */
     duration: number;
   }>;
+  /** Emitted with FFmpeg log output during trimming. */
   readonly onLog: EventEmitter<{
     level: string;
     message: string;
     sessionId: number;
   }>;
+  /** Emitted with FFmpeg encoding statistics during trimming. */
   readonly onStatistics: EventEmitter<{
     sessionId: number;
     videoFrameNumber: number;
@@ -128,11 +215,14 @@ export interface Spec extends TurboModule {
     bitrate: number;
     speed: number;
   }>;
+  /** Emitted when an error occurs during trimming or file loading. */
   readonly onError: EventEmitter<{
     message: string;
     errorCode: string;
   }>;
+  /** Emitted when the media file has finished loading in the editor. */
   readonly onLoad: EventEmitter<{
+    /** Duration of the loaded media in milliseconds. */
     duration: number;
   }>;
 }