@beyondwork/docx-react-component 1.0.99 → 1.0.101

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@beyondwork/docx-react-component",
   "publisher": "beyondwork",
-  "version": "1.0.99",
+  "version": "1.0.101",
   "description": "Embeddable React Word (docx) editor with review, comments, tracked changes, and round-trip OOXML fidelity.",
   "type": "module",
   "sideEffects": [
@@ -204,6 +204,14 @@
     "ci-check:headless-example-imports": "node scripts/ci-check-headless-example-imports.mjs",
     "ci-check:no-legacy-presentation": "node scripts/ci-check-no-legacy-presentation.mjs",
     "ci-check:layer-11-boundary": "node scripts/ci-check-layer-11-boundary.mjs",
-    "ci-check:layer-11-boundary:update": "node scripts/ci-check-layer-11-boundary.mjs --update"
+    "ci-check:layer-11-boundary:update": "node scripts/ci-check-layer-11-boundary.mjs --update",
+    "lint:tsgo:harness": "pnpm --filter @docx-react-component/react-word-editor-harness lint:tsgo",
+    "harness:dev": "pnpm --filter @docx-react-component/react-word-editor-harness dev",
+    "mcp:tool-runner:sync": "bash scripts/tool-runner-sync.sh",
+    "mcp:tool-runner:knowledge": "bash scripts/tool-runner-mcp.sh knowledge",
+    "mcp:tool-runner:visual-smoke": "bash scripts/tool-runner-mcp.sh visual-smoke",
+    "mcp:tool-runner:ooxml-validator": "bash scripts/tool-runner-mcp.sh ooxml-validator",
+    "mcp:tool-runner:truth": "bash scripts/tool-runner-mcp.sh truth",
+    "mcp:tool-runner:scope-calibration": "bash scripts/tool-runner-mcp.sh scope-calibration"
   }
 }

package/src/runtime/document-runtime.ts

