react-native-video-trim 6.0.13 → 6.1.0

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

@@ -486,11 +486,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"));

package/ios/VideoTrimmerViewController.swift

@@ -332,7 +332,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 +340,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)

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.1.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@3.6.1",
   "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;
   }>;
 }