odf.js 1.12.0 → 1.13.0

package/dist/typed/shared/transform.d.cts

@@ -0,0 +1,26 @@
+import { l as XmlElement } from "../../node-CkBWRjNR.cjs";
+import { Box } from "document-schema.js";
+//#region src/typed/shared/transform.d.ts
+type OdfTransformFunction = {
+  readonly kind: 'rotate';
+  readonly angleRad: number;
+} | {
+  readonly kind: 'translate';
+  readonly xPt: number;
+  readonly yPt: number;
+};
+interface OdfPoint {
+  readonly xPt: number;
+  readonly yPt: number;
+}
+declare function parseOdfTransform(value: string): OdfTransformFunction[];
+declare function applyOdfTransform(functions: readonly OdfTransformFunction[], point: OdfPoint): OdfPoint;
+declare function netRotationDeg(functions: readonly OdfTransformFunction[]): number;
+interface OdfShapeGeometry {
+  readonly frame: Box;
+  readonly rotationDeg: number | undefined;
+}
+declare function resolveOdfShapeGeometry(element: XmlElement): OdfShapeGeometry | undefined;
+declare function composeOdfGroupTransform(groupFunctions: readonly OdfTransformFunction[], child: OdfShapeGeometry): OdfShapeGeometry;
+//#endregion
+export { OdfPoint, OdfShapeGeometry, OdfTransformFunction, applyOdfTransform, composeOdfGroupTransform, netRotationDeg, parseOdfTransform, resolveOdfShapeGeometry };

package/dist/typed/shared/transform.d.ts

@@ -0,0 +1,26 @@
+import { l as XmlElement } from "../../node-CkBWRjNR.js";
+import { Box } from "document-schema.js";
+//#region src/typed/shared/transform.d.ts
+type OdfTransformFunction = {
+  readonly kind: 'rotate';
+  readonly angleRad: number;
+} | {
+  readonly kind: 'translate';
+  readonly xPt: number;
+  readonly yPt: number;
+};
+interface OdfPoint {
+  readonly xPt: number;
+  readonly yPt: number;
+}
+declare function parseOdfTransform(value: string): OdfTransformFunction[];
+declare function applyOdfTransform(functions: readonly OdfTransformFunction[], point: OdfPoint): OdfPoint;
+declare function netRotationDeg(functions: readonly OdfTransformFunction[]): number;
+interface OdfShapeGeometry {
+  readonly frame: Box;
+  readonly rotationDeg: number | undefined;
+}
+declare function resolveOdfShapeGeometry(element: XmlElement): OdfShapeGeometry | undefined;
+declare function composeOdfGroupTransform(groupFunctions: readonly OdfTransformFunction[], child: OdfShapeGeometry): OdfShapeGeometry;
+//#endregion
+export { OdfPoint, OdfShapeGeometry, OdfTransformFunction, applyOdfTransform, composeOdfGroupTransform, netRotationDeg, parseOdfTransform, resolveOdfShapeGeometry };

package/dist/typed/shared/transform.js

