@doxi/docx 0.11.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mahbub Hasan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# @doxi/docx
+
+DOCX (OOXML) export and import for Doxiva. **Zero runtime dependencies** — hand-written ZIP reader/writer, hand-written OOXML builder, hand-rolled XML parser with a `DOMParser` fast path.
+
+> **Status:** v0.10.x preview. Round-trips Doxiva-authored DOCX losslessly within the supported schema subset; foreign docs (Word / LibreOffice / Google Docs export) come in best-effort with explicit warnings.
+
+## Install
+
+```bash
+pnpm add @doxi/docx @doxi/core
+```
+
+## Export
+
+```ts
+import { exportDocx } from '@doxi/docx'
+
+const bytes: Uint8Array = exportDocx(doc) // pure function. Deterministic output.
+// Save to disk, send to server, trigger a browser download — your call.
+```
+
+Pure function: no DOM, no view state, no IO. Deterministic byte output, suitable for golden-file snapshots.
+
+## Import
+
+```ts
+import { importDocx } from '@doxi/docx'
+
+const { doc, warnings } = await importDocx(bytes)
+// warnings: ImportWarning[] — surface in your UI
+view.dispatch(view.state.tr.replace(0, view.state.doc.content.size, doc))
+```
+
+Async because ZIP decompression goes through the platform `DecompressionStream` (Web Streams). Returns a Doxiva document tree plus structured warnings for anything the importer couldn't handle.
+
+## Supported schema subset
+
+Paragraphs (alignment + line height), headings, lists (bullet + numbered, multiple instances), tables (incl. colspan/rowspan + header rows), text with bold/italic/underline/color/font-size/font-family marks, hyperlinks, horizontal rule, forced page break, blockquote.
+
+## Self-round-trip guarantee
+
+`@doxi/docx` ships a property-test harness (`fast-check`) with 200 runs per arbitrary across 5 arbitraries (1000 runs total). Every generator round-trips through `importDocx(exportDocx(doc))` and asserts deep equality against the input.
+
+## Honest deferrals
+
+- **Images** — `word/media/` binaries and `image*.xml` rels are read past silently; no image nodes materialize yet.
+- **`page_var` field codes** (`PAGE`, `NUMPAGES`) — exported as literal placeholder text; imported as literal text.
+- **Multi-section documents** — only the body's first `<w:sectPr>` is considered.
+- **Headers / footers** from `header*.xml` / `footer*.xml` parts are not yet wired into the imported `pageMeta`.
+- **Track changes / comments / footnotes** — ignored.
+- **DEFLATE compression** — exports are ~2-3× the size of typical `.docx`. Word reads them without complaint.
+
+## Security
+
+`importDocx` rejects `<w:hyperlink>` targets matching `javascript:`, `vbscript:`, and non-image `data:` URLs. An `'unsafe-content'` `ImportWarning` is emitted so the host UI can surface "1 unsafe link was removed". See [`docs/security-review.md`](../../docs/security-review.md).
+
+## License
+
+[MIT](LICENSE)

package/dist/blocks.d.ts

