@cesdk/node 1.76.0-nightly.20260512 → 1.76.0-nightly.20260514

package/index.d.ts

@@ -4490,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.
      *
@@ -4870,6 +4902,18 @@ export declare class BlockAPI {
      * @returns The text content of the line.
      */
     getTextVisibleLineContent(id: DesignBlockId, lineIndex: number): string;
+    /**
+     * Returns the tight ink-paint bounding box for each grapheme in the range.
+     * One entry per grapheme in [from, to). Non-printable graphemes get a zero-rect.
+     * Coordinates are in global scene space.
+     *
+     * @category Block Text
+     * @param id - The text block to query.
+     * @param from - Start grapheme index (-1 = start of cursor selection or 0).
+     * @param to - End grapheme index (-1 = end of cursor selection or text length).
+     * @returns Array of CharacterInkBox, one per grapheme in range, in text order.
+     */
+    getTextCharacterInkBoxes(id: DesignBlockId, from?: number, to?: number): CharacterInkBox[];
     /**
      * Gets the effective horizontal alignment of a text block.
      * If the alignment is set to Auto, this returns the resolved alignment (Left or Right)
@@ -6056,6 +6100,23 @@ export declare type CaptionVerticalAlignment = (typeof CaptionVerticalAlignmentV
 /** @public */
 export declare const CaptionVerticalAlignmentValues: readonly ["Top", "Bottom", "Center"];
 
+/**
+ * Tight ink-paint bounding box of a single grapheme, in global scene coordinates.
+ * @public
+ */
+export declare interface CharacterInkBox {
+    /** Global X of the tight ink rect (left edge, Y-down scene space). */
+    x: number;
+    /** Global Y of the tight ink rect (top edge, Y-down scene space). */
+    y: number;
+    /** Width of the tight ink rect. */
+    width: number;
+    /** Height of the tight ink rect. */
+    height: number;
+    /** Global Y of the glyph baseline (needed for underline/cursor overlays). */
+    baselineY: number;
+}
+
 /**
  * Represents a color in the CMYK color space.
  *