@@ -0,0 +1,107 @@
+import { parseOdfLength } from "./units.js";
+import { attrValue } from "../../xml/query.js";
+import { parseBox } from "./geometry.js";
+//#region src/typed/shared/transform.ts
+const FUNCTION_PATTERN = /([a-zA-Z]+)\s*\(\s*([^)]*?)\s*\)/g;
+function parseOdfTransform(value) {
+	const functions = [];
+	for (const match of value.matchAll(FUNCTION_PATTERN)) {
+		const name = match[1];
+		const argsRaw = match[2];
+		if (name === void 0 || argsRaw === void 0) continue;
+		const args = argsRaw.split(/\s+/).filter((arg) => arg.length > 0);
+		if (name === "rotate") {
+			const angleArg = args[0];
+			if (angleArg === void 0) continue;
+			const angleRad = Number(angleArg);
+			if (!Number.isFinite(angleRad)) continue;
+			functions.push({
+				kind: "rotate",
+				angleRad
+			});
+		} else if (name === "translate") {
+			const xArg = args[0];
+			if (xArg === void 0) continue;
+			const yArg = args[1];
+			const xPt = parseOdfLength(xArg);
+			const yPt = yArg === void 0 ? 0 : parseOdfLength(yArg);
+			if (xPt === void 0 || yPt === void 0) continue;
+			functions.push({
+				kind: "translate",
+				xPt,
+				yPt
+			});
+		}
+	}
+	return functions;
+}
+function applyOdfTransform(functions, point) {
+	let current = point;
+	for (const fn of functions) if (fn.kind === "rotate") {
+		const cos = Math.cos(fn.angleRad);
+		const sin = Math.sin(fn.angleRad);
+		current = {
+			xPt: current.xPt * cos + current.yPt * sin,
+			yPt: current.yPt * cos - current.xPt * sin
+		};
+	} else current = {
+		xPt: current.xPt + fn.xPt,
+		yPt: current.yPt + fn.yPt
+	};
+	return current;
+}
+function netRotationDeg(functions) {
+	let totalRad = 0;
+	for (const fn of functions) if (fn.kind === "rotate") totalRad += fn.angleRad;
+	return -totalRad * 180 / Math.PI;
+}
+function resolveOdfShapeGeometry(element) {
+	const transformValue = attrValue(element, "draw:transform");
+	if (transformValue === void 0) {
+		const box = parseBox(element);
+		return box === void 0 ? void 0 : {
+			frame: box,
+			rotationDeg: void 0
+		};
+	}
+	const widthValue = attrValue(element, "svg:width");
+	const heightValue = attrValue(element, "svg:height");
+	if (widthValue === void 0 || heightValue === void 0) return;
+	const widthPt = parseOdfLength(widthValue);
+	const heightPt = parseOdfLength(heightValue);
+	if (widthPt === void 0 || heightPt === void 0) return;
+	const functions = parseOdfTransform(transformValue);
+	const center = applyOdfTransform(functions, {
+		xPt: widthPt / 2,
+		yPt: heightPt / 2
+	});
+	const rotationDeg = netRotationDeg(functions);
+	return {
+		frame: {
+			xPt: center.xPt - widthPt / 2,
+			yPt: center.yPt - heightPt / 2,
+			widthPt,
+			heightPt
+		},
+		rotationDeg: rotationDeg === 0 ? void 0 : rotationDeg
+	};
+}
+function composeOdfGroupTransform(groupFunctions, child) {
+	if (groupFunctions.length === 0) return child;
+	const newCenter = applyOdfTransform(groupFunctions, {
+		xPt: child.frame.xPt + child.frame.widthPt / 2,
+		yPt: child.frame.yPt + child.frame.heightPt / 2
+	});
+	const newRotationDeg = (child.rotationDeg ?? 0) + netRotationDeg(groupFunctions);
+	return {
+		frame: {
+			xPt: newCenter.xPt - child.frame.widthPt / 2,
+			yPt: newCenter.yPt - child.frame.heightPt / 2,
+			widthPt: child.frame.widthPt,
+			heightPt: child.frame.heightPt
+		},
+		rotationDeg: newRotationDeg === 0 ? void 0 : newRotationDeg
+	};
+}
+//#endregion
+export { applyOdfTransform, composeOdfGroupTransform, netRotationDeg, parseOdfTransform, resolveOdfShapeGeometry };

package/dist/typed/shared/units.cjs

