@usejunior/docx-core 0.9.1 → 0.11.0

package/dist/primitives/validate_ai_revisions.js

@@ -0,0 +1,323 @@
+import path from 'node:path';
+import { parseXml, serializeXml } from './xml.js';
+import { OOXML } from './namespaces.js';
+import { REVISION_SIDE_PART_PATHS, REVISION_STORY_PART_PATHS, } from './revision-parts.js';
+import { REVISION_RANGE_ELEMENT_NAMES, TRACKED_CHANGE_ELEMENT_NAMES, } from './revision-vocabulary.js';
+import { collectFieldStructureIssues, } from '../shared/field-structure.js';
+const W_NS = OOXML.W_NS;
+const REL_NS = OOXML.REL_NS;
+const CT_NS = OOXML.CT_NS;
+const FULL_REVISION_ATTRS = ['id', 'author', 'date'];
+const ID_ONLY_REVISION_ATTRS = ['id'];
+/**
+ * Range-end milestones (OOXML CT_MarkupRange / CT_Markup) carry only w:id —
+ * unlike their *RangeStart counterparts (OOXML CT_TrackChange / CT_Bookmark),
+ * they have no w:author or w:date attribute.
+ */
+const ID_ONLY_REVISION_ELEMENT_NAMES = new Set(REVISION_RANGE_ELEMENT_NAMES.filter((name) => name.endsWith('RangeEnd')));
+const RANGE_PAIRS = [
+    { start: 'moveFromRangeStart', end: 'moveFromRangeEnd' },
+    { start: 'moveToRangeStart', end: 'moveToRangeEnd' },
+    { start: 'commentRangeStart', end: 'commentRangeEnd' },
+    { start: 'permStart', end: 'permEnd' },
+    { start: 'customXmlInsRangeStart', end: 'customXmlInsRangeEnd' },
+    { start: 'customXmlDelRangeStart', end: 'customXmlDelRangeEnd' },
+    { start: 'customXmlMoveFromRangeStart', end: 'customXmlMoveFromRangeEnd' },
+    { start: 'customXmlMoveToRangeStart', end: 'customXmlMoveToRangeEnd' },
+    { start: 'bookmarkStart', end: 'bookmarkEnd' },
+];
+const TRACKED_CHANGE_PLACEMENTS = {
+    cellIns: ['tcPr'],
+    cellDel: ['tcPr'],
+    cellMerge: ['tcPr'],
+    tblGridChange: ['tblGrid'],
+    sectPrChange: ['sectPr'],
+    numberingChange: ['pPr', 'rPr'],
+};
+function toStringSet(values) {
+    const set = new Set();
+    if (!values)
+        return set;
+    for (const value of values)
+        set.add(String(value));
+    return set;
+}
+function getWAttr(el, localName) {
+    return el.getAttributeNS(W_NS, localName) ?? el.getAttribute(`w:${localName}`) ?? el.getAttribute(localName);
+}
+function allW(doc, localName) {
+    return Array.from(doc.getElementsByTagNameNS(W_NS, localName));
+}
+function parentLocalName(el) {
+    let node = el.parentNode;
+    while (node) {
+        if (node.nodeType === 1)
+            return node.localName;
+        node = node.parentNode;
+    }
+    return null;
+}
+function classifyRevision(el, aiAuthor, touchedRevisionIds) {
+    const author = getWAttr(el, 'author');
+    const id = getWAttr(el, 'id');
+    const isAi = author === aiAuthor || (id !== null && touchedRevisionIds.has(id));
+    return { severity: isAi ? 'error' : 'warning', author, id };
+}
+function push(out, diagnostic) {
+    out.push(diagnostic);
+}
+function isIntegerString(value) {
+    return value !== null && /^(?:0|[1-9]\d*)$/.test(value);
+}
+/**
+ * OOXML ST_DateTime is xsd:dateTime — full date-time with optional fractional
+ * seconds and timezone. Date.parse alone is too lax (it accepts "2026" and
+ * RFC 1123 dates, which Word rejects).
+ */
+const XSD_DATETIME_PATTERN = /^-?\d{4,}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})?$/;
+function isValidDate(value) {
+    if (!value)
+        return false;
+    return XSD_DATETIME_PATTERN.test(value) && Number.isFinite(Date.parse(value));
+}
+function checkRevisionMetadata(story, aiAuthor, touchedRevisionIds, diagnostics, aiIds) {
+    const names = [...TRACKED_CHANGE_ELEMENT_NAMES, ...REVISION_RANGE_ELEMENT_NAMES];
+    for (const localName of names) {
+        const idOnly = ID_ONLY_REVISION_ELEMENT_NAMES.has(localName);
+        const requiredAttrs = idOnly ? ID_ONLY_REVISION_ATTRS : FULL_REVISION_ATTRS;
+        for (const el of allW(story.doc, localName)) {
+            const classified = classifyRevision(el, aiAuthor, touchedRevisionIds);
+            for (const attr of requiredAttrs) {
+                const value = getWAttr(el, attr);
+                if (!value) {
+                    push(diagnostics, {
+                        severity: classified.severity,
+                        code: 'REVISION_METADATA_MISSING',
+                        message: `<w:${localName}> missing required w:${attr}`,
+                        part: story.part,
+                        element: `w:${localName}`,
+                        id: classified.id ?? undefined,
+                        author: classified.author,
+                    });
+                }
+            }
+            const id = getWAttr(el, 'id');
+            if (!isIntegerString(id)) {
+                push(diagnostics, {
+                    severity: classified.severity,
+                    code: 'REVISION_ID_INVALID',
+                    message: `<w:${localName}> has non-integer w:id`,
+                    part: story.part,
+                    element: `w:${localName}`,
+                    id: id ?? undefined,
+                    author: classified.author,
+                });
+            }
+            const date = getWAttr(el, 'date');
+            if (!idOnly && !isValidDate(date)) {
+                push(diagnostics, {
+                    severity: classified.severity,
+                    code: 'REVISION_DATE_INVALID',
+                    message: `<w:${localName}> has invalid w:date`,
+                    part: story.part,
+                    element: `w:${localName}`,
+                    id: id ?? undefined,
+                    author: classified.author,
+                });
+            }
+            if (classified.severity === 'error' && id) {
+                const previousPart = aiIds.get(id);
+                if (previousPart && previousPart !== story.part) {
+                    push(diagnostics, {
+                        severity: 'error',
+                        code: 'AI_REVISION_ID_DUPLICATE',
+                        message: `AI revision w:id="${id}" appears in both ${previousPart} and ${story.part}`,
+                        part: story.part,
+                        element: `w:${localName}`,
+                        id,
+                        author: classified.author,
+                    });
+                }
+                else {
+                    aiIds.set(id, story.part);
+                }
+            }
+        }
+    }
+}
+function checkRangePairs(story, aiAuthor, touchedRangeIds, diagnostics) {
+    const collect = (localName, into) => {
+        for (const el of allW(story.doc, localName)) {
+            const id = getWAttr(el, 'id');
+            if (!id || !isIntegerString(id)) {
+                const author = getWAttr(el, 'author');
+                push(diagnostics, {
+                    severity: author === aiAuthor || (id !== null && touchedRangeIds.has(id)) ? 'error' : 'warning',
+                    code: id === null ? 'RANGE_MARKER_ID_MISSING' : 'RANGE_MARKER_ID_INVALID',
+                    message: id === null
+                        ? `<w:${localName}> missing required w:id`
+                        : `<w:${localName}> has non-integer w:id`,
+                    part: story.part,
+                    element: `w:${localName}`,
+                    id: id ?? undefined,
+                    author,
+                });
+            }
+            if (!id)
+                continue;
+            const list = into.get(id) ?? [];
+            list.push(el);
+            into.set(id, list);
+        }
+    };
+    for (const pair of RANGE_PAIRS) {
+        const starts = new Map();
+        const ends = new Map();
+        collect(pair.start, starts);
+        collect(pair.end, ends);
+        const ids = new Set([...starts.keys(), ...ends.keys()]);
+        for (const id of ids) {
+            const startCount = starts.get(id)?.length ?? 0;
+            const endCount = ends.get(id)?.length ?? 0;
+            if (startCount === endCount)
+                continue;
+            const representative = starts.get(id)?.[0] ?? ends.get(id)?.[0];
+            const author = representative ? getWAttr(representative, 'author') : null;
+            const severity = author === aiAuthor || touchedRangeIds.has(id) ? 'error' : 'warning';
+            push(diagnostics, {
+                severity,
+                code: 'RANGE_PAIR_UNBALANCED',
+                message: `<w:${pair.start}>/<w:${pair.end}> pair id="${id}" is unbalanced`,
+                part: story.part,
+                element: `w:${pair.start}`,
+                id,
+                author,
+            });
+        }
+    }
+}
+function checkFieldStructure(story, diagnostics) {
+    const fieldStory = { label: story.part, xml: serializeXml(story.doc) };
+    for (const issue of collectFieldStructureIssues([fieldStory])) {
+        push(diagnostics, {
+            severity: 'error',
+            code: issue.code,
+            message: issue.message,
+            part: story.part,
+            element: issue.element,
+        });
+    }
+}
+function checkPlacement(story, aiAuthor, touchedRevisionIds, diagnostics) {
+    for (const [localName, allowedParents] of Object.entries(TRACKED_CHANGE_PLACEMENTS)) {
+        for (const el of allW(story.doc, localName)) {
+            const parent = parentLocalName(el);
+            if (parent && allowedParents.includes(parent))
+                continue;
+            const classified = classifyRevision(el, aiAuthor, touchedRevisionIds);
+            push(diagnostics, {
+                severity: classified.severity,
+                code: 'REVISION_PLACEMENT_INVALID',
+                message: `<w:${localName}> must appear under ${allowedParents.map((x) => `w:${x}`).join(' or ')}`,
+                part: story.part,
+                element: `w:${localName}`,
+                id: classified.id ?? undefined,
+                author: classified.author,
+            });
+        }
+    }
+}
+function relsSourceBase(relsPath) {
+    if (relsPath === '_rels/.rels')
+        return '';
+    const marker = '/_rels/';
+    const idx = relsPath.indexOf(marker);
+    if (idx < 0)
+        return path.posix.dirname(relsPath);
+    return relsPath.slice(0, idx);
+}
+function resolveRelationshipTarget(relsPath, target) {
+    const base = relsSourceBase(relsPath);
+    return path.posix.normalize(path.posix.join(base, target)).replace(/^\.\//, '');
+}
+async function checkPackageInvariants(zip, touchedRelationshipParts, touchedSideParts, diagnostics) {
+    for (const fileName of zip.listFiles()) {
+        if (!fileName.endsWith('.rels'))
+            continue;
+        if (touchedRelationshipParts.size > 0 && !touchedRelationshipParts.has(fileName))
+            continue;
+        const relsXml = await zip.readTextOrNull(fileName);
+        if (!relsXml)
+            continue;
+        const relsDoc = parseXml(relsXml);
+        for (const rel of Array.from(relsDoc.getElementsByTagNameNS(REL_NS, 'Relationship'))) {
+            const target = rel.getAttribute('Target');
+            if (!target)
+                continue;
+            if (rel.getAttribute('TargetMode') === 'External')
+                continue;
+            const resolved = resolveRelationshipTarget(fileName, target);
+            if (!zip.hasFile(resolved)) {
+                push(diagnostics, {
+                    severity: touchedRelationshipParts.has(fileName) ? 'error' : 'warning',
+                    code: 'RELATIONSHIP_TARGET_MISSING',
+                    message: `Relationship target '${target}' resolves to missing package part '${resolved}'`,
+                    part: fileName,
+                });
+            }
+        }
+    }
+    const sidePartsToCheck = touchedSideParts.size > 0
+        ? [...touchedSideParts]
+        : REVISION_SIDE_PART_PATHS.filter((part) => zip.hasFile(part));
+    if (sidePartsToCheck.length === 0)
+        return;
+    const contentTypesXml = await zip.readTextOrNull('[Content_Types].xml');
+    const overrides = new Set();
+    if (contentTypesXml) {
+        const ctDoc = parseXml(contentTypesXml);
+        for (const override of Array.from(ctDoc.getElementsByTagNameNS(CT_NS, 'Override'))) {
+            const partName = override.getAttribute('PartName');
+            if (partName)
+                overrides.add(partName.replace(/^\//, ''));
+        }
+    }
+    for (const part of sidePartsToCheck) {
+        if (!zip.hasFile(part))
+            continue;
+        if (!overrides.has(part)) {
+            push(diagnostics, {
+                severity: touchedSideParts.has(part) ? 'error' : 'warning',
+                code: 'SIDE_PART_CONTENT_TYPE_MISSING',
+                message: `Created side part '${part}' is missing a [Content_Types].xml Override`,
+                part,
+            });
+        }
+    }
+}
+export async function validateAiRevisions(options) {
+    const touchedRevisionIds = toStringSet(options.touched?.revisionIds);
+    const touchedRangeIds = toStringSet(options.touched?.rangeIds);
+    const touchedRelationshipParts = toStringSet(options.touched?.relationshipParts);
+    const touchedSideParts = toStringSet(options.touched?.sideParts);
+    const diagnostics = [];
+    const aiIds = new Map();
+    for (const story of options.stories) {
+        checkRevisionMetadata(story, options.aiAuthor, touchedRevisionIds, diagnostics, aiIds);
+        checkRangePairs(story, options.aiAuthor, touchedRangeIds, diagnostics);
+        checkFieldStructure(story, diagnostics);
+        checkPlacement(story, options.aiAuthor, touchedRevisionIds, diagnostics);
+    }
+    if (options.packageZip) {
+        await checkPackageInvariants(options.packageZip, touchedRelationshipParts, touchedSideParts, diagnostics);
+    }
+    const errors = diagnostics.filter((d) => d.severity === 'error');
+    const warnings = diagnostics.filter((d) => d.severity === 'warning');
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+export const AI_REVISION_VALIDATION_STORY_PARTS = REVISION_STORY_PART_PATHS;
+//# sourceMappingURL=validate_ai_revisions.js.map

package/dist/primitives/validate_ai_revisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate_ai_revisions.js","sourceRoot":"","sources":["../../src/primitives/validate_ai_revisions.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,2BAA2B,GAE5B,MAAM,8BAA8B,CAAC;AAuCtC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;AACxB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;AAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;AAC1B,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAC9D,MAAM,sBAAsB,GAAG,CAAC,IAAI,CAAU,CAAC;AAE/C;;;;GAIG;AACH,MAAM,8BAA8B,GAAG,IAAI,GAAG,CAC5C,4BAA4B,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CACzE,CAAC;AAEF,MAAM,WAAW,GAA0C;IACzD,EAAE,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,kBAAkB,EAAE;IACxD,EAAE,KAAK,EAAE,kBAAkB,EAAE,GAAG,EAAE,gBAAgB,EAAE;IACpD,EAAE,KAAK,EAAE,mBAAmB,EAAE,GAAG,EAAE,iBAAiB,EAAE;IACtD,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE;IACtC,EAAE,KAAK,EAAE,wBAAwB,EAAE,GAAG,EAAE,sBAAsB,EAAE;IAChE,EAAE,KAAK,EAAE,wBAAwB,EAAE,GAAG,EAAE,sBAAsB,EAAE;IAChE,EAAE,KAAK,EAAE,6BAA6B,EAAE,GAAG,EAAE,2BAA2B,EAAE;IAC1E,EAAE,KAAK,EAAE,2BAA2B,EAAE,GAAG,EAAE,yBAAyB,EAAE;IACtE,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,aAAa,EAAE;CAC/C,CAAC;AAEF,MAAM,yBAAyB,GAAsC;IACnE,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,SAAS,EAAE,CAAC,MAAM,CAAC;IACnB,aAAa,EAAE,CAAC,SAAS,CAAC;IAC1B,YAAY,EAAE,CAAC,QAAQ,CAAC;IACxB,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;CAChC,CAAC;AAEF,SAAS,WAAW,CAAC,MAA6C;IAChE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC;IACxB,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,EAAW,EAAE,SAAiB;IAC9C,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,KAAK,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;AAC/G,CAAC;AAED,SAAS,IAAI,CAAC,GAAuB,EAAE,SAAiB;IACtD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAc,CAAC;AAC9E,CAAC;AAED,SAAS,eAAe,CAAC,EAAW;IAClC,IAAI,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC;IACzB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAQ,IAAgB,CAAC,SAAS,CAAC;QAC5D,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CACvB,EAAW,EACX,QAAgB,EAChB,kBAA+B;IAE/B,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,KAAK,QAAQ,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAChF,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,IAAI,CACX,GAA2B,EAC3B,UAAqF;IAErF,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,eAAe,CAAC,KAAoB;IAC3C,OAAO,KAAK,KAAK,IAAI,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,0EAA0E,CAAC;AAExG,SAAS,WAAW,CAAC,KAAoB;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAA2B,EAC3B,QAAgB,EAChB,kBAA+B,EAC/B,WAAmC,EACnC,KAA0B;IAE1B,MAAM,KAAK,GAAG,CAAC,GAAG,4BAA4B,EAAE,GAAG,4BAA4B,CAAC,CAAC;IACjF,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,8BAA8B,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,mBAAmB,CAAC;QAC5E,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;YAC5C,MAAM,UAAU,GAAG,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;YACtE,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gBACjC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,IAAI,CAAC,WAAW,EAAE;wBAChB,QAAQ,EAAE,UAAU,CAAC,QAAQ;wBAC7B,IAAI,EAAE,2BAA2B;wBACjC,OAAO,EAAE,MAAM,SAAS,wBAAwB,IAAI,EAAE;wBACtD,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,OAAO,EAAE,KAAK,SAAS,EAAE;wBACzB,EAAE,EAAE,UAAU,CAAC,EAAE,IAAI,SAAS;wBAC9B,MAAM,EAAE,UAAU,CAAC,MAAM;qBAC1B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,WAAW,EAAE;oBAChB,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,IAAI,EAAE,qBAAqB;oBAC3B,OAAO,EAAE,MAAM,SAAS,wBAAwB;oBAChD,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,SAAS,EAAE;oBACzB,EAAE,EAAE,EAAE,IAAI,SAAS;oBACnB,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;YACL,CAAC;YAED,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,WAAW,EAAE;oBAChB,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,IAAI,EAAE,uBAAuB;oBAC7B,OAAO,EAAE,MAAM,SAAS,sBAAsB;oBAC9C,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,SAAS,EAAE;oBACzB,EAAE,EAAE,EAAE,IAAI,SAAS;oBACnB,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;YACL,CAAC;YAED,IAAI,UAAU,CAAC,QAAQ,KAAK,OAAO,IAAI,EAAE,EAAE,CAAC;gBAC1C,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnC,IAAI,YAAY,IAAI,YAAY,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;oBAChD,IAAI,CAAC,WAAW,EAAE;wBAChB,QAAQ,EAAE,OAAO;wBACjB,IAAI,EAAE,0BAA0B;wBAChC,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,YAAY,QAAQ,KAAK,CAAC,IAAI,EAAE;wBACrF,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,OAAO,EAAE,KAAK,SAAS,EAAE;wBACzB,EAAE;wBACF,MAAM,EAAE,UAAU,CAAC,MAAM;qBAC1B,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,KAA2B,EAC3B,QAAgB,EAChB,eAA4B,EAC5B,WAAmC;IAEnC,MAAM,OAAO,GAAG,CACd,SAAiB,EACjB,IAA4B,EACtB,EAAE;QACR,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;YAC5C,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC9B,IAAI,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,CAAC;gBAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;gBACtC,IAAI,CAAC,WAAW,EAAE;oBAChB,QAAQ,EAAE,MAAM,KAAK,QAAQ,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;oBAC/F,IAAI,EAAE,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,yBAAyB;oBACzE,OAAO,EAAE,EAAE,KAAK,IAAI;wBAClB,CAAC,CAAC,MAAM,SAAS,yBAAyB;wBAC1C,CAAC,CAAC,MAAM,SAAS,wBAAwB;oBAC3C,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,SAAS,EAAE;oBACzB,EAAE,EAAE,EAAE,IAAI,SAAS;oBACnB,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,EAAE;gBAAE,SAAS;YAClB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACd,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAExB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACxD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;YAC3C,IAAI,UAAU,KAAK,QAAQ;gBAAE,SAAS;YACtC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1E,MAAM,QAAQ,GACZ,MAAM,KAAK,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YACvE,IAAI,CAAC,WAAW,EAAE;gBAChB,QAAQ;gBACR,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,MAAM,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,cAAc,EAAE,iBAAiB;gBAC1E,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE;gBAC1B,EAAE;gBACF,MAAM;aACP,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAA2B,EAC3B,WAAmC;IAEnC,MAAM,UAAU,GAAe,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACnF,KAAK,MAAM,KAAK,IAAI,2BAA2B,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,WAAW,EAAE;YAChB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,KAA2B,EAC3B,QAAgB,EAChB,kBAA+B,EAC/B,WAAmC;IAEnC,KAAK,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,EAAE,CAAC;QACpF,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,MAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,SAAS;YACxD,MAAM,UAAU,GAAG,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;YACtE,IAAI,CAAC,WAAW,EAAE;gBAChB,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,IAAI,EAAE,4BAA4B;gBAClC,OAAO,EAAE,MAAM,SAAS,uBAAuB,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;gBACjG,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,SAAS,EAAE;gBACzB,EAAE,EAAE,UAAU,CAAC,EAAE,IAAI,SAAS;gBAC9B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,QAAQ,KAAK,aAAa;QAAE,OAAO,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAgB,EAAE,MAAc;IACjE,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,GAAY,EACZ,wBAAqC,EACrC,gBAA6B,EAC7B,WAAmC;IAEnC,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAS;QAC1C,IAAI,wBAAwB,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS;QAC3F,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAc,EAAE,CAAC;YAClG,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,IAAI,GAAG,CAAC,YAAY,CAAC,YAAY,CAAC,KAAK,UAAU;gBAAE,SAAS;YAC5D,MAAM,QAAQ,GAAG,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC7D,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,WAAW,EAAE;oBAChB,QAAQ,EAAE,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;oBACtE,IAAI,EAAE,6BAA6B;oBACnC,OAAO,EAAE,wBAAwB,MAAM,uCAAuC,QAAQ,GAAG;oBACzF,IAAI,EAAE,QAAQ;iBACf,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,IAAI,GAAG,CAAC;QAChD,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC;QACvB,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE1C,MAAM,eAAe,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;QACxC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAc,EAAE,CAAC;YAChG,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YACnD,IAAI,QAAQ;gBAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,SAAS;QACjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,WAAW,EAAE;gBAChB,QAAQ,EAAE,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBAC1D,IAAI,EAAE,gCAAgC;gBACtC,OAAO,EAAE,sBAAsB,IAAI,6CAA6C;gBAChF,IAAI;aACL,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAmC;IAEnC,MAAM,kBAAkB,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACrE,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,wBAAwB,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACjF,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACjE,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;QACvF,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;QACvE,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACxC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,kBAAkB,EAAE,WAAW,CAAC,CAAC;IAE3E,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,sBAAsB,CAC1B,OAAO,CAAC,UAAU,EAClB,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,CACZ,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IACrE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,kCAAkC,GAAG,yBAAyB,CAAC"}

package/dist/primitives/xml-helpers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Defensive XML access helpers for OOXML-style DOMs.
+ *
+ * DOCX parts in the wild may mix namespace-bound attributes/elements with
+ * prefixed or bare names. These helpers centralize the fallback order without
+ * changing each caller's null handling.
+ */
+export type AttributeSafeOptions = {
+    /**
+     * Treat empty strings as missing and continue through fallbacks.
+     * Leave false for the canonical DOM getAttributeNS/getAttribute semantics.
+     */
+    emptyIsMissing?: boolean;
+    /** Include a final bare local-name lookup after namespace/prefix fallbacks. */
+    bareFallback?: boolean;
+};
+/**
+ * Read an attribute by namespace, then optional prefix, then bare local name.
+ */
+export declare function getAttributeSafe(el: Element, ns: string, localName: string, prefix?: string, options?: AttributeSafeOptions): string | null;
+/**
+ * Return the first descendant element matching namespace/local-name, or null.
+ */
+export declare function getFirstChild(parent: Element | Document, ns: string, localName: string): Element | null;
+/**
+ * Return the first descendant element matching tag name, or null.
+ */
+export declare function findChild(parent: Element | Document, tagName: string): Element | null;
+//# sourceMappingURL=xml-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"xml-helpers.d.ts","sourceRoot":"","sources":["../../src/primitives/xml-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,OAAO,EACX,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,GAAG,IAAI,CAiBf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAEvG;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAErF"}

package/dist/primitives/xml-helpers.js

@@ -0,0 +1,35 @@
+/**
+ * Defensive XML access helpers for OOXML-style DOMs.
+ *
+ * DOCX parts in the wild may mix namespace-bound attributes/elements with
+ * prefixed or bare names. These helpers centralize the fallback order without
+ * changing each caller's null handling.
+ */
+/**
+ * Read an attribute by namespace, then optional prefix, then bare local name.
+ */
+export function getAttributeSafe(el, ns, localName, prefix, options) {
+    const useBareFallback = options?.bareFallback ?? true;
+    if (options?.emptyIsMissing) {
+        return (el.getAttributeNS(ns, localName) ||
+            (prefix ? el.getAttribute(`${prefix}:${localName}`) : null) ||
+            (useBareFallback ? el.getAttribute(localName) : null) ||
+            null);
+    }
+    return (el.getAttributeNS(ns, localName) ??
+        (prefix ? el.getAttribute(`${prefix}:${localName}`) : null) ??
+        (useBareFallback ? el.getAttribute(localName) : null));
+}
+/**
+ * Return the first descendant element matching namespace/local-name, or null.
+ */
+export function getFirstChild(parent, ns, localName) {
+    return parent.getElementsByTagNameNS(ns, localName).item(0);
+}
+/**
+ * Return the first descendant element matching tag name, or null.
+ */
+export function findChild(parent, tagName) {
+    return parent.getElementsByTagName(tagName).item(0);
+}
+//# sourceMappingURL=xml-helpers.js.map

package/dist/primitives/xml-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-helpers.js","sourceRoot":"","sources":["../../src/primitives/xml-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAW,EACX,EAAU,EACV,SAAiB,EACjB,MAAe,EACf,OAA8B;IAE9B,MAAM,eAAe,GAAG,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC;IAEtD,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;QAC5B,OAAO,CACL,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC;YAChC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3D,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACrD,IAAI,CACL,CAAC;IACJ,CAAC;IAED,OAAO,CACL,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,SAAS,CAAC;QAChC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CACtD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAA0B,EAAE,EAAU,EAAE,SAAiB;IACrF,OAAO,MAAM,CAAC,sBAAsB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAmB,CAAC;AAChF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAA0B,EAAE,OAAe;IACnE,OAAO,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAmB,CAAC;AACxE,CAAC"}

package/dist/primitives/xml.d.ts

@@ -1,4 +1,9 @@
 export type XmlDoc = Document;
+/**
+ * Standard XML declaration for serialized OOXML parts. xmldom's serializer
+ * omits the declaration, so every emitted part prepends this manually.
+ */
+export declare const XML_DECL = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>";
 export declare function parseXml(xml: string): XmlDoc;
 export declare function serializeXml(doc: XmlDoc): string;
 export declare function textContent(node: Node | null | undefined): string;

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

@@ -1 +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,CAa5C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEjE"}
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/primitives/xml.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC;AAE9B;;;GAGG;AACH,eAAO,MAAM,QAAQ,kEAA4D,CAAC;AAElF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAa5C;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

@@ -1,4 +1,9 @@
 import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
+/**
+ * Standard XML declaration for serialized OOXML parts. xmldom's serializer
+ * omits the declaration, so every emitted part prepends this manually.
+ */
+export const XML_DECL = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>';
 export function parseXml(xml) {
     // application/xml ensures XML parsing rules (vs HTML-ish parsing).
     // xmldom 0.9.x returns its own module-scoped Document type; cast to global

package/dist/primitives/xml.js.map

@@ -1 +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,2EAA2E;IAC3E,qDAAqD;IACrD,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,iBAAiB,CAAwB,CAAC;IAE3F,+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"}
+{"version":3,"file":"xml.js","sourceRoot":"","sources":["../../src/primitives/xml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI1D;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,yDAAyD,CAAC;AAElF,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,mEAAmE;IACnE,2EAA2E;IAC3E,qDAAqD;IACrD,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,iBAAiB,CAAwB,CAAC;IAE3F,+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"}

package/dist/primitives/zip.d.ts

@@ -19,6 +19,7 @@ export declare class DocxZip {
 export declare function createZipBuffer(files: Record<string, string | Buffer | Uint8Array>, opts?: {
     compression?: ZipCompression;
     compressionLevel?: number;
+    fileDate?: Date;
 }): Promise<Buffer>;
 export declare function readZipText(buffer: Buffer, path: string): Promise<string | null>;
 export declare function inspectZipEntries(buffer: Buffer): Promise<ZipEntryInfo[]>;

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

@@ -1 +1 @@
-{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../../src/primitives/zip.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAaF,qBAAa,OAAO;IAClB,OAAO,CAAC,GAAG,CAAQ;IAEnB,OAAO;WAIM,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM1D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,SAAS,IAAI,MAAM,EAAE;IAQf,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAIlC;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC,EACnD,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,cAAc,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKtF;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAW/E"}
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../../src/primitives/zip.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAaF,qBAAa,OAAO;IAClB,OAAO,CAAC,GAAG,CAAQ;IAEnB,OAAO;WAIM,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM1D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAM3C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,SAAS,IAAI,MAAM,EAAE;IAQf,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CAgBlC;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC,EACnD,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,cAAc,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;CAAE,GAClF,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKtF;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAW/E"}

package/dist/primitives/zip.js

@@ -27,7 +27,9 @@ export class DocxZip {
         return file.async('text');
     }
     writeText(path, text) {
-        this.zip.file(path, text);
+        // createFolders defaults to true and would add a directory entry (e.g.
+        // `word/`) absent from the Word-authored input archive.
+        this.zip.file(path, text, { createFolders: false });
     }
     hasFile(path) {
         return this.zip.file(path) !== null;
@@ -40,14 +42,30 @@ export class DocxZip {
         return files;
     }
     async toBuffer() {
-        const out = await this.zip.generateAsync({ type: 'nodebuffer' });
+        // OPC packages never need directory entries (Word does not emit them);
+        // drop any that came in via the source archive or earlier writes so the
+        // output contract is simply "zero directory entries". NOT zip.remove():
+        // that deletes a folder's contents recursively.
+        for (const file of Object.values(this.zip.files)) {
+            if (file.dir)
+                delete this.zip.files[file.name];
+        }
+        // jszip defaults to STORE, which inflated saves ~6x.
+        const out = await this.zip.generateAsync({
+            type: 'nodebuffer',
+            compression: 'DEFLATE',
+            compressionOptions: { level: 6 },
+        });
         return out;
     }
 }
 export async function createZipBuffer(files, opts) {
     const zip = new JSZip();
     for (const [name, value] of Object.entries(files)) {
-        zip.file(name, value);
+        // JSZip stamps each entry with the current time by default, which makes
+        // otherwise-identical archives differ byte-for-byte across runs; callers
+        // needing deterministic output pass a fixed fileDate.
+        zip.file(name, value, opts?.fileDate ? { date: opts.fileDate } : undefined);
     }
     const out = await zip.generateAsync({
         type: 'nodebuffer',

package/dist/primitives/zip.js.map

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

package/dist/shared/field-structure.d.ts

@@ -0,0 +1,14 @@
+export interface FieldStory {
+    label: string;
+    xml: string;
+}
+export type FieldStructureIssue = {
+    code: string;
+    message: string;
+    story?: string;
+    element?: string;
+};
+export declare function hasFldCharInsideDel(documentXml: string): boolean;
+export declare function collectFieldStructureIssues(input: string | FieldStory[]): FieldStructureIssue[];
+export declare function validateFieldStructure(input: string | FieldStory[]): boolean;
+//# sourceMappingURL=field-structure.d.ts.map

package/dist/shared/field-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-structure.d.ts","sourceRoot":"","sources":["../../src/shared/field-structure.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAcF,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CA2BhE;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,mBAAmB,EAAE,CAU/F;AAaD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,OAAO,CAI5E"}