@@ -0,0 +1,30 @@
+import type { DxNode } from '@doxi/core';
+import { type XmlElement } from './xml.js';
+import type { RenderCtx } from './runs.js';
+/** Optional paragraph render hints — set by list renderer / heading wrapper. */
+export interface ParagraphOpts {
+    /** Apply a paragraph style (e.g. 'Heading1', 'Quote') via `<w:pStyle>`. */
+    readonly style?: string;
+    /** Emit a `<w:numPr>` with the given numbering instance + indent level. */
+    readonly listNumId?: number;
+    readonly listIlvl?: number;
+}
+/** Render a `paragraph` node as `<w:p>`. */
+export declare function renderParagraph(node: DxNode, ctx: RenderCtx, opts?: ParagraphOpts): XmlElement;
+/**
+ * Render a `heading` node as `<w:p>` with a Heading{level} style. Levels are
+ * clamped to 1..6 to match the styles defined in `parts.ts:stylesXml`.
+ */
+export declare function renderHeading(node: DxNode, ctx: RenderCtx): XmlElement;
+/**
+ * Render a `blockquote` by flattening its inner blocks. Every inner block
+ * becomes a `Quote`-styled paragraph; that loses headings-inside-blockquote
+ * styling, but blockquote-around-heading is not idiomatic enough to justify
+ * a richer mapping in v0.7.
+ */
+export declare function renderBlockquote(node: DxNode, ctx: RenderCtx): XmlElement[];
+/** Horizontal rule → empty paragraph with a bottom border. */
+export declare function renderHr(_node: DxNode): XmlElement;
+/** Forced page break → paragraph wrapping a `<w:br w:type="page"/>`. */
+export declare function renderPageBreak(_node: DxNode): XmlElement;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../src/blocks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAM,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,GAAE,aAAkB,GAAG,UAAU,CAMlG;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,CAItE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE,CAO3E;AAED,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAQlD;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAMzD"}

package/dist/blocks.js

@@ -0,0 +1,69 @@
+import { el } from './xml.js';
+import { renderInline } from './inline.js';
+/** Render a `paragraph` node as `<w:p>`. */
+export function renderParagraph(node, ctx, opts = {}) {
+    const pPr = pprForParagraph(node.attrs, opts);
+    const children = [];
+    if (pPr)
+        children.push(pPr);
+    for (const r of renderInline(node.content, ctx))
+        children.push(r);
+    return el('w:p', null, ...children);
+}
+/**
+ * Render a `heading` node as `<w:p>` with a Heading{level} style. Levels are
+ * clamped to 1..6 to match the styles defined in `parts.ts:stylesXml`.
+ */
+export function renderHeading(node, ctx) {
+    const raw = node.attrs.level ?? 1;
+    const level = Math.min(6, Math.max(1, raw));
+    return renderParagraph(node, ctx, { style: `Heading${level}` });
+}
+/**
+ * Render a `blockquote` by flattening its inner blocks. Every inner block
+ * becomes a `Quote`-styled paragraph; that loses headings-inside-blockquote
+ * styling, but blockquote-around-heading is not idiomatic enough to justify
+ * a richer mapping in v0.7.
+ */
+export function renderBlockquote(node, ctx) {
+    const out = [];
+    for (let i = 0; i < node.content.childCount; i++) {
+        const child = node.content.child(i);
+        out.push(renderParagraph(child, ctx, { style: 'Quote' }));
+    }
+    return out;
+}
+/** Horizontal rule → empty paragraph with a bottom border. */
+export function renderHr(_node) {
+    return el('w:p', null, el('w:pPr', null, el('w:pBdr', null, el('w:bottom', { 'w:val': 'single', 'w:sz': '6', 'w:space': '1', 'w:color': 'auto' }))));
+}
+/** Forced page break → paragraph wrapping a `<w:br w:type="page"/>`. */
+export function renderPageBreak(_node) {
+    return el('w:p', null, el('w:r', null, el('w:br', { 'w:type': 'page' })));
+}
+/**
+ * Build a `<w:pPr>` from a paragraph's attrs + opts. Returns null when no
+ * paragraph-level properties are needed.
+ */
+function pprForParagraph(attrs, opts) {
+    const children = [];
+    if (opts.style)
+        children.push(el('w:pStyle', { 'w:val': opts.style }));
+    if (opts.listNumId !== undefined) {
+        const ilvl = opts.listIlvl ?? 0;
+        children.push(el('w:numPr', null, el('w:ilvl', { 'w:val': String(ilvl) }), el('w:numId', { 'w:val': String(opts.listNumId) })));
+    }
+    const align = attrs.align;
+    if (align === 'left' || align === 'center' || align === 'right' || align === 'justify') {
+        const map = { left: 'left', center: 'center', right: 'right', justify: 'both' };
+        children.push(el('w:jc', { 'w:val': map[align] }));
+    }
+    const lineHeight = attrs.lineHeight;
+    if (typeof lineHeight === 'number' && lineHeight > 0) {
+        // Word's single-line is 240 (twentieths of a point). Multiplier × 240 with
+        // `w:lineRule="auto"` reproduces a CSS line-height multiplier.
+        children.push(el('w:spacing', { 'w:line': String(Math.round(240 * lineHeight)), 'w:lineRule': 'auto' }));
+    }
+    return children.length ? el('w:pPr', null, ...children) : null;
+}
+//# sourceMappingURL=blocks.js.map

