@unmade/text-renderer 1.1.0 → 1.2.0

package/README.md

@@ -46,6 +46,107 @@ 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.
 
+## Choosing a font size
+
+`getRenderedText` draws text at a size you give it. These work out what that size should be.
+
+```typescript
+import { getFontSizeToFitBox, loadFont } from '@unmade/text-renderer';
+
+const font = await loadFont('https://example.com/font.ttf');
+
+const { fontSize, fits, boundBy } = getFontSizeToFitBox({
+  font,
+  text: 'HELLO',
+  boxDimensions: {
+    width: 500,
+    height: 200,
+    physicalWidth: 100,
+    physicalHeight: 40,
+    physicalUnits: 'mm',
+  },
+  size: { mode: 'fitToBox', minFontSize: 20, maxFontSize: 200 },
+  spacing: { outlineWidth: 0, letterSpacing: 0, letterSpacingOutline: 0 },
+  baseline: 'flat',            // or 'curved', or { type: 'custom', path: '...' }
+  verticalAlignment: 'centre', // affects where a curved baseline sits
+});
+```
+
+For flat and custom baselines this is a direct calculation rather than a search: glyph
+widths, outline stroke and letter spacing are all `fontSize * constant`, so measuring
+once at a reference size and solving for a scale factor is exact. Curved baselines are
+bisected instead, against both limits at once: neither the arc's length nor the arch's
+position is proportional to font size, so both are evaluated at each candidate size.
+
+The height check asks where the text will actually land, not how tall it is. The arch is
+positioned from a standard capital, so that its shape does not change as characters are
+typed — which means a descender hangs below the arch's ends, outside a box the arch itself
+sits comfortably inside. The check reads the arch's placement from the same function that
+generates the baseline path, so a size it accepts is one the renderer can draw.
+
+### The three ways to decide a size
+
+`size` covers each of them, so none is a special case:
+
+| `size` | Meaning |
+|---|---|
+| `{ mode: 'fitToBox', minFontSize, maxFontSize }` | Solve for the largest size that fits the box |
+| `{ mode: 'fontSize', fontSize }` | Pin a size in pixels |
+| `{ mode: 'physicalSize', physicalSize: [60, 'mm'] }` | Pin a physical size — what a fixed size preset is |
+
+`minFontSize` and `maxFontSize` belong only to `fitToBox`, because they only mean
+anything while solving. A pinned size overrides them by design.
+
+Pinning inverts the problem. Instead of the text being fixed and the size free, the
+size is fixed and the **text length** becomes the free variable — hold 60mm, and fit as
+many characters as will go.
+
+### Reading the result
+
+```typescript
+interface FitTextToBoxResult {
+  fontSize: number;
+  fits: boolean;                 // false when it won't fit even at the smallest allowed size
+  boundBy: 'width' | 'height' | 'requestedSize';
+}
+```
+
+`boundBy` says which limit decided the outcome — when it fits, what capped the size;
+when it doesn't, what couldn't be satisfied. Callers generally need to respond
+differently to each: text too wide for its box and text too tall for its box call for
+different remedies, and in the configuration engine they surface as different messages.
+
+`requestedSize` means the box wasn't the limiting factor: either `maxFontSize` was
+reached while solving, or a pinned size was simply granted.
+
+### Shortening text that won't fit
+
+```typescript
+import { fitAndTruncateTextToBox } from '@unmade/text-renderer';
+
+const result = fitAndTruncateTextToBox({ font, text, boxDimensions, size, spacing });
+
+result.text;              // possibly shortened
+result.truncated;         // whether anything was removed
+result.linesDropped;      // whole lines removed
+result.charactersRemoved; // trailing characters removed
+```
+
+Whole lines are dropped before characters are trimmed. Both counts are reported rather
+than a single mode, because one call can do both — drop a line, then find the remainder
+still needs trimming — and because the caller usually wants to say something different
+about each.
+
+Works in every `size` mode. With a pinned size it is the only thing that can give: the
+size stays put and the text shortens.
+
+### Rotation
+
+Deliberately absent. Pass the box you want text laid out in and apply rotation to the
+rendered output. Rotating the frame rather than reasoning about rotation inside the
+solver keeps it working in one coordinate space, and is also what lets a rotated tall
+placement use its long side for the baseline.
+
 ## Configuration Engine adapter
 
 The `ce-adapter` sub-package bridges CE (Configuration Engine) editor state to renderer options:
