@unmade/text-renderer 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -88,6 +88,9 @@ export declare interface GetFontSizeFromPhysicalSizeOptions {
 
 /**
  * Async text renderer. Loads font from URL, then delegates to renderText.
+ *
+ * If the calculated font size causes a TOO_WIDE error and fontSizeFallback is
+ * provided, retries once using the fallback as an explicit fontSize override.
  */
 export declare const getRenderedText: (options: GetRenderedTextOptions) => Promise<string>;
 
@@ -96,6 +99,12 @@ export declare interface GetRenderedTextOptions {
     text: string;
     fontUrl: string;
     physicalSize: PhysicalSize;
+    /**
+     * Fallback font size (in pixels) to use if the calculated size causes a
+     * TOO_WIDE error. Useful when the caller has an authoritative size (e.g.
+     * from the CE) that avoids floating-point rounding issues.
+     */
+    fontSizeFallback?: number;
     boxDimensions: BoxDimensions;
     spacing?: TextSpacing;
     verticalAlignment?: VerticalTextAlignmentValues;
@@ -165,6 +174,8 @@ export declare interface RenderTextOptions {
     text: string;
     font: LoadedFont;
     physicalSize: PhysicalSize;
+    /** When provided, bypasses the physicalSize → font size calculation. */
+    fontSize?: number;
     boxDimensions: BoxDimensions;
     spacing?: TextSpacing;
     verticalAlignment?: VerticalTextAlignmentValues;