@cesdk/node 1.76.0-nightly.20260511 → 1.76.0-nightly.20260513

package/index.d.ts

@@ -2619,6 +2619,60 @@ export declare class BlockAPI {
      * @returns The current mode: 'Crop', 'Cover' or 'Contain'.
      */
     getContentFillMode(id: DesignBlockId): ContentFillMode;
+    /**
+     * Sets the horizontal alignment of the content fill within a block.
+     *
+     * Only affects 'Contain' and 'Cover' fill modes; has no visible effect in 'Crop' mode,
+     * where the user positions the content explicitly.
+     *
+     * ```javascript
+     * engine.block.setContentFillHorizontalAlignment(image, 'Left');
+     * ```
+     *
+     * @category Block Fills
+     * @param id - The block to update.
+     * @param alignment - The horizontal alignment: 'Left', 'Center' or 'Right'.
+     */
+    setContentFillHorizontalAlignment(id: DesignBlockId, alignment: HorizontalContentFillAlignment): void;
+    /**
+     * Gets the horizontal alignment of the content fill within a block.
+     *
+     * ```javascript
+     * engine.block.getContentFillHorizontalAlignment(image);
+     * ```
+     *
+     * @category Block Fills
+     * @param id - The block to query.
+     * @returns The current alignment: 'Left', 'Center' or 'Right'.
+     */
+    getContentFillHorizontalAlignment(id: DesignBlockId): HorizontalContentFillAlignment;
+    /**
+     * Sets the vertical alignment of the content fill within a block.
+     *
+     * Only affects 'Contain' and 'Cover' fill modes; has no visible effect in 'Crop' mode,
+     * where the user positions the content explicitly.
+     *
+     * ```javascript
+     * engine.block.setContentFillVerticalAlignment(image, 'Top');
+     * ```
+     *
+     * @category Block Fills
+     * @param id - The block to update.
+     * @param alignment - The vertical alignment: 'Top', 'Center' or 'Bottom'.
+     */
+    setContentFillVerticalAlignment(id: DesignBlockId, alignment: VerticalContentFillAlignment): void;
+    /**
+     * Gets the vertical alignment of the content fill within a block.
+     *
+     * ```javascript
+     * engine.block.getContentFillVerticalAlignment(image);
+     * ```
+     *
+     * @category Block Fills
+     * @param id - The block to query.
+     * @returns The current alignment: 'Top', 'Center' or 'Bottom'.
+     */
+    getContentFillVerticalAlignment(id: DesignBlockId): VerticalContentFillAlignment;
     /**
      * Duplicates a block and its children.
      *
@@ -4436,6 +4490,38 @@ export declare class BlockAPI {
      * @param to - The end index of the UTF-16 range. Defaults to the end of the current selection or text.
      */
     setTextDecoration(id: DesignBlockId, config: TextDecorationConfig, from?: number, to?: number): void;
+    /**
+     * Sets kerning for a grapheme range.
+     *
+     * Applies an additional offset in em units on top of the font's built-in kern.
+     * `1.0` equals the run's font size, so the offset scales proportionally with text size.
+     *
+     * ```javascript
+     * engine.block.setTextKerning(text, 0.1); // add 10% of font size as extra spacing
+     * engine.block.setTextKerning(text, -0.05, 0, 5); // tighten first 5 graphemes
+     * engine.block.setTextKerning(text, 0); // reset to no extra offset
+     * ```
+     *
+     * @category Block Text
+     * @param id - The text block to modify.
+     * @param kerning - Additional kerning in em units (1.0 = one full em). Use 0 for no extra offset.
+     * @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.
+     */
+    setTextKerning(id: DesignBlockId, kerning: number, from?: number, to?: number): void;
+    /**
+     * Returns the unique kerning values across the grapheme range.
+     *
+     * ```javascript
+     * const kernings = engine.block.getTextKernings(text); // e.g. [0] or [0.1, 0]
+     * ```
+     *
+     * @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.
+     */
+    getTextKernings(id: DesignBlockId, from?: number, to?: number): number[];
     /**
      * Toggles the underline decoration for a text range.
      *
@@ -6835,19 +6921,27 @@ export declare class EditorAPI {
     /**
      * Subscribe to undo/redo history changes.
      *
+     * The callback receives a {@link HistoryUpdate} describing what kind of update happened so consumers can
+     * distinguish a real change to the active history's snapshots (e.g. an edit, undo, or redo) from a pure activation
+     * via `setActiveHistory`.
+     *
      * ```javascript
-     * const unsubscribe = engine.editor.onHistoryUpdated(() => {
+     * const unsubscribe = engine.editor.onHistoryUpdated((kind) => {
+     *   if (kind === 'Activated') {
+     *     // The active history was switched; no scene change happened on this event.
+     *     return;
+     *   }
      *   const canUndo = engine.editor.canUndo();
      *   const canRedo = engine.editor.canRedo();
-     *   console.log("History updated", {canUndo, canRedo});
-     * })
+     *   console.log('History updated', { canUndo, canRedo });
+     * });
      * ```
      *
      * @category Event Subscriptions
-     * @param callback - Function called when the undo/redo history changes.
+     * @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: () => void) => (() => void);
+    onHistoryUpdated: (callback: (kind: HistoryUpdate) => void) => (() => void);
     /**
      * Subscribe to editor settings changes.
      *
@@ -7991,9 +8085,27 @@ export declare type HexColorString = string;
  */
 export declare type HistoryId = number;
 
+/**
+ * Describes the kind of update that triggered an `onHistoryUpdated` 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.
+ * - `Activated`: A different history buffer was activated via `setActiveHistory`. The undo/redo stack visible to the
+ *   user changed, but no new snapshot was created and no undo/redo was applied as part of this event.
+ *
+ * @public
+ */
+export declare type HistoryUpdate = 'Updated' | 'Activated';
+
 /** @public */
 export declare type HorizontalBlockAlignment = TextHorizontalAlignment;
 
+/** @public */
+export declare type HorizontalContentFillAlignment = (typeof HorizontalContentFillAlignmentValues)[number];
+
+/** @public */
+export declare const HorizontalContentFillAlignmentValues: readonly ["Left", "Center", "Right"];
+
 /**
  * Represents the image MIME types used in the editor.
  *
@@ -9894,6 +10006,12 @@ export declare interface Vec3 {
 /** @public */
 export declare type VerticalBlockAlignment = TextVerticalAlignment;
 
+/** @public */
+export declare type VerticalContentFillAlignment = (typeof VerticalContentFillAlignmentValues)[number];
+
+/** @public */
+export declare const VerticalContentFillAlignmentValues: readonly ["Top", "Center", "Bottom"];
+
 /**
  * Represents the options for exporting a video.
  *