react-native-video-trim 7.1.1 → 8.1.0

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

@@ -24,6 +24,14 @@ export interface BaseOptions {
      * happens regardless of this flag, so precise trimming comes for free in that case.
      */
     enablePreciseTrimming: boolean;
+    /** When `true`, strips the audio track from the output. Default `false`. */
+    removeAudio: boolean;
+    /**
+     * Playback speed multiplier applied during export. `1.0` is normal speed,
+     * `2.0` is double speed, `0.5` is half speed. Valid range: 0.25–4.0.
+     * When not `1.0`, re-encoding is forced regardless of `enablePreciseTrimming`.
+     */
+    speed: number;
 }
 /**
  * Configuration for the video trimmer editor UI.
@@ -126,6 +134,19 @@ export interface EditorConfig extends BaseOptions {
      * `"light"` uses a white background with black icons/text and white trimmer-handle chevrons.
      */
     theme?: string;
+    /**
+     * Format token for the editor's start / current / end time labels.
+     * Allowed values:
+     * - `"mm:ss"` — minutes:seconds (e.g. `01:23`)
+     * - `"mm:ss.SS"` — centiseconds (e.g. `01:23.45`)
+     * - `"mm:ss.SSS"` — milliseconds (e.g. `01:23.456`) — **default**
+     * - `"hh:mm:ss"` — hours:minutes:seconds (e.g. `00:01:23`)
+     * - `"hh:mm:ss.SSS"` — hours:minutes:seconds.milliseconds (e.g. `00:01:23.456`)
+     *
+     * Unknown values fall back to the default. Only affects on-screen labels;
+     * `onLoad` / `onFinishTrimming` payloads continue to report raw milliseconds.
+     */
+    durationFormat?: string;
     /** Color of the audio waveform bars as a `processColor` value. */
     waveformColor?: number;
     /** Background color behind the audio waveform bars as a `processColor` value. */
@@ -172,6 +193,130 @@ export interface TrimResult {
     /** Whether the trim operation completed successfully. */
     success: boolean;
 }
