js.documents 2.0.0 → 2.2.0

package/dist/svg/text.js

@@ -0,0 +1,19 @@
+//#region src/svg/text.ts
+var SvgInvalidUtf8Error = class extends Error {
+	constructor() {
+		super("svg text must be well-formed UTF-8");
+		this.name = "SvgInvalidUtf8Error";
+	}
+};
+function decodeSvgText(bytes) {
+	try {
+		return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+	} catch {
+		throw new SvgInvalidUtf8Error();
+	}
+}
+function encodeSvgText(text) {
+	return new TextEncoder().encode(text);
+}
+//#endregion
+export { SvgInvalidUtf8Error, decodeSvgText, encodeSvgText };

package/dist/svg/transform.cjs

@@ -0,0 +1,206 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/svg/transform.ts
+const IDENTITY_MATRIX = {
+	a: 1,
+	b: 0,
+	c: 0,
+	d: 1,
+	e: 0,
+	f: 0
+};
+function applyMatrix(m, x, y) {
+	return {
+		x: m.a * x + m.c * y + m.e,
+		y: m.b * x + m.d * y + m.f
+	};
+}
+function composeMatrices(outer, inner) {
+	return {
+		a: outer.a * inner.a + outer.c * inner.b,
+		b: outer.b * inner.a + outer.d * inner.b,
+		c: outer.a * inner.c + outer.c * inner.d,
+		d: outer.b * inner.c + outer.d * inner.d,
+		e: outer.a * inner.e + outer.c * inner.f + outer.e,
+		f: outer.b * inner.e + outer.d * inner.f + outer.f
+	};
+}
+function applyScale(m, factor) {
+	return {
+		a: m.a * factor,
+		b: m.b * factor,
+		c: m.c * factor,
+		d: m.d * factor,
+		e: m.e * factor,
+		f: m.f * factor
+	};
+}
+function meanScaleFactor(m) {
+	return (Math.hypot(m.a, m.b) + Math.hypot(m.c, m.d)) / 2;
+}
+function isAxisAligned(m) {
+	return m.b === 0 && m.c === 0;
+}
+function isNonReflectingSimilarity(m) {
+	if (isAxisAligned(m)) return true;
+	if (m.a * m.d - m.b * m.c < 0) return false;
+	return Math.abs(m.a * m.a + m.b * m.b - (m.c * m.c + m.d * m.d)) < 1e-9;
+}
+function similarityRotationDeg(m) {
+	return Math.atan2(m.b, m.a) * 180 / Math.PI;
+}
+const TRANSFORM_NUMBER = /[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?/y;
+const TRANSFORM_FUNCTIONS = [
+	"translate",
+	"scale",
+	"rotate",
+	"skewX",
+	"skewY",
+	"matrix"
+];
+function skipTransformSeparators(source, scanner) {
+	let comma = false;
+	while (scanner.pos < source.length && /[\s,]/.test(source[scanner.pos])) {
+		if (source[scanner.pos] === ",") comma = true;
+		scanner.pos++;
+	}
+	return comma;
+}
+function scanTransformNumber(source, scanner) {
+	TRANSFORM_NUMBER.lastIndex = scanner.pos;
+	const match = TRANSFORM_NUMBER.exec(source);
+	if (match === null) return;
+	scanner.pos = TRANSFORM_NUMBER.lastIndex;
+	const value = Number(match[0]);
+	return Number.isFinite(value) ? value : void 0;
+}
+function matrixFromFunction(name, args) {
+	switch (name) {
+		case "translate":
+			if (args.length !== 1 && args.length !== 2) return;
+			return {
+				a: 1,
+				b: 0,
+				c: 0,
+				d: 1,
+				e: args[0],
+				f: args[1] ?? 0
+			};
+		case "scale": {
+			if (args.length !== 1 && args.length !== 2) return;
+			const sx = args[0];
+			return {
+				a: sx,
+				b: 0,
+				c: 0,
+				d: args[1] ?? sx,
+				e: 0,
+				f: 0
+			};
+		}
+		case "rotate": {
+			if (args.length !== 1 && args.length !== 3) return;
+			const radians = args[0] * Math.PI / 180;
+			const cos = Math.cos(radians);
+			const sin = Math.sin(radians);
+			const rotation = {
+				a: cos,
+				b: sin,
+				c: -sin,
+				d: cos,
+				e: 0,
+				f: 0
+			};
+			if (args.length === 1) return rotation;
+			const cx = args[1];
+			const cy = args[2];
+			return composeMatrices(composeMatrices({
+				a: 1,
+				b: 0,
+				c: 0,
+				d: 1,
+				e: cx,
+				f: cy
+			}, rotation), {
+				a: 1,
+				b: 0,
+				c: 0,
+				d: 1,
+				e: -cx,
+				f: -cy
+			});
+		}
+		case "skewX":
+			if (args.length !== 1) return;
+			return {
+				a: 1,
+				b: 0,
+				c: Math.tan(args[0] * Math.PI / 180),
+				d: 1,
+				e: 0,
+				f: 0
+			};
+		case "skewY":
+			if (args.length !== 1) return;
+			return {
+				a: 1,
+				b: Math.tan(args[0] * Math.PI / 180),
+				c: 0,
+				d: 1,
+				e: 0,
+				f: 0
+			};
+		case "matrix":
+			if (args.length !== 6) return;
+			return {
+				a: args[0],
+				b: args[1],
+				c: args[2],
+				d: args[3],
+				e: args[4],
+				f: args[5]
+			};
+	}
+}
+function parseSvgTransform(raw) {
+	if (raw === void 0) return;
+	const source = raw.trim();
+	if (source === "") return;
+	const scanner = { pos: 0 };
+	let total;
+	for (;;) {
+		skipTransformSeparators(source, scanner);
+		if (scanner.pos >= source.length) break;
+		const name = TRANSFORM_FUNCTIONS.find((candidate) => source.startsWith(candidate, scanner.pos));
+		if (name === void 0) return;
+		scanner.pos += name.length;
+		skipTransformSeparators(source, scanner);
+		if (source[scanner.pos] !== "(") return;
+		scanner.pos++;
+		const args = [];
+		for (;;) {
+			const hadComma = skipTransformSeparators(source, scanner);
+			if (source[scanner.pos] === ")") {
+				if (hadComma) return;
+				scanner.pos++;
+				break;
+			}
+			const value = scanTransformNumber(source, scanner);
+			if (value === void 0) return;
+			args.push(value);
+		}
+		const step = matrixFromFunction(name, args);
+		if (step === void 0) return;
+		total = total === void 0 ? step : composeMatrices(total, step);
+	}
+	return total;
+}
+//#endregion
+exports.IDENTITY_MATRIX = IDENTITY_MATRIX;
+exports.applyMatrix = applyMatrix;
+exports.applyScale = applyScale;
+exports.composeMatrices = composeMatrices;
+exports.isAxisAligned = isAxisAligned;
+exports.isNonReflectingSimilarity = isNonReflectingSimilarity;
+exports.meanScaleFactor = meanScaleFactor;
+exports.parseSvgTransform = parseSvgTransform;
+exports.similarityRotationDeg = similarityRotationDeg;

package/dist/svg/transform.d.cts

@@ -0,0 +1,23 @@
+//#region src/svg/transform.d.ts
+interface AffineMatrix {
+  readonly a: number;
+  readonly b: number;
+  readonly c: number;
+  readonly d: number;
+  readonly e: number;
+  readonly f: number;
+}
+declare const IDENTITY_MATRIX: AffineMatrix;
+declare function applyMatrix(m: AffineMatrix, x: number, y: number): {
+  readonly x: number;
+  readonly y: number;
+};
+declare function composeMatrices(outer: AffineMatrix, inner: AffineMatrix): AffineMatrix;
+declare function applyScale(m: AffineMatrix, factor: number): AffineMatrix;
+declare function meanScaleFactor(m: AffineMatrix): number;
+declare function isAxisAligned(m: AffineMatrix): boolean;
+declare function isNonReflectingSimilarity(m: AffineMatrix): boolean;
+declare function similarityRotationDeg(m: AffineMatrix): number;
+declare function parseSvgTransform(raw: string | undefined): AffineMatrix | undefined;
+//#endregion
+export { AffineMatrix, IDENTITY_MATRIX, applyMatrix, applyScale, composeMatrices, isAxisAligned, isNonReflectingSimilarity, meanScaleFactor, parseSvgTransform, similarityRotationDeg };

package/dist/svg/transform.d.ts

@@ -0,0 +1,23 @@
+//#region src/svg/transform.d.ts
+interface AffineMatrix {
+  readonly a: number;
+  readonly b: number;
+  readonly c: number;
+  readonly d: number;
+  readonly e: number;
+  readonly f: number;
+}
+declare const IDENTITY_MATRIX: AffineMatrix;
+declare function applyMatrix(m: AffineMatrix, x: number, y: number): {
+  readonly x: number;
+  readonly y: number;
+};
+declare function composeMatrices(outer: AffineMatrix, inner: AffineMatrix): AffineMatrix;
+declare function applyScale(m: AffineMatrix, factor: number): AffineMatrix;
+declare function meanScaleFactor(m: AffineMatrix): number;
+declare function isAxisAligned(m: AffineMatrix): boolean;
+declare function isNonReflectingSimilarity(m: AffineMatrix): boolean;
+declare function similarityRotationDeg(m: AffineMatrix): number;
+declare function parseSvgTransform(raw: string | undefined): AffineMatrix | undefined;
+//#endregion
+export { AffineMatrix, IDENTITY_MATRIX, applyMatrix, applyScale, composeMatrices, isAxisAligned, isNonReflectingSimilarity, meanScaleFactor, parseSvgTransform, similarityRotationDeg };

package/dist/svg/transform.js

@@ -0,0 +1,197 @@
+//#region src/svg/transform.ts
+const IDENTITY_MATRIX = {
+	a: 1,
+	b: 0,
+	c: 0,
+	d: 1,
+	e: 0,
+	f: 0
+};
+function applyMatrix(m, x, y) {
+	return {
+		x: m.a * x + m.c * y + m.e,
+		y: m.b * x + m.d * y + m.f
+	};
+}
+function composeMatrices(outer, inner) {
+	return {
+		a: outer.a * inner.a + outer.c * inner.b,
+		b: outer.b * inner.a + outer.d * inner.b,
+		c: outer.a * inner.c + outer.c * inner.d,
+		d: outer.b * inner.c + outer.d * inner.d,
+		e: outer.a * inner.e + outer.c * inner.f + outer.e,
+		f: outer.b * inner.e + outer.d * inner.f + outer.f
+	};
+}
+function applyScale(m, factor) {
+	return {
+		a: m.a * factor,
+		b: m.b * factor,
+		c: m.c * factor,
+		d: m.d * factor,
+		e: m.e * factor,
+		f: m.f * factor
+	};
+}
+function meanScaleFactor(m) {
+	return (Math.hypot(m.a, m.b) + Math.hypot(m.c, m.d)) / 2;
+}
+function isAxisAligned(m) {
+	return m.b === 0 && m.c === 0;
+}
+function isNonReflectingSimilarity(m) {
+	if (isAxisAligned(m)) return true;
+	if (m.a * m.d - m.b * m.c < 0) return false;
+	return Math.abs(m.a * m.a + m.b * m.b - (m.c * m.c + m.d * m.d)) < 1e-9;
+}
+function similarityRotationDeg(m) {
+	return Math.atan2(m.b, m.a) * 180 / Math.PI;
+}
+const TRANSFORM_NUMBER = /[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?/y;
+const TRANSFORM_FUNCTIONS = [
+	"translate",
+	"scale",
+	"rotate",
+	"skewX",
+	"skewY",
+	"matrix"
+];
+function skipTransformSeparators(source, scanner) {
+	let comma = false;
+	while (scanner.pos < source.length && /[\s,]/.test(source[scanner.pos])) {
+		if (source[scanner.pos] === ",") comma = true;
+		scanner.pos++;
+	}
+	return comma;
+}
+function scanTransformNumber(source, scanner) {
+	TRANSFORM_NUMBER.lastIndex = scanner.pos;
+	const match = TRANSFORM_NUMBER.exec(source);
+	if (match === null) return;
+	scanner.pos = TRANSFORM_NUMBER.lastIndex;
+	const value = Number(match[0]);
+	return Number.isFinite(value) ? value : void 0;
+}
+function matrixFromFunction(name, args) {
+	switch (name) {
+		case "translate":
+			if (args.length !== 1 && args.length !== 2) return;
+			return {
+				a: 1,
+				b: 0,
+				c: 0,
+				d: 1,
+				e: args[0],
+				f: args[1] ?? 0
+			};
+		case "scale": {
+			if (args.length !== 1 && args.length !== 2) return;
+			const sx = args[0];
+			return {
+				a: sx,
+				b: 0,
+				c: 0,
+				d: args[1] ?? sx,
+				e: 0,
+				f: 0
+			};
+		}
+		case "rotate": {
+			if (args.length !== 1 && args.length !== 3) return;
+			const radians = args[0] * Math.PI / 180;
+			const cos = Math.cos(radians);
+			const sin = Math.sin(radians);
+			const rotation = {
+				a: cos,
+				b: sin,
+				c: -sin,
+				d: cos,
+				e: 0,
+				f: 0
+			};
+			if (args.length === 1) return rotation;
+			const cx = args[1];
+			const cy = args[2];
+			return composeMatrices(composeMatrices({
+				a: 1,
+				b: 0,
+				c: 0,
+				d: 1,
+				e: cx,
+				f: cy
+			}, rotation), {
+				a: 1,
+				b: 0,
+				c: 0,
+				d: 1,
+				e: -cx,
+				f: -cy
+			});
+		}
+		case "skewX":
+			if (args.length !== 1) return;
+			return {
+				a: 1,
+				b: 0,
+				c: Math.tan(args[0] * Math.PI / 180),
+				d: 1,
+				e: 0,
+				f: 0
+			};
+		case "skewY":
+			if (args.length !== 1) return;
+			return {
+				a: 1,
+				b: Math.tan(args[0] * Math.PI / 180),
+				c: 0,
+				d: 1,
+				e: 0,
+				f: 0
+			};
+		case "matrix":
+			if (args.length !== 6) return;
+			return {
+				a: args[0],
+				b: args[1],
+				c: args[2],
+				d: args[3],
+				e: args[4],
+				f: args[5]
+			};
+	}
+}
+function parseSvgTransform(raw) {
+	if (raw === void 0) return;
+	const source = raw.trim();
+	if (source === "") return;
+	const scanner = { pos: 0 };
+	let total;
+	for (;;) {
+		skipTransformSeparators(source, scanner);
+		if (scanner.pos >= source.length) break;
+		const name = TRANSFORM_FUNCTIONS.find((candidate) => source.startsWith(candidate, scanner.pos));
+		if (name === void 0) return;
+		scanner.pos += name.length;
+		skipTransformSeparators(source, scanner);
+		if (source[scanner.pos] !== "(") return;
+		scanner.pos++;
+		const args = [];
+		for (;;) {
+			const hadComma = skipTransformSeparators(source, scanner);
+			if (source[scanner.pos] === ")") {
+				if (hadComma) return;
+				scanner.pos++;
+				break;
+			}
+			const value = scanTransformNumber(source, scanner);
+			if (value === void 0) return;
+			args.push(value);
+		}
+		const step = matrixFromFunction(name, args);
+		if (step === void 0) return;
+		total = total === void 0 ? step : composeMatrices(total, step);
+	}
+	return total;
+}
+//#endregion
+export { IDENTITY_MATRIX, applyMatrix, applyScale, composeMatrices, isAxisAligned, isNonReflectingSimilarity, meanScaleFactor, parseSvgTransform, similarityRotationDeg };

package/dist/svg/units.cjs

@@ -0,0 +1,47 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/svg/units.ts
+const PT_PER_PX = .75;
+const PT_PER_MM = 72 / 25.4;
+const PT_PER_CM = 720 / 25.4;
+const PT_PER_IN = 72;
+const SVG_NUMBER_PATTERN = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?$/;
+const SVG_LENGTH_PATTERN = /^([+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?)(px|pt|mm|cm|in|pc|q|em|ex|%)?$/;
+function parseSvgLengthPt(raw) {
+	if (raw === void 0) return;
+	const match = SVG_LENGTH_PATTERN.exec(raw.trim());
+	if (match === null) return;
+	const value = Number(match[1]);
+	if (!Number.isFinite(value)) return;
+	switch (match[2]) {
+		case void 0:
+		case "px": return value * PT_PER_PX;
+		case "pt": return value;
+		case "mm": return value * PT_PER_MM;
+		case "cm": return value * PT_PER_CM;
+		case "in": return value * PT_PER_IN;
+		case "pc": return value * 12;
+		case "q": return value * PT_PER_CM / 40;
+		default: return;
+	}
+}
+function parseSvgUserUnits(raw) {
+	const pt = parseSvgLengthPt(raw);
+	return pt === void 0 ? void 0 : pt / PT_PER_PX;
+}
+function parseSvgViewBox(raw) {
+	if (raw === void 0) return;
+	const parts = raw.trim().replace(/,/g, " ").split(/\s+/);
+	if (parts.length !== 4) return;
+	const numbers = parts.map((part) => SVG_NUMBER_PATTERN.test(part) ? Number(part) : NaN);
+	if (!numbers.every((value) => Number.isFinite(value)) || numbers[2] < 0 || numbers[3] < 0) return;
+	return {
+		minX: numbers[0],
+		minY: numbers[1],
+		width: numbers[2],
+		height: numbers[3]
+	};
+}
+//#endregion
+exports.parseSvgLengthPt = parseSvgLengthPt;
+exports.parseSvgUserUnits = parseSvgUserUnits;
+exports.parseSvgViewBox = parseSvgViewBox;

package/dist/svg/units.d.cts

@@ -0,0 +1,12 @@
+//#region src/svg/units.d.ts
+declare function parseSvgLengthPt(raw: string | undefined): number | undefined;
+declare function parseSvgUserUnits(raw: string | undefined): number | undefined;
+interface SvgViewBox {
+  readonly minX: number;
+  readonly minY: number;
+  readonly width: number;
+  readonly height: number;
+}
+declare function parseSvgViewBox(raw: string | undefined): SvgViewBox | undefined;
+//#endregion
+export { SvgViewBox, parseSvgLengthPt, parseSvgUserUnits, parseSvgViewBox };

package/dist/svg/units.d.ts

@@ -0,0 +1,12 @@
+//#region src/svg/units.d.ts
+declare function parseSvgLengthPt(raw: string | undefined): number | undefined;
+declare function parseSvgUserUnits(raw: string | undefined): number | undefined;
+interface SvgViewBox {
+  readonly minX: number;
+  readonly minY: number;
+  readonly width: number;
+  readonly height: number;
+}
+declare function parseSvgViewBox(raw: string | undefined): SvgViewBox | undefined;
+//#endregion
+export { SvgViewBox, parseSvgLengthPt, parseSvgUserUnits, parseSvgViewBox };

package/dist/svg/units.js

@@ -0,0 +1,44 @@
+//#region src/svg/units.ts
+const PT_PER_PX = .75;
+const PT_PER_MM = 72 / 25.4;
+const PT_PER_CM = 720 / 25.4;
+const PT_PER_IN = 72;
+const SVG_NUMBER_PATTERN = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?$/;
+const SVG_LENGTH_PATTERN = /^([+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?)(px|pt|mm|cm|in|pc|q|em|ex|%)?$/;
+function parseSvgLengthPt(raw) {
+	if (raw === void 0) return;
+	const match = SVG_LENGTH_PATTERN.exec(raw.trim());
+	if (match === null) return;
+	const value = Number(match[1]);
+	if (!Number.isFinite(value)) return;
+	switch (match[2]) {
+		case void 0:
+		case "px": return value * PT_PER_PX;
+		case "pt": return value;
+		case "mm": return value * PT_PER_MM;
+		case "cm": return value * PT_PER_CM;
+		case "in": return value * PT_PER_IN;
+		case "pc": return value * 12;
+		case "q": return value * PT_PER_CM / 40;
+		default: return;
+	}
+}
+function parseSvgUserUnits(raw) {
+	const pt = parseSvgLengthPt(raw);
+	return pt === void 0 ? void 0 : pt / PT_PER_PX;
+}
+function parseSvgViewBox(raw) {
+	if (raw === void 0) return;
+	const parts = raw.trim().replace(/,/g, " ").split(/\s+/);
+	if (parts.length !== 4) return;
+	const numbers = parts.map((part) => SVG_NUMBER_PATTERN.test(part) ? Number(part) : NaN);
+	if (!numbers.every((value) => Number.isFinite(value)) || numbers[2] < 0 || numbers[3] < 0) return;
+	return {
+		minX: numbers[0],
+		minY: numbers[1],
+		width: numbers[2],
+		height: numbers[3]
+	};
+}
+//#endregion
+export { parseSvgLengthPt, parseSvgUserUnits, parseSvgViewBox };