@cesdk/engine 1.60.0-rc.0 → 1.61.0-nightly.20250907

package/index.d.ts

@@ -4724,6 +4724,23 @@ export declare class BlockAPI {
      * @returns The trim length of the object in seconds.
      */
     getTrimLength(id: DesignBlockId): number;
+    /**
+     * Splits a block at the specified time.
+     *
+     * The original block will be trimmed to end at the split time, and the returned duplicate
+     * will start at the split time and continue to the original end time.
+     *
+     * ```javascript
+     * const duplicate = engine.block.split(video, 10.0);
+     * ```
+     *
+     * @category Block
+     * @param id - The block to split.
+     * @param atTime - The time (in seconds) relative to the block's time offset where the split should occur.
+     * @param options - The options for configuring the split operation.
+     * @returns The newly created second half of the split block.
+     */
+    split(id: DesignBlockId, atTime: number, options?: SplitOptions): DesignBlockId;
     /**
      * Gets the total duration of a scene in video mode.
      *
@@ -8391,6 +8408,45 @@ export declare interface Source {
     height: number;
 }
 
+/**
+ * Options for configuring block split operations.
+ * @public
+ */
+export declare type SplitOptions = {
+    /**
+     * Whether or not the new block will be attached to the same parent as the original.
+     * @defaultValue true
+     */
+    attachToParent?: boolean;
+    /**
+     * Whether to create a parent track if needed and add both blocks to it. Only used when attachToParent is true.
+     * @defaultValue false
+     */
+    createParentTrackIfNeeded?: boolean;
+    /**
+     * Whether to select the newly created block after splitting.
+     * @defaultValue true
+     */
+    selectNewBlock?: boolean;
+};
+
+/**
+ * Specifies options for configuring block split operations.
+ *
+ * The `SplitOptions` interface provides a set of properties that control the
+ * behavior of the block splitting operation.
+ *
+ * @categoryDescription Split Options
+ * Methods for configuring block split operations.
+ *
+ * @public
+ */
+declare interface SplitOptions_2 {
+    attachToParent: boolean;
+    createParentTrackIfNeeded: boolean;
+    selectNewBlock: boolean;
+}
+
 /**
  * Represents a spot color value.
  *