js.documents 14.4.46 → 14.4.47

package/dist/svg/path.cjs

@@ -1,5 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/svg/path.ts
+const CUBIC_CONTROL_STEP = 2 / 3;
+const PI_RADIANS_IN_DEGREES = 180;
+const KAPPA_NUMERATOR = 4;
+const KAPPA_DENOMINATOR = 3;
+const KAPPA_ARG_QUARTER = 4;
 const PATH_NUMBER = /[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?/y;
 var PathScanner = class {
 	source;
@@ -68,11 +73,11 @@ function addQuad(cursor, acc, control, to) {
 		y: cursor.y
 	};
 	addCubic(cursor, acc, {
-		x: from.x + 2 / 3 * (control.x - from.x),
-		y: from.y + 2 / 3 * (control.y - from.y)
+		x: from.x + CUBIC_CONTROL_STEP * (control.x - from.x),
+		y: from.y + CUBIC_CONTROL_STEP * (control.y - from.y)
 	}, {
-		x: to.x + 2 / 3 * (control.x - to.x),
-		y: to.y + 2 / 3 * (control.y - to.y)
+		x: to.x + CUBIC_CONTROL_STEP * (control.x - to.x),
+		y: to.y + CUBIC_CONTROL_STEP * (control.y - to.y)
 	}, to);
 	cursor.lastQuadControl = control;
 }
@@ -85,7 +90,7 @@ function addArc(cursor, acc, rx, ry, xRotDeg, largeArc, sweep, to) {
 		if (from.x !== to.x || from.y !== to.y) addLine(cursor, acc, to);
 		return;
 	}
-	const xRot = xRotDeg * Math.PI / 180;
+	const xRot = xRotDeg * Math.PI / PI_RADIANS_IN_DEGREES;
 	const cosRot = Math.cos(xRot);
 	const sinRot = Math.sin(xRot);
 	const dx = (from.x - to.x) / 2;
@@ -120,7 +125,7 @@ function addArc(cursor, acc, rx, ry, xRotDeg, largeArc, sweep, to) {
 	else if (sweep === 1 && deltaTheta < 0) deltaTheta += 2 * Math.PI;
 	const segmentCount = Math.max(1, Math.ceil(Math.abs(deltaTheta) / (Math.PI / 2)));
 	const deltaPerSegment = deltaTheta / segmentCount;
-	const kappa = 4 / 3 * Math.tan(deltaPerSegment / 4);
+	const kappa = KAPPA_NUMERATOR / KAPPA_DENOMINATOR * Math.tan(deltaPerSegment / KAPPA_ARG_QUARTER);
 	const pointAt = (t) => ({
 		x: cx + rx * cosRot * Math.cos(t) - ry * sinRot * Math.sin(t),
 		y: cy + rx * sinRot * Math.cos(t) + ry * cosRot * Math.sin(t)

package/dist/svg/path.js

@@ -1,4 +1,9 @@
 //#region src/svg/path.ts
+const CUBIC_CONTROL_STEP = 2 / 3;
+const PI_RADIANS_IN_DEGREES = 180;
+const KAPPA_NUMERATOR = 4;
+const KAPPA_DENOMINATOR = 3;
+const KAPPA_ARG_QUARTER = 4;
 const PATH_NUMBER = /[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?/y;
 var PathScanner = class {
 	source;
@@ -67,11 +72,11 @@ function addQuad(cursor, acc, control, to) {
 		y: cursor.y
 	};
 	addCubic(cursor, acc, {
-		x: from.x + 2 / 3 * (control.x - from.x),
-		y: from.y + 2 / 3 * (control.y - from.y)
+		x: from.x + CUBIC_CONTROL_STEP * (control.x - from.x),
+		y: from.y + CUBIC_CONTROL_STEP * (control.y - from.y)
 	}, {
-		x: to.x + 2 / 3 * (control.x - to.x),
-		y: to.y + 2 / 3 * (control.y - to.y)
+		x: to.x + CUBIC_CONTROL_STEP * (control.x - to.x),
+		y: to.y + CUBIC_CONTROL_STEP * (control.y - to.y)
 	}, to);
 	cursor.lastQuadControl = control;
 }
@@ -84,7 +89,7 @@ function addArc(cursor, acc, rx, ry, xRotDeg, largeArc, sweep, to) {
 		if (from.x !== to.x || from.y !== to.y) addLine(cursor, acc, to);
 		return;
 	}
-	const xRot = xRotDeg * Math.PI / 180;
+	const xRot = xRotDeg * Math.PI / PI_RADIANS_IN_DEGREES;
 	const cosRot = Math.cos(xRot);
 	const sinRot = Math.sin(xRot);
 	const dx = (from.x - to.x) / 2;
@@ -119,7 +124,7 @@ function addArc(cursor, acc, rx, ry, xRotDeg, largeArc, sweep, to) {
 	else if (sweep === 1 && deltaTheta < 0) deltaTheta += 2 * Math.PI;
 	const segmentCount = Math.max(1, Math.ceil(Math.abs(deltaTheta) / (Math.PI / 2)));
 	const deltaPerSegment = deltaTheta / segmentCount;
-	const kappa = 4 / 3 * Math.tan(deltaPerSegment / 4);
+	const kappa = KAPPA_NUMERATOR / KAPPA_DENOMINATOR * Math.tan(deltaPerSegment / KAPPA_ARG_QUARTER);
 	const pointAt = (t) => ({
 		x: cx + rx * cosRot * Math.cos(t) - ry * sinRot * Math.sin(t),
 		y: cy + rx * sinRot * Math.cos(t) + ry * cosRot * Math.sin(t)

package/dist/svg/read.cjs

@@ -6,14 +6,18 @@ const require_svg_transform = require("./transform.cjs");
 let ooxml_js = require("ooxml.js");
 let odf_js = require("odf.js");
 //#region src/svg/read.ts
+const ASPECT_DISPLAY_DECIMALS = 4;
+const ASPECT_COMPARE_TOLERANCE = 1e-6;
 var SvgMissingRootElementError = class extends Error {
 	constructor() {
 		super("svg text must contain an <svg> root element");
 		this.name = "SvgMissingRootElementError";
 	}
 };
-const DEFAULT_WIDTH_PT = 225;
-const DEFAULT_HEIGHT_PT = 112.5;
+const DEFAULT_VIEWPORT_WIDTH_PX = 300;
+const DEFAULT_VIEWPORT_HEIGHT_PX = 150;
+const DEFAULT_WIDTH_PT = DEFAULT_VIEWPORT_WIDTH_PX * require_svg_units.PT_PER_PX;
+const DEFAULT_HEIGHT_PT = DEFAULT_VIEWPORT_HEIGHT_PX * require_svg_units.PT_PER_PX;
 const KAPPA = 4 / 3 * (Math.SQRT2 - 1);
 function localName(tag) {
 	return tag.slice(tag.indexOf(":") + 1);
@@ -629,7 +633,7 @@ function resolveRootGeometry(root, state) {
 	if (preserveAspectRatio.trim() !== "none") {
 		const viewBoxAspect = viewBox.width / viewBox.height;
 		const pageAspect = widthPt / heightPt;
-		if (Math.abs(viewBoxAspect - pageAspect) > 1e-6 * Math.max(viewBoxAspect, pageAspect)) report(state, "svg/preserve-aspect-ratio-stretched", `viewBox aspect ${viewBoxAspect.toFixed(4)} stretched onto page aspect ${pageAspect.toFixed(4)} under preserveAspectRatio="${preserveAspectRatio.trim()}" (letterboxing is out of scope)`);
+		if (Math.abs(viewBoxAspect - pageAspect) > ASPECT_COMPARE_TOLERANCE * Math.max(viewBoxAspect, pageAspect)) report(state, "svg/preserve-aspect-ratio-stretched", `viewBox aspect ${viewBoxAspect.toFixed(ASPECT_DISPLAY_DECIMALS)} stretched onto page aspect ${pageAspect.toFixed(ASPECT_DISPLAY_DECIMALS)} under preserveAspectRatio="${preserveAspectRatio.trim()}" (letterboxing is out of scope)`);
 	}
 	const sx = widthPt / viewBox.width;
 	const sy = heightPt / viewBox.height;

package/dist/svg/read.js

@@ -1,18 +1,22 @@
 import { parseSvgDashStyle, parseSvgPaint } from "./paint.js";
 import { parseSvgPathData } from "./path.js";
-import { parseSvgLengthPt, parseSvgUserUnits, parseSvgViewBox } from "./units.js";
+import { PT_PER_PX, parseSvgLengthPt, parseSvgUserUnits, parseSvgViewBox } from "./units.js";
 import { applyMatrix, composeMatrices, isAxisAligned, isNonReflectingSimilarity, meanScaleFactor, parseSvgTransform, similarityRotationDeg } from "./transform.js";
 import { decodeEntities } from "ooxml.js";
 import { parseXml } from "odf.js";
 //#region src/svg/read.ts
+const ASPECT_DISPLAY_DECIMALS = 4;
+const ASPECT_COMPARE_TOLERANCE = 1e-6;
 var SvgMissingRootElementError = class extends Error {
 	constructor() {
 		super("svg text must contain an <svg> root element");
 		this.name = "SvgMissingRootElementError";
 	}
 };
-const DEFAULT_WIDTH_PT = 225;
-const DEFAULT_HEIGHT_PT = 112.5;
+const DEFAULT_VIEWPORT_WIDTH_PX = 300;
+const DEFAULT_VIEWPORT_HEIGHT_PX = 150;
+const DEFAULT_WIDTH_PT = DEFAULT_VIEWPORT_WIDTH_PX * PT_PER_PX;
+const DEFAULT_HEIGHT_PT = DEFAULT_VIEWPORT_HEIGHT_PX * PT_PER_PX;
 const KAPPA = 4 / 3 * (Math.SQRT2 - 1);
 function localName(tag) {
 	return tag.slice(tag.indexOf(":") + 1);
@@ -628,7 +632,7 @@ function resolveRootGeometry(root, state) {
 	if (preserveAspectRatio.trim() !== "none") {
 		const viewBoxAspect = viewBox.width / viewBox.height;
 		const pageAspect = widthPt / heightPt;
-		if (Math.abs(viewBoxAspect - pageAspect) > 1e-6 * Math.max(viewBoxAspect, pageAspect)) report(state, "svg/preserve-aspect-ratio-stretched", `viewBox aspect ${viewBoxAspect.toFixed(4)} stretched onto page aspect ${pageAspect.toFixed(4)} under preserveAspectRatio="${preserveAspectRatio.trim()}" (letterboxing is out of scope)`);
+		if (Math.abs(viewBoxAspect - pageAspect) > ASPECT_COMPARE_TOLERANCE * Math.max(viewBoxAspect, pageAspect)) report(state, "svg/preserve-aspect-ratio-stretched", `viewBox aspect ${viewBoxAspect.toFixed(ASPECT_DISPLAY_DECIMALS)} stretched onto page aspect ${pageAspect.toFixed(ASPECT_DISPLAY_DECIMALS)} under preserveAspectRatio="${preserveAspectRatio.trim()}" (letterboxing is out of scope)`);
 	}
 	const sx = widthPt / viewBox.width;
 	const sy = heightPt / viewBox.height;

package/dist/svg/transform.cjs

@@ -1,5 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/svg/transform.ts
+const PI_RADIANS_IN_DEGREES = 180;
+const SIMILARITY_AXIS_TOLERANCE = 1e-9;
+const ROTATE_WITH_CENTRE_ARGUMENT_COUNT = 3;
+const MATRIX_ARGUMENT_COUNT = 6;
 const IDENTITY_MATRIX = {
 	a: 1,
 	b: 0,
@@ -43,10 +47,10 @@ function isAxisAligned(m) {
 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;
+	return Math.abs(m.a * m.a + m.b * m.b - (m.c * m.c + m.d * m.d)) < SIMILARITY_AXIS_TOLERANCE;
 }
 function similarityRotationDeg(m) {
-	return Math.atan2(m.b, m.a) * 180 / Math.PI;
+	return Math.atan2(m.b, m.a) * PI_RADIANS_IN_DEGREES / Math.PI;
 }
 const TRANSFORM_NUMBER = /[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?/y;
 const TRANSFORM_FUNCTIONS = [
@@ -98,8 +102,8 @@ function matrixFromFunction(name, args) {
 			};
 		}
 		case "rotate": {
-			if (args.length !== 1 && args.length !== 3) return;
-			const radians = args[0] * Math.PI / 180;
+			if (args.length !== 1 && args.length !== ROTATE_WITH_CENTRE_ARGUMENT_COUNT) return;
+			const radians = args[0] * Math.PI / PI_RADIANS_IN_DEGREES;
 			const cos = Math.cos(radians);
 			const sin = Math.sin(radians);
 			const rotation = {
@@ -134,7 +138,7 @@ function matrixFromFunction(name, args) {
 			return {
 				a: 1,
 				b: 0,
-				c: Math.tan(args[0] * Math.PI / 180),
+				c: Math.tan(args[0] * Math.PI / PI_RADIANS_IN_DEGREES),
 				d: 1,
 				e: 0,
 				f: 0
@@ -143,14 +147,14 @@ function matrixFromFunction(name, args) {
 			if (args.length !== 1) return;
 			return {
 				a: 1,
-				b: Math.tan(args[0] * Math.PI / 180),
+				b: Math.tan(args[0] * Math.PI / PI_RADIANS_IN_DEGREES),
 				c: 0,
 				d: 1,
 				e: 0,
 				f: 0
 			};
 		case "matrix":
-			if (args.length !== 6) return;
+			if (args.length !== MATRIX_ARGUMENT_COUNT) return;
 			return {
 				a: args[0],
 				b: args[1],

package/dist/svg/transform.js

@@ -1,4 +1,8 @@
 //#region src/svg/transform.ts
+const PI_RADIANS_IN_DEGREES = 180;
+const SIMILARITY_AXIS_TOLERANCE = 1e-9;
+const ROTATE_WITH_CENTRE_ARGUMENT_COUNT = 3;
+const MATRIX_ARGUMENT_COUNT = 6;
 const IDENTITY_MATRIX = {
 	a: 1,
 	b: 0,
@@ -42,10 +46,10 @@ function isAxisAligned(m) {
 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;
+	return Math.abs(m.a * m.a + m.b * m.b - (m.c * m.c + m.d * m.d)) < SIMILARITY_AXIS_TOLERANCE;
 }
 function similarityRotationDeg(m) {
-	return Math.atan2(m.b, m.a) * 180 / Math.PI;
+	return Math.atan2(m.b, m.a) * PI_RADIANS_IN_DEGREES / Math.PI;
 }
 const TRANSFORM_NUMBER = /[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?/y;
 const TRANSFORM_FUNCTIONS = [
@@ -97,8 +101,8 @@ function matrixFromFunction(name, args) {
 			};
 		}
 		case "rotate": {
-			if (args.length !== 1 && args.length !== 3) return;
-			const radians = args[0] * Math.PI / 180;
+			if (args.length !== 1 && args.length !== ROTATE_WITH_CENTRE_ARGUMENT_COUNT) return;
+			const radians = args[0] * Math.PI / PI_RADIANS_IN_DEGREES;
 			const cos = Math.cos(radians);
 			const sin = Math.sin(radians);
 			const rotation = {
@@ -133,7 +137,7 @@ function matrixFromFunction(name, args) {
 			return {
 				a: 1,
 				b: 0,
-				c: Math.tan(args[0] * Math.PI / 180),
+				c: Math.tan(args[0] * Math.PI / PI_RADIANS_IN_DEGREES),
 				d: 1,
 				e: 0,
 				f: 0
@@ -142,14 +146,14 @@ function matrixFromFunction(name, args) {
 			if (args.length !== 1) return;
 			return {
 				a: 1,
-				b: Math.tan(args[0] * Math.PI / 180),
+				b: Math.tan(args[0] * Math.PI / PI_RADIANS_IN_DEGREES),
 				c: 0,
 				d: 1,
 				e: 0,
 				f: 0
 			};
 		case "matrix":
-			if (args.length !== 6) return;
+			if (args.length !== MATRIX_ARGUMENT_COUNT) return;
 			return {
 				a: args[0],
 				b: args[1],

package/dist/svg/units.cjs

@@ -1,9 +1,12 @@
 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 PT_PER_MM = PT_PER_IN / 25.4;
+const PT_PER_CM = PT_PER_MM * 10;
+const PT_PER_PC = 12;
+const Q_PER_CM = 40;
+const VIEWBOX_COMPONENT_COUNT = 4;
 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) {
@@ -19,8 +22,8 @@ function parseSvgLengthPt(raw) {
 		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;
+		case "pc": return value * PT_PER_PC;
+		case "q": return value * (PT_PER_CM / Q_PER_CM);
 		default: return;
 	}
 }
@@ -31,7 +34,7 @@ function parseSvgUserUnits(raw) {
 function parseSvgViewBox(raw) {
 	if (raw === void 0) return;
 	const parts = raw.trim().replace(/,/g, " ").split(/\s+/);
-	if (parts.length !== 4) return;
+	if (parts.length !== VIEWBOX_COMPONENT_COUNT) 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 {
@@ -42,6 +45,7 @@ function parseSvgViewBox(raw) {
 	};
 }
 //#endregion
+exports.PT_PER_PX = PT_PER_PX;
 exports.parseSvgLengthPt = parseSvgLengthPt;
 exports.parseSvgUserUnits = parseSvgUserUnits;
 exports.parseSvgViewBox = parseSvgViewBox;

package/dist/svg/units.d.cts

@@ -1,4 +1,5 @@
 //#region src/svg/units.d.ts
+declare const PT_PER_PX = 0.75;
 declare function parseSvgLengthPt(raw: string | undefined): number | undefined;
 declare function parseSvgUserUnits(raw: string | undefined): number | undefined;
 interface SvgViewBox {
@@ -9,4 +10,4 @@ interface SvgViewBox {
 }
 declare function parseSvgViewBox(raw: string | undefined): SvgViewBox | undefined;
 //#endregion
-export { SvgViewBox, parseSvgLengthPt, parseSvgUserUnits, parseSvgViewBox };
+export { PT_PER_PX, SvgViewBox, parseSvgLengthPt, parseSvgUserUnits, parseSvgViewBox };

package/dist/svg/units.d.ts

@@ -1,4 +1,5 @@
 //#region src/svg/units.d.ts
+declare const PT_PER_PX = 0.75;
 declare function parseSvgLengthPt(raw: string | undefined): number | undefined;
 declare function parseSvgUserUnits(raw: string | undefined): number | undefined;
 interface SvgViewBox {
@@ -9,4 +10,4 @@ interface SvgViewBox {
 }
 declare function parseSvgViewBox(raw: string | undefined): SvgViewBox | undefined;
 //#endregion
-export { SvgViewBox, parseSvgLengthPt, parseSvgUserUnits, parseSvgViewBox };
+export { PT_PER_PX, SvgViewBox, parseSvgLengthPt, parseSvgUserUnits, parseSvgViewBox };

package/dist/svg/units.js

@@ -1,8 +1,11 @@
 //#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 PT_PER_MM = PT_PER_IN / 25.4;
+const PT_PER_CM = PT_PER_MM * 10;
+const PT_PER_PC = 12;
+const Q_PER_CM = 40;
+const VIEWBOX_COMPONENT_COUNT = 4;
 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) {
@@ -18,8 +21,8 @@ function parseSvgLengthPt(raw) {
 		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;
+		case "pc": return value * PT_PER_PC;
+		case "q": return value * (PT_PER_CM / Q_PER_CM);
 		default: return;
 	}
 }
@@ -30,7 +33,7 @@ function parseSvgUserUnits(raw) {
 function parseSvgViewBox(raw) {
 	if (raw === void 0) return;
 	const parts = raw.trim().replace(/,/g, " ").split(/\s+/);
-	if (parts.length !== 4) return;
+	if (parts.length !== VIEWBOX_COMPONENT_COUNT) 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 {
@@ -41,4 +44,4 @@ function parseSvgViewBox(raw) {
 	};
 }
 //#endregion
-export { parseSvgLengthPt, parseSvgUserUnits, parseSvgViewBox };
+export { PT_PER_PX, parseSvgLengthPt, parseSvgUserUnits, parseSvgViewBox };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js.documents",
-  "version": "14.4.46",
+  "version": "14.4.47",
   "description": "Bidirectional docx/pptx <-> PDF conversion and a read+write editable OOXML document model, built on ooxml.js and Zod 4 codecs.",
   "type": "module",
   "repository": {
@@ -86,7 +86,7 @@
     "markdown-codec": "11.1.12",
     "odf.js": "11.1.12",
     "ooxml.js": "12.2.26",
-    "pdf-codec": "5.2.27",
+    "pdf-codec": "5.2.28",
     "ppt-codec": "2.2.19",
     "rtf-codec": "8.1.20",
     "temml": "0.13.4",