documents.js 1.57.0 → 1.58.0

package/dist/xml/edit.d.ts

@@ -0,0 +1,12 @@
+import { XmlElement, XmlNode } from "ooxml.js";
+//#region src/xml/edit.d.ts
+declare function setAttr(element: XmlElement, name: string, value: string): void;
+declare function removeAttr(element: XmlElement, name: string): void;
+declare function removeChild(container: XmlNode[], child: XmlNode): boolean;
+declare function insertBefore(container: XmlNode[], reference: XmlNode, newNode: XmlNode): void;
+declare function insertAfter(container: XmlNode[], reference: XmlNode, newNode: XmlNode): void;
+declare function insertInSchemaOrder(parent: XmlElement, child: XmlElement, order: readonly string[]): void;
+declare function directChildElement(parent: XmlElement, tag: string): XmlElement | undefined;
+declare function getOrCreateChildElement(parent: XmlElement, tag: string, order: readonly string[], build: () => XmlElement): XmlElement;
+//#endregion
+export { directChildElement, getOrCreateChildElement, insertAfter, insertBefore, insertInSchemaOrder, removeAttr, removeChild, setAttr };

package/dist/xml/edit.js

@@ -0,0 +1,57 @@
+//#region src/xml/edit.ts
+function setAttr(element, name, value) {
+	for (const a of element.attributes) if (a.name === name) {
+		a.value = value;
+		return;
+	}
+	element.attributes.push({
+		name,
+		value
+	});
+}
+function removeAttr(element, name) {
+	const index = element.attributes.findIndex((a) => a.name === name);
+	if (index !== -1) element.attributes.splice(index, 1);
+}
+function removeChild(container, child) {
+	const index = container.indexOf(child);
+	if (index === -1) return false;
+	container.splice(index, 1);
+	return true;
+}
+function insertBefore(container, reference, newNode) {
+	const index = container.indexOf(reference);
+	container.splice(index === -1 ? container.length : index, 0, newNode);
+}
+function insertAfter(container, reference, newNode) {
+	const index = container.indexOf(reference);
+	container.splice(index === -1 ? container.length : index + 1, 0, newNode);
+}
+function insertInSchemaOrder(parent, child, order) {
+	const childRank = order.indexOf(child.tag);
+	if (childRank === -1) {
+		parent.children.push(child);
+		return;
+	}
+	for (const sibling of parent.children) {
+		if (sibling.type !== "element") continue;
+		const siblingRank = order.indexOf(sibling.tag);
+		if (siblingRank !== -1 && siblingRank > childRank) {
+			insertBefore(parent.children, sibling, child);
+			return;
+		}
+	}
+	parent.children.push(child);
+}
+function directChildElement(parent, tag) {
+	for (const child of parent.children) if (child.type === "element" && child.tag === tag) return child;
+}
+function getOrCreateChildElement(parent, tag, order, build) {
+	const existing = directChildElement(parent, tag);
+	if (existing !== void 0) return existing;
+	const created = build();
+	insertInSchemaOrder(parent, created, order);
+	return created;
+}
+//#endregion
+export { directChildElement, getOrCreateChildElement, insertAfter, insertBefore, insertInSchemaOrder, removeAttr, removeChild, setAttr };

package/dist/xml/entities.cjs

@@ -0,0 +1,12 @@
+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 LEADING_OR_TRAILING_WHITESPACE = /^\s|\s$/;
+function needsSpacePreserve(text) {
+	return LEADING_OR_TRAILING_WHITESPACE.test(text);
+}
+//#endregion
+exports.encodeXmlText = encodeXmlText;
+exports.needsSpacePreserve = needsSpacePreserve;

package/dist/xml/entities.d.cts

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

package/dist/xml/entities.d.ts

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

package/dist/xml/entities.js

@@ -0,0 +1,10 @@
+//#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 LEADING_OR_TRAILING_WHITESPACE = /^\s|\s$/;
+function needsSpacePreserve(text) {
+	return LEADING_OR_TRAILING_WHITESPACE.test(text);
+}
+//#endregion
+export { encodeXmlText, needsSpacePreserve };

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 { XmlElement, XmlNode, XmlText } from "ooxml.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.d.ts