@@ -0,0 +1,35 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/typed/shared/units.ts
+const LENGTH_PATTERN = /^(-?(?:\d+(?:\.\d+)?|\.\d+))(cm|mm|in|pt|pc|px)$/;
+const POINTS_PER_INCH = 72;
+const POINTS_PER_PICA = 12;
+const CM_PER_INCH = 2.54;
+const MM_PER_INCH = 25.4;
+const CSS_REFERENCE_PIXELS_PER_INCH = 96;
+function unitToPtFactor(unit) {
+	switch (unit) {
+		case "pt": return 1;
+		case "in": return POINTS_PER_INCH;
+		case "cm": return POINTS_PER_INCH / CM_PER_INCH;
+		case "mm": return POINTS_PER_INCH / MM_PER_INCH;
+		case "pc": return POINTS_PER_PICA;
+		case "px": return POINTS_PER_INCH / CSS_REFERENCE_PIXELS_PER_INCH;
+	}
+}
+function isLengthUnit(value) {
+	return value === "cm" || value === "mm" || value === "in" || value === "pt" || value === "pc" || value === "px";
+}
+function parseOdfLength(value) {
+	const match = LENGTH_PATTERN.exec(value);
+	if (match === null) return;
+	const numeric = match[1];
+	const unit = match[2];
+	if (numeric === void 0 || unit === void 0 || !isLengthUnit(unit)) return;
+	return Number(numeric) * unitToPtFactor(unit);
+}
+function formatOdfLength(pt, unit = "pt") {
+	return `${pt / unitToPtFactor(unit)}${unit}`;
+}
+//#endregion
+exports.formatOdfLength = formatOdfLength;
+exports.parseOdfLength = parseOdfLength;

package/dist/typed/shared/units.d.cts

@@ -0,0 +1,2 @@
+import { n as formatOdfLength, r as parseOdfLength, t as LengthUnit } from "../../units-7pCiECuP.cjs";
+export { LengthUnit, formatOdfLength, parseOdfLength };

package/dist/typed/shared/units.d.ts

@@ -0,0 +1,2 @@
+import { n as formatOdfLength, r as parseOdfLength, t as LengthUnit } from "../../units-7pCiECuP.js";
+export { LengthUnit, formatOdfLength, parseOdfLength };

package/dist/typed/shared/units.js

@@ -0,0 +1,33 @@
+//#region src/typed/shared/units.ts
+const LENGTH_PATTERN = /^(-?(?:\d+(?:\.\d+)?|\.\d+))(cm|mm|in|pt|pc|px)$/;
+const POINTS_PER_INCH = 72;
+const POINTS_PER_PICA = 12;
+const CM_PER_INCH = 2.54;
+const MM_PER_INCH = 25.4;
+const CSS_REFERENCE_PIXELS_PER_INCH = 96;
+function unitToPtFactor(unit) {
+	switch (unit) {
+		case "pt": return 1;
+		case "in": return POINTS_PER_INCH;
+		case "cm": return POINTS_PER_INCH / CM_PER_INCH;
+		case "mm": return POINTS_PER_INCH / MM_PER_INCH;
+		case "pc": return POINTS_PER_PICA;
+		case "px": return POINTS_PER_INCH / CSS_REFERENCE_PIXELS_PER_INCH;
+	}
+}
+function isLengthUnit(value) {
+	return value === "cm" || value === "mm" || value === "in" || value === "pt" || value === "pc" || value === "px";
+}
+function parseOdfLength(value) {
+	const match = LENGTH_PATTERN.exec(value);
+	if (match === null) return;
+	const numeric = match[1];
+	const unit = match[2];
+	if (numeric === void 0 || unit === void 0 || !isLengthUnit(unit)) return;
+	return Number(numeric) * unitToPtFactor(unit);
+}
+function formatOdfLength(pt, unit = "pt") {
+	return `${pt / unitToPtFactor(unit)}${unit}`;
+}
+//#endregion
+export { formatOdfLength, parseOdfLength };

package/dist/units-7pCiECuP.d.cts

@@ -0,0 +1,6 @@
+//#region src/typed/shared/units.d.ts
+type LengthUnit = 'cm' | 'mm' | 'in' | 'pt' | 'pc' | 'px';
+declare function parseOdfLength(value: string): number | undefined;
+declare function formatOdfLength(pt: number, unit?: LengthUnit): string;
+//#endregion
+export { formatOdfLength as n, parseOdfLength as r, LengthUnit as t };

package/dist/units-7pCiECuP.d.ts

