@usejunior/docx-core 0.9.1 → 0.10.0

package/dist/primitives/serialize_markdown.js

@@ -0,0 +1,300 @@
+// DOCX → Markdown serializer.
+//
+// This is a *serializer over the existing structured document model* — it does no OOXML
+// parsing. `DocxDocument.buildDocumentView({ showFormatting: true })` already yields a
+// `DocumentViewNode[]` carrying headings, list metadata, grid-aware table context, injected
+// `[^n]` footnote markers, and an HTML-shaped inline-tag string (`tagged_text`). This module
+// turns that model into GitHub-Flavored Markdown.
+//
+// Markdown is intentionally *lossy*: there is no round-trip guarantee. Constructs without a
+// Markdown equivalent (highlighting, font runs, merged/nested table cells, layout) are
+// downgraded as documented below rather than preserved.
+//
+// The inline tokenizer (`inlineTagsToMarkdown`) is the reusable core; the planned HTML
+// emitter (#304) renders the same tokens, so neither serializer reasons about the tag
+// grammar independently and drifts from the emitter in `formatting_tags.ts`.
+import { tokenizeToonInline } from './document_view.js';
+import { LabelType } from './list_labels.js';
+/** Footnote markers already injected into `tagged_text`, e.g. `[^1]`, `[^12]`. */
+const FOOTNOTE_MARKER_RE = /\[\^\d+\]/g;
+/**
+ * Backslash-escape the inline Markdown-significant characters that would otherwise be
+ * interpreted mid-line. GFM honours backslash escapes for ASCII punctuation, so `\*`
+ * renders a literal `*`. We escape only the characters that trigger *inline* constructs
+ * (emphasis, code, links, raw HTML, table pipes); block-level triggers (`#`, `-`, `>`, …)
+ * are handled per-line by {@link escapeLeadingBlockSyntax} so we don't litter prose with
+ * `\.` and `\-` on every sentence.
+ *
+ * Already-present `[^n]` footnote markers are protected: escaping their `[`/`]`/`^` would
+ * sever them from the appended `[^n]: …` definitions.
+ */
+function escapeInlineText(text) {
+    const escapeSpan = (s) => s.replace(/[\\`*_[\]<|]/g, (c) => `\\${c}`);
+    let out = '';
+    let lastIndex = 0;
+    for (const match of text.matchAll(FOOTNOTE_MARKER_RE)) {
+        const idx = match.index ?? 0;
+        out += escapeSpan(text.slice(lastIndex, idx));
+        out += match[0]; // leave the footnote marker untouched
+        lastIndex = idx + match[0].length;
+    }
+    out += escapeSpan(text.slice(lastIndex));
+    return out;
+}
+/**
+ * Escape a leading block-level trigger so a normal paragraph whose visible text begins with
+ * `#`, `>`, `-`, `+`, `* `, or `N.`/`N)` is not mis-read as a heading, quote, or list.
+ * Block triggers always require a trailing space, whereas the emphasis we emit (`**`, `*`)
+ * never does — so matching the space-terminated forms cannot corrupt generated Markdown.
+ */
+function escapeLeadingBlockSyntax(line) {
+    return line.replace(/^(\s*)(#{1,6}(?= )|>(?= )|[-+*](?= )|\d+[.)](?= ))/, (_m, ws, trig) => {
+        if (/^\d/.test(trig)) {
+            // ordered-list trigger: escape the delimiter (the `.` or `)`), keep the digits
+            return `${ws}${trig.slice(0, -1)}\\${trig.slice(-1)}`;
+        }
+        return `${ws}\\${trig[0]}${trig.slice(1)}`;
+    });
+}
+export function inlineTagsToMarkdown(text) {
+    const ops = [];
+    const linkUrls = []; // stack of open <a> hrefs (links don't nest meaningfully)
+    for (const token of tokenizeToonInline(text)) {
+        if (token.kind === 'text') {
+            ops.push({ t: 'md', v: escapeInlineText(token.value) });
+            continue;
+        }
+        const tag = token.value;
+        if (tag === '<b>')
+            ops.push({ t: 'emph', kind: 'b', dir: 1 });
+        else if (tag === '</b>')
+            ops.push({ t: 'emph', kind: 'b', dir: -1 });
+        else if (tag === '<i>')
+            ops.push({ t: 'emph', kind: 'i', dir: 1 });
+        else if (tag === '</i>')
+            ops.push({ t: 'emph', kind: 'i', dir: -1 });
+        else if (tag === '<u>' || tag === '</u>')
+            ops.push({ t: 'md', v: tag }); // raw HTML passthrough
+        else if (tag.startsWith('<a ')) {
+            linkUrls.push(/href="([^"]*)"/.exec(tag)?.[1] ?? '');
+            ops.push({ t: 'md', v: '[' });
+        }
+        else if (tag === '</a>') {
+            ops.push({ t: 'md', v: `](${linkUrls.pop() ?? ''})` });
+        }
+        // <highlight>, </highlight>, <font …>, </font> → strip (emit nothing, keep inner text)
+    }
+    // Defensive: an unbalanced <a> (no closing tag) would leave a dangling "["; close it.
+    while (linkUrls.length > 0) {
+        ops.push({ t: 'md', v: `](${linkUrls.pop()})` });
+    }
+    // Emit emphasis delimiters only where the *active* emphasis state actually changes
+    // between two text spans. Word splits a single formatted phrase into many runs, so
+    // `tagged_text` carries boundary noise: `</b></i><b><i>` (state unchanged across the
+    // boundary), interleaved different-kind toggles `</b></i><i><b>`, or empty `<b></b>`
+    // pairs. Mapping each toggle naively yields runs like `******` / `****` that render as
+    // literal asterisks. Tracking the state and reconciling on a stack collapses all of that
+    // to the minimal delimiters while keeping nesting well-formed (`**a*b*c**`).
+    const DELIM = { b: '**', i: '*' };
+    let out = '';
+    const activeStack = []; // emphasis kinds currently open, in open order
+    const desired = new Set(); // running target state as we scan emph ops
+    const reconcile = () => {
+        // Close from the top until every still-open kind is wanted, remembering any wanted
+        // kinds we had to close (because they sat above an unwanted one) so we can reopen them.
+        const reopen = [];
+        while (activeStack.length > 0 && !activeStack.every((k) => desired.has(k))) {
+            const k = activeStack.pop();
+            out += DELIM[k];
+            if (desired.has(k))
+                reopen.push(k);
+        }
+        // Open the kinds that are wanted but not currently open: the reopened ones first (in
+        // their original open order), then any brand-new kinds in a stable order (b before i).
+        const active = new Set(activeStack);
+        const toOpen = [...reopen.reverse(), ...['b', 'i'].filter((k) => desired.has(k))];
+        for (const k of toOpen) {
+            if (active.has(k))
+                continue;
+            active.add(k);
+            activeStack.push(k);
+            out += DELIM[k];
+        }
+    };
+    for (const op of ops) {
+        if (op.t === 'emph') {
+            if (op.dir === 1)
+                desired.add(op.kind);
+            else
+                desired.delete(op.kind);
+            continue;
+        }
+        reconcile(); // realize pending state changes before emitting literal text/Markdown
+        out += op.v;
+    }
+    desired.clear();
+    reconcile(); // close any still-open emphasis at end of string
+    return out;
+}
+/** A heading is structural (gets `#`) only when Word's style told us so and gave a level. */
+function isStructuralHeading(node) {
+    return node.heading?.source === 'word_style' && typeof node.heading.level === 'number';
+}
+function renderListItem(node) {
+    const lm = node.list_metadata;
+    const level = Math.max(0, lm.list_level);
+    const indent = '  '.repeat(level);
+    const text = inlineTagsToMarkdown(node.tagged_text).trim();
+    const label = lm.label_string?.trim() ?? '';
+    // True auto-numbered numeric lists render as a Markdown ordered list (let the renderer
+    // number them). Everything else preserves the *literal* label — legal documents carry
+    // meaningful labels like `Section 2.1`, `Article IV`, `(a)`, `(i)` that a bare `1.` would
+    // silently destroy.
+    if (lm.label_type === LabelType.NUMBER && lm.is_auto_numbered) {
+        return `${indent}1. ${text}`.trimEnd();
+    }
+    if (label) {
+        return `${indent}- ${label} ${text}`.trimEnd();
+    }
+    return `${indent}- ${text}`.trimEnd();
+}
+/**
+ * Render a run of nodes that share a `table_context.table_id` as a GFM table.
+ *
+ * Lossy by design (GFM has no merged/nested-cell support):
+ * - Horizontally merged cells (`gridSpan`) advance `col_index`, leaving grid gaps that we
+ *   fill with empty cells so the column count stays consistent and viewers don't break.
+ * - Vertically merged cells (`vMerge`) and nested tables are flattened into the body-level
+ *   grid; multi-paragraph cells are joined with `<br>`.
+ */
+function renderTable(group) {
+    let totalCols = 0;
+    for (const n of group) {
+        const tc = n.table_context;
+        if (!tc)
+            continue;
+        totalCols = Math.max(totalCols, tc.total_cols, tc.col_index + 1);
+    }
+    if (totalCols <= 0)
+        return [];
+    const rows = new Map();
+    const rowOrder = [];
+    const headerRows = new Set();
+    for (const n of group) {
+        const tc = n.table_context;
+        if (!tc)
+            continue;
+        if (!rows.has(tc.row_index)) {
+            rows.set(tc.row_index, new Map());
+            rowOrder.push(tc.row_index);
+        }
+        const cellMap = rows.get(tc.row_index);
+        // A raw newline inside a cell (from a line break) would split the GFM table row and
+        // break the whole table, so collapse intra-cell newlines to `<br>`.
+        const cellText = inlineTagsToMarkdown(n.tagged_text).replace(/\s*\n+\s*/g, '<br>').trim();
+        const parts = cellMap.get(tc.col_index) ?? [];
+        if (cellText)
+            parts.push(cellText);
+        cellMap.set(tc.col_index, parts);
+        if (tc.is_header_row)
+            headerRows.add(tc.row_index);
+    }
+    rowOrder.sort((a, b) => a - b);
+    if (rowOrder.length === 0)
+        return [];
+    const cellsFor = (rowIndex) => {
+        const cellMap = rows.get(rowIndex) ?? new Map();
+        const cells = [];
+        for (let c = 0; c < totalCols; c++) {
+            cells.push((cellMap.get(c) ?? []).join('<br>'));
+        }
+        return cells;
+    };
+    // GFM requires exactly one header row. Prefer the first row Word flagged as a header;
+    // otherwise treat the first row as the header (the common case).
+    const headerRowIndex = rowOrder.find((ri) => headerRows.has(ri)) ?? rowOrder[0];
+    const lines = [];
+    lines.push(`| ${cellsFor(headerRowIndex).join(' | ')} |`);
+    lines.push(`| ${Array.from({ length: totalCols }, () => '---').join(' | ')} |`);
+    for (const ri of rowOrder) {
+        if (ri === headerRowIndex)
+            continue;
+        lines.push(`| ${cellsFor(ri).join(' | ')} |`);
+    }
+    return lines;
+}
+/**
+ * Serialize a structured document view to GitHub-Flavored Markdown.
+ *
+ * @param nodes     Block nodes from `buildDocumentView({ showFormatting: true }).nodes`.
+ * @param footnotes Footnotes from `DocxDocument.getFootnotes()` (already sorted by
+ *                  `displayNumber`); appended as `[^n]: …` definitions.
+ */
+export function serializeToMarkdown(nodes, footnotes = [], _opts = {}) {
+    const blocks = [];
+    let inList = false;
+    const closeList = () => {
+        if (inList) {
+            blocks.push('');
+            inList = false;
+        }
+    };
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        // ── Tables: consume the whole run of same-table_id nodes at once ──
+        if (node.table_context) {
+            closeList();
+            const tableId = node.table_context.table_id;
+            const group = [];
+            while (i < nodes.length && nodes[i].table_context?.table_id === tableId) {
+                group.push(nodes[i]);
+                i++;
+            }
+            i--; // for-loop will re-increment
+            const tableLines = renderTable(group);
+            if (tableLines.length > 0) {
+                blocks.push(tableLines.join('\n'));
+                blocks.push('');
+            }
+            continue;
+        }
+        // ── Structural (Word-styled) headings ──
+        if (isStructuralHeading(node)) {
+            closeList();
+            const level = Math.min(6, Math.max(1, node.heading.level));
+            const text = inlineTagsToMarkdown(node.tagged_text).trim();
+            blocks.push(`${'#'.repeat(level)} ${text}`.trimEnd());
+            blocks.push('');
+            continue;
+        }
+        // ── List items ──
+        if (node.list_metadata.list_level >= 0) {
+            inList = true;
+            blocks.push(renderListItem(node));
+            continue;
+        }
+        // ── Normal paragraphs (heuristic headings land here: their run-in bold already lives
+        //     in the inline tags, so we keep them as paragraphs rather than inventing a `#`). ──
+        closeList();
+        const text = escapeLeadingBlockSyntax(inlineTagsToMarkdown(node.tagged_text));
+        if (text.trim() === '') {
+            blocks.push('');
+        }
+        else {
+            blocks.push(text);
+            blocks.push('');
+        }
+    }
+    closeList();
+    // ── Footnote definitions ──
+    const defs = footnotes.filter((fn) => fn.displayNumber > 0);
+    if (defs.length > 0) {
+        blocks.push('');
+        for (const fn of defs) {
+            const body = escapeInlineText(fn.text.replace(/\s+/g, ' ').trim());
+            blocks.push(`[^${fn.displayNumber}]: ${body}`);
+        }
+    }
+    return `${blocks.join('\n').replace(/\n{3,}/g, '\n\n').trim()}\n`;
+}
+//# sourceMappingURL=serialize_markdown.js.map

package/dist/primitives/serialize_markdown.js.map

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

package/dist/primitives/serialize_plaintext.d.ts

@@ -0,0 +1,15 @@
+import type { DocumentViewNode } from './document_view.js';
+import type { Footnote } from './footnotes.js';
+export interface SerializePlainTextOptions {
+    /** Reserved for future knobs (footnote policy, table layout). Currently unused. */
+    readonly _reserved?: never;
+}
+/**
+ * Serialize a structured document view to plain text.
+ *
+ * @param nodes     Block nodes from `buildDocumentView({ showFormatting: true }).nodes`.
+ * @param footnotes Footnotes from `DocxDocument.getFootnotes()` (already sorted by
+ *                  `displayNumber`); appended as `[^n] …` definitions.
+ */
+export declare function serializeToPlainText(nodes: DocumentViewNode[], footnotes?: Footnote[], _opts?: SerializePlainTextOptions): string;
+//# sourceMappingURL=serialize_plaintext.d.ts.map

package/dist/primitives/serialize_plaintext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize_plaintext.d.ts","sourceRoot":"","sources":["../../src/primitives/serialize_plaintext.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA2E/C,MAAM,WAAW,yBAAyB;IACxC,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EAAE,EACzB,SAAS,GAAE,QAAQ,EAAO,EAC1B,KAAK,GAAE,yBAA8B,GACpC,MAAM,CA4DR"}

package/dist/primitives/serialize_plaintext.js

@@ -0,0 +1,154 @@
+// DOCX → plain text serializer.
+//
+// The thinnest member of the export family. Like `serialize_markdown.ts`, this is a
+// *serializer over the existing structured document model* — it does no OOXML parsing.
+// `DocxDocument.buildDocumentView({ showFormatting: true })` already yields a
+// `DocumentViewNode[]` carrying headings, list metadata, grid-aware table context, injected
+// `[^n]` footnote markers, and an HTML-shaped inline-tag string (`tagged_text`). This module
+// turns that model into plain text with no markup.
+//
+// Where the Markdown emitter *maps* inline tags to Markdown syntax, the plain-text emitter
+// *strips* them (via `stripAllInlineTags`) and keeps only sensible block separators:
+//   - a blank line between block-level paragraphs (including headings),
+//   - simple `- ` list bullets (preserving literal legal labels like `Section 2.1`),
+//   - tab-separated table cells, one row per line,
+//   - injected `[^n]` footnote markers kept inline, definitions appended at the end.
+//
+// Plain text is intentionally *lossy*: all formatting (bold/italic/underline, highlight,
+// fonts, links, merged/nested table cells, layout) is discarded — that is the whole point of
+// a "just give me the text" rendering.
+import { stripAllInlineTags } from './semantic_tags.js';
+/** Convert one `tagged_text` value to plain text: strip all inline/semantic tags, keep text. */
+function toPlainInline(text) {
+    return stripAllInlineTags(text);
+}
+/**
+ * Render a list item as a simple bullet. Auto-numbered numeric items and unlabeled items get
+ * a bare `- ` bullet; items carrying a literal label (legal documents use meaningful labels
+ * like `Section 2.1`, `Article IV`, `(a)`, `(i)`) keep that label so it isn't silently lost.
+ * Indentation tracks the list level.
+ */
+function renderListItem(node) {
+    const lm = node.list_metadata;
+    const level = Math.max(0, lm.list_level);
+    const indent = '  '.repeat(level);
+    const text = toPlainInline(node.tagged_text).trim();
+    const label = lm.label_string?.trim() ?? '';
+    if (label) {
+        return `${indent}- ${label} ${text}`.trimEnd();
+    }
+    return `${indent}- ${text}`.trimEnd();
+}
+/**
+ * Render a run of nodes sharing a `table_context.table_id` as tab-separated rows.
+ *
+ * Lossy by design (plain text has no table model):
+ * - Horizontally merged cells (`gridSpan`) leave grid gaps; we fill them with empty fields so
+ *   every row keeps the same tab-delimited column count (a row `X<gap>Z` → `X\t\tZ`).
+ * - Vertically merged cells (`vMerge`) and nested tables are flattened into the body grid.
+ * - Multi-paragraph / multi-node cells and intra-cell line breaks are joined with a space
+ *   (a raw newline would split the tab-delimited row).
+ */
+function renderTable(group) {
+    let totalCols = 0;
+    for (const n of group) {
+        const tc = n.table_context;
+        if (!tc)
+            continue;
+        totalCols = Math.max(totalCols, tc.total_cols, tc.col_index + 1);
+    }
+    if (totalCols <= 0)
+        return [];
+    const rows = new Map();
+    const rowOrder = [];
+    for (const n of group) {
+        const tc = n.table_context;
+        if (!tc)
+            continue;
+        if (!rows.has(tc.row_index)) {
+            rows.set(tc.row_index, new Map());
+            rowOrder.push(tc.row_index);
+        }
+        const cellMap = rows.get(tc.row_index);
+        const cellText = toPlainInline(n.tagged_text).replace(/\s*\n+\s*/g, ' ').trim();
+        const parts = cellMap.get(tc.col_index) ?? [];
+        if (cellText)
+            parts.push(cellText);
+        cellMap.set(tc.col_index, parts);
+    }
+    rowOrder.sort((a, b) => a - b);
+    const lines = [];
+    for (const ri of rowOrder) {
+        const cellMap = rows.get(ri) ?? new Map();
+        const cells = [];
+        for (let c = 0; c < totalCols; c++) {
+            cells.push((cellMap.get(c) ?? []).join(' '));
+        }
+        lines.push(cells.join('\t'));
+    }
+    return lines;
+}
+/**
+ * Serialize a structured document view to plain text.
+ *
+ * @param nodes     Block nodes from `buildDocumentView({ showFormatting: true }).nodes`.
+ * @param footnotes Footnotes from `DocxDocument.getFootnotes()` (already sorted by
+ *                  `displayNumber`); appended as `[^n] …` definitions.
+ */
+export function serializeToPlainText(nodes, footnotes = [], _opts = {}) {
+    const blocks = [];
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        // ── Tables: consume the whole run of same-table_id nodes at once ──
+        if (node.table_context) {
+            const tableId = node.table_context.table_id;
+            const group = [];
+            while (i < nodes.length && nodes[i].table_context?.table_id === tableId) {
+                group.push(nodes[i]);
+                i++;
+            }
+            i--; // for-loop will re-increment
+            const tableLines = renderTable(group);
+            if (tableLines.length > 0) {
+                blocks.push(tableLines.join('\n'));
+                blocks.push('');
+            }
+            continue;
+        }
+        // ── List items: a bullet per item, no surrounding blank lines ──
+        if (node.list_metadata.list_level >= 0) {
+            blocks.push(renderListItem(node));
+            continue;
+        }
+        // ── Headings and normal paragraphs alike: plain text, blank line between blocks ──
+        // Plain text has no heading syntax, so a Word-styled heading is just its text.
+        const text = toPlainInline(node.tagged_text).trim();
+        if (text === '') {
+            blocks.push('');
+        }
+        else {
+            blocks.push(text);
+            blocks.push('');
+        }
+    }
+    // ── Footnote definitions ──
+    const defs = footnotes.filter((fn) => fn.displayNumber > 0);
+    if (defs.length > 0) {
+        blocks.push('');
+        for (const fn of defs) {
+            const body = fn.text.replace(/\s+/g, ' ').trim();
+            blocks.push(`[^${fn.displayNumber}] ${body}`.trimEnd());
+        }
+    }
+    // Trim only blank *lines* at the document boundary — not all whitespace. A plain `.trim()`
+    // would eat a leading/trailing tab that is a meaningful empty TSV field when the document
+    // starts or ends with a table whose boundary cell is empty (e.g. a row `\tZ`), breaking the
+    // "every row keeps the same column count" contract.
+    const rendered = blocks
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .replace(/^\n+/, '')
+        .replace(/\n+$/, '');
+    return `${rendered}\n`;
+}
+//# sourceMappingURL=serialize_plaintext.js.map

