@unmade/text-renderer 0.2.0 → 0.3.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/ce-adapter/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function C(t){return t.type==="text"}function P(t){const i=t.getState().garment;return t.settings.garments.find(s=>s.slug===i)}function w(t,o){if(t.embellishment_positions)return t.embellishment_positions.find(i=>i.placement===o)}function A(t,o){const i=t.fonts.find(s=>s.id===o);if(i)return{id:i.id,fontUrl:i.font_url,fontFamily:i.font_family,letterSpacing:i.letter_spacing??0,letterSpacingOutline:i.letter_spacing_outline??0,outlineWidth:i.outline_width??0,fixedColours:i.fixed_colours}}function v(t,o,i,s,c){const{library:u}=c,a=[];for(const[l,h]of Object.entries(s)){if(h.type!=="text")continue;const f=h,{meta:n}=f;if(!n?.text)continue;const{libraryItemID:d}=f,g=u[d];if(!g||!C(g))continue;const y=n.font;if(y===void 0)continue;const m=A(g,y);if(!m)continue;const r=w(o,l);if(!r)continue;let x=null,b=null;if(n.colours&&g.palette!=null)try{const e=t.palettes.getUsedColours(g.palette,n.colours);x=e[0]??null,b=e[1]??null}catch(e){console.warn(`[extractTextPlacements] Colour resolution failed for ${l}:`,e)}const S=c.byId?.[l],p={vertical:"top",horizontal:"left"};if(S){const e=S;e.vertical_alignment&&(p.vertical=e.vertical_alignment),e.horizontal_alignment&&(p.horizontal=e.horizontal_alignment)}a.push({placementId:l,displayName:l,source:i,text:n.text,font:m,isCurved:n.isCurved??!1,isDistributed:n.isDistributed??!1,verticalAlignment:n.verticalAlignment??p.vertical,horizontalAlignment:n.horizontalAlignment??p.horizontal,rotation:n.rotation??0,spacing:n.spacing??null,fillColour:x,outlineColour:b,position:{width:r.width,height:r.height,physicalWidth:r.physical_width_decimal,physicalHeight:r.physical_height_decimal,physicalUnits:r.physical_size_units,baselinePath:r.baseline_path,rotation:r.rotation},userSetPhysicalSize:n.retainedPhysicalSize??null,fontMetrics:(()=>{const e=n.fontMetrics??{size:0,height:0,baseline:0,width:0},z=e.physicalFontSize||(e.physicalHeight!=null&&e.physicalHeight>0&&e.physicalUnits!=null?[e.physicalHeight,e.physicalUnits]:void 0);return{...e,physicalFontSize:z}})(),manufacturingMethod:n.manufacturing_method??""})}return a}function U(t){const o=t.getState(),i=P(t);if(!i)return console.warn("[extractTextPlacements] No matching garment found"),[];const s=[],c=o.vals?.placements,u=t.settings.placements;c&&u&&s.push(...v(t,i,"placements",c,u));const a=o.vals?.embellishments,l=t.settings.embellishments;return a&&l&&s.push(...v(t,i,"embellishments",a,l)),s.length===0&&console.warn("[extractTextPlacements] No text entries found in either placements or embellishments"),s}function _(t){return t==="center"?"centre":t}function O(t){let o=_(t.horizontalAlignment);t.isDistributed&&(o="distributed");let i;t.position.baselinePath?i={type:"custom",path:t.position.baselinePath}:t.isCurved?i="curved":i="flat";const s=t.userSetPhysicalSize?[t.userSetPhysicalSize[0],t.userSetPhysicalSize[1]]:t.fontMetrics.physicalFontSize!=null?t.fontMetrics.physicalFontSize:[t.position.physicalHeight,t.position.physicalUnits],u={outlineWidth:t.outlineColour!=null?t.font.outlineWidth:0,letterSpacing:t.spacing?.letter_spacing??0,letterSpacingOutline:t.spacing?.letter_spacing_outline??0},a=t.fillColour?{hex:t.fillColour.hex,reference:t.fillColour.reference??void 0}:void 0,l=t.outlineColour?{hex:t.outlineColour.hex,reference:t.outlineColour.reference??void 0}:void 0;let h;if(t.font.fixedColours){const f={};for(const[n,d]of Object.entries(t.font.fixedColours))f[n]={hex:d.hex,reference:d.reference};h=f}return{text:t.text,fontUrl:t.font.fontUrl,physicalSize:s,fontSizeFallback:t.fontMetrics.size,boxDimensions:{width:t.position.width,height:t.position.height,physicalWidth:t.position.physicalWidth,physicalHeight:t.position.physicalHeight,physicalUnits:t.position.physicalUnits},spacing:u,verticalAlignment:_(t.verticalAlignment),horizontalAlignment:o,baseline:i,fillColour:a,strokeColour:l,colourMap:h}}exports.extractTextPlacements=U;exports.mapStateToRendererOptions=O;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function P(t){return t.type==="text"}function w(t){const i=t.getState().garment;return t.settings.garments.find(s=>s.slug===i)}function A(t,l,i){if(!t.embellishment_positions)return;const s=t.embellishment_positions.filter(o=>o.placement!==l?!1:!i||!o.variant?!0:o.variant===i||o.variant.toLowerCase()==="common");if(i&&s.length>1){const o=s.find(a=>a.variant===i);if(o)return o}return s[0]}function U(t,l){const i=t.fonts.find(s=>s.id===l);if(i)return{id:i.id,fontUrl:i.font_url,fontFamily:i.font_family,letterSpacing:i.letter_spacing??0,letterSpacingOutline:i.letter_spacing_outline??0,outlineWidth:i.outline_width??0,fixedColours:i.fixed_colours}}function v(t,l,i,s,o,a){const{library:h}=o,u=[];for(const[r,f]of Object.entries(s)){if(f.type!=="text")continue;const d=f,{meta:e}=d;if(!e?.text)continue;const{libraryItemID:z}=d,g=h[z];if(!g||!P(g))continue;const y=e.font;if(y===void 0)continue;const m=U(g,y);if(!m)continue;const c=A(l,r,a);if(!c)continue;let x=null,b=null;if(e.colours&&g.palette!=null)try{const n=t.palettes.getUsedColours(g.palette,e.colours);x=n[0]??null,b=n[1]??null}catch(n){console.warn(`[extractTextPlacements] Colour resolution failed for ${r}:`,n)}const S=o.byId?.[r],p={vertical:"top",horizontal:"left"};if(S){const n=S;n.vertical_alignment&&(p.vertical=n.vertical_alignment),n.horizontal_alignment&&(p.horizontal=n.horizontal_alignment)}u.push({placementId:r,displayName:r,source:i,text:e.text,font:m,isCurved:e.isCurved??!1,isDistributed:e.isDistributed??!1,verticalAlignment:e.verticalAlignment??p.vertical,horizontalAlignment:e.horizontalAlignment??p.horizontal,rotation:e.rotation??0,spacing:e.spacing??null,fillColour:x,outlineColour:b,position:{width:c.width,height:c.height,physicalWidth:c.physical_width_decimal,physicalHeight:c.physical_height_decimal,physicalUnits:c.physical_size_units,baselinePath:c.baseline_path,rotation:c.rotation},userSetPhysicalSize:e.retainedPhysicalSize??null,fontMetrics:(()=>{const n=e.fontMetrics??{size:0,height:0,baseline:0,width:0},C=n.physicalFontSize||(n.physicalHeight!=null&&n.physicalHeight>0&&n.physicalUnits!=null?[n.physicalHeight,n.physicalUnits]:void 0);return{...n,physicalFontSize:C}})(),manufacturingMethod:e.manufacturing_method??""})}return u}function O(t){const l=t.getState(),i=w(t);if(!i)return console.warn("[extractTextPlacements] No matching garment found"),[];const s=typeof t.getCurrentVariant=="function"?t.getCurrentVariant():void 0,o=[],a=l.vals?.placements,h=t.settings.placements;a&&h&&o.push(...v(t,i,"placements",a,h,s));const u=l.vals?.embellishments,r=t.settings.embellishments;return u&&r&&o.push(...v(t,i,"embellishments",u,r,s)),o.length===0&&console.warn("[extractTextPlacements] No text entries found in either placements or embellishments"),o}function _(t){return t==="center"?"centre":t}function T(t){let l=_(t.horizontalAlignment);t.isDistributed&&(l="distributed");let i;t.position.baselinePath?i={type:"custom",path:t.position.baselinePath}:t.isCurved?i="curved":i="flat";const s=t.userSetPhysicalSize?[t.userSetPhysicalSize[0],t.userSetPhysicalSize[1]]:t.fontMetrics.physicalFontSize!=null?t.fontMetrics.physicalFontSize:[t.position.physicalHeight,t.position.physicalUnits],a={outlineWidth:t.outlineColour!=null?t.font.outlineWidth:0,letterSpacing:t.spacing?.letter_spacing??0,letterSpacingOutline:t.spacing?.letter_spacing_outline??0},h=t.fillColour?{hex:t.fillColour.hex,reference:t.fillColour.reference??void 0}:void 0,u=t.outlineColour?{hex:t.outlineColour.hex,reference:t.outlineColour.reference??void 0}:void 0;let r;if(t.font.fixedColours){const f={};for(const[d,e]of Object.entries(t.font.fixedColours))f[d]={hex:e.hex,reference:e.reference};r=f}return{text:t.text,fontUrl:t.font.fontUrl,physicalSize:s,fontSizeFallback:t.fontMetrics.size,boxDimensions:{width:t.position.width,height:t.position.height,physicalWidth:t.position.physicalWidth,physicalHeight:t.position.physicalHeight,physicalUnits:t.position.physicalUnits},spacing:a,verticalAlignment:_(t.verticalAlignment),horizontalAlignment:l,baseline:i,fillColour:h,strokeColour:u,colourMap:r}}exports.extractTextPlacements=O;exports.mapStateToRendererOptions=T;

