@cesdk/node 1.77.0-nightly.20260523 → 1.77.0-nightly.20260529

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.
      *
@@ -5084,6 +5103,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.
      *
@@ -9464,7 +9499,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 & {});
@@ -9584,6 +9619,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. */
@@ -10073,6 +10113,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 }