@imgly/codesign-mcp 0.1.2 → 0.1.5

package/assets/docs/api/index.d.ts

@@ -103,7 +103,7 @@ export declare type AnimationEntry = {
 export declare type AnimationGrowDirection = (typeof AnimationGrowDirectionValues)[number];
 
 /** @public */
-export declare const AnimationGrowDirectionValues: readonly ["Horizontal", "Vertical", "TopLeft", "TopRight", "BottomLeft", "BottomRight", "All"];
+export declare const AnimationGrowDirectionValues: readonly ["Horizontal", "Vertical", "All", "TopLeft", "TopRight", "BottomLeft", "BottomRight"];
 
 /** @public */
 export declare type AnimationJumpLoopDirection = (typeof AnimationJumpLoopDirectionValues)[number];
@@ -136,12 +136,6 @@ export declare type AnimationOptions = {
     out?: AnimationEntry;
 };
 
-/** @public */
-export declare type AnimationScaleLoopDirection = (typeof AnimationScaleLoopDirectionValues)[number];
-
-/** @public */
-export declare const AnimationScaleLoopDirectionValues: readonly ["Horizontal", "Vertical", "TopLeft", "TopRight", "BottomLeft", "BottomRight", "All"];
-
 /** @public */
 export declare type AnimationSpinDirection = (typeof AnimationSpinDirectionValues)[number];
 
@@ -1028,6 +1022,8 @@ export declare interface AssetPayload {
     typeface?: Typeface;
     transformPreset?: AssetTransformPreset;
     properties?: AssetProperty[];
+    /** A declarative style preset the engine applies to text/caption blocks. */
+    stylePreset?: AssetStylePreset;
 }
 
 /**
@@ -1317,6 +1313,166 @@ export declare interface AssetStringProperty {
     defaultValue: string;
 }
 
+/**
+ * A declarative style preset the engine applies to text and caption blocks. The engine parses and
+ * applies it identically on every platform. Lives in {@link AssetPayload.stylePreset}.
+ *
+ * Most of the look is in {@link AssetStylePreset.properties}; the other fields cover the font,
+ * size-relative scaling and animations.
+ * @public
+ */
+export declare interface AssetStylePreset {
+    /**
+     * The block type this preset is for. Used as the type to create when the preset is applied with no
+     * target block, and as the apply filter (it only restyles a block of this type). Omitted applies to any
+     * block. Style presets target text and caption blocks; the value is the longhand id, which the engine
+     * matches against the block's `getType()`.
+     */
+    blockType?: '//ly.img.ubq/text' | '//ly.img.ubq/caption';
+    /**
+     * How the preset combines with the block's current look. `'replace'` (the default) also clears the
+     * decorations and animations the preset omits, so switching presets never stacks; `'merge'` layers
+     * the preset on top, keeping everything it does not set. Either way the block's text content is never
+     * touched, and its size only changes when the preset asks for it (`fontSize.resizeExistingOnApply`,
+     * or a `text/path` baseline adopting its bounding box).
+     */
+    mode?: 'replace' | 'merge';
+    /**
+     * Font to apply. The engine resolves `family` against the registered typefaces and matches
+     * `weight`/`style`. Ignored when the family is empty or not registered.
+     */
+    typeface?: {
+        family: string;
+        weight?: FontWeight;
+        style?: FontStyle;
+    };
+    /**
+     * Scene-relative font size. `scale` is a unitless multiplier on the scene's base font size (1 = the
+     * base size), sizing a block created from the preset. With `resizeExistingOnApply: true` the same size
+     * also resizes an existing block on apply. For an absolute size, set `properties['text/fontSize']`
+     * instead (it takes precedence).
+     */
+    fontSize?: {
+        scale: number;
+        resizeExistingOnApply?: boolean;
+    };
+    /**
+     * Lengths that scale with the block's font size. Each entry sets its `property` to `ratio × fontSize`
+     * — e.g. `{ property: 'stroke/width', ratio: 0.012 }` makes the stroke width `0.012 × fontSize`. Keeps
+     * a preset's stroke width, drop-shadow offset/blur, … proportional at any size.
+     */
+    scaleWithFontSize?: Array<{
+        property: AssetStylePresetScalableProperty;
+        ratio: number;
+    }>;
+    /**
+     * The bulk of the look: typography plus the `fill/*`, `stroke/*`, `dropShadow/*` and
+     * `backgroundColor/*` decorations with their `…/enabled` toggles. Known paths are value-checked and
+     * autocomplete. See {@link AssetStylePresetProperties}.
+     */
+    properties?: AssetStylePresetProperties;
+    /** Entrance animation. */
+    inAnimation?: AssetStylePresetAnimation;
+    /** Exit animation. */
+    outAnimation?: AssetStylePresetAnimation;
+    /** Looping animation. */
+    loopAnimation?: AssetStylePresetAnimation;
+}
+
+/**
+ * An animation slot of an {@link AssetStylePreset} (`inAnimation`, `outAnimation` or `loopAnimation`).
+ * @public
+ */
+export declare interface AssetStylePresetAnimation {
+    /** The animation block type to apply, e.g. `'//ly.img.ubq/animation/slide'`. */
+    type: AnimationTypeLonghand;
+    /** Configures the animation as a map of its property paths to values. */
+    properties?: AssetStylePresetAnimationProperties;
+}
+
+/**
+ * The parameters of an {@link AssetStylePresetAnimation}: a map of the animation's property paths to
+ * values. The animation's `animation/*` properties (e.g. `animation/slide/fade`,
+ * `animation/grow/scaleFactor`) are value-checked and autocomplete, as are the animation controls
+ * (`playback/duration`, `animationEasing`, `textWritingStyle`, `textWritingOverlap`); any other
+ * property path is still accepted. These are animation paths, distinct from the block-property paths
+ * in {@link AssetStylePresetProperties}.
+ * @public
+ */
+export declare type AssetStylePresetAnimationProperties = {
+    [K in Extract<BoolPropertyName, `animation/${string}`>]?: boolean;
+} & {
+    [K in Extract<EnumPropertyName, `animation/${string}`>]?: string;
+} & {
+    [K in Extract<FloatPropertyName, `animation/${string}`>]?: number;
+} & {
+    [K in Extract<ColorPropertyName, `animation/${string}`>]?: RGBColor | RGBAColor;
+} & {
+    /** Animation controls applied outside the `animation/*` properties. */
+    'playback/duration'?: number;
+    animationEasing?: string;
+    textWritingStyle?: string;
+    textWritingOverlap?: number;
+} & {
+    [path: string]: AssetStylePresetPropertyValue;
+};
+
+/**
+ * The look of an {@link AssetStylePreset}: a map of property paths to values. Known paths are
+ * value-checked and autocomplete (e.g. `stroke/enabled` must be a boolean, `stroke/width` a number,
+ * `fill/solid/color` a color); any other property path is still accepted with the broader
+ * {@link AssetStylePresetPropertyValue}. Keys without a `/` are namespaced to the block (`text/` or
+ * `caption/`); keys with a `/` are used verbatim.
+ * @public
+ */
+export declare type AssetStylePresetProperties = {
+    [K in BoolPropertyName as string extends K ? never : K]?: boolean;
+} & {
+    [K in IntPropertyName as string extends K ? never : K]?: number;
+} & {
+    [K in FloatPropertyName as string extends K ? never : K]?: number;
+} & {
+    [K in DoublePropertyName as string extends K ? never : K]?: number;
+} & {
+    [K in StringPropertyName as string extends K ? never : K]?: string;
+} & {
+    [K in EnumPropertyName as string extends K ? never : K]?: string;
+} & {
+    [K in ColorPropertyName as string extends K ? never : K]?: RGBColor | RGBAColor;
+} & {
+    /**
+     * The text-on-path baseline (see `setTextOnPath`): a single-subpath SVG path string in the block's
+     * local coordinate space wraps the block's text on the path and resizes the block to the path's
+     * bounding box; an explicit `null` clears the path and restores normal layout. This is a virtual
+     * preset property — the baseline path is not a reflected block property, so the engine routes it
+     * through `setTextOnPath`, inheriting its validation. Pair it with `text/pathOffset` and
+     * `text/pathFlipped` (plain reflected properties) to fully define the path state. Which curve is
+     * applied is identified by the path value itself — compare `getTextOnPath` against an entry's
+     * `text/path`.
+     */
+    'text/path'?: string | null;
+} & {
+    [path: string]: AssetStylePresetPropertyValue;
+};
+
+/**
+ * A value a style preset can set on a property: a boolean, number, string (including enum values) or
+ * an RGB(A) color. Colors must be RGB(A) (`{ r, g, b, a? }`); CMYK and spot colors are not supported in
+ * presets. Structs and source sets cannot be set from a preset. A `null` value is ignored for regular
+ * properties; for the virtual `text/path` property it clears the baseline path.
+ * @public
+ */
+export declare type AssetStylePresetPropertyValue = boolean | number | string | RGBColor | RGBAColor | null;
+
+/**
+ * A length property a style preset may scale with the block's font size (see
+ * {@link AssetStylePreset.scaleWithFontSize}). Restricted to the decoration lengths for which scaling is
+ * meaningful — stroke width, drop-shadow offset/blur and the caption background corner radius — not
+ * arbitrary numeric properties like `rotation` or `opacity`.
+ * @public
+ */
+export declare type AssetStylePresetScalableProperty = 'stroke/width' | 'dropShadow/offset/x' | 'dropShadow/offset/y' | 'dropShadow/blurRadius/x' | 'dropShadow/blurRadius/y' | 'backgroundColor/cornerRadius';
+
 /**
  * Transform preset payload
  * @public
@@ -5103,6 +5259,22 @@ export declare class BlockAPI {
      * @returns The unique typefaces in the range.
      */
     getTypefaces(id: DesignBlockId, from?: number, to?: number): Typeface[];
+    /**
+     * Gets all text runs within a range of text.
+     *
+     * Each run represents a contiguous span of text with uniform formatting.
+     *
+     * ```javascript
+     * const runs = engine.block.getTextRuns(text);
+     * ```
+     *
+     * @category Block Text
+     * @param id - The text block to query.
+     * @param from - The start index of the UTF-16 range. Defaults to the start of the current selection or text.
+     * @param to - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
+     * @returns The ordered list of text runs covering the requested range.
+     */
+    getTextRuns(id: DesignBlockId, from?: number, to?: number): TextRunInfo[];
     /**
      * Gets the current text cursor or selection range.
      *
@@ -5185,6 +5357,56 @@ export declare class BlockAPI {
      * @returns The effective alignment ('Left', 'Right', or 'Center').
      */
     getTextEffectiveHorizontalAlignment(id: DesignBlockId): 'Left' | 'Right' | 'Center';
+    /**
+     * Sets the SVG path that the text baseline follows.
+     * Pass `null` to restore normal straight-line text layout.
+     *
+     * @category Block Text
+     * @param id - The text block to modify.
+     * @param svgPath - An SVG path string in the block's local coordinate space, or `null` to clear.
+     */
+    setTextOnPath(id: DesignBlockId, svgPath: string | null): void;
+    /**
+     * Gets the SVG path currently used as the text baseline.
+     *
+     * @category Block Text
+     * @param id - The text block to query.
+     * @returns The SVG path string, or `null` if no path is set.
+     */
+    getTextOnPath(id: DesignBlockId): string | null;
+    /**
+     * Sets the start offset along the baseline path as a proportion of the path length.
+     * Values are clamped to `[-1, 1]`; `1` and `-1` wrap back to the path start.
+     *
+     * @category Block Text
+     * @param id - The text block to modify.
+     * @param offset - The proportional offset. Positive values move the text forward along the path.
+     */
+    setTextOnPathOffset(id: DesignBlockId, offset: number): void;
+    /**
+     * Gets the start offset along the baseline path as a proportion of the path length.
+     *
+     * @category Block Text
+     * @param id - The text block to query.
+     * @returns The proportional offset in `[-1, 1]`.
+     */
+    getTextOnPathOffset(id: DesignBlockId): number;
+    /**
+     * Sets whether text is placed on the opposite side of the baseline path.
+     *
+     * @category Block Text
+     * @param id - The text block to modify.
+     * @param flipped - When `true`, text sits on the underside of the curve and reads in the reverse direction.
+     */
+    setTextOnPathFlipped(id: DesignBlockId, flipped: boolean): void;
+    /**
+     * Gets whether the text-on-path rendering is flipped.
+     *
+     * @category Block Text
+     * @param id - The text block to query.
+     * @returns `true` when text is on the underside of the curve.
+     */
+    getTextOnPathFlipped(id: DesignBlockId): boolean;
     /**
      * Checks if a block has fill properties.
      *
@@ -6189,18 +6411,25 @@ export declare class BlockAPI {
 /** @public */
 export declare type BlockEnumType = {
     'blend/mode': BlendMode;
+    'contentFill/horizontalAlignment': HorizontalContentFillAlignment;
     'contentFill/mode': ContentFillMode;
+    'contentFill/verticalAlignment': VerticalContentFillAlignment;
     'height/mode': HeightMode;
-    'page/guides/source': PageGuidesSource;
     'position/x/mode': PositionXMode;
     'position/y/mode': PositionYMode;
     'scene/designUnit': SceneDesignUnit;
+    'scene/fontSizeUnit': SceneFontSizeUnit;
     'scene/layout': SceneLayout;
     'scene/mode': SceneMode;
     'width/mode': WidthMode;
+    'page/guides/source': PageGuidesSource;
     'stroke/cap': StrokeCap;
     'stroke/cornerGeometry': StrokeCornerGeometry;
+    'stroke/dashEndCap': StrokeDashEndCap;
+    'stroke/dashStartCap': StrokeDashStartCap;
+    'stroke/endCap': StrokeEndCap;
     'stroke/position': StrokePosition;
+    'stroke/startCap': StrokeStartCap;
     'stroke/style': StrokeStyle;
     'text/horizontalAlignment': TextHorizontalAlignment;
     'text/verticalAlignment': TextVerticalAlignment;
@@ -6219,7 +6448,6 @@ export declare type BlockEnumType = {
     'animation/block_swipe_text/direction': AnimationBlockSwipeTextDirection;
     'animation/merge_text/direction': AnimationMergeTextDirection;
     'animation/ken_burns/direction': AnimationKenBurnsDirection;
-    'animation/scale_loop/direction': AnimationScaleLoopDirection;
     'fill/pixelStream/orientation': FillPixelStreamOrientation;
     'shape/vector_path/fillRule': ShapeVectorPathFillRule;
 };
@@ -6328,7 +6556,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' | 'selectionEnabled' | 'transformLocked' | 'visible' | 'blur/enabled' | 'dropShadow/clip' | 'dropShadow/enabled' | 'fill/enabled' | 'page/guides/gridEnabled' | 'page/guides/gridSnapEnabled' | 'page/marginEnabled' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'playback/looping' | 'playback/muted' | 'stroke/enabled' | 'backgroundColor/enabled' | 'placeholderBehavior/enabled' | 'text/automaticFontSizeEnabled' | 'text/clipLinesOutsideOfFrame' | 'text/hasClippedLines' | 'text/useLigatures' | 'text/useKerning' | 'text/useContextualLigatures' | 'text/useDiscretionaryLigatures' | 'track/automaticallyManageBlockOffsets' | 'caption/automaticFontSizeEnabled' | 'caption/clipLinesOutsideOfFrame' | 'caption/hasClippedLines' | 'caption/useLigatures' | 'caption/useKerning' | 'caption/useContextualLigatures' | 'caption/useDiscretionaryLigatures' | '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' | 'scene/extendedPanningArea' | 'selected' | 'selectionEnabled' | 'transformLocked' | 'visible' | 'blur/enabled' | 'dropShadow/clip' | 'dropShadow/enabled' | 'fill/enabled' | 'fill/overprint' | 'page/guides/gridEnabled' | 'page/guides/gridSnapEnabled' | 'page/marginEnabled' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'playback/looping' | 'playback/muted' | 'stroke/enabled' | 'stroke/overprint' | 'backgroundColor/enabled' | 'placeholderBehavior/enabled' | 'text/automaticFontSizeEnabled' | 'text/clipLinesOutsideOfFrame' | 'text/hasClippedLines' | 'text/pathFlipped' | 'text/useContextualLigatures' | 'text/useDiscretionaryLigatures' | 'text/useKerning' | 'text/useLigatures' | 'track/automaticallyManageBlockOffsets' | 'caption/automaticFontSizeEnabled' | 'caption/clipLinesOutsideOfFrame' | 'caption/hasClippedLines' | 'caption/pathFlipped' | 'caption/useContextualLigatures' | 'caption/useDiscretionaryLigatures' | 'caption/useKerning' | 'caption/useLigatures' | '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.
@@ -6549,6 +6777,30 @@ export declare type ContentFillMode = (typeof ContentFillModeValues)[number];
 /** @public */
 export declare const ContentFillModeValues: readonly ["Crop", "Cover", "Contain"];
 
+/** @public */
+export declare type ControlGizmoMoveHandleVisibility = (typeof ControlGizmoMoveHandleVisibilityValues)[number];
+
+/** @public */
+export declare const ControlGizmoMoveHandleVisibilityValues: readonly ["auto", "always", "never"];
+
+/** @public */
+export declare type ControlGizmoResizeHandlesVisibility = (typeof ControlGizmoResizeHandlesVisibilityValues)[number];
+
+/** @public */
+export declare const ControlGizmoResizeHandlesVisibilityValues: readonly ["auto", "always", "never"];
+
+/** @public */
+export declare type ControlGizmoRotateHandlesVisibility = (typeof ControlGizmoRotateHandlesVisibilityValues)[number];
+
+/** @public */
+export declare const ControlGizmoRotateHandlesVisibilityValues: readonly ["auto", "always", "never"];
+
+/** @public */
+export declare type ControlGizmoScaleHandlesVisibility = (typeof ControlGizmoScaleHandlesVisibilityValues)[number];
+
+/** @public */
+export declare const ControlGizmoScaleHandlesVisibilityValues: readonly ["auto", "always", "never"];
+
 /**
  * Options for creating a video scene.
  * @public
@@ -6594,6 +6846,12 @@ declare class CreativeEngine {
     event: EventAPI;
     scene: SceneAPI;
     variable: VariableAPI;
+    /**
+     * Register, run, and discover named, overridable actions. On headless Node the registry
+     * starts with only the engine-default `ly.img.*` actions (no host UI), but the API is
+     * identical to the browser engine.
+     */
+    actions: EngineActions;
     version: string;
 
     /**
@@ -6829,7 +7087,7 @@ export declare type DoubleClickSelectionMode = (typeof DoubleClickSelectionModeV
 export declare const DoubleClickSelectionModeValues: readonly ["Direct", "Hierarchical"];
 
 /** @public */
-export declare type DoublePropertyName = 'playback/time' | 'playback/duration' | 'playback/timeOffset' | 'audio/totalDuration' | 'playback/trimLength' | 'playback/trimOffset' | 'fill/video/totalDuration' | 'animation/scale_loop/startDelay' | 'animation/scale_loop/holdDuration' | 'animation/scale_loop/easingDuration' | (string & {});
+export declare type DoublePropertyName = 'playback/time' | 'playback/duration' | 'playback/timeOffset' | 'audio/totalDuration' | 'playback/trimLength' | 'playback/trimOffset' | 'fill/video/totalDuration' | (string & {});
 
 /**
  * Information about a single audio track from a video.
@@ -8009,6 +8267,97 @@ export declare type EffectTypeLonghand = `//ly.img.ubq/effect/${EffectTypeShorth
 /** @public */
 export declare type EffectTypeShorthand = (typeof EFFECT_TYPES)[number];
 
+/** @public Known action ids from {@link EngineActionsRegistry}. */
+export declare type EngineActionId = keyof EngineActionsRegistry & string;
+
+/** @public Info about a registered action, from {@link EngineActions.list}. */
+export declare interface EngineActionInfo {
+    /** The action id, e.g. `nudge`. */
+    id: string;
+    /** Whether the action currently says it can run. */
+    enabled: boolean;
+    /** Optional JSON description of the arguments it accepts. */
+    argSchema: string | null;
+}
+
+/**
+ * @public Named, overridable actions for one engine. Actions are either JS
+ * closures you register or engine defaults (e.g. undo/redo), and
+ * either kind can override the other by reusing the id.
+ *
+ * JS-registered actions run directly in JS, so on the web you get full fidelity:
+ * {@link get} hands back the raw function and {@link run} passes args/results by
+ * reference (non-serializable payloads like File/Blob work). The engine also keeps
+ * a JSON trampoline per action so defaults run natively and host actions stay
+ * reachable across the FFI — that path is JSON-only and async. Engine defaults you
+ * have not overridden are reachable only via {@link run}; {@link get} returns undefined.
+ *
+ * @remarks Main-thread only. {@link get} is web-only; use run/has/list cross-platform.
+ */
+export declare class EngineActions {
+    #private;
+
+    /**
+     * Register an action, replacing any existing one with the same id.
+     *
+     * @param id - The action id (e.g. `undo`). Reusing an engine default's id overrides it.
+     * @param fn - The action body (sync or async). On the web it runs directly with
+     *   any JS values. Across the FFI args/results are JSON, so only serializable
+     *   payloads work there.
+     */
+    register<K extends EngineActionId>(id: K, fn: EngineActionsRegistry[K] extends (...args: any[]) => any ? EngineActionsRegistry[K] : EngineCustomActionFunction): void;
+    register(id: string, fn: EngineCustomActionFunction): void;
+    /**
+     * Get the raw registered function for an id so you can call it synchronously.
+     *
+     * Returns the exact function you registered. Returns `undefined` for unknown ids
+     * and engine-default native actions (which have no JS function) — use {@link run}
+     * for those.
+     *
+     * @remarks Web-only.
+     */
+    get<K extends EngineActionId>(id: K): EngineActionsRegistry[K] | undefined;
+    get(id: string): EngineCustomActionFunction | undefined;
+    /**
+     * Run an action by id and return its result as a Promise.
+     *
+     * JS-registered actions are called directly (args/result by reference). Engine
+     * defaults go across the FFI (JSON args/result).
+     *
+     * @param id - The action id.
+     * @param args - Arguments forwarded to the action.
+     * @returns The action's result, or a rejection if the id is unknown or it threw.
+     */
+    run<K extends EngineActionId>(id: K, ...args: EngineActionsRegistry[K] extends (...args: infer A) => any ? A : unknown[]): Promise<EngineActionsRegistry[K] extends (...args: any[]) => infer R ? Awaited<R> : unknown>;
+    run<R = unknown>(id: string, ...args: unknown[]): Promise<R>;
+    /** Whether an action with this id is registered (host or engine default). */
+    has(id: string): boolean;
+    /**
+     * Remove a host action, or revert an overridden engine default to its built-in.
+     *
+     * If you override an engine default (such as `select` or `undo`), unregistering the id restores
+     * the default rather than leaving it unhandled. A custom id you registered yourself is removed
+     * entirely. Returns `false` only when the id is unknown.
+     */
+    unregister(id: string): boolean;
+    /** List registered actions, optionally filtered by a `*` glob matcher on the id. */
+    list(options?: {
+        matcher?: string;
+    }): EngineActionInfo[];
+
+}
+
+/**
+ * @public Hook for hosts to add strongly-typed action ids. Augment via
+ * `declare module '@cesdk/engine'` to get autocomplete on register/run while
+ * still allowing custom string ids.
+ */
+export declare interface EngineActionsRegistry {
+}
+
+/** @public A generic, untyped action function for custom ids. */
+export declare type EngineCustomActionFunction = (...args: any[]) => unknown;
+
 /**
  * Represents an engine plugin.
  *
@@ -8038,10 +8387,10 @@ export declare type EnginePluginContext = {
 };
 
 /** @public */
-export declare type EnumPropertyName = 'blend/mode' | 'contentFill/mode' | 'height/mode' | 'position/x/mode' | 'position/y/mode' | 'scene/designUnit' | 'scene/layout' | 'scene/mode' | 'width/mode' | 'page/guides/source' | 'stroke/cornerGeometry' | 'stroke/position' | 'stroke/style' | 'text/horizontalAlignment' | 'text/verticalAlignment' | 'cutout/type' | 'caption/horizontalAlignment' | 'caption/verticalAlignment' | 'animationEasing' | 'textAnimationWritingStyle' | 'animation/grow/direction' | 'animation/wipe/direction' | 'animation/baseline/direction' | 'animation/spin/direction' | 'animation/spin_loop/direction' | 'animation/jump_loop/direction' | 'animation/typewriter_text/writingStyle' | 'animation/block_swipe_text/direction' | 'animation/merge_text/direction' | 'animation/ken_burns/direction' | 'animation/scale_loop/direction' | 'fill/pixelStream/orientation' | 'shape/vector_path/fillRule' | (string & {});
+export declare type EnumPropertyName = 'blend/mode' | 'contentFill/horizontalAlignment' | 'contentFill/mode' | 'contentFill/verticalAlignment' | 'height/mode' | 'position/x/mode' | 'position/y/mode' | 'scene/designUnit' | 'scene/fontSizeUnit' | 'scene/layout' | 'scene/mode' | 'width/mode' | 'page/guides/source' | 'stroke/cap' | 'stroke/cornerGeometry' | 'stroke/dashEndCap' | 'stroke/dashStartCap' | 'stroke/endCap' | 'stroke/position' | 'stroke/startCap' | 'stroke/style' | 'text/horizontalAlignment' | 'text/verticalAlignment' | 'cutout/type' | 'caption/horizontalAlignment' | 'caption/verticalAlignment' | 'animationEasing' | 'textAnimationWritingStyle' | 'animation/grow/direction' | 'animation/wipe/direction' | 'animation/baseline/direction' | 'animation/spin/direction' | 'animation/spin_loop/direction' | 'animation/jump_loop/direction' | 'animation/typewriter_text/writingStyle' | 'animation/block_swipe_text/direction' | 'animation/merge_text/direction' | 'animation/ken_burns/direction' | 'fill/pixelStream/orientation' | 'shape/vector_path/fillRule' | (string & {});
 
 /** @public */
-export declare type EnumValues = BlendMode | ContentFillMode | HeightMode | PageGuidesSource | PositionXMode | PositionYMode | SceneDesignUnit | SceneLayout | SceneMode | WidthMode | StrokeCap | StrokeCornerGeometry | StrokePosition | StrokeStyle | TextHorizontalAlignment | TextVerticalAlignment | CutoutType | CaptionHorizontalAlignment | CaptionVerticalAlignment | AnimationEasing | TextAnimationWritingStyle | AnimationGrowDirection | AnimationWipeDirection | AnimationBaselineDirection | AnimationSpinDirection | AnimationSpinLoopDirection | AnimationJumpLoopDirection | AnimationTypewriterTextWritingStyle | AnimationBlockSwipeTextDirection | AnimationMergeTextDirection | AnimationKenBurnsDirection | AnimationScaleLoopDirection | FillPixelStreamOrientation | ShapeVectorPathFillRule | (string & {});
+export declare type EnumValues = BlendMode | HorizontalContentFillAlignment | ContentFillMode | VerticalContentFillAlignment | HeightMode | PositionXMode | PositionYMode | SceneDesignUnit | SceneFontSizeUnit | SceneLayout | SceneMode | WidthMode | PageGuidesSource | StrokeCap | StrokeCornerGeometry | StrokeDashEndCap | StrokeDashStartCap | StrokeEndCap | StrokePosition | StrokeStartCap | StrokeStyle | TextHorizontalAlignment | TextVerticalAlignment | CutoutType | CaptionHorizontalAlignment | CaptionVerticalAlignment | AnimationEasing | TextAnimationWritingStyle | AnimationGrowDirection | AnimationWipeDirection | AnimationBaselineDirection | AnimationSpinDirection | AnimationSpinLoopDirection | AnimationJumpLoopDirection | AnimationTypewriterTextWritingStyle | AnimationBlockSwipeTextDirection | AnimationMergeTextDirection | AnimationKenBurnsDirection | FillPixelStreamOrientation | ShapeVectorPathFillRule | (string & {});
 
 /**
  * @public Subscribe to block lifecycle events in the design engine.
@@ -8268,7 +8617,7 @@ declare interface Flip {
 }
 
 /** @public */
-export declare type FloatPropertyName = 'globalBoundingBox/height' | 'globalBoundingBox/width' | 'globalBoundingBox/x' | 'globalBoundingBox/y' | 'height' | 'lastFrame/height' | 'lastFrame/width' | 'lastFrame/x' | 'lastFrame/y' | 'position/x' | 'position/y' | 'rotation' | 'scene/dpi' | 'scene/pageDimensions/height' | 'scene/pageDimensions/width' | 'scene/pixelScaleFactor' | 'width' | 'camera/pixelRatio' | 'camera/resolution/height' | 'camera/resolution/width' | 'camera/zoomLevel' | 'dropShadow/blurRadius/x' | 'dropShadow/blurRadius/y' | 'dropShadow/offset/x' | 'dropShadow/offset/y' | 'page/guides/gridSpacingX' | 'page/guides/gridSpacingY' | 'page/margin/bottom' | 'page/margin/left' | 'page/margin/right' | 'page/margin/top' | 'playback/speed' | 'playback/volume' | 'stroke/width' | 'opacity' | 'backgroundColor/cornerRadius' | 'backgroundColor/paddingBottom' | 'backgroundColor/paddingLeft' | 'backgroundColor/paddingRight' | 'backgroundColor/paddingTop' | 'text/fontSize' | 'text/letterSpacing' | 'text/lineHeight' | 'text/maxAutomaticFontSize' | 'text/minAutomaticFontSize' | 'text/paragraphSpacing' | 'cutout/offset' | 'cutout/smoothing' | 'caption/fontSize' | 'caption/letterSpacing' | 'caption/lineHeight' | 'caption/maxAutomaticFontSize' | 'caption/minAutomaticFontSize' | 'caption/paragraphSpacing' | 'animation/slide/direction' | 'textAnimationOverlap' | 'animation/pan/direction' | 'animation/pan/distance' | 'animation/blur/intensity' | 'animation/grow/scaleFactor' | 'animation/crop_zoom/scale' | 'animation/spin/intensity' | 'animation/blur_loop/intensity' | 'animation/pulsating_loop/intensity' | 'animation/breathing_loop/intensity' | 'animation/jump_loop/intensity' | 'animation/sway_loop/intensity' | 'animation/scale_loop/startScale' | 'animation/scale_loop/endScale' | 'animation/spread_text/intensity' | 'animation/merge_text/intensity' | 'animation/ken_burns/travelDistanceRatio' | 'animation/ken_burns/zoomIntensity' | 'blur/uniform/intensity' | 'blur/linear/blurRadius' | 'blur/linear/x1' | 'blur/linear/x2' | 'blur/linear/y1' | 'blur/linear/y2' | 'blur/mirrored/blurRadius' | 'blur/mirrored/gradientSize' | 'blur/mirrored/size' | 'blur/mirrored/x1' | 'blur/mirrored/x2' | 'blur/mirrored/y1' | 'blur/mirrored/y2' | 'blur/radial/blurRadius' | 'blur/radial/gradientRadius' | 'blur/radial/radius' | 'blur/radial/x' | 'blur/radial/y' | 'effect/adjustments/blacks' | 'effect/adjustments/brightness' | 'effect/adjustments/clarity' | 'effect/adjustments/contrast' | 'effect/adjustments/exposure' | 'effect/adjustments/gamma' | 'effect/adjustments/highlights' | 'effect/adjustments/saturation' | 'effect/adjustments/shadows' | 'effect/adjustments/sharpness' | 'effect/adjustments/temperature' | 'effect/adjustments/whites' | 'effect/cross_cut/offset' | 'effect/cross_cut/slices' | 'effect/cross_cut/speedV' | 'effect/cross_cut/time' | 'effect/dot_pattern/blur' | 'effect/dot_pattern/dots' | 'effect/dot_pattern/size' | 'effect/duotone_filter/intensity' | 'effect/extrude_blur/amount' | 'effect/glow/amount' | 'effect/glow/darkness' | 'effect/glow/size' | 'effect/green_screen/colorMatch' | 'effect/green_screen/smoothness' | 'effect/green_screen/spill' | 'effect/half_tone/angle' | 'effect/half_tone/scale' | 'effect/linocut/scale' | 'effect/liquid/amount' | 'effect/liquid/scale' | 'effect/liquid/time' | 'effect/lut_filter/intensity' | 'effect/outliner/amount' | 'effect/outliner/passthrough' | 'effect/posterize/levels' | 'effect/radial_pixel/radius' | 'effect/radial_pixel/segments' | 'effect/recolor/brightnessMatch' | 'effect/recolor/colorMatch' | 'effect/recolor/smoothness' | 'effect/shifter/amount' | 'effect/shifter/angle' | 'effect/tilt_shift/amount' | 'effect/tilt_shift/position' | 'effect/tv_glitch/distortion' | 'effect/tv_glitch/distortion2' | 'effect/tv_glitch/rollSpeed' | 'effect/tv_glitch/speed' | 'effect/vignette/darkness' | 'effect/vignette/offset' | 'fill/gradient/linear/endPointX' | 'fill/gradient/linear/endPointY' | 'fill/gradient/linear/startPointX' | 'fill/gradient/linear/startPointY' | 'fill/gradient/radial/centerPointX' | 'fill/gradient/radial/centerPointY' | 'fill/gradient/radial/radius' | 'fill/gradient/conical/centerPointX' | 'fill/gradient/conical/centerPointY' | 'shape/rect/cornerRadiusBL' | 'shape/rect/cornerRadiusBR' | 'shape/rect/cornerRadiusTL' | 'shape/rect/cornerRadiusTR' | 'shape/polygon/cornerRadius' | 'shape/star/innerDiameter' | 'shape/vector_path/cornerRadius' | 'shape/vector_path/height' | 'shape/vector_path/width' | (string & {});
+export declare type FloatPropertyName = 'globalBoundingBox/height' | 'globalBoundingBox/width' | 'globalBoundingBox/x' | 'globalBoundingBox/y' | 'height' | 'lastFrame/height' | 'lastFrame/width' | 'lastFrame/x' | 'lastFrame/y' | 'movement/constraint' | 'position/x' | 'position/y' | 'rotation' | 'scene/dpi' | 'scene/pageDimensions/height' | 'scene/pageDimensions/width' | 'scene/pixelScaleFactor' | 'width' | 'camera/pixelRatio' | 'camera/resolution/height' | 'camera/resolution/width' | 'camera/zoomLevel' | 'dropShadow/blurRadius/x' | 'dropShadow/blurRadius/y' | 'dropShadow/offset/x' | 'dropShadow/offset/y' | 'page/guides/gridSpacingX' | 'page/guides/gridSpacingY' | 'page/margin/bottom' | 'page/margin/left' | 'page/margin/right' | 'page/margin/top' | 'page/marginScale' | 'playback/speed' | 'playback/volume' | 'stroke/dashOffset' | 'stroke/width' | 'opacity' | 'backgroundColor/cornerRadius' | 'backgroundColor/paddingBottom' | 'backgroundColor/paddingLeft' | 'backgroundColor/paddingRight' | 'backgroundColor/paddingTop' | 'text/fontSize' | 'text/letterSpacing' | 'text/lineHeight' | 'text/maxAutomaticFontSize' | 'text/minAutomaticFontSize' | 'text/paragraphSpacing' | 'text/pathOffset' | 'cutout/offset' | 'cutout/smoothing' | 'caption/fontSize' | 'caption/letterSpacing' | 'caption/lineHeight' | 'caption/maxAutomaticFontSize' | 'caption/minAutomaticFontSize' | 'caption/paragraphSpacing' | 'caption/pathOffset' | 'animation/slide/direction' | 'textAnimationOverlap' | 'animation/pan/direction' | 'animation/pan/distance' | 'animation/blur/intensity' | 'animation/grow/scaleFactor' | 'animation/crop_zoom/scale' | 'animation/spin/intensity' | 'animation/blur_loop/intensity' | 'animation/pulsating_loop/intensity' | 'animation/breathing_loop/intensity' | 'animation/jump_loop/intensity' | 'animation/sway_loop/intensity' | 'animation/spread_text/intensity' | 'animation/merge_text/intensity' | 'animation/ken_burns/travelDistanceRatio' | 'animation/ken_burns/zoomIntensity' | 'blur/uniform/intensity' | 'blur/linear/blurRadius' | 'blur/linear/x1' | 'blur/linear/x2' | 'blur/linear/y1' | 'blur/linear/y2' | 'blur/mirrored/blurRadius' | 'blur/mirrored/gradientSize' | 'blur/mirrored/size' | 'blur/mirrored/x1' | 'blur/mirrored/x2' | 'blur/mirrored/y1' | 'blur/mirrored/y2' | 'blur/radial/blurRadius' | 'blur/radial/gradientRadius' | 'blur/radial/radius' | 'blur/radial/x' | 'blur/radial/y' | 'effect/adjustments/blacks' | 'effect/adjustments/brightness' | 'effect/adjustments/clarity' | 'effect/adjustments/contrast' | 'effect/adjustments/exposure' | 'effect/adjustments/gamma' | 'effect/adjustments/highlights' | 'effect/adjustments/saturation' | 'effect/adjustments/shadows' | 'effect/adjustments/sharpness' | 'effect/adjustments/temperature' | 'effect/adjustments/whites' | 'effect/cross_cut/offset' | 'effect/cross_cut/slices' | 'effect/cross_cut/speedV' | 'effect/cross_cut/time' | 'effect/dot_pattern/blur' | 'effect/dot_pattern/dots' | 'effect/dot_pattern/size' | 'effect/duotone_filter/intensity' | 'effect/extrude_blur/amount' | 'effect/glow/amount' | 'effect/glow/darkness' | 'effect/glow/size' | 'effect/green_screen/colorMatch' | 'effect/green_screen/smoothness' | 'effect/green_screen/spill' | 'effect/half_tone/angle' | 'effect/half_tone/scale' | 'effect/linocut/scale' | 'effect/liquid/amount' | 'effect/liquid/scale' | 'effect/liquid/time' | 'effect/lut_filter/intensity' | 'effect/outliner/amount' | 'effect/outliner/passthrough' | 'effect/posterize/levels' | 'effect/radial_pixel/radius' | 'effect/radial_pixel/segments' | 'effect/recolor/brightnessMatch' | 'effect/recolor/colorMatch' | 'effect/recolor/smoothness' | 'effect/shifter/amount' | 'effect/shifter/angle' | 'effect/tilt_shift/amount' | 'effect/tilt_shift/position' | 'effect/tv_glitch/distortion' | 'effect/tv_glitch/distortion2' | 'effect/tv_glitch/rollSpeed' | 'effect/tv_glitch/speed' | 'effect/vignette/darkness' | 'effect/vignette/offset' | 'fill/gradient/linear/endPointX' | 'fill/gradient/linear/endPointY' | 'fill/gradient/linear/startPointX' | 'fill/gradient/linear/startPointY' | 'fill/gradient/radial/centerPointX' | 'fill/gradient/radial/centerPointY' | 'fill/gradient/radial/radius' | 'fill/gradient/conical/centerPointX' | 'fill/gradient/conical/centerPointY' | 'shape/rect/cornerRadiusBL' | 'shape/rect/cornerRadiusBR' | 'shape/rect/cornerRadiusTL' | 'shape/rect/cornerRadiusTR' | 'shape/polygon/cornerRadius' | 'shape/star/cornerRadius' | 'shape/star/innerDiameter' | 'shape/vector_path/cornerRadius' | 'shape/vector_path/height' | 'shape/vector_path/width' | (string & {});
 
 /**
  * Individual font within a typeface. Field optionality matches `@cesdk/engine`
@@ -9470,10 +9819,10 @@ export declare type SceneLayout = (typeof SceneLayoutValues)[number];
 /** @public */
 export declare const SceneLayoutValues: readonly ["Free", "VerticalStack", "HorizontalStack", "DepthStack"];
 
-/** @public @deprecated Since v1.72. Scene mode no longer affects engine behavior. */
+/** @public */
 export declare type SceneMode = (typeof SceneModeValues)[number];
 
-/** @public @deprecated Since v1.72. Scene mode no longer affects engine behavior. */
+/** @public */
 export declare const SceneModeValues: readonly ["Design", "Video"];
 
 /**
@@ -9494,29 +9843,33 @@ export declare const SceneModeValues: readonly ["Design", "Video"];
 export declare type Scope = 'text/edit' | 'text/character' | 'fill/change' | 'fill/changeType' | 'stroke/change' | 'shape/change' | 'layer/move' | 'layer/resize' | 'layer/rotate' | 'layer/flip' | 'layer/crop' | 'layer/opacity' | 'layer/blendMode' | 'layer/visibility' | 'layer/clipping' | 'appearance/adjustments' | 'appearance/filter' | 'appearance/effect' | 'appearance/blur' | 'appearance/shadow' | 'appearance/animation' | 'lifecycle/destroy' | 'lifecycle/duplicate' | 'editor/add' | 'editor/select';
 
 /** @public */
-export declare type SettingBoolPropertyName = 'alwaysHighlightPlaceholders' | 'doubleClickToCropEnabled' | 'showBuildVersion' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'blockAnimations/enabled' | 'playback/showAllBlocks' | 'renderTextCursorAndSelectionInEngine' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning' | 'mouse/enableZoom' | 'mouse/enableScroll' | 'controlGizmo/showCropHandles' | 'controlGizmo/showMoveHandles' | 'controlGizmo/dynamicMoveHandleVisibility' | 'controlGizmo/showResizeHandles' | 'controlGizmo/showScaleHandles' | 'controlGizmo/showRotateHandles' | 'controlGizmo/showCropScaleHandles' | 'page/title/canEdit' | 'page/title/show' | 'page/title/showPageTitleTemplate' | 'page/title/appendPageName' | 'page/title/showOnSinglePage' | 'page/dimOutOfPageAreas' | 'page/allowCropInteraction' | 'page/allowResizeInteraction' | 'page/restrictResizeInteractionToFixedAspectRatio' | 'page/allowRotateInteraction' | 'page/allowMoveInteraction' | 'page/marqueeSelectOnBodyDrag' | 'page/restrictPageSelectionToBorderAndTitle' | 'page/moveChildrenWhenCroppingFill' | 'page/selectWhenNoBlocksSelected' | 'page/highlightWhenCropping' | 'page/highlightDropTarget' | 'page/reparentBlocksToSceneWhenOutOfPage' | 'colorMaskingSettings/secondPass' | 'clampThumbnailTextureSizes' | 'useSystemFontFallback' | 'forceSystemEmojis' | 'features/textEditModeTransformHandlesEnabled' | 'features/videoStreamingEnabled' | 'grid/enabled' | 'grid/snapEnabled' | 'features/enableAutomaticEnumerations' | 'features/transparentClickThroughEnabled' | 'features/fontLineGapEnabled' | (string & {});
+export declare type SettingBoolPropertyName = 'doubleClickToCropEnabled' | 'showBuildVersion' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'blockAnimations/enabled' | 'playback/showAllBlocks' | 'grid/enabled' | 'grid/snapEnabled' | 'archival/bundleOnlyUsedFontVariants' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning' | 'mouse/enableZoom' | 'mouse/enableScroll' | 'controlGizmo/showCropHandles' | 'controlGizmo/showMoveHandles' | 'controlGizmo/dynamicMoveHandleVisibility' | 'controlGizmo/showResizeHandles' | 'controlGizmo/showScaleHandles' | 'controlGizmo/showRotateHandles' | 'controlGizmo/showCropScaleHandles' | 'page/title/show' | 'page/title/showPageTitleTemplate' | 'page/title/appendPageName' | 'page/title/showOnSinglePage' | 'page/title/canEdit' | 'page/dimOutOfPageAreas' | 'page/allowCropInteraction' | 'page/allowResizeInteraction' | 'page/restrictResizeInteractionToFixedAspectRatio' | 'page/allowRotateInteraction' | 'page/allowMoveInteraction' | 'page/marqueeSelectOnBodyDrag' | 'page/restrictPageSelectionToBorderAndTitle' | 'page/moveChildrenWhenCroppingFill' | 'page/selectWhenNoBlocksSelected' | 'page/highlightWhenCropping' | 'page/allowShapeChange' | 'page/highlightDropTarget' | 'page/reparentBlocksToSceneWhenOutOfPage' | 'page/flipDimensionsOn90DegreeCropRotation' | 'clampThumbnailTextureSizes' | 'useSystemFontFallback' | 'forceSystemEmojis' | (string & {});
 
 /** @public */
-export declare type SettingColorPropertyName = 'clearColor' | 'handleFillColor' | 'highlightColor' | 'pageHighlightColor' | 'placeholderHighlightColor' | 'snappingGuideColor' | 'rotationSnappingGuideColor' | 'cropOverlayColor' | 'textVariableHighlightColor' | 'borderOutlineColor' | 'progressColor' | 'errorStateColor' | 'page/title/color' | 'page/marginFillColor' | 'page/marginFrameColor' | 'page/innerBorderColor' | 'page/outerBorderColor' | 'colorMaskingSettings/maskColor' | 'grid/color' | (string & {});
+export declare type SettingColorPropertyName = 'clearColor' | 'handleFillColor' | 'highlightColor' | 'pageHighlightColor' | 'placeholderHighlightColor' | 'snappingGuideColor' | 'rotationSnappingGuideColor' | 'cropOverlayColor' | 'textVariableHighlightColor' | 'borderOutlineColor' | 'progressColor' | 'errorStateColor' | 'grid/color' | 'page/title/color' | 'page/marginFillColor' | 'page/marginFrameColor' | 'page/innerBorderColor' | 'page/outerBorderColor' | 'colorMaskingSettings/maskColor' | (string & {});
 
 /** @public */
-export declare type SettingEnumPropertyName = 'touch/pinchAction' | 'touch/rotateAction' | 'camera/clamping/overshootMode' | 'doubleClickSelectionMode' | 'colorPicker/colorMode' | 'timeline/trackVisibility' | (string & {});
+export declare type SettingEnumPropertyName = 'touch/pinchAction' | 'touch/rotateAction' | 'camera/clamping/overshootMode' | 'controlGizmo/moveHandleVisibility' | 'controlGizmo/resizeHandlesVisibility' | 'controlGizmo/scaleHandlesVisibility' | 'controlGizmo/rotateHandlesVisibility' | 'doubleClickSelectionMode' | 'colorPicker/colorMode' | 'timeline/trackVisibility' | (string & {});
 
 /** @public */
 export declare type SettingEnumType = {
     'touch/pinchAction': TouchPinchAction;
     'touch/rotateAction': TouchRotateAction;
     'camera/clamping/overshootMode': CameraClampingOvershootMode;
+    'controlGizmo/moveHandleVisibility': ControlGizmoMoveHandleVisibility;
+    'controlGizmo/resizeHandlesVisibility': ControlGizmoResizeHandlesVisibility;
+    'controlGizmo/scaleHandlesVisibility': ControlGizmoScaleHandlesVisibility;
+    'controlGizmo/rotateHandlesVisibility': ControlGizmoRotateHandlesVisibility;
     doubleClickSelectionMode: DoubleClickSelectionMode;
     'colorPicker/colorMode': ColorPickerColorMode;
     'timeline/trackVisibility': TimelineTrackVisibility;
 };
 
 /** @public */
-export declare type SettingEnumValues = TouchPinchAction | TouchRotateAction | CameraClampingOvershootMode | DoubleClickSelectionMode | ColorPickerColorMode | TimelineTrackVisibility | (string & {});
+export declare type SettingEnumValues = TouchPinchAction | TouchRotateAction | CameraClampingOvershootMode | ControlGizmoMoveHandleVisibility | ControlGizmoResizeHandlesVisibility | ControlGizmoScaleHandlesVisibility | ControlGizmoRotateHandlesVisibility | DoubleClickSelectionMode | ColorPickerColorMode | TimelineTrackVisibility | (string & {});
 
 /** @public */
-export declare type SettingFloatPropertyName = 'positionSnappingThreshold' | 'rotationSnappingThreshold' | 'controlGizmo/blockScaleDownLimit' | 'listIndentPerLevel' | 'grid/spacingX' | 'grid/spacingY' | (string & {});
+export declare type SettingFloatPropertyName = 'positionSnappingThreshold' | 'rotationSnappingThreshold' | 'grid/spacingX' | 'grid/spacingY' | 'controlGizmo/blockScaleDownLimit' | 'listIndentPerLevel' | (string & {});
 
 /** @public */
 export declare type SettingIntPropertyName = 'maxImageSize' | 'maxPreviewResolution' | (string & {});
@@ -9546,15 +9899,15 @@ export declare interface Settings {
     'controlGizmo/showCropHandles': boolean;
     /** Whether to display the outer handles that scale the full image during crop. */
     'controlGizmo/showCropScaleHandles': boolean;
-    /** Whether to show the move handles. */
+    /** @deprecated Use `controlGizmo/moveHandleVisibility`. `false` hides the move handle. */
     'controlGizmo/showMoveHandles': boolean;
-    /** Whether the move handle visibility is dynamic based on block size. Set to false to always show. */
+    /** @deprecated Use `controlGizmo/moveHandleVisibility`. `false` shows the move handle at any block size. */
     'controlGizmo/dynamicMoveHandleVisibility': boolean;
-    /** Whether to display the non-proportional resize handles (edge handles). */
+    /** @deprecated Use `controlGizmo/resizeHandlesVisibility`. `false` hides the edge (resize) handles. */
     'controlGizmo/showResizeHandles': boolean;
-    /** Whether to show the rotation handles. */
+    /** @deprecated Use `controlGizmo/rotateHandlesVisibility`. `false` hides the rotation handle. */
     'controlGizmo/showRotateHandles': boolean;
-    /** Whether to display the proportional scale handles (corner handles). */
+    /** @deprecated Use `controlGizmo/scaleHandlesVisibility`. `false` hides the corner (scale) handles. */
     'controlGizmo/showScaleHandles': boolean;
     /** Enable double-click to enter crop mode. */
     doubleClickToCropEnabled: boolean;
@@ -9730,6 +10083,26 @@ export declare interface Settings {
     handleFillColor: Color;
     /** Color of the grid lines. */
     'grid/color': Color;
+    /**
+     * When the move handle is shown: 'auto' (by block size), 'always' (even while editing text, not in crop
+     * mode), or 'never'. Replaces deprecated `controlGizmo/showMoveHandles`/`dynamicMoveHandleVisibility`.
+     */
+    'controlGizmo/moveHandleVisibility': 'auto' | 'always' | 'never';
+    /**
+     * When the edge (resize) handles are shown: 'auto' (default), 'always' (even while editing text, not in
+     * crop mode), or 'never'. Replaces the deprecated `controlGizmo/showResizeHandles`.
+     */
+    'controlGizmo/resizeHandlesVisibility': 'auto' | 'always' | 'never';
+    /**
+     * When the corner (scale) handles are shown: 'auto' (default), 'always' (even while editing text, not in
+     * crop mode), or 'never'. Replaces the deprecated `controlGizmo/showScaleHandles`.
+     */
+    'controlGizmo/scaleHandlesVisibility': 'auto' | 'always' | 'never';
+    /**
+     * When the rotation handle is shown: 'auto' (default), 'always' (even while editing text, not in crop
+     * mode), or 'never'. Replaces the deprecated `controlGizmo/showRotateHandles`.
+     */
+    'controlGizmo/rotateHandlesVisibility': 'auto' | 'always' | 'never';
     /** The selection mode for double-click: Direct selects the clicked element, Hierarchical traverses the hierarchy. */
     doubleClickSelectionMode: 'Direct' | 'Hierarchical';
     /** The action performed for pinch gestures: None, Zoom, Scale, Auto, or Dynamic. */
@@ -9768,6 +10141,7 @@ export declare interface Settings {
 
 
 
+
 
 
 }
@@ -9968,7 +10342,7 @@ export declare interface SpotColor {
 }
 
 /** @public */
-export declare type StringPropertyName = 'name' | 'scene/pageFormatId' | 'type' | 'uuid' | 'page/titleTemplate' | 'audio/fileURI' | 'text/externalReference' | 'text/fontFileUri' | 'text/text' | 'text/typeface' | 'cutout/path' | 'caption/externalReference' | 'caption/fontFileUri' | 'caption/text' | 'caption/typeface' | 'effect/lut_filter/lutFileURI' | 'fill/image/externalReference' | 'fill/image/imageFileURI' | 'fill/image/previewFileURI' | 'fill/video/fileURI' | 'shape/vector_path/path' | (string & {});
+export declare type StringPropertyName = 'name' | 'scene/pageFormatId' | 'type' | 'uuid' | 'page/titleTemplate' | 'audio/fileURI' | 'text/externalReference' | 'text/fontFileUri' | 'text/pathExternalRef' | 'text/text' | 'text/typeface' | 'cutout/path' | 'caption/externalReference' | 'caption/fontFileUri' | 'caption/pathExternalRef' | 'caption/text' | 'caption/typeface' | 'effect/lut_filter/filterId' | 'effect/lut_filter/lutFileURI' | 'fill/image/externalReference' | 'fill/image/imageFileURI' | 'fill/image/previewFileURI' | 'fill/video/fileURI' | 'shape/vector_path/path' | (string & {});
 
 /** @public */
 export declare type StrokeCap = (typeof StrokeCapValues)[number];
@@ -9982,12 +10356,36 @@ export declare type StrokeCornerGeometry = (typeof StrokeCornerGeometryValues)[n
 /** @public */
 export declare const StrokeCornerGeometryValues: readonly ["Bevel", "Miter", "Round"];
 
+/** @public */
+export declare type StrokeDashEndCap = (typeof StrokeDashEndCapValues)[number];
+
+/** @public */
+export declare const StrokeDashEndCapValues: readonly ["Butt", "Round", "Square"];
+
+/** @public */
+export declare type StrokeDashStartCap = (typeof StrokeDashStartCapValues)[number];
+
+/** @public */
+export declare const StrokeDashStartCapValues: readonly ["Butt", "Round", "Square"];
+
+/** @public */
+export declare type StrokeEndCap = (typeof StrokeEndCapValues)[number];
+
+/** @public */
+export declare const StrokeEndCapValues: readonly ["Butt", "Round", "Square"];
+
 /** @public */
 export declare type StrokePosition = (typeof StrokePositionValues)[number];
 
 /** @public */
 export declare const StrokePositionValues: readonly ["Center", "Inner", "Outer"];
 
+/** @public */
+export declare type StrokeStartCap = (typeof StrokeStartCapValues)[number];
+
+/** @public */
+export declare const StrokeStartCapValues: readonly ["Butt", "Round", "Square"];
+
 /** @public */
 export declare type StrokeStyle = (typeof StrokeStyleValues)[number];
 
@@ -10108,6 +10506,38 @@ export { TextHorizontalAlignment }
 /** @public */
 export declare const TextHorizontalAlignmentValues: readonly ["Left", "Right", "Center", "Auto"];
 
+/**
+ * Represents a single contiguous text run with uniform formatting.
+ *
+ * @public
+ */
+export declare interface TextRunInfo {
+    /** Start grapheme index (inclusive). */
+    from: number;
+    /** End grapheme index (exclusive). */
+    to: number;
+    /** The text content of this run. */
+    text: string;
+    /** The text color. */
+    color: Color;
+    /** The font weight. */
+    fontWeight: FontWeight;
+    /** The font style. */
+    fontStyle: FontStyle;
+    /** The font size in points. */
+    fontSize: number;
+    /** The text case transformation. */
+    textCase: TextCase;
+    /** The typeface used by this run. */
+    typeface: Typeface;
+    /** The resolved font file URI. */
+    resolvedFontFileUri: string;
+    /** The text decoration configuration of this run. */
+    textDecoration: TextDecorationConfig;
+    /** Additional kerning offset in em units. */
+    kerning: number;
+}
+
 /** @public */
 declare type TextVerticalAlignment = (typeof TextVerticalAlignmentValues)[number];
 export { TextVerticalAlignment }