package/dist/primitives/serialize_plaintext.js.map

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

package/dist/primitives/styles.js

@@ -1,9 +1,9 @@
 import { OOXML, W } from './namespaces.js';
+import { getAttributeSafe, getFirstChild } from './xml-helpers.js';
 function getWAttr(el, localName) {
-    // Use || instead of ?? — getAttributeNS returns "" (not null) when the
-    // attribute exists without proper NS binding (e.g. set via setAttribute
-    // instead of setAttributeNS).
-    return el.getAttributeNS(OOXML.W_NS, localName) || el.getAttribute(`w:${localName}`) || el.getAttribute(localName) || null;
+    // Preserve legacy truthy fallback for empty strings from namespace-bound reads
+    // when attributes were written without a real namespace binding.
+    return getAttributeSafe(el, OOXML.W_NS, localName, 'w', { emptyIsMissing: true });
 }
 export function parseStylesXml(stylesDoc) {
     const byId = new Map();
@@ -14,10 +14,10 @@ export function parseStylesXml(stylesDoc) {
         const id = getWAttr(st, 'styleId');
         if (!id)
             continue;
-        const nameEl = st.getElementsByTagNameNS(OOXML.W_NS, W.name).item(0);
-        const basedOnEl = st.getElementsByTagNameNS(OOXML.W_NS, W.basedOn).item(0);
-        const pPr = st.getElementsByTagNameNS(OOXML.W_NS, W.pPr).item(0);
-        const rPr = st.getElementsByTagNameNS(OOXML.W_NS, W.rPr).item(0);
+        const nameEl = getFirstChild(st, OOXML.W_NS, W.name);
+        const basedOnEl = getFirstChild(st, OOXML.W_NS, W.basedOn);
+        const pPr = getFirstChild(st, OOXML.W_NS, W.pPr);
+        const rPr = getFirstChild(st, OOXML.W_NS, W.rPr);
         const name = nameEl ? (getWAttr(nameEl, 'val') ?? id) : id;
         const basedOn = basedOnEl ? (getWAttr(basedOnEl, 'val') ?? null) : null;
         byId.set(id, {
@@ -85,15 +85,15 @@ function firstNonNull(vals) {
     return null;
 }
 export function extractParagraphFormatting(pPr, styles) {
-    const pStyleEl = pPr ? pPr.getElementsByTagNameNS(OOXML.W_NS, W.pStyle).item(0) : null;
+    const pStyleEl = pPr ? getFirstChild(pPr, OOXML.W_NS, W.pStyle) : null;
     const styleId = pStyleEl ? (getWAttr(pStyleEl, 'val') ?? null) : null;
     const chain = resolveStyleChain(styles, styleId);
     const styleName = (styleId && styles.byId.get(styleId)?.name) || styleId || '';
     // Resolve alignment and indents: direct pPr overrides style chain.
-    const directJc = pPr ? pPr.getElementsByTagNameNS(OOXML.W_NS, W.jc).item(0) : null;
-    const directInd = pPr ? pPr.getElementsByTagNameNS(OOXML.W_NS, W.ind).item(0) : null;
-    const styleJc = firstNonNull(chain.map((s) => (s.pPr ? s.pPr.getElementsByTagNameNS(OOXML.W_NS, W.jc).item(0) : null)));
-    const styleInd = firstNonNull(chain.map((s) => (s.pPr ? s.pPr.getElementsByTagNameNS(OOXML.W_NS, W.ind).item(0) : null)));
+    const directJc = pPr ? getFirstChild(pPr, OOXML.W_NS, W.jc) : null;
+    const directInd = pPr ? getFirstChild(pPr, OOXML.W_NS, W.ind) : null;
+    const styleJc = firstNonNull(chain.map((s) => (s.pPr ? getFirstChild(s.pPr, OOXML.W_NS, W.jc) : null)));
+    const styleInd = firstNonNull(chain.map((s) => (s.pPr ? getFirstChild(s.pPr, OOXML.W_NS, W.ind) : null)));
     const alignment = parseAlignment(directJc ?? styleJc);
     const ind = parseIndentPt(directInd ?? styleInd);
     return {
@@ -107,7 +107,7 @@ export function extractParagraphFormatting(pPr, styles) {
 function parseBoolProp(parent, tagLocal) {
     if (!parent)
         return null;
-    const el = parent.getElementsByTagNameNS(OOXML.W_NS, tagLocal).item(0);
+    const el = getFirstChild(parent, OOXML.W_NS, tagLocal);
     if (!el)
         return null;
     // <w:b/> implies true. <w:b w:val="0"/> implies false.
@@ -119,7 +119,7 @@ function parseBoolProp(parent, tagLocal) {
 function parseUnderline(parent) {
     if (!parent)
         return null;
-    const el = parent.getElementsByTagNameNS(OOXML.W_NS, W.u).item(0);
+    const el = getFirstChild(parent, OOXML.W_NS, W.u);
     if (!el)
         return null;
     const v = getWAttr(el, 'val');
@@ -130,7 +130,7 @@ function parseUnderline(parent) {
 function parseFontName(parent) {
     if (!parent)
         return null;
-    const el = parent.getElementsByTagNameNS(OOXML.W_NS, W.rFonts).item(0);
+    const el = getFirstChild(parent, OOXML.W_NS, W.rFonts);
     if (!el)
         return null;
     return getWAttr(el, 'ascii') ?? getWAttr(el, 'hAnsi') ?? getWAttr(el, 'cs') ?? getWAttr(el, 'val') ?? null;
@@ -138,7 +138,7 @@ function parseFontName(parent) {
 function parseFontSizePt(parent) {
     if (!parent)
         return null;
-    const el = parent.getElementsByTagNameNS(OOXML.W_NS, W.sz).item(0);
+    const el = getFirstChild(parent, OOXML.W_NS, W.sz);
     if (!el)
         return null;
     const valStr = getWAttr(el, 'val') || el.getAttribute('val');
@@ -153,7 +153,7 @@ function parseFontSizePt(parent) {
 function parseColorHex(parent) {
     if (!parent)
         return null;
-    const el = parent.getElementsByTagNameNS(OOXML.W_NS, W.color).item(0);
+    const el = getFirstChild(parent, OOXML.W_NS, W.color);
     if (!el)
         return null;
     const v = getWAttr(el, 'val') || el.getAttribute('val');
@@ -164,7 +164,7 @@ function parseColorHex(parent) {
 function parseHighlightVal(parent) {
     if (!parent)
         return null;
-    const el = parent.getElementsByTagNameNS(OOXML.W_NS, W.highlight).item(0);
+    const el = getFirstChild(parent, OOXML.W_NS, W.highlight);
     if (!el)
         return null;
     const v = getWAttr(el, 'val');
@@ -175,10 +175,10 @@ function parseHighlightVal(parent) {
 export function extractEffectiveRunFormatting(params) {
     const { run, paragraphPPr, paragraphStyleId, styles } = params;
     const isRun = run.localName === W.r || run.localName === 'r';
-    const rPr = isRun ? run.getElementsByTagNameNS(OOXML.W_NS, W.rPr).item(0) : null;
-    const pRPr = paragraphPPr ? paragraphPPr.getElementsByTagNameNS(OOXML.W_NS, W.rPr).item(0) : null;
+    const rPr = isRun ? getFirstChild(run, OOXML.W_NS, W.rPr) : null;
+    const pRPr = paragraphPPr ? getFirstChild(paragraphPPr, OOXML.W_NS, W.rPr) : null;
     // Resolve w:rStyle character style chain (e.g. "Strong" → bold via style definition).
-    const rStyleEl = rPr?.getElementsByTagNameNS(OOXML.W_NS, W.rStyle).item(0);
+    const rStyleEl = rPr ? getFirstChild(rPr, OOXML.W_NS, W.rStyle) : null;
     const rStyleId = rStyleEl ? (getWAttr(rStyleEl, 'val') ?? null) : null;
     const rStyleChain = resolveStyleChain(styles, rStyleId);
     const rStyleRPr = firstNonNull(rStyleChain.map((s) => s.rPr));