@usejunior/docx-core 0.0.1 → 0.1.1

package/dist/primitives/text.js

@@ -0,0 +1,416 @@
+import { OOXML, W } from './namespaces.js';
+import { SafeDocxError } from './errors.js';
+export function getParagraphRuns(p) {
+    let FieldState;
+    (function (FieldState) {
+        FieldState[FieldState["OUTSIDE_FIELD"] = 0] = "OUTSIDE_FIELD";
+        FieldState[FieldState["IN_FIELD_CODE"] = 1] = "IN_FIELD_CODE";
+        FieldState[FieldState["IN_FIELD_RESULT"] = 2] = "IN_FIELD_RESULT";
+    })(FieldState || (FieldState = {}));
+    function getWAttr(el, localName) {
+        return el.getAttributeNS(OOXML.W_NS, localName) ?? el.getAttribute(`w:${localName}`) ?? el.getAttribute(localName);
+    }
+    const runs = [];
+    const rElems = Array.from(p.getElementsByTagNameNS(OOXML.W_NS, W.r));
+    let state = FieldState.OUTSIDE_FIELD;
+    for (const r of rElems) {
+        let runText = '';
+        let sawResult = state === FieldState.IN_FIELD_RESULT;
+        // Walk children in order so we can handle rare cases where fldChar and result text
+        // appear in the same run.
+        for (const child of Array.from(r.childNodes)) {
+            if (child.nodeType !== 1)
+                continue;
+            const el = child;
+            if (el.namespaceURI !== OOXML.W_NS)
+                continue;
+            if (el.localName === W.fldChar) {
+                const typ = getWAttr(el, 'fldCharType') ?? '';
+                if (typ === 'begin')
+                    state = FieldState.IN_FIELD_CODE;
+                else if (typ === 'separate')
+                    state = FieldState.IN_FIELD_RESULT;
+                else if (typ === 'end')
+                    state = FieldState.OUTSIDE_FIELD;
+                continue;
+            }
+            if (state === FieldState.IN_FIELD_CODE) {
+                // Skip field code/instruction text.
+                continue;
+            }
+            if (state === FieldState.IN_FIELD_RESULT)
+                sawResult = true;
+            if (el.localName === W.t) {
+                runText += el.textContent ?? '';
+            }
+            else if (el.localName === W.tab) {
+                runText += '\t';
+            }
+            else if (el.localName === W.br) {
+                runText += '\n';
+            }
+        }
+        if (runText)
+            runs.push({ r, text: runText, isFieldResult: sawResult });
+    }
+    return runs;
+}
+export function getParagraphText(p) {
+    return getParagraphRuns(p)
+        .map((tr) => tr.text)
+        .join('');
+}
+function findOffsetInRuns(runs, start, end) {
+    // Map [start, end) in concatenated string to run index + offset.
+    let pos = 0;
+    let startRunIdx = -1;
+    let endRunIdx = -1;
+    let startOffset = 0;
+    let endOffset = 0;
+    for (let i = 0; i < runs.length; i++) {
+        const len = runs[i].text.length;
+        if (startRunIdx === -1 && start >= pos && start <= pos + len) {
+            startRunIdx = i;
+            startOffset = start - pos;
+        }
+        if (endRunIdx === -1 && end >= pos && end <= pos + len) {
+            endRunIdx = i;
+            endOffset = end - pos;
+            break;
+        }
+        pos += len;
+    }
+    if (startRunIdx === -1 || endRunIdx === -1) {
+        throw new Error('Offset mapping failed');
+    }
+    return { startRunIdx, startOffset, endRunIdx, endOffset };
+}
+function isW(el, localName) {
+    return !!el && el.namespaceURI === OOXML.W_NS && el.localName === localName;
+}
+function setXmlSpacePreserveIfNeeded(t, text) {
+    // OOXML needs xml:space="preserve" when leading/trailing spaces exist.
+    if (!text)
+        return;
+    if (text.startsWith(' ') || text.endsWith(' ')) {
+        t.setAttributeNS('http://www.w3.org/XML/1998/namespace', 'xml:space', 'preserve');
+    }
+}
+function cloneRunFormattingOnly(doc, sourceRun) {
+    const r = doc.createElementNS(OOXML.W_NS, 'w:r');
+    // Copy rPr if present (direct child).
+    for (const child of Array.from(sourceRun.childNodes)) {
+        if (child.nodeType !== 1)
+            continue;
+        const el = child;
+        if (isW(el, W.rPr)) {
+            r.appendChild(el.cloneNode(true));
+            break;
+        }
+    }
+    return r;
+}
+function appendTextToRun(doc, run, text) {
+    // Convert \t and \n to OOXML equivalents where possible.
+    let buf = '';
+    const flush = () => {
+        if (!buf)
+            return;
+        const t = doc.createElementNS(OOXML.W_NS, 'w:t');
+        setXmlSpacePreserveIfNeeded(t, buf);
+        t.appendChild(doc.createTextNode(buf));
+        run.appendChild(t);
+        buf = '';
+    };
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === '\t') {
+            flush();
+            run.appendChild(doc.createElementNS(OOXML.W_NS, 'w:tab'));
+            continue;
+        }
+        if (ch === '\n') {
+            flush();
+            run.appendChild(doc.createElementNS(OOXML.W_NS, 'w:br'));
+            continue;
+        }
+        buf += ch;
+    }
+    flush();
+}
+export function visibleLengthForEl(el) {
+    if (el.namespaceURI !== OOXML.W_NS)
+        return 0;
+    if (el.localName === W.t)
+        return (el.textContent ?? '').length;
+    if (el.localName === W.tab)
+        return 1;
+    if (el.localName === W.br)
+        return 1;
+    return 0;
+}
+export function getDirectContentElements(run) {
+    // Direct children excluding rPr; preserves unknown nodes without duplicating them on splits.
+    const out = [];
+    for (const child of Array.from(run.childNodes)) {
+        if (child.nodeType !== 1)
+            continue;
+        const el = child;
+        if (el.namespaceURI !== OOXML.W_NS)
+            continue;
+        if (el.localName === W.rPr)
+            continue;
+        out.push(el);
+    }
+    return out;
+}
+export function splitRunAtVisibleOffset(run, offset) {
+    const doc = run.ownerDocument;
+    if (!doc)
+        throw new Error('Run has no ownerDocument');
+    const parent = run.parentNode;
+    if (!parent)
+        throw new Error('Run has no parent');
+    const right = run.cloneNode(true);
+    parent.insertBefore(right, run.nextSibling);
+    const leftContent = getDirectContentElements(run);
+    const rightContent = getDirectContentElements(right);
+    let pos = 0;
+    for (let i = 0; i < leftContent.length; i++) {
+        const lEl = leftContent[i];
+        const rEl = rightContent[i];
+        const len = visibleLengthForEl(lEl);
+        if (len === 0) {
+            // Zero-length nodes (proofing, field markers, etc.) should not be duplicated. Keep them on the side
+            // determined by the current visible position.
+            if (pos < offset)
+                rEl.parentNode?.removeChild(rEl);
+            else
+                lEl.parentNode?.removeChild(lEl);
+            continue;
+        }
+        const start = pos;
+        const end = pos + len;
+        if (offset <= start) {
+            // Entire element is to the right.
+            lEl.parentNode?.removeChild(lEl);
+            pos += len;
+            continue;
+        }
+        if (offset >= end) {
+            // Entire element is to the left.
+            rEl.parentNode?.removeChild(rEl);
+            pos += len;
+            continue;
+        }
+        // Split inside this element.
+        if (isW(lEl, W.t) && isW(rEl, W.t)) {
+            const full = lEl.textContent ?? '';
+            const leftText = full.slice(0, offset - start);
+            const rightText = full.slice(offset - start);
+            lEl.textContent = leftText;
+            rEl.textContent = rightText;
+            setXmlSpacePreserveIfNeeded(lEl, leftText);
+            setXmlSpacePreserveIfNeeded(rEl, rightText);
+            if (!leftText)
+                lEl.parentNode?.removeChild(lEl);
+            if (!rightText)
+                rEl.parentNode?.removeChild(rEl);
+        }
+        else {
+            // tab/br are length 1 and should not be split; move to the right by default.
+            lEl.parentNode?.removeChild(lEl);
+        }
+        pos += len;
+    }
+    return { left: run, right };
+}
+function cleanupEmptyRuns(parent) {
+    for (const child of Array.from(parent.childNodes)) {
+        if (child.nodeType !== 1)
+            continue;
+        const el = child;
+        if (!isW(el, W.r))
+            continue;
+        // Keep run if it has any non-rPr element children.
+        let hasContent = false;
+        for (const c of Array.from(el.childNodes)) {
+            if (c.nodeType !== 1)
+                continue;
+            const cEl = c;
+            if (!isW(cEl, W.rPr)) {
+                hasContent = true;
+                break;
+            }
+        }
+        if (!hasContent)
+            el.parentNode?.removeChild(el);
+    }
+}
+function getDirectChild(parent, localName) {
+    for (const child of Array.from(parent.childNodes)) {
+        if (child.nodeType !== 1)
+            continue;
+        const el = child;
+        if (isW(el, localName))
+            return el;
+    }
+    return null;
+}
+function ensureRPr(doc, run) {
+    const existing = getDirectChild(run, W.rPr);
+    if (existing)
+        return existing;
+    const rPr = doc.createElementNS(OOXML.W_NS, `w:${W.rPr}`);
+    run.insertBefore(rPr, run.firstChild);
+    return rPr;
+}
+function ensureBoolProp(doc, rPr, localName) {
+    let el = rPr.getElementsByTagNameNS(OOXML.W_NS, localName).item(0);
+    if (!el) {
+        el = doc.createElementNS(OOXML.W_NS, `w:${localName}`);
+        rPr.appendChild(el);
+    }
+    // Ensure truthy by removing any explicit false.
+    el.removeAttributeNS(OOXML.W_NS, 'val');
+    el.removeAttribute('w:val');
+    el.removeAttribute('val');
+}
+function ensureUnderline(doc, rPr, val) {
+    let el = rPr.getElementsByTagNameNS(OOXML.W_NS, W.u).item(0);
+    if (!el) {
+        el = doc.createElementNS(OOXML.W_NS, `w:${W.u}`);
+        rPr.appendChild(el);
+    }
+    const v = val ?? 'single';
+    el.setAttribute('w:val', v);
+}
+function clearHighlightProp(rPr) {
+    const hs = Array.from(rPr.getElementsByTagNameNS(OOXML.W_NS, W.highlight));
+    for (const h of hs)
+        h.parentNode?.removeChild(h);
+}
+function ensureHighlight(doc, rPr, val) {
+    let el = rPr.getElementsByTagNameNS(OOXML.W_NS, W.highlight).item(0);
+    if (!el) {
+        el = doc.createElementNS(OOXML.W_NS, `w:${W.highlight}`);
+        rPr.appendChild(el);
+    }
+    el.setAttribute('w:val', val ?? 'yellow');
+}
+function applyRunProps(doc, run, add, clearHighlight) {
+    if (!add && !clearHighlight)
+        return;
+    const rPr = ensureRPr(doc, run);
+    if (clearHighlight)
+        clearHighlightProp(rPr);
+    if (!add)
+        return;
+    if (add.bold)
+        ensureBoolProp(doc, rPr, W.b);
+    if (add.italic)
+        ensureBoolProp(doc, rPr, W.i);
+    if (add.underline)
+        ensureUnderline(doc, rPr, typeof add.underline === 'string' ? add.underline : null);
+    if (add.highlight)
+        ensureHighlight(doc, rPr, typeof add.highlight === 'string' ? add.highlight : null);
+}
+export function replaceParagraphTextRange(p, start, end, replacement) {
+    // Replace visible text in [start, end) in paragraph by operating on w:t nodes.
+    // Strategy:
+    // 1. Build concatenated visible text from visible runs (field-code aware).
+    // 2. Map offsets to run index + offset.
+    // 3. Split boundary runs so the replace range aligns to run boundaries.
+    // 4. Remove the runs in range and insert new run(s) that clone formatting from the
+    //    predominant run in the replaced span.
+    const doc = p.ownerDocument;
+    if (!doc)
+        throw new Error('Paragraph has no ownerDocument');
+    const runs = getParagraphRuns(p);
+    const fullText = runs.map((r) => r.text).join('');
+    if (start < 0 || end < start || end > fullText.length) {
+        throw new Error(`Invalid range [${start}, ${end}) for paragraph length ${fullText.length}`);
+    }
+    const { startRunIdx, startOffset, endRunIdx, endOffset } = findOffsetInRuns(runs, start, end);
+    const startRun = runs[startRunIdx];
+    const endRun = runs[endRunIdx];
+    // For now we only support field edits that stay within a single visible run.
+    if (startRunIdx !== endRunIdx) {
+        for (let i = startRunIdx; i <= endRunIdx; i++) {
+            if (runs[i]?.isFieldResult) {
+                throw new SafeDocxError('UNSUPPORTED_EDIT', 'Edit spans multiple runs and intersects a field result. This is currently unsupported in Safe-Docx TS.', 'Narrow old_string so the edit does not cross a field, or edit the field result text in a smaller span.');
+            }
+        }
+    }
+    // Pick a template run from the span: the run with the largest overlap by visible character count.
+    let templateRun = startRun.r;
+    let best = -1;
+    for (let i = startRunIdx; i <= endRunIdx; i++) {
+        const r = runs[i];
+        const runStart = i === startRunIdx ? startOffset : 0;
+        const runEnd = i === endRunIdx ? endOffset : r.text.length;
+        const overlap = Math.max(0, runEnd - runStart);
+        if (overlap > best) {
+            best = overlap;
+            templateRun = r.r;
+        }
+    }
+    const parts = typeof replacement === 'string' ? [{ text: replacement }] : replacement;
+    // Split boundary runs so we can remove whole runs cleanly.
+    let rangeStartRunEl = startRun.r;
+    let rangeEndRunEl = endRun.r;
+    if (startRunIdx === endRunIdx) {
+        // Single-run replacement: split end first, then start.
+        const runLen = startRun.text.length;
+        if (endOffset < runLen) {
+            const { left } = splitRunAtVisibleOffset(rangeStartRunEl, endOffset);
+            rangeStartRunEl = left;
+            rangeEndRunEl = left;
+        }
+        if (startOffset > 0) {
+            const { right } = splitRunAtVisibleOffset(rangeStartRunEl, startOffset);
+            rangeStartRunEl = right;
+            rangeEndRunEl = right;
+        }
+    }
+    else {
+        // Multi-run replacement: split start then end.
+        if (startOffset > 0) {
+            const { right } = splitRunAtVisibleOffset(rangeStartRunEl, startOffset);
+            rangeStartRunEl = right;
+        }
+        const endLen = endRun.text.length;
+        if (endOffset < endLen) {
+            const { left } = splitRunAtVisibleOffset(rangeEndRunEl, endOffset);
+            rangeEndRunEl = left;
+        }
+    }
+    const parent = rangeStartRunEl.parentNode;
+    if (!parent)
+        throw new Error('Run has no parent');
+    if (rangeEndRunEl.parentNode !== parent) {
+        throw new SafeDocxError('UNSAFE_CONTAINER_BOUNDARY', 'Edit crosses container boundaries (e.g. hyperlinks/SDTs).', 'Narrow old_string so the match is contained within a single container, or avoid editing inside hyperlinks.');
+    }
+    const insertBeforeNode = rangeEndRunEl.nextSibling;
+    // Remove runs in [rangeStartRunEl, rangeEndRunEl] inclusive (only w:r elements).
+    let cur = rangeStartRunEl;
+    while (cur) {
+        const nextNode = cur.nextSibling;
+        if (cur.nodeType === 1 && isW(cur, W.r)) {
+            cur.parentNode?.removeChild(cur);
+        }
+        if (cur === rangeEndRunEl)
+            break;
+        cur = nextNode;
+    }
+    // Insert replacement runs.
+    for (const part of parts) {
+        const tmpl = part.templateRun ?? templateRun;
+        const newRun = cloneRunFormattingOnly(doc, tmpl);
+        applyRunProps(doc, newRun, part.addRunProps, part.clearHighlight);
+        appendTextToRun(doc, newRun, part.text);
+        parent.insertBefore(newRun, insertBeforeNode);
+    }
+    cleanupEmptyRuns(parent);
+}
+//# sourceMappingURL=text.js.map

