pa_font 0.3.5 → 0.3.7

package/dist/paFont.js

@@ -272,6 +272,8 @@ function mod(value, divisor) {
 }
 //#endregion
 //#region src/paFont/core.js
+var DEFAULT_TEXT_SIZE = 72;
+var DEFAULT_TEXT_SIZE_BASIS = "bbox";
 function layoutGlyphs(font, value, opts) {
 	const glyphs = [];
 	const renderOptions = toRenderOptions(opts);
@@ -321,12 +323,14 @@ function measureText(font, value, opts) {
 	const renderOptions = toRenderOptions(opts);
 	const bbox = resolveMeasuredBBox(font.getPath(value, opts.x, opts.y, opts.size, renderOptions).getBoundingBox(), opts.x, opts.y);
 	if (opts.anchor == null) return {
+		size: opts.size,
 		width: measureAdvanceWidth(font, value, opts),
 		bbox
 	};
 	const tx = opts.x - (bbox.x + bbox.w * opts.anchor.x);
 	const ty = opts.y - (bbox.y + bbox.h * opts.anchor.y);
 	return {
+		size: opts.size,
 		width: measureAdvanceWidth(font, value, opts),
 		bbox: translateRect(bbox, tx, ty)
 	};
@@ -544,8 +548,30 @@ function translateGlyphGeometry(geometry, tx, ty, glyphPosition) {
 		bbox: translateRect(geometry.bbox, tx, ty)
 	};
 }
+function resolveTextOptions(font, value, options = {}, config = {}) {
+	const sourceOptions = options ?? {};
+	return normalizeTextOptions({
+		...sourceOptions,
+		size: resolveTextSize(font, value, sourceOptions, config)
+	});
+}
+function resolveTextSize(font, value, options = {}, config = {}) {
+	const sourceOptions = options ?? {};
+	const sizeOption = sourceOptions.size;
+	if (!isTextSizeConstraint(sizeOption)) return normalizePositive(sizeOption, DEFAULT_TEXT_SIZE);
+	const fit = normalizeTextSizeConstraint(sizeOption, config.methodName);
+	const referenceSize = DEFAULT_TEXT_SIZE;
+	const measurement = measureText(font, String(value ?? ""), normalizeTextOptions({
+		...sourceOptions,
+		anchor: null,
+		size: referenceSize
+	}));
+	const measuredWidth = fit.basis === "advance" ? measurement.width : measurement.bbox.w;
+	if (!Number.isFinite(measuredWidth) || measuredWidth <= 0) return clampTextSize(referenceSize, fit.min, fit.max);
+	return clampTextSize(referenceSize * fit.width / measuredWidth, fit.min, fit.max);
+}
 function normalizeTextOptions(options = {}) {
-	const size = normalizePositive(options.size, 72);
+	const size = normalizePositive(options.size, DEFAULT_TEXT_SIZE);
 	const anchor = normalizeAnchor(options.anchor);
 	return {
 		x: normalizeNumber(options.x, 0),
@@ -613,6 +639,28 @@ function resolveMeasuredBBox(box, fallbackX, fallbackY) {
 function defaultEdgeEpsilon(size) {
 	return Math.min(1, Math.max(.01, size * .0025));
 }
+function isTextSizeConstraint(value) {
+	return value != null && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeTextSizeConstraint(value, methodName) {
+	const width = normalizeNonNegativeNumber(value.width, NaN);
+	if (!Number.isFinite(width)) throw new TypeError(`${methodName ?? "Text"} option "size.width" must be a non-negative number.`);
+	const min = normalizeNonNegativeNumber(value.min, 0);
+	const maxValue = value.max === Infinity ? Infinity : normalizeNonNegativeNumber(value.max, Number.POSITIVE_INFINITY);
+	const max = Number.isFinite(maxValue) ? Math.max(min, maxValue) : Infinity;
+	return {
+		width,
+		basis: value.basis === "advance" ? "advance" : DEFAULT_TEXT_SIZE_BASIS,
+		min,
+		max
+	};
+}
+function normalizeNonNegativeNumber(value, fallback) {
+	return Number.isFinite(value) && value >= 0 ? Number(value) : fallback;
+}
+function clampTextSize(value, min, max) {
+	return Math.min(max, Math.max(min, normalizeNonNegativeNumber(value, min)));
+}
 function toRenderOptions(opts) {
 	const renderOptions = { kerning: opts.kerning };
 	if (opts.letterSpacing != null) renderOptions.letterSpacing = opts.letterSpacing;
@@ -4593,14 +4641,17 @@ var paFont = class paFont {
 		return new paFont(await load(target, void 0, loadOptions));
 	}
 	text(value, options = {}) {
-		const opts = normalizeTextOptions(options);
-		assertValidAnchorOption("font.text()", options, opts.anchor);
-		return createTextShape(this._layoutText(String(value ?? ""), opts), opts, this);
+		const text = String(value ?? "");
+		const sourceOptions = options ?? {};
+		const opts = resolveTextOptions(this.font, text, sourceOptions, { methodName: "font.text()" });
+		assertValidAnchorOption("font.text()", sourceOptions, opts.anchor);
+		return createTextShape(this._layoutText(text, opts), opts, this);
 	}
 	glyph(value, options = {}) {
-		const opts = normalizeTextOptions(options);
-		assertValidAnchorOption("font.glyph()", options, opts.anchor);
 		const text = Array.from(String(value ?? ""))[0] ?? "";
+		const sourceOptions = options ?? {};
+		const opts = resolveTextOptions(this.font, text, sourceOptions, { methodName: "font.glyph()" });
+		assertValidAnchorOption("font.glyph()", sourceOptions, opts.anchor);
 		const glyph = this.font.charToGlyph(text);
 		const layout = {
 			text,
@@ -4621,9 +4672,11 @@ var paFont = class paFont {
 		return createTextShape(anchorSingleGlyphLayout(this.font, text, layout, opts), opts, this);
 	}
 	metrics(value, options = {}) {
-		const opts = normalizeTextOptions(options);
-		assertValidAnchorOption("font.metrics()", options, opts.anchor);
-		return measureText(this.font, String(value ?? ""), opts);
+		const text = String(value ?? "");
+		const sourceOptions = options ?? {};
+		const opts = resolveTextOptions(this.font, text, sourceOptions, { methodName: "font.metrics()" });
+		assertValidAnchorOption("font.metrics()", sourceOptions, opts.anchor);
+		return measureText(this.font, text, opts);
 	}
 	paragraph(value, options = {}) {
 		return createParagraph(this, String(value ?? ""), options);