@unmade/text-renderer 1.1.1 → 1.2.0

package/dist/node/index.js

@@ -1,8 +1,8 @@
 import { Blob as e, Buffer as t, Face as n, Feature as r, Font as i, shape as a } from "harfbuzzjs";
-import { svgPathProperties as o } from "svg-path-properties";
+import o from "@thednp/dommatrix";
 import { DOMParser as s } from "linkedom";
 import "node:path";
-import c from "@thednp/dommatrix";
+import { svgPathProperties as c } from "svg-path-properties";
 //#region src/loading/createLoadedFont.ts
 function l(e) {
 	let t = Infinity, n = Infinity, r = -Infinity, i = -Infinity, a = 0, o = 0;
@@ -237,18 +237,18 @@ var x = async (t, r = !1) => {
 	let a = f.get(t);
 	if (a) {
 		if (r && !a.svgGlyphs) {
-			let r = new n(new e(await b(t))), o = new i(r), s = r.referenceTable("SVG ");
-			a.svgGlyphs = s ? await _(s, o, r.upem) : /* @__PURE__ */ new Map();
+			let r = await b(t), o = new e(r), s = new n(o), c = new i(s), l = s.referenceTable("SVG ");
+			a.svgGlyphs = l ? await _(l, c, s.upem) : /* @__PURE__ */ new Map();
 		}
 		return a;
 	}
-	let o = new n(new e(await b(t))), s = new i(o), c = o.getName(1, "en") ?? "", l;
+	let o = await b(t), s = new e(o), c = new n(s), l = new i(c), u = c.getName(1, "en") ?? "", p;
 	if (r) {
-		let e = o.referenceTable("SVG ");
-		l = e ? await _(e, s, o.upem) : /* @__PURE__ */ new Map();
+		let e = c.referenceTable("SVG ");
+		p = e ? await _(e, l, c.upem) : /* @__PURE__ */ new Map();
 	}
-	let u = d(o, s, c, l);
-	return f.set(t, u), u;
+	let m = d(c, l, u, p);
+	return f.set(t, m), m;
 }, S = .03125, C = 1.1, w = .2, T = {
 	outlineWidth: S,
 	letterSpacing: 0,
@@ -267,36 +267,44 @@ var x = async (t, r = !1) => {
 		return `${this.x} ${this.y}`;
 	}
 };
-function D(e, t, n = new E(0, 0)) {
+function ee(e, t, n = new E(0, 0)) {
 	let r = e.X - n.X, i = e.Y - n.Y, a = t / 180 * Math.PI, o = Math.cos(a), s = Math.sin(a), c = r * o - i * s, l = r * s + i * o;
 	return new E(c + n.X, l + n.Y);
 }
 //#endregion
 //#region src/baselines/index.ts
-var O = (e) => e === void 0 || e === "flat" ? { type: "flat" } : e === "curved" ? { type: "curved" } : e, k = (e) => {
+var D = (e) => e === void 0 || e === "flat" ? { type: "flat" } : e === "curved" ? { type: "curved" } : e, O = (e) => {
 	if (!e || !e.trim()) throw Error("Custom baseline path must be a non-empty SVG path string");
 	if (!e.trim().startsWith("M")) throw Error("Custom baseline path must start with an M (moveto) command");
-}, A = ({ boxDimensions: e, totalTextHeight: t, baseline: n, lineHeight: r, verticalAlignment: i = "centre", lineNumber: a = 0 }) => {
+}, k = ({ boxDimensions: e, totalTextHeight: t, baseline: n, lineHeight: r, verticalAlignment: i = "centre", lineNumber: a = 0 }) => {
 	let { width: o, height: s } = e, c = r - n, l = n;
 	switch (i) {
 		case "centre":
 			l = (s - t) / 2 + r - c;
 			break;
-		case "bottom":
-			l = s - t + r - c;
-			break;
+		case "bottom": l = s - t + r - c;
 	}
 	return l += r * C * a, `M 0 ${l} L ${o} ${l}`;
-}, j = ({ boxDimensions: e, baseline: t, textHeight: n, verticalAlignment: r }) => {
-	let { width: i, height: a } = e, o = n * w, s = n + o, c = r === "top" ? 0 : a / 2 - s / 2, l = t + c, u = l + o;
-	if (r !== "top" && (u > a || l - n < 0)) return j({
+}, A = ({ boxDimensions: e, baseline: t, textHeight: n, verticalAlignment: r }) => {
+	let { height: i } = e, a = n * w, o = n + a, s = t + (r === "top" ? 0 : i / 2 - o / 2), c = s + a;
+	return r !== "top" && (c > i || s - n < 0) ? A({
 		boxDimensions: e,
 		baseline: t,
 		textHeight: n,
 		verticalAlignment: "top"
-	});
-	let d = n / 4, f = new E(d, u), p = new E(i / 2, l), m = new E(i - d, u), h = i * .2, g = new E(h, t + c), _ = new E(i - h, t + c);
-	return `${`M ${f.toSVGString()}`} ${`Q ${g.toSVGString()} ${p.toSVGString()}`} ${`Q ${_.toSVGString()} ${m.toSVGString()}`}`;
+	}) : {
+		curveTop: s,
+		curveBottom: c,
+		curveXInset: n / 4
+	};
+}, j = ({ boxDimensions: e, baseline: t, textHeight: n, verticalAlignment: r }) => {
+	let { width: i } = e, { curveTop: a, curveBottom: o, curveXInset: s } = A({
+		boxDimensions: e,
+		baseline: t,
+		textHeight: n,
+		verticalAlignment: r
+	}), c = new E(s, o), l = new E(i / 2, a), u = new E(i - s, o), d = i * .2, f = new E(d, a), p = new E(i - d, a);
+	return `${`M ${c.toSVGString()}`} ${`Q ${f.toSVGString()} ${l.toSVGString()}`} ${`Q ${p.toSVGString()} ${u.toSVGString()}`}`;
 }, M = (e) => {
 	for (let t of [
 		"I",
@@ -324,11 +332,11 @@ var O = (e) => e === void 0 || e === "flat" ? { type: "flat" } : e === "curved"
 		height: s.y2 - s.y1 + c,
 		baseline: s.y1 * -1 + c / 2
 	};
-}, I = s, ee = c, te = new I().parseFromString("<svg></svg>", "image/svg+xml");
-te.readyState = "complete";
+}, I = s, te = o, ne = new I().parseFromString("<svg></svg>", "image/svg+xml");
+ne.readyState = "complete";
 //#endregion
 //#region ../svg-helpers/dist/colours/named-colours.mjs
-var ne = {
+var re = {
 	aliceblue: "#f0f8ff",
 	antiquewhite: "#faebd7",
 	aqua: "#00ffff",
@@ -477,13 +485,13 @@ var ne = {
 	whitesmoke: "#f5f5f5",
 	yellow: "#ffff00",
 	yellowgreen: "#9acd32"
-}, re = (e) => {
+}, ie = (e) => {
 	let t = Array.from(e), n = !1;
 	return t[0] === "#" && (t.shift(), n = !0), t.length === 3 && (t = t.map((e) => `${e}${e}`)), `${n ? "#" : ""}${t.join("").toLowerCase()}`;
 }, L = (e) => Math.max(0, Math.min(255, Math.round(typeof e == "string" ? Number.parseInt(e, 10) : e))).toString(16).padStart(2, "0"), R = (...e) => {
 	let [t, n, r] = Array.isArray(e[0]) ? e[0] : e;
 	return `#${L(t)}${L(n)}${L(r)}`;
-}, ie = (e, t, n) => {
+}, ae = (e, t, n) => {
 	if (t === 0) {
 		let e = Math.round(n * 255);
 		return [
@@ -498,9 +506,9 @@ var ne = {
 		Math.round((c + o) * 255),
 		Math.round((l + o) * 255)
 	];
-}, ae = (e) => /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.test(e), z = (e) => {
+}, oe = (e) => /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.test(e), z = (e) => {
 	let t = e.trim().toLowerCase();
-	if (t.startsWith("#") || /^[0-9a-f]{3}([0-9a-f]{3})?$/.test(t)) return ae(t) ? re(t) : void 0;
+	if (t.startsWith("#") || /^[0-9a-f]{3}([0-9a-f]{3})?$/.test(t)) return oe(t) ? ie(t) : void 0;
 	if (t.startsWith("rgb")) {
 		let e = t.match(/rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(?:,\s*[\d.]+\s*)?\)/);
 		return e ? R(Number.parseInt(e[1], 10), Number.parseInt(e[2], 10), Number.parseInt(e[3], 10)) : void 0;
@@ -508,10 +516,10 @@ var ne = {
 	if (t.startsWith("hsl")) {
 		let e = t.match(/hsla?\(\s*(\d+)\s*,\s*([\d.]+)%\s*,\s*([\d.]+)%\s*(?:,\s*[\d.]+\s*)?\)/);
 		if (!e) return;
-		let [n, r, i] = ie(Number.parseInt(e[1], 10), Number.parseFloat(e[2]) / 100, Number.parseFloat(e[3]) / 100);
+		let [n, r, i] = ae(Number.parseInt(e[1], 10), Number.parseFloat(e[2]) / 100, Number.parseFloat(e[3]) / 100);
 		return R(n, r, i);
 	}
-	let n = ne[t];
+	let n = re[t];
 	if (n) return n;
 }, B = {
 	svg: "svg",
@@ -527,7 +535,7 @@ var ne = {
 }, V = {
 	fill: "fill",
 	stroke: "stroke"
-}, oe = {
+}, se = {
 	tiling: [
 		B.circle,
 		B.ellipse,
@@ -553,69 +561,69 @@ var ne = {
 		`[${V.fill}]`,
 		`[${V.stroke}]`
 	]
-}, se = (e) => Array.from(e.querySelectorAll(oe.tiling.map((e) => `*:not(clipPath) > ${e}`).join(", "))), H = (e) => {
+}, ce = (e) => Array.from(e.querySelectorAll(se.tiling.map((e) => `*:not(clipPath) > ${e}`).join(", "))), le = (e) => {
 	let t = e.getAttribute(V.stroke);
 	return t === "none" || !t ? !1 : t;
-}, U = (e) => {
+}, H = (e) => {
 	if (!(e === "none" || e === "transparent" || e.startsWith("url("))) return z(e);
-}, W = (e) => {
-	let t = se(e).reduce((e, t) => {
-		let n = t.getAttribute("stop-color"), r = t.getAttribute(V.fill) || "#000", i = H(t);
+}, ue = (e) => {
+	let t = ce(e).reduce((e, t) => {
+		let n = t.getAttribute("stop-color"), r = t.getAttribute(V.fill) || "#000", i = le(t);
 		if (r && !n) {
-			let t = U(r);
+			let t = H(r);
 			t && e.add(t);
 		}
 		if (n) {
-			let t = U(n);
+			let t = H(n);
 			t && e.add(t);
 		}
 		if (i) {
-			let t = U(i);
+			let t = H(i);
 			t && e.add(t);
 		}
 		return e;
 	}, /* @__PURE__ */ new Set());
 	return Array.from(t);
-}, G = (e) => {
+}, de = (e) => {
 	let t = new I().parseFromString(e, "image/svg+xml").querySelector("svg");
-	return t ? W(t) : [];
+	return t ? ue(t) : [];
 };
 //#endregion
 //#region src/glyph/svg-glyph-converter.ts
-function K(e) {
+function U(e) {
 	let t = e.trim(), n = t.startsWith("<svg") || t.startsWith("<?xml"), r = n ? t : `<svg>${t}</svg>`;
 	return {
 		doc: new I().parseFromString(r, "image/svg+xml"),
 		wasWrapped: !n
 	};
 }
-function q(e, t) {
+function W(e, t) {
 	let n = e.querySelector("svg");
 	return n ? t ? n.innerHTML : n.outerHTML : "";
 }
-function ce(e) {
+function fe(e) {
 	let { svgGlyphs: t } = e;
 	if (!t || t.size === 0) return [];
 	let n = /* @__PURE__ */ new Set();
-	for (let [, e] of t) for (let t of G(e.svg)) n.add(t);
+	for (let [, e] of t) for (let t of de(e.svg)) n.add(t);
 	return Array.from(n);
 }
-function le(e) {
+function pe(e) {
 	return !!e && e !== "none" && e !== "transparent" && !e.startsWith("url(");
 }
-function ue(e) {
+function me(e) {
 	let t = new I().parseFromString(e, "image/svg+xml").querySelector("svg");
 	return t ? t.innerHTML.trim() : "";
 }
-var de = [
+var he = [
 	"fill",
 	"stroke",
 	"clip-path",
 	"mask",
 	"filter"
 ];
-function fe(e, t) {
-	let { doc: n, wasWrapped: r } = K(e), i = /* @__PURE__ */ new Map();
+function ge(e, t) {
+	let { doc: n, wasWrapped: r } = U(e), i = /* @__PURE__ */ new Map();
 	for (let e of n.querySelectorAll("[id]")) {
 		let n = e.getAttribute("id");
 		if (!n) continue;
@@ -623,7 +631,7 @@ function fe(e, t) {
 		i.set(n, r), e.setAttribute("id", r);
 	}
 	if (i.size === 0) return e;
-	for (let e of de) for (let t of n.querySelectorAll(`[${e}]`)) {
+	for (let e of he) for (let t of n.querySelectorAll(`[${e}]`)) {
 		let n = t.getAttribute(e);
 		if (n) {
 			let r = n.replace(/url\(#([^)]+)\)/g, (e, t) => {
@@ -640,13 +648,13 @@ function fe(e, t) {
 			a && e.setAttribute(t, `#${a}`);
 		}
 	}
-	return q(n, r);
+	return W(n, r);
 }
-var pe = [
+var _e = [
 	"fill",
 	"stroke",
 	"stop-color"
-], me = [
+], ve = [
 	"path",
 	"rect",
 	"circle",
@@ -655,109 +663,95 @@ var pe = [
 	"polyline",
 	"text"
 ];
-function he(e, t) {
-	let { doc: n, wasWrapped: r } = K(e), i = {};
+function ye(e, t) {
+	let { doc: n, wasWrapped: r } = U(e), i = {};
 	for (let [e, n] of Object.entries(t)) i[z(e) ?? e.toLowerCase()] = n;
-	for (let e of pe) for (let t of n.querySelectorAll(`[${e}]`)) {
+	for (let e of _e) for (let t of n.querySelectorAll(`[${e}]`)) {
 		let n = t.getAttribute(e);
-		if (!n || !le(n)) continue;
+		if (!n || !pe(n)) continue;
 		let r = z(n), a = r ? i[r] : void 0;
 		a && t.setAttribute(e, a.hex);
 	}
 	let a = i["#000000"];
 	if (a) {
-		let e = me.map((e) => `${e}:not([fill])`).join(", ");
+		let e = ve.map((e) => `${e}:not([fill])`).join(", ");
 		for (let t of n.querySelectorAll(e)) t.setAttribute("fill", a.hex);
 	}
-	return q(n, r);
+	return W(n, r);
 }
 //#endregion
-//#region src/helpers/matrix.ts
-var ge = (e = [
-	1,
-	0,
-	0,
-	1,
-	0,
-	0
-]) => {
-	let t = new ee(`matrix(${e.join(",")})`);
-	if (!t) throw Error("Your browser does not support matrices");
-	return t;
-};
-//#endregion
 //#region src/helpers/xml.ts
-function _e(e) {
+function be(e) {
 	return e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/'/g, "&apos;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
 //#endregion
 //#region src/rendering/index.ts
-var J = (e, t, n) => e / n * t, Y = ({ font: e, baselinePath: t, text: n, fontSize: r, spacing: i = T, horizontalAlignment: a = "centre", colourMap: s }) => {
-	let { outlineWidth: c, letterSpacing: l, letterSpacingOutline: u } = i, d = new o(t), f = c ? r * c * 2 : 0, p = d.getTotalLength(), m = e.getPaths(n, 0, 0, r, { drawSVG: !1 }), h = e.getPath(n, 0, 0, r, { drawSVG: !1 }).getBoundingBox(), g = h.x1 - f / 2, _ = h.x2 + f / 2 - g, v = c > 0 ? u : l, y = v ? v * r : 0;
+var G = (e, t, n) => e / n * t, xe = ({ font: e, baselinePath: t, text: n, fontSize: r, spacing: i = T, horizontalAlignment: a = "centre", colourMap: o }) => {
+	let { outlineWidth: s, letterSpacing: l, letterSpacingOutline: u } = i, d = new c(t), f = s ? r * s * 2 : 0, p = d.getTotalLength(), m = e.getPaths(n, 0, 0, r, { drawSVG: !1 }), h = e.getPath(n, 0, 0, r, { drawSVG: !1 }).getBoundingBox(), g = h.x1 - f / 2, _ = h.x2 + f / 2 - g, v = s > 0 ? u : l, y = v ? v * r : 0;
 	a === "distributed" && (y = n.length === 1 ? 0 : (p - _) / (n.length - 1));
 	let b = y * (n.length - 1), x = _ + b, S = 0 - g;
 	a === "centre" ? S = (p - x) / 2 - g : a === "right" && (S = p - _ - g - b);
 	let C = [];
 	for (let t = 0; t < m.length; t++) {
-		let i = m[t], a = i.getBoundingBox(), o = e.charToGlyph(n[t]), { advanceWidth: c } = o;
+		let i = m[t], a = i.getBoundingBox(), s = e.charToGlyph(n[t]), { advanceWidth: c } = s;
 		if (!c) throw Error(`No advance width for character: ${n[t]} in font ${e.names.fontFamily}`);
-		let { x1: l, x2: u } = o.getBoundingBox(), f = J(c, r, e.unitsPerEm), h = J(u - l, r, e.unitsPerEm), g = S + a.x1;
+		let { x1: l, x2: u } = s.getBoundingBox(), f = G(c, r, e.unitsPerEm), h = G(u - l, r, e.unitsPerEm), g = S + a.x1;
 		if (t > 0 && (g += y * t), g + h > p) throw Error(`TOO_WIDE: character "${n[t]}" at index ${t} exceeds baseline path length (${Math.round(g + h)} > ${Math.round(p)})`);
-		let _ = g + f / 2, v = d.getTangentAtLength(_), b = Math.atan2(v.y, v.x) * 180 / Math.PI, x = d.getPointAtLength(g), w = x.x, T = x.y, O = a.x2 - a.x1, k = new E(a.x1 + O / 2, 0), A = D(new E(a.x1, 0), b, k), j = w - A.X, M = T - A.Y, N = ge();
-		N = N.translate(j, M);
-		let P;
+		let _ = g + f / 2, v = d.getTangentAtLength(_), b = Math.atan2(v.y, v.x) * 180 / Math.PI, x = d.getPointAtLength(g), w = x.x, T = x.y, D = a.x2 - a.x1, O = new E(a.x1 + D / 2, 0), k = ee(new E(a.x1, 0), b, O), A = w - k.X, j = T - k.Y, M = new te();
+		M = M.translate(A, j);
+		let N;
 		if (b) {
-			let e = a.x1 + O / 2;
-			N = N.translate(e, 0), N = N.rotate(b), N = N.translate(-e, 0), P = `translate(${j} ${M}) translate(${e} 0) rotate(${b}) translate(${-e} 0)`;
-		} else P = `translate(${j} ${M})`;
-		let F = i.toPathData(2);
-		F.length && !F.endsWith("Z") && (F += "Z", F = F.replace(/M/g, "ZM"), F = F.substring(1));
-		let I;
+			let e = a.x1 + D / 2;
+			M = M.translate(e, 0), M = M.rotate(b), M = M.translate(-e, 0), N = `translate(${A} ${j}) translate(${e} 0) rotate(${b}) translate(${-e} 0)`;
+		} else N = `translate(${A} ${j})`;
+		let P = i.toPathData(2);
+		P.length && !P.endsWith("Z") && (P += "Z", P = P.replace(/M/g, "ZM"), P = P.substring(1));
+		let F;
 		if (e.svgGlyphs) {
-			let n = e.svgGlyphs.get(o.index);
+			let n = e.svgGlyphs.get(s.index);
 			if (n) {
-				let e = ue(n.svg);
-				e = fe(e, `g${o.index}-${t}`), s && (e = he(e, s)), I = {
+				let e = me(n.svg);
+				e = ge(e, `g${s.index}-${t}`), o && (e = ye(e, o)), F = {
 					content: e,
 					viewBox: n.viewbox,
 					x: a.x1,
 					y: a.y1,
 					width: a.x2 - a.x1,
 					height: a.y2 - a.y1,
-					glyphIndex: o.index
+					glyphIndex: s.index
 				};
 			}
 		}
 		C.push({
 			path: i,
-			matrix: N,
+			matrix: M,
 			attributes: {
-				d: F,
-				"data-character": _e(n[t]),
-				transform: P
+				d: P,
+				"data-character": be(n[t]),
+				transform: N
 			},
 			glyphData: {
-				index: o.index,
+				index: s.index,
 				bbox: a
 			},
-			...I ? { svgGlyph: I } : {}
+			...F ? { svgGlyph: F } : {}
 		});
 	}
 	return C;
-}, X = { hex: "#FFFFFF" }, Z = (e, t) => {
+}, K = { hex: "#FFFFFF" }, q = (e, t) => {
 	let n = `data-${e}-colour-url`, r = [`${e}="${t.hex}"`];
 	return t.reference && r.push(`${n}="${t.reference}"`), r.join(" ");
-}, Q = (e, t) => {
+}, J = (e, t) => {
 	let { attributes: n, svgGlyph: r } = e;
-	return r ? `<g transform="${n.transform}" data-character="${n["data-character"]}"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="${r.viewBox}" width="${r.width}" height="${r.height}" x="${r.x}" y="${r.y}" data-glyph-index="${r.glyphIndex}">${r.content}</svg></g>` : `<path d="${n.d}" ${Z("fill", t)} transform="${n.transform}" data-character="${n["data-character"]}"/>`;
-}, ve = ({ boxDimensions: e, paths: t, spacing: n = T, fontSize: r = 0, fillColour: i = X, strokeColour: a = X }) => {
+	return r ? `<g transform="${n.transform}" data-character="${n["data-character"]}"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="${r.viewBox}" width="${r.width}" height="${r.height}" x="${r.x}" y="${r.y}" data-glyph-index="${r.glyphIndex}">${r.content}</svg></g>` : `<path d="${n.d}" ${q("fill", t)} transform="${n.transform}" data-character="${n["data-character"]}"/>`;
+}, Se = ({ boxDimensions: e, paths: t, spacing: n = T, fontSize: r = 0, fillColour: i = K, strokeColour: a = K }) => {
 	let { width: o, height: s } = e, { outlineWidth: c } = n, l = c > 0 && r > 0, u;
 	if (l) {
 		let e = r * c * 2;
-		u = `${t.filter((e) => !e.svgGlyph).map(({ attributes: t }) => `<path d="${t.d}" ${Z("fill", a)} ${Z("stroke", a)} stroke-width="${e}" stroke-linejoin="round" transform="${t.transform}" data-character="${t["data-character"]}"/>`).join("\n  ")}\n  ${t.map((e) => Q(e, i)).join("\n  ")}`;
-	} else u = t.map((e) => Q(e, i)).join("\n  ");
+		u = `${t.filter((e) => !e.svgGlyph).map(({ attributes: t }) => `<path d="${t.d}" ${q("fill", a)} ${q("stroke", a)} stroke-width="${e}" stroke-linejoin="round" transform="${t.transform}" data-character="${t["data-character"]}"/>`).join("\n  ")}\n  ${t.map((e) => J(e, i)).join("\n  ")}`;
+	} else u = t.map((e) => J(e, i)).join("\n  ");
 	return `<svg xmlns="http://www.w3.org/2000/svg" width="${o}" height="${s}" viewBox="0 0 ${o} ${s}">${u ? `\n  ${u}\n` : ""}</svg>`;
-}, $ = (e) => {
+}, Y = (e) => {
 	let { text: t, font: n, physicalSize: r, fontSize: i, boxDimensions: a, spacing: o = T, verticalAlignment: s = "centre", baseline: c = "flat", horizontalAlignment: l = "left", fillColour: u = { hex: "#FFFFFF" }, strokeColour: d = { hex: "#FFFFFF" }, colourMap: f } = e, { width: p, height: m, physicalWidth: h, physicalHeight: g } = a;
 	if (p <= 0 || m <= 0) throw Error(`boxDimensions width and height must be positive (got ${p}x${m})`);
 	if (h <= 0 || g <= 0) throw Error(`boxDimensions physicalWidth and physicalHeight must be positive (got ${h}x${g})`);
@@ -767,7 +761,7 @@ var J = (e, t, n) => e / n * t, Y = ({ font: e, baselinePath: t, text: n, fontSi
 		boxDimensions: a,
 		physicalSize: r,
 		spacing: o
-	}), v = O(c), y = t.split("\n").filter((e) => e.length > 0);
+	}), v = D(c), y = t.split("\n").filter((e) => e.length > 0);
 	y.length || (y = [""]), (v.type === "curved" || v.type === "custom") && (y = [y.join("")]);
 	let b = y.map((e) => F({
 		font: n,
@@ -779,7 +773,7 @@ var J = (e, t, n) => e / n * t, Y = ({ font: e, baselinePath: t, text: n, fontSi
 		let t;
 		switch (v.type) {
 			case "custom":
-				k(v.path), t = v.path;
+				O(v.path), t = v.path;
 				break;
 			case "curved": {
 				let e = F({
@@ -796,18 +790,16 @@ var J = (e, t, n) => e / n * t, Y = ({ font: e, baselinePath: t, text: n, fontSi
 				});
 				break;
 			}
-			case "flat":
-				t = A({
-					boxDimensions: a,
-					totalTextHeight: w,
-					baseline: x,
-					lineHeight: S,
-					verticalAlignment: s,
-					lineNumber: e
-				});
-				break;
+			case "flat": t = k({
+				boxDimensions: a,
+				totalTextHeight: w,
+				baseline: x,
+				lineHeight: S,
+				verticalAlignment: s,
+				lineNumber: e
+			});
 		}
-		let r = Y({
+		let r = xe({
 			font: n,
 			baselinePath: t,
 			text: y[e],
@@ -818,7 +810,7 @@ var J = (e, t, n) => e / n * t, Y = ({ font: e, baselinePath: t, text: n, fontSi
 		});
 		E.push(...r);
 	}
-	return ve({
+	return Se({
 		boxDimensions: a,
 		paths: E,
 		spacing: o,
@@ -826,15 +818,139 @@ var J = (e, t, n) => e / n * t, Y = ({ font: e, baselinePath: t, text: n, fontSi
 		fillColour: u,
 		strokeColour: d
 	});
-}, ye = async (e) => {
+}, X = 100, Ce = (e) => {
+	let t = e.split("\n").filter((e) => e.length > 0);
+	return t.length ? t : [""];
+}, we = (e) => e.split("\n").filter((e) => e.length > 0).join(""), Te = (e, t, n, r, i, a) => {
+	let o = F({
+		font: e,
+		text: M(e),
+		fontSize: n,
+		spacing: r
+	}), s = {
+		boxDimensions: i,
+		baseline: o.baseline,
+		textHeight: o.height,
+		verticalAlignment: a
+	}, l = new c(j(s)).getTotalLength(), { curveTop: u, curveBottom: d } = A(s), f = F({
+		font: e,
+		text: t,
+		fontSize: n,
+		spacing: r
+	}), p = u - f.baseline, m = d + (f.height - f.baseline);
+	return {
+		width: f.width <= l,
+		height: p >= 0 && m <= i.height
+	};
+}, Z = (e) => e.width && e.height, Q = (e) => e.width ? "height" : "width", Ee = .01, De = 60, Oe = ({ font: e, text: t, boxDimensions: n, spacing: r, verticalAlignment: i, minFontSize: a, maxFontSize: o }) => {
+	let s = we(t);
+	if (!s.length) return {
+		fontSize: o,
+		fits: !0,
+		boundBy: "requestedSize"
+	};
+	let c = (t) => Te(e, s, t, r, n, i), l = c(a);
+	if (!Z(l)) return {
+		fontSize: a,
+		fits: !1,
+		boundBy: Q(l)
+	};
+	if (Z(c(o))) return {
+		fontSize: o,
+		fits: !0,
+		boundBy: "requestedSize"
+	};
+	let u = a, d = o, f = 0;
+	for (; d - u > Ee && f < De;) {
+		let e = (u + d) / 2;
+		Z(c(e)) ? u = e : d = e, f++;
+	}
+	return {
+		fontSize: u,
+		fits: !0,
+		boundBy: Q(c(d))
+	};
+}, $ = (e) => {
+	let { font: t, text: n, boxDimensions: r, size: i, spacing: a = T, baseline: o = "flat", verticalAlignment: s = "centre" } = e, l = i.mode === "fitToBox" ? i.maxFontSize : i.mode === "fontSize" ? i.fontSize : P({
+		font: t,
+		boxDimensions: r,
+		physicalSize: i.physicalSize,
+		spacing: a
+	});
+	if (!n.length) return {
+		fontSize: l,
+		fits: !0,
+		boundBy: "requestedSize"
+	};
+	let u = D(o);
+	if (u.type === "curved") return Oe({
+		font: t,
+		text: n,
+		boxDimensions: r,
+		spacing: a,
+		verticalAlignment: s,
+		minFontSize: i.mode === "fitToBox" ? i.minFontSize : l,
+		maxFontSize: l
+	});
+	let d = Ce(n);
+	u.type === "custom" && (d = [d.join("")]);
+	let f = d.map((e) => F({
+		font: t,
+		text: e,
+		fontSize: X,
+		spacing: a
+	})), p = Math.max(...f.map((e) => e.baseline)) + Math.max(...f.map((e) => e.height - e.baseline)), m = d.length === 1 ? p : p + p * (d.length - 1) * C, h = Math.max(...f.map((e) => e.width)), g = (u.type === "custom" ? new c(u.path).getTotalLength() : r.width) / h, _ = r.height / m, v = g <= _ ? "width" : "height", y = X * Math.min(g, _);
+	return i.mode === "fitToBox" ? y < i.minFontSize ? {
+		fontSize: i.minFontSize,
+		fits: !1,
+		boundBy: v
+	} : y > i.maxFontSize ? {
+		fontSize: i.maxFontSize,
+		fits: !0,
+		boundBy: "requestedSize"
+	} : {
+		fontSize: y,
+		fits: !0,
+		boundBy: v
+	} : l <= y ? {
+		fontSize: l,
+		fits: !0,
+		boundBy: "requestedSize"
+	} : {
+		fontSize: l,
+		fits: !1,
+		boundBy: v
+	};
+}, ke = (e) => {
+	let t = e.text, n = t, r = 0, i = 0;
+	for (;;) {
+		let a = $({
+			...e,
+			text: n
+		});
+		if (a.fits) return {
+			...a,
+			text: n,
+			truncated: n !== t,
+			linesDropped: r,
+			charactersRemoved: i
+		};
+		let o = n.split("\n");
+		if (o.length > 1) n = o.slice(0, -1).join("\n"), r += 1;
+		else {
+			let e = n.slice(0, -1).trim();
+			i += n.length - e.length, n = e;
+		}
+	}
+}, Ae = async (e) => {
 	let { fontUrl: t, fontSizeFallback: n, ...r } = e, i = await x(t, !!r.colourMap);
 	try {
-		return $({
+		return Y({
 			...r,
 			font: i
 		});
 	} catch (e) {
-		if (n != null && e instanceof Error && e.message.startsWith("TOO_WIDE")) return $({
+		if (n != null && e instanceof Error && e.message.startsWith("TOO_WIDE")) return Y({
 			...r,
 			font: i,
 			fontSize: n
@@ -843,4 +959,4 @@ var J = (e, t, n) => e / n * t, Y = ({ font: e, baselinePath: t, text: n, fontSi
 	}
 };
 //#endregion
-export { S as DEFAULT_OUTLINE_FACTOR, T as DEFAULT_SPACING, C as LINE_HEIGHT, j as generateCurvedBaseline, A as generateFlatBaseline, p as getFontCache, ce as getFontColours, P as getFontSizeFromPhysicalSize, ye as getRenderedText, F as getTextMetricsAtFontSize, x as loadFont, O as normaliseBaselineOption, $ as renderText, k as validateCustomBaselinePath };
+export { S as DEFAULT_OUTLINE_FACTOR, T as DEFAULT_SPACING, C as LINE_HEIGHT, ke as fitAndTruncateTextToBox, j as generateCurvedBaseline, k as generateFlatBaseline, p as getFontCache, fe as getFontColours, P as getFontSizeFromPhysicalSize, $ as getFontSizeToFitBox, Ae as getRenderedText, F as getTextMetricsAtFontSize, x as loadFont, D as normaliseBaselineOption, Y as renderText, O as validateCustomBaselinePath };

package/dist/node/rendering/index.d.ts

@@ -1,5 +1,5 @@
 import { LoadedFont } from '../loading';
-import { ColourMap, GlyphFill, HorizontalTextAlignmentValues, TextSpacing } from '../types';
+import { ColourMap, GlyphFill, HorizontalTextAlignmentValues, PlatformMatrix, TextSpacing } from '../types';
 export interface SvgGlyphEntry {
     content: string;
     viewBox: string;
@@ -16,7 +16,7 @@ export interface PathEntry {
         transform: string;
     };
     path: unknown;
-    matrix: DOMMatrix;
+    matrix: PlatformMatrix;
     glyphData: {
         index: number;
         bbox: {

package/dist/node/types.d.ts

@@ -1,4 +1,7 @@
+import { DOMMatrix } from '@unmade/platform';
 import { LoadedFont } from './loading';
+/** The platform's matrix, which is not the same shape as the DOM's DOMMatrix. */
+export type PlatformMatrix = InstanceType<typeof DOMMatrix>;
 export type MeasurementUnits = 'mm' | 'in';
 export type BoxDimensions = {
     width: number;

package/dist/rendering/index.d.ts

@@ -1,5 +1,5 @@
 import { LoadedFont } from '../loading';
-import { ColourMap, GlyphFill, HorizontalTextAlignmentValues, TextSpacing } from '../types';
+import { ColourMap, GlyphFill, HorizontalTextAlignmentValues, PlatformMatrix, TextSpacing } from '../types';
 export interface SvgGlyphEntry {
     content: string;
     viewBox: string;
@@ -16,7 +16,7 @@ export interface PathEntry {
         transform: string;
     };
     path: unknown;
-    matrix: DOMMatrix;
+    matrix: PlatformMatrix;
     glyphData: {
         index: number;
         bbox: {