+/**
+ * Options for extracting a single frame from a video.
+ */
+export interface FrameExtractionOptions {
+    /** Timestamp in milliseconds at which to extract the frame. */
+    time: number;
+    /** Output image format: `"jpeg"` (default) or `"png"`. */
+    format: string;
+    /** JPEG compression quality from 0–100. Default `80`. Ignored for PNG. */
+    quality: number;
+    /** Maximum width in pixels. Height is auto-calculated to preserve aspect ratio. `-1` for original. */
+    maxWidth: number;
+    /** Maximum height in pixels. Width is auto-calculated to preserve aspect ratio. `-1` for original. */
+    maxHeight: number;
+}
+/**
+ * Result returned by {@link Spec.getFrameAt}.
+ */
+export interface FrameResult {
+    /** Absolute path to the extracted image file. */
+    outputPath: string;
+}
+/**
+ * Options for extracting the audio track from a video file.
+ */
+export interface ExtractAudioOptions {
+    /** Output audio file extension (e.g. `"mp3"`, `"m4a"`, `"wav"`). Default `"mp3"`. */
+    outputExt: string;
+}
+/**
+ * Result returned by {@link Spec.extractAudio}.
+ */
+export interface ExtractAudioResult {
+    /** Absolute path to the extracted audio file. */
+    outputPath: string;
+    /** Duration of the audio in milliseconds. */
+    duration: number;
+}
+/**
+ * Options for compressing a video file.
+ */
+export interface CompressOptions {
+    /**
+     * Quality preset: `"low"` (smallest file), `"medium"` (balanced), `"high"` (best quality).
+     * Maps to CRF 28, 23, 18 respectively. Ignored when `bitrate` is set.
+     */
+    quality: string;
+    /** Explicit target bitrate in bits per second. Overrides `quality` when set. `-1` to use quality preset. */
+    bitrate: number;
+    /** Target width in pixels. `-1` to keep original. Height is auto-calculated to preserve aspect ratio. */
+    width: number;
+    /** Target height in pixels. `-1` to keep original. Width is auto-calculated to preserve aspect ratio. */
+    height: number;
+    /** Target frame rate. `-1` to keep original. */
+    frameRate: number;
+    /** Output file extension (e.g. `"mp4"`). Default `"mp4"`. */
+    outputExt: string;
+    /** When `true`, strips the audio track from the output. Default `false`. */
+    removeAudio: boolean;
+}
+/**
+ * Result returned by {@link Spec.compress}.
+ */
+export interface CompressResult {
+    /** Absolute path to the compressed output file. */
+    outputPath: string;
+}
+/**
+ * Options for converting a video segment to an animated GIF.
+ */
+export interface GifOptions {
+    /** Start time in milliseconds. Default `0`. */
+    startTime: number;
+    /** End time in milliseconds. Default `-1` (end of video). */
+    endTime: number;
+    /** Frame rate of the GIF. Default `10`. */
+    fps: number;
+    /** Width in pixels. Height is auto-calculated to preserve aspect ratio. `-1` for original. */
+    width: number;
+}
+/**
+ * Result returned by {@link Spec.toGif}.
+ */
+export interface GifResult {
+    /** Absolute path to the generated GIF file. */
+    outputPath: string;
+}
+/**
+ * Options for merging multiple media files into one.
+ */
+export interface MergeOptions {
+    /** Output file extension (e.g. `"mp4"`, `"wav"`). Default `"mp4"`. */
+    outputExt: string;
+}
+/**
+ * Result returned by {@link Spec.merge}.
+ */
+export interface MergeResult {
+    /** Absolute path to the merged output file. */
+    outputPath: string;
+    /** Total duration of the merged file in milliseconds. */
+    duration: number;
+}
+/**
+ * Result returned by {@link Spec.saveToPhoto}.
+ */
+export interface SaveToPhotoResult {
+    /** Whether the file was saved to the photo library successfully. */
+    success: boolean;
+}
+/**
+ * Result returned by {@link Spec.saveToDocuments}.
+ */
+export interface SaveToDocumentsResult {
+    /** Whether the file was saved to documents successfully. */
+    success: boolean;
+}
+/**
+ * Result returned by {@link Spec.share}.
+ */
+export interface ShareResult {
+    /** Whether the user completed the share action. */
+    success: boolean;
+}
 /**
  * TurboModule spec for the native VideoTrim module.
  */