package/dist/primitives/text.js.map

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

package/dist/primitives/validate_document.d.ts

@@ -0,0 +1,24 @@
+/**
+ * validate_document — structural integrity checks for OOXML documents.
+ *
+ * Runs before download/pack to catch common issues that could produce
+ * corrupt or unexpected output. Returns warnings (non-blocking) that are
+ * surfaced in response metadata.
+ */
+export type ValidationWarning = {
+    code: string;
+    message: string;
+    /** Optional element context (e.g. bookmark name, paragraph index). */
+    context?: string;
+};
+export type ValidateDocumentResult = {
+    warnings: ValidationWarning[];
+    isValid: boolean;
+};
+/**
+ * Validate structural integrity of the document body.
+ * Returns warnings for issues that may cause problems during download/pack.
+ * All checks are non-destructive and read-only.
+ */
+export declare function validateDocument(doc: Document): ValidateDocumentResult;
+//# sourceMappingURL=validate_document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate_document.d.ts","sourceRoot":"","sources":["../../src/primitives/validate_document.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAyIF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,sBAAsB,CActE"}

package/dist/primitives/validate_document.js

@@ -0,0 +1,147 @@
+/**
+ * validate_document — structural integrity checks for OOXML documents.
+ *
+ * Runs before download/pack to catch common issues that could produce
+ * corrupt or unexpected output. Returns warnings (non-blocking) that are
+ * surfaced in response metadata.
+ */
+import { OOXML, W } from './namespaces.js';
+// ── Helpers ───────────────────────────────────────────────────────────
+function getWAttr(el, localName) {
+    return el.getAttributeNS(OOXML.W_NS, localName) ?? el.getAttribute(`w:${localName}`);
+}
+// ── Check: orphaned bookmarks ─────────────────────────────────────────
+function checkOrphanedBookmarks(body) {
+    const warnings = [];
+    const starts = new Map();
+    const ends = new Set();
+    const bookmarkStarts = body.getElementsByTagNameNS(OOXML.W_NS, W.bookmarkStart);
+    for (let i = 0; i < bookmarkStarts.length; i++) {
+        const el = bookmarkStarts.item(i);
+        const id = getWAttr(el, 'id');
+        if (id)
+            starts.set(id, el);
+    }
+    const bookmarkEnds = body.getElementsByTagNameNS(OOXML.W_NS, W.bookmarkEnd);
+    for (let i = 0; i < bookmarkEnds.length; i++) {
+        const el = bookmarkEnds.item(i);
+        const id = getWAttr(el, 'id');
+        if (id)
+            ends.add(id);
+    }
+    // bookmarkStart without matching bookmarkEnd
+    for (const [id, el] of starts) {
+        if (!ends.has(id)) {
+            const name = getWAttr(el, 'name') ?? '(unnamed)';
+            warnings.push({
+                code: 'ORPHANED_BOOKMARK_START',
+                message: `bookmarkStart id="${id}" name="${name}" has no matching bookmarkEnd`,
+                context: `name=${name}`,
+            });
+        }
+    }
+    // bookmarkEnd without matching bookmarkStart
+    for (const id of ends) {
+        if (!starts.has(id)) {
+            warnings.push({
+                code: 'ORPHANED_BOOKMARK_END',
+                message: `bookmarkEnd id="${id}" has no matching bookmarkStart`,
+                context: `id=${id}`,
+            });
+        }
+    }
+    return warnings;
+}
+// ── Check: malformed tracked-change wrappers ──────────────────────────
+const TC_LOCALS = ['ins', 'del', 'moveFrom', 'moveTo'];
+const REQUIRED_TC_ATTRS = ['id', 'author', 'date'];
+function checkTrackedChangeWrappers(body) {
+    const warnings = [];
+    for (const local of TC_LOCALS) {
+        const elements = body.getElementsByTagNameNS(OOXML.W_NS, local);
+        for (let i = 0; i < elements.length; i++) {
+            const el = elements.item(i);
+            for (const attr of REQUIRED_TC_ATTRS) {
+                const val = getWAttr(el, attr);
+                if (!val) {
+                    warnings.push({
+                        code: 'MALFORMED_TRACKED_CHANGE',
+                        message: `<w:${local}> missing required attribute w:${attr}`,
+                        context: `element=w:${local}, missing=w:${attr}`,
+                    });
+                }
+            }
+            // Check for empty tracked-change wrappers (no child elements)
+            let hasChildElement = false;
+            let c = el.firstChild;
+            while (c) {
+                if (c.nodeType === 1) {
+                    hasChildElement = true;
+                    break;
+                }
+                c = c.nextSibling;
+            }
+            if (!hasChildElement) {
+                const tcId = getWAttr(el, 'id') ?? '?';
+                warnings.push({
+                    code: 'EMPTY_TRACKED_CHANGE',
+                    message: `<w:${local} w:id="${tcId}"> has no child elements`,
+                    context: `element=w:${local}, id=${tcId}`,
+                });
+            }
+        }
+    }
+    return warnings;
+}
+// ── Check: mismatched field markers ───────────────────────────────────
+function checkFieldMarkers(body) {
+    const warnings = [];
+    // Collect all fldChar elements in document order
+    const fldChars = body.getElementsByTagNameNS(OOXML.W_NS, W.fldChar);
+    let depth = 0;
+    for (let i = 0; i < fldChars.length; i++) {
+        const el = fldChars.item(i);
+        const fldCharType = getWAttr(el, 'fldCharType');
+        if (fldCharType === 'begin') {
+            depth++;
+        }
+        else if (fldCharType === 'end') {
+            depth--;
+            if (depth < 0) {
+                warnings.push({
+                    code: 'UNMATCHED_FIELD_END',
+                    message: 'fldChar type="end" without matching type="begin"',
+                });
+                depth = 0;
+            }
+        }
+    }
+    if (depth > 0) {
+        warnings.push({
+            code: 'UNMATCHED_FIELD_BEGIN',
+            message: `${depth} fldChar type="begin" without matching type="end"`,
+        });
+    }
+    return warnings;
+}
+// ── Public API ────────────────────────────────────────────────────────
+/**
+ * Validate structural integrity of the document body.
+ * Returns warnings for issues that may cause problems during download/pack.
+ * All checks are non-destructive and read-only.
+ */
+export function validateDocument(doc) {
+    const body = doc.getElementsByTagNameNS(OOXML.W_NS, W.body).item(0);
+    if (!body)
+        return { warnings: [], isValid: true };
+    const warnings = [
+        ...checkOrphanedBookmarks(body),
+        ...checkTrackedChangeWrappers(body),
+        ...checkFieldMarkers(body),
+    ];
+    return {
+        warnings,
+        isValid: warnings.length === 0,
+    };
+}
+//# sourceMappingURL=validate_document.js.map

