@unmade/text-renderer 0.2.1 → 1.0.0

package/README.md

@@ -34,6 +34,18 @@ import { getRenderedText } from '@unmade/text-renderer/node';   // Node.js
 import { getRenderedText } from '@unmade/text-renderer/worker'; // Web Worker
 ```
 
+### ESM-only
+
+This package is ESM-only — `require('@unmade/text-renderer')` will not work. This is a hard constraint: harfbuzzjs (the font shaping engine) uses top-level `await` for WASM initialisation, which Rollup cannot emit as CJS.
+
+**Node.js / Lambda**: Node 18+ supports ESM natively, so this is not a blocker. When integrating from a CJS codebase, use dynamic import:
+
+```typescript
+const { getRenderedText } = await import('@unmade/text-renderer/node');
+```
+
+**CE Lambda integration**: When wiring text-renderer into the Configuration Engine Lambda, use the `/node` ESM entry (`@unmade/text-renderer/node`) from an ESM Lambda handler, or use the `await import()` pattern above from an existing CJS handler. The `ce-adapter` sub-package (`@unmade/text-renderer/ce-adapter`) retains a CJS build and can be `require()`'d normally.
+
 ## Configuration Engine adapter
 
 The `ce-adapter` sub-package bridges CE (Configuration Engine) editor state to renderer options:

package/dist/__vite-browser-external-l0sNRNKZ.js

@@ -0,0 +1 @@
+

package/dist/index.d.ts

@@ -1,6 +1,3 @@
-import { default as default_2 } from 'opentype.js';
-import { SVGGlyphData } from '@unmade/svg-glyphs';
-
 export declare type BaselineConfig = {
     type: 'flat';
 } | {
@@ -67,7 +64,7 @@ export declare interface GenerateFlatBaselineOptions {
     lineNumber?: number;
 }
 
-export declare const getFontCache: () => Map<any, any>;
+export declare const getFontCache: () => Map<string, LoadedFont>;
 
 /**
  * Get the unique colours used by a font's SVG glyphs.
@@ -147,13 +144,48 @@ export declare type HorizontalTextAlignmentValues = 'left' | 'centre' | 'right'
 
 export declare const LINE_HEIGHT = 1.1;
 
-export declare type LoadedFont = default_2.Font & LoadedFontExtras;
-
-declare interface LoadedFontExtras {
+export declare interface LoadedFont {
+    unitsPerEm: number;
+    names: {
+        fontFamily: string;
+    };
     svgGlyphs?: Map<number, SVGGlyphData>;
+    charToGlyph(char: string): {
+        index: number;
+        advanceWidth: number;
+        name: string;
+        getBoundingBox(): {
+            x1: number;
+            y1: number;
+            x2: number;
+            y2: number;
+        };
+    };
+    getPath(text: string, x: number, y: number, fontSize: number, options?: {
+        drawSVG?: boolean;
+    }): {
+        getBoundingBox(): {
+            x1: number;
+            y1: number;
+            x2: number;
+            y2: number;
+        };
+        toPathData(decimals?: number): string;
+    };
+    getPaths(text: string, x: number, y: number, fontSize: number, options?: {
+        drawSVG?: boolean;
+    }): Array<{
+        getBoundingBox(): {
+            x1: number;
+            y1: number;
+            x2: number;
+            y2: number;
+        };
+        toPathData(decimals?: number): string;
+    }>;
 }
 
-export declare const loadOpentypeFont: (fontUrl: string, fetchSVGGlyphs?: boolean) => Promise<LoadedFont>;
+export declare const loadFont: (fontUrl: string, fetchSVGGlyphs?: boolean) => Promise<LoadedFont>;
 
 export declare type MeasurementUnits = 'mm' | 'in';
 
@@ -186,6 +218,11 @@ export declare interface RenderTextOptions {
     colourMap?: ColourMap;
 }
 
+declare interface SVGGlyphData {
+    svg: string;
+    viewbox: string;
+}
+
 export declare interface SvgGlyphEntry {
     content: string;
     viewBox: string;