@beyondwork/docx-react-component 1.0.0 → 1.0.1

package/test/io/docx-session.test.ts

@@ -1,1495 +0,0 @@
-import assert from "node:assert/strict";
-import { readFileSync } from "node:fs";
-import test from "node:test";
-
-import type { PersistedEditorSnapshot } from "../../src/api/public-types.ts";
-import { parseTextStory } from "../../src/core/schema/text-schema.ts";
-import { loadDocxEditorSession } from "../../src/io/docx-session.ts";
-import { normalizeParsedTextDocument } from "../../src/io/normalize/normalize-text.ts";
-import { parseMainDocumentXml } from "../../src/io/ooxml/parse-main-document.ts";
-import { writeDocxPackage } from "../../src/io/opc/docx-package.ts";
-import type { OpcPackage } from "../../src/io/opc/package-reader.ts";
-import { readOpcPackage } from "../../src/io/opc/package-reader.ts";
-import { writeOpcPackage } from "../../src/io/opc/package-writer.ts";
-import { assertPersistedEditorSnapshot } from "../../src/model/snapshot.ts";
-import { createDocumentRuntime } from "../../src/runtime/document-runtime.ts";
-
-test("package-backed DOCX sessions import existing comments and revisions into runtime-owned state", () => {
-  const commentSession = loadDocxEditorSession({
-    documentId: "docx-comments",
-    sourceLabel: "commented.docx",
-    bytes: createCommentedDocxPackage(),
-    editorBuild: "test",
-  });
-  const revisionSession = loadDocxEditorSession({
-    documentId: "docx-revisions",
-    sourceLabel: "F11-redlines-basic.docx",
-    bytes: new Uint8Array(readFileSync("test/fixtures/docx/F11-redlines-basic.docx")),
-    editorBuild: "test",
-  });
-
-  assert.equal(commentSession.readOnly, false);
-  assert.equal(revisionSession.readOnly, false);
-  assert.equal(commentSession.fatalError, undefined);
-  assert.equal(revisionSession.fatalError, undefined);
-  assert.ok(
-    Object.keys(
-      (commentSession.initialSnapshot as PersistedEditorSnapshot).canonicalDocument.review.comments,
-    ).length > 0,
-  );
-  assert.ok(
-    Object.keys(
-      (revisionSession.initialSnapshot as PersistedEditorSnapshot).canonicalDocument.review.revisions,
-    ).length > 0,
-  );
-});
-
-test("package-backed DOCX sessions produce persisted snapshots that satisfy the strict model contract", () => {
-  const session = loadDocxEditorSession({
-    documentId: "docx-f01-strict-snapshot",
-    sourceLabel: "F01-basic-contract.docx",
-    bytes: new Uint8Array(readFileSync("test/fixtures/docx/F01-basic-contract.docx")),
-    editorBuild: "test",
-  });
-
-  assert.equal(session.readOnly, false);
-  assert.doesNotThrow(() => {
-    assertPersistedEditorSnapshot(session.initialSnapshot);
-  });
-});
-
-test("diagnostics-mode sessions produce persisted snapshots that satisfy the strict model contract", () => {
-  const session = loadDocxEditorSession({
-    documentId: "docx-broken-strict-snapshot",
-    sourceLabel: "broken.docx",
-    bytes: new Uint8Array([0x00, 0x01, 0x02, 0x03]),
-    editorBuild: "test",
-  });
-
-  assert.equal(session.readOnly, true);
-  assert.doesNotThrow(() => {
-    assertPersistedEditorSnapshot(session.initialSnapshot);
-  });
-});
-
-test("threaded comment fixtures import replies and resolution metadata into one runtime thread", async () => {
-  const session = loadDocxEditorSession({
-    documentId: "docx-f10-threaded-comments",
-    sourceLabel: "F10-threaded-comments-resolve.docx",
-    bytes: new Uint8Array(readFileSync("test/fixtures/docx/F10-threaded-comments-resolve.docx")),
-    editorBuild: "test",
-  });
-  const snapshot = structuredClone(session.initialSnapshot) as PersistedEditorSnapshot;
-  const importedComments = Object.values(snapshot.canonicalDocument.review.comments);
-  const rootThread = importedComments[0];
-
-  assert.equal(session.readOnly, false);
-  assert.equal(session.fatalError, undefined);
-  assert.equal(importedComments.length, 1);
-  assert.equal(rootThread?.status, "resolved");
-  assert.equal(rootThread?.entries?.length, 2);
-  assert.equal(rootThread?.entries?.[0]?.body, "Root comment requesting review.");
-  assert.equal(rootThread?.entries?.[1]?.body, "Reply confirming the change is resolved.");
-  assert.equal(rootThread?.resolution?.resolvedBy, "Reviewer B");
-  assert.equal(rootThread?.metadata?.rootOoxmlCommentId, "0");
-  assert.equal(rootThread?.entries?.[1]?.metadata?.ooxmlCommentId, "1");
-
-  const runtime = createDocumentRuntime({
-    documentId: "runtime-f10-threaded-comments",
-    initialSnapshot: session.initialSnapshot,
-    sourceKind: "docx",
-    sourceLabel: "F10-threaded-comments-resolve.docx",
-    editorBuild: session.initialSnapshot.editorBuild,
-    exportDocx: session.exportDocx,
-  });
-  const runtimeThread = runtime.getRenderSnapshot().comments.threads[0];
-  assert.equal(runtimeThread?.entryCount, 2);
-  assert.equal(runtimeThread?.entries.length, 2);
-  assert.equal(
-    runtimeThread?.entries[1]?.body,
-    "Reply confirming the change is resolved.",
-  );
-
-  if (rootThread?.entries?.[0]) {
-    rootThread.entries[0].body = "Root comment edited after import.";
-  }
-  if (rootThread) {
-    rootThread.body = rootThread.entries?.map((entry) => entry.body).join("\n");
-  }
-  snapshot.updatedAt = "2026-03-27T00:00:00.000Z";
-  snapshot.canonicalDocument.updatedAt = snapshot.updatedAt;
-
-  const result = await session.exportDocx(snapshot, {
-    fileName: "f10-threaded-export.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const exportedCommentsXml = Buffer.from(
-    exportedPackage.parts.get("/word/comments.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-  const exportedCommentsExtendedXml = Buffer.from(
-    exportedPackage.parts.get("/word/commentsExtended.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-  const exportedCommentsIdsXml = Buffer.from(
-    exportedPackage.parts.get("/word/commentsIds.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-  const exportedPeopleXml = Buffer.from(
-    exportedPackage.parts.get("/word/people.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-
-  assert.match(exportedCommentsXml, /Root comment edited after import/);
-  assert.match(exportedCommentsExtendedXml, /w15:done="true"/);
-  assert.match(exportedCommentsExtendedXml, /w15:paraIdParent=/);
-  assert.match(exportedCommentsIdsXml, /durableId=/);
-  assert.match(exportedPeopleXml, /Reviewer A/);
-  assert.match(exportedPeopleXml, /Reviewer B/);
-
-  const reloaded = loadDocxEditorSession({
-    documentId: "docx-f10-threaded-comments-reloaded",
-    sourceLabel: "f10-threaded-export.docx",
-    bytes: result.bytes,
-    editorBuild: "test",
-  });
-  const reloadedThread = Object.values(
-    (reloaded.initialSnapshot as PersistedEditorSnapshot).canonicalDocument.review.comments,
-  )[0];
-
-  assert.equal(reloaded.readOnly, false);
-  assert.equal(reloaded.fatalError, undefined);
-  assert.equal(reloadedThread?.entries?.length, 2);
-  assert.equal(reloadedThread?.status, "resolved");
-  assert.equal(reloadedThread?.entries?.[0]?.body, "Root comment edited after import.");
-  assert.equal(reloadedThread?.entries?.[1]?.metadata?.parentParaId, reloadedThread?.entries?.[0]?.metadata?.paraId);
-});
-
-test("comment fixture runtime exports keep the Open XML comments extension content types", async () => {
-  for (const fixtureName of [
-    "F09-comments-single-paragraph.docx",
-    "F13-comments-on-deleted-text.docx",
-  ]) {
-    const session = loadDocxEditorSession({
-      documentId: `docx-${fixtureName}`,
-      sourceLabel: fixtureName,
-      bytes: new Uint8Array(readFileSync(`test/fixtures/docx/${fixtureName}`)),
-      editorBuild: "test",
-    });
-    const runtime = createDocumentRuntime({
-      documentId: `runtime-${fixtureName}`,
-      initialSnapshot: session.initialSnapshot,
-      sourceKind: "docx",
-      sourceLabel: fixtureName,
-      editorBuild: session.initialSnapshot.editorBuild,
-      exportDocx: session.exportDocx,
-      defaultAuthorId: "test-operator",
-    });
-
-    const result = await runtime.exportDocx({
-      fileName: `exported-${fixtureName}`,
-    });
-    const exportedPackage = readOpcPackage(result.bytes);
-    const commentsExtendedPart = exportedPackage.parts.get("/word/commentsExtended.xml");
-    const commentsIdsPart = exportedPackage.parts.get("/word/commentsIds.xml");
-    const peoplePart = exportedPackage.parts.get("/word/people.xml");
-    const commentsXml = Buffer.from(
-      exportedPackage.parts.get("/word/comments.xml")?.bytes ?? new Uint8Array(),
-    ).toString("utf8");
-
-    assert.ok(commentsExtendedPart, `${fixtureName} should export commentsExtended.xml`);
-    assert.ok(commentsIdsPart, `${fixtureName} should export commentsIds.xml`);
-    assert.ok(peoplePart, `${fixtureName} should export people.xml`);
-    assert.match(commentsXml, /<w:comments\b[^>]*xmlns:w14=/);
-    assert.equal(
-      commentsExtendedPart?.contentType,
-      "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtended+xml",
-    );
-    assert.equal(
-      commentsIdsPart?.contentType,
-      "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsIds+xml",
-    );
-    assert.equal(
-      peoplePart?.contentType,
-      "application/vnd.openxmlformats-officedocument.wordprocessingml.people+xml",
-    );
-  }
-});
-
-test("package-backed export preserves imported comments that remain inside opaque OOXML", async () => {
-  const session = loadDocxEditorSession({
-    documentId: "docx-opaque-comment",
-    sourceLabel: "opaque-comment.docx",
-    bytes: createOpaqueCommentedDocxPackage(),
-    editorBuild: "test",
-  });
-  const importedComments = Object.values(
-    (session.initialSnapshot as PersistedEditorSnapshot).canonicalDocument.review.comments,
-  );
-
-  assert.equal(session.readOnly, false);
-  assert.equal(importedComments.length, 1);
-  assert.equal(importedComments[0]?.anchor.kind, "detached");
-
-  const result = await session.exportDocx(session.initialSnapshot, {
-    fileName: "opaque-comment-export.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const documentXml = Buffer.from(
-    exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-  const commentsXml = Buffer.from(
-    exportedPackage.parts.get("/word/comments.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-
-  assert.match(documentXml, /<w:commentRangeStart w:id="17"\/>/);
-  assert.match(documentXml, /<w:commentRangeEnd w:id="17"\/>/);
-  assert.match(documentXml, /<w:commentReference w:id="17"\/>/);
-  assert.match(commentsXml, /<w:comment w:id="17"/);
-  assert.match(commentsXml, /<w:bookmarkStart w:id="1" w:name="opaque-comment-bookmark"\/>/);
-  assert.match(commentsXml, /<w:bookmarkEnd w:id="1"\/>/);
-});
-
-test("package-backed export strips styled comment reference runs before reserializing owned comments", async () => {
-  const session = loadDocxEditorSession({
-    documentId: "docx-styled-comment-reference",
-    sourceLabel: "styled-comment-reference.docx",
-    bytes: createStyledCommentReferenceDocxPackage(),
-    editorBuild: "test",
-  });
-  const snapshot = structuredClone(session.initialSnapshot) as PersistedEditorSnapshot;
-  const comment = snapshot.canonicalDocument.review.comments["23"];
-
-  assert.equal(session.readOnly, false);
-  assert.ok(comment);
-  if (comment?.entries?.[0]) {
-    comment.entries[0].body = "Styled reference comment edited after import.";
-  }
-  if (comment) {
-    comment.body = comment.entries?.map((entry) => entry.body).join("\n");
-  }
-  snapshot.updatedAt = "2026-03-28T00:10:00.000Z";
-  snapshot.canonicalDocument.updatedAt = snapshot.updatedAt;
-
-  const result = await session.exportDocx(snapshot, {
-    fileName: "styled-comment-reference-export.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const documentXml = Buffer.from(
-    exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-
-  assert.equal((documentXml.match(/<w:commentRangeStart\b/g) ?? []).length, 1);
-  assert.equal((documentXml.match(/<w:commentRangeEnd\b/g) ?? []).length, 1);
-  assert.equal((documentXml.match(/<w:commentReference\b/g) ?? []).length, 1);
-});
-
-test("package-backed DOCX sessions export edited body content instead of echoing the source bytes", async () => {
-  const sourceBytes = new Uint8Array(readFileSync("test/fixtures/docx/F01-basic-contract.docx"));
-  const session = loadDocxEditorSession({
-    documentId: "docx-edit-export",
-    sourceLabel: "F01-basic-contract.docx",
-    bytes: sourceBytes,
-    editorBuild: "test",
-  });
-  const nextSnapshot = structuredClone(session.initialSnapshot) as PersistedEditorSnapshot;
-  const firstParagraph = (nextSnapshot.canonicalDocument.content as {
-    children: Array<{ children: Array<{ text?: string }> }>;
-  }).children[0];
-  const firstText = firstParagraph?.children[0];
-  assert.ok(firstText);
-  firstText.text = `${firstText.text ?? ""} Edited`;
-  nextSnapshot.updatedAt = "2026-03-26T23:59:00.000Z";
-  nextSnapshot.canonicalDocument.updatedAt = nextSnapshot.updatedAt;
-
-  const result = await session.exportDocx(nextSnapshot, {
-    fileName: "edited.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const documentXml = Buffer.from(
-    exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-
-  assert.notDeepEqual(Buffer.from(result.bytes), Buffer.from(sourceBytes));
-  assert.match(documentXml, /Edited/);
-});
-
-test("F03 numbering imports numbering.xml into runtime state and preserves list bindings on export", async () => {
-  const sourceBytes = new Uint8Array(readFileSync("test/fixtures/docx/F03-legal-outline-numbering.docx"));
-  const session = loadDocxEditorSession({
-    documentId: "docx-f03-numbering",
-    sourceLabel: "F03-legal-outline-numbering.docx",
-    bytes: sourceBytes,
-    editorBuild: "test",
-  });
-  const snapshot = structuredClone(session.initialSnapshot) as PersistedEditorSnapshot;
-  const content = snapshot.canonicalDocument.content as {
-    type: "doc";
-    children: Array<{
-      type: string;
-      numbering?: { numberingInstanceId: string; level: number };
-    }>;
-  };
-  const numbering = snapshot.canonicalDocument.numbering as {
-    abstractDefinitions: Record<string, unknown>;
-    instances: Record<string, unknown>;
-  };
-
-  assert.equal(session.readOnly, false);
-  assert.ok(
-    content.children.filter((block) => block.type === "paragraph" && block.numbering).length >= 6,
-  );
-  assert.ok(numbering.instances["num:1"]);
-  assert.ok(numbering.instances["num:2"]);
-
-  appendSuffixToFirstTextNode(snapshot, " Edited");
-  snapshot.updatedAt = "2026-03-27T01:00:00.000Z";
-  snapshot.canonicalDocument.updatedAt = snapshot.updatedAt;
-
-  const result = await session.exportDocx(snapshot, {
-    fileName: "f03-numbering-export.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const documentXml = Buffer.from(
-    exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-  const numberingXml = Buffer.from(
-    exportedPackage.parts.get("/word/numbering.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-
-  assert.match(documentXml, /Legal outline numbering proof Edited/);
-  assert.match(documentXml, /<w:numPr><w:ilvl w:val="0"\/><w:numId w:val="1"\/><\/w:numPr>/);
-  assert.match(numberingXml, /<w:abstractNum w:abstractNumId="1">/);
-  assert.match(numberingXml, /<w:num w:numId="2">/);
-
-  const reloaded = loadDocxEditorSession({
-    documentId: "docx-f03-numbering-reloaded",
-    sourceLabel: "f03-numbering-export.docx",
-    bytes: result.bytes,
-    editorBuild: "test",
-  });
-  const reloadedContent = reloaded.initialSnapshot.canonicalDocument.content as {
-    type: "doc";
-    children: Array<{
-      type: string;
-      numbering?: { numberingInstanceId: string; level: number };
-    }>;
-  };
-  const reloadedNumbering = reloaded.initialSnapshot.canonicalDocument.numbering as {
-    instances: Record<string, unknown>;
-  };
-
-  assert.equal(reloaded.readOnly, false);
-  assert.ok(
-    reloadedContent.children.filter((block) => block.type === "paragraph" && block.numbering)
-      .length >= 6,
-  );
-  assert.ok(reloadedNumbering.instances["num:1"]);
-  assert.ok(reloadedNumbering.instances["num:2"]);
-});
-
-test("F04 restart numbering fixture preserves numbering restart overrides on export", async () => {
-  const sourceBytes = new Uint8Array(
-    readFileSync("test/fixtures/docx/F04-restart-numbering-schedules.docx"),
-  );
-  const session = loadDocxEditorSession({
-    documentId: "docx-f04-numbering-restart",
-    sourceLabel: "F04-restart-numbering-schedules.docx",
-    bytes: sourceBytes,
-    editorBuild: "test",
-  });
-  const snapshot = structuredClone(session.initialSnapshot) as PersistedEditorSnapshot;
-  const content = snapshot.canonicalDocument.content as {
-    type: "doc";
-    children: Array<{
-      type: string;
-      numbering?: { numberingInstanceId: string; level: number };
-    }>;
-  };
-  const numbering = snapshot.canonicalDocument.numbering as {
-    abstractDefinitions: Record<string, unknown>;
-    instances: Record<
-      string,
-      {
-        overrides?: Array<{ level: number; startAt?: number }>;
-      }
-    >;
-  };
-
-  assert.equal(session.readOnly, false);
-  assert.equal(
-    content.children.filter((block) => block.type === "paragraph" && block.numbering).length,
-    4,
-  );
-  assert.ok(numbering.instances["num:1"]);
-  assert.deepEqual(numbering.instances["num:2"]?.overrides, [{ level: 0, startAt: 1 }]);
-
-  appendSuffixToFirstTextNode(snapshot, " Edited");
-  snapshot.updatedAt = "2026-03-27T03:00:00.000Z";
-  snapshot.canonicalDocument.updatedAt = snapshot.updatedAt;
-
-  const result = await session.exportDocx(snapshot, {
-    fileName: "f04-numbering-restart-export.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const documentXml = Buffer.from(
-    exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-  const numberingXml = Buffer.from(
-    exportedPackage.parts.get("/word/numbering.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-
-  assert.match(documentXml, /Restart numbering proof Edited/);
-  assert.match(numberingXml, /<w:startOverride w:val="1"\/>/);
-  assert.match(numberingXml, /<w:num w:numId="2">/);
-
-  const reloaded = loadDocxEditorSession({
-    documentId: "docx-f04-numbering-restart-reloaded",
-    sourceLabel: "f04-numbering-restart-export.docx",
-    bytes: result.bytes,
-    editorBuild: "test",
-  });
-  const reloadedNumbering = reloaded.initialSnapshot.canonicalDocument.numbering as {
-    instances: Record<string, { overrides?: Array<{ level: number; startAt?: number }> }>;
-  };
-
-  assert.equal(reloaded.readOnly, false);
-  assert.deepEqual(reloadedNumbering.instances["num:2"]?.overrides, [{ level: 0, startAt: 1 }]);
-});
-
-test("F05 and F06 remain preserve-only table fixtures on the live package-backed session path", async () => {
-  const fixtures = [
-    {
-      fixturePath: "test/fixtures/docx/F05-table-heavy-agreement.docx",
-      documentId: "docx-f05-preserve-only-table",
-      expectedPatterns: [/<w:tbl>/, /<w:tblGrid>/],
-    },
-    {
-      fixturePath: "test/fixtures/docx/F06-merged-cells-signature-table.docx",
-      documentId: "docx-f06-preserve-only-table",
-      expectedPatterns: [/<w:gridSpan\b/, /<w:vMerge\b/],
-    },
-  ] as const;
-
-  for (const fixture of fixtures) {
-    const sourceBytes = new Uint8Array(readFileSync(fixture.fixturePath));
-    const session = loadDocxEditorSession({
-      documentId: fixture.documentId,
-      sourceLabel: fixture.fixturePath.split("/").at(-1),
-      bytes: sourceBytes,
-      editorBuild: "test",
-    });
-    const snapshot = structuredClone(session.initialSnapshot) as PersistedEditorSnapshot;
-    const root = snapshot.canonicalDocument.content as {
-      type: "doc";
-      children: Array<{ type: string; fragmentId?: string }>;
-    };
-    const opaqueTableBlocks = root.children.filter(
-      (block) => block.type === "opaque_block",
-    );
-
-    assert.equal(session.readOnly, false);
-    assert.ok(opaqueTableBlocks.length >= 1);
-
-    appendSuffixToFirstTextNode(snapshot, " Edited");
-    snapshot.updatedAt = "2026-03-27T02:00:00.000Z";
-    snapshot.canonicalDocument.updatedAt = snapshot.updatedAt;
-
-    const result = await session.exportDocx(snapshot, {
-      fileName: `${fixture.documentId}-edited.docx`,
-    });
-    const exportedPackage = readOpcPackage(result.bytes);
-    const documentXml = Buffer.from(
-      exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-    ).toString("utf8");
-
-    assert.match(documentXml, /Edited/);
-    for (const pattern of fixture.expectedPatterns) {
-      assert.match(documentXml, pattern);
-    }
-
-    const reloaded = loadDocxEditorSession({
-      documentId: `${fixture.documentId}-reloaded`,
-      sourceLabel: `${fixture.documentId}-edited.docx`,
-      bytes: result.bytes,
-      editorBuild: "test",
-    });
-    const reloadedRoot = reloaded.initialSnapshot.canonicalDocument.content as {
-      type: "doc";
-      children: Array<{ type: string }>;
-    };
-
-    assert.equal(reloaded.readOnly, false);
-    assert.ok(
-      reloadedRoot.children.some((block) => block.type === "opaque_block"),
-    );
-  }
-});
-
-test("F07 inline images survive package-backed edits and reload with their media relationship intact", async () => {
-  const sourceBytes = new Uint8Array(readFileSync("test/fixtures/docx/F07-inline-images-exhibit.docx"));
-  const session = loadDocxEditorSession({
-    documentId: "docx-f07-inline-images",
-    sourceLabel: "F07-inline-images-exhibit.docx",
-    bytes: sourceBytes,
-    editorBuild: "test",
-  });
-  const snapshot = structuredClone(session.initialSnapshot) as PersistedEditorSnapshot;
-  const imageNode = findFirstImageNode(snapshot);
-  const media = snapshot.canonicalDocument.media as {
-    items: Record<string, { relationshipId?: string; packagePartName?: string }>;
-  };
-
-  assert.equal(session.readOnly, false);
-  assert.ok(imageNode);
-  assert.equal(imageNode?.mediaId, "media:word/media/image1.png");
-  assert.equal(media.items[imageNode!.mediaId]?.relationshipId, "rIdImage1");
-  assert.equal(media.items[imageNode!.mediaId]?.packagePartName, "/word/media/image1.png");
-
-  appendSuffixToFirstTextNode(snapshot, " Edited");
-  snapshot.updatedAt = "2026-03-27T01:10:00.000Z";
-  snapshot.canonicalDocument.updatedAt = snapshot.updatedAt;
-
-  const result = await session.exportDocx(snapshot, {
-    fileName: "f07-inline-images-export.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const documentXml = Buffer.from(
-    exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-
-  assert.match(documentXml, /Execution exhibit image Edited/);
-  assert.match(documentXml, /<w:drawing>/);
-  assert.match(documentXml, /r:embed="rIdImage1"/);
-  assert.ok(exportedPackage.parts.get("/word/media/image1.png"));
-
-  const reloaded = loadDocxEditorSession({
-    documentId: "docx-f07-inline-images-reloaded",
-    sourceLabel: "f07-inline-images-export.docx",
-    bytes: result.bytes,
-    editorBuild: "test",
-  });
-  const reloadedImageNode = findFirstImageNode(
-    reloaded.initialSnapshot as PersistedEditorSnapshot,
-  );
-
-  assert.equal(reloaded.readOnly, false);
-  assert.ok(reloadedImageNode);
-  assert.equal(reloadedImageNode?.mediaId, "media:word/media/image1.png");
-});
-
-test("unchanged S02 sessions export the original source bytes instead of reserializing the package", async () => {
-  const sourceBytes = new Uint8Array(
-    readFileSync("test/fixtures/scenarios/docx/S02-bw-partner-user-licence-agreement-redlines.docx"),
-  );
-  const session = loadDocxEditorSession({
-    documentId: "docx-s02-unchanged-export",
-    sourceLabel: "S02-bw-partner-user-licence-agreement-redlines.docx",
-    bytes: sourceBytes,
-    editorBuild: "test",
-  });
-
-  const result = await session.exportDocx(session.initialSnapshot, {
-    fileName: "s02-unchanged.docx",
-  });
-
-  assert.deepEqual(Buffer.from(result.bytes), Buffer.from(sourceBytes));
-});
-
-test("unchanged exports stay on the source-byte fast path across canonical key insertion order", async () => {
-  const sourceBytes = new Uint8Array(readFileSync("test/fixtures/docx/F01-basic-contract.docx"));
-  const session = loadDocxEditorSession({
-    documentId: "docx-f01-deterministic-fast-path",
-    sourceLabel: "F01-basic-contract.docx",
-    bytes: sourceBytes,
-    editorBuild: "test",
-  });
-  const snapshot = structuredClone(session.initialSnapshot) as PersistedEditorSnapshot;
-  const originalDocument = snapshot.canonicalDocument;
-
-  snapshot.canonicalDocument = {
-    diagnostics: originalDocument.diagnostics,
-    preservation: originalDocument.preservation,
-    review: {
-      revisions: { ...originalDocument.review.revisions },
-      comments: { ...originalDocument.review.comments },
-    },
-    content: originalDocument.content,
-    media: {
-      items: { ...originalDocument.media.items },
-    },
-    numbering: {
-      instances: { ...originalDocument.numbering.instances },
-      abstractDefinitions: { ...originalDocument.numbering.abstractDefinitions },
-    },
-    styles: {
-      tables: { ...originalDocument.styles.tables },
-      characters: { ...originalDocument.styles.characters },
-      paragraphs: { ...originalDocument.styles.paragraphs },
-    },
-    metadata: {
-      ...originalDocument.metadata,
-      customProperties: { ...originalDocument.metadata.customProperties },
-    },
-    updatedAt: originalDocument.updatedAt,
-    createdAt: originalDocument.createdAt,
-    docId: originalDocument.docId,
-    schemaVersion: originalDocument.schemaVersion,
-  };
-
-  const result = await session.exportDocx(snapshot, {
-    fileName: "f01-deterministic-fast-path.docx",
-  });
-
-  assert.deepEqual(Buffer.from(result.bytes), Buffer.from(sourceBytes));
-});
-
-test("S02 runtime single-item accept reduces actionable pending revisions", () => {
-  const session = loadDocxEditorSession({
-    documentId: "docx-s02-runtime-accept",
-    sourceLabel: "S02-bw-partner-user-licence-agreement-redlines.docx",
-    bytes: new Uint8Array(
-      readFileSync("test/fixtures/scenarios/docx/S02-bw-partner-user-licence-agreement-redlines.docx"),
-    ),
-    editorBuild: "test",
-  });
-  const runtime = createDocumentRuntime({
-    documentId: "docx-s02-runtime-accept",
-    initialSnapshot: session.initialSnapshot,
-    sourceKind: "docx",
-    editorBuild: session.initialSnapshot.editorBuild,
-    exportDocx: session.exportDocx,
-  });
-
-  const before = runtime.getRenderSnapshot().trackedChanges;
-  const actionableRevision = before.revisions.find(
-    (revision) =>
-      revision.status === "active" && revision.actionability === "actionable",
-  );
-
-  assert.ok(actionableRevision);
-  const beforePending = before.revisions.filter(
-    (revision) =>
-      revision.status === "active" && revision.actionability === "actionable",
-  ).length;
-
-  runtime.acceptChange(actionableRevision.revisionId);
-
-  const after = runtime.getRenderSnapshot().trackedChanges;
-  const afterPending = after.revisions.filter(
-    (revision) =>
-      revision.status === "active" && revision.actionability === "actionable",
-  ).length;
-  const updatedRevision = after.revisions.find(
-    (revision) => revision.revisionId === actionableRevision.revisionId,
-  );
-
-  assert.ok(updatedRevision);
-  assert.equal(updatedRevision?.status, "accepted");
-  assert.ok(afterPending < beforePending);
-});
-
-test("source-backed paragraph-mark review actions export F12 with merged paragraph boundaries", async () => {
-  const session = loadDocxEditorSession({
-    documentId: "docx-f12",
-    sourceLabel: "F12-redlines-paragraph-joins-splits.docx",
-    bytes: new Uint8Array(readFileSync("test/fixtures/docx/F12-redlines-paragraph-joins-splits.docx")),
-    editorBuild: "test",
-  });
-  const runtime = createDocumentRuntime({
-    documentId: "docx-f12",
-    initialSnapshot: session.initialSnapshot,
-    sourceKind: "docx",
-    editorBuild: session.initialSnapshot.editorBuild,
-    exportDocx: session.exportDocx,
-  });
-
-  const initialRevisions = Object.values(runtime.getPersistedSnapshot().canonicalDocument.review.revisions);
-  const paragraphDeletion = initialRevisions.find(
-    (revision) => revision.metadata?.originalRevisionType === "paragraph-del",
-  );
-  const paragraphInsertion = initialRevisions.find(
-    (revision) => revision.metadata?.originalRevisionType === "paragraph-ins",
-  );
-
-  assert.ok(paragraphDeletion, "Expected imported paragraph deletion revision in F12.");
-  assert.ok(paragraphInsertion, "Expected imported paragraph insertion revision in F12.");
-
-  runtime.acceptChange(paragraphDeletion.changeId);
-  runtime.rejectChange(paragraphInsertion.changeId);
-
-  const updatedSnapshot = runtime.getPersistedSnapshot();
-  const initialBreakCount = parseTextStory(session.initialSnapshot.canonicalDocument.content).units.filter(
-    (unit) => unit.kind === "paragraph_break",
-  ).length;
-  const updatedBreakCount = parseTextStory(updatedSnapshot.canonicalDocument.content).units.filter(
-    (unit) => unit.kind === "paragraph_break",
-  ).length;
-  assert.ok(updatedBreakCount < initialBreakCount);
-
-  const result = await runtime.exportDocx({
-    fileName: "f12-edited.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const documentPart = exportedPackage.parts.get("/word/document.xml");
-  assert.ok(documentPart);
-
-  const normalized = normalizeParsedTextDocument(
-    parseMainDocumentXml(
-      Buffer.from(documentPart.bytes).toString("utf8"),
-      documentPart.relationships,
-    ),
-    "/word/document.xml",
-  );
-
-  assert.deepEqual(normalized.content, updatedSnapshot.canonicalDocument.content);
-});
-
-test("imported redlined sessions allow freeform plain-text edits and preserve active run-level revisions on export", async () => {
-  const sourceBytes = new Uint8Array(readFileSync("test/fixtures/docx/F11-redlines-basic.docx"));
-  const session = loadDocxEditorSession({
-    documentId: "docx-f11-edit",
-    sourceLabel: "F11-redlines-basic.docx",
-    bytes: sourceBytes,
-    editorBuild: "test",
-  });
-  const runtime = createDocumentRuntime({
-    documentId: "docx-f11-edit",
-    initialSnapshot: session.initialSnapshot,
-    sourceKind: "docx",
-    editorBuild: session.initialSnapshot.editorBuild,
-    exportDocx: session.exportDocx,
-  });
-
-  runtime.dispatch({
-    type: "selection.set",
-    selection: {
-      anchor: 0,
-      head: 0,
-      isCollapsed: true,
-      activeRange: {
-        kind: "range",
-        from: 0,
-        to: 0,
-        assoc: { start: -1, end: 1 },
-      },
-    },
-  });
-  runtime.dispatch({
-    type: "text.insert",
-    text: "Updated ",
-    origin: {
-      source: "keyboard",
-      timestamp: "2026-03-26T23:00:00.000Z",
-    },
-  });
-
-  const result = await runtime.exportDocx({
-    fileName: "f11-freeform-edit.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const documentXml = Buffer.from(
-    exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-
-  assert.notDeepEqual(Buffer.from(result.bytes), Buffer.from(sourceBytes));
-  assert.match(documentXml, /Updated The Supplier/);
-  assert.match(documentXml, /<w:ins\b[^>]*w:id="11"/);
-  assert.match(documentXml, /<w:del\b[^>]*w:id="12"/);
-
-  const reloaded = loadDocxEditorSession({
-    documentId: "docx-f11-reloaded",
-    sourceLabel: "f11-freeform-edit.docx",
-    bytes: result.bytes,
-    editorBuild: "test",
-  });
-
-  assert.equal(reloaded.readOnly, false);
-  assert.equal(reloaded.fatalError, undefined);
-  assert.ok(
-    Object.keys(
-      (reloaded.initialSnapshot as PersistedEditorSnapshot).canonicalDocument.review.revisions,
-    ).length >= 2,
-  );
-});
-
-test("package-backed exports remap newly added comments to numeric OOXML ids", async () => {
-  const sourceBytes = new Uint8Array(readFileSync("test/fixtures/docx/F11-redlines-basic.docx"));
-  const session = loadDocxEditorSession({
-    documentId: "docx-f11-comment-export",
-    sourceLabel: "F11-redlines-basic.docx",
-    bytes: sourceBytes,
-    editorBuild: "test",
-  });
-  const runtime = createDocumentRuntime({
-    documentId: "docx-f11-comment-export",
-    initialSnapshot: session.initialSnapshot,
-    sourceKind: "docx",
-    editorBuild: session.initialSnapshot.editorBuild,
-    exportDocx: session.exportDocx,
-  });
-
-  runtime.addComment({
-    authorId: "user:operator",
-    body: "Wave 8 operator comment",
-    anchor: {
-      kind: "range",
-      from: 0,
-      to: 1,
-      assoc: {
-        start: -1,
-        end: 1,
-      },
-    },
-  });
-  runtime.acceptAllChanges();
-
-  const result = await runtime.exportDocx({
-    fileName: "f11-comment-export.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const documentXml = Buffer.from(
-    exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-  const commentsXml = Buffer.from(
-    exportedPackage.parts.get("/word/comments.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-
-  assert.match(documentXml, /<w:commentRangeStart w:id="\d+"\/>/);
-  assert.match(documentXml, /<w:commentRangeEnd w:id="\d+"\/>/);
-  assert.match(documentXml, /<w:commentReference w:id="\d+"\/>/);
-  assert.match(commentsXml, /<w:comment w:id="\d+"/);
-  assert.doesNotMatch(documentXml, /comment-\d{14,}-\d+/);
-  assert.doesNotMatch(commentsXml, /comment-\d{14,}-\d+/);
-
-  const reloaded = loadDocxEditorSession({
-    documentId: "docx-f11-comment-reloaded",
-    sourceLabel: "f11-comment-export.docx",
-    bytes: result.bytes,
-    editorBuild: "test",
-  });
-  const reloadedComments = Object.values(
-    (reloaded.initialSnapshot as PersistedEditorSnapshot).canonicalDocument.review.comments,
-  );
-
-  assert.equal(reloaded.readOnly, false);
-  assert.equal(reloaded.fatalError, undefined);
-  assert.ok(reloadedComments.length >= 1);
-  assert.equal(reloadedComments[0]?.body, "Wave 8 operator comment");
-});
-
-test("imported revisions with unsupported descendants downgrade to preserve-only and export unchanged", async () => {
-  const session = loadDocxEditorSession({
-    documentId: "docx-preserve-only-revision",
-    sourceLabel: "preserve-only-revision.docx",
-    bytes: createRevisionWithBookmarkDocxPackage(),
-    editorBuild: "test",
-  });
-  const runtime = createDocumentRuntime({
-    documentId: "docx-preserve-only-revision",
-    initialSnapshot: session.initialSnapshot,
-    sourceKind: "docx",
-    editorBuild: session.initialSnapshot.editorBuild,
-    exportDocx: session.exportDocx,
-  });
-  const importedRevisions = Object.values(
-    runtime.getPersistedSnapshot().canonicalDocument.review.revisions,
-  );
-  const preserveOnlyRevision = importedRevisions.find(
-    (revision) => revision.metadata?.ooxmlRevisionId === "55",
-  );
-
-  assert.ok(preserveOnlyRevision);
-  assert.match(
-    preserveOnlyRevision.metadata?.preserveOnlyReason ?? "",
-    /preserve-only/i,
-  );
-
-  runtime.dispatch({
-    type: "selection.set",
-    selection: {
-      anchor: 0,
-      head: 0,
-      isCollapsed: true,
-      activeRange: {
-        kind: "range",
-        from: 0,
-        to: 0,
-        assoc: { start: -1, end: 1 },
-      },
-    },
-  });
-  runtime.dispatch({
-    type: "text.insert",
-    text: "Draft ",
-    origin: {
-      source: "keyboard",
-      timestamp: "2026-03-26T23:20:00.000Z",
-    },
-  });
-
-  const result = await runtime.exportDocx({
-    fileName: "preserve-only-revision-export.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const documentXml = Buffer.from(
-    exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-
-  assert.match(documentXml, /Draft Lead /);
-  assert.match(documentXml, /<w:ins\b[^>]*w:id="55"/);
-  assert.match(documentXml, /<w:bookmarkStart w:id="9" w:name="review-bookmark"\/>/);
-  assert.match(documentXml, /<w:bookmarkEnd w:id="9"\/>/);
-});
-
-test("unsupported pict-only runs stay wrapped as runs when edited imports are exported", async () => {
-  const session = loadDocxEditorSession({
-    documentId: "docx-pict-run",
-    sourceLabel: "pict-run.docx",
-    bytes: createPictSeparatorDocxPackage(),
-    editorBuild: "test",
-  });
-  const nextSnapshot = structuredClone(session.initialSnapshot) as PersistedEditorSnapshot;
-  const firstParagraph = (nextSnapshot.canonicalDocument.content as {
-    children: Array<{ children: Array<{ text?: string }> }>;
-  }).children[0];
-  const firstText = firstParagraph?.children[0];
-
-  assert.ok(firstText);
-  firstText.text = `${firstText.text ?? ""} Edited`;
-  nextSnapshot.updatedAt = "2026-03-27T01:15:00.000Z";
-  nextSnapshot.canonicalDocument.updatedAt = nextSnapshot.updatedAt;
-
-  const result = await session.exportDocx(nextSnapshot, {
-    fileName: "pict-run-edited.docx",
-  });
-  const exportedPackage = readOpcPackage(result.bytes);
-  const documentXml = Buffer.from(
-    exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-  ).toString("utf8");
-
-  assert.match(documentXml, /Editable intro\. Edited/);
-  assert.match(
-    documentXml,
-    /<w:r>\s*<w:rPr><w:noProof\/><\/w:rPr>\s*<w:pict\b[\s\S]*?<v:rect\b[\s\S]*?<\/w:pict>\s*<\/w:r>/,
-  );
-  assert.doesNotMatch(documentXml, /<w:p><w:pict\b/);
-});
-
-test("S02 freeform edits fail closed when preserve-only comment anchors would be lost", async () => {
-  const sourceBytes = new Uint8Array(
-    readFileSync("test/fixtures/scenarios/docx/S02-bw-partner-user-licence-agreement-redlines.docx"),
-  );
-  const session = loadDocxEditorSession({
-    documentId: "docx-s02-edit",
-    sourceLabel: "S02-bw-partner-user-licence-agreement-redlines.docx",
-    bytes: sourceBytes,
-    editorBuild: "test",
-  });
-  const runtime = createDocumentRuntime({
-    documentId: "docx-s02-edit",
-    initialSnapshot: session.initialSnapshot,
-    sourceKind: "docx",
-    editorBuild: session.initialSnapshot.editorBuild,
-    exportDocx: session.exportDocx,
-  });
-
-  runtime.dispatch({
-    type: "selection.set",
-    selection: {
-      anchor: 0,
-      head: 0,
-      isCollapsed: true,
-      activeRange: {
-        kind: "range",
-        from: 0,
-        to: 0,
-        assoc: { start: -1, end: 1 },
-      },
-    },
-  });
-  runtime.dispatch({
-    type: "text.insert",
-    text: "Draft ",
-    origin: {
-      source: "keyboard",
-      timestamp: "2026-03-26T23:10:00.000Z",
-    },
-  });
-
-  await assert.rejects(
-    () =>
-      runtime.exportDocx({
-        fileName: "s02-freeform-edit.docx",
-      }),
-    /preserve-only comment anchors/i,
-  );
-});
-
-test("F16 through F18 preserve-only fixtures survive edited exports with their critical OOXML intact", async () => {
-  const fixtures = [
-    {
-      fixturePath: "test/fixtures/docx/F16-footnotes-endnotes.docx",
-      documentId: "docx-f16",
-      expectedDocumentPatterns: [
-        /<w:footnoteReference w:id="2"\/>/,
-        /<w:endnoteReference w:id="3"\/>/,
-      ],
-      expectedParts: ["/word/footnotes.xml", "/word/endnotes.xml"],
-    },
-    {
-      fixturePath: "test/fixtures/docx/F17-fields-and-toc.docx",
-      documentId: "docx-f17",
-      expectedDocumentPatterns: [
-        /<w:fldChar w:fldCharType="begin"\/>/,
-        /<w:fldSimple w:instr=" PAGE ">/,
-      ],
-      expectedParts: [],
-    },
-    {
-      fixturePath: "test/fixtures/docx/F18-content-controls-template.docx",
-      documentId: "docx-f18",
-      expectedDocumentPatterns: [
-        /<w:sdt>/,
-        /<w:lock w:val="sdtLocked"\/>/,
-      ],
-      expectedParts: [],
-    },
-  ] as const;
-
-  for (const fixture of fixtures) {
-    const sourceBytes = new Uint8Array(readFileSync(fixture.fixturePath));
-    const session = loadDocxEditorSession({
-      documentId: fixture.documentId,
-      sourceLabel: fixture.fixturePath.split("/").at(-1),
-      bytes: sourceBytes,
-      editorBuild: "test",
-    });
-    const snapshot = structuredClone(session.initialSnapshot) as PersistedEditorSnapshot;
-
-    appendSuffixToFirstTextNode(snapshot, " Edited");
-    snapshot.updatedAt = "2026-03-27T01:20:00.000Z";
-    snapshot.canonicalDocument.updatedAt = snapshot.updatedAt;
-
-    const result = await session.exportDocx(snapshot, {
-      fileName: `${fixture.documentId}-edited.docx`,
-    });
-    const exportedPackage = readOpcPackage(result.bytes);
-    const documentXml = Buffer.from(
-      exportedPackage.parts.get("/word/document.xml")?.bytes ?? new Uint8Array(),
-    ).toString("utf8");
-
-    assert.match(documentXml, /Edited/);
-    for (const pattern of fixture.expectedDocumentPatterns) {
-      assert.match(documentXml, pattern);
-    }
-    for (const partPath of fixture.expectedParts) {
-      assert.ok(exportedPackage.parts.get(partPath), `Expected preserved package part ${partPath}.`);
-    }
-
-    const reloaded = loadDocxEditorSession({
-      documentId: `${fixture.documentId}-reloaded`,
-      sourceLabel: `${fixture.documentId}-edited.docx`,
-      bytes: result.bytes,
-      editorBuild: "test",
-    });
-    assert.equal(reloaded.readOnly, false);
-    assert.equal(reloaded.fatalError, undefined);
-  }
-});
-
-test("malformed package bytes open in diagnostics mode and block export", async () => {
-  const session = loadDocxEditorSession({
-    documentId: "docx-broken",
-    sourceLabel: "broken.docx",
-    bytes: new Uint8Array([0x00, 0x01, 0x02, 0x03]),
-    editorBuild: "test",
-  });
-
-  assert.equal(session.readOnly, true);
-  assert.ok(session.fatalError);
-  assert.equal(session.fatalError.code, "package_corrupt");
-  assert.equal(session.fatalError.details?.stage, "package");
-  assert.equal(session.initialSnapshot.compatibility.blockExport, true);
-  assert.equal(
-    session.initialSnapshot.canonicalDocument.metadata.importMode,
-    "read-only-diagnostics",
-  );
-  assert.equal(
-    session.initialSnapshot.compatibility.featureEntries[0]?.details?.stage,
-    "package",
-  );
-  assert.match(
-    String(session.initialSnapshot.compatibility.featureEntries[0]?.details?.diagnosticsToken),
-    /^pkg-[0-9a-f]{8}$/u,
-  );
-  await assert.rejects(() => session.exportDocx(session.initialSnapshot));
-});
-
-function createCommentedDocxPackage(): Uint8Array {
-  const documentXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<w:document xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
-  <w:body>
-    <w:p>
-      <w:r><w:t>Alpha </w:t></w:r>
-      <w:commentRangeStart w:id="7"/>
-      <w:r><w:t>Beta</w:t></w:r>
-      <w:commentRangeEnd w:id="7"/>
-      <w:r><w:commentReference w:id="7"/></w:r>
-    </w:p>
-    <w:sectPr/>
-  </w:body>
-</w:document>`;
-  const commentsXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
-  <w:comment w:id="7" w:author="user:a" w:date="2026-03-26T12:00:00.000Z">
-    <w:p><w:r><w:t>Imported comment body</w:t></w:r></w:p>
-  </w:comment>
-</w:comments>`;
-  const basePackage = readOpcPackage(writeDocxPackage({ documentXml }));
-  const documentPart = basePackage.parts.get("/word/document.xml");
-  assert.ok(documentPart);
-
-  const nextPackage: OpcPackage = {
-    manifest: {
-      ...basePackage.manifest,
-      contentTypes: {
-        defaults: {
-          ...basePackage.manifest.contentTypes.defaults,
-        },
-        overrides: {
-          ...basePackage.manifest.contentTypes.overrides,
-          "/word/comments.xml":
-            "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml",
-        },
-      },
-      parts: [
-        ...basePackage.manifest.parts.map((part) =>
-          part.path === "/word/document.xml"
-            ? {
-                ...part,
-                relationships: [
-                  ...part.relationships,
-                  {
-                    id: "rIdComments1",
-                    type: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments",
-                    target: "comments.xml",
-                    targetMode: "internal" as const,
-                  },
-                ],
-              }
-            : part,
-        ),
-        {
-          path: "/word/comments.xml",
-          surfaceKind: "content",
-          contentType:
-            "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml",
-          relationshipsPartPath: "/word/_rels/comments.xml.rels",
-          relationships: [],
-          compression: "deflate",
-          byteLength: new TextEncoder().encode(commentsXml).byteLength,
-        },
-      ],
-      packageRelationships: basePackage.manifest.packageRelationships,
-    },
-    parts: new Map([
-      ...basePackage.parts.entries(),
-      [
-        "/word/document.xml",
-        {
-          ...documentPart,
-          relationships: [
-            ...documentPart.relationships,
-            {
-              id: "rIdComments1",
-              type: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments",
-              target: "comments.xml",
-              targetMode: "internal" as const,
-            },
-          ],
-        },
-      ],
-      [
-        "/word/comments.xml",
-        {
-          path: "/word/comments.xml",
-          surfaceKind: "content",
-          contentType:
-            "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml",
-          relationshipsPartPath: "/word/_rels/comments.xml.rels",
-          relationships: [],
-          compression: "deflate",
-          bytes: new TextEncoder().encode(commentsXml),
-          crc32: 0,
-        },
-      ],
-    ]),
-    sourceByteLength: 0,
-  };
-
-  return writeOpcPackage(nextPackage);
-}
-
-function createStyledCommentReferenceDocxPackage(): Uint8Array {
-  const documentXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<w:document xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
-  <w:body>
-    <w:p>
-      <w:r><w:t>Alpha </w:t></w:r>
-      <w:commentRangeStart w:id="23"/>
-      <w:r><w:rPr><w:rStyle w:val="Emphasis"/></w:rPr><w:t>Beta</w:t></w:r>
-      <w:commentRangeEnd w:id="23"/>
-      <w:r>
-        <w:rPr><w:rStyle w:val="CommentReference"/></w:rPr>
-        <w:commentReference w:id="23"/>
-      </w:r>
-    </w:p>
-    <w:sectPr/>
-  </w:body>
-</w:document>`;
-  const commentsXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
-  <w:comment w:id="23" w:author="user:styled" w:date="2026-03-28T00:00:00.000Z">
-    <w:p><w:r><w:t>Styled reference comment</w:t></w:r></w:p>
-  </w:comment>
-</w:comments>`;
-
-  return createCommentedPackage(documentXml, commentsXml, "rIdCommentsStyled");
-}
-
-function appendSuffixToFirstTextNode(
-  snapshot: PersistedEditorSnapshot,
-  suffix: string,
-): void {
-  const content = snapshot.canonicalDocument.content as {
-    type?: string;
-    children?: Array<{
-      type?: string;
-      children?: Array<{
-        type?: string;
-        text?: string;
-      }>;
-    }>;
-  };
-
-  for (const block of content.children ?? []) {
-    if (block.type !== "paragraph") {
-      continue;
-    }
-
-    for (const child of block.children ?? []) {
-      if (child.type !== "text") {
-        continue;
-      }
-
-      child.text = `${child.text ?? ""}${suffix}`;
-      return;
-    }
-  }
-
-  throw new Error("Expected an editable text node in the fixture snapshot.");
-}
-
-function findFirstImageNode(
-  snapshot: PersistedEditorSnapshot,
-): { mediaId: string; altText?: string } | undefined {
-  const content = snapshot.canonicalDocument.content as {
-    type?: string;
-    children?: Array<{
-      type?: string;
-      children?: Array<{
-        type?: string;
-        mediaId?: string;
-        altText?: string;
-      }>;
-    }>;
-  };
-
-  for (const block of content.children ?? []) {
-    if (block.type !== "paragraph") {
-      continue;
-    }
-
-    for (const child of block.children ?? []) {
-      if (child.type === "image" && typeof child.mediaId === "string") {
-        return {
-          mediaId: child.mediaId,
-          altText: child.altText,
-        };
-      }
-    }
-  }
-
-  return undefined;
-}
-
-function createOpaqueCommentedDocxPackage(): Uint8Array {
-  const documentXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<w:document xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
-  <w:body>
-    <w:p>
-      <w:pPr>
-        <w:pPrChange w:id="41" w:author="user:format" w:date="2026-03-26T12:10:00.000Z">
-          <w:pPr><w:jc w:val="center"/></w:pPr>
-        </w:pPrChange>
-      </w:pPr>
-      <w:r><w:t>Alpha </w:t></w:r>
-      <w:commentRangeStart w:id="17"/>
-      <w:r><w:t>Beta</w:t></w:r>
-      <w:commentRangeEnd w:id="17"/>
-      <w:r><w:commentReference w:id="17"/></w:r>
-    </w:p>
-    <w:p>
-      <w:r><w:t>Tail paragraph.</w:t></w:r>
-    </w:p>
-    <w:sectPr/>
-  </w:body>
-</w:document>`;
-  const commentsXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
-  <w:comment w:id="17" w:author="user:opaque" w:date="2026-03-26T12:11:00.000Z">
-    <w:p>
-      <w:bookmarkStart w:id="1" w:name="opaque-comment-bookmark"/>
-      <w:r><w:t>Opaque comment body</w:t></w:r>
-      <w:bookmarkEnd w:id="1"/>
-    </w:p>
-  </w:comment>
-</w:comments>`;
-
-  return createCommentedPackage(documentXml, commentsXml, "rIdCommentsOpaque");
-}
-
-function createRevisionWithBookmarkDocxPackage(): Uint8Array {
-  const documentXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
-  <w:body>
-    <w:p>
-      <w:r><w:t>Lead </w:t></w:r>
-      <w:ins w:id="55" w:author="user:revision" w:date="2026-03-26T12:15:00.000Z">
-        <w:bookmarkStart w:id="9" w:name="review-bookmark"/>
-        <w:r><w:t>Marked</w:t></w:r>
-        <w:bookmarkEnd w:id="9"/>
-      </w:ins>
-      <w:r><w:t> Tail</w:t></w:r>
-    </w:p>
-    <w:p>
-      <w:r><w:t>Trailing paragraph.</w:t></w:r>
-    </w:p>
-    <w:sectPr/>
-  </w:body>
-</w:document>`;
-
-  return writeDocxPackage({ documentXml });
-}
-
-function createPictSeparatorDocxPackage(): Uint8Array {
-  const documentXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<w:document xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:v="urn:schemas-microsoft-com:vml" xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" xmlns:w14="http://schemas.microsoft.com/office/word/2010/wordml">
-  <w:body>
-    <w:p>
-      <w:r><w:t>Editable intro.</w:t></w:r>
-    </w:p>
-    <w:p w14:paraId="45590ACA" w14:textId="77777777">
-      <w:r>
-        <w:rPr><w:noProof/></w:rPr>
-        <w:pict w14:anchorId="1E251FC2">
-          <v:rect id="_x0000_i1043" alt="" style="width:451.15pt;height:.05pt" o:hrpct="964" o:hralign="center" o:hrstd="t" o:hr="t" fillcolor="#a0a0a0" stroked="f"/>
-        </w:pict>
-      </w:r>
-    </w:p>
-    <w:p>
-      <w:r><w:t>Tail paragraph.</w:t></w:r>
-    </w:p>
-    <w:sectPr/>
-  </w:body>
-</w:document>`;
-
-  return writeDocxPackage({ documentXml });
-}
-
-function createCommentedPackage(
-  documentXml: string,
-  commentsXml: string,
-  relationshipId: string,
-): Uint8Array {
-  const basePackage = readOpcPackage(writeDocxPackage({ documentXml }));
-  const documentPart = basePackage.parts.get("/word/document.xml");
-  assert.ok(documentPart);
-
-  const nextPackage: OpcPackage = {
-    manifest: {
-      ...basePackage.manifest,
-      contentTypes: {
-        defaults: {
-          ...basePackage.manifest.contentTypes.defaults,
-        },
-        overrides: {
-          ...basePackage.manifest.contentTypes.overrides,
-          "/word/comments.xml":
-            "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml",
-        },
-      },
-      parts: [
-        ...basePackage.manifest.parts.map((part) =>
-          part.path === "/word/document.xml"
-            ? {
-                ...part,
-                relationships: [
-                  ...part.relationships,
-                  {
-                    id: relationshipId,
-                    type: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments",
-                    target: "comments.xml",
-                    targetMode: "internal" as const,
-                  },
-                ],
-              }
-            : part,
-        ),
-        {
-          path: "/word/comments.xml",
-          surfaceKind: "content",
-          contentType:
-            "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml",
-          relationshipsPartPath: "/word/_rels/comments.xml.rels",
-          relationships: [],
-          compression: "deflate",
-          byteLength: new TextEncoder().encode(commentsXml).byteLength,
-        },
-      ],
-      packageRelationships: basePackage.manifest.packageRelationships,
-    },
-    parts: new Map([
-      ...basePackage.parts.entries(),
-      [
-        "/word/document.xml",
-        {
-          ...documentPart,
-          relationships: [
-            ...documentPart.relationships,
-            {
-              id: relationshipId,
-              type: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments",
-              target: "comments.xml",
-              targetMode: "internal" as const,
-            },
-          ],
-        },
-      ],
-      [
-        "/word/comments.xml",
-        {
-          path: "/word/comments.xml",
-          surfaceKind: "content",
-          contentType:
-            "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml",
-          relationshipsPartPath: "/word/_rels/comments.xml.rels",
-          relationships: [],
-          compression: "deflate",
-          bytes: new TextEncoder().encode(commentsXml),
-          crc32: 0,
-        },
-      ],
-    ]),
-    sourceByteLength: 0,
-  };
-
-  return writeOpcPackage(nextPackage);
-}