odf.js 1.12.0 → 1.13.0

package/dist/xml/parse.d.cts

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

package/dist/xml/parse.d.ts

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

package/dist/xml/parse.js

@@ -0,0 +1,88 @@
+import { XMLParser } from "fast-xml-parser";
+//#region src/xml/parse.ts
+const PARSER = new 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
+export { parseXml };

package/dist/xml/query.cjs

@@ -0,0 +1,33 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/xml/query.ts
+function rootElement(nodes) {
+	for (const node of nodes) if (node.type === "element") return node;
+}
+function findChildElement(nodes, tag) {
+	for (const node of nodes) if (node.type === "element" && node.tag === tag) return node;
+}
+function childrenWithTag(element, tag) {
+	const out = [];
+	for (const child of element.children) if (child.type === "element" && child.tag === tag) out.push(child);
+	return out;
+}
+function* walk(nodes) {
+	for (const node of nodes) {
+		yield node;
+		if (node.type === "element") yield* walk(node.children);
+	}
+}
+function elementsWithTag(nodes, tag) {
+	const out = [];
+	for (const node of walk(nodes)) if (node.type === "element" && node.tag === tag) out.push(node);
+	return out;
+}
+function attrValue(element, name) {
+	return element.attributes.find((attribute) => attribute.name === name)?.value;
+}
+//#endregion
+exports.attrValue = attrValue;
+exports.childrenWithTag = childrenWithTag;
+exports.elementsWithTag = elementsWithTag;
+exports.findChildElement = findChildElement;
+exports.rootElement = rootElement;

package/dist/xml/query.d.cts

@@ -0,0 +1,9 @@
+import { d as XmlNode, l as XmlElement } from "../node-CkBWRjNR.cjs";
+//#region src/xml/query.d.ts
+declare function rootElement(nodes: readonly XmlNode[]): XmlElement | undefined;
+declare function findChildElement(nodes: readonly XmlNode[], tag: string): XmlElement | undefined;
+declare function childrenWithTag(element: XmlElement, tag: string): XmlElement[];
+declare function elementsWithTag(nodes: readonly XmlNode[], tag: string): XmlElement[];
+declare function attrValue(element: XmlElement, name: string): string | undefined;
+//#endregion
+export { attrValue, childrenWithTag, elementsWithTag, findChildElement, rootElement };

package/dist/xml/query.d.ts

@@ -0,0 +1,9 @@
+import { d as XmlNode, l as XmlElement } from "../node-CkBWRjNR.js";
+//#region src/xml/query.d.ts
+declare function rootElement(nodes: readonly XmlNode[]): XmlElement | undefined;
+declare function findChildElement(nodes: readonly XmlNode[], tag: string): XmlElement | undefined;
+declare function childrenWithTag(element: XmlElement, tag: string): XmlElement[];
+declare function elementsWithTag(nodes: readonly XmlNode[], tag: string): XmlElement[];
+declare function attrValue(element: XmlElement, name: string): string | undefined;
+//#endregion
+export { attrValue, childrenWithTag, elementsWithTag, findChildElement, rootElement };

package/dist/xml/query.js

@@ -0,0 +1,28 @@
+//#region src/xml/query.ts
+function rootElement(nodes) {
+	for (const node of nodes) if (node.type === "element") return node;
+}
+function findChildElement(nodes, tag) {
+	for (const node of nodes) if (node.type === "element" && node.tag === tag) return node;
+}
+function childrenWithTag(element, tag) {
+	const out = [];
+	for (const child of element.children) if (child.type === "element" && child.tag === tag) out.push(child);
+	return out;
+}
+function* walk(nodes) {
+	for (const node of nodes) {
+		yield node;
+		if (node.type === "element") yield* walk(node.children);
+	}
+}
+function elementsWithTag(nodes, tag) {
+	const out = [];
+	for (const node of walk(nodes)) if (node.type === "element" && node.tag === tag) out.push(node);
+	return out;
+}
+function attrValue(element, name) {
+	return element.attributes.find((attribute) => attribute.name === name)?.value;
+}
+//#endregion
+export { attrValue, childrenWithTag, elementsWithTag, findChildElement, rootElement };

package/dist/zip.cjs

@@ -0,0 +1,15 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let fflate = require("fflate");
+//#region src/zip.ts
+function unzipPackage(bytes) {
+	return (0, fflate.unzipSync)(bytes);
+}
+function zipPackage(entries) {
+	const data = {};
+	for (const [path, entry] of entries) if (entry.stored === true) data[path] = [entry.bytes, { level: 0 }];
+	else data[path] = entry.bytes;
+	return (0, fflate.zipSync)(data);
+}
+//#endregion
+exports.unzipPackage = unzipPackage;
+exports.zipPackage = zipPackage;

package/dist/zip.d.cts

@@ -0,0 +1,9 @@
+//#region src/zip.d.ts
+interface ZipEntry {
+  readonly bytes: Uint8Array<ArrayBuffer>;
+  readonly stored?: boolean;
+}
+declare function unzipPackage(bytes: Uint8Array<ArrayBuffer>): Record<string, Uint8Array<ArrayBuffer>>;
+declare function zipPackage(entries: readonly (readonly [string, ZipEntry])[]): Uint8Array<ArrayBuffer>;
+//#endregion
+export { ZipEntry, unzipPackage, zipPackage };

package/dist/zip.d.ts

@@ -0,0 +1,9 @@
+//#region src/zip.d.ts
+interface ZipEntry {
+  readonly bytes: Uint8Array<ArrayBuffer>;
+  readonly stored?: boolean;
+}
+declare function unzipPackage(bytes: Uint8Array<ArrayBuffer>): Record<string, Uint8Array<ArrayBuffer>>;
+declare function zipPackage(entries: readonly (readonly [string, ZipEntry])[]): Uint8Array<ArrayBuffer>;
+//#endregion
+export { ZipEntry, unzipPackage, zipPackage };

package/dist/zip.js

@@ -0,0 +1,13 @@
+import { unzipSync, zipSync } from "fflate";
+//#region src/zip.ts
+function unzipPackage(bytes) {
+	return unzipSync(bytes);
+}
+function zipPackage(entries) {
+	const data = {};
+	for (const [path, entry] of entries) if (entry.stored === true) data[path] = [entry.bytes, { level: 0 }];
+	else data[path] = entry.bytes;
+	return zipSync(data);
+}
+//#endregion
+export { unzipPackage, zipPackage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odf.js",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Type-safe, lossless round-trip conversion between OpenDocument Format packages (odt, ods, odp) and JSON, hand-written and dependency-minimal, built on Zod 4 codecs.",
   "type": "module",
   "repository": {
@@ -19,6 +19,14 @@
       },
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./*": {
+      "types": {
+        "import": "./dist/*.d.ts",
+        "require": "./dist/*.d.cts"
+      },
+      "import": "./dist/*.js",
+      "require": "./dist/*.cjs"
     }
   },
   "main": "./dist/index.cjs",