package/dist/blocks.js.map

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

package/dist/export.d.ts

@@ -0,0 +1,41 @@
+import type { DxNode } from '@doxi/core';
+export interface ExportDocxOptions {
+    /** Page size in twips. Default = US Letter (12240 × 15840). */
+    readonly pageSize?: {
+        widthTwips: number;
+        heightTwips: number;
+    };
+    /** Page margins in twips. Default = 1in on all sides (1440 twips). */
+    readonly marginsTwips?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+}
+export interface RenderDocumentResult {
+    readonly xml: string;
+    /** Hyperlinks discovered during render — used to emit document.xml.rels. */
+    readonly hyperlinks: ReadonlyArray<{
+        id: string;
+        target: string;
+    }>;
+    /** Per-list numbering instances to be emitted in numbering.xml. */
+    readonly numberingPlan: ReadonlyArray<{
+        numId: number;
+        ordered: boolean;
+    }>;
+}
+/**
+ * Walk the Doxiva doc tree and emit `word/document.xml`. Side data
+ * (hyperlinks, numbering plan) is returned so the caller can wire it into
+ * the corresponding parts.
+ */
+export declare function renderDocumentXml(doc: DxNode, opts: ExportDocxOptions): RenderDocumentResult;
+/**
+ * Serialize a Doxiva doc tree into a `.docx` (OOXML zip). Pure function —
+ * no DOM, no view state, no IO. Output is deterministic so snapshot tests
+ * stay stable across runs.
+ */
+export declare function exportDocx(doc: DxNode, opts?: ExportDocxOptions): Uint8Array;
+//# sourceMappingURL=export.d.ts.map

package/dist/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAexC,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/D,sEAAsE;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CACrF;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClE,mEAAmE;IACnE,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAC3E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,oBAAoB,CA4B5F;AAgBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,UAAU,CAYhF"}

package/dist/export.js

