@otomate/docx 0.0.1

package/dist/xml.js

@@ -0,0 +1,47 @@
+// ---------------------------------------------------------------------------
+// XML parsing/building wrapper for OOXML
+// ---------------------------------------------------------------------------
+import { XMLParser, XMLBuilder } from "fast-xml-parser";
+const parserOptions = {
+    ignoreAttributes: false,
+    attributeNamePrefix: "@_",
+    textNodeName: "#text",
+    trimValues: false,
+    preserveOrder: false,
+    isArray: (name) => {
+        return [
+            "w:p", "w:r", "w:t", "w:tbl", "w:tr", "w:tc",
+            "w:hyperlink", "w:drawing", "w:style",
+            "w:abstractNum", "w:num", "w:lvl",
+        ].includes(name);
+    },
+};
+/** Parser that preserves element order — used for document body */
+const orderedParserOptions = {
+    ignoreAttributes: false,
+    attributeNamePrefix: "@_",
+    textNodeName: "#text",
+    trimValues: false,
+    preserveOrder: true,
+};
+const orderedParser = new XMLParser(orderedParserOptions);
+const builderOptions = {
+    ignoreAttributes: false,
+    attributeNamePrefix: "@_",
+    textNodeName: "#text",
+    format: true,
+    suppressEmptyNode: true,
+};
+const parser = new XMLParser(parserOptions);
+const builder = new XMLBuilder(builderOptions);
+export function parseXml(xml) {
+    return parser.parse(xml);
+}
+/** Parse XML preserving element order. Returns an array of { tagName: children[], :@: attrs } */
+export function parseXmlOrdered(xml) {
+    return orderedParser.parse(xml);
+}
+export function buildXml(obj) {
+    return builder.build(obj);
+}
+//# sourceMappingURL=xml.js.map

package/dist/xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.js","sourceRoot":"","sources":["../src/xml.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,aAAa,GAAG;IACpB,gBAAgB,EAAE,KAAK;IACvB,mBAAmB,EAAE,IAAI;IACzB,YAAY,EAAE,OAAO;IACrB,UAAU,EAAE,KAAK;IACjB,aAAa,EAAE,KAAK;IACpB,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE;QACxB,OAAO;YACL,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;YAC5C,aAAa,EAAE,WAAW,EAAE,SAAS;YACrC,eAAe,EAAE,OAAO,EAAE,OAAO;SAClC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;CACF,CAAC;AAEF,mEAAmE;AACnE,MAAM,oBAAoB,GAAG;IAC3B,gBAAgB,EAAE,KAAK;IACvB,mBAAmB,EAAE,IAAI;IACzB,YAAY,EAAE,OAAO;IACrB,UAAU,EAAE,KAAK;IACjB,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF,MAAM,aAAa,GAAG,IAAI,SAAS,CAAC,oBAAoB,CAAC,CAAC;AAE1D,MAAM,cAAc,GAAG;IACrB,gBAAgB,EAAE,KAAK;IACvB,mBAAmB,EAAE,IAAI;IACzB,YAAY,EAAE,OAAO;IACrB,MAAM,EAAE,IAAI;IACZ,iBAAiB,EAAE,IAAI;CACxB,CAAC;AAEF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,aAAa,CAAC,CAAC;AAC5C,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC,CAAC;AAE/C,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAA4B;IACnD,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/dist/zip.d.ts

@@ -0,0 +1,14 @@
+export interface DocxParts {
+    document: string;
+    styles?: string;
+    numbering?: string;
+    relationships?: string;
+    contentTypes?: string;
+    media: Map<string, Uint8Array>;
+    rawParts: Map<string, string>;
+}
+/** Extract a .docx buffer into structured parts. */
+export declare function extractDocx(buffer: ArrayBuffer | Uint8Array): Promise<DocxParts>;
+/** Pack structured parts back into a .docx buffer. */
+export declare function packDocx(parts: DocxParts): Promise<Uint8Array>;
+//# sourceMappingURL=zip.d.ts.map

