@beyondwork/docx-react-component 1.0.5 → 1.0.8

package/README.md

@@ -2,7 +2,7 @@
 
 [![CI](https://github.com/bwllaming/React-OOXML-Office/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/bwllaming/React-OOXML-Office/actions/workflows/ci.yml)
 
-`@beyondwork/docx-react-component` is now configured as an npm-ready package for the shipped product in this repository: `WordReviewEditor`, a fidelity-first React editor for legal-review-safe `docx` workflows.
+`@beyondwork/docx-react-component` is the shipped product in this repository: `WordReviewEditor`, a fidelity-first React editor for legal-review-safe `docx` workflows. Wave 21 lands the package-facing docs, npm metadata, publish workflow, and `pnpm pack` proof for this surface.
 
 The broader repository is still evolving toward a layered `react-ooxml-office` platform, but the source reality is unchanged:
 
@@ -22,6 +22,7 @@ Current packaging truth:
 
 - the package is ESM-only
 - exports point at shipped TypeScript source entry points
+- `types` and subpath `types` entries resolve to the shipped source-backed TypeScript contracts
 - consumers need a bundler or runtime that can resolve `.ts` and `.tsx` ESM imports
 - consumers should import `@beyondwork/docx-react-component/ui-tailwind/theme/editor-theme.css` once and provide a Tailwind v4 CSS pipeline for it
 - package and source identifiers remain docx-first until a deliberate rename lands
@@ -104,7 +105,7 @@ Shared platform and planned xlsx docs:
 
 - `.github/workflows/publish.yml` publishes on `v*` tags after verifying the tag matches `package.json`
 - `pnpm pack --dry-run` is the baseline package proof for this wave
-- npm provenance is enabled in `publishConfig`
+- npm provenance is enabled in `publishConfig` and in the publish workflow invocation
 - the published package currently ships source ESM entry points plus TypeScript source-backed `types` exports
 - the Microsoft Open XML SDK remains CI/internal-service only, never part of the shipped browser runtime
 

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@beyondwork/docx-react-component",
   "publisher": "beyondwork",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "description": "Embeddable React Word (docx) editor with review, comments, tracked changes, and round-trip OOXML fidelity.",
   "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
   "files": [
     "README.md",
     "LICENSE.md",
@@ -26,9 +29,6 @@
       "types": "./src/ui-tailwind/index.ts",
       "import": "./src/ui-tailwind/index.ts"
     },
-    "./io/docx-session": "./src/io/docx-session.ts",
-    "./runtime/document-runtime": "./src/runtime/document-runtime.ts",
-    "./api/public-types": "./src/api/public-types.ts",
     "./ui-tailwind/theme/editor-theme.css": "./src/ui-tailwind/theme/editor-theme.css",
     "./package.json": "./package.json"
   },
@@ -45,6 +45,14 @@
     "prosemirror"
   ],
   "author": "",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bwllaming/React-OOXML-Office.git"
+  },
+  "homepage": "https://github.com/bwllaming/React-OOXML-Office#readme",
+  "bugs": {
+    "url": "https://github.com/bwllaming/React-OOXML-Office/issues"
+  },
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
     "@radix-ui/react-popover": "^1.1.15",
@@ -73,6 +81,7 @@
     "@chllming/wave-orchestration": "^0.9.8",
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
+    "@typescript/native-preview": "7.0.0-dev.20260409.1",
     "jsdom": "^29.0.1",
     "prosemirror-commands": "^1.7.1",
     "prosemirror-keymap": "^1.2.3",
@@ -91,7 +100,10 @@
     "test": "bash scripts/run-workspace-tests.sh",
     "test:repo": "pnpm exec tsx --test $(find test -type f \\( -name '*.test.ts' -o -name '*.test.tsx' \\) | sort)",
     "test:harness": "pnpm --filter @docx-react-component/react-word-editor-harness test",
+    "lint": "pnpm run lint:no-authored-js && pnpm run lint:tsgo && pnpm run lint:tsgo:harness",
     "lint:no-authored-js": "bash scripts/check-no-authored-js.sh",
+    "lint:tsgo": "tsgo --noEmit -p tsconfig.build.json",
+    "lint:tsgo:harness": "pnpm --filter @docx-react-component/react-word-editor-harness lint:tsgo",
     "context7:api-check": "bash scripts/context7-export-env.sh run bash scripts/context7-api-check.sh",
     "wave:doctor": "bash scripts/context7-export-env.sh run pnpm exec wave doctor --json",
     "wave:dry-run": "bash scripts/context7-export-env.sh run pnpm exec wave launch --lane main --dry-run --no-dashboard",

package/src/api/public-types.ts

