@cesdk/engine 1.75.0-rc.0 → 1.76.0-nightly.20260507

package/index.d.ts

@@ -4602,6 +4602,36 @@ export declare class BlockAPI {
      * @returns The paragraph indices overlapping the range.
      */
     getTextParagraphIndices(id: DesignBlockId, from?: number, to?: number): number[];
+    /**
+     * Sets the line height multiplier for a specific paragraph or all paragraphs of a text block.
+     *
+     * ```javascript
+     * engine.block.setTextLineHeight(text, 1.5);
+     * engine.block.setTextLineHeight(text, 1.5, 0);
+     * engine.block.setTextLineHeight(text, null); // reset all paragraphs to block default
+     * ```
+     *
+     * @category Block Text
+     * @param id - The text block to modify.
+     * @param lineHeight - The line height multiplier, or `null` to reset to the block-level default.
+     * @param paragraphIndex - The 0-based index of the paragraph to modify. Negative values apply to all paragraphs.
+     */
+    setTextLineHeight(id: DesignBlockId, lineHeight: number | null, paragraphIndex?: number): void;
+    /**
+     * Returns the line height multiplier for a specific paragraph of a text block.
+     *
+     * Returns the per-paragraph override if one is set, otherwise returns the block-level `lineHeight`.
+     *
+     * ```javascript
+     * const lineHeight = engine.block.getTextLineHeight(text, 0);
+     * ```
+     *
+     * @category Block Text
+     * @param id - The text block to query.
+     * @param paragraphIndex - The 0-based index of the paragraph.
+     * @returns The line height multiplier for the paragraph.
+     */
+    getTextLineHeight(id: DesignBlockId, paragraphIndex: number): number;
     /**
      * Checks if the bold font weight can be toggled for a range of text.
      *