@usejunior/docx-core 0.9.0 → 0.10.0

package/dist/integration/libreoffice-oracle.js

@@ -0,0 +1,282 @@
+/**
+ * LibreOffice accept/reject oracle — a committed, reproducible reference voter.
+ *
+ * Drives LibreOffice headless as a track-changes accept/reject implementation so the
+ * production engine's paragraph-collapse behavior (the G3/G4/G5 differential cases) can be
+ * validated against a real word processor, not just Lean↔TS self-consistency. LibreOffice is
+ * the native engine for the .uno:AcceptAllTrackedChanges / .uno:RejectAllTrackedChanges
+ * dispatches, so its paragraph-structure output is authoritative ground truth for the
+ * mark-based rule (an untracked paragraph mark is kept on accept/reject; a PPR-INS/PPR-DEL mark
+ * is dropped).
+ *
+ * Mechanism (macOS-portable; also works on Linux): pyuno from a terminal is blocked on macOS by
+ * Launch Constraints, so this injects a Basic macro into a throwaway user profile and invokes it
+ * with a bare `macro:///` URL. The order matters — a fresh profile regenerates the Standard Basic
+ * library on first launch, clobbering any hand-placed Module1.xba — so we (1) init the profile via
+ * a throwaway convert, (2) THEN overwrite Module1.xba, (3) THEN run the macro. See
+ * reference_libreoffice_macos_oracle.
+ *
+ * This module is gated by callers: when `resolveSoffice()` returns null the oracle is skipped.
+ * CI does not install LibreOffice, so the oracle voter is a local developer check.
+ */
+import { execFile } from 'node:child_process';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { promisify } from 'node:util';
+import { createZipBuffer, readZipText } from '../primitives/zip.js';
+import { parseXml } from '../primitives/xml.js';
+const execFileAsync = promisify(execFile);
+const W_NS = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** Run soffice, capturing stdout/stderr; never throws (the macro terminates the desktop, so a
+ *  nonzero exit is expected). */
+async function runSoffice(soffice, args, timeout) {
+    try {
+        const r = await execFileAsync(soffice, args, { timeout, killSignal: 'SIGKILL', maxBuffer: 8 * 1024 * 1024 });
+        return { stdout: String(r.stdout ?? ''), stderr: String(r.stderr ?? '') };
+    }
+    catch (err) {
+        const e = err;
+        return { stdout: String(e.stdout ?? ''), stderr: String(e.stderr ?? e.message ?? '') };
+    }
+}
+/**
+ * LibreOffice's single-instance model forwards a new `soffice` invocation to an existing instance
+ * that shares the same UserInstallation — so the init-convert process MUST be fully gone before the
+ * macro launch, or the `macro:///` command is delivered to the dying init instance (which has no
+ * Module1 yet) and never runs. The instance lock is `<profile>/.lock`. LibreOffice often leaves a
+ * STALE lock after `--convert-to` exits, so we wait a short bounded window for it to self-clear and
+ * then remove it unconditionally; the macro launch's own retry backstops a slow init exit.
+ */
+async function settleProfile(profile, timeoutMs = 1_500) {
+    const lock = path.join(profile, '.lock');
+    const deadline = Date.now() + timeoutMs;
+    while (existsSync(lock) && Date.now() < deadline)
+        await sleep(150);
+    if (existsSync(lock)) {
+        try {
+            rmSync(lock, { force: true });
+        }
+        catch { /* best effort — fresh launch will relock */ }
+    }
+}
+/** Resolve a LibreOffice binary, or null if none is available (callers skip the oracle). */
+export function resolveSoffice() {
+    const candidates = [
+        process.env.SAFE_DOCX_SOFFICE_BIN,
+        process.env.ODF_SOFFICE_BIN,
+        '/opt/homebrew/bin/soffice',
+        '/usr/bin/soffice',
+        '/usr/local/bin/soffice',
+        '/Applications/LibreOffice.app/Contents/MacOS/soffice',
+    ].filter(Boolean);
+    return candidates.find((c) => existsSync(c)) ?? null;
+}
+const CONTENT_TYPES = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">
+ <Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>
+ <Default Extension="xml" ContentType="application/xml"/>
+ <Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/>
+</Types>`;
+const RELS = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
+ <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="word/document.xml"/>
+</Relationships>`;
+const DOC_RELS = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"/>`;
+/** Pack a bare `word/document.xml` string into a minimal valid .docx package. */
+export async function packMinimalDocx(documentXml) {
+    return createZipBuffer({
+        '[Content_Types].xml': CONTENT_TYPES,
+        '_rels/.rels': RELS,
+        'word/_rels/document.xml.rels': DOC_RELS,
+        'word/document.xml': documentXml,
+    });
+}
+/** Read `word/document.xml` back out of a .docx package. */
+export async function extractDocumentXml(docx) {
+    const xml = await readZipText(docx, 'word/document.xml');
+    if (xml == null)
+        throw new Error('word/document.xml not found in oracle output');
+    return xml;
+}
+const SCRIPT_XLC = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE library:libraries PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "libraries.dtd">
+<library:libraries xmlns:library="http://openoffice.org/2000/library" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <library:library library:name="Standard" xlink:href="$(USER)/basic/Standard/script.xlb/" xlink:type="simple" library:link="false"/>
+</library:libraries>`;
+const SCRIPT_XLB = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE library:library PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "library.dtd">
+<library:library xmlns:library="http://openoffice.org/2000/library" library:name="Standard" library:readonly="false" library:passwordprotected="false">
+ <library:element library:name="Module1"/>
+</library:library>`;
+const REGMOD = `<?xml version="1.0" encoding="UTF-8"?>
+<oor:items xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+ <item oor:path="/org.openoffice.Office.Common/Security/Scripting"><prop oor:name="MacroSecurityLevel" oor:op="fuse"><value>0</value></prop></item>
+ <item oor:path="/org.openoffice.Office.Common/Misc"><prop oor:name="FirstRun" oor:op="fuse"><value>false</value></prop></item>
+</oor:items>`;
+/** The Basic macro: load each doc Hidden, dispatch accept/reject-all (or, for `identity`,
+ *  dispatch nothing at all), save with the job's filter. */
+function module1Xba(jobsPath, markerPath) {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE script:module PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "module.dtd">
+<script:module xmlns:script="http://openoffice.org/2000/script" script:name="Module1" script:language="StarBasic">
+Sub RunOracle
+  Dim iFile As Integer, sLine As String, parts() As String, m As Integer
+  m = FreeFile : Open "${markerPath}" For Output As #m : Print #m, "started" : Close #m
+  iFile = FreeFile
+  Open "${jobsPath}" For Input As #iFile
+  Do While Not EOF(iFile)
+    Line Input #iFile, sLine
+    If Len(Trim(sLine)) &gt; 0 Then
+      parts = Split(sLine, "|")
+      ProcessOne(parts(0), ConvertToURL(parts(1)), ConvertToURL(parts(2)), parts(3))
+    End If
+  Loop
+  Close #iFile
+  StarDesktop.terminate()
+End Sub
+
+Sub ProcessOne(op As String, inUrl As String, outUrl As String, filterName As String)
+  Dim oDoc As Object, oFrame As Object, oDisp As Object
+  Dim loadArgs(0) As New com.sun.star.beans.PropertyValue
+  loadArgs(0).Name = "Hidden" : loadArgs(0).Value = True
+  oDoc = StarDesktop.loadComponentFromURL(inUrl, "_blank", 0, loadArgs())
+  oFrame = oDoc.getCurrentController().getFrame()
+  oDisp = createUnoService("com.sun.star.frame.DispatchHelper")
+  Dim noArgs()
+  If op = "accept" Then
+    oDisp.executeDispatch(oFrame, ".uno:AcceptAllTrackedChanges", "", 0, noArgs())
+  ElseIf op = "reject" Then
+    oDisp.executeDispatch(oFrame, ".uno:RejectAllTrackedChanges", "", 0, noArgs())
+  End If
+  ' op = "identity": no dispatch — a plain load-&gt;save, exposing LibreOffice's own DOCX
+  ' import/export of UNRESOLVED tracked changes (the oracle trust-boundary check).
+  Dim saveArgs(0) As New com.sun.star.beans.PropertyValue
+  saveArgs(0).Name = "FilterName" : saveArgs(0).Value = filterName
+  oDoc.storeToURL(outUrl, saveArgs())
+  oDoc.close(False)
+End Sub
+</script:module>`;
+}
+function isOdtJob(job) {
+    return 'odt' in job;
+}
+/**
+ * Run LibreOffice over a batch of jobs in ONE headless launch and return each job's resulting
+ * main XML part — `word/document.xml` for DOCX jobs, `content.xml` for ODT jobs. Throws if the
+ * binary is missing or the macro did not run.
+ */
+export async function runLibreOfficeOracle(jobs, soffice = resolveSoffice()) {
+    if (!soffice)
+        throw new Error('runLibreOfficeOracle: no soffice binary (call resolveSoffice() and skip)');
+    if (jobs.length === 0)
+        return [];
+    const work = mkdtempSync(path.join(os.tmpdir(), 'lo-oracle-'));
+    const profile = path.join(work, 'profile');
+    const userDir = path.join(profile, 'user');
+    const basicDir = path.join(userDir, 'basic', 'Standard');
+    const inDir = path.join(work, 'in');
+    const outDir = path.join(work, 'out');
+    const marker = path.join(work, 'macro_ran.txt');
+    const jobsPath = path.join(work, 'jobs.txt');
+    const profileUrl = pathToFileURL(profile).href;
+    let keepWork = false;
+    try {
+        for (const d of [userDir, basicDir, inDir, outDir])
+            mkdirSync(d, { recursive: true });
+        // Write each job's input package and build the jobs file (op|inPath|outPath|filter).
+        const outPaths = [];
+        const jobLines = [];
+        for (let i = 0; i < jobs.length; i++) {
+            const job = jobs[i];
+            const ext = isOdtJob(job) ? 'odt' : 'docx';
+            const filter = isOdtJob(job) ? 'writer8' : 'MS Word 2007 XML';
+            const inPath = path.join(inDir, `job${i}.${ext}`);
+            const outPath = path.join(outDir, `job${i}.${ext}`);
+            writeFileSync(inPath, isOdtJob(job) ? new Uint8Array(job.odt) : new Uint8Array(await packMinimalDocx(job.documentXml)));
+            outPaths.push(outPath);
+            jobLines.push(`${job.op}|${inPath}|${outPath}|${filter}`);
+        }
+        writeFileSync(jobsPath, jobLines.join('\n') + '\n');
+        // Macro security level 0 so the Standard-library macro runs headless.
+        writeFileSync(path.join(userDir, 'registrymodifications.xcu'), REGMOD);
+        const baseArgs = ['--headless', '--norestore', '--nologo', `-env:UserInstallation=${profileUrl}`];
+        const diag = [];
+        // (1) INIT the profile: a throwaway convert makes soffice populate user/basic/Standard
+        // (which would otherwise clobber a pre-placed Module1.xba on first real launch).
+        const init = await runSoffice(soffice, [...baseArgs, '--convert-to', 'txt', '--outdir', path.join(work, 'init'), path.join(inDir, 'job0.docx')], 20_000);
+        diag.push(`[init] ${(init.stderr || init.stdout || '(no output)').trim()}`);
+        // (2) Overwrite the Basic library with our macro.
+        mkdirSync(basicDir, { recursive: true });
+        writeFileSync(path.join(userDir, 'basic', 'script.xlc'), SCRIPT_XLC);
+        writeFileSync(path.join(basicDir, 'script.xlb'), SCRIPT_XLB);
+        writeFileSync(path.join(basicDir, 'Module1.xba'), module1Xba(jobsPath, marker));
+        // (3) Run the macro via a bare macro:/// URL — but only once the init instance has fully
+        // released the profile, so LibreOffice's single-instance model can't forward our macro command
+        // to the dying init process. Retry once: the first macro launch can still race a slow init exit.
+        for (let attempt = 1; attempt <= 2 && !existsSync(marker); attempt++) {
+            await settleProfile(profile);
+            const run = await runSoffice(soffice, [...baseArgs, 'macro:///Standard.Module1.RunOracle'], 45_000);
+            diag.push(`[macro attempt ${attempt}] ${(run.stderr || run.stdout || '(no output)').trim()}`);
+            if (!existsSync(marker))
+                await sleep(400);
+        }
+        if (!existsSync(marker)) {
+            keepWork = Boolean(process.env.SAFE_DOCX_ORACLE_DEBUG);
+            throw new Error('LibreOffice oracle macro did not run (no marker file) after 2 attempts.\nsoffice output:\n' +
+                diag.join('\n') +
+                (keepWork ? `\n(profile kept for debugging at ${work})` : ' (set SAFE_DOCX_ORACLE_DEBUG=1 to keep the profile)'));
+        }
+        return Promise.all(outPaths.map(async (p, i) => {
+            if (!existsSync(p))
+                throw new Error(`LibreOffice oracle produced no output for ${path.basename(p)}`);
+            if (isOdtJob(jobs[i])) {
+                const contentXml = await readZipText(readFileSync(p), 'content.xml');
+                if (contentXml == null)
+                    throw new Error(`content.xml not found in oracle output ${path.basename(p)}`);
+                return contentXml;
+            }
+            return extractDocumentXml(readFileSync(p));
+        }));
+    }
+    finally {
+        if (!keepWork)
+            rmSync(work, { recursive: true, force: true });
+    }
+}
+/**
+ * Structural projection of a `word/document.xml`: one entry per top-level body paragraph,
+ * recording whether it carries visible text (a non-whitespace `w:t` descendant). This captures
+ * the paragraph-collapse claim the oracle is authoritative for — how many paragraphs survive and
+ * which collapsed to empty — without depending on revision-markup or formatting details (which
+ * LibreOffice rewrites). `[]`-length is the paragraph count.
+ */
+export function paragraphShape(documentXml) {
+    const doc = parseXml(documentXml);
+    const body = doc.getElementsByTagNameNS(W_NS, 'body').item(0) ?? doc.documentElement;
+    if (!body)
+        return [];
+    const shape = [];
+    for (let i = 0; i < body.childNodes.length; i++) {
+        const node = body.childNodes[i];
+        if (node.nodeType !== 1)
+            continue;
+        const el = node;
+        if (el.namespaceURI !== W_NS || el.localName !== 'p')
+            continue; // skip w:sectPr etc.
+        const texts = el.getElementsByTagNameNS(W_NS, 't');
+        let hasText = false;
+        for (let j = 0; j < texts.length; j++) {
+            if ((texts.item(j).textContent ?? '').trim().length > 0) {
+                hasText = true;
+                break;
+            }
+        }
+        shape.push(hasText);
+    }
+    return shape;
+}
+//# sourceMappingURL=libreoffice-oracle.js.map

package/dist/integration/libreoffice-oracle.js.map

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

package/dist/integration/synthetic-docx-fixture.d.ts

@@ -0,0 +1,62 @@
+export interface SyntheticDocxOptions {
+    paragraphs: string[];
+    footnoteOnParagraph?: number;
+    footnoteText?: string;
+    commentOnParagraph?: number;
+    commentText?: string;
+    commentAuthor?: string;
+    commentAncillaryParts?: boolean;
+    /**
+     * Threaded reply to the root comment (w:id="1"). Emits a second
+     * <w:comment w:id="2"> with paraId 00000002 and, when commentAncillaryParts
+     * is also set, a <w15:commentEx w15:paraIdParent="00000001"> linkage and a
+     * second <w15:person> for the reply author. Reply comments deliberately
+     * have NO <w:commentReference> in document.xml — that's the issue #108
+     * shape: replies are discoverable only via paraIdParent threading.
+     */
+    replyText?: string;
+    replyAuthor?: string;
+    /**
+     * Cross-paragraph comment span. The comment opens at the start of
+     * paragraphs[start] and closes at the end of paragraphs[end]. The
+     * commentReference run is appended to paragraphs[end].
+     *
+     * Mutually exclusive with commentOnParagraph.
+     */
+    commentSpanParagraphs?: {
+        start: number;
+        end: number;
+    };
+    /**
+     * Bookmark spanning a single paragraph (start and end inside the same w:p).
+     * Used to verify paragraph-internal bookmark preservation through rebuild.
+     */
+    bookmarkOnParagraph?: {
+        paragraph: number;
+        name: string;
+        id?: number;
+    };
+    /**
+     * Body-level (sibling of <w:p>) bookmark inserted between
+     * paragraphs[index - 1] and paragraphs[index]. Used to verify scaffold
+     * markers do not leak into reconstructed paragraphs.
+     */
+    siblingBookmarkBefore?: {
+        index: number;
+        name: string;
+        id?: number;
+    };
+}
+export declare function buildSyntheticDocx(opts: SyntheticDocxOptions): Promise<Buffer>;
+export interface SyntheticResultParts {
+    documentXml: string;
+    footnotesXml: string | null;
+    endnotesXml: string | null;
+    commentsXml: string | null;
+    commentsExtendedXml: string | null;
+    peopleXml: string | null;
+    contentTypesXml: string | null;
+    relsXml: string | null;
+}
+export declare function getResultParts(resultBuffer: Buffer): Promise<SyntheticResultParts>;
+//# sourceMappingURL=synthetic-docx-fixture.d.ts.map

package/dist/integration/synthetic-docx-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic-docx-fixture.d.ts","sourceRoot":"","sources":["../../src/integration/synthetic-docx-fixture.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD;;;OAGG;IACH,mBAAmB,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE;;;;OAIG;IACH,qBAAqB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4MpF;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAYxF"}

package/dist/integration/synthetic-docx-fixture.js

@@ -0,0 +1,171 @@
+import JSZip from 'jszip';
+import { DocxArchive } from '../shared/docx/DocxArchive.js';
+export async function buildSyntheticDocx(opts) {
+    const hasFootnote = opts.footnoteOnParagraph != null;
+    const hasComment = opts.commentOnParagraph != null;
+    const hasCommentSpan = opts.commentSpanParagraphs != null;
+    const hasBookmark = opts.bookmarkOnParagraph != null;
+    const hasSiblingBookmark = opts.siblingBookmarkBefore != null;
+    if (hasComment && hasCommentSpan) {
+        throw new Error('commentOnParagraph and commentSpanParagraphs are mutually exclusive');
+    }
+    const bookmarkId = opts.bookmarkOnParagraph?.id ?? 100;
+    const siblingBookmarkId = opts.siblingBookmarkBefore?.id ?? 200;
+    const spanStart = opts.commentSpanParagraphs?.start;
+    const spanEnd = opts.commentSpanParagraphs?.end;
+    const paragraphParts = opts.paragraphs.map((text, idx) => {
+        const escaped = text
+            .replaceAll('&', '&')
+            .replaceAll('<', '&lt;')
+            .replaceAll('>', '&gt;');
+        let extra = '';
+        if (hasFootnote && idx === opts.footnoteOnParagraph) {
+            extra += `<w:r><w:rPr><w:rStyle w:val="FootnoteReference"/></w:rPr><w:footnoteReference w:id="1"/></w:r>`;
+        }
+        if (hasComment && idx === opts.commentOnParagraph) {
+            extra =
+                `<w:commentRangeStart w:id="1"/>` +
+                    `<w:r><w:t>${escaped}</w:t></w:r>` +
+                    `<w:commentRangeEnd w:id="1"/>` +
+                    `<w:r><w:rPr><w:rStyle w:val="CommentReference"/></w:rPr><w:commentReference w:id="1"/></w:r>`;
+            return `<w:p>${extra}</w:p>`;
+        }
+        if (hasCommentSpan && (idx === spanStart || idx === spanEnd)) {
+            const before = idx === spanStart ? `<w:commentRangeStart w:id="1"/>` : '';
+            const after = idx === spanEnd
+                ? `<w:commentRangeEnd w:id="1"/>` +
+                    `<w:r><w:rPr><w:rStyle w:val="CommentReference"/></w:rPr><w:commentReference w:id="1"/></w:r>`
+                : '';
+            return `<w:p>${before}<w:r><w:t>${escaped}</w:t></w:r>${after}${extra}</w:p>`;
+        }
+        if (hasBookmark && idx === opts.bookmarkOnParagraph.paragraph) {
+            const name = opts.bookmarkOnParagraph.name;
+            return (`<w:p>` +
+                `<w:bookmarkStart w:id="${bookmarkId}" w:name="${name}"/>` +
+                `<w:r><w:t>${escaped}</w:t></w:r>` +
+                `<w:bookmarkEnd w:id="${bookmarkId}"/>` +
+                extra +
+                `</w:p>`);
+        }
+        return `<w:p><w:r><w:t>${escaped}</w:t></w:r>${extra}</w:p>`;
+    });
+    // Inject a body-level (sibling of <w:p>) bookmark before paragraphs[index].
+    // Bookmark*Start*/End placed as sibling of <w:p> per ECMA-376 §17.13.5.
+    if (hasSiblingBookmark) {
+        const { index, name } = opts.siblingBookmarkBefore;
+        const sibling = `<w:bookmarkStart w:id="${siblingBookmarkId}" w:name="${name}"/>` +
+            `<w:bookmarkEnd w:id="${siblingBookmarkId}"/>`;
+        paragraphParts.splice(index, 0, sibling);
+    }
+    const paragraphsXml = paragraphParts.join('\n    ');
+    const documentXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>` +
+        `<w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"` +
+        ` xmlns:w14="http://schemas.microsoft.com/office/word/2010/wordml">` +
+        `<w:body>${paragraphsXml}<w:sectPr/></w:body></w:document>`;
+    const contentTypeParts = [
+        `<Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/>`,
+    ];
+    const docRelEntries = [];
+    let rIdCounter = 1;
+    const zip = new JSZip();
+    if (hasFootnote) {
+        const fnText = opts.footnoteText ?? 'Test footnote';
+        const footnotesXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>` +
+            `<w:footnotes xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">` +
+            `<w:footnote w:type="separator" w:id="-1"><w:p><w:r><w:separator/></w:r></w:p></w:footnote>` +
+            `<w:footnote w:type="continuationSeparator" w:id="0"><w:p><w:r><w:continuationSeparator/></w:r></w:p></w:footnote>` +
+            `<w:footnote w:id="1"><w:p><w:r><w:t>${fnText}</w:t></w:r></w:p></w:footnote>` +
+            `</w:footnotes>`;
+        zip.file('word/footnotes.xml', footnotesXml);
+        contentTypeParts.push(`<Override PartName="/word/footnotes.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.footnotes+xml"/>`);
+        rIdCounter++;
+        docRelEntries.push(`<Relationship Id="rId${rIdCounter}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes" Target="footnotes.xml"/>`);
+    }
+    if (hasComment || hasCommentSpan) {
+        const cText = opts.commentText ?? 'Test comment';
+        const cAuthor = opts.commentAuthor ?? 'Author';
+        const hasReply = opts.replyText != null;
+        const replyAuthor = opts.replyAuthor ?? 'Replier';
+        const replyEntry = hasReply
+            ? `<w:comment w:id="2" w:author="${replyAuthor}" w:date="2025-01-02T00:00:00Z">` +
+                `<w:p w14:paraId="00000002"><w:r><w:t>${opts.replyText}</w:t></w:r></w:p>` +
+                `</w:comment>`
+            : '';
+        const commentsXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>` +
+            `<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"` +
+            ` xmlns:w14="http://schemas.microsoft.com/office/word/2010/wordml">` +
+            `<w:comment w:id="1" w:author="${cAuthor}" w:date="2025-01-01T00:00:00Z">` +
+            `<w:p w14:paraId="00000001"><w:r><w:t>${cText}</w:t></w:r></w:p>` +
+            `</w:comment>` +
+            replyEntry +
+            `</w:comments>`;
+        zip.file('word/comments.xml', commentsXml);
+        contentTypeParts.push(`<Override PartName="/word/comments.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml"/>`);
+        rIdCounter++;
+        docRelEntries.push(`<Relationship Id="rId${rIdCounter}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments" Target="comments.xml"/>`);
+        if (opts.commentAncillaryParts) {
+            const replyExEntry = hasReply
+                ? `<w15:commentEx w15:paraId="00000002" w15:paraIdParent="00000001" w15:done="0"/>`
+                : '';
+            const commentsExtendedXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>` +
+                `<w15:commentsEx xmlns:w15="http://schemas.microsoft.com/office/word/2012/wordml">` +
+                `<w15:commentEx w15:paraId="00000001" w15:done="0"/>` +
+                replyExEntry +
+                `</w15:commentsEx>`;
+            zip.file('word/commentsExtended.xml', commentsExtendedXml);
+            contentTypeParts.push(`<Override PartName="/word/commentsExtended.xml" ContentType="application/vnd.ms-word.commentsExtended+xml"/>`);
+            rIdCounter++;
+            docRelEntries.push(`<Relationship Id="rId${rIdCounter}" Type="http://schemas.microsoft.com/office/2011/relationships/commentsExtended" Target="commentsExtended.xml"/>`);
+            const replyPersonEntry = hasReply
+                ? `<w15:person w15:author="${replyAuthor}">` +
+                    `<w15:presenceInfo w15:providerId="None" w15:userId="${replyAuthor}@example.com"/>` +
+                    `</w15:person>`
+                : '';
+            const peopleXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>` +
+                `<w15:people xmlns:w15="http://schemas.microsoft.com/office/word/2012/wordml"` +
+                ` xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">` +
+                `<w15:person w15:author="${cAuthor}">` +
+                `<w15:presenceInfo w15:providerId="None" w15:userId="${cAuthor}@example.com"/>` +
+                `</w15:person>` +
+                replyPersonEntry +
+                `</w15:people>`;
+            zip.file('word/people.xml', peopleXml);
+            contentTypeParts.push(`<Override PartName="/word/people.xml" ContentType="application/vnd.ms-word.people+xml"/>`);
+            rIdCounter++;
+            docRelEntries.push(`<Relationship Id="rId${rIdCounter}" Type="http://schemas.microsoft.com/office/2011/relationships/people" Target="people.xml"/>`);
+        }
+    }
+    const contentTypesXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>` +
+        `<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">` +
+        `<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>` +
+        `<Default Extension="xml" ContentType="application/xml"/>` +
+        contentTypeParts.join('') +
+        `</Types>`;
+    const rootRelsXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>` +
+        `<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">` +
+        `<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="word/document.xml"/>` +
+        `</Relationships>`;
+    const docRelsXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>` +
+        `<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">` +
+        docRelEntries.join('') +
+        `</Relationships>`;
+    zip.file('[Content_Types].xml', contentTypesXml);
+    zip.file('_rels/.rels', rootRelsXml);
+    zip.file('word/document.xml', documentXml);
+    zip.file('word/_rels/document.xml.rels', docRelsXml);
+    return (await zip.generateAsync({ type: 'nodebuffer' }));
+}
+export async function getResultParts(resultBuffer) {
+    const archive = await DocxArchive.load(resultBuffer);
+    return {
+        documentXml: await archive.getDocumentXml(),
+        footnotesXml: await archive.getFile('word/footnotes.xml'),
+        endnotesXml: await archive.getFile('word/endnotes.xml'),
+        commentsXml: await archive.getFile('word/comments.xml'),
+        commentsExtendedXml: await archive.getFile('word/commentsExtended.xml'),
+        peopleXml: await archive.getFile('word/people.xml'),
+        contentTypesXml: await archive.getFile('[Content_Types].xml'),
+        relsXml: await archive.getFile('word/_rels/document.xml.rels'),
+    };
+}
+//# sourceMappingURL=synthetic-docx-fixture.js.map

package/dist/integration/synthetic-docx-fixture.js.map

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

package/dist/primitives/accept_changes.d.ts

@@ -20,8 +20,8 @@ export type AcceptChangesResult = {
     propertyChangesResolved: number;
 };
 /**
- * Accept all tracked changes in the document body, producing a clean
- * document with no revision markup.
+ * Accept all tracked changes in the document body or story root, producing a
+ * clean document with no revision markup.
  *
  * Mutates the Document in place (same convention as simplifyRedlines
  * and mergeRuns).

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

@@ -1 +1 @@
-{"version":3,"file":"accept_changes.d.ts","sourceRoot":"","sources":["../../src/primitives/accept_changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,MAAM,mBAAmB,GAAG;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AA8IF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,mBAAmB,CA0FhE"}
+{"version":3,"file":"accept_changes.d.ts","sourceRoot":"","sources":["../../src/primitives/accept_changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,MAAM,mBAAmB,GAAG;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC;AAoFF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,mBAAmB,CA4FhE"}