@@ -384,6 +384,8 @@ export type WordReviewEditorEvent =
       source: "docx" | "snapshot" | "datastore" | "canonical";
       stats: DocumentStats;
       compatibility: CompatibilityReport;
+      comments: CommentSidebarSnapshot;
+      trackedChanges: TrackedChangesSnapshot;
     }
   | {
       type: "dirty_changed";
@@ -504,6 +506,8 @@ export interface WordReviewEditorRef {
   getSnapshot(): PersistedEditorSnapshot;
   getCompatibilityReport(): CompatibilityReport;
   getWarnings(): EditorWarning[];
+  getComments(): CommentSidebarSnapshot;
+  getTrackedChanges(): TrackedChangesSnapshot;
 }
 
 export interface WordReviewEditorProps {

package/src/compare/diff-engine.ts

@@ -6,6 +6,7 @@ import {
   type HyperlinkNode,
   type InlineNode,
   type ParagraphNode,
+  type RevisionRecord,
   type TextNode,
 } from "../model/canonical-document.ts";
 import type { DocumentVersionSnapshot } from "./snapshot.ts";
@@ -319,39 +320,35 @@ function createParagraphRevisionRecords(
     previousWasParagraph = false;
   }
 
-  return Object.fromEntries(
-    pendingRevisions
-      .map((revision, index) => {
-        const position = positionByParagraphIndex.get(revision.paragraphIndex);
-        if (position === undefined) {
-          return undefined;
-        }
+  const entries: Array<[string, RevisionRecord]> = [];
+  pendingRevisions.forEach((revision, index) => {
+    const position = positionByParagraphIndex.get(revision.paragraphIndex);
+    if (position === undefined) {
+      return;
+    }
 
-        const changeId = `change-${index + 1}`;
-        return [
-          changeId,
-          {
-            changeId,
-            kind: revision.kind,
-            anchor: {
-              kind: "range" as const,
-              range: { from: position, to: position },
-              assoc: { start: -1 as const, end: 1 as const },
-            },
-            authorId,
-            createdAt,
-            status: "open" as const,
-            warningIds: [],
-            metadata: {
-              source: "runtime" as const,
-              importedRevisionForm:
-                revision.kind === "insertion" ? "paragraph-insertion" : "paragraph-deletion",
-            },
-          },
-        ] as const;
-      })
-      .filter((entry): entry is readonly [string, CanonicalDocument["review"]["revisions"][string]] => Boolean(entry)),
-  );
+    const changeId = `change-${index + 1}`;
+    const record: RevisionRecord = {
+      changeId,
+      kind: revision.kind,
+      anchor: {
+        kind: "range",
+        range: { from: position, to: position },
+        assoc: { start: -1, end: 1 },
+      },
+      authorId,
+      createdAt,
+      status: "open",
+      warningIds: [],
+      metadata: {
+        source: "runtime",
+        importedRevisionForm:
+          revision.kind === "insertion" ? "paragraph-insertion" : "paragraph-deletion",
+      },
+    };
+    entries.push([changeId, record]);
+  });
+  return Object.fromEntries(entries);
 }
 
 function getComparableBlockKey(block: BlockNode): string {
@@ -434,11 +431,17 @@ function getInlineLength(node: InlineNode): number {
     case "tab":
     case "hard_break":
     case "column_break":
+    case "symbol":
     case "image":
     case "opaque_inline":
     case "footnote_ref":
     case "bookmark_start":
     case "bookmark_end":
+    case "chart_preview":
+    case "smartart_preview":
+    case "shape":
+    case "wordart":
+    case "vml_shape":
       return 1;
   }
 }
@@ -471,6 +474,8 @@ function getInlineDisplayText(node: InlineNode): string {
     case "hard_break":
     case "column_break":
       return "\n";
+    case "symbol":
+      return node.char;
     case "hyperlink":
       return node.children.map(getInlineDisplayText).join("");
     case "field":
@@ -484,6 +489,16 @@ function getInlineDisplayText(node: InlineNode): string {
     case "bookmark_start":
     case "bookmark_end":
       return "";
+    case "chart_preview":
+      return "[Chart]";
+    case "smartart_preview":
+      return "[SmartArt]";
+    case "shape":
+      return node.text ?? "[Shape]";
+    case "wordart":
+      return node.text;
+    case "vml_shape":
+      return node.text ?? "[VML Shape]";
   }
 }
 
@@ -517,7 +532,7 @@ function mergePreservationStores(
   };
 }
 
