@cesdk/engine 1.61.0-nightly.20250914 → 1.61.0-nightly.20250916

package/index.d.ts

@@ -4010,28 +4010,75 @@ export declare class BlockAPI {
      * Sets the font size for a range of text.
      *
      * ```javascript
+     * // With numeric fontSize (in points)
      * engine.block.setTextFontSize(text, 12, 0, 5);
+     *
+     * // With font size and options object
+     * engine.block.setTextFontSize(text, 16, { unit: 'Pixel' });
+     * engine.block.setTextFontSize(text, 24, { unit: 'Point', from: 0, to: 10 });
      * ```
      *
      * @category Block Text
      * @param id - The text block whose font size should be changed.
-     * @param fontSize - The new font size.
+     * @param fontSize - The new font size value.
+     * @param options - An options object with unit, from, and to properties.
+     */
+    setTextFontSize(id: DesignBlockId, fontSize: number, options?: TextFontSizeOptions): void;
+    /**
+     * Sets the font size for a range of text.
+     *
+     * @category Block Text
+     * @param id - The text block whose font size should be changed.
+     * @param fontSize - The new font size in points.
      * @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.
+     * @deprecated Use the new signature with options object instead.
+     * @example
+     * ```typescript
+     * // Before migration
+     * engine.block.setTextFontSize(text, 18, 0, 5);
+     * // After migration
+     * engine.block.setTextFontSize(text, 18, { from: 0, to: 5 });
+     * ```
      */
     setTextFontSize(id: DesignBlockId, fontSize: number, from?: number, to?: number): void;
     /**
      * Gets the unique font sizes within a range of text.
      *
      * ```javascript
+     * // Get all font sizes
      * const fontSizes = engine.block.getTextFontSizes(text);
+     *
+     * // Get font sizes for a range
+     * const fontSizes = engine.block.getTextFontSizes(text, 0, 10);
+     *
+     * // With options object
+     * const sizesInPx = engine.block.getTextFontSizes(text, { unit: 'Pixel' });
+     * const sizesInRange = engine.block.getTextFontSizes(text, { unit: 'Millimeter', from: 5, to: 15 });
      * ```
      *
      * @category Block Text
      * @param id - The text block whose font sizes should be returned.
+     * @param options - An options object with unit, from, and to properties.
+     * @returns The ordered unique list of font sizes.
+     */
+    getTextFontSizes(id: DesignBlockId, options?: TextFontSizeOptions): number[];
+    /**
+     * Gets the unique font sizes within a range of text.
+     *
+     * @category Block Text
+     * @param id - The text block whose font sizes should be returned.
      * @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.
-     * @returns The ordered unique list of font sizes.
+     * @returns The ordered unique list of font sizes in points.
+     * @deprecated Use the new signature with options object instead.
+     * @example
+     * ```typescript
+     * // Before migration
+     * const fontSizes = engine.block.getTextFontSizes(text, 0, 10);
+     * // After migration
+     * const fontSizes = engine.block.getTextFontSizes(text, { from: 0, to: 10 });
+     * ```
      */
     getTextFontSizes(id: DesignBlockId, from?: number, to?: number): number[];
     /**
@@ -6994,6 +7041,13 @@ export declare interface Font {
     style?: FontStyle;
 }
 
+/**
+ * Extended design unit type that includes Point for font size operations.
+ * Maintains consistency with DesignUnit's capitalized naming convention.
+ * @public
+ */
+export declare type FontSizeUnit = DesignUnit | 'Point';
+
 /**
  * Represents the style of a font.
  *
@@ -8572,6 +8626,19 @@ export declare function supportsWasm(): boolean;
  */
 export declare type TextCase = 'Normal' | 'Uppercase' | 'Lowercase' | 'Titlecase';
 
+/**
+ * Options for text font size operations with unit support.
+ * @public
+ */
+export declare interface TextFontSizeOptions {
+    /** The unit of the font size. Defaults to 'Point' */
+    unit?: FontSizeUnit;
+    /** The start index of the UTF-16 range. Defaults to -1 (start of selection/text) */
+    from?: number;
+    /** The end index of the UTF-16 range. Defaults to -1 (end of selection/text) */
+    to?: number;
+}
+
 /**
  * Represents a transient resource.
  *