@cesdk/node 1.72.0-nightly.20260319 → 1.72.0-rc.0

package/index.d.ts

@@ -5591,7 +5591,6 @@ export declare class BlockAPI {
     /**
      * Adds a video block to the current scene page. The video will be positioned and sized
      * according to the provided parameters. Timeline and animation effects can be applied.
-     * Only works in Video mode, not in Design mode.
      *
      * @category Helper
      * @param url - URL or path to the video file
@@ -5599,7 +5598,7 @@ export declare class BlockAPI {
      * @param height - Height of the video in scene design units
      * @param options - Configuration options for the video
      * @returns Promise that resolves to the ID of the created video block
-     * @throws Error if called in Design mode or if no current page exists
+     * @throws Error if no current page exists
      */
     addVideo(url: string, width: number, height: number, options?: AddVideoOptions): Promise<DesignBlockId>;
     /**
@@ -5620,23 +5619,20 @@ export declare class BlockAPI {
     applyDropShadow(block: DesignBlockId, options?: DropShadowOptions): void;
     /**
      * Generates a thumbnail image of the scene at a specific time.
-     * Only works in Video mode, not in Design mode.
      *
      * @category Helper
      * @param height - Height of the thumbnail in scene design units (maximum 512)
      * @param time - Time position in seconds to capture the thumbnail
      * @returns Promise that resolves to a Blob containing the PNG thumbnail image
-     * @throws Error if no page exists, if called in Design mode, or if height exceeds 512 pixels
+     * @throws Error if no page exists or if height exceeds 512 pixels
      */
     generateThumbnailAtTimeOffset(height: number, time: number): Promise<Blob>;
     /**
      * Gets the background track of the current scene.
      * The background track is the track that determines the page duration.
-     * Only works in Video mode, not in Design mode.
      *
      * @category Helper
      * @returns The ID of the background track, or null if none exists
-     * @throws Error if called in Design mode
      */
     getBackgroundTrack(): DesignBlockId | null;
     /**
@@ -6264,7 +6260,7 @@ export declare type DropShadowOptions = {
  *
  * @public
  */
-export declare type EditMode = 'Transform' | 'Crop' | 'Text' | 'Playback' | 'Trim' | (string & {});
+export declare type EditMode = 'Transform' | 'Crop' | 'Text' | 'Playback' | 'Trim' | 'Vector' | (string & {});
 
 /**
  * @public Control the design editor's behavior and settings.
@@ -6326,7 +6322,7 @@ export declare class EditorAPI {
      * ```
      *
      * @category Edit Mode Management
-     * @param mode - "Transform", "Crop", "Text", "Playback", "Trim" or a custom value.
+     * @param mode - "Transform", "Crop", "Text", "Playback", "Trim", "Vector" or a custom value.
      * @param baseMode - Optional base mode from which the custom mode will inherit the settings.
      */
     setEditMode(mode: EditMode, baseMode?: string): void;
@@ -6336,7 +6332,7 @@ export declare class EditorAPI {
      * Edit modes represent different tools or interaction states within the editor. Common ones, are "Crop" while the crop tool is shown or "Text" when inline-editing text.
      *
      * @category Edit Mode Management
-     * @returns "Transform", "Crop", "Text", "Playback", "Trim" or a custom value.
+     * @returns "Transform", "Crop", "Text", "Playback", "Trim", "Vector" or a custom value.
      */
     getEditMode(): EditMode;
     /**
@@ -6349,13 +6345,110 @@ export declare class EditorAPI {
      * @experimental This API is experimental and may change or be removed in future versions.
      */
     unstable_isInteractionHappening(): boolean;
+    /**
+     * Check whether a vector anchor node is currently selected in vector edit mode.
+     *
+     * @category Vector Edit
+     * @returns True if a vector anchor node is selected.
+     */
+    hasSelectedVectorNode(): boolean;
+    /**
+     * Add a new vertex by splitting the segment after the currently selected vector node.
+     *
+     * @category Vector Edit
+     */
+    addVectorNode(): void;
+    /**
+     * Delete the currently selected vector node from the path.
+     *
+     * @category Vector Edit
+     */
+    deleteVectorNode(): void;
+    /**
+     * Toggle the currently selected vector node between smooth (bezier handles)
+     * and corner (no handles).
+     *
+     * @category Vector Edit
+     */
+    toggleSelectedVectorNodeSmooth(): void;
+    /**
+     * Enable or disable bend mode for vector editing.
+     *
+     * When bend mode is active, clicking an anchor node automatically toggles
+     * it between smooth (bezier handles) and corner (no handles).
+     *
+     * @param active - true to enable bend mode, false to return to normal move mode.
+     * @category Vector Edit
+     */
+    setVectorEditBendMode(active: boolean): void;
+    /**
+     * Check whether vector edit bend mode is currently active.
+     *
+     * @returns true if bend mode is active.
+     * @category Vector Edit
+     */
+    getVectorEditBendMode(): boolean;
+    /**
+     * Enable or disable add mode for vector editing.
+     *
+     * When add mode is active, clicking on a path segment inserts a new anchor
+     * point at the click position. Mutually exclusive with bend and delete modes.
+     *
+     * @param active - true to enable add mode, false to return to normal move mode.
+     * @category Vector Edit
+     */
+    setVectorEditAddMode(active: boolean): void;
+    /**
+     * Check whether vector edit add mode is currently active.
+     *
+     * @returns true if add mode is active.
+     * @category Vector Edit
+     */
+    getVectorEditAddMode(): boolean;
+    /**
+     * Enable or disable delete mode for vector editing.
+     *
+     * When delete mode is active, clicking an anchor node instantly deletes it
+     * from the path. Mutually exclusive with bend and add modes.
+     *
+     * @param active - true to enable delete mode, false to return to normal move mode.
+     * @category Vector Edit
+     */
+    setVectorEditDeleteMode(active: boolean): void;
+    /**
+     * Check whether vector edit delete mode is currently active.
+     *
+     * @returns true if delete mode is active.
+     * @category Vector Edit
+     */
+    getVectorEditDeleteMode(): boolean;
+    /**
+     * Set the bezier handle mirror mode for the currently selected vector node.
+     *
+     * Mirror modes control how the opposite handle behaves when one handle is dragged:
+     * - 0 (None): handles move independently
+     * - 1 (AngleAndLength): the opposite handle mirrors both angle and length
+     * - 2 (AngleOnly): the opposite handle mirrors the angle but keeps its own length
+     *
+     * @param mode - The mirror mode (0, 1, or 2).
+     * @category Vector Edit
+     */
+    setSelectedVectorNodeMirrorMode(mode: number): void;
+    /**
+     * Get the bezier handle mirror mode of the currently selected vector node.
+     *
+     * @returns The mirror mode as a number (0 = None, 1 = AngleAndLength, 2 = AngleOnly).
+     * @throws Error if no node is selected or no vector path is being edited.
+     * @category Vector Edit
+     */
+    getSelectedVectorNodeMirrorMode(): number;
     /**
      * Get the cursor type that should be displayed.
      *
      * @category Edit Mode Management
      * @returns The cursor type.
      */
-    getCursorType(): 'Arrow' | 'Move' | 'MoveNotPermitted' | 'Resize' | 'Rotate' | 'Text';
+    getCursorType(): 'Arrow' | 'Move' | 'MoveNotPermitted' | 'Resize' | 'Rotate' | 'Text' | 'Cell';
     /**
      * Get the cursor rotation angle.
      *
@@ -7452,7 +7545,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/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/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' | '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/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 & {});
 
 /**
  * Represents a font.
@@ -8082,6 +8175,8 @@ export declare class SceneAPI {
     /**
      * Create a new scene in video mode, along with its own camera.
      *
+     * @deprecated Scene mode no longer affects engine behavior. Use `create()` followed by `setMode('Video')` instead.
+     *
      * ```javascript
      * const scene = engine.scene.createVideo();
      * ```
@@ -8172,19 +8267,20 @@ export declare class SceneAPI {
     /**
      * Get the current scene mode.
      *
+     * @deprecated Scene mode no longer affects engine behavior. All features work regardless of mode.
+     *
      * ```javascript
      * const mode = scene.getMode();
      * ```
      *
      * @category Scene Properties
-     * @returns The current mode of the scene.
+     * @returns The current mode of the scene, or null if no mode has been set.
      */
-    getMode(): SceneMode;
+    getMode(): SceneMode | null;
     /**
      * Set the mode of the scene.
-     * Changing the scene mode affects how the engine processes and renders the scene:
-     * - Video mode enables timeline-based playback, animations, and audio processing.
-     * - Design mode disables playback-related features and uses different color space settings.
+     *
+     * @deprecated Scene mode no longer affects engine behavior. All features work regardless of mode.
      *
      * ```javascript
      * engine.scene.setMode('Video');
@@ -8567,10 +8663,10 @@ export declare type SceneLayout = (typeof SceneLayoutValues)[number];
 /** @public */
 export declare const SceneLayoutValues: readonly ["Free", "VerticalStack", "HorizontalStack", "DepthStack"];
 
-/** @public */
+/** @public @deprecated Since v1.72. Scene mode no longer affects engine behavior. */
 export declare type SceneMode = (typeof SceneModeValues)[number];
 
-/** @public */
+/** @public @deprecated Since v1.72. Scene mode no longer affects engine behavior. */
 export declare const SceneModeValues: readonly ["Design", "Video"];
 
 /**
@@ -8591,10 +8687,10 @@ 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' | 'renderTextCursorAndSelectionInEngine' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning' | 'mouse/enableZoom' | 'mouse/enableScroll' | 'controlGizmo/showCropHandles' | 'controlGizmo/showMoveHandles' | '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/moveChildrenWhenCroppingFill' | 'page/selectWhenNoBlocksSelected' | 'page/highlightWhenCropping' | 'page/highlightDropTarget' | 'page/reparentBlocksToSceneWhenOutOfPage' | 'page/clipped' | 'colorMaskingSettings/secondPass' | 'clampThumbnailTextureSizes' | 'useSystemFontFallback' | 'forceSystemEmojis' | 'features/textEditModeTransformHandlesEnabled' | 'features/videoStreamingEnabled' | 'features/enableAutomaticEnumerations' | (string & {});
+export declare type SettingBoolPropertyName = 'alwaysHighlightPlaceholders' | 'doubleClickToCropEnabled' | 'showBuildVersion' | 'placeholderControls/showButton' | 'placeholderControls/showOverlay' | 'blockAnimations/enabled' | 'renderTextCursorAndSelectionInEngine' | 'touch/dragStartCanSelect' | 'touch/singlePointPanning' | 'mouse/enableZoom' | 'mouse/enableScroll' | 'controlGizmo/showCropHandles' | 'controlGizmo/showMoveHandles' | '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/moveChildrenWhenCroppingFill' | 'page/selectWhenNoBlocksSelected' | 'page/highlightWhenCropping' | 'page/highlightDropTarget' | 'page/reparentBlocksToSceneWhenOutOfPage' | 'colorMaskingSettings/secondPass' | 'clampThumbnailTextureSizes' | 'useSystemFontFallback' | 'forceSystemEmojis' | 'features/textEditModeTransformHandlesEnabled' | 'features/videoStreamingEnabled' | 'grid/enabled' | 'grid/snapEnabled' | 'features/enableAutomaticEnumerations' | (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' | (string & {});
+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 & {});
 
 /** @public */
 export declare type SettingEnumPropertyName = 'touch/pinchAction' | 'touch/rotateAction' | 'camera/clamping/overshootMode' | 'doubleClickSelectionMode' | 'colorPicker/colorMode' | 'timeline/trackVisibility' | (string & {});
@@ -8613,7 +8709,7 @@ export declare type SettingEnumType = {
 export declare type SettingEnumValues = TouchPinchAction | TouchRotateAction | CameraClampingOvershootMode | DoubleClickSelectionMode | ColorPickerColorMode | TimelineTrackVisibility | (string & {});
 
 /** @public */
-export declare type SettingFloatPropertyName = 'positionSnappingThreshold' | 'rotationSnappingThreshold' | 'controlGizmo/blockScaleDownLimit' | 'listIndentPerLevel' | (string & {});
+export declare type SettingFloatPropertyName = 'positionSnappingThreshold' | 'rotationSnappingThreshold' | 'controlGizmo/blockScaleDownLimit' | 'listIndentPerLevel' | 'grid/spacingX' | 'grid/spacingY' | (string & {});
 
 /** @public */
 export declare type SettingIntPropertyName = 'maxImageSize' | 'maxPreviewResolution' | (string & {});
@@ -8699,6 +8795,10 @@ export declare interface Settings {
     'placeholderControls/showOverlay': boolean;
     /** Whether animations should be enabled or not. */
     'blockAnimations/enabled': boolean;
+    /** Whether the background grid is shown on pages. */
+    'grid/enabled': boolean;
+    /** Whether elements should snap to grid lines when dragged. */
+    'grid/snapEnabled': boolean;
     /** Whether to display the build version in the UI. */
     showBuildVersion: boolean;
     /** Whether drag start can select elements. */
@@ -8718,9 +8818,6 @@ export declare interface Settings {
     /** Whether blocks should be reparented to the scene when dragged outside all pages,
      * and reparented back to a page when dragged over one. */
     'page/reparentBlocksToSceneWhenOutOfPage': boolean;
-    /** Whether pages should clip their contents to their bounds.
-     * Applies to newly created pages and, when changed, immediately updates all existing pages. */
-    'page/clipped': boolean;
     /** Clamp thumbnail texture sizes to the platform's GPU texture limit. */
     clampThumbnailTextureSizes: boolean;
     /** Toggle the dock components visibility */
@@ -8759,6 +8856,10 @@ export declare interface Settings {
     positionSnappingThreshold: number;
     /** The threshold angle in degrees for rotation snapping. */
     rotationSnappingThreshold: number;
+    /** Horizontal spacing between vertical grid lines in design units. */
+    'grid/spacingX': number;
+    /** Vertical spacing between horizontal grid lines in design units. */
+    'grid/spacingY': number;
     /** The maximum size (width or height) in pixels for images. */
     maxImageSize: number;
     /** The maximum dimension (width or height) in physical pixels for preview rendering.
@@ -8803,6 +8904,8 @@ export declare interface Settings {
     textVariableHighlightColor: Color;
     /** The fill color for handles. */
     handleFillColor: Color;
+    /** Color of the grid lines. */
+    'grid/color': Color;
     /** 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, or Auto. */