@cesdk/engine 1.64.0-rc.1 → 1.65.0-nightly.20251113

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.
      *
@@ -7348,6 +7356,14 @@ export declare type ExportOptions = {
      * The adjustment in size of the shape of the underlayer.
      */
     underlayerOffset?: number;
+    /**
+     * If true, the export will include text bounding boxes that account for glyph overhangs.
+     * When enabled, text blocks with glyphs that extend beyond their frame (e.g., decorative fonts with swashes)
+     * will be exported with the full glyph bounds visible, preventing text clipping.
+     *
+     * @defaultValue false
+     */
+    allowTextOverhang?: boolean;
     /**
      * An abortsignal that can be used to cancel the export.
      */
@@ -8337,6 +8353,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.
      *
@@ -9325,6 +9368,7 @@ export declare interface _UBQExportOptions {
     exportPdfWithUnderlayer: boolean;
     underlayerSpotColorName: string;
     underlayerOffset: number;
+    allowTextOverhang: boolean;
 }
 
 /**
@@ -9347,6 +9391,7 @@ export declare interface _UBQExportVideoOptions {
     useTargetSize: boolean;
     targetWidth: number;
     targetHeight: number;
+    allowTextOverhang: boolean;
 }
 
 /**
@@ -9525,6 +9570,14 @@ export declare type VideoExportOptions = {
      * size entirely while maintaining its aspect ratio.
      */
     targetHeight?: number;
+    /**
+     * If true, the export will include text bounding boxes that account for glyph overhangs.
+     * When enabled, text blocks with glyphs that extend beyond their frame (e.g., decorative fonts with swashes)
+     * will be exported with the full glyph bounds visible, preventing text clipping.
+     *
+     * @defaultValue false
+     */
+    allowTextOverhang?: boolean;
     /**
      * An abortsignal that can be used to cancel the export.
      */