@cesdk/node 1.70.0-nightly.20260220 → 1.70.0-nightly.20260221

package/index.d.ts

@@ -6868,6 +6868,25 @@ export declare class EditorAPI {
      * @throws Error if the resource cannot be downloaded or MIME type determined.
      */
     getMimeType(uri: string): Promise<string>;
+    /**
+     * Gets the font metrics for a given font file URI.
+     *
+     * If the font is not yet loaded, it will be fetched asynchronously.
+     * The returned metrics are in the font's design units coordinate space.
+     *
+     * ```javascript
+     * const metrics = await engine.editor.getFontMetrics('/extensions/ly.img.cesdk.fonts/fonts/Roboto/Roboto-Regular.ttf');
+     * console.log(metrics.ascender, metrics.descender, metrics.unitsPerEm);
+     * console.log(metrics.lineGap);
+     * console.log(metrics.capHeight, metrics.xHeight);
+     * console.log(metrics.underlineOffset, metrics.underlineSize, metrics.strikeoutOffset, metrics.strikeoutSize);
+     * ```
+     *
+     * @category Resource Management
+     * @param fontFileUri - The URI of the font file to get metrics from.
+     * @returns A promise resolving to the font metrics.
+     */
+    getFontMetrics(fontFileUri: string): Promise<FontMetrics>;
     /**
      * Get all transient resources that would be lost during export.
      *
@@ -7255,6 +7274,34 @@ export declare interface Font {
     style?: FontStyle;
 }
 
+/**
+ * Font metrics extracted from a font file.
+ * Values are in the font's design units coordinate space.
+ * @public
+ */
+export declare interface FontMetrics {
+    /** The ascender value in font design units. */
+    ascender: number;
+    /** The descender value in font design units (typically negative). */
+    descender: number;
+    /** The number of units per em square (typically 1000 or 2048). */
+    unitsPerEm: number;
+    /** The OS/2 sTypoLineGap value in font design units. */
+    lineGap: number;
+    /** The OS/2 sCapHeight value in font design units. */
+    capHeight: number;
+    /** The OS/2 sxHeight value in font design units. */
+    xHeight: number;
+    /** The post.underlinePosition value in font design units (typically negative). */
+    underlineOffset: number;
+    /** The post.underlineThickness value in font design units. */
+    underlineSize: number;
+    /** The OS/2 yStrikeoutPosition value in font design units. */
+    strikeoutOffset: number;
+    /** The OS/2 yStrikeoutSize value in font design units. */
+    strikeoutSize: number;
+}
+
 /**
  * Extended design unit type that includes Point for font size operations.
  * Maintains consistency with SceneDesignUnit's capitalized naming convention.