-function mergeRecordCatalog<T extends Record<string, unknown>>(base: T, target: T): T {
+function mergeRecordCatalog<T extends object>(base: T, target: T): T {
   return projectValue({ ...base, ...target });
 }
 

package/src/core/schema/text-schema.ts

@@ -94,6 +94,10 @@ export function parseTextStory(content: unknown): TextStory {
       continue;
     }
 
+    if (block.type !== "opaque_block") {
+      continue;
+    }
+
     units.push({
       kind: "opaque_block",
       fragmentId: block.fragmentId,
@@ -484,7 +488,7 @@ function createEmptyParagraph(): ParagraphNode {
 const EMPTY_PARAGRAPH_PROPERTIES: ParagraphProperties = {};
 
 function cloneMarks(marks: TextMark[]): TextMark[] {
-  return marks.map((mark) => ({ type: mark.type }));
+  return marks.map((mark) => ({ ...mark }));
 }
 
 function haveEqualMarks(left?: TextMark[], right?: TextMark[]): boolean {

package/src/core/selection/mapping.ts

@@ -101,6 +101,16 @@ export function normalizeRange(range: DocRange): DocRange {
     : { from: range.to, to: range.from };
 }
 
+export function getEffectiveRange(anchor: EditorAnchorProjection): DocRange {
+  if (anchor.kind === "range") {
+    return anchor.range;
+  }
+  if (anchor.kind === "node") {
+    return { from: anchor.at, to: anchor.at };
+  }
+  return anchor.lastKnownRange;
+}
+
 export function mapPosition(
   position: Position,
   assoc: Assoc,

package/src/formats/xlsx/io/xlsx-session.ts

@@ -301,6 +301,8 @@ function convertCachedFormulaValue(
 // Helpers
 // ---------------------------------------------------------------------------
 
+const UTF8_DECODER = new TextDecoder("utf-8");
+
 function decodePartBytes(bytes: Uint8Array): string {
-  return new TextDecoder("utf-8").decode(bytes);
+  return UTF8_DECODER.decode(bytes);
 }

package/src/formats/xlsx/model/sheet.ts

@@ -8,6 +8,8 @@
 import type { CellAddress, CellKey, CellValue, ColIndex, RowIndex } from "./cell.ts";
 import { cellKey } from "./cell.ts";
 
+export type { ColIndex, RowIndex } from "./cell.ts";
+
 // ---------------------------------------------------------------------------
 // Row and column metadata (sparse)
 // ---------------------------------------------------------------------------

package/src/io/docx-session.ts

@@ -853,7 +853,9 @@ function exportDocxEditorSession(
         exportSession.replaceOwnedPart({
           path: state.sourceSubPartPaths.themePartPath,
           bytes: sourceThemePart.bytes,
-          contentType: sourceThemePart.contentType,
+          contentType:
+            sourceThemePart.contentType ??
+            "application/vnd.openxmlformats-officedocument.theme+xml",
           relationships: sourceThemePart.relationships,
           compression: sourceThemePart.compression,
         });
@@ -1061,13 +1063,14 @@ function normalizeImportedRevisionRecords(
   return {
     ...parsed,
     revisions: parsed.revisions.map((revision) => {
-      if (revision.anchor.kind !== "range" || revision.metadata.preserveOnlyReason) {
+      const { anchor } = revision;
+      if (anchor.kind !== "range" || revision.metadata.preserveOnlyReason) {
         return revision;
       }
 
       const preserveOnlyReason =
         getStructuralPreserveOnlyReason(revision, paragraphRanges) ??
-        (opaqueRanges.some((range) => rangesIntersect(range, revision.anchor.range))
+        (opaqueRanges.some((range) => rangesIntersect(range, anchor.range))
           ? "Imported revision overlaps preserve-only OOXML and remains preserve-only."
           : undefined);
 
@@ -1092,23 +1095,27 @@ function normalizeImportedCommentThreads(
   revisions: readonly ReviewRevisionRecord[],
 ): NormalizedImportedCommentsResult {
   const opaqueRanges = Object.values(opaqueFragments).map((fragment) => fragment.lastKnownRange);
-  const preserveOnlyRevisionRanges = revisions
-    .filter(
-      (revision) =>
-        revision.anchor.kind === "range" &&
-        typeof revision.metadata.preserveOnlyReason === "string" &&
-        revision.metadata.preserveOnlyReason.length > 0,
-    )
-    .map((revision) => revision.anchor.range);
+  const preserveOnlyRevisionRanges = revisions.flatMap((revision) => {
+    const { anchor } = revision;
+    if (
+      anchor.kind !== "range" ||
+      typeof revision.metadata.preserveOnlyReason !== "string" ||
+      revision.metadata.preserveOnlyReason.length === 0
+    ) {
+      return [];
+    }
+    return [anchor.range];
+  });
   const preserveOnlyCommentIds = new Set(parsed.diagnostics.map((diagnostic) => diagnostic.commentId));
   const additionalDiagnostics: CommentImportDiagnostic[] = [];
-  const normalizedThreads = parsed.threads.map((thread) => {
-    if (thread.anchor.kind !== "range") {
+  const normalizedThreads: CommentThread[] = parsed.threads.map((thread) => {
+    const { anchor } = thread;
+    if (anchor.kind !== "range") {
       preserveOnlyCommentIds.add(thread.commentId);
       return thread;
     }
 
-    const opaqueOverlap = opaqueRanges.some((range) => rangesIntersect(range, thread.anchor.range));
+    const opaqueOverlap = opaqueRanges.some((range) => rangesIntersect(range, anchor.range));
     if (opaqueOverlap) {
       preserveOnlyCommentIds.add(thread.commentId);
       additionalDiagnostics.push({
@@ -1120,13 +1127,13 @@ function normalizeImportedCommentThreads(
       });
       return {
         ...thread,
-        anchor: createDetachedAnchor(thread.anchor.range, "importAmbiguity"),
+        anchor: createDetachedAnchor(anchor.range, "importAmbiguity"),
         status: "detached",
       };
     }
 
     const preserveOnlyRevisionOverlap = preserveOnlyRevisionRanges.some((range) =>
-      rangesIntersect(range, thread.anchor.range),
+      rangesIntersect(range, anchor.range),
     );
     if (preserveOnlyRevisionOverlap) {
       preserveOnlyCommentIds.add(thread.commentId);
@@ -1139,7 +1146,7 @@ function normalizeImportedCommentThreads(
       });
       return {
         ...thread,
-        anchor: createDetachedAnchor(thread.anchor.range, "importAmbiguity"),
+        anchor: createDetachedAnchor(anchor.range, "importAmbiguity"),
         status: "detached",
       };
     }
@@ -1196,13 +1203,14 @@ function getStructuralPreserveOnlyReason(
   paragraphRanges: ReadonlyArray<{ start: number; end: number }>,
 ): string | undefined {
   const form = revision.metadata.importedRevisionForm;
-  if (!form || revision.anchor.kind !== "range") {
+  const { anchor } = revision;
+  if (!form || anchor.kind !== "range") {
     return undefined;
   }
 
   if (
     (form === "run-insertion" || form === "run-deletion") &&
-    revision.anchor.range.from === revision.anchor.range.to
+    anchor.range.from === anchor.range.to
   ) {
     return "Imported zero-width run revision remains preserve-only.";
   }
@@ -1210,9 +1218,9 @@ function getStructuralPreserveOnlyReason(
   if (form === "paragraph-insertion" || form === "paragraph-deletion") {
     const paragraphBoundary = paragraphRanges.find(
       (boundary) =>
-        boundary.end === revision.anchor.range.from ||
-        (revision.anchor.range.from >= boundary.start &&
-          revision.anchor.range.from <= boundary.end),
+        boundary.end === anchor.range.from ||
+        (anchor.range.from >= boundary.start &&
+          anchor.range.from <= boundary.end),
     );
     return paragraphBoundary
       ? undefined
@@ -1221,8 +1229,8 @@ function getStructuralPreserveOnlyReason(
 
   const paragraphBoundary = paragraphRanges.find(
     (boundary) =>
-      revision.anchor.range.from >= boundary.start &&
-      revision.anchor.range.to <= boundary.end,
+      anchor.range.from >= boundary.start &&
+      anchor.range.to <= boundary.end,
   );
   return paragraphBoundary
     ? undefined
@@ -1256,29 +1264,22 @@ function collectCanonicalParagraphRanges(
 }
 
 function measureCanonicalParagraph(paragraph: CanonicalDocumentEnvelope["content"]["children"][number] & { type: "paragraph" }): number {
-  return paragraph.children.reduce((size, child) => {
-    switch (child.type) {
-      case "text":
-        return size + child.text.length;
-      case "tab":
-      case "hard_break":
-      case "image":
-      case "opaque_inline":
-        return size + 1;
-      case "hyperlink":
-        return (
-          size +
-          child.children.reduce((childSize, entry) => {
-            switch (entry.type) {
-              case "text":
-                return childSize + entry.text.length;
-              case "tab":
-              case "hard_break":
-                return childSize + 1;
-            }
-          }, 0)
-        );
+  return paragraph.children.reduce<number>((size, child) => {
+    if (child.type === "text") {
+      return size + child.text.length;
     }
+    if (child.type === "hyperlink") {
+      return (
+        size +
+        child.children.reduce<number>((childSize, entry) => {
+          if (entry.type === "text") {
+            return childSize + entry.text.length;
+          }
+          return childSize + 1;
+        }, 0)
+      );
+    }
+    return size + 1;
   }, 0);
 }
 
@@ -1728,12 +1729,14 @@ function cloneRelationship(relationship: OpcRelationship): OpcRelationship {
   return { ...relationship };
 }
 
+const UTF8_DECODER = new TextDecoder("utf-8");
+
 function decodeUtf8(bytes: Uint8Array | undefined): string {
   if (!bytes) {
     return "";
   }
 
-  return new TextDecoder("utf-8").decode(bytes);
+  return UTF8_DECODER.decode(bytes);
 }
 
 function toUint8Array(bytes: Uint8Array | ArrayBuffer): Uint8Array {

package/src/io/export/serialize-comments.ts

@@ -255,15 +255,16 @@ export function serializeCommentAnchorsIntoDocumentXml(
     options.exportCommentIds ?? createCommentExportIdMap(threads);
 
   for (const thread of threads) {
-    if (thread.anchor.kind !== "range") {
+    const { anchor } = thread;
+    if (anchor.kind !== "range") {
       skippedCommentIds.push(thread.commentId);
       continue;
     }
 
     const paragraph = paragraphs.find(
       (candidate) =>
-        thread.anchor.range.from >= candidate.start &&
-        thread.anchor.range.to <= candidate.end,
+        anchor.range.from >= candidate.start &&
+        anchor.range.to <= candidate.end,
     );
 
     if (!paragraph) {
@@ -271,8 +272,8 @@ export function serializeCommentAnchorsIntoDocumentXml(
       continue;
     }
 
-    const startIndex = paragraph.boundaries.get(thread.anchor.range.from);
-    const endIndex = paragraph.boundaries.get(thread.anchor.range.to);
+    const startIndex = paragraph.boundaries.get(anchor.range.from);
+    const endIndex = paragraph.boundaries.get(anchor.range.to);
 
     if (startIndex === undefined || endIndex === undefined) {
       skippedCommentIds.push(thread.commentId);

package/src/io/export/serialize-headers-footers.ts

@@ -140,7 +140,12 @@ function serializeInlineNode(node: InlineNode): string {
     case "bookmark_end":
     case "column_break":
     case "symbol":
-      // These node types are not parsed from headers/footers by parse-headers-footers.ts
+    case "chart_preview":
+    case "smartart_preview":
+    case "shape":
+    case "wordart":
+    case "vml_shape":
+    default:
       return "";
   }
 }

package/src/io/export/serialize-main-document.ts

@@ -153,6 +153,15 @@ export function serializeMainDocument(
       continue;
     }
 
+    if (block.type === "section_break") {
+      if (block.propertiesXml) {
+        sectionPropertiesXml = block.propertiesXml;
+      }
+      cursor += 1;
+      previousWasParagraph = false;
+      continue;
+    }
+
     const blockXml = serializeOpaqueBlock(block, state);
     if (looksLikeSectionPropertiesXml(blockXml)) {
       sectionPropertiesXml = blockXml;
@@ -365,6 +374,12 @@ function serializeTableInlineNode(
       const childrenXml = node.children.map((child) => serializeTableInlineNode(child, state)).join("");
       return `${hyperlinkOpen}${childrenXml}</w:hyperlink>`;
     }
+    case "field":
+    case "bookmark_start":
+    case "bookmark_end":
+    case "footnote_ref":
+    default:
+      return "";
   }
 }
 
@@ -772,6 +787,15 @@ function serializeInlineNode(
         boundaries,
       };
     }
+    case "field":
+    case "bookmark_start":
+    case "bookmark_end":
+    case "footnote_ref":
+    default: {
+      const boundaries = new Map<number, number>();
+      boundaries.set(cursor, xmlOffset);
+      return { xml: "", cursor, boundaries };
+    }
   }
 }
 

package/src/io/export/serialize-runtime-revisions.ts

@@ -94,13 +94,17 @@ function createRangeRevisionReplacement(
   boundaries: readonly RevisionParagraphBoundary[],
   revision: RevisionRecord,
 ): XmlReplacement | undefined {
-  const paragraphBoundary = findParagraphBoundaryForRange(boundaries, revision.anchor.range.from, revision.anchor.range.to);
+  const { anchor } = revision;
+  if (anchor.kind !== "range") {
+    return undefined;
+  }
+  const paragraphBoundary = findParagraphBoundaryForRange(boundaries, anchor.range.from, anchor.range.to);
   if (!paragraphBoundary) {
     return undefined;
   }
 
-  const startIndex = paragraphBoundary.boundaries.get(revision.anchor.range.from);
-  const endIndex = paragraphBoundary.boundaries.get(revision.anchor.range.to);
+  const startIndex = paragraphBoundary.boundaries.get(anchor.range.from);
+  const endIndex = paragraphBoundary.boundaries.get(anchor.range.to);
   if (startIndex === undefined || endIndex === undefined || endIndex < startIndex) {
     return undefined;
   }

package/src/io/normalize/normalize-text.ts

@@ -368,14 +368,11 @@ function normalizeHyperlink(node: ParsedHyperlinkNode): {
 }
 
 function measureHyperlink(node: ParsedHyperlinkNode): number {
-  return node.children.reduce((size, child) => {
-    switch (child.type) {
-      case "text":
-        return size + child.text.length;
-      case "tab":
-      case "hard_break":
-        return size + 1;
+  return node.children.reduce<number>((size, child) => {
+    if (child.type === "text") {
+      return size + child.text.length;
     }
+    return size + 1;
   }, 0);
 }
 

package/src/io/ooxml/parse-comments.ts

@@ -124,14 +124,15 @@ export function parseCommentsFromOoxml(
     }));
     const createdBy = rootDefinition.authorId ?? entries[0]?.authorId ?? "unknown";
     const createdAt = rootDefinition.createdAt ?? entries[0]?.createdAt ?? "1970-01-01T00:00:00.000Z";
+    const lastEntry = entries.length > 0 ? entries[entries.length - 1] : undefined;
     const resolution =
       rootDefinition.isDone
         ? {
-            resolvedAt: entries.at(-1)?.createdAt ?? createdAt,
-            resolvedBy: entries.at(-1)?.authorId ?? createdBy,
+            resolvedAt: lastEntry?.createdAt ?? createdAt,
+            resolvedBy: lastEntry?.authorId ?? createdBy,
           }
         : undefined;
-    const detachedRange = toDetachedRange(anchor);
+    const detachedRange = anchor ? toDetachedRange(anchor) : { from: 0, to: 0 };
 
     if (
       start === undefined ||

package/src/io/ooxml/parse-main-document.ts

@@ -1249,7 +1249,7 @@ function parseHyperlink(
     };
   }
 
-  const children: Array<ParsedTextNode | ParsedBreakNode | ParsedTabNode> = [];
+  const children: Array<ParsedTextNode | ParsedBreakNode | ParsedColumnBreakNode | ParsedTabNode | ParsedSymbolNode> = [];
 
   for (const child of node.children) {
     if (child.type !== "element") {

package/src/legal/cross-references.ts

@@ -80,7 +80,7 @@ export function parseCrossReferencesFromDocumentXml(xml: string): CrossReference
       });
     }
 
-    for (const pattern of detectCrossReferencePatterns(flattenParagraphText(block))) {
+    for (const pattern of detectCrossReferencePatterns(flattenParagraphText(block as unknown as ParagraphNode))) {
       results.push({
         source: "text-pattern",
         kind: pattern.kind,

package/src/legal/defined-terms.ts

@@ -35,7 +35,7 @@ export function collectDefinedTermsFromDocumentXml(xml: string): DefinedTerm[] {
   const parsed = parseMainDocumentXml(xml);
   const paragraphs = parsed.blocks
     .filter((block): block is typeof parsed.blocks[number] & { type: "paragraph" } => block.type === "paragraph")
-    .map(flattenParagraphText);
+    .map((block) => flattenParagraphText(block as unknown as ParagraphNode));
 
   return buildDefinedTermCatalog(paragraphs);
 }

package/src/model/canonical-document.ts

@@ -56,7 +56,7 @@ export interface CanonicalDocument {
   styles: StylesCatalog;
   numbering: NumberingCatalog;
   media: MediaCatalog;
-  content: DocumentNode;
+  content: DocumentRootNode;
   review: ReviewStore;
   preservation: PreservationStore;
   diagnostics: DiagnosticStore;
@@ -70,6 +70,7 @@ export interface DocumentMetadata {
   language?: string;
   keywords?: string[];
   category?: string;
+  importMode?: string;
   customProperties: Record<string, string>;
 }
 
@@ -456,7 +457,9 @@ export interface SectionBreakNode {
 export type InlineNode =
   | TextNode
   | HardBreakNode
+  | ColumnBreakNode
   | TabNode
+  | SymbolNode
   | HyperlinkNode
   | ImageNode
   | FieldNode
@@ -765,6 +768,7 @@ export interface DiagnosticErrorEntry {
   diagnosticId: string;
   code:
     | "load_failed"
+    | "import_failed"
     | "export_failed"
     | "package_corrupt"
     | "validation_failed"
@@ -773,6 +777,7 @@ export interface DiagnosticErrorEntry {
   message: string;
   isFatal: boolean;
   source: "import" | "runtime" | "validation" | "datastore" | "export";
+  details?: unknown;
 }
 
 export function createCanonicalDocument(

package/src/review/store/revision-store.ts

@@ -13,6 +13,8 @@ import {
   type RevisionStatus,
 } from "./revision-types.ts";
 
+export type { RevisionRecord, RevisionKind, RevisionStatus } from "./revision-types.ts";
+
 export interface RevisionStore {
   version: "revision-store/1";
   revisions: Record<string, RevisionRecord>;

package/src/runtime/document-runtime.ts

@@ -133,6 +133,8 @@ export function createDocumentRuntime(
     source: options.sourceKind ?? (options.initialSnapshot ? "snapshot" : "canonical"),
     stats: toPublicDocumentStats(state),
     compatibility: toPublicCompatibilityReport(createDerivedCompatibility(state)),
+    comments: cachedRenderSnapshot.comments,
+    trackedChanges: cachedRenderSnapshot.trackedChanges,
   });
   if (options.fatalError) {
     emit({

package/src/runtime/revision-runtime.ts

@@ -42,7 +42,7 @@ export function applyRevisionRuntimeCommand(
     : listBatchRevisionIds(options.state.store);
 
   const outcomes: RevisionActionOutcome[] = [];
-  const mappings: Array<{ revisionId: string; steps: number }> = [];
+  const mappings: Array<{ revisionId: string; mapping: TransactionMapping; steps: number }> = [];
   const appliedRevisionIds: string[] = [];
   const detachedRevisionIds = new Set<string>();
 

package/src/runtime/surface-projection.ts

@@ -14,6 +14,7 @@ import type {
   ChartPreviewNode,
   DocumentRootNode,
   InlineNode,
+  MediaCatalog,
   ParagraphNode,
   SdtNode,
   ShapeNode,
@@ -165,6 +166,26 @@ function createSurfaceBlock(
     };
   }
 
+  if (block.type === "section_break") {
+    const blockId = `section-break-${counters.opaque}`;
+    counters.opaque += 1;
+    return {
+      block: {
+        blockId,
+        kind: "opaque_block",
+        from: cursor,
+        to: cursor + 1,
+        fragmentId: blockId,
+        warningId: blockId,
+        label: "Section break",
+        detail: "Section properties preserved as a read-only boundary.",
+        state: "locked-preserve-only",
+      },
+      lockedFragmentIds: [],
+      nextCursor: cursor + 1,
+    };
+  }
+
   const paragraphIndex = counters.paragraph;
   counters.paragraph += 1;
   return createParagraphBlock(paragraphIndex, block, document, cursor);
@@ -394,6 +415,14 @@ function appendInlineSegments(
       return appendComplexPreviewSegment(paragraph, node, start, "WordArt", createWordArtDetail(node));
     case "vml_shape":
       return appendComplexPreviewSegment(paragraph, node, start, "VML shape", createVmlDetail(node));
+    case "column_break":
+    case "symbol":
+    case "field":
+    case "bookmark_start":
+    case "bookmark_end":
+    case "footnote_ref":
+    default:
+      return { nextCursor: start + 1, lockedFragmentIds: [] };
   }
 }
 
@@ -499,7 +528,18 @@ function createPlainText(
 }
 
 function cloneMarks(marks: TextMark[]): Array<"bold" | "italic" | "underline" | "strikethrough"> {
-  return marks.map((mark) => mark.type);
+  const supported: Array<"bold" | "italic" | "underline" | "strikethrough"> = [];
+  for (const mark of marks) {
+    if (
+      mark.type === "bold" ||
+      mark.type === "italic" ||
+      mark.type === "underline" ||
+      mark.type === "strikethrough"
+    ) {
+      supported.push(mark.type);
+    }
+  }
+  return supported;
 }
 
 function normalizeDocumentRoot(content: unknown): DocumentRootNode {
@@ -556,15 +596,6 @@ function createFloatingImageDetail(
   return parts.join(" ");
 }
 
-function hasMediaItem(media: Record<string, unknown>, mediaId: string): boolean {
-  if (mediaId in media) {
-    return true;
-  }
-
-  const items = media.items;
-  if (!items || typeof items !== "object" || Array.isArray(items)) {
-    return false;
-  }
-
-  return mediaId in items;
+function hasMediaItem(media: MediaCatalog, mediaId: string): boolean {
+  return mediaId in media.items;
 }

package/src/runtime/table-commands.ts

@@ -60,22 +60,22 @@ function withTableGuard(
   };
 }
 
-export const addRowBefore: PMCommand = (state, dispatch, view) =>
-  pmAddRowBefore(state, dispatch, view);
+export const addRowBefore: PMCommand = (state, dispatch) =>
+  pmAddRowBefore(state, dispatch);
 
-export const addRowAfter: PMCommand = (state, dispatch, view) =>
-  pmAddRowAfter(state, dispatch, view);
+export const addRowAfter: PMCommand = (state, dispatch) =>
+  pmAddRowAfter(state, dispatch);
 
 export const deleteRow: PMCommand = withTableGuard((state) => {
   const table = tableAtSelection(state);
   return table !== null && table.childCount > 1;
 }, pmDeleteRow);
 
-export const addColumnBefore: PMCommand = (state, dispatch, view) =>
-  pmAddColumnBefore(state, dispatch, view);
+export const addColumnBefore: PMCommand = (state, dispatch) =>
+  pmAddColumnBefore(state, dispatch);
 
-export const addColumnAfter: PMCommand = (state, dispatch, view) =>
-  pmAddColumnAfter(state, dispatch, view);
+export const addColumnAfter: PMCommand = (state, dispatch) =>
+  pmAddColumnAfter(state, dispatch);
 
 export const deleteColumn: PMCommand = withTableGuard((state) => {
   const table = tableAtSelection(state);

package/src/ui/WordReviewEditor.tsx

@@ -112,6 +112,8 @@ export function __createWordReviewEditorRefBridge(
     getSnapshot: () => runtime.getPersistedSnapshot(),
     getCompatibilityReport: () => runtime.getCompatibilityReport(),
     getWarnings: () => runtime.getWarnings(),
+    getComments: () => runtime.getRenderSnapshot().comments,
+    getTrackedChanges: () => runtime.getRenderSnapshot().trackedChanges,
   };
 }
 
@@ -496,6 +498,8 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
         getSnapshot: () => activeRuntime.getPersistedSnapshot(),
         getCompatibilityReport: () => activeRuntime.getCompatibilityReport(),
         getWarnings: () => activeRuntime.getWarnings(),
+        getComments: () => activeRuntime.getRenderSnapshot().comments,
+        getTrackedChanges: () => activeRuntime.getRenderSnapshot().trackedChanges,
       }),
       [activeRuntime, currentUser.userId, documentId, runtime],
     );
@@ -1289,6 +1293,8 @@ function createReadyEvent(
     source,
     stats: snapshot.documentStats,
     compatibility: runtime.getCompatibilityReport(),
+    comments: snapshot.comments,
+    trackedChanges: snapshot.trackedChanges,
   };
 }
 

package/src/ui-tailwind/editor-surface/tw-table-node-view.tsx

@@ -9,6 +9,7 @@
  */
 
 import type { Node as PMNode } from "prosemirror-model";
+import type { NodeViewConstructor, ViewMutationRecord } from "prosemirror-view";
 
 const TABLE_LAYOUT_SYNC_EVENT = "pm-table-layout-sync";
 
@@ -251,7 +252,7 @@ export class TableNodeView {
     this.dom.removeEventListener(TABLE_LAYOUT_SYNC_EVENT, this.onSyncRequest);
   }
 
-  ignoreMutation(record: MutationRecord): boolean {
+  ignoreMutation(record: ViewMutationRecord): boolean {
     return record.type === "attributes" && record.target === this.dom;
   }
 
@@ -336,7 +337,7 @@ export class TableCellNodeView {
     return true;
   }
 
-  ignoreMutation(record: MutationRecord): boolean {
+  ignoreMutation(record: ViewMutationRecord): boolean {
     return record.type === "attributes" && record.target === this.dom;
   }
 }
@@ -347,7 +348,7 @@ export class TableCellNodeView {
  * Pass this object directly to the EditorView constructor options:
  *   new EditorView(mount, { nodeViews: tableNodeViews, ... })
  */
-export const tableNodeViews = {
+export const tableNodeViews: { [node: string]: NodeViewConstructor } = {
   table: (node: PMNode) => new TableNodeView(node),
   table_row: (node: PMNode) => new TableRowNodeView(node),
   table_cell: (node: PMNode) => new TableCellNodeView(node),

package/src/validation/compatibility-engine.ts

@@ -200,6 +200,20 @@ function measureInlineNode(
     case "opaque_inline":
       flags.runs = true;
       return 1;
+    case "column_break":
+    case "symbol":
+    case "field":
+    case "bookmark_start":
+    case "bookmark_end":
+    case "footnote_ref":
+    case "chart_preview":
+    case "smartart_preview":
+    case "shape":
+    case "wordart":
+    case "vml_shape":
+    default:
+      flags.runs = true;
+      return 1;
   }
 }
 

package/src/validation/compatibility-report.ts

@@ -147,7 +147,7 @@ export type {
   EditorWarning,
 } from "./diagnostics.ts";
 
-function flattenUnique<Value extends { [key: string]: unknown }>(
+function flattenUnique<Value extends object>(
   items: readonly Value[],
 ): readonly Value[] {
   const deduped = new Map<string, Value>();