open-agreements 0.7.7 → 0.8.0

package/node_modules/@usejunior/docx-core/dist/primitives/track-changes-emitter.js

@@ -0,0 +1,291 @@
+import { parseXml, serializeXml } from './xml.js';
+import { childElements, createWmlElement, renameElement } from './dom-helpers.js';
+import { OOXML } from './namespaces.js';
+const SYNTHETIC_DOC = parseXml('<root xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"/>');
+const EXCLUDED_PPR_CHANGE_CHILDREN = new Set(['w:rPr', 'w:rPrChange', 'w:pPrChange', 'w:sectPr']);
+const EXCLUDED_TRPR_CHANGE_CHILDREN = new Set(['w:trPrChange', 'w:ins', 'w:del']);
+// CT_TcPrInner (the inner pPr under <w:tcPrChange>) preserves cell-topology
+// revision children (w:cellIns, w:cellDel, w:cellMerge). Only the
+// change-of-a-change marker w:tcPrChange itself is excluded. See:
+// https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.wordprocessing.previoustablecellproperties
+const EXCLUDED_TCPR_CHANGE_CHILDREN = new Set(['w:tcPrChange']);
+const EXCLUDED_RPR_CHANGE_CHILDREN = new Set(['w:rPrChange']);
+/**
+ * Create a revision ID allocator.
+ *
+ * @param startId - First ID to allocate. Defaults to `1`.
+ */
+export function createRevisionIdState(startId = 1) {
+    return {
+        nextId: startId,
+        moveRangeIds: new Map(),
+    };
+}
+/**
+ * Allocate the next revision ID from a shared state object.
+ */
+export function allocateRevisionId(state) {
+    return state.nextId++;
+}
+/**
+ * Format a revision timestamp as OOXML-friendly ISO 8601.
+ */
+export function formatDate(date) {
+    return date.toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+/**
+ * Escape XML attribute text used in serialized revision markup.
+ */
+export function escapeXmlAttr(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+/**
+ * Create a reusable revision context for tracked-change emission.
+ */
+export function createRevisionContext(options) {
+    const { author, date, idState = createRevisionIdState() } = options;
+    return {
+        author,
+        date: typeof date === 'string' ? date : formatDate(date ?? new Date()),
+        idState,
+    };
+}
+/**
+ * Create a fresh tracked-change container (`<w:ins>` or `<w:del>`) into which
+ * the caller appends owned child nodes.
+ *
+ * Use this when wrapping multiple sibling elements under one revision marker.
+ * For single-element wrapping, prefer `wrapElementWithIns` / `wrapElementWithDel`.
+ */
+export function createRevisionContainer(doc, kind, ctx) {
+    return createRevisionWrapperElement(doc, kind, ctx);
+}
+/**
+ * Rewrite `<w:t>` → `<w:delText>` and `<w:instrText>` → `<w:delInstrText>`
+ * on the given element and all its descendants, for use inside a `<w:del>`
+ * container.
+ *
+ * **CALLERS MUST USE THE RETURN VALUE.** When the input element itself is a
+ * root `<w:t>` or `<w:instrText>`, this helper creates a renamed replacement
+ * node (you cannot rename a DOM element in place); the input element is
+ * detached from the tree and the new node is returned. Pattern:
+ *
+ *   const ready = prepareElementForDeletion(detachedElement);
+ *   wrapper.appendChild(ready);
+ *
+ * The element MUST already be detached from any parent. Calling on an
+ * attached element will leave the original tree in an inconsistent state.
+ */
+export function prepareElementForDeletion(element) {
+    return normalizeDeletionElement(element);
+}
+/**
+ * Wrap an xmldom element in `<w:ins>`.
+ *
+ * The source element is cloned; the original DOM node is left untouched.
+ */
+export function wrapElementWithIns(element, ctx) {
+    const wrapper = createRevisionContainer(getOwnerDocument(element), 'ins', ctx);
+    wrapper.appendChild(element.cloneNode(true));
+    return wrapper;
+}
+/**
+ * Wrap an xmldom element in `<w:del>`.
+ *
+ * Any descendant `<w:t>` and `<w:instrText>` nodes are converted to the OOXML
+ * deletion equivalents before the cloned element is appended.
+ */
+export function wrapElementWithDel(element, ctx) {
+    const wrapper = createRevisionContainer(getOwnerDocument(element), 'del', ctx);
+    const cloned = prepareElementForDeletion(element.cloneNode(true));
+    wrapper.appendChild(cloned);
+    return wrapper;
+}
+/**
+ * Build a `<w:pPrChange>` wrapper containing the previous paragraph properties.
+ *
+ * The nested snapshot excludes children that are not valid in `CT_PPrBase`.
+ */
+export function buildPPrChangeElement(oldPPr, ctx) {
+    const pPrChange = createWmlElement(getOwnerDocument(oldPPr), 'pPrChange', revisionAttributes(ctx));
+    const previousPPr = createWmlElement(getOwnerDocument(oldPPr), 'pPr');
+    if (oldPPr) {
+        for (const child of childElements(oldPPr)) {
+            if (!EXCLUDED_PPR_CHANGE_CHILDREN.has(child.tagName)) {
+                previousPPr.appendChild(child.cloneNode(true));
+            }
+        }
+    }
+    pPrChange.appendChild(previousPPr);
+    return pPrChange;
+}
+/**
+ * Build a `<w:trPrChange>` wrapper containing the previous row properties.
+ *
+ * The nested snapshot excludes children that are not valid in `CT_TrPrBase`.
+ */
+export function buildTrPrChangeElement(oldTrPr, ctx) {
+    const trPrChange = createWmlElement(getOwnerDocument(oldTrPr), 'trPrChange', revisionAttributes(ctx));
+    const previousTrPr = createWmlElement(getOwnerDocument(oldTrPr), 'trPr');
+    if (oldTrPr) {
+        for (const child of childElements(oldTrPr)) {
+            if (!EXCLUDED_TRPR_CHANGE_CHILDREN.has(child.tagName)) {
+                previousTrPr.appendChild(child.cloneNode(true));
+            }
+        }
+    }
+    trPrChange.appendChild(previousTrPr);
+    return trPrChange;
+}
+/**
+ * Build a `<w:tcPrChange>` wrapper containing the previous cell properties.
+ *
+ * The nested snapshot excludes children that are not valid in `CT_TcPrBase`.
+ */
+export function buildTcPrChangeElement(oldTcPr, ctx) {
+    const tcPrChange = createWmlElement(getOwnerDocument(oldTcPr), 'tcPrChange', revisionAttributes(ctx));
+    const previousTcPr = createWmlElement(getOwnerDocument(oldTcPr), 'tcPr');
+    if (oldTcPr) {
+        for (const child of childElements(oldTcPr)) {
+            if (!EXCLUDED_TCPR_CHANGE_CHILDREN.has(child.tagName)) {
+                previousTcPr.appendChild(child.cloneNode(true));
+            }
+        }
+    }
+    tcPrChange.appendChild(previousTcPr);
+    return tcPrChange;
+}
+/**
+ * Build a `<w:rPrChange>` wrapper containing the previous run properties.
+ *
+ * The nested snapshot excludes any existing `w:rPrChange` child. This filtering
+ * is intentional: OOXML does not permit recursively nested `w:rPrChange` (a
+ * change-of-a-change is undefined), so the helper drops it. Note this is a
+ * stricter contract than the legacy reconstructor's per-child loop, which
+ * would have passed a nested `w:rPrChange` through verbatim. The reconstructor
+ * still uses its own per-child path; this helper is for new primitive code
+ * (#136 onward).
+ */
+export function buildRPrChangeElement(oldRPr, ctx) {
+    const rPrChange = createWmlElement(getOwnerDocument(oldRPr), 'rPrChange', revisionAttributes(ctx));
+    const previousRPr = createWmlElement(getOwnerDocument(oldRPr), 'rPr');
+    if (oldRPr) {
+        for (const child of childElements(oldRPr)) {
+            if (!EXCLUDED_RPR_CHANGE_CHILDREN.has(child.tagName)) {
+                previousRPr.appendChild(child.cloneNode(true));
+            }
+        }
+    }
+    rPrChange.appendChild(previousRPr);
+    return rPrChange;
+}
+/**
+ * Wrap serialized OOXML content in a `<w:ins>` element.
+ *
+ * This keeps the reconstructor on its string-based emission path while sharing
+ * revision metadata handling with the DOM-aware helpers above.
+ */
+export function wrapSerializedContentWithIns(content, ctx) {
+    return `${createSerializedRevisionOpenTag('w:ins', ctx)}${content}</w:ins>`;
+}
+/**
+ * Wrap serialized OOXML content in a `<w:del>` element.
+ *
+ * Visible text nodes are rewritten to their deletion-tag equivalents before
+ * the wrapper is serialized.
+ */
+export function wrapSerializedContentWithDel(content, ctx) {
+    return `${createSerializedRevisionOpenTag('w:del', ctx)}${convertSerializedDeletionContent(content)}</w:del>`;
+}
+/**
+ * Matches a `<w:t>` or `<w:instrText>` open tag (including the self-closing
+ * form). Used as a fast path: content with no convertible tags is returned
+ * byte-for-byte unchanged, skipping the parse/serialize round-trip.
+ */
+const CONVERTIBLE_TEXT_TAG = /<w:(?:t|instrText)[\s/>]/;
+/**
+ * Convert serialized run content from insertion-style text tags to deletion
+ * equivalents (`w:t` -> `w:delText`, `w:instrText` -> `w:delInstrText`).
+ *
+ * The fragment is parsed into a DOM and renamed via the same traversal as
+ * `prepareElementForDeletion`, so attribute order is preserved and shapes a
+ * regex sweep mishandles (self-closing `<w:t/>`, attribute values containing
+ * `>`) convert correctly. Namespace prefixes the fragment uses without an
+ * inline declaration are bound on a temporary wrapper root that is stripped
+ * from the returned serialization.
+ *
+ * @see https://github.com/UseJunior/safe-docx/issues/102
+ */
+export function convertSerializedDeletionContent(content) {
+    if (!CONVERTIBLE_TEXT_TAG.test(content)) {
+        return content;
+    }
+    const doc = parseXml(`<root${declareContentPrefixes(content)}>${content}</root>`);
+    for (const child of childElements(doc.documentElement)) {
+        normalizeDeletionElement(child);
+    }
+    // Strip the wrapper root: everything between the end of its open tag and
+    // the start of its close tag. Safe because the declared URIs contain no '>'.
+    const serialized = serializeXml(doc);
+    return serialized.slice(serialized.indexOf('>') + 1, serialized.lastIndexOf('<'));
+}
+/**
+ * Matches a `prefix:` occurrence in markup context — after `<`, `</`, or
+ * whitespace (attribute position). May over-match inside text content, which
+ * is harmless: it only yields an unused declaration on the wrapper root.
+ */
+const PREFIX_SCAN = /[<\s]\/?([A-Za-z_][A-Za-z0-9_.-]*):/g;
+/**
+ * Build `xmlns` declarations for every namespace prefix a serialized fragment
+ * uses, so the fragment parses under a wrapper root (xmldom rejects
+ * undeclared prefixes). `w` binds to the real WordprocessingML namespace —
+ * the deletion rename produces elements in that namespace — while unknown
+ * prefixes get placeholder URIs. The wrapper root carrying these declarations
+ * is stripped after serialization, so placeholders never reach the output;
+ * fragments serialized from a real document carry their own inline
+ * declarations, which take precedence over the wrapper's.
+ */
+function declareContentPrefixes(content) {
+    const declarations = new Map([['w', OOXML.W_NS]]);
+    for (const match of content.matchAll(PREFIX_SCAN)) {
+        const prefix = match[1];
+        if (prefix !== 'xml' && prefix !== 'xmlns' && !declarations.has(prefix)) {
+            declarations.set(prefix, `urn:safe-docx:undeclared-prefix:${prefix}`);
+        }
+    }
+    return [...declarations].map(([prefix, uri]) => ` xmlns:${prefix}="${uri}"`).join('');
+}
+function getOwnerDocument(element) {
+    return element?.ownerDocument ?? SYNTHETIC_DOC;
+}
+function revisionAttributes(ctx) {
+    return {
+        'w:id': String(allocateRevisionId(ctx.idState)),
+        'w:author': ctx.author,
+        'w:date': ctx.date,
+    };
+}
+function createRevisionWrapperElement(doc, tag, ctx) {
+    return createWmlElement(doc, tag, revisionAttributes(ctx));
+}
+function createSerializedRevisionOpenTag(tagName, ctx) {
+    const id = allocateRevisionId(ctx.idState);
+    return `<${tagName} w:id="${id}" w:author="${escapeXmlAttr(ctx.author)}" w:date="${ctx.date}">`;
+}
+function normalizeDeletionElement(element) {
+    for (const child of childElements(element)) {
+        normalizeDeletionElement(child);
+    }
+    if (element.tagName === 'w:t') {
+        return renameElement(element, 'w:delText');
+    }
+    if (element.tagName === 'w:instrText') {
+        return renameElement(element, 'w:delInstrText');
+    }
+    return element;
+}
+//# sourceMappingURL=track-changes-emitter.js.map

package/node_modules/@usejunior/docx-core/dist/primitives/track-changes-emitter.js.map

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

package/node_modules/@usejunior/docx-core/dist/primitives/validate_ai_revisions.d.ts

@@ -0,0 +1,35 @@
+import { DocxZip } from './zip.js';
+export type AiRevisionSeverity = 'error' | 'warning';
+export type AiRevisionDiagnostic = {
+    severity: AiRevisionSeverity;
+    code: string;
+    message: string;
+    part?: string;
+    element?: string;
+    id?: string;
+    author?: string | null;
+};
+export type ValidateAiRevisionsResult = {
+    valid: boolean;
+    errors: AiRevisionDiagnostic[];
+    warnings: AiRevisionDiagnostic[];
+};
+export type AiRevisionValidationTouchedContext = {
+    revisionIds?: Iterable<string | number>;
+    rangeIds?: Iterable<string | number>;
+    relationshipParts?: Iterable<string>;
+    sideParts?: Iterable<string>;
+};
+export type AiRevisionStoryInput = {
+    part: string;
+    doc: Document;
+};
+export type ValidateAiRevisionsOptions = {
+    aiAuthor: string;
+    stories: AiRevisionStoryInput[];
+    packageZip?: DocxZip;
+    touched?: AiRevisionValidationTouchedContext;
+};
+export declare function validateAiRevisions(options: ValidateAiRevisionsOptions): Promise<ValidateAiRevisionsResult>;
+export declare const AI_REVISION_VALIDATION_STORY_PARTS: readonly ["word/footnotes.xml", "word/endnotes.xml", "word/comments.xml", "word/glossary/document.xml"];
+//# sourceMappingURL=validate_ai_revisions.d.ts.map

package/node_modules/@usejunior/docx-core/dist/primitives/validate_ai_revisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate_ai_revisions.d.ts","sourceRoot":"","sources":["../../src/primitives/validate_ai_revisions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAcnC,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACrC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,QAAQ,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,kCAAkC,CAAC;CAC9C,CAAC;AAoVF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAgCpC;AAED,eAAO,MAAM,kCAAkC,yGAA4B,CAAC"}

package/node_modules/@usejunior/docx-core/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