@@ -0,0 +1,6 @@
+//#region src/typed/shared/units.d.ts
+type LengthUnit = 'cm' | 'mm' | 'in' | 'pt' | 'pc' | 'px';
+declare function parseOdfLength(value: string): number | undefined;
+declare function formatOdfLength(pt: number, unit?: LengthUnit): string;
+//#endregion
+export { formatOdfLength as n, parseOdfLength as r, LengthUnit as t };

package/dist/util/base64.cjs

@@ -0,0 +1,48 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/util/base64.ts
+const TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+const DECODE = (() => {
+	const map = (/* @__PURE__ */ new Uint8Array(256)).fill(255);
+	for (let i = 0; i < 64; i = i + 1) map[TABLE.charCodeAt(i)] = i;
+	return map;
+})();
+function bytesToBase64(bytes) {
+	let out = "";
+	const len = bytes.length;
+	for (let i = 0; i < len; i = i + 3) {
+		const b0 = bytes[i];
+		const b1 = i + 1 < len ? bytes[i + 1] : 0;
+		const b2 = i + 2 < len ? bytes[i + 2] : 0;
+		out += TABLE[b0 >> 2];
+		out += TABLE[(b0 & 3) << 4 | b1 >> 4];
+		out += i + 1 < len ? TABLE[(b1 & 15) << 2 | b2 >> 6] : "=";
+		out += i + 2 < len ? TABLE[b2 & 63] : "=";
+	}
+	return out;
+}
+function base64ToBytes(b64) {
+	const clean = b64.replace(/[^A-Za-z0-9+/=]/g, "");
+	const len = clean.length;
+	const out = new Uint8Array(len * 3 / 4 | 0);
+	let p = 0;
+	for (let i = 0; i < len; i = i + 4) {
+		const c0 = DECODE[clean.charCodeAt(i)];
+		const c1 = DECODE[clean.charCodeAt(i + 1)];
+		const c2 = clean.charCodeAt(i + 2);
+		const c3 = clean.charCodeAt(i + 3);
+		if (c0 === 255 || c1 === 255) throw new Error("invalid base64 input");
+		out[p++] = c0 << 2 | c1 >> 4;
+		if (c2 !== 61) {
+			const d2 = DECODE[c2];
+			out[p++] = (c1 & 15) << 4 | d2 >> 2;
+			if (c3 !== 61) {
+				const d3 = DECODE[c3];
+				out[p++] = (d2 & 3) << 6 | d3;
+			}
+		}
+	}
+	return out.subarray(0, p);
+}
+//#endregion
+exports.base64ToBytes = base64ToBytes;
+exports.bytesToBase64 = bytesToBase64;

package/dist/util/base64.d.cts

@@ -0,0 +1,5 @@
+//#region src/util/base64.d.ts
+declare function bytesToBase64(bytes: Uint8Array<ArrayBuffer>): string;
+declare function base64ToBytes(b64: string): Uint8Array<ArrayBuffer>;
+//#endregion
+export { base64ToBytes, bytesToBase64 };

package/dist/util/base64.d.ts

@@ -0,0 +1,5 @@
+//#region src/util/base64.d.ts
+declare function bytesToBase64(bytes: Uint8Array<ArrayBuffer>): string;
+declare function base64ToBytes(b64: string): Uint8Array<ArrayBuffer>;
+//#endregion
+export { base64ToBytes, bytesToBase64 };

package/dist/util/base64.js