package/dist/primitives/validate_document.js.map

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

package/dist/primitives/xml.d.ts

@@ -0,0 +1,5 @@
+export type XmlDoc = Document;
+export declare function parseXml(xml: string): XmlDoc;
+export declare function serializeXml(doc: XmlDoc): string;
+export declare function textContent(node: Node | null | undefined): string;
+//# sourceMappingURL=xml.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/primitives/xml.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC;AAE9B,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAW5C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEjE"}

package/dist/primitives/xml.js

@@ -0,0 +1,19 @@
+import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
+export function parseXml(xml) {
+    // application/xml ensures XML parsing rules (vs HTML-ish parsing).
+    const doc = new DOMParser().parseFromString(xml, 'application/xml');
+    // xmldom uses a <parsererror> element for some failures; keep a minimal check.
+    const parseErrors = doc.getElementsByTagName('parsererror');
+    if (parseErrors && parseErrors.length > 0) {
+        const msg = parseErrors[0]?.textContent?.trim() || 'XML parse error';
+        throw new Error(msg);
+    }
+    return doc;
+}
+export function serializeXml(doc) {
+    return new XMLSerializer().serializeToString(doc);
+}
+export function textContent(node) {
+    return node?.textContent ?? '';
+}
+//# sourceMappingURL=xml.js.map

package/dist/primitives/xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.js","sourceRoot":"","sources":["../../src/primitives/xml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI1D,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,mEAAmE;IACnE,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAEpE,+EAA+E;IAC/E,MAAM,WAAW,GAAG,GAAG,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAC5D,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,iBAAiB,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,IAAI,aAAa,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAA6B;IACvD,OAAO,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC;AACjC,CAAC"}