@cesdk/node 1.63.0-nightly.20251022 → 1.63.0-nightly.20251024

package/index.d.ts

@@ -1183,6 +1183,24 @@ export declare type AudioExportOptions = {
     abortSignal?: AbortSignal;
 };
 
+/**
+ * Options for configuring audio extraction from video operations.
+ * @public
+ */
+export declare type AudioFromVideoOptions = {
+    /**
+     * If true, the audio block will have the same duration, trim length, and trim offset as the source video.
+     * If false, the full audio track is extracted without trim settings.
+     * @defaultValue true
+     */
+    keepTrimSettings?: boolean;
+    /**
+     * If true, mutes the audio of the original video fill block.
+     * @defaultValue true
+     */
+    muteOriginalVideo?: boolean;
+};
+
 /**
  * Represents the audio MIME types used in the editor.
  *
@@ -1628,40 +1646,46 @@ export declare class BlockAPI {
      * Creates a new audio block by extracting a specific audio track from a video fill block.
      *
      * ```javascript
-     * // Extract the first audio track (usually the main mix)
+     * // Extract the first audio track (usually the main mix) with trim settings
      * const audioBlock = engine.block.createAudioFromVideo(videoFillBlock, 0);
      *
-     * // Extract a specific track and mute the original video
-     * const dialogueTrack = engine.block.createAudioFromVideo(videoFillBlock, 1, true);
+     * // Extract full audio track without trim settings
+     * const audioBlock = engine.block.createAudioFromVideo(videoFillBlock, 0, { keepTrimSettings: false });
+     *
+     * // Extract a specific track, keep trim settings, and mute the original video
+     * const dialogueTrack = engine.block.createAudioFromVideo(videoFillBlock, 1, { keepTrimSettings: true, muteOriginalVideo: true });
      * ```
      *
      * @category Block Audio
      * @param videoFillBlock - The video fill block to extract audio from.
      * @param trackIndex - The index of the audio track to extract (0-based).
-     * @param muteOriginalVideo - If true, mutes the audio of the original video fill block (default: false).
+     * @param options - Options for the audio extraction operation.
      * @returns The handle of the newly created audio block with extracted audio from the specified track.
      * @throws Will throw an error if the track index is invalid or the block has no audio.
      */
-    createAudioFromVideo(videoFillBlock: DesignBlockId, trackIndex: number, muteOriginalVideo?: boolean): DesignBlockId;
+    createAudioFromVideo(videoFillBlock: DesignBlockId, trackIndex: number, options?: AudioFromVideoOptions): DesignBlockId;
     /**
      * Creates multiple audio blocks by extracting all audio tracks from a video fill block.
      *
      * ```javascript
-     * // Extract all audio tracks from a video
+     * // Extract all audio tracks from a video with trim settings
      * const audioBlocks = engine.block.createAudiosFromVideo(videoFillBlock);
      * console.log(`Created ${audioBlocks.length} audio blocks`);
      *
-     * // Extract all tracks and mute the original video
-     * const audioBlocks = engine.block.createAudiosFromVideo(videoFillBlock, true);
+     * // Extract all tracks without trim settings (full audio)
+     * const audioBlocks = engine.block.createAudiosFromVideo(videoFillBlock, { keepTrimSettings: false });
+     *
+     * // Extract all tracks with trim settings and mute the original video
+     * const audioBlocks = engine.block.createAudiosFromVideo(videoFillBlock, { keepTrimSettings: true, muteOriginalVideo: true });
      * ```
      *
      * @category Block Audio
      * @param videoFillBlock - The video fill block to extract audio from.
-     * @param muteOriginalVideo - If true, mutes the audio of the original video fill block (default: false).
+     * @param options - Options for the audio extraction operation.
      * @returns An array of handles for the newly created audio blocks, one per track.
      * @throws Will throw an error if the block has no audio or extraction fails.
      */
-    createAudiosFromVideo(videoFillBlock: DesignBlockId, muteOriginalVideo?: boolean): DesignBlockId[];
+    createAudiosFromVideo(videoFillBlock: DesignBlockId, options?: AudioFromVideoOptions): DesignBlockId[];
     /**
      * Gets information about all audio tracks from a video fill block.
      *
@@ -3290,6 +3314,35 @@ export declare class BlockAPI {
      * @param id - The block whose crop should be updated.
      */
     flipCropVertical(id: DesignBlockId): void;
+    /**
+     * Checks if the crop aspect ratio is locked for a block.
+     *
+     * When locked, crop handles will maintain the current aspect ratio during resize.
+     *
+     * ```javascript
+     * const isLocked = engine.block.isCropAspectRatioLocked(block);
+     * ```
+     *
+     * @category Block Crop
+     * @param id - The block to query.
+     * @returns True if aspect ratio is locked, false otherwise.
+     */
+    isCropAspectRatioLocked(id: DesignBlockId): boolean;
+    /**
+     * Sets whether the crop aspect ratio should be locked for a block.
+     *
+     * When enabled, crop handles will maintain the current aspect ratio.
+     * When disabled, free resizing is allowed.
+     *
+     * ```javascript
+     * engine.block.setCropAspectRatioLocked(block, true);
+     * ```
+     *
+     * @category Block Crop
+     * @param id - The block to update.
+     * @param locked - Whether aspect ratio should be locked.
+     */
+    setCropAspectRatioLocked(id: DesignBlockId, locked: boolean): void;
     /**
      * Checks if a block has an opacity property.
      *
@@ -8424,6 +8477,21 @@ export declare type TypefaceDefinition = {
     }[];
 };
 
+/**
+ * Specifies options for configuring audio extraction from video operations.
+ *
+ * The `UBQAudioFromVideoOptions` interface provides a set of properties that control the
+ * behavior of the audio extraction operation.
+ *
+ * Methods for configuring audio extraction from video operations.
+ *
+ * @public
+ */
+declare interface UBQAudioFromVideoOptions {
+    keepTrimSettings: boolean;
+    muteOriginalVideo: boolean;
+}
+
 /**
  * Specifies options for exporting audio design blocks to various formats.
  *