@@ -0,0 +1,46 @@
+//#region src/util/base64.ts
+const TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+const DECODE = (() => {
+	const map = (/* @__PURE__ */ new Uint8Array(256)).fill(255);
+	for (let i = 0; i < 64; i = i + 1) map[TABLE.charCodeAt(i)] = i;
+	return map;
+})();
+function bytesToBase64(bytes) {
+	let out = "";
+	const len = bytes.length;
+	for (let i = 0; i < len; i = i + 3) {
+		const b0 = bytes[i];
+		const b1 = i + 1 < len ? bytes[i + 1] : 0;
+		const b2 = i + 2 < len ? bytes[i + 2] : 0;
+		out += TABLE[b0 >> 2];
+		out += TABLE[(b0 & 3) << 4 | b1 >> 4];
+		out += i + 1 < len ? TABLE[(b1 & 15) << 2 | b2 >> 6] : "=";
+		out += i + 2 < len ? TABLE[b2 & 63] : "=";
+	}
+	return out;
+}
+function base64ToBytes(b64) {
+	const clean = b64.replace(/[^A-Za-z0-9+/=]/g, "");
+	const len = clean.length;
+	const out = new Uint8Array(len * 3 / 4 | 0);
+	let p = 0;
+	for (let i = 0; i < len; i = i + 4) {
+		const c0 = DECODE[clean.charCodeAt(i)];
+		const c1 = DECODE[clean.charCodeAt(i + 1)];
+		const c2 = clean.charCodeAt(i + 2);
+		const c3 = clean.charCodeAt(i + 3);
+		if (c0 === 255 || c1 === 255) throw new Error("invalid base64 input");
+		out[p++] = c0 << 2 | c1 >> 4;
+		if (c2 !== 61) {
+			const d2 = DECODE[c2];
+			out[p++] = (c1 & 15) << 4 | d2 >> 2;
+			if (c3 !== 61) {
+				const d3 = DECODE[c3];
+				out[p++] = (d2 & 3) << 6 | d3;
+			}
+		}
+	}
+	return out.subarray(0, p);
+}
+//#endregion
+export { base64ToBytes, bytesToBase64 };

package/dist/xml/build.cjs

@@ -0,0 +1,46 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/xml/build.ts
+const BUILDER = new (require("fast-xml-parser")).XMLBuilder({
+	preserveOrder: true,
+	attributeNamePrefix: "@_",
+	ignoreAttributes: false,
+	textNodeName: "#text",
+	cdataPropName: "__cdata",
+	commentPropName: "__comment",
+	processEntities: false,
+	format: false,
+	suppressEmptyNode: false
+});
+function buildXml(nodes) {
+	const out = BUILDER.build(toOrdered(nodes));
+	if (typeof out !== "string") throw new Error("XMLBuilder did not return a string");
+	return out;
+}
+function toOrdered(nodes) {
+	return nodes.map(toOrderedNode);
+}
+function attrsObject(attributes) {
+	const obj = {};
+	for (const a of attributes) obj[`@_${a.name}`] = a.value;
+	return obj;
+}
+function toOrderedNode(node) {
+	switch (node.type) {
+		case "text": return { "#text": node.value };
+		case "comment": return { __comment: [{ "#text": node.value }] };
+		case "cdata": return { __cdata: [{ "#text": node.value }] };
+		case "pi": return { [`?${node.target}`]: [{ "#text": node.content }] };
+		case "declaration": return {
+			"?xml": [{ "#text": "" }],
+			":@": attrsObject(node.attributes)
+		};
+		case "element": {
+			const obj = { [node.tag]: toOrdered(node.children) };
+			const attrs = attrsObject(node.attributes);
+			if (Object.keys(attrs).length > 0) obj[":@"] = attrs;
+			return obj;
+		}
+	}
+}
+//#endregion
+exports.buildXml = buildXml;

package/dist/xml/build.d.cts

@@ -0,0 +1,5 @@
+import { d as XmlNode } from "../node-CkBWRjNR.cjs";
+//#region src/xml/build.d.ts
+declare function buildXml(nodes: XmlNode[]): string;
+//#endregion
+export { buildXml };

package/dist/xml/build.d.ts

@@ -0,0 +1,5 @@
+import { d as XmlNode } from "../node-CkBWRjNR.js";
+//#region src/xml/build.d.ts
+declare function buildXml(nodes: XmlNode[]): string;
+//#endregion
+export { buildXml };

package/dist/xml/build.js

