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

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.
      *