@cesdk/engine 1.64.0-nightly.20251106 → 1.65.0-nightly.20251112

package/index.d.ts

@@ -4427,6 +4427,14 @@ export declare class BlockAPI {
      * @returns The selected UTF-16 range or `{ from: -1, to: -1 }` if no text block is being edited.
      */
     getTextCursorRange(): Range_2;
+    /**
+     * Sets the text cursor range (selection) within the text block that is currently being edited.
+     *
+     * @category Block Text
+     * @param range - The UTF-16 range to set as the selection. If `from` equals `to`, the cursor is positioned at that index. If `from` and `to` are set to -1, the whole text is selected.
+     * @throws Error if no text block is currently being edited or if the range is invalid.
+     */
+    setTextCursorRange(range: Range_2): void;
     /**
      * Gets the number of visible lines in a text block.
      *
@@ -5588,7 +5596,7 @@ export declare type BlurTypeShorthand = (typeof BLUR_TYPES)[number];
 export declare type BooleanOperation = 'Difference' | 'Intersection' | 'Union' | 'XOR';
 
 /** @public */
-export declare type BoolPropertyName = 'alwaysOnBottom' | 'alwaysOnTop' | 'clipped' | 'flip/horizontal' | 'flip/vertical' | 'highlightEnabled' | 'includedInExport' | 'placeholder/enabled' | 'playback/playing' | 'playback/soloPlaybackEnabled' | 'scene/aspectRatioLock' | 'selected' | 'transformLocked' | 'visible' | 'blur/enabled' | 'dropShadow/clip' | 'dropShadow/enabled' | 'fill/enabled' | 'page/marginEnabled' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'playback/looping' | 'playback/muted' | 'stroke/enabled' | 'backgroundColor/enabled' | 'placeholderBehavior/enabled' | 'text/automaticFontSizeEnabled' | 'text/clipLinesOutsideOfFrame' | 'text/hasClippedLines' | 'track/automaticallyManageBlockOffsets' | 'caption/automaticFontSizeEnabled' | 'caption/clipLinesOutsideOfFrame' | 'caption/hasClippedLines' | 'captionTrack/automaticallyManageBlockOffsets' | 'animation/slide/fade' | 'animation/pan/fade' | 'animation/blur/fade' | 'animation/zoom/fade' | 'animation/crop_zoom/fade' | 'animation/spin/fade' | 'animation/block_swipe_text/useTextColor' | 'animation/spread_text/fade' | 'animation/ken_burns/fade' | 'effect/enabled' | (string & {});
+export declare type BoolPropertyName = 'alwaysOnBottom' | 'alwaysOnTop' | 'clipped' | 'flip/horizontal' | 'flip/vertical' | 'highlightEnabled' | 'includedInExport' | 'placeholder/enabled' | 'playback/playing' | 'playback/soloPlaybackEnabled' | 'scene/aspectRatioLock' | 'selected' | 'selectionEnabled' | 'transformLocked' | 'visible' | 'blur/enabled' | 'dropShadow/clip' | 'dropShadow/enabled' | 'fill/enabled' | 'page/marginEnabled' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'playback/looping' | 'playback/muted' | 'stroke/enabled' | 'backgroundColor/enabled' | 'placeholderBehavior/enabled' | 'text/automaticFontSizeEnabled' | 'text/clipLinesOutsideOfFrame' | 'text/hasClippedLines' | 'track/automaticallyManageBlockOffsets' | 'caption/automaticFontSizeEnabled' | 'caption/clipLinesOutsideOfFrame' | 'caption/hasClippedLines' | 'captionTrack/automaticallyManageBlockOffsets' | 'animation/slide/fade' | 'animation/pan/fade' | 'animation/blur/fade' | 'animation/zoom/fade' | 'animation/crop_zoom/fade' | 'animation/spin/fade' | 'animation/block_swipe_text/useTextColor' | 'animation/spread_text/fade' | 'animation/ken_burns/fade' | 'effect/enabled' | (string & {});
 
 /**
  * Represents a buffer of data.
@@ -8337,6 +8345,33 @@ export declare class SceneAPI {
      * @returns The current design unit.
      */
     getDesignUnit(): SceneDesignUnit;
+    /**
+     * Get the layout of the current scene.
+     *
+     * ```javascript
+     * const layout = engine.scene.getLayout();
+     * ```
+     *
+     * @category Scene Properties
+     * @returns The current layout of the scene.
+     */
+    getLayout(): SceneLayout;
+    /**
+     * Set the layout of the current scene.
+     * This will handle all necessary conversions including creating or destroying stack blocks
+     * and reparenting pages as needed.
+     *
+     * When transitioning from stack layouts (VerticalStack, HorizontalStack, DepthStack) to Free layout,
+     * the global positions of pages are preserved to maintain their visual appearance in the scene.
+     *
+     * ```javascript
+     * engine.scene.setLayout('VerticalStack');
+     * ```
+     *
+     * @category Scene Properties
+     * @param layout - The new layout for the scene.
+     */
+    setLayout(layout: SceneLayout): void;
     /**
      * Get the sorted list of pages in the scene.
      *
@@ -8895,6 +8930,7 @@ export declare interface Settings {
 
 
 
+
 
 
 }
@@ -8970,7 +9006,7 @@ export declare type SettingsInt = SettingIntPropertyName;
 export declare type SettingsString = SettingStringPropertyName;
 
 /** @public */
-export declare type SettingStringPropertyName = 'basePath' | 'defaultEmojiFontFileUri' | 'defaultFontFileUri' | 'upload/supportedMimeTypes' | 'license' | 'page/title/separator' | 'page/title/fontFileUri' | 'fallbackFontUri' | (string & {});
+export declare type SettingStringPropertyName = 'basePath' | 'defaultEmojiFontFileUri' | 'defaultFontFileUri' | 'upload/supportedMimeTypes' | 'license' | 'web/fetchCredentials' | 'page/title/separator' | 'page/title/fontFileUri' | 'fallbackFontUri' | (string & {});
 
 /**
  * Represents the type of a setting.