@@ -294,6 +294,7 @@ import type {
   ParagraphNode,
   SectionProperties,
   SubPartsCatalog,
+  TocCachedEntry,
   TocRegion,
 } from "../model/canonical-document.ts";
 import {
@@ -7550,14 +7551,16 @@ function refreshDocumentTableOfContents(
         : parseTocLevelRange(field.instruction);
     const entries = navigation.headings
       .filter((heading) => heading.level >= levelRange.from && heading.level <= levelRange.to)
-      .map((heading) => {
+      .map((heading, index) => {
         const bookmarkName = bookmarkNameByOffset.get(heading.offset);
-        return {
+        const entry: RuntimeTocEntry = {
           level: heading.level,
           text: heading.text,
           pageIndex: heading.pageIndex,
           ...(bookmarkName ? { bookmarkName } : {}),
         };
+        const cachedPageText = resolveCachedTocPageText(selectedRegion, entry, index);
+        return cachedPageText ? { ...entry, pageText: cachedPageText } : entry;
       });
     if (resultEntries.length === 0) {
       resultEntries = entries;
@@ -7657,6 +7660,7 @@ type RuntimeTocEntry = {
   level: number;
   text: string;
   pageIndex: number;
+  pageText?: string;
   bookmarkName?: string;
 };
 
@@ -7688,11 +7692,54 @@ function buildTocRefreshResult(
       level: entry.level,
       text: entry.text,
       pageIndex: entry.pageIndex,
+      ...(entry.pageText ? { pageText: entry.pageText } : {}),
       source: "generated",
     })),
   };
 }
 
+function resolveCachedTocPageText(
+  region: TocRegion | undefined,
+  entry: RuntimeTocEntry,
+  index: number,
+): string | undefined {
+  if (!region || region.cachedEntries.length === 0) {
+    return undefined;
+  }
+  const indexed = region.cachedEntries[index];
+  if (indexed?.pageText && cachedTocEntryMatchesRuntimeEntry(indexed, entry)) {
+    return indexed.pageText;
+  }
+  if (entry.bookmarkName) {
+    const bookmarkMatch = region.cachedEntries.find(
+      (cached) =>
+        cached.bookmarkName === entry.bookmarkName &&
+        cached.pageText &&
+        cached.level === entry.level,
+    );
+    if (bookmarkMatch?.pageText) {
+      return bookmarkMatch.pageText;
+    }
+  }
+  return undefined;
+}
+
+function cachedTocEntryMatchesRuntimeEntry(
+  cached: TocCachedEntry,
+  entry: RuntimeTocEntry,
+): boolean {
+  return cached.level === entry.level &&
+    normalizeTocEntryPageReuseText(cached.text) === normalizeTocEntryPageReuseText(entry.text);
+}
+
+function normalizeTocEntryPageReuseText(text: string): string {
+  return text
+    .replace(/\s+/gu, " ")
+    .trim()
+    .replace(/^(\d+(?:\.\d+)*\.?)\s+/u, "$1")
+    .toLowerCase();
+}
+
 function tocPageTextToPageIndex(pageText: string | undefined): number {
   const value = Number.parseInt(pageText ?? "", 10);
   return Number.isFinite(value) && value > 0 ? value - 1 : 0;
@@ -7873,7 +7920,7 @@ function buildTocEntryInlineNodes(
     children.push({ type: "text", text: entry.text });
   }
   children.push({ type: "tab" });
-  const displayed = resolveDisplayPageNumber?.(entry.pageIndex);
+  const displayed = entry.pageText ?? resolveDisplayPageNumber?.(entry.pageIndex);
   children.push({
     type: "text",
     text: String(displayed ?? entry.pageIndex + 1),
@@ -8056,7 +8103,7 @@ function buildInlineNodesFromDisplayText(text: string): InlineNode[] {
  * resolver, falls back to the raw `pageIndex + 1` (pre-P5 behavior).
  */
 function buildTocInlineNodes(
-  entries: ReadonlyArray<{ level: number; text: string; pageIndex: number; bookmarkName?: string }>,
+  entries: ReadonlyArray<{ level: number; text: string; pageIndex: number; pageText?: string; bookmarkName?: string }>,
   resolveDisplayPageNumber?: (pageIndex: number) => number | null,
 ): InlineNode[] {
   const children: InlineNode[] = [];
@@ -8071,7 +8118,7 @@ function buildTocInlineNodes(
       children.push({ type: "text", text: entry.text });
     }
     children.push({ type: "tab" });
-    const displayed = resolveDisplayPageNumber?.(entry.pageIndex);
+    const displayed = entry.pageText ?? resolveDisplayPageNumber?.(entry.pageIndex);
     children.push({
       type: "text",
       text: String(displayed ?? entry.pageIndex + 1),
@@ -8085,7 +8132,7 @@ function buildTocInlineNodes(
 
 /** Test-only export of `buildTocInlineNodes` (P5 unit tests). */
 export function __buildTocInlineNodes(
-  entries: ReadonlyArray<{ level: number; text: string; pageIndex: number; bookmarkName?: string }>,
+  entries: ReadonlyArray<{ level: number; text: string; pageIndex: number; pageText?: string; bookmarkName?: string }>,
   resolveDisplayPageNumber?: (pageIndex: number) => number | null,
 ): InlineNode[] {
   return buildTocInlineNodes(entries, resolveDisplayPageNumber);

package/src/runtime/layout/layout-engine-version.ts

@@ -467,7 +467,7 @@
  *       undefined (F01 + 10 single-column CCEP regression preserved).
  *       Section-level `<w:type w:val="nextColumn"/>` still degrades to
  *       `continuous`-style page merging — cross-section column-state
- *       carry is explicit follow-up work (tracked on react-refactor).
+ *       carry is explicit follow-up work (tracked on pe2).
  *       Cache envelopes from v37 invalidate because the per-page
  *       fragment routing under multi-column layouts changes; single-
  *       column envelopes remain shape-compatible but the version bump

package/src/ui/editor-surface-controller.tsx

@@ -87,7 +87,7 @@ export interface EditorSurfaceControllerProps {
   /**
    * Coord-10 L11-4 — forwarded to `TwProseMirrorSurface`. Threaded
    * from `api.runtime.workflow.createScopeTagRegistry` (shipped by
-   * L06 in react-refactor `534f2b97`). Replaces the pre-L06-catalog
+   * L06 in pe2 `534f2b97`). Replaces the pre-L06-catalog
    * pragmatic public-types re-export (refactor/11 §4.17, 2026-04-24
    * `7a2d2fc0`). When absent, `TwProseMirrorSurface` falls back to
    * the public-types re-export for test / headless mount back-compat.

package/src/ui-tailwind/editor-surface/tw-prosemirror-surface.tsx

@@ -26,7 +26,7 @@ import type {
 import type { CanonicalDocumentEnvelope } from "../../api/public-types.ts";
 // §4.8 · refactor/11 — search + table descriptor access moved to the
 // Runtime API v3 seam (`runtime.search.searchDocument` +
-// `runtime.table.getSelectionDescriptor`, both shipped in react-refactor
+// `runtime.table.getSelectionDescriptor`, both shipped in pe2
 // `eb98ae06`). The PM surface receives them as host-supplied callbacks
 // instead of importing from `src/runtime/**` directly. `TableSelectionDescriptor`
 // is re-exported from the v3 table family so consumers don't peek into