@@ -0,0 +1,6 @@
+import { XmlElement, XmlNode, XmlText } from "ooxml.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/odf-text.cjs

@@ -0,0 +1,53 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_fragment = require("./fragment.cjs");
+const require_xml_entities = require("./entities.cjs");
+let odf_js = require("odf.js");
+//#region src/xml/odf-text.ts
+const MIN_SPACE_RUN_FOR_TEXT_S = 2;
+function encodeOdfText(text) {
+	const nodes = [];
+	let literal = "";
+	const flushLiteral = () => {
+		if (literal.length > 0) {
+			nodes.push(require_xml_fragment.txt(require_xml_entities.encodeXmlText(literal)));
+			literal = "";
+		}
+	};
+	let i = 0;
+	while (i < text.length) {
+		const ch = text[i];
+		if (ch === " ") {
+			let runLength = 1;
+			while (i + runLength < text.length && text[i + runLength] === " ") runLength += 1;
+			if (runLength >= MIN_SPACE_RUN_FOR_TEXT_S) {
+				flushLiteral();
+				nodes.push(require_xml_fragment.el("text:s", { "text:c": String(runLength) }));
+			} else literal += " ";
+			i += runLength;
+			continue;
+		}
+		if (ch === "	") {
+			flushLiteral();
+			nodes.push(require_xml_fragment.el("text:tab"));
+			i += 1;
+			continue;
+		}
+		if (ch === "\n") {
+			flushLiteral();
+			nodes.push(require_xml_fragment.el("text:line-break"));
+			i += 1;
+			continue;
+		}
+		literal += ch;
+		i += 1;
+	}
+	flushLiteral();
+	return nodes;
+}
+function decodeOdfText(nodes) {
+	const wrapper = require_xml_fragment.el("_odf-text-container", {}, [...nodes]);
+	return (0, odf_js.decodeOdfText)(wrapper);
+}
+//#endregion
+exports.decodeOdfText = decodeOdfText;
+exports.encodeOdfText = encodeOdfText;

package/dist/xml/odf-text.d.cts

@@ -0,0 +1,6 @@
+import { XmlNode } from "ooxml.js";
+//#region src/xml/odf-text.d.ts
+declare function encodeOdfText(text: string): XmlNode[];
+declare function decodeOdfText(nodes: readonly XmlNode[]): string;
+//#endregion
+export { decodeOdfText, encodeOdfText };

package/dist/xml/odf-text.d.ts

@@ -0,0 +1,6 @@
+import { XmlNode } from "ooxml.js";
+//#region src/xml/odf-text.d.ts
+declare function encodeOdfText(text: string): XmlNode[];
+declare function decodeOdfText(nodes: readonly XmlNode[]): string;
+//#endregion
+export { decodeOdfText, encodeOdfText };

package/dist/xml/odf-text.js

@@ -0,0 +1,51 @@
+import { el, txt } from "./fragment.js";
+import { encodeXmlText } from "./entities.js";
+import { decodeOdfText as decodeOdfText$1 } from "odf.js";
+//#region src/xml/odf-text.ts
+const MIN_SPACE_RUN_FOR_TEXT_S = 2;
+function encodeOdfText(text) {
+	const nodes = [];
+	let literal = "";
+	const flushLiteral = () => {
+		if (literal.length > 0) {
+			nodes.push(txt(encodeXmlText(literal)));
+			literal = "";
+		}
+	};
+	let i = 0;
+	while (i < text.length) {
+		const ch = text[i];
+		if (ch === " ") {
+			let runLength = 1;
+			while (i + runLength < text.length && text[i + runLength] === " ") runLength += 1;
+			if (runLength >= MIN_SPACE_RUN_FOR_TEXT_S) {
+				flushLiteral();
+				nodes.push(el("text:s", { "text:c": String(runLength) }));
+			} else literal += " ";
+			i += runLength;
+			continue;
+		}
+		if (ch === "	") {
+			flushLiteral();
+			nodes.push(el("text:tab"));
+			i += 1;
+			continue;
+		}
+		if (ch === "\n") {
+			flushLiteral();
+			nodes.push(el("text:line-break"));
+			i += 1;
+			continue;
+		}
+		literal += ch;
+		i += 1;
+	}
+	flushLiteral();
+	return nodes;
+}
+function decodeOdfText(nodes) {
+	const wrapper = el("_odf-text-container", {}, [...nodes]);
+	return decodeOdfText$1(wrapper);
+}
+//#endregion
+export { decodeOdfText, encodeOdfText };