@@ -190,6 +335,22 @@ export interface Spec extends TurboModule {
     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>;
+    /** Extract a single frame from a video at the specified timestamp. */
+    getFrameAt(url: string, options: FrameExtractionOptions): Promise<FrameResult>;
+    /** Extract the audio track from a video file into a separate audio file. */
+    extractAudio(url: string, options: ExtractAudioOptions): Promise<ExtractAudioResult>;
+    /** Compress a video file to reduce its size. */
+    compress(url: string, options: CompressOptions): Promise<CompressResult>;
+    /** Convert a video segment to an animated GIF. */
+    toGif(url: string, options: GifOptions): Promise<GifResult>;
+    /** Merge multiple media files into a single file. Headless only, no editor UI. */
+    merge(urls: ReadonlyArray<string>, options: MergeOptions): Promise<MergeResult>;
+    /** Save a file to the device's photo library. Requires photo library permission. */
+    saveToPhoto(filePath: string): Promise<SaveToPhotoResult>;
+    /** Present the system document picker to save a file to the user's chosen location. */
+    saveToDocuments(filePath: string): Promise<SaveToDocumentsResult>;
+    /** Open the system share sheet for a file. */
+    share(filePath: string): Promise<ShareResult>;
     /** Emitted when the trim operation starts. */
     readonly onStartTrimming: EventEmitter<void>;
     /** Emitted when the user cancels an in-progress trim operation. */

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/lib/typescript/src/index.d.ts

@@ -1,4 +1,4 @@
-import type { EditorConfig, FileValidationResult, TrimOptions, TrimResult } from './NativeVideoTrim';
+import type { CompressOptions, CompressResult, EditorConfig, ExtractAudioOptions, ExtractAudioResult, FileValidationResult, FrameExtractionOptions, FrameResult, GifOptions, GifResult, MergeOptions, MergeResult, SaveToDocumentsResult, SaveToPhotoResult, ShareResult, TrimOptions, TrimResult } from './NativeVideoTrim';
 declare const VideoTrim: any;
 /**
  * Show video editor
@@ -53,6 +53,67 @@ export declare function isValidFile(url: string): Promise<FileValidationResult>;
  * @returns {Promise<TrimResult>} A **Promise** which resolves to the TrimResult interface
  */
 export declare function trim(url: string, options: Partial<TrimOptions>): Promise<TrimResult>;
+/**
+ * Extract a single frame from a video at a given timestamp
+ *
+ * @param {string} url: absolute non-empty file path
+ * @param {Partial<FrameExtractionOptions>} options: extraction options
+ * @returns {Promise<FrameResult>} A **Promise** which resolves to the FrameResult
+ */
+export declare function getFrameAt(url: string, options?: Partial<FrameExtractionOptions>): Promise<FrameResult>;
+/**
+ * Extract the audio track from a video file
+ *
+ * @param {string} url: absolute non-empty file path
+ * @param {Partial<ExtractAudioOptions>} options: extraction options
+ * @returns {Promise<ExtractAudioResult>} A **Promise** which resolves to the result
+ */
+export declare function extractAudio(url: string, options?: Partial<ExtractAudioOptions>): Promise<ExtractAudioResult>;
+/**
+ * Compress a video file to reduce its size
+ *
+ * @param {string} url: absolute non-empty file path
+ * @param {Partial<CompressOptions>} options: compression options
+ * @returns {Promise<CompressResult>} A **Promise** which resolves to the result
+ */
+export declare function compress(url: string, options?: Partial<CompressOptions>): Promise<CompressResult>;
+/**
+ * Convert a video segment to an animated GIF
+ *
+ * @param {string} url: absolute non-empty file path
+ * @param {Partial<GifOptions>} options: GIF conversion options
+ * @returns {Promise<GifResult>} A **Promise** which resolves to the result
+ */
+export declare function toGif(url: string, options?: Partial<GifOptions>): Promise<GifResult>;
+/**
+ * Merge multiple media files into a single file (headless, no UI)
+ *
+ * @param {string[]} urls: array of file paths to merge in order
+ * @param {Partial<MergeOptions>} options: merge options
+ * @returns {Promise<MergeResult>} A **Promise** which resolves to the result
+ */
+export declare function merge(urls: string[], options?: Partial<MergeOptions>): Promise<MergeResult>;
+/**
+ * Save a file to the device's photo library
+ *
+ * @param {string} filePath: absolute path to the file
+ * @returns {Promise<SaveToPhotoResult>} A **Promise** which resolves to the result
+ */
+export declare function saveToPhoto(filePath: string): Promise<SaveToPhotoResult>;
+/**
+ * Present the system document picker to save a file
+ *
+ * @param {string} filePath: absolute path to the file
+ * @returns {Promise<SaveToDocumentsResult>} A **Promise** which resolves to the result
+ */
+export declare function saveToDocuments(filePath: string): Promise<SaveToDocumentsResult>;
+/**
+ * Open the system share sheet for a file
+ *
+ * @param {string} filePath: absolute path to the file
+ * @returns {Promise<ShareResult>} A **Promise** which resolves to the result
+ */
+export declare function share(filePath: string): Promise<ShareResult>;
 export * from './NativeVideoTrim';
 export default VideoTrim;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,UAAU,EACX,MAAM,mBAAmB,CAAC;AAK3B,QAAA,MAAM,SAAS,KAAiD,CAAC;AAiFjE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,CACb,IAAI,CACF,YAAY,EACV,iBAAiB,GACjB,cAAc,GACd,iBAAiB,GACjB,eAAe,GACf,yBAAyB,CAC5B,CACF,GAAG;IACF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,GACA,IAAI,CAgCN;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK7D;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEtE;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAClB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,CAErB;AAED,cAAc,mBAAmB,CAAC;AAClC,eAAe,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,UAAU,EACX,MAAM,mBAAmB,CAAC;AAK3B,QAAA,MAAM,SAAS,KAAiD,CAAC;AA4IjE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,CACb,IAAI,CACF,YAAY,EACV,iBAAiB,GACjB,cAAc,GACd,iBAAiB,GACjB,eAAe,GACf,yBAAyB,CAC5B,CACF,GAAG;IACF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,GACA,IAAI,CAgCN;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK7D;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEtE;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAClB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC5C,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,OAAO,CAAC,kBAAkB,CAAC,CAE7B;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM,GACrC,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM,GAChC,OAAO,CAAC,SAAS,CAAC,CAEpB;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAClC,OAAO,CAAC,WAAW,CAAC,CAKtB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKxE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,CAAC,CAKhC;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAK5D;AAED,cAAc,mBAAmB,CAAC;AAClC,eAAe,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-video-trim",
-  "version": "7.1.1",
+  "version": "8.1.0",
   "description": "Video trimmer for your React Native app",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/NativeVideoTrim.ts

@@ -26,6 +26,14 @@ export interface BaseOptions {
    * happens regardless of this flag, so precise trimming comes for free in that case.
    */
   enablePreciseTrimming: boolean;
+  /** When `true`, strips the audio track from the output. Default `false`. */
+  removeAudio: boolean;
+  /**
+   * Playback speed multiplier applied during export. `1.0` is normal speed,
+   * `2.0` is double speed, `0.5` is half speed. Valid range: 0.25–4.0.
+   * When not `1.0`, re-encoding is forced regardless of `enablePreciseTrimming`.
+   */
+  speed: number;
 }
 
 /**
@@ -129,6 +137,19 @@ export interface EditorConfig extends BaseOptions {
    * `"light"` uses a white background with black icons/text and white trimmer-handle chevrons.
    */
   theme?: string;
+  /**
+   * Format token for the editor's start / current / end time labels.
+   * Allowed values:
+   * - `"mm:ss"` — minutes:seconds (e.g. `01:23`)
+   * - `"mm:ss.SS"` — centiseconds (e.g. `01:23.45`)
+   * - `"mm:ss.SSS"` — milliseconds (e.g. `01:23.456`) — **default**
+   * - `"hh:mm:ss"` — hours:minutes:seconds (e.g. `00:01:23`)
+   * - `"hh:mm:ss.SSS"` — hours:minutes:seconds.milliseconds (e.g. `00:01:23.456`)
+   *
+   * Unknown values fall back to the default. Only affects on-screen labels;
+   * `onLoad` / `onFinishTrimming` payloads continue to report raw milliseconds.
+   */
+  durationFormat?: string;
   /** Color of the audio waveform bars as a `processColor` value. */
   waveformColor?: number;
   /** Background color behind the audio waveform bars as a `processColor` value. */
@@ -179,6 +200,143 @@ export interface TrimResult {
   success: boolean;
 }
 
+/**
+ * Options for extracting a single frame from a video.
+ */
+export interface FrameExtractionOptions {
+  /** Timestamp in milliseconds at which to extract the frame. */
+  time: number;
+  /** Output image format: `"jpeg"` (default) or `"png"`. */
+  format: string;
+  /** JPEG compression quality from 0–100. Default `80`. Ignored for PNG. */
+  quality: number;
+  /** Maximum width in pixels. Height is auto-calculated to preserve aspect ratio. `-1` for original. */
+  maxWidth: number;
+  /** Maximum height in pixels. Width is auto-calculated to preserve aspect ratio. `-1` for original. */
+  maxHeight: number;
+}
+
+/**
+ * Result returned by {@link Spec.getFrameAt}.
+ */
+export interface FrameResult {
+  /** Absolute path to the extracted image file. */
+  outputPath: string;
+}
+
+/**
+ * Options for extracting the audio track from a video file.
+ */
+export interface ExtractAudioOptions {
+  /** Output audio file extension (e.g. `"mp3"`, `"m4a"`, `"wav"`). Default `"mp3"`. */
+  outputExt: string;
+}
+
+/**
+ * Result returned by {@link Spec.extractAudio}.
+ */
+export interface ExtractAudioResult {
+  /** Absolute path to the extracted audio file. */
+  outputPath: string;
+  /** Duration of the audio in milliseconds. */
+  duration: number;
+}
+
+/**
+ * Options for compressing a video file.
+ */
+export interface CompressOptions {
+  /**
+   * Quality preset: `"low"` (smallest file), `"medium"` (balanced), `"high"` (best quality).
+   * Maps to CRF 28, 23, 18 respectively. Ignored when `bitrate` is set.
+   */
+  quality: string;
+  /** Explicit target bitrate in bits per second. Overrides `quality` when set. `-1` to use quality preset. */
+  bitrate: number;
+  /** Target width in pixels. `-1` to keep original. Height is auto-calculated to preserve aspect ratio. */
+  width: number;
+  /** Target height in pixels. `-1` to keep original. Width is auto-calculated to preserve aspect ratio. */
+  height: number;
+  /** Target frame rate. `-1` to keep original. */
+  frameRate: number;
+  /** Output file extension (e.g. `"mp4"`). Default `"mp4"`. */
+  outputExt: string;
+  /** When `true`, strips the audio track from the output. Default `false`. */
+  removeAudio: boolean;
+}
+
+/**
+ * Result returned by {@link Spec.compress}.
+ */
+export interface CompressResult {
+  /** Absolute path to the compressed output file. */
+  outputPath: string;
+}
+
+/**
+ * Options for converting a video segment to an animated GIF.
+ */
+export interface GifOptions {
+  /** Start time in milliseconds. Default `0`. */
+  startTime: number;
+  /** End time in milliseconds. Default `-1` (end of video). */
+  endTime: number;
+  /** Frame rate of the GIF. Default `10`. */
+  fps: number;
+  /** Width in pixels. Height is auto-calculated to preserve aspect ratio. `-1` for original. */
+  width: number;
+}
+
+/**
+ * Result returned by {@link Spec.toGif}.
+ */
+export interface GifResult {
+  /** Absolute path to the generated GIF file. */
+  outputPath: string;
+}
+
+/**
+ * Options for merging multiple media files into one.
+ */
+export interface MergeOptions {
+  /** Output file extension (e.g. `"mp4"`, `"wav"`). Default `"mp4"`. */
+  outputExt: string;
+}
+
+/**
+ * Result returned by {@link Spec.merge}.
+ */
+export interface MergeResult {
+  /** Absolute path to the merged output file. */
+  outputPath: string;
+  /** Total duration of the merged file in milliseconds. */
+  duration: number;
+}
+
+/**
+ * Result returned by {@link Spec.saveToPhoto}.
+ */
+export interface SaveToPhotoResult {
+  /** Whether the file was saved to the photo library successfully. */
+  success: boolean;
+}
+
+/**
+ * Result returned by {@link Spec.saveToDocuments}.
+ */
+export interface SaveToDocumentsResult {
+  /** Whether the file was saved to documents successfully. */
+  success: boolean;
+}
+
+/**
+ * Result returned by {@link Spec.share}.
+ */
+export interface ShareResult {
+  /** Whether the user completed the share action. */
+  success: boolean;
+}
+
 /**
  * TurboModule spec for the native VideoTrim module.
  */
@@ -197,6 +355,31 @@ export interface Spec extends TurboModule {
   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>;
+  /** Extract a single frame from a video at the specified timestamp. */
+  getFrameAt(
+    url: string,
+    options: FrameExtractionOptions
+  ): Promise<FrameResult>;
+  /** Extract the audio track from a video file into a separate audio file. */
+  extractAudio(
+    url: string,
+    options: ExtractAudioOptions
+  ): Promise<ExtractAudioResult>;
+  /** Compress a video file to reduce its size. */
+  compress(url: string, options: CompressOptions): Promise<CompressResult>;
+  /** Convert a video segment to an animated GIF. */
+  toGif(url: string, options: GifOptions): Promise<GifResult>;
+  /** Merge multiple media files into a single file. Headless only, no editor UI. */
+  merge(
+    urls: ReadonlyArray<string>,
+    options: MergeOptions
+  ): Promise<MergeResult>;
+  /** Save a file to the device's photo library. Requires photo library permission. */
+  saveToPhoto(filePath: string): Promise<SaveToPhotoResult>;
+  /** Present the system document picker to save a file to the user's chosen location. */
+  saveToDocuments(filePath: string): Promise<SaveToDocumentsResult>;
+  /** Open the system share sheet for a file. */
+  share(filePath: string): Promise<ShareResult>;
 
   /** Emitted when the trim operation starts. */
   readonly onStartTrimming: EventEmitter<void>;