@cesdk/engine 1.76.0-rc.0 → 1.76.0-rc.2

package/index.d.ts

@@ -3640,6 +3640,25 @@ export declare class BlockAPI {
      * @param locked - Whether aspect ratio should be locked.
      */
     setCropAspectRatioLocked(id: DesignBlockId, locked: boolean): void;
+    /**
+     * Checks whether the "Original" crop preset (`ContentAspectRatio`) can be applied to a block.
+     *
+     * This runs the same preliminary check the apply path performs: it resolves the intrinsic
+     * content dimensions from the block's image/video fill (an image fill resolves only from its
+     * `sourceSet`; a video fill resolves from its `sourceSet` or the first decoded frame). Use it
+     * to gate UI that would otherwise call the preset and fail — e.g. an unreplaced placeholder
+     * image fill with an empty `sourceSet`.
+     *
+     * ```javascript
+     * const canRevert = engine.block.canRevertToOriginalRatio(block);
+     * ```
+     *
+     * @category Block Crop
+     * @param id - The block to query.
+     * @returns True if the preset would resolve, false if it cannot (no/placeholder fill, empty
+     * sourceSet, video not yet decoded, or unsupported fill type).
+     */
+    canRevertToOriginalRatio(id: DesignBlockId): boolean;
     /**
      * Checks if a block has an opacity property.
      *
@@ -7504,6 +7523,17 @@ export declare class EditorAPI {
      * @returns True if a redo step is available.
      */
     canRedo(): boolean;
+    /**
+     * Subscribe to undo/redo history changes.
+     *
+     * @deprecated Use {@link onHistoryUpdatedWithKind} instead, which additionally reports a {@link HistoryUpdate}
+     * describing the kind of update.
+     *
+     * @category Event Subscriptions
+     * @param callback - Function called when the undo/redo history changes.
+     * @returns A method to unsubscribe from the event.
+     */
+    onHistoryUpdated: (callback: () => void) => (() => void);
     /**
      * Subscribe to undo/redo history changes.
      *
@@ -7512,7 +7542,7 @@ export declare class EditorAPI {
      * via `setActiveHistory`.
      *
      * ```javascript
-     * const unsubscribe = engine.editor.onHistoryUpdated((kind) => {
+     * const unsubscribe = engine.editor.onHistoryUpdatedWithKind((kind) => {
      *   if (kind === 'Activated') {
      *     // The active history was switched; no scene change happened on this event.
      *     return;
@@ -7527,7 +7557,7 @@ export declare class EditorAPI {
      * @param callback - Function called when the undo/redo history changes. The argument describes the kind of update.
      * @returns A method to unsubscribe from the event.
      */
-    onHistoryUpdated: (callback: (kind: HistoryUpdate) => void) => (() => void);
+    onHistoryUpdatedWithKind: (callback: (kind: HistoryUpdate) => void) => (() => void);
     /**
      * Subscribe to editor settings changes.
      *
@@ -8665,7 +8695,7 @@ export declare type HexColorString = string;
 export declare type HistoryId = number;
 
 /**
- * Describes the kind of update that triggered an `onHistoryUpdated` callback.
+ * Describes the kind of update that triggered an `onHistoryUpdatedWithKind` callback.
  *
  * - `Updated`: The active history's snapshots changed: a new snapshot was added (e.g. after an edit), or undo/redo
  *   was applied. The scene state changed as a direct consequence.
@@ -10024,7 +10054,7 @@ 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/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 = '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 & {});
 
 /** @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 & {});
@@ -10144,6 +10174,11 @@ export declare interface Settings {
     'placeholderControls/showOverlay': boolean;
     /** Whether animations should be enabled or not. */
     'blockAnimations/enabled': boolean;
+    /**
+     * When enabled, every block stays visible regardless of the current playback time, instead of being
+     * culled outside its time offset/duration. No effect on export.
+     */
+    'playback/showAllBlocks': boolean;
     /** Whether the background grid is shown on pages. */
     'grid/enabled': boolean;
     /** Whether elements should snap to grid lines when dragged. */