package/dist/xml/query.cjs

@@ -0,0 +1,33 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/xml/query.ts
+function findChildElement(container, tag) {
+	for (const node of container) if (node.type === "element" && node.tag === tag) return {
+		container,
+		node
+	};
+}
+function findChildElements(container, tag) {
+	const out = [];
+	for (const node of container) if (node.type === "element" && node.tag === tag) out.push({
+		container,
+		node
+	});
+	return out;
+}
+function* walkElements(container) {
+	for (const node of container) if (node.type === "element") {
+		yield {
+			container,
+			node
+		};
+		yield* walkElements(node.children);
+	}
+}
+function findDescendantElement(container, tag) {
+	for (const cursor of walkElements(container)) if (cursor.node.tag === tag) return cursor;
+}
+//#endregion
+exports.findChildElement = findChildElement;
+exports.findChildElements = findChildElements;
+exports.findDescendantElement = findDescendantElement;
+exports.walkElements = walkElements;

package/dist/xml/query.d.cts

@@ -0,0 +1,12 @@
+import { XmlElement, XmlNode } from "ooxml.js";
+//#region src/xml/query.d.ts
+interface ElementCursor {
+  readonly container: XmlNode[];
+  readonly node: XmlElement;
+}
+declare function findChildElement(container: XmlNode[], tag: string): ElementCursor | undefined;
+declare function findChildElements(container: XmlNode[], tag: string): ElementCursor[];
+declare function walkElements(container: XmlNode[]): Generator<ElementCursor>;
+declare function findDescendantElement(container: XmlNode[], tag: string): ElementCursor | undefined;
+//#endregion
+export { ElementCursor, findChildElement, findChildElements, findDescendantElement, walkElements };

package/dist/xml/query.d.ts

@@ -0,0 +1,12 @@
+import { XmlElement, XmlNode } from "ooxml.js";
+//#region src/xml/query.d.ts
+interface ElementCursor {
+  readonly container: XmlNode[];
+  readonly node: XmlElement;
+}
+declare function findChildElement(container: XmlNode[], tag: string): ElementCursor | undefined;
+declare function findChildElements(container: XmlNode[], tag: string): ElementCursor[];
+declare function walkElements(container: XmlNode[]): Generator<ElementCursor>;
+declare function findDescendantElement(container: XmlNode[], tag: string): ElementCursor | undefined;
+//#endregion
+export { ElementCursor, findChildElement, findChildElements, findDescendantElement, walkElements };

package/dist/xml/query.js

@@ -0,0 +1,29 @@
+//#region src/xml/query.ts
+function findChildElement(container, tag) {
+	for (const node of container) if (node.type === "element" && node.tag === tag) return {
+		container,
+		node
+	};
+}
+function findChildElements(container, tag) {
+	const out = [];
+	for (const node of container) if (node.type === "element" && node.tag === tag) out.push({
+		container,
+		node
+	});
+	return out;
+}
+function* walkElements(container) {
+	for (const node of container) if (node.type === "element") {
+		yield {
+			container,
+			node
+		};
+		yield* walkElements(node.children);
+	}
+}
+function findDescendantElement(container, tag) {
+	for (const cursor of walkElements(container)) if (cursor.node.tag === tag) return cursor;
+}
+//#endregion
+export { findChildElement, findChildElements, findDescendantElement, walkElements };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "documents.js",
-  "version": "1.57.0",
+  "version": "1.58.0",
   "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": {
@@ -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",