@@ -0,0 +1,46 @@
+import { XMLBuilder } from "fast-xml-parser";
+//#region src/xml/build.ts
+const BUILDER = new XMLBuilder({
+	preserveOrder: true,
+	attributeNamePrefix: "@_",
+	ignoreAttributes: false,
+	textNodeName: "#text",
+	cdataPropName: "__cdata",
+	commentPropName: "__comment",
+	processEntities: false,
+	format: false,
+	suppressEmptyNode: false
+});
+function buildXml(nodes) {
+	const out = BUILDER.build(toOrdered(nodes));
+	if (typeof out !== "string") throw new Error("XMLBuilder did not return a string");
+	return out;
+}
+function toOrdered(nodes) {
+	return nodes.map(toOrderedNode);
+}
+function attrsObject(attributes) {
+	const obj = {};
+	for (const a of attributes) obj[`@_${a.name}`] = a.value;
+	return obj;
+}
+function toOrderedNode(node) {
+	switch (node.type) {
+		case "text": return { "#text": node.value };
+		case "comment": return { __comment: [{ "#text": node.value }] };
+		case "cdata": return { __cdata: [{ "#text": node.value }] };
+		case "pi": return { [`?${node.target}`]: [{ "#text": node.content }] };
+		case "declaration": return {
+			"?xml": [{ "#text": "" }],
+			":@": attrsObject(node.attributes)
+		};
+		case "element": {
+			const obj = { [node.tag]: toOrdered(node.children) };
+			const attrs = attrsObject(node.attributes);
+			if (Object.keys(attrs).length > 0) obj[":@"] = attrs;
+			return obj;
+		}
+	}
+}
+//#endregion
+export { buildXml };

package/dist/xml/entities.cjs

