@usejunior/docx-core 0.0.1 → 0.1.1

package/dist/primitives/extract_revisions.js

@@ -0,0 +1,340 @@
+/**
+ * extract_revisions — walk tracked-change markup in a document body and
+ * return structured per-paragraph revision records with before/after text.
+ *
+ * Algorithm:
+ * 1. Clone DOM twice → acceptChanges() on one, rejectChanges() on the other
+ * 2. Walk all w:p in the *original* tracked DOM (including inside w:tc table cells)
+ * 3. For each paragraph with revision wrappers, look up before_text (rejected clone)
+ *    and after_text (accepted clone) by _bk_* bookmark ID
+ * 4. Collect individual revision entries with type, text, author
+ * 5. Join comments by anchoredParagraphId
+ * 6. Apply offset/limit pagination
+ */
+import { OOXML } from './namespaces.js';
+import { acceptChanges } from './accept_changes.js';
+import { rejectChanges } from './reject_changes.js';
+import { getParagraphText } from './text.js';
+import { getParagraphBookmarkId, findParagraphByBookmarkId } from './bookmarks.js';
+const W_NS = OOXML.W_NS;
+// ── Internal helpers ────────────────────────────────────────────────
+function isW(node, localName) {
+    return (node.nodeType === 1 &&
+        node.namespaceURI === W_NS &&
+        node.localName === localName);
+}
+// Revision wrapper local names
+const REVISION_WRAPPER_LOCALS = new Set(['ins', 'del', 'moveFrom', 'moveTo']);
+// Property change local names
+const PR_CHANGE_LOCALS = new Set([
+    'rPrChange', 'pPrChange', 'sectPrChange',
+    'tblPrChange', 'trPrChange', 'tcPrChange',
+]);
+/**
+ * Check if a paragraph is entirely inserted (all content is inside w:ins).
+ * Such paragraphs have no "before" state — they didn't exist before the edit.
+ */
+function paragraphIsEntirelyInserted(p) {
+    // Check for paragraph-level insertion marker: w:pPr > w:rPr > w:ins
+    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++) {
+            if (!isW(child.childNodes[j], 'rPr'))
+                continue;
+            for (let k = 0; k < child.childNodes[j].childNodes.length; k++) {
+                if (isW(child.childNodes[j].childNodes[k], 'ins'))
+                    return true;
+            }
+        }
+    }
+    // Check if all content-bearing children are inside w:ins
+    let hasContent = false;
+    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 (local === 'pPr' || local === 'bookmarkStart' || local === 'bookmarkEnd')
+            continue;
+        if (local === 'ins' || local === 'moveTo') {
+            hasContent = true;
+            continue;
+        }
+        // Any content outside ins/moveTo means not entirely inserted
+        if (local === 'r' || local === 'del' || local === 'moveFrom')
+            return false;
+    }
+    return hasContent;
+}
+/**
+ * Check if a paragraph is entirely deleted (all content is inside w:del).
+ * Such paragraphs have no "after" state — they were fully removed.
+ */
+function paragraphIsEntirelyDeleted(p) {
+    // Check for paragraph-level deletion marker: w:pPr > w:rPr > w:del
+    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++) {
+            if (!isW(child.childNodes[j], 'rPr'))
+                continue;
+            for (let k = 0; k < child.childNodes[j].childNodes.length; k++) {
+                if (isW(child.childNodes[j].childNodes[k], 'del'))
+                    return true;
+            }
+        }
+    }
+    // Check if all content-bearing children are inside w:del
+    let hasContent = false;
+    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 (local === 'pPr' || local === 'bookmarkStart' || local === 'bookmarkEnd')
+            continue;
+        if (local === 'del' || local === 'moveFrom') {
+            hasContent = true;
+            continue;
+        }
+        // Any content outside del/moveFrom means not entirely deleted
+        if (local === 'r' || local === 'ins' || local === 'moveTo')
+            return false;
+    }
+    return hasContent;
+}
+/**
+ * Check if a paragraph contains any revision wrappers or property change records.
+ */
+function paragraphHasRevisions(p) {
+    // Check for revision wrappers (w:ins, w:del, w:moveFrom, w:moveTo)
+    for (const local of REVISION_WRAPPER_LOCALS) {
+        if (p.getElementsByTagNameNS(W_NS, local).length > 0)
+            return true;
+    }
+    // Check for property change records
+    for (const local of PR_CHANGE_LOCALS) {
+        if (p.getElementsByTagNameNS(W_NS, local).length > 0)
+            return true;
+    }
+    return false;
+}
+/**
+ * Extract text content from an element's w:t and w:delText children (recursive through runs).
+ */
+function getRevisionText(el) {
+    const parts = [];
+    const ts = el.getElementsByTagNameNS(W_NS, 't');
+    for (let i = 0; i < ts.length; i++) {
+        parts.push(ts[i].textContent ?? '');
+    }
+    const delTs = el.getElementsByTagNameNS(W_NS, 'delText');
+    for (let i = 0; i < delTs.length; i++) {
+        parts.push(delTs[i].textContent ?? '');
+    }
+    return parts.join('');
+}
+function getAttr(el, localName) {
+    return el.getAttributeNS(W_NS, localName) ?? el.getAttribute(`w:${localName}`) ?? '';
+}
+/**
+ * Collect individual revision entries from a paragraph's revision wrappers.
+ */
+function collectRevisionEntries(p) {
+    const entries = [];
+    // Collect from w:ins wrappers
+    const insEls = p.getElementsByTagNameNS(W_NS, 'ins');
+    for (let i = 0; i < insEls.length; i++) {
+        const ins = insEls[i];
+        // Skip paragraph-level markers (inside pPr/rPr)
+        if (isInsidePPrOrRPr(ins, p))
+            continue;
+        entries.push({
+            type: 'INSERTION',
+            text: getRevisionText(ins),
+            author: getAttr(ins, 'author'),
+        });
+    }
+    // Collect from w:del wrappers
+    const delEls = p.getElementsByTagNameNS(W_NS, 'del');
+    for (let i = 0; i < delEls.length; i++) {
+        const del = delEls[i];
+        if (isInsidePPrOrRPr(del, p))
+            continue;
+        entries.push({
+            type: 'DELETION',
+            text: getRevisionText(del),
+            author: getAttr(del, 'author'),
+        });
+    }
+    // Collect from w:moveFrom wrappers
+    const moveFromEls = p.getElementsByTagNameNS(W_NS, 'moveFrom');
+    for (let i = 0; i < moveFromEls.length; i++) {
+        const mf = moveFromEls[i];
+        entries.push({
+            type: 'MOVE_FROM',
+            text: getRevisionText(mf),
+            author: getAttr(mf, 'author'),
+        });
+    }
+    // Collect from w:moveTo wrappers
+    const moveToEls = p.getElementsByTagNameNS(W_NS, 'moveTo');
+    for (let i = 0; i < moveToEls.length; i++) {
+        const mt = moveToEls[i];
+        entries.push({
+            type: 'MOVE_TO',
+            text: getRevisionText(mt),
+            author: getAttr(mt, 'author'),
+        });
+    }
+    // Collect FORMAT_CHANGE from *PrChange records
+    for (const localName of PR_CHANGE_LOCALS) {
+        const changes = p.getElementsByTagNameNS(W_NS, localName);
+        for (let i = 0; i < changes.length; i++) {
+            const change = changes[i];
+            entries.push({
+                type: 'FORMAT_CHANGE',
+                text: '',
+                author: getAttr(change, 'author'),
+            });
+        }
+    }
+    return entries;
+}
+/**
+ * Check if an element is nested inside w:pPr or w:rPr within the given paragraph.
+ * These are paragraph-level revision markers, not content revisions.
+ */
+function isInsidePPrOrRPr(el, paragraph) {
+    let cur = el.parentNode;
+    while (cur && cur !== paragraph) {
+        if (cur.nodeType === 1) {
+            const cel = cur;
+            if (cel.namespaceURI === W_NS && cel.localName === 'pPr')
+                return true;
+            const parent = cel.parentNode;
+            if (cel.namespaceURI === W_NS && cel.localName === 'rPr' &&
+                parent && parent.namespaceURI === W_NS && parent.localName === 'pPr') {
+                return true;
+            }
+        }
+        cur = cur.parentNode;
+    }
+    return false;
+}
+/**
+ * Convert a Comment (from getComments()) to a RevisionComment.
+ */
+function commentToRevisionComment(c) {
+    const rc = {
+        author: c.author,
+        text: c.text,
+        date: c.date || null,
+    };
+    if (c.replies.length > 0) {
+        rc.replies = c.replies.map(commentToRevisionComment);
+    }
+    return rc;
+}
+// ── Public API ──────────────────────────────────────────────────────
+/**
+ * Extract structured revision data from a document with tracked changes.
+ *
+ * @param doc - The original document DOM with tracked changes
+ * @param comments - Comments from getComments() (with anchoredParagraphId resolved)
+ * @param opts - Pagination options: offset (0-based) and limit
+ */
+export function extractRevisions(doc, comments, opts) {
+    const body = doc.getElementsByTagNameNS(W_NS, 'body').item(0);
+    if (!body) {
+        return { changes: [], total_changes: 0, has_more: false };
+    }
+    // Clone DOM twice and apply accept/reject
+    const acceptedDoc = doc.cloneNode(true);
+    const rejectedDoc = doc.cloneNode(true);
+    acceptChanges(acceptedDoc);
+    rejectChanges(rejectedDoc);
+    // Build comment lookup by anchoredParagraphId
+    const commentsByParaId = new Map();
+    for (const c of comments) {
+        if (c.anchoredParagraphId) {
+            const existing = commentsByParaId.get(c.anchoredParagraphId);
+            if (existing) {
+                existing.push(c);
+            }
+            else {
+                commentsByParaId.set(c.anchoredParagraphId, [c]);
+            }
+        }
+    }
+    // Walk all paragraphs in the original tracked DOM
+    const allParagraphs = Array.from(body.getElementsByTagNameNS(W_NS, 'p'));
+    const changedParagraphs = [];
+    for (const p of allParagraphs) {
+        if (!paragraphHasRevisions(p))
+            continue;
+        const paraId = getParagraphBookmarkId(p);
+        if (!paraId)
+            continue; // All paragraphs should have bookmarks from session resolution
+        // Detect entirely-inserted/deleted paragraphs to avoid stale bookmark lookups.
+        // When rejectChanges() removes an inserted paragraph, it relocates bookmarks
+        // to adjacent paragraphs, which would give the wrong before_text.
+        const isFullyInserted = paragraphIsEntirelyInserted(p);
+        const isFullyDeleted = paragraphIsEntirelyDeleted(p);
+        // Look up before_text in rejected clone by bookmark
+        let beforeText;
+        if (isFullyInserted) {
+            beforeText = ''; // Didn't exist before
+        }
+        else {
+            const rejectedP = findParagraphByBookmarkId(rejectedDoc, paraId);
+            beforeText = rejectedP ? getParagraphText(rejectedP) : '';
+        }
+        // Look up after_text in accepted clone by bookmark
+        let afterText;
+        if (isFullyDeleted) {
+            afterText = ''; // Doesn't exist after
+        }
+        else {
+            const acceptedP = findParagraphByBookmarkId(acceptedDoc, paraId);
+            afterText = acceptedP ? getParagraphText(acceptedP) : '';
+        }
+        // Collect revision entries
+        const revisions = collectRevisionEntries(p);
+        // Skip structurally-empty paragraphs with only paragraph-level markers
+        // (e.g. empty inserted paragraphs from comparison engines with pPr/rPr/ins only)
+        if (revisions.length === 0 && beforeText === '' && afterText === '')
+            continue;
+        // Associate comments
+        const paraComments = commentsByParaId.get(paraId) ?? [];
+        const revisionComments = paraComments.map(commentToRevisionComment);
+        changedParagraphs.push({
+            para_id: paraId,
+            before_text: beforeText,
+            after_text: afterText,
+            revisions,
+            comments: revisionComments,
+        });
+    }
+    // Apply pagination
+    const totalChanges = changedParagraphs.length;
+    const offset = opts?.offset ?? 0;
+    const limit = opts?.limit ?? totalChanges;
+    const page = changedParagraphs.slice(offset, offset + limit);
+    const hasMore = offset + limit < totalChanges;
+    return {
+        changes: page,
+        total_changes: totalChanges,
+        has_more: hasMore,
+    };
+}
+//# sourceMappingURL=extract_revisions.js.map

