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

package/index.d.ts

@@ -4902,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)
@@ -6088,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.
  *