@@ -0,0 +1,70 @@
+import { buildZip } from './zip.js';
+import { contentTypesXml, rootRelsXml, stylesXml, numberingXml, documentRelsXml } from './parts.js';
+import { el, renderXml } from './xml.js';
+import { newRenderCtx } from './runs.js';
+import { renderParagraph, renderHeading, renderBlockquote, renderHr, renderPageBreak, } from './blocks.js';
+import { renderList } from './lists.js';
+import { renderTable } from './tables.js';
+/**
+ * Walk the Doxiva doc tree and emit `word/document.xml`. Side data
+ * (hyperlinks, numbering plan) is returned so the caller can wire it into
+ * the corresponding parts.
+ */
+export function renderDocumentXml(doc, opts) {
+    const ctx = newRenderCtx();
+    const bodyChildren = [];
+    for (let i = 0; i < doc.content.childCount; i++) {
+        bodyChildren.push(...renderBlock(doc.content.child(i), ctx));
+    }
+    // Section properties at end of body (page size + margins).
+    const pageW = opts.pageSize?.widthTwips ?? 12240;
+    const pageH = opts.pageSize?.heightTwips ?? 15840;
+    const m = opts.marginsTwips ?? { top: 1440, right: 1440, bottom: 1440, left: 1440 };
+    bodyChildren.push(el('w:sectPr', null, el('w:pgSz', { 'w:w': String(pageW), 'w:h': String(pageH) }), el('w:pgMar', {
+        'w:top': String(m.top),
+        'w:right': String(m.right),
+        'w:bottom': String(m.bottom),
+        'w:left': String(m.left),
+    })));
+    const root = el('w:document', {
+        'xmlns:w': 'http://schemas.openxmlformats.org/wordprocessingml/2006/main',
+        'xmlns:r': 'http://schemas.openxmlformats.org/officeDocument/2006/relationships',
+    }, el('w:body', null, ...bodyChildren));
+    return {
+        xml: renderXml(root, { declaration: true }),
+        hyperlinks: ctx.hyperlinks,
+        numberingPlan: ctx.numberingPlan,
+    };
+}
+/** Top-level block dispatch. Unsupported types are silently dropped. */
+function renderBlock(node, ctx) {
+    switch (node.type.name) {
+        case 'paragraph': return [renderParagraph(node, ctx)];
+        case 'heading': return [renderHeading(node, ctx)];
+        case 'blockquote': return renderBlockquote(node, ctx);
+        case 'hr': return [renderHr(node)];
+        case 'page_break': return [renderPageBreak(node)];
+        case 'list': return renderList(node, ctx, 0);
+        case 'table': return [renderTable(node, ctx)];
+        default: return [];
+    }
+}
+/**
+ * Serialize a Doxiva doc tree into a `.docx` (OOXML zip). Pure function —
+ * no DOM, no view state, no IO. Output is deterministic so snapshot tests
+ * stay stable across runs.
+ */
+export function exportDocx(doc, opts = {}) {
+    const { xml, hyperlinks, numberingPlan } = renderDocumentXml(doc, opts);
+    const enc = new TextEncoder();
+    const entries = [
+        { name: '[Content_Types].xml', data: enc.encode(contentTypesXml()) },
+        { name: '_rels/.rels', data: enc.encode(rootRelsXml()) },
+        { name: 'word/document.xml', data: enc.encode(xml) },
+        { name: 'word/_rels/document.xml.rels', data: enc.encode(documentRelsXml(hyperlinks)) },
+        { name: 'word/styles.xml', data: enc.encode(stylesXml()) },
+        { name: 'word/numbering.xml', data: enc.encode(numberingXml(numberingPlan)) },
+    ];
+    return buildZip(entries);
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

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

package/dist/import.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `importDocx` — read a `.docx` (OOXML zip) and produce a Doxiva doc tree.
+ *
+ * Body dispatch walks `w:body` children and routes each to the matching
+ * parser:
+ *   - `w:p` → parseParagraph (Track B). Returns either a plain block or a
+ *     `list-paragraph` that we accumulate and convert into a `list` node
+ *     once we see a paragraph with a different numId (Track D).
+ *   - `w:tbl` → parseTable (Track C).
+ *   - `w:sectPr` → ignored (single-section v0.8).
+ *
+ * Best-effort by design: malformed input, unknown elements, and missing
+ * parts are reported via `ImportWarning` rather than thrown.
+ */
+import type { DxNode, Schema } from '@doxi/core';
+import { type ImportWarning } from './warnings.js';
+export interface ImportDocxOptions {
+    readonly schema?: Schema;
+}
+export interface ImportDocxResult {
+    readonly doc: DxNode;
+    readonly warnings: ReadonlyArray<ImportWarning>;
+}
+export declare function importDocx(bytes: Uint8Array, opts?: ImportDocxOptions): Promise<ImportDocxResult>;
+/**
+ * Parse `word/_rels/document.xml.rels` into a relationship-id → target map.
+ * Returns an empty map on malformed input rather than throwing — relationship
+ * loss is reported by individual element parsers via `unknown-relationship`
+ * warnings instead.
+ */
+export declare function parseRels(xml: string): Map<string, {
+    target: string;
+    type?: string;
+}>;
+//# sourceMappingURL=import.d.ts.map

package/dist/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../src/import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAIhD,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAKpE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;CAChD;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAkG3B;AAcD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBrF"}

package/dist/import.js

@@ -0,0 +1,156 @@
+/**
+ * `importDocx` — read a `.docx` (OOXML zip) and produce a Doxiva doc tree.
+ *
+ * Body dispatch walks `w:body` children and routes each to the matching
+ * parser:
+ *   - `w:p` → parseParagraph (Track B). Returns either a plain block or a
+ *     `list-paragraph` that we accumulate and convert into a `list` node
+ *     once we see a paragraph with a different numId (Track D).
+ *   - `w:tbl` → parseTable (Track C).
+ *   - `w:sectPr` → ignored (single-section v0.8).
+ *
+ * Best-effort by design: malformed input, unknown elements, and missing
+ * parts are reported via `ImportWarning` rather than thrown.
+ */
+import { defaultSchema } from '@doxi/core';
+import { unzip } from './unzip.js';
+import { parseXml } from './parse-xml.js';
+import { WarningCollector } from './warnings.js';
+import { parseParagraph } from './parse-blocks.js';
+import { parseTable } from './parse-tables.js';
+import { parseNumbering } from './parse-numbering.js';
+export async function importDocx(bytes, opts = {}) {
+    const schema = (opts.schema ?? defaultSchema);
+    const warnings = new WarningCollector();
+    let entries;
+    try {
+        entries = await unzip(bytes);
+    }
+    catch (err) {
+        warnings.add({ code: 'malformed-xml', message: `Failed to unzip archive: ${err.message}` });
+        return { doc: emptyDoc(schema), warnings: warnings.warnings };
+    }
+    const docEntry = entries.find((e) => e.name === 'word/document.xml');
+    if (!docEntry) {
+        warnings.add({ code: 'malformed-xml', message: 'No word/document.xml found in archive' });
+        return { doc: emptyDoc(schema), warnings: warnings.warnings };
+    }
+    const relsEntry = entries.find((e) => e.name === 'word/_rels/document.xml.rels');
+    const rels = relsEntry
+        ? parseRels(new TextDecoder().decode(relsEntry.data))
+        : new Map();
+    const numberingEntry = entries.find((e) => e.name === 'word/numbering.xml');
+    const numbering = parseNumbering(numberingEntry ? new TextDecoder().decode(numberingEntry.data) : undefined, warnings);
+    let root;
+    try {
+        root = parseXml(new TextDecoder().decode(docEntry.data)).root;
+    }
+    catch (err) {
+        warnings.add({ code: 'malformed-xml', message: err.message, path: 'word/document.xml' });
+        return { doc: emptyDoc(schema), warnings: warnings.warnings };
+    }
+    const ctx = { schema, warnings, rels };
+    const body = findChild(root, 'w:body');
+    const blocks = [];
+    if (body) {
+        let listAcc = [];
+        const flushList = () => {
+            if (listAcc.length === 0)
+                return;
+            // Group consecutive entries with the same numId into one `list` node.
+            let i = 0;
+            while (i < listAcc.length) {
+                const startNumId = listAcc[i].numId;
+                let j = i + 1;
+                while (j < listAcc.length && listAcc[j].numId === startNumId)
+                    j++;
+                const items = listAcc.slice(i, j);
+                const ordered = numbering.instances.get(startNumId)?.ordered ?? false;
+                const listItems = items.map((it) => schema.node('list_item', null, [it.node]));
+                blocks.push(schema.node('list', { ordered }, listItems));
+                i = j;
+            }
+            listAcc = [];
+        };
+        for (const child of body.children) {
+            if (typeof child === 'string')
+                continue;
+            const el = child;
+            switch (el.name) {
+                case 'w:p': {
+                    const parsed = parseParagraph(el, ctx);
+                    if (parsed.kind === 'list-paragraph') {
+                        listAcc.push({ numId: parsed.numId, ilvl: parsed.ilvl, node: parsed.node });
+                    }
+                    else {
+                        flushList();
+                        blocks.push(parsed.node);
+                    }
+                    break;
+                }
+                case 'w:tbl':
+                    flushList();
+                    blocks.push(parseTable(el, ctx));
+                    break;
+                case 'w:sectPr':
+                    // Section properties carried at the body tail — ignored for import.
+                    break;
+                default:
+                    flushList();
+                    warnings.add({
+                        code: 'unknown-element',
+                        message: `Unknown body child: ${el.name}`,
+                        path: 'word/document.xml',
+                    });
+            }
+        }
+        flushList();
+    }
+    else {
+        warnings.add({ code: 'malformed-xml', message: 'document.xml has no w:body', path: 'word/document.xml' });
+    }
+    if (blocks.length === 0)
+        blocks.push(schema.node('paragraph', null));
+    return { doc: schema.node('doc', null, blocks), warnings: warnings.warnings };
+}
+function emptyDoc(schema) {
+    return schema.node('doc', null, [schema.node('paragraph', null)]);
+}
+function findChild(el, name) {
+    for (const c of el.children) {
+        if (typeof c === 'string')
+            continue;
+        if (c.name === name)
+            return c;
+    }
+    return null;
+}
+/**
+ * Parse `word/_rels/document.xml.rels` into a relationship-id → target map.
+ * Returns an empty map on malformed input rather than throwing — relationship
+ * loss is reported by individual element parsers via `unknown-relationship`
+ * warnings instead.
+ */
+export function parseRels(xml) {
+    const result = new Map();
+    try {
+        const root = parseXml(xml).root;
+        for (const c of root.children) {
+            if (typeof c === 'string')
+                continue;
+            if (c.name === 'Relationship') {
+                const id = c.attrs.Id;
+                const target = c.attrs.Target;
+                const type = c.attrs.Type;
+                if (id && target) {
+                    result.set(id, type !== undefined ? { target, type } : { target });
+                }
+            }
+        }
+    }
+    catch {
+        /* malformed rels: return whatever we got */
+    }
+    return result;
+}
+//# sourceMappingURL=import.js.map

package/dist/import.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { exportDocx, type ExportDocxOptions } from './export.js';
+export { importDocx, type ImportDocxOptions, type ImportDocxResult } from './import.js';
+export { type ImportWarning, type ImportWarningCode } from './warnings.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACvF,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { exportDocx } from './export.js';
+export { importDocx } from './import.js';
+export {} from './warnings.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,UAAU,EAAiD,MAAM,aAAa,CAAA;AACvF,OAAO,EAA8C,MAAM,eAAe,CAAA"}

package/dist/inline.d.ts

@@ -0,0 +1,15 @@
+import type { Fragment } from '@doxi/core';
+import { type XmlElement } from './xml.js';
+import { type RenderCtx } from './runs.js';
+/**
+ * Render a Fragment of inline content into a flat list of `<w:r>` or
+ * `<w:hyperlink>` elements.
+ *
+ * - text with a `link` mark → wrapped in `<w:hyperlink r:id="…">`; a
+ *   relationship is recorded on `ctx.hyperlinks` so documentRelsXml can
+ *   later emit the matching `<Relationship Type="…/hyperlink">`.
+ * - image and page_var nodes are NOT in the v0.7 scope — we emit a literal
+ *   placeholder run so the doc tree is still observable in the export.
+ */
+export declare function renderInline(content: Fragment, ctx: RenderCtx): XmlElement[];
+//# sourceMappingURL=inline.d.ts.map

package/dist/inline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../src/inline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,QAAQ,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAM,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,WAAW,CAAA;AAEzD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE,CA+B5E"}

package/dist/inline.js

@@ -0,0 +1,48 @@
+import { el } from './xml.js';
+import { renderTextRun } from './runs.js';
+/**
+ * Render a Fragment of inline content into a flat list of `<w:r>` or
+ * `<w:hyperlink>` elements.
+ *
+ * - text with a `link` mark → wrapped in `<w:hyperlink r:id="…">`; a
+ *   relationship is recorded on `ctx.hyperlinks` so documentRelsXml can
+ *   later emit the matching `<Relationship Type="…/hyperlink">`.
+ * - image and page_var nodes are NOT in the v0.7 scope — we emit a literal
+ *   placeholder run so the doc tree is still observable in the export.
+ */
+export function renderInline(content, ctx) {
+    const out = [];
+    for (let i = 0; i < content.childCount; i++) {
+        const child = content.child(i);
+        const name = child.type.name;
+        if (child.isText) {
+            const linkMark = child.marks.find((m) => m.type.name === 'link');
+            if (linkMark) {
+                const href = linkMark.attrs.href ?? '';
+                const rid = `rIdLink${ctx.ridCounter.value++}`;
+                ctx.hyperlinks.push({ id: rid, target: href });
+                // `xmlns:r` is declared on the `<w:document>` root in export.ts —
+                // no need to re-declare it per element.
+                out.push(el('w:hyperlink', { 'r:id': rid }, renderTextRun(child)));
+            }
+            else {
+                out.push(renderTextRun(child));
+            }
+        }
+        else if (name === 'image') {
+            // v0.7 doesn't ship image embedding (needs word/media + binary rels).
+            // Emit a literal placeholder so the source intent is preserved.
+            const src = child.attrs.src ?? '';
+            out.push(el('w:r', null, el('w:t', { 'xml:space': 'preserve' }, `[image:${src}]`)));
+        }
+        else if (name === 'page_var') {
+            // v0.7 doesn't ship Word field codes (PAGE / NUMPAGES). Emit a
+            // literal token so the doc remains visually readable.
+            const kind = child.attrs.kind ?? '';
+            out.push(el('w:r', null, el('w:t', { 'xml:space': 'preserve' }, `{${kind}}`)));
+        }
+        // Other inline atoms are not in v0.7 scope — silently skip.
+    }
+    return out;
+}
+//# sourceMappingURL=inline.js.map

package/dist/inline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline.js","sourceRoot":"","sources":["../src/inline.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAmB,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAkB,MAAM,WAAW,CAAA;AAEzD;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,OAAiB,EAAE,GAAc;IAC5D,MAAM,GAAG,GAAiB,EAAE,CAAA;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAW,CAAA;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAA;QAC5B,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;YAChE,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,GAAI,QAAQ,CAAC,KAAK,CAAC,IAA2B,IAAI,EAAE,CAAA;gBAC9D,MAAM,GAAG,GAAG,UAAU,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAA;gBAC9C,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;gBAC9C,kEAAkE;gBAClE,wCAAwC;gBACxC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YACpE,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;YAChC,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,sEAAsE;YACtE,gEAAgE;YAChE,MAAM,GAAG,GAAI,KAAK,CAAC,KAAK,CAAC,GAA0B,IAAI,EAAE,CAAA;YACzD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;QACrF,CAAC;aAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,+DAA+D;YAC/D,sDAAsD;YACtD,MAAM,IAAI,GAAI,KAAK,CAAC,KAAK,CAAC,IAA2B,IAAI,EAAE,CAAA;YAC3D,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAA;QAChF,CAAC;QACD,4DAA4D;IAC9D,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/lists.d.ts

@@ -0,0 +1,17 @@
+import type { DxNode } from '@doxi/core';
+import type { XmlElement } from './xml.js';
+import type { RenderCtx } from './runs.js';
+/**
+ * Render a Doxiva `list` node as a flat sequence of `<w:p>` elements.
+ *
+ * Numbering model:
+ *   - Each Doxiva `list` node gets its OWN numId so consecutive lists
+ *     restart numbering. The numId is allocated on first sight via
+ *     `ctx.numIdCounter` (starts at 3 to avoid the predefined 1/2 in
+ *     numbering.xml) and recorded on `ctx.numberingPlan` so the numbering
+ *     part can emit a matching `<w:num>` instance.
+ *   - Nested lists increase `ilvl` and ALSO get a fresh numId — the
+ *     numbering.xml abstractNum definitions provide ilvl 0 and 1 levels.
+ */
+export declare function renderList(list: DxNode, ctx: RenderCtx, ilvl: number): XmlElement[];
+//# sourceMappingURL=lists.d.ts.map