@@ -0,0 +1,19 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/xml/entities.ts
+function encodeXmlText(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+const XML_ENTITY_PATTERN = /&(?:amp|lt|gt|quot|apos);/g;
+const XML_ENTITY_DECODE = {
+	"&amp;": "&",
+	"&lt;": "<",
+	"&gt;": ">",
+	"&quot;": "\"",
+	"&apos;": "'"
+};
+function decodeXmlText(value) {
+	return value.replace(XML_ENTITY_PATTERN, (entity) => XML_ENTITY_DECODE[entity]);
+}
+//#endregion
+exports.decodeXmlText = decodeXmlText;
+exports.encodeXmlText = encodeXmlText;

package/dist/xml/entities.d.cts

@@ -0,0 +1,5 @@
+//#region src/xml/entities.d.ts
+declare function encodeXmlText(value: string): string;
+declare function decodeXmlText(value: string): string;
+//#endregion
+export { decodeXmlText, encodeXmlText };

package/dist/xml/entities.d.ts

@@ -0,0 +1,5 @@
+//#region src/xml/entities.d.ts
+declare function encodeXmlText(value: string): string;
+declare function decodeXmlText(value: string): string;
+//#endregion
+export { decodeXmlText, encodeXmlText };

package/dist/xml/entities.js

@@ -0,0 +1,17 @@
+//#region src/xml/entities.ts
+function encodeXmlText(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+const XML_ENTITY_PATTERN = /&(?:amp|lt|gt|quot|apos);/g;
+const XML_ENTITY_DECODE = {
+	"&amp;": "&",
+	"&lt;": "<",
+	"&gt;": ">",
+	"&quot;": "\"",
+	"&apos;": "'"
+};
+function decodeXmlText(value) {
+	return value.replace(XML_ENTITY_PATTERN, (entity) => XML_ENTITY_DECODE[entity]);
+}
+//#endregion
+export { decodeXmlText, encodeXmlText };

package/dist/xml/fragment.cjs

@@ -0,0 +1,22 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/xml/fragment.ts
+function el(tag, attrs = {}, children = []) {
+	return {
+		type: "element",
+		tag,
+		attributes: Object.entries(attrs).map(([name, value]) => ({
+			name,
+			value
+		})),
+		children
+	};
+}
+function txt(value) {
+	return {
+		type: "text",
+		value
+	};
+}
+//#endregion
+exports.el = el;
+exports.txt = txt;

package/dist/xml/fragment.d.cts

@@ -0,0 +1,6 @@
+import { d as XmlNode, h as XmlText, l as XmlElement } from "../node-CkBWRjNR.cjs";
+//#region src/xml/fragment.d.ts
+declare function el(tag: string, attrs?: Record<string, string>, children?: XmlNode[]): XmlElement;
+declare function txt(value: string): XmlText;
+//#endregion
+export { el, txt };

package/dist/xml/fragment.d.ts

@@ -0,0 +1,6 @@
+import { d as XmlNode, h as XmlText, l as XmlElement } from "../node-CkBWRjNR.js";
+//#region src/xml/fragment.d.ts
+declare function el(tag: string, attrs?: Record<string, string>, children?: XmlNode[]): XmlElement;
+declare function txt(value: string): XmlText;
+//#endregion
+export { el, txt };

package/dist/xml/fragment.js

@@ -0,0 +1,20 @@
+//#region src/xml/fragment.ts
+function el(tag, attrs = {}, children = []) {
+	return {
+		type: "element",
+		tag,
+		attributes: Object.entries(attrs).map(([name, value]) => ({
+			name,
+			value
+		})),
+		children
+	};
+}
+function txt(value) {
+	return {
+		type: "text",
+		value
+	};
+}
+//#endregion
+export { el, txt };

package/dist/xml/parse.cjs

@@ -0,0 +1,88 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/xml/parse.ts
+const PARSER = new (require("fast-xml-parser")).XMLParser({
+	preserveOrder: true,
+	attributeNamePrefix: "@_",
+	ignoreAttributes: false,
+	textNodeName: "#text",
+	cdataPropName: "__cdata",
+	commentPropName: "__comment",
+	processEntities: false,
+	parseTagValue: false,
+	trimValues: false
+});
+function parseXml(xml) {
+	return parseNodes(PARSER.parse(xml));
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isUnknownArray(value) {
+	return Array.isArray(value);
+}
+function asString(value) {
+	if (typeof value !== "string") throw new Error(`expected string while parsing XML, got ${typeof value}`);
+	return value;
+}
+function parseNodes(raw) {
+	if (!isUnknownArray(raw)) throw new Error("fast-xml-parser output was not an ordered array");
+	return raw.map(parseNode);
+}
+function parseNode(raw) {
+	if (!isRecord(raw)) throw new Error("fast-xml-parser node was not an object");
+	let tagKey;
+	for (const key of Object.keys(raw)) if (key !== ":@") {
+		if (tagKey !== void 0) throw new Error("XML node had multiple tag keys");
+		tagKey = key;
+	}
+	if (tagKey === void 0) throw new Error("XML node had no tag key");
+	const attributes = parseAttributes(raw[":@"]);
+	if (tagKey === "#text") return {
+		type: "text",
+		value: asString(raw["#text"])
+	};
+	if (tagKey === "__comment") return {
+		type: "comment",
+		value: scalarText(raw.__comment)
+	};
+	if (tagKey === "__cdata") return {
+		type: "cdata",
+		value: scalarText(raw.__cdata)
+	};
+	if (tagKey === "?xml") return {
+		type: "declaration",
+		attributes
+	};
+	if (tagKey.startsWith("?")) return {
+		type: "pi",
+		target: tagKey.slice(1),
+		content: scalarText(raw[tagKey])
+	};
+	return {
+		type: "element",
+		tag: tagKey,
+		attributes,
+		children: parseNodes(raw[tagKey])
+	};
+}
+function parseAttributes(raw) {
+	if (raw === void 0) return [];
+	if (!isRecord(raw)) throw new Error("XML attributes were not an object");
+	const attrs = [];
+	for (const key of Object.keys(raw)) {
+		if (!key.startsWith("@_")) throw new Error(`unexpected attribute key without @_ prefix: ${key}`);
+		attrs.push({
+			name: key.slice(2),
+			value: asString(raw[key])
+		});
+	}
+	return attrs;
+}
+function scalarText(raw) {
+	if (!isUnknownArray(raw) || raw.length === 0) throw new Error("expected a scalar-text wrapper array");
+	const first = raw[0];
+	if (!isRecord(first)) throw new Error("scalar-text wrapper was not an object");
+	return asString(first["#text"]);
+}
+//#endregion
+exports.parseXml = parseXml;