@@ -88,6 +189,89 @@ comparisons/{designUrlHash}/{timestamp}/{placementId}/
   renderer-options.json # GetRenderedTextOptions (mapped TR input)
 ```
 
+## Platform bundle suites
+
+The package builds a separate bundle per platform — browser, worker and node —
+each resolving a different variant of `@unmade/platform`:
+
+| | `DOMPoint` | `DOMMatrix` | `DOMParser` |
+|---|---|---|---|
+| node | polyfill | `@thednp` polyfill | linkedom |
+| worker | **native** | `@thednp` polyfill | linkedom/worker |
+| browser | native | native | native |
+
+`__tests__/platform/` tests those built bundles, each in the host it ships into:
+the node bundle in the test process, the browser bundle on a page, and the worker
+bundle inside a real `DedicatedWorkerGlobalScope`. Nothing else runs them — the
+unit suite tests `src` under node, where neither `DOMPoint` nor `DOMMatrix`
+exists, so it can only ever exercise the polyfills.
+
+```bash
+npm run test:platform
+```
+
+It builds first, because it loads `dist` and a stale bundle would otherwise give
+a green run against code that is no longer there. It needs a browser:
+`npx playwright install chromium`.
+
+### The two suites
+
+**`render.test.ts`** draws every scenario in `scenarios.ts` on all three bundles,
+through both public render entry points — `getRenderedText`, which loads its own
+font, and `renderText`, which takes one already loaded. Each render is rasterised
+here, by one resvg call for all three, and checked twice:
+
+- **pixel-identical to the node bundle's, with no tolerance.** All three go
+  through the same rasteriser in the same process, so nothing legitimate can move
+  a pixel. This is the assertion that the differing geometry and DOM
+  implementations do not reach the artwork.
+- **within 1% of a committed reference** in `platform/references/`, so a change
+  that shifts all three together is caught as well.
+
+**`api.test.ts`** covers the rest of the public API, which nothing else would
+call on the browser or worker bundles: constants, baseline generation and
+validation, measurement, font loading and the font cache. Each is called with
+identical inputs on all three bundles and the results compared. It also asserts
+the three export the same names, that every export has a probe, and that each
+bundle ran in the host it is built for — a `typeof DOMPoint` check cannot tell a
+page from a worker, since both have the native globals.
+
+### The report
+
+Every run writes `__tests__/platform-output/report.html`: one self-contained file
+with each scenario's committed reference beside what each bundle drew, badged
+with both comparisons, plus the diff images and the browser's user agent. It is
+gitignored and collected as a CI artifact from `platform-test` whether the run
+passed or failed, so a by-eye check is always available. The SVG each bundle
+produced is written alongside it, so a difference the report shows as pixels can
+be diffed as text.
+
+### Fonts
+
+Served from the test process, so every platform fetches byte-identical bytes from
+the same URL and the font is never a variable. Three, chosen for what they
+exercise:
+
+- **Bangers** — irregular display face: curves, diagonals, varying stroke widths.
+  Caps only.
+- **Lora** — high-contrast serif with true lowercase, so descenders feed the
+  baseline and line-height calculation.
+- **giants-color** — glyphs stored as SVG documents, the only path that goes
+  through a `DOMParser` and back out through an `XMLSerializer`.
+
+The two added faces are OFL, with their licences beside them in
+`__tests__/fixtures/`.
+
+### Updating the references
+
+```bash
+UPDATE_FIXTURES=true npm run test:platform
+```
+
+Rewrites every reference from the node bundle's render, then still checks the
+other two against what it just stored. Review the diffs in the report before
+committing.
+
 ## Regression tests
 
 Regression tests live in `__tests__/regression.test.ts` and use fixture pairs in `__tests__/fixtures/regression/`:

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

@@ -0,0 +1,7 @@
+import { t as e } from "./rolldown-runtime-DtPi1Y-2.js";
+//#region __vite-browser-external
+var t = /* @__PURE__ */ e(((e, t) => {
+	t.exports = {};
+}));
+//#endregion
+export default t();

package/dist/baselines/index.d.ts

@@ -0,0 +1,59 @@
+import { BaselineConfig, BaselineType, BoxDimensions, VerticalTextAlignmentValues } from '../types';
+/**
+ * Normalise a baseline option (string shorthand or object) into a BaselineConfig.
+ */
+export declare const normaliseBaselineOption: (baseline: BaselineType | BaselineConfig | undefined) => BaselineConfig;
+/**
+ * Validate a custom baseline SVG path string.
+ */
+export declare const validateCustomBaselinePath: (path: string) => void;
+export interface GenerateFlatBaselineOptions {
+    boxDimensions: BoxDimensions;
+    totalTextHeight: number;
+    baseline: number;
+    lineHeight: number;
+    verticalAlignment?: VerticalTextAlignmentValues;
+    lineNumber?: number;
+}
+/**
+ * Generate a path as a baseline for straight text
+ * This can be called multiple times for multiline text by incrementing the lineNumber parameter
+ *
+ * @returns an SVG path command to draw the baseline
+ */
+export declare const generateFlatBaseline: ({ boxDimensions, totalTextHeight, baseline, lineHeight, verticalAlignment, lineNumber, }: GenerateFlatBaselineOptions) => string;
+export interface GenerateCurvedBaselineOptions {
+    boxDimensions: BoxDimensions;
+    baseline: number;
+    textHeight: number;
+    verticalAlignment: VerticalTextAlignmentValues;
+}
+/** Where the arch sits vertically: its peak, and the baseline at its ends. */
+export interface CurvedBaselineGeometry {
+    /** y of the peak — the highest point of the baseline. */
+    curveTop: number;
+    /** y of the two ends — the lowest points of the baseline. */
+    curveBottom: number;
+    /** Horizontal gap left at each end so the outer glyphs are not clipped. */
+    curveXInset: number;
+}
+/**
+ * The arch's placement, on its own so that the path and anything reasoning
+ * about where the text will land come from one calculation.
+ *
+ * Sizing needs this: it has to know where the renderer will actually put the
+ * baseline before it can say whether the text riding it clears the box. Working
+ * that out separately is what let the fit engine believe a size fitted while
+ * the render clipped.
+ */
+export declare const curvedBaselineGeometry: ({ boxDimensions, baseline, textHeight, verticalAlignment, }: GenerateCurvedBaselineOptions) => CurvedBaselineGeometry;
+/**
+ * Generate a path command to curve text and align that text to the top of the box.
+ * Uses two quadratic bezier curves — one from the bottom left to the peak, and a
+ * second mirrored from the peak to the end.
+ *
+ * Curved text is not currently supported for multiline text.
+ *
+ * @returns an SVG path command to draw the curve
+ */
+export declare const generateCurvedBaseline: ({ boxDimensions, baseline, textHeight, verticalAlignment, }: GenerateCurvedBaselineOptions) => string;

package/dist/ce-adapter/index.cjs

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

package/dist/ce-adapter/index.js

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

package/dist/constants.d.ts

@@ -0,0 +1,5 @@
+import { TextSpacing } from './types';
+export declare const DEFAULT_OUTLINE_FACTOR = 0.03125;
+export declare const LINE_HEIGHT = 1.1;
+export declare const CURVE_DEPTH = 0.2;
+export declare const DEFAULT_SPACING: TextSpacing;