package/dist/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../src/zip.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAUD,oDAAoD;AACpD,wBAAsB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAgCtF;AAED,sDAAsD;AACtD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBpE"}

package/dist/zip.js

@@ -0,0 +1,84 @@
+// ---------------------------------------------------------------------------
+// JSZip wrapper for reading/writing .docx archives
+// ---------------------------------------------------------------------------
+import JSZip from "jszip";
+const KNOWN_PARTS = new Set([
+    "word/document.xml",
+    "word/styles.xml",
+    "word/numbering.xml",
+    "word/_rels/document.xml.rels",
+    "[Content_Types].xml",
+]);
+/** Extract a .docx buffer into structured parts. */
+export async function extractDocx(buffer) {
+    const zip = await JSZip.loadAsync(buffer);
+    const parts = { document: "", media: new Map(), rawParts: new Map() };
+    for (const [path, file] of Object.entries(zip.files)) {
+        if (file.dir)
+            continue;
+        if (path === "word/document.xml") {
+            parts.document = await file.async("string");
+        }
+        else if (path === "word/styles.xml") {
+            parts.styles = await file.async("string");
+        }
+        else if (path === "word/numbering.xml") {
+            parts.numbering = await file.async("string");
+        }
+        else if (path === "word/_rels/document.xml.rels") {
+            parts.relationships = await file.async("string");
+        }
+        else if (path === "[Content_Types].xml") {
+            parts.contentTypes = await file.async("string");
+        }
+        else if (path.startsWith("word/media/")) {
+            parts.media.set(path, await file.async("uint8array"));
+        }
+        else {
+            // Store as raw string for round-trip
+            try {
+                parts.rawParts.set(path, await file.async("string"));
+            }
+            catch {
+                // Binary files that aren't media — store as base64
+                const data = await file.async("uint8array");
+                parts.rawParts.set(path, Buffer.from(data).toString("base64"));
+            }
+        }
+    }
+    return parts;
+}
+/** Pack structured parts back into a .docx buffer. */
+export async function packDocx(parts) {
+    const zip = new JSZip();
+    zip.file("[Content_Types].xml", parts.contentTypes ?? DEFAULT_CONTENT_TYPES);
+    zip.file("word/document.xml", parts.document);
+    if (parts.styles)
+        zip.file("word/styles.xml", parts.styles);
+    if (parts.numbering)
+        zip.file("word/numbering.xml", parts.numbering);
+    if (parts.relationships)
+        zip.file("word/_rels/document.xml.rels", parts.relationships);
+    // Media
+    for (const [path, data] of parts.media) {
+        zip.file(path, data);
+    }
+    // Raw parts (round-trip preservation)
+    for (const [path, content] of parts.rawParts) {
+        if (!zip.file(path)) { // Don't overwrite parts we already wrote
+            zip.file(path, content);
+        }
+    }
+    return zip.generateAsync({ type: "uint8array" });
+}
+const DEFAULT_CONTENT_TYPES = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">
+  <Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>
+  <Default Extension="xml" ContentType="application/xml"/>
+  <Default Extension="png" ContentType="image/png"/>
+  <Default Extension="jpeg" ContentType="image/jpeg"/>
+  <Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/>
+  <Override PartName="/word/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml"/>
+  <Override PartName="/word/numbering.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.numbering+xml"/>
+</Types>`;
+//# sourceMappingURL=zip.js.map

package/dist/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../src/zip.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@otomate/docx",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test --import tsx src/__tests__/*.test.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@otomate/core": "workspace:*",
+    "@otomate/css-docx": "workspace:*",
+    "jszip": "^3.10.0",
+    "fast-xml-parser": "^4.4.0"
+  },
+  "devDependencies": {
+    "@otomate/diff": "workspace:*",
+    "@otomate/html": "workspace:*",
+    "@types/node": "^25.5.2",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "description": "docx adapter for the Universal Document Model",
+  "license": "BUSL-1.1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Alessio-G/occam",
+    "directory": "packages/docx"
+  }
+}