package/dist/ce-adapter/index.js

@@ -1,18 +1,21 @@
-function C(t) {
+function w(t) {
   return t.type === "text";
 }
 function P(t) {
   const i = t.getState().garment;
   return t.settings.garments.find((s) => s.slug === i);
 }
-function w(t, o) {
-  if (t.embellishment_positions)
-    return t.embellishment_positions.find(
-      (i) => i.placement === o
-    );
+function A(t, l, i) {
+  if (!t.embellishment_positions) return;
+  const s = t.embellishment_positions.filter((o) => o.placement !== l ? !1 : !i || !o.variant ? !0 : o.variant === i || o.variant.toLowerCase() === "common");
+  if (i && s.length > 1) {
+    const o = s.find((a) => a.variant === i);
+    if (o) return o;
+  }
+  return s[0];
 }
-function A(t, o) {
-  const i = t.fonts.find((s) => s.id === o);
+function U(t, l) {
+  const i = t.fonts.find((s) => s.id === l);
   if (i)
     return {
       id: i.id,
@@ -24,109 +27,109 @@ function A(t, o) {
       fixedColours: i.fixed_colours
     };
 }
-function v(t, o, i, s, c) {
-  const { library: u } = c, a = [];
-  for (const [l, h] of Object.entries(s)) {
-    if (h.type !== "text") continue;
-    const f = h, { meta: n } = f;
-    if (!n?.text) continue;
-    const { libraryItemID: d } = f, g = u[d];
-    if (!g || !C(g)) continue;
-    const y = n.font;
+function S(t, l, i, s, o, a) {
+  const { library: h } = o, u = [];
+  for (const [r, f] of Object.entries(s)) {
+    if (f.type !== "text") continue;
+    const d = f, { meta: e } = d;
+    if (!e?.text) continue;
+    const { libraryItemID: z } = d, g = h[z];
+    if (!g || !w(g)) continue;
+    const y = e.font;
     if (y === void 0) continue;
-    const m = A(g, y);
+    const m = U(g, y);
     if (!m) continue;
-    const r = w(o, l);
-    if (!r) continue;
+    const c = A(l, r, a);
+    if (!c) continue;
     let x = null, b = null;
-    if (n.colours && g.palette != null)
+    if (e.colours && g.palette != null)
       try {
-        const e = t.palettes.getUsedColours(
+        const n = t.palettes.getUsedColours(
           g.palette,
-          n.colours
+          e.colours
         );
-        x = e[0] ?? null, b = e[1] ?? null;
-      } catch (e) {
-        console.warn(`[extractTextPlacements] Colour resolution failed for ${l}:`, e);
+        x = n[0] ?? null, b = n[1] ?? null;
+      } catch (n) {
+        console.warn(`[extractTextPlacements] Colour resolution failed for ${r}:`, n);
       }
-    const S = c.byId?.[l], p = {
+    const v = o.byId?.[r], p = {
       vertical: "top",
       horizontal: "left"
     };
-    if (S) {
-      const e = S;
-      e.vertical_alignment && (p.vertical = e.vertical_alignment), e.horizontal_alignment && (p.horizontal = e.horizontal_alignment);
+    if (v) {
+      const n = v;
+      n.vertical_alignment && (p.vertical = n.vertical_alignment), n.horizontal_alignment && (p.horizontal = n.horizontal_alignment);
     }
-    a.push({
-      placementId: l,
-      displayName: l,
+    u.push({
+      placementId: r,
+      displayName: r,
       source: i,
-      text: n.text,
+      text: e.text,
       font: m,
-      isCurved: n.isCurved ?? !1,
-      isDistributed: n.isDistributed ?? !1,
-      verticalAlignment: n.verticalAlignment ?? p.vertical,
-      horizontalAlignment: n.horizontalAlignment ?? p.horizontal,
-      rotation: n.rotation ?? 0,
-      spacing: n.spacing ?? null,
+      isCurved: e.isCurved ?? !1,
+      isDistributed: e.isDistributed ?? !1,
+      verticalAlignment: e.verticalAlignment ?? p.vertical,
+      horizontalAlignment: e.horizontalAlignment ?? p.horizontal,
+      rotation: e.rotation ?? 0,
+      spacing: e.spacing ?? null,
       fillColour: x,
       outlineColour: b,
       position: {
-        width: r.width,
-        height: r.height,
-        physicalWidth: r.physical_width_decimal,
-        physicalHeight: r.physical_height_decimal,
-        physicalUnits: r.physical_size_units,
-        baselinePath: r.baseline_path,
-        rotation: r.rotation
+        width: c.width,
+        height: c.height,
+        physicalWidth: c.physical_width_decimal,
+        physicalHeight: c.physical_height_decimal,
+        physicalUnits: c.physical_size_units,
+        baselinePath: c.baseline_path,
+        rotation: c.rotation
       },
-      userSetPhysicalSize: n.retainedPhysicalSize ?? null,
+      userSetPhysicalSize: e.retainedPhysicalSize ?? null,
       fontMetrics: (() => {
-        const e = n.fontMetrics ?? { size: 0, height: 0, baseline: 0, width: 0 }, z = e.physicalFontSize || (e.physicalHeight != null && e.physicalHeight > 0 && e.physicalUnits != null ? [e.physicalHeight, e.physicalUnits] : void 0);
-        return { ...e, physicalFontSize: z };
+        const n = e.fontMetrics ?? { size: 0, height: 0, baseline: 0, width: 0 }, C = n.physicalFontSize || (n.physicalHeight != null && n.physicalHeight > 0 && n.physicalUnits != null ? [n.physicalHeight, n.physicalUnits] : void 0);
+        return { ...n, physicalFontSize: C };
       })(),
-      manufacturingMethod: n.manufacturing_method ?? ""
+      manufacturingMethod: e.manufacturing_method ?? ""
     });
   }
-  return a;
+  return u;
 }
-function U(t) {
-  const o = t.getState(), i = P(t);
+function F(t) {
+  const l = t.getState(), i = P(t);
   if (!i)
     return console.warn("[extractTextPlacements] No matching garment found"), [];
-  const s = [], c = o.vals?.placements, u = t.settings.placements;
-  c && u && s.push(...v(t, i, "placements", c, u));
-  const a = o.vals?.embellishments, l = t.settings.embellishments;
-  return a && l && s.push(...v(t, i, "embellishments", a, l)), s.length === 0 && console.warn("[extractTextPlacements] No text entries found in either placements or embellishments"), s;
+  const s = typeof t.getCurrentVariant == "function" ? t.getCurrentVariant() : void 0, o = [], a = l.vals?.placements, h = t.settings.placements;
+  a && h && o.push(...S(t, i, "placements", a, h, s));
+  const u = l.vals?.embellishments, r = t.settings.embellishments;
+  return u && r && o.push(...S(t, i, "embellishments", u, r, s)), o.length === 0 && console.warn("[extractTextPlacements] No text entries found in either placements or embellishments"), o;
 }
 function _(t) {
   return t === "center" ? "centre" : t;
 }
-function F(t) {
-  let o = _(t.horizontalAlignment);
-  t.isDistributed && (o = "distributed");
+function H(t) {
+  let l = _(t.horizontalAlignment);
+  t.isDistributed && (l = "distributed");
   let i;
   t.position.baselinePath ? i = { type: "custom", path: t.position.baselinePath } : t.isCurved ? i = "curved" : i = "flat";
   const s = t.userSetPhysicalSize ? [
     t.userSetPhysicalSize[0],
     t.userSetPhysicalSize[1]
-  ] : t.fontMetrics.physicalFontSize != null ? t.fontMetrics.physicalFontSize : [t.position.physicalHeight, t.position.physicalUnits], u = {
+  ] : t.fontMetrics.physicalFontSize != null ? t.fontMetrics.physicalFontSize : [t.position.physicalHeight, t.position.physicalUnits], a = {
     outlineWidth: t.outlineColour != null ? t.font.outlineWidth : 0,
     letterSpacing: t.spacing?.letter_spacing ?? 0,
     letterSpacingOutline: t.spacing?.letter_spacing_outline ?? 0
-  }, a = t.fillColour ? {
+  }, h = t.fillColour ? {
     hex: t.fillColour.hex,
     reference: t.fillColour.reference ?? void 0
-  } : void 0, l = t.outlineColour ? {
+  } : void 0, u = t.outlineColour ? {
     hex: t.outlineColour.hex,
     reference: t.outlineColour.reference ?? void 0
   } : void 0;
-  let h;
+  let r;
   if (t.font.fixedColours) {
     const f = {};
-    for (const [n, d] of Object.entries(t.font.fixedColours))
-      f[n] = { hex: d.hex, reference: d.reference };
-    h = f;
+    for (const [d, e] of Object.entries(t.font.fixedColours))
+      f[d] = { hex: e.hex, reference: e.reference };
+    r = f;
   }
   return {
     text: t.text,
@@ -140,18 +143,18 @@ function F(t) {
       physicalHeight: t.position.physicalHeight,
       physicalUnits: t.position.physicalUnits
     },
-    spacing: u,
+    spacing: a,
     verticalAlignment: _(
       t.verticalAlignment
     ),
-    horizontalAlignment: o,
+    horizontalAlignment: l,
     baseline: i,
-    fillColour: a,
-    strokeColour: l,
-    colourMap: h
+    fillColour: h,
+    strokeColour: u,
+    colourMap: r
   };
 }
 export {
-  U as extractTextPlacements,
-  F as mapStateToRendererOptions
+  F as extractTextPlacements,
+  H as mapStateToRendererOptions
 };

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,10 +144,45 @@ 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>;
@@ -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;