@cesdk/cesdk-js 1.64.0-nightly.20251026 → 1.64.0-nightly.20251028

package/index.d.ts

@@ -957,6 +957,8 @@ export declare interface BuiltinTranslations {
     'common.colorValue': string;
     'common.confirm': string;
     'common.controlKey': string;
+    'common.shiftKey': string;
+    'common.altKey': string;
     'common.custom': string;
     'common.defaultDuration': string;
     'common.defaultDuration.inUnit': string;
@@ -1166,6 +1168,8 @@ export declare interface BuiltinTranslations {
     'component.placeholder.appearance.description': string;
     'component.placeholder.arrange': string;
     'component.placeholder.arrange.description': string;
+    'component.placeholder.audio': string;
+    'component.placeholder.audio.description': string;
     'component.placeholder.create': string;
     'component.placeholder.disableAll': string;
     'component.placeholder.enableAll': string;
@@ -2016,6 +2020,8 @@ export declare interface BuiltinTranslations {
     'scope.appearance.filter.tooltip': string;
     'scope.appearance.shadow': string;
     'scope.appearance.shadow.tooltip': string;
+    'scope.audio.change': string;
+    'scope.audio.change.tooltip': string;
     'scope.editor.select': string;
     'scope.fill.change': string;
     'scope.fill.change.tooltip': string;
@@ -2023,8 +2029,6 @@ export declare interface BuiltinTranslations {
     'scope.fill.change.text.tooltip': string;
     'scope.fill.change.graphic': string;
     'scope.fill.change.graphic.tooltip': string;
-    'scope.fill.change.audio': string;
-    'scope.fill.change.audio.tooltip': string;
     'scope.fill.changeType': string;
     'scope.fill.changeType.tooltip': string;
     'scope.layer.blendMode': string;
@@ -2105,7 +2109,7 @@ export declare interface ButtonGroupOptions {
  * behavior and appearance of a button. These options include settings for the
  * input label, input label position, label, label alignment, tooltip, click
  * handler, variant, color, size, icon, trailing icon, active state, selected state,
- * disabled state, loading state, loading progress, and suffix.
+ * disabled state, loading state, loading progress, suffix, and keyboard shortcut.
  *
  * @public
  */
@@ -2127,6 +2131,12 @@ export declare interface ButtonOptions {
     isLoading?: boolean;
     loadingProgress?: number;
     suffix?: Suffix;
+    /**
+     * Keyboard shortcut to display (e.g., 'Meta+C', 'Meta+V', 'Alt+D').
+     * Automatically renders OS-appropriate modifiers (⌘ on macOS, Ctrl on Windows/Linux).
+     * Hidden on small viewports.
+     */
+    shortcut?: string;
 }
 
 /**
@@ -2196,14 +2206,75 @@ export { Canvas }
 export declare type CanvasBarComponentId = 'ly.img.separator' | 'ly.img.spacer' | 'ly.img.settings.canvasBar' | 'ly.img.page.add.canvasBar' | (string & {});
 
 /**
- * Represents the ID of a canvas menu component.
+ * @public
+ * Base interface for action buttons in the canvas menu.
+ * Contains common properties shared across all canvas menu button types.
  *
- * The CanvasMenuComponentId type defines the possible IDs for components that can be used in the canvas menu.
- * It includes predefined IDs for separators, spacers, and various menu items, as well as a catch-all type for custom IDs.
+ * - `onClick`: Handler invoked when the button is clicked.
+ * - `label`: Optional label for the button.
+ * - `icon`: Optional icon name to display on the button.
+ * - `variant`: Optional style variant of the button, either 'regular' or 'plain'.
+ * - `isDisabled`: Optional disabled property.
+ * - `shortcut`: Optional keyboard shortcut displayed alongside the action.
+ */
+export declare interface CanvasMenuActionButton extends OrderComponent {
+    id: 'ly.img.flipX.canvasMenu' | 'ly.img.flipY.canvasMenu' | 'ly.img.copy.canvasMenu' | 'ly.img.paste.canvasMenu';
+    onClick?: () => void | Promise<void>;
+    label?: string;
+    icon?: string;
+    variant?: 'regular' | 'plain';
+    isDisabled?: boolean;
+    shortcut?: string;
+}
+
+/**
+ * A list of the component IDs that can be used in the canvas menu.
+ * @public
+ */
+export declare type CanvasMenuComponentId = 'ly.img.separator' | 'ly.img.spacer' | 'ly.img.group.enter.canvasMenu' | 'ly.img.group.select.canvasMenu' | 'ly.img.page.moveUp.canvasMenu' | 'ly.img.page.moveDown.canvasMenu' | 'ly.img.text.edit.canvasMenu' | 'ly.img.replace.canvasMenu' | 'ly.img.placeholder.canvasMenu' | 'ly.img.bringForward.canvasMenu' | 'ly.img.sendBackward.canvasMenu' | 'ly.img.duplicate.canvasMenu' | 'ly.img.delete.canvasMenu' | 'ly.img.options.canvasMenu' | 'ly.img.flipX.canvasMenu' | 'ly.img.flipY.canvasMenu' | 'ly.img.copy.canvasMenu' | 'ly.img.paste.canvasMenu' | 'ly.img.text.color.canvasMenu' | 'ly.img.text.bold.canvasMenu' | 'ly.img.text.italic.canvasMenu' | 'ly.img.text.variables.canvasMenu' | (string & {});
+
+/**
+ * @public
+ */
+export declare type CanvasMenuComponents = CanvasMenuActionButton | CanvasMenuOptionsComponent | CanvasMenuCustomActionButton;
+
+/**
+ * @public
+ * Interface representing a custom canvas menu action button.
+ * Note: This component requires a key and has a required label, unlike other action buttons.
+ */
+export declare interface CanvasMenuCustomActionButton extends OrderComponent {
+    id: 'ly.img.action.canvasMenu';
+    key: string;
+    onClick: () => void | Promise<void>;
+    label: string;
+    icon?: string;
+    variant?: 'regular' | 'plain';
+    isDisabled?: boolean;
+    shortcut?: string;
+}
+
+/**
+ * @public
+ * Interface representing the canvas menu options dropdown component.
+ * This component can contain children components that are rendered in a dropdown menu.
  *
+ * - `children`: Optional array of child component IDs or components to render in the dropdown.
+ * - `icon`: Optional icon name to display on the dropdown button.
+ * - `variant`: Optional style variant of the dropdown button, either 'regular' or 'plain'.
+ * - `tooltip`: Optional tooltip text to display when hovering over the dropdown button.
+ */
+export declare interface CanvasMenuOptionsComponent extends OrderComponentWithChildren<CanvasMenuComponentId, CanvasMenuActionButton> {
+    id: 'ly.img.options.canvasMenu';
+    icon?: string;
+    variant?: 'regular' | 'plain';
+    tooltip?: string;
+}
+
+/**
  * @public
  */
-export declare type CanvasMenuComponentId = 'ly.img.separator' | 'ly.img.spacer' | 'ly.img.group.enter.canvasMenu' | 'ly.img.group.select.canvasMenu' | 'ly.img.page.moveUp.canvasMenu' | 'ly.img.page.moveDown.canvasMenu' | 'ly.img.text.edit.canvasMenu' | 'ly.img.replace.canvasMenu' | 'ly.img.placeholder.canvasMenu' | 'ly.img.bringForward.canvasMenu' | 'ly.img.sendBackward.canvasMenu' | 'ly.img.duplicate.canvasMenu' | 'ly.img.delete.canvasMenu' | 'ly.img.options.canvasMen' | 'ly.img.text.color.canvasMenu' | 'ly.img.text.bold.canvasMenu' | 'ly.img.text.italic.canvasMenu' | 'ly.img.text.variables.canvasMenu' | (string & {});
+export declare type CanvasMenuOrderComponent = CanvasMenuComponents | OrderComponentWithChildren<CanvasMenuComponentId, CanvasMenuComponents>;
 
 /**
  * @public
@@ -2709,6 +2780,9 @@ declare class CreativeEditorSDK {
      */
     unstable_onActivePageChanged(callback: (id: number) => void): () => void;
     /**
+     * Focus on a specific page and zoom to fit it in the viewport.
+     * @param pageId - The ID of the page to focus on
+     * @returns A promise that resolves when the focus operation is complete
      * @category Page Management
      * @experimental This API is experimental and may change or be removed in future versions.
      */
@@ -3618,7 +3692,7 @@ export declare class FeatureAPI {
  *
  * @public
  */
-export declare type FeatureId = 'ly.img.navigation.bar' | 'ly.img.navigation.back' | 'ly.img.navigation.close' | 'ly.img.navigation.undoRedo' | 'ly.img.navigation.zoom' | 'ly.img.navigation.actions' | 'ly.img.delete' | 'ly.img.duplicate' | 'ly.img.placeholder' | 'ly.img.preview' | 'ly.img.page.move' | 'ly.img.page.add' | 'ly.img.group' | 'ly.img.replace' | 'ly.img.text.edit' | 'ly.img.text.typeface' | 'ly.img.text.fontSize' | 'ly.img.text.fontStyle' | 'ly.img.text.alignment' | 'ly.img.text.advanced' | 'ly.img.text.background' | 'ly.img.adjustment' | 'ly.img.filter' | 'ly.img.filter.lut' | 'ly.img.filter.duotone' | 'ly.img.effect' | 'ly.img.blur' | 'ly.img.shadow' | 'ly.img.cutout' | 'ly.img.fill' | 'ly.img.shape.options' | 'ly.img.combine' | 'ly.img.trim' | 'ly.img.crop' | 'ly.img.crop.size' | 'ly.img.crop.rotation' | 'ly.img.crop.flip' | 'ly.img.crop.fillMode' | 'ly.img.crop.scale' | 'ly.img.crop.position' | 'ly.img.volume' | 'ly.img.stroke' | 'ly.img.position' | 'ly.img.animations' | 'ly.img.opacity' | 'ly.img.blendMode' | 'ly.img.video.timeline' | 'ly.img.video.clips' | 'ly.img.video.overlays' | 'ly.img.video.audio' | 'ly.img.video.addClip' | 'ly.img.video.controls' | 'ly.img.video.controls.toggle' | 'ly.img.video.controls.background' | 'ly.img.video.controls.playback' | 'ly.img.video.controls.loop' | 'ly.img.video.controls.split' | 'ly.img.video.controls.timelineZoom' | 'ly.img.video.caption' | 'ly.img.transform.position' | 'ly.img.transform.size' | 'ly.img.transform.rotation' | 'ly.img.transform.flip' | 'ly.img.inspector.bar' | 'ly.img.inspector.toggle' | 'ly.img.page.resize' | 'ly.img.dock' | 'ly.img.canvas.bar' | 'ly.img.canvas.menu' | 'ly.img.inspector' | 'ly.img.settings' | 'ly.img.library.panel' | (string & {});
+export declare type FeatureId = 'ly.img.navigation.bar' | 'ly.img.navigation.back' | 'ly.img.navigation.close' | 'ly.img.navigation.undoRedo' | 'ly.img.navigation.zoom' | 'ly.img.navigation.actions' | 'ly.img.delete' | 'ly.img.duplicate' | 'ly.img.placeholder' | 'ly.img.placeholder.general' | 'ly.img.placeholder.arrange' | 'ly.img.placeholder.fill' | 'ly.img.placeholder.shape' | 'ly.img.placeholder.stroke' | 'ly.img.placeholder.text' | 'ly.img.placeholder.appearance' | 'ly.img.placeholder.general.opacity' | 'ly.img.placeholder.general.blendMode' | 'ly.img.placeholder.general.duplicate' | 'ly.img.placeholder.general.delete' | 'ly.img.placeholder.arrange.move' | 'ly.img.placeholder.arrange.resize' | 'ly.img.placeholder.arrange.rotate' | 'ly.img.placeholder.arrange.flip' | 'ly.img.placeholder.fill.change' | 'ly.img.placeholder.fill.changeType' | 'ly.img.placeholder.fill.actAsPlaceholder' | 'ly.img.placeholder.fill.crop' | 'ly.img.placeholder.shape.change' | 'ly.img.placeholder.stroke.change' | 'ly.img.placeholder.text.edit' | 'ly.img.placeholder.text.actAsPlaceholder' | 'ly.img.placeholder.text.character' | 'ly.img.placeholder.appearance.adjustments' | 'ly.img.placeholder.appearance.filter' | 'ly.img.placeholder.appearance.effect' | 'ly.img.placeholder.appearance.blur' | 'ly.img.placeholder.appearance.shadow' | 'ly.img.placeholder.appearance.animations' | 'ly.img.preview' | 'ly.img.page.move' | 'ly.img.page.add' | 'ly.img.group' | 'ly.img.replace' | 'ly.img.text.edit' | 'ly.img.text.typeface' | 'ly.img.text.fontSize' | 'ly.img.text.fontStyle' | 'ly.img.text.alignment' | 'ly.img.text.advanced' | 'ly.img.text.background' | 'ly.img.adjustment' | 'ly.img.filter' | 'ly.img.filter.lut' | 'ly.img.filter.duotone' | 'ly.img.effect' | 'ly.img.blur' | 'ly.img.shadow' | 'ly.img.cutout' | 'ly.img.fill' | 'ly.img.shape.options' | 'ly.img.combine' | 'ly.img.trim' | 'ly.img.crop' | 'ly.img.crop.size' | 'ly.img.crop.rotation' | 'ly.img.crop.flip' | 'ly.img.crop.fillMode' | 'ly.img.crop.scale' | 'ly.img.crop.position' | 'ly.img.crop.panel.autoOpen' | 'ly.img.volume' | 'ly.img.stroke' | 'ly.img.position' | 'ly.img.animations' | 'ly.img.opacity' | 'ly.img.blendMode' | 'ly.img.video.timeline' | 'ly.img.video.clips' | 'ly.img.video.overlays' | 'ly.img.video.audio' | 'ly.img.video.addClip' | 'ly.img.video.controls' | 'ly.img.video.controls.toggle' | 'ly.img.video.controls.background' | 'ly.img.video.controls.playback' | 'ly.img.video.controls.loop' | 'ly.img.video.controls.split' | 'ly.img.video.controls.timelineZoom' | 'ly.img.video.caption' | 'ly.img.transform.position' | 'ly.img.transform.size' | 'ly.img.transform.rotation' | 'ly.img.transform.flip' | 'ly.img.inspector.bar' | 'ly.img.inspector.toggle' | 'ly.img.page.resize' | 'ly.img.dock' | 'ly.img.canvas.bar' | 'ly.img.canvas.menu' | 'ly.img.inspector' | 'ly.img.settings' | 'ly.img.library.panel' | (string & {});
 
 /**
  * The feature predicate is used to enable or disable a feature
@@ -4360,6 +4434,39 @@ export declare interface RegisteredActions {
      * Action invoked when the add clip button is pressed in the video timeline
      */
     addClip: VoidFunction;
+    /**
+     * Zoom actions for explicit zoom control
+     */
+    /** Action for zooming to a specific block */
+    'zoom.toBlock': ZoomToBlockAction;
+    /** Action for zooming to the current page with optional padding */
+    'zoom.toPage': ZoomToPageAction;
+    /** Action for zooming to the current selection */
+    'zoom.toSelection': ZoomToSelectionAction;
+    /** Action for zooming in by one step */
+    'zoom.in': ZoomInAction;
+    /** Action for zooming out by one step */
+    'zoom.out': ZoomOutAction;
+    /** Action for setting zoom to a specific level */
+    'zoom.toLevel': ZoomToLevelAction;
+    /**
+     * Scroll actions
+     */
+    /** Action for scrolling to a specific page */
+    'scroll.toPage': ScrollToPageAction;
+    /**
+     * Video timeline zoom actions
+     */
+    /** Action for zooming in the video timeline */
+    'timeline.zoom.in': TimelineZoomInAction;
+    /** Action for zooming out the video timeline */
+    'timeline.zoom.out': TimelineZoomOutAction;
+    /** Action for fitting the video timeline to show all content */
+    'timeline.zoom.fit': TimelineZoomToFitAction;
+    /** Action for setting the video timeline zoom to a specific level */
+    'timeline.zoom.toLevel': TimelineZoomToLevelAction;
+    /** Action for resetting the video timeline zoom to default */
+    'timeline.zoom.reset': TimelineZoomResetAction;
 }
 
 /**
@@ -4430,6 +4537,17 @@ export { SceneMode }
 
 export { Scope }
 
+/**
+ * Action function for scrolling to a specific page
+ * @public
+ */
+export declare type ScrollToPageAction = (options?: {
+    /** The page ID to scroll to (defaults to current page) */
+    pageId?: number;
+    /** Whether to animate the scroll (default: false) */
+    animate?: boolean;
+}) => Promise<void>;
+
 /**
  * Represents options for a section.
  *
@@ -4631,6 +4749,39 @@ declare type ThemeConfig = Theme | ThemeFn | 'system';
  */
 declare type ThemeFn = () => Theme;
 
+/**
+ * Video timeline zoom action types
+ */
+/**
+ * Action function for zooming in the video timeline by one step
+ * @public
+ */
+export declare type TimelineZoomInAction = () => void;
+
+/**
+ * Action function for zooming out the video timeline by one step
+ * @public
+ */
+export declare type TimelineZoomOutAction = () => void;
+
+/**
+ * Action function for resetting the video timeline zoom to default level (1.0)
+ * @public
+ */
+export declare type TimelineZoomResetAction = () => void;
+
+/**
+ * Action function for fitting the video timeline to show all content
+ * @public
+ */
+export declare type TimelineZoomToFitAction = () => void;
+
+/**
+ * Action function for setting the video timeline zoom to a specific level
+ * @public
+ */
+export declare type TimelineZoomToLevelAction = (level: number) => void;
+
 export { TransientResource }
 
 /**
@@ -5523,7 +5674,7 @@ export declare class UserInterfaceAPI {
      * @param canvasMenuOrder - Array of component IDs defining the canvas menu order.
      * @param orderContext - Optional context specifying when this order applies.
      */
-    setCanvasMenuOrder(canvasMenuOrder: (CanvasMenuComponentId | OrderComponent<CanvasMenuComponentId>)[], orderContext?: OrderContext): void;
+    setCanvasMenuOrder(canvasMenuOrder: (CanvasMenuComponentId | CanvasMenuOrderComponent)[], orderContext?: OrderContext): void;
     /**
      * Gets the current rendering order of canvas menu components.
      *
@@ -5535,7 +5686,7 @@ export declare class UserInterfaceAPI {
      * @param orderContext - Optional context specifying which order to retrieve.
      * @returns Array of component configurations defining the canvas menu order.
      */
-    getCanvasMenuOrder(orderContext?: OrderContext): OrderComponent[];
+    getCanvasMenuOrder(orderContext?: OrderContext): CanvasMenuOrderComponent[];
     /**
      * Updates a component in the render order of the canvas menu.
      *
@@ -5551,11 +5702,11 @@ export declare class UserInterfaceAPI {
      * @param matcher - Function or object to match the component to update.
      * @param update - New ID, partial properties, or updater function for the component.
      * @param orderContext - Optional context specifying which order to update.
-     * @returns The updated canvas menu order array.
+     * @returns An object containing the number of updated components and the updated canvas menu order array.
      */
-    updateCanvasMenuOrderComponent(matcher: OrderComponentMatcher<OrderComponent<CanvasMenuComponentId>>, update: CanvasMenuComponentId | Partial<OrderComponent<CanvasMenuComponentId>> | ((component: OrderComponent<CanvasMenuComponentId>) => Partial<OrderComponent<CanvasMenuComponentId>>), orderContext?: OrderContext): {
+    updateCanvasMenuOrderComponent(matcher: OrderComponentMatcher<OrderComponent<CanvasMenuComponentId>>, update: CanvasMenuComponentId | Partial<CanvasMenuOrderComponent> | ((component: CanvasMenuOrderComponent) => Partial<CanvasMenuOrderComponent>), orderContext?: OrderContext): {
         updated: number;
-        order: OrderComponent<CanvasMenuComponentId>[];
+        order: CanvasMenuOrderComponent[];
     };
     /**
      * Removes a component from the render order of the canvas menu.
@@ -5568,11 +5719,11 @@ export declare class UserInterfaceAPI {
      * @category UI Layout
      * @param matcher - Function or object to match the component to remove.
      * @param orderContext - Optional context specifying which order to update.
-     * @returns The updated canvas menu order array.
+     * @returns An object containing the number of removed components and the updated canvas menu order array.
      */
     removeCanvasMenuOrderComponent(matcher: OrderComponentMatcher<OrderComponent<CanvasMenuComponentId>>, orderContext?: OrderContext): {
         removed: number;
-        order: OrderComponent<CanvasMenuComponentId>[];
+        order: CanvasMenuOrderComponent[];
     };
     /**
      * Inserts a component into the render order of the canvas menu.
@@ -5590,7 +5741,7 @@ export declare class UserInterfaceAPI {
      * @param orderContext - Optional context specifying which order to update.
      * @returns The updated canvas menu order array.
      */
-    insertCanvasMenuOrderComponent(matcher: OrderComponentMatcher<OrderComponent<CanvasMenuComponentId>>, component: CanvasMenuComponentId | OrderComponent<CanvasMenuComponentId>, location?: InsertOrderComponentLocation, orderContext?: OrderContext): {
+    insertCanvasMenuOrderComponent(matcher: OrderComponentMatcher<OrderComponent<CanvasMenuComponentId>>, component: CanvasMenuComponentId | CanvasMenuOrderComponent, location?: InsertOrderComponentLocation, orderContext?: OrderContext): {
         inserted: boolean;
         order: OrderComponent<CanvasMenuComponentId>[];
     };
@@ -6534,6 +6685,34 @@ export declare class UtilsAPI {
      * @public
      */
     localUpload(file: File, context?: UploadCallbackContext): Promise<AssetDefinition>;
+    /**
+     * Calculates the recommended viewport padding based on current viewport size and settings.
+     * This utility matches the internal padding used by the SDK for zoom operations.
+     *
+     * @param width - Optional viewport width to use instead of current camera width
+     * @param height - Optional viewport height to use instead of current camera height
+     * @returns An object containing paddingX and paddingY values
+     *
+     * @example
+     * ```typescript
+     * const padding = cesdk.utils.calculateViewportPadding();
+     * console.log(`Padding: ${padding.paddingX}x${padding.paddingY}`);
+     *
+     * // Use with custom zoom
+     * await cesdk.engine.scene.zoomToBlock(
+     *   pageId,
+     *   padding.paddingX,
+     *   padding.paddingY,
+     *   padding.paddingX,
+     *   padding.paddingY
+     * );
+     * ```
+     * @public
+     */
+    calculateViewportPadding(width?: number, height?: number): {
+        paddingX: number;
+        paddingY: number;
+    };
 }
 
 export { VariableAPI }
@@ -6556,6 +6735,153 @@ export { XYWH }
 
 export { ZoomAutoFitAxis }
 
+/**
+ * Action function for zooming in by one step
+ * @public
+ */
+export declare type ZoomInAction = (options?: {
+    /** Custom step size for zoom in (default uses predefined steps) */
+    stepSize?: number;
+    /** Animation configuration - boolean for default animation or object for custom settings */
+    animate?: boolean | {
+        /** Duration of the animation in seconds */
+        duration?: number;
+        /** Easing function for the animation */
+        easing?: 'Linear' | 'EaseIn' | 'EaseOut' | 'EaseInOut';
+        /** Whether the animation can be interrupted */
+        interruptible?: boolean;
+    };
+    /** Maximum allowed zoom level (default: 32) */
+    maxZoom?: number;
+}) => void | Promise<void>;
+
 export { ZoomOptions }
 
+/**
+ * Action function for zooming out by one step
+ * @public
+ */
+export declare type ZoomOutAction = (options?: {
+    /** Custom step size for zoom out (default uses predefined steps) */
+    stepSize?: number;
+    /** Animation configuration - boolean for default animation or object for custom settings */
+    animate?: boolean | {
+        /** Duration of the animation in seconds */
+        duration?: number;
+        /** Easing function for the animation */
+        easing?: 'Linear' | 'EaseIn' | 'EaseOut' | 'EaseInOut';
+        /** Whether the animation can be interrupted */
+        interruptible?: boolean;
+    };
+    /** Minimum allowed zoom level (default: 0.125) */
+    minZoom?: number;
+}) => void | Promise<void>;
+
+/**
+ * Zoom action types for explicit zoom control
+ */
+/**
+ * Action function for zooming to a specific block
+ * @public
+ */
+export declare type ZoomToBlockAction = (blockId: number, options?: {
+    /** Padding configuration around the block */
+    padding?: number | {
+        x?: number;
+        y?: number;
+    } | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    };
+    /** Animation configuration - boolean for default animation or object for custom settings */
+    animate?: boolean | {
+        /** Duration of the animation in seconds */
+        duration?: number;
+        /** Easing function for the animation */
+        easing?: 'Linear' | 'EaseIn' | 'EaseOut' | 'EaseInOut';
+        /** Whether the animation can be interrupted */
+        interruptible?: boolean;
+    };
+    /** Whether to enable auto-fit mode after zooming (default: false) */
+    autoFit?: boolean;
+}) => Promise<void>;
+
+/**
+ * Action function for setting zoom to a specific level
+ * @public
+ */
+export declare type ZoomToLevelAction = (level: number, options?: {
+    /** Animation configuration - boolean for default animation or object for custom settings */
+    animate?: boolean | {
+        /** Duration of the animation in seconds */
+        duration?: number;
+        /** Easing function for the animation */
+        easing?: 'Linear' | 'EaseIn' | 'EaseOut' | 'EaseInOut';
+        /** Whether the animation can be interrupted */
+        interruptible?: boolean;
+    };
+    /** Minimum allowed zoom level (default: 0.125) */
+    minZoom?: number;
+    /** Maximum allowed zoom level (default: 32) */
+    maxZoom?: number;
+}) => void | Promise<void>;
+
+/**
+ * Action function for zooming to the current page with optional padding
+ * @public
+ */
+export declare type ZoomToPageAction = (options?: {
+    /** Padding configuration around the block */
+    padding?: number | {
+        x?: number;
+        y?: number;
+    } | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    };
+    /** Animation configuration - boolean for default animation or object for custom settings */
+    animate?: boolean | {
+        /** Duration of the animation in seconds */
+        duration?: number;
+        /** Easing function for the animation */
+        easing?: 'Linear' | 'EaseIn' | 'EaseOut' | 'EaseInOut';
+        /** Whether the animation can be interrupted */
+        interruptible?: boolean;
+    };
+    /** Whether to enable auto-fit mode after zooming (default: false) */
+    autoFit?: boolean;
+}) => Promise<void>;
+
+/**
+ * Action function for zooming to the current selection
+ * @public
+ */
+export declare type ZoomToSelectionAction = (options?: {
+    /** Padding configuration around the block */
+    padding?: number | {
+        x?: number;
+        y?: number;
+    } | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    };
+    /** Animation configuration - boolean for default animation or object for custom settings */
+    animate?: boolean | {
+        /** Duration of the animation in seconds */
+        duration?: number;
+        /** Easing function for the animation */
+        easing?: 'Linear' | 'EaseIn' | 'EaseOut' | 'EaseInOut';
+        /** Whether the animation can be interrupted */
+        interruptible?: boolean;
+    };
+    /** Whether to enable auto-fit mode after zooming (default: false) */
+    autoFit?: boolean;
+}) => Promise<void>;
+
 export { }