@usejunior/docx-core 0.0.1 → 0.1.1

package/dist/primitives/accept_changes.js

@@ -0,0 +1,241 @@
+/**
+ * accept_changes — accept all tracked changes in a OOXML document body.
+ *
+ * Produces a clean document with no revision markup by:
+ * - Removing w:del elements and their content
+ * - Unwrapping w:ins elements (promoting children)
+ * - Removing w:moveFrom (source), unwrapping w:moveTo (destination)
+ * - Removing all *PrChange property change records
+ * - Stripping paragraph-level revision markers
+ * - Cleaning up move range markers and rsidDel attributes
+ *
+ * Operates on the W3C DOM (`@xmldom/xmldom`) — the same API used
+ * throughout docx-primitives-ts (contrast with docx-comparison's
+ * custom WmlElement AST).
+ */
+import { OOXML } from './namespaces.js';
+const W_NS = OOXML.W_NS;
+// ── DOM helpers (internal) ──────────────────────────────────────────
+function isW(node, localName) {
+    return (node.nodeType === 1 &&
+        node.namespaceURI === W_NS &&
+        node.localName === localName);
+}
+function isWElement(node) {
+    return node.nodeType === 1 && node.namespaceURI === W_NS;
+}
+function getDepth(node) {
+    let depth = 0;
+    let cur = node.parentNode;
+    while (cur) {
+        depth++;
+        cur = cur.parentNode;
+    }
+    return depth;
+}
+function collectByLocalName(container, localName) {
+    return Array.from(container.getElementsByTagNameNS(W_NS, localName));
+}
+function removeAllByLocalName(container, localName) {
+    const elements = collectByLocalName(container, localName);
+    let count = 0;
+    for (const el of elements) {
+        if (el.parentNode) {
+            el.parentNode.removeChild(el);
+            count++;
+        }
+    }
+    return count;
+}
+function unwrapAllByLocalName(container, localName) {
+    const elements = collectByLocalName(container, localName);
+    // Sort deepest-first to handle nested wrappers correctly
+    elements.sort((a, b) => getDepth(b) - getDepth(a));
+    let count = 0;
+    for (const el of elements) {
+        const parent = el.parentNode;
+        if (!parent)
+            continue;
+        // Promote all children to the parent
+        while (el.firstChild) {
+            parent.insertBefore(el.firstChild, el);
+        }
+        parent.removeChild(el);
+        count++;
+    }
+    return count;
+}
+/**
+ * Check if a paragraph has a paragraph-level revision marker.
+ * Pattern: w:p > w:pPr > w:rPr > w:del (or w:ins)
+ */
+function paragraphHasParaMarker(p, markerLocalName) {
+    for (let i = 0; i < p.childNodes.length; i++) {
+        const child = p.childNodes[i];
+        if (!isW(child, 'pPr'))
+            continue;
+        for (let j = 0; j < child.childNodes.length; j++) {
+            const pPrChild = child.childNodes[j];
+            if (!isW(pPrChild, 'rPr'))
+                continue;
+            for (let k = 0; k < pPrChild.childNodes.length; k++) {
+                const rPrChild = pPrChild.childNodes[k];
+                if (isW(rPrChild, markerLocalName))
+                    return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Check if a node (or its descendants) contains any w:r elements.
+ */
+function containsRun(node) {
+    if (isW(node, 'r'))
+        return true;
+    for (let i = 0; i < node.childNodes.length; i++) {
+        if (containsRun(node.childNodes[i]))
+            return true;
+    }
+    return false;
+}
+// Tags that are "removed" content — should not count as live content
+const REMOVED_LOCALS = new Set(['del', 'moveFrom']);
+// Tags that are "kept" content — their presence means the paragraph has live content
+const KEPT_LOCALS = new Set(['ins', 'moveTo']);
+// Range marker tags to ignore when scanning paragraph children
+const RANGE_MARKER_LOCALS = new Set([
+    'moveFromRangeStart', 'moveFromRangeEnd',
+    'moveToRangeStart', 'moveToRangeEnd',
+]);
+/**
+ * Determine if a paragraph's only content lives inside w:del or w:moveFrom
+ * (no w:r outside those wrappers, and no w:ins/w:moveTo siblings).
+ */
+function paragraphHasOnlyRemovedContent(p) {
+    for (let i = 0; i < p.childNodes.length; i++) {
+        const child = p.childNodes[i];
+        if (child.nodeType !== 1)
+            continue;
+        const el = child;
+        if (el.namespaceURI !== W_NS)
+            continue;
+        const local = el.localName;
+        // If the paragraph has kept content wrappers, it stays
+        if (KEPT_LOCALS.has(local))
+            return false;
+        // Skip pPr, range markers, and removed wrappers — they don't contribute live content
+        if (local === 'pPr' || RANGE_MARKER_LOCALS.has(local) || REMOVED_LOCALS.has(local))
+            continue;
+        // A bare w:r or any other element that contains runs means live content
+        if (local === 'r' || containsRun(el))
+            return false;
+    }
+    // We passed all children without finding live content — but there must be
+    // at least one removed wrapper for this to be a "removed content" paragraph
+    for (let i = 0; i < p.childNodes.length; i++) {
+        const child = p.childNodes[i];
+        if (child.nodeType === 1 && isWElement(child) && REMOVED_LOCALS.has(child.localName)) {
+            return true;
+        }
+    }
+    return false;
+}
+// Property change element local names (all 6 types)
+const PR_CHANGE_LOCALS = [
+    'rPrChange', 'pPrChange', 'sectPrChange',
+    'tblPrChange', 'trPrChange', 'tcPrChange',
+];
+// ── Public API ──────────────────────────────────────────────────────
+/**
+ * Accept all tracked changes in the document body, producing a clean
+ * document with no revision markup.
+ *
+ * Mutates the Document in place (same convention as simplifyRedlines
+ * and mergeRuns).
+ */
+export function acceptChanges(doc) {
+    const body = doc.getElementsByTagNameNS(W_NS, 'body').item(0);
+    if (!body) {
+        return { insertionsAccepted: 0, deletionsAccepted: 0, movesResolved: 0, propertyChangesResolved: 0 };
+    }
+    // Phase A — Identify paragraphs to remove
+    const paragraphsToRemove = new Set();
+    const allParagraphs = collectByLocalName(body, 'p');
+    for (const p of allParagraphs) {
+        // Paragraph-level deletion marker: w:p > w:pPr > w:rPr > w:del
+        if (paragraphHasParaMarker(p, 'del')) {
+            paragraphsToRemove.add(p);
+            continue;
+        }
+        // Paragraphs whose only content is inside w:del or w:moveFrom
+        if (paragraphHasOnlyRemovedContent(p)) {
+            paragraphsToRemove.add(p);
+        }
+    }
+    // Phase B — Remove deletions and move sources
+    const deletionsAccepted = removeAllByLocalName(body, 'del');
+    const moveFromRemoved = removeAllByLocalName(body, 'moveFrom');
+    removeAllByLocalName(body, 'moveFromRangeStart');
+    removeAllByLocalName(body, 'moveFromRangeEnd');
+    removeAllByLocalName(body, 'moveToRangeStart');
+    removeAllByLocalName(body, 'moveToRangeEnd');
+    // Phase C — Unwrap insertions and move destinations (depth-sorted)
+    const insertionsAccepted = unwrapAllByLocalName(body, 'ins');
+    const moveToUnwrapped = unwrapAllByLocalName(body, 'moveTo');
+    // Phase D — Remove property change records
+    let propertyChangesResolved = 0;
+    for (const localName of PR_CHANGE_LOCALS) {
+        propertyChangesResolved += removeAllByLocalName(body, localName);
+    }
+    // Phase E — Cleanup
+    // Strip paragraph-level revision markers from w:pPr/w:rPr
+    for (const p of collectByLocalName(body, 'p')) {
+        for (let i = 0; i < p.childNodes.length; i++) {
+            const child = p.childNodes[i];
+            if (!isW(child, 'pPr'))
+                continue;
+            for (let j = 0; j < child.childNodes.length; j++) {
+                const pPrChild = child.childNodes[j];
+                if (!isW(pPrChild, 'rPr'))
+                    continue;
+                // Remove w:ins and w:del marker elements inside pPr > rPr
+                const toRemove = [];
+                for (let k = 0; k < pPrChild.childNodes.length; k++) {
+                    const rPrChild = pPrChild.childNodes[k];
+                    if (isW(rPrChild, 'ins') || isW(rPrChild, 'del')) {
+                        toRemove.push(rPrChild);
+                    }
+                }
+                for (const el of toRemove) {
+                    pPrChild.removeChild(el);
+                }
+            }
+        }
+    }
+    // Remove paragraphs collected in Phase A (check parentNode still exists)
+    for (const p of paragraphsToRemove) {
+        if (p.parentNode) {
+            p.parentNode.removeChild(p);
+        }
+    }
+    // Strip w:rsidDel attributes on remaining elements
+    const allElements = body.getElementsByTagNameNS(W_NS, '*');
+    for (let i = 0; i < allElements.length; i++) {
+        const el = allElements[i];
+        if (el.hasAttributeNS(W_NS, 'rsidDel')) {
+            el.removeAttributeNS(W_NS, 'rsidDel');
+        }
+        // Also check prefixed form
+        if (el.hasAttribute('w:rsidDel')) {
+            el.removeAttribute('w:rsidDel');
+        }
+    }
+    return {
+        insertionsAccepted,
+        deletionsAccepted,
+        movesResolved: moveFromRemoved + moveToUnwrapped,
+        propertyChangesResolved,
+    };
+}
+//# sourceMappingURL=accept_changes.js.map

package/dist/primitives/accept_changes.js.map

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

package/dist/primitives/bookmarks.d.ts

@@ -0,0 +1,12 @@
+export type ParagraphBookmark = {
+    name: string;
+    numericId: number;
+};
+export declare function getParagraphBookmarkId(p: Element): string | null;
+export declare function cleanupInternalBookmarks(doc: Document): number;
+export declare function insertParagraphBookmarks(doc: Document, _attachmentId: string): {
+    indexedParagraphs: number;
+};
+export declare function insertSingleParagraphBookmark(doc: Document, p: Element): string;
+export declare function findParagraphByBookmarkId(doc: Document, bookmarkId: string): Element | null;
+//# sourceMappingURL=bookmarks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bookmarks.d.ts","sourceRoot":"","sources":["../../src/primitives/bookmarks.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAwHF,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CA+BhE;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAuB9D;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG;IAAE,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAkD5G;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAoC/E;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAO3F"}

package/dist/primitives/bookmarks.js

@@ -0,0 +1,248 @@
+import { createHash } from 'node:crypto';
+import { OOXML, W } from './namespaces.js';
+import { getParagraphText } from './text.js';
+const W14_NS = 'http://schemas.microsoft.com/office/word/2010/wordml';
+function sha12(input) {
+    return createHash('sha1').update(input).digest('hex').slice(0, 12);
+}
+function normalizeText(value) {
+    return (value ?? '').replace(/\s+/g, ' ').trim().toLowerCase();
+}
+function ancestorSignature(p) {
+    const parts = [];
+    let cur = p.parentElement;
+    while (cur) {
+        parts.push(cur.localName ?? cur.nodeName);
+        // Body/document boundary is enough context.
+        if (cur.namespaceURI === OOXML.W_NS && (cur.localName === W.body || cur.localName === W.document))
+            break;
+        cur = cur.parentElement;
+    }
+    return parts.join('/');
+}
+function getW14ParaId(p) {
+    const namespaced = p.getAttributeNS(W14_NS, 'paraId');
+    if (namespaced)
+        return namespaced.toLowerCase();
+    // Fallbacks for XML libraries that may not expose namespaced attributes consistently.
+    const prefixed = p.getAttribute('w14:paraId');
+    if (prefixed)
+        return prefixed.toLowerCase();
+    const plain = p.getAttribute('paraId');
+    if (plain)
+        return plain.toLowerCase();
+    return null;
+}
+function buildParagraphSeed(params) {
+    const { paragraph, prevText, nextText } = params;
+    const intrinsic = getW14ParaId(paragraph);
+    if (intrinsic)
+        return `intrinsic:w14:${intrinsic}`;
+    const text = normalizeText(getParagraphText(paragraph));
+    const prev = normalizeText(prevText);
+    const next = normalizeText(nextText);
+    const ancestors = ancestorSignature(paragraph);
+    return `fallback:text=${text}|prev=${prev}|next=${next}|ancestors=${ancestors}`;
+}
+function deriveDeterministicJrParaName(params) {
+    const seed = buildParagraphSeed({
+        paragraph: params.paragraph,
+        prevText: params.prevText,
+        nextText: params.nextText,
+    });
+    let attempt = 0;
+    while (attempt < 10_000) {
+        const salt = attempt === 0 ? '' : `|salt:${attempt}`;
+        const candidate = `_bk_${sha12(`${seed}${salt}`)}`;
+        if (!params.usedNames.has(candidate)) {
+            params.usedNames.add(candidate);
+            return candidate;
+        }
+        attempt += 1;
+    }
+    throw new Error('Unable to allocate deterministic _bk_ bookmark name');
+}
+function collectUsedJrParaNames(doc) {
+    const used = new Set();
+    const starts = Array.from(doc.getElementsByTagNameNS(OOXML.W_NS, W.bookmarkStart));
+    for (const s of starts) {
+        const name = getAttr(s, 'name');
+        if (name && name.startsWith('_bk_'))
+            used.add(name);
+    }
+    return used;
+}
+function getAttr(el, localName) {
+    return el.getAttributeNS(OOXML.W_NS, localName) ?? el.getAttribute(`w:${localName}`);
+}
+function prevElementSibling(node) {
+    let cur = node?.previousSibling ?? null;
+    while (cur) {
+        if (cur.nodeType === 1)
+            return cur;
+        cur = cur.previousSibling;
+    }
+    return null;
+}
+function nextElementSibling(node) {
+    let cur = node?.nextSibling ?? null;
+    while (cur) {
+        if (cur.nodeType === 1)
+            return cur;
+        cur = cur.nextSibling;
+    }
+    return null;
+}
+function isBookmarkStart(el) {
+    return el.namespaceURI === OOXML.W_NS && el.localName === W.bookmarkStart;
+}
+function isBookmarkEnd(el) {
+    return el.namespaceURI === OOXML.W_NS && el.localName === W.bookmarkEnd;
+}
+function isParagraph(el) {
+    return el.namespaceURI === OOXML.W_NS && el.localName === W.p;
+}
+export function getParagraphBookmarkId(p) {
+    // Supports:
+    // 1) sibling style: <w:bookmarkStart/> <w:p/> <w:bookmarkEnd/>
+    // 2) inside style: <w:p><w:bookmarkStart/> ... </w:p>
+    // 1) Sibling style lookup.
+    // Handle stacked bookmarks (e.g. _bk_* plus edit-*) around the same paragraph.
+    // We scan backward across adjacent bookmark nodes until we hit another paragraph.
+    const prev = prevElementSibling(p);
+    const next = nextElementSibling(p);
+    if (prev && next && isBookmarkEnd(next)) {
+        let cur = prev;
+        while (cur) {
+            if (isParagraph(cur))
+                break;
+            if (isBookmarkStart(cur)) {
+                const name = getAttr(cur, 'name');
+                if (name && name.startsWith('_bk_'))
+                    return name;
+            }
+            cur = prevElementSibling(cur);
+        }
+    }
+    // 2) Inside paragraph lookup (best-effort).
+    const starts = p.getElementsByTagNameNS(OOXML.W_NS, W.bookmarkStart);
+    for (let i = 0; i < starts.length; i++) {
+        const el = starts.item(i);
+        const name = el ? getAttr(el, 'name') : null;
+        if (name && name.startsWith('_bk_'))
+            return name;
+    }
+    return null;
+}
+export function cleanupInternalBookmarks(doc) {
+    // Remove paragraph bookmarks (_bk_*) and edit span bookmarks (edit-*).
+    const starts = Array.from(doc.getElementsByTagNameNS(OOXML.W_NS, W.bookmarkStart));
+    const ends = Array.from(doc.getElementsByTagNameNS(OOXML.W_NS, W.bookmarkEnd));
+    const idsToRemove = new Set();
+    for (const s of starts) {
+        const name = getAttr(s, 'name') ?? '';
+        if (name.startsWith('_bk_') || name.startsWith('edit-')) {
+            const id = getAttr(s, 'id') ?? '';
+            if (id)
+                idsToRemove.add(id);
+            s.parentNode?.removeChild(s);
+        }
+    }
+    for (const e of ends) {
+        const id = getAttr(e, 'id') ?? '';
+        if (id && idsToRemove.has(id)) {
+            e.parentNode?.removeChild(e);
+        }
+    }
+    return idsToRemove.size;
+}
+export function insertParagraphBookmarks(doc, _attachmentId) {
+    // Insert _bk_* bookmarks around ALL paragraphs (including empty), using sibling style.
+    // This avoids moving paragraphs out of tables by inserting into the paragraph's parent.
+    const paragraphs = Array.from(doc.getElementsByTagNameNS(OOXML.W_NS, W.p));
+    if (paragraphs.length === 0)
+        return { indexedParagraphs: 0 };
+    const usedNames = collectUsedJrParaNames(doc);
+    let maxNumeric = 0;
+    const existingStarts = Array.from(doc.getElementsByTagNameNS(OOXML.W_NS, W.bookmarkStart));
+    for (const s of existingStarts) {
+        const n = getAttr(s, 'id');
+        const val = n ? Number.parseInt(n, 10) : NaN;
+        if (!Number.isNaN(val))
+            maxNumeric = Math.max(maxNumeric, val);
+    }
+    for (let i = 0; i < paragraphs.length; i++) {
+        const p = paragraphs[i];
+        if (!isParagraph(p))
+            continue;
+        const existingName = getParagraphBookmarkId(p);
+        if (existingName) {
+            usedNames.add(existingName);
+            continue;
+        }
+        const parent = p.parentNode;
+        if (!parent)
+            continue;
+        const numericId = ++maxNumeric;
+        const prevText = i > 0 ? getParagraphText(paragraphs[i - 1]) : '';
+        const nextText = i + 1 < paragraphs.length ? getParagraphText(paragraphs[i + 1]) : '';
+        const name = deriveDeterministicJrParaName({
+            paragraph: p,
+            prevText,
+            nextText,
+            usedNames,
+        });
+        const start = doc.createElementNS(OOXML.W_NS, 'w:bookmarkStart');
+        start.setAttributeNS(OOXML.W_NS, 'w:id', String(numericId));
+        start.setAttributeNS(OOXML.W_NS, 'w:name', name);
+        const end = doc.createElementNS(OOXML.W_NS, 'w:bookmarkEnd');
+        end.setAttributeNS(OOXML.W_NS, 'w:id', String(numericId));
+        parent.insertBefore(start, p);
+        parent.insertBefore(end, p.nextSibling);
+    }
+    return { indexedParagraphs: paragraphs.length };
+}
+export function insertSingleParagraphBookmark(doc, p) {
+    const parent = p.parentNode;
+    if (!parent)
+        throw new Error('Paragraph has no parent');
+    const paragraphs = Array.from(doc.getElementsByTagNameNS(OOXML.W_NS, W.p));
+    const idx = paragraphs.indexOf(p);
+    const prevText = idx > 0 ? getParagraphText(paragraphs[idx - 1]) : '';
+    const nextText = idx >= 0 && idx + 1 < paragraphs.length ? getParagraphText(paragraphs[idx + 1]) : '';
+    const usedNames = collectUsedJrParaNames(doc);
+    let maxNumeric = 0;
+    const existingStarts = Array.from(doc.getElementsByTagNameNS(OOXML.W_NS, W.bookmarkStart));
+    for (const s of existingStarts) {
+        const n = getAttr(s, 'id');
+        const val = n ? Number.parseInt(n, 10) : NaN;
+        if (!Number.isNaN(val))
+            maxNumeric = Math.max(maxNumeric, val);
+    }
+    const numericId = maxNumeric + 1;
+    const name = deriveDeterministicJrParaName({
+        paragraph: p,
+        prevText,
+        nextText,
+        usedNames,
+    });
+    const start = doc.createElementNS(OOXML.W_NS, 'w:bookmarkStart');
+    start.setAttributeNS(OOXML.W_NS, 'w:id', String(numericId));
+    start.setAttributeNS(OOXML.W_NS, 'w:name', name);
+    const end = doc.createElementNS(OOXML.W_NS, 'w:bookmarkEnd');
+    end.setAttributeNS(OOXML.W_NS, 'w:id', String(numericId));
+    parent.insertBefore(start, p);
+    parent.insertBefore(end, p.nextSibling);
+    return name;
+}
+export function findParagraphByBookmarkId(doc, bookmarkId) {
+    const paragraphs = Array.from(doc.getElementsByTagNameNS(OOXML.W_NS, W.p));
+    for (const p of paragraphs) {
+        if (!isParagraph(p))
+            continue;
+        if (getParagraphBookmarkId(p) === bookmarkId)
+            return p;
+    }
+    return null;
+}
+//# sourceMappingURL=bookmarks.js.map

package/dist/primitives/bookmarks.js.map

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

package/dist/primitives/comments.d.ts

@@ -0,0 +1,88 @@
+/**
+ * comments — OOXML comment insertion, threaded replies, and part bootstrapping.
+ *
+ * Creates comment XML parts when missing, inserts comment range markers,
+ * and supports threaded replies via commentsExtended.xml.
+ */
+import { DocxZip } from './zip.js';
+export type BootstrapResult = {
+    partsCreated: string[];
+};
+/**
+ * Create missing comment XML parts when a DOCX has no comment infrastructure.
+ * Idempotent — skips parts that already exist.
+ */
+export declare function bootstrapCommentParts(zip: DocxZip): Promise<BootstrapResult>;
+export type AddCommentParams = {
+    paragraphEl: Element;
+    start: number;
+    end: number;
+    author: string;
+    text: string;
+    initials?: string;
+};
+export type AddCommentResult = {
+    commentId: number;
+};
+/**
+ * Insert a root comment anchored to a text range within a paragraph.
+ *
+ * - Allocates next comment ID from existing comments.xml
+ * - Inserts commentRangeStart/commentRangeEnd markers in document body
+ * - Inserts commentReference run after range end
+ * - Adds comment entry to comments.xml
+ * - Adds author to people.xml if not present
+ */
+export declare function addComment(documentXml: Document, zip: DocxZip, params: AddCommentParams): Promise<AddCommentResult>;
+export type AddCommentReplyParams = {
+    parentCommentId: number;
+    author: string;
+    text: string;
+    initials?: string;
+};
+export type AddCommentReplyResult = {
+    commentId: number;
+    parentCommentId: number;
+};
+/**
+ * Add a threaded reply to an existing comment.
+ *
+ * Replies don't have range markers in the document body.
+ * Thread linkage is stored in commentsExtended.xml via paraIdParent.
+ */
+export declare function addCommentReply(_documentXml: Document, zip: DocxZip, params: AddCommentReplyParams): Promise<AddCommentReplyResult>;
+export type Comment = {
+    id: number;
+    author: string;
+    date: string;
+    initials: string;
+    text: string;
+    paragraphId: string | null;
+    anchoredParagraphId: string | null;
+    replies: Comment[];
+};
+/**
+ * Read all comments from a document, building a threaded tree.
+ *
+ * Root comments are returned at the top level; replies are nested under
+ * their parent's `replies` array. Thread linkage is resolved via
+ * commentsExtended.xml paraIdParent relationships.
+ */
+export declare function getComments(zip: DocxZip, documentXml: Document): Promise<Comment[]>;
+/**
+ * Get a single comment by ID, searching the full tree including replies.
+ */
+export declare function getComment(zip: DocxZip, documentXml: Document, commentId: number): Promise<Comment | null>;
+/**
+ * Delete a comment and all its descendants from the document.
+ *
+ * - Removes comment elements from comments.xml
+ * - Removes commentEx entries from commentsExtended.xml (if present)
+ * - For root comments: removes commentRangeStart, commentRangeEnd, and
+ *   commentReference from document.xml (element-level; run removed only if empty)
+ * - Transitive cascade: deleting any node also deletes all descendants
+ */
+export declare function deleteComment(documentXml: Document, zip: DocxZip, params: {
+    commentId: number;
+}): Promise<void>;
+//# sourceMappingURL=comments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/primitives/comments.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AA+CnC,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CA0BlF;AA2FD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,QAAQ,EACrB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CA4B3B;AAID,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,QAAQ,EACtB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAmChC;AA2MD,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAgHzF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAGhH;AAaD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,QAAQ,EACrB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAoGf"}