package/dist/primitives/extract_revisions.js.map

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

package/dist/primitives/footnotes.d.ts

@@ -0,0 +1,37 @@
+/**
+ * footnotes — OOXML footnote bootstrapping, CRUD, and display numbering.
+ *
+ * Creates footnote XML parts when missing, inserts footnote reference runs,
+ * and supports reading, updating, and deleting footnotes.
+ */
+import { DocxZip } from './zip.js';
+export type Footnote = {
+    id: number;
+    displayNumber: number;
+    text: string;
+    anchoredParagraphId: string | null;
+};
+export type AddFootnoteParams = {
+    paragraphEl: Element;
+    afterText?: string;
+    text: string;
+};
+export type AddFootnoteResult = {
+    noteId: number;
+};
+export type BootstrapFootnoteResult = {
+    partsCreated: string[];
+};
+export declare function isReservedFootnote(footnoteEl: Element): boolean;
+export declare function bootstrapFootnoteParts(zip: DocxZip): Promise<BootstrapFootnoteResult>;
+export declare function getFootnotes(zip: DocxZip, documentXml: Document): Promise<Footnote[]>;
+export declare function getFootnote(zip: DocxZip, documentXml: Document, noteId: number): Promise<Footnote | null>;
+export declare function addFootnote(documentXml: Document, zip: DocxZip, params: AddFootnoteParams): Promise<AddFootnoteResult>;
+export declare function updateFootnoteText(zip: DocxZip, params: {
+    noteId: number;
+    newText: string;
+}): Promise<void>;
+export declare function deleteFootnote(documentXml: Document, zip: DocxZip, params: {
+    noteId: number;
+}): Promise<void>;
+//# sourceMappingURL=footnotes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"footnotes.d.ts","sourceRoot":"","sources":["../../src/primitives/footnotes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AA0BnC,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAQF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAG/D;AAID,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAiB3F;AAmID,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAqD3F;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAG/G;AAgCD,wBAAsB,WAAW,CAC/B,WAAW,EAAE,QAAQ,EACrB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAkB5B;AAuOD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,IAAI,CAAC,CAmDf;AAID,wBAAsB,cAAc,CAClC,WAAW,EAAE,QAAQ,EACrB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CAsCf"}