@usejunior/docx-core 0.9.1 → 0.11.0

package/dist/primitives/track-changes-emitter.d.ts

@@ -0,0 +1,148 @@
+/**
+ * State for allocating monotonically increasing revision IDs.
+ *
+ * `moveRangeIds` exists so comparison-time emitters can reserve paired source
+ * and destination IDs for move ranges while sharing the same counter.
+ */
+export interface RevisionIdState {
+    nextId: number;
+    moveRangeIds: Map<string, {
+        sourceRangeId: number;
+        destRangeId: number;
+    }>;
+}
+/**
+ * Create a revision ID allocator.
+ *
+ * @param startId - First ID to allocate. Defaults to `1`.
+ */
+export declare function createRevisionIdState(startId?: number): RevisionIdState;
+/**
+ * Allocate the next revision ID from a shared state object.
+ */
+export declare function allocateRevisionId(state: RevisionIdState): number;
+/**
+ * Serialized metadata shared by tracked-change emitters.
+ */
+export interface RevisionContext {
+    author: string;
+    date: string;
+    idState: RevisionIdState;
+}
+/**
+ * Options for constructing a revision context.
+ */
+export interface RevisionContextOptions {
+    author: string;
+    date?: Date | string;
+    idState?: RevisionIdState;
+}
+/**
+ * Format a revision timestamp as OOXML-friendly ISO 8601.
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Escape XML attribute text used in serialized revision markup.
+ */
+export declare function escapeXmlAttr(text: string): string;
+/**
+ * Create a reusable revision context for tracked-change emission.
+ */
+export declare function createRevisionContext(options: RevisionContextOptions): RevisionContext;
+/**
+ * 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 declare function createRevisionContainer(doc: Document, kind: 'ins' | 'del', ctx: RevisionContext): Element;
+/**
+ * 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 declare function prepareElementForDeletion(element: Element): Element;
+/**
+ * Wrap an xmldom element in `<w:ins>`.
+ *
+ * The source element is cloned; the original DOM node is left untouched.
+ */
+export declare function wrapElementWithIns(element: Element, ctx: RevisionContext): Element;
+/**
+ * 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 declare function wrapElementWithDel(element: Element, ctx: RevisionContext): Element;
+/**
+ * Build a `<w:pPrChange>` wrapper containing the previous paragraph properties.
+ *
+ * The nested snapshot excludes children that are not valid in `CT_PPrBase`.
+ */
+export declare function buildPPrChangeElement(oldPPr: Element | null, ctx: RevisionContext): Element;
+/**
+ * Build a `<w:trPrChange>` wrapper containing the previous row properties.
+ *
+ * The nested snapshot excludes children that are not valid in `CT_TrPrBase`.
+ */
+export declare function buildTrPrChangeElement(oldTrPr: Element | null, ctx: RevisionContext): Element;
+/**
+ * Build a `<w:tcPrChange>` wrapper containing the previous cell properties.
+ *
+ * The nested snapshot excludes children that are not valid in `CT_TcPrBase`.
+ */
+export declare function buildTcPrChangeElement(oldTcPr: Element | null, ctx: RevisionContext): Element;
+/**
+ * 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 declare function buildRPrChangeElement(oldRPr: Element | null, ctx: RevisionContext): Element;
+/**
+ * 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 declare function wrapSerializedContentWithIns(content: string, ctx: RevisionContext): string;
+/**
+ * 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 declare function wrapSerializedContentWithDel(content: string, ctx: RevisionContext): string;
+/**
+ * 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 declare function convertSerializedDeletionContent(content: string): string;
+//# sourceMappingURL=track-changes-emitter.d.ts.map

package/dist/primitives/track-changes-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-changes-emitter.d.ts","sourceRoot":"","sources":["../../src/primitives/track-changes-emitter.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,MAAU,GAAG,eAAe,CAK1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAOtF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,KAAK,GAAG,KAAK,EACnB,GAAG,EAAE,eAAe,GACnB,OAAO,CAET;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAIlF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAKlF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAkB3F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAkB7F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAkB7F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAkB3F;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,MAAM,CAE1F;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,MAAM,CAE1F;AASD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcxE"}

package/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/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/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/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"}