@beyondwork/docx-react-component 1.0.47 → 1.0.49

package/README.md

@@ -224,17 +224,22 @@ The CCEP corpus is kept on `main` as a maintainer-safe smoke-doc source set for
 
 Engineering work is organized into 9 lanes (5 active now + 2 later polish + 2 final) — full plan index, status, and worktree map at [`docs/plans/README.md`](docs/plans/README.md). Each lane has a single self-contained doc at `docs/plans/lane-N-<name>.md`:
 
-| Lane | Mission | Status |
-|---|---|---|
-| 1. [**Editing Foundation**](docs/plans/lane-1-editing-foundation.md) | Close I1–I6 + ship the SelectionLayer / EditLayer / StructureLayer / SurfaceLayer split | active |
-| 2. [**Render Performance**](docs/plans/lane-2-render-performance.md) | <32 ms typing P50 + <1 s cold-open on 200-page CCEP; never stuck on loading | active |
-| 3. [**Layout Engine + OOXML Fidelity**](docs/plans/lane-3-layout-engine-ooxml-fidelity.md) | Land P9 anchor-index + P10 incremental relayout + drain O2/O3/O4 round-trip + tables/TOC/page numbers/front pages/image structures | active |
-| 4. [**Collab + CLM/Vallor Integration**](docs/plans/lane-4-collab-clm-vallor.md) | Promote collab plumbing → first-class user mode; wire Sunday CLM × React E2E demo | active |
-| 5. [**Charts (independent)**](docs/plans/lane-5-charts.md) | Move charts from preserve-only opaque preview to Word-accurate native rendering (Stages 1–7) | active |
-| 6. [**Visual Chrome / Layout Polish**](docs/plans/lane-6-visual-chrome-layout-polish.md) | True-to-Word visuals: discrete paper cards, native page chrome, float-wrap, validation bar | LATER |
-| 7. [**Bugs / Gaps / Cross-cutting**](docs/plans/lane-7-bugs-gaps-cross-cutting.md) | Drain V#/O#/X# register; trigger-gated work; infrastructure hardening | LATER |
-| 8. [**API Ergonomics / Errors / Backwards Compatibility**](docs/plans/lane-8-api-ergonomics.md) | Refactor `docs/reference/public-api.md` end-to-end with groups + per-code error catalog + ergonomics fixes; maintain backwards compat | LATER (Tracks A+C shipped 2026-04-19) |
-| 9. [**Shipping**](docs/plans/lane-9-shipping.md) | Production-readiness: API freeze, semver discipline, changelog, telemetry, customer migration guides, doc completeness audit | FINAL |
+**Progress snapshot — 2026-04-19 (post PR #189 + #190 + #191 + #192 merged to `main`; Lane 3 split into 3a + 3b on 2026-04-19 deep evening):**
+
+| # | Lane | % to goal | Status summary |
+|---|---|---|---|
+| 1 | [**Editing Foundation**](docs/plans/lane-1-editing-foundation.md) | **65%** | I1–I6 + I3 widening + I4 + S1 + X3 + I8 shipped; I2B / I7 / R.1–R.5 backlog |
+| 2 | [**Render Performance**](docs/plans/lane-2-render-performance.md) | **85%** | All Phases 1.x + 2.2 + 2.4b + 2.5 (A+B) + 2.9 shipped; Tasks 2.1 / 2.3 left |
+| 3a | [**Layout & Render Engine**](docs/plans/lane-3a-layout-render-engine.md) | **45%** | P1–P6 + P8 + P14.a/b/e shipped; P9 (now unblocked) + P10 + P11 + P12 + P14.c/d backlog |
+| 3b | [**OOXML Fidelity & Round-Trip**](docs/plans/lane-3b-ooxml-fidelity.md) | **55%** | V1 + O3 + O4 + O2 (all 4 slices) + V7 closed; 🚨 O8 + L2.c + V6 + V2a/b/c + R3–R5 backlog |
+| 4 | [**Collab + CLM/Vallor**](docs/plans/lane-4-collab-clm-vallor.md) | **80%** | P1–P14 + all P11 sub-bullets + P12 + perf-parity + P13 A/B/C shipped; P15 / P16 / P17 left |
+| 5 | [**Charts (independent)**](docs/plans/lane-5-charts.md) | **30%** | Stages 0–2 shipped (parsers + theme); Stages 3–7 (SVG renderers + pixel-diff) left |
+| 6 | [**Visual Chrome / Layout Polish**](docs/plans/lane-6-visual-chrome-layout-polish.md) | **0%** | LATER — activates after Lane 3b V2c + Lane 2 Phase 2.2 ship; discrete paper cards, native chrome, float-wrap, validation bar |
+| 7 | [**Bugs / Gaps / Cross-cutting**](docs/plans/lane-7-bugs-gaps-cross-cutting.md) | **0%** | LATER — drain V#/O#/X# register, trigger-gated work, infrastructure hardening |
+| 8 | [**API Ergonomics / Errors / BC**](docs/plans/lane-8-api-ergonomics.md) | **40%** | LATER — Tracks A+C shipped (error catalog + ergonomics fixes); Tracks B+D+E + public-api.md end-to-end refactor remain |
+| 9 | [**Shipping (v2.0.0)**](docs/plans/lane-9-shipping.md) | **0%** | FINAL — API freeze, semver discipline, changelog, telemetry, customer migration guides, doc completeness audit |
+
+**Aggregate v2.0.0 readiness:** ~70% — long poles are Lane 3 O8 + P9/P10, Lane 4 P15/P16/P17, Lane 1 R.1–R.5, Lane 5 Stage 4 SVG renderers (Lane 5 ships on independent v2.x cadence). Detailed task-completeness factor + per-lane backlog inventory in [`docs/plans/coordination-prompt.md`](docs/plans/coordination-prompt.md).
 
 ### Technical Wiki
 

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@beyondwork/docx-react-component",
   "publisher": "beyondwork",
-  "version": "1.0.47",
+  "version": "1.0.49",
   "description": "Embeddable React Word (docx) editor with review, comments, tracked changes, and round-trip OOXML fidelity.",
-  "packageManager": "pnpm@10.30.3",
   "type": "module",
   "sideEffects": [
     "**/*.css"
@@ -93,35 +92,6 @@
     "./ui-tailwind/theme/editor-theme.css": "./src/ui-tailwind/theme/editor-theme.css"
   },
   "types": "./src/index.ts",
-  "scripts": {
-    "build": "tsup",
-    "test": "bash scripts/run-workspace-tests.sh",
-    "test:repo": "node scripts/ci-check-layout-engine-version.mjs && node scripts/run-repo-tests.mjs core",
-    "test:repo:all": "node scripts/run-repo-tests.mjs all",
-    "test:repo:optional": "node scripts/run-repo-tests.mjs optional",
-    "test:repo:browser-ui": "node scripts/run-repo-tests.mjs browser-ui",
-    "test:wcag-audit": "node scripts/run-repo-tests.mjs wcag-audit",
-    "test:harness": "pnpm --filter @docx-react-component/react-word-editor-harness test",
-    "test:visual": "VISUAL_SMOKE_PROFILE=bare pnpm exec playwright test --project=chromium",
-    "test:visual:chrome": "VISUAL_SMOKE_PROFILE=chrome-cycle pnpm exec playwright test --project=chromium",
-    "visual:list-runs": "node scripts/visual-smoke-list-runs.mjs",
-    "mcp:visual-smoke": "node scripts/visual-smoke-mcp.mjs",
-    "lint": "pnpm run lint:no-authored-js && pnpm run lint:docs-contracts && pnpm run lint:tsgo && pnpm run lint:tsgo:harness",
-    "lint:docs-contracts": "bash scripts/check-reference-load-contract.sh",
-    "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",
-    "wave:launch": "bash scripts/context7-export-env.sh run pnpm exec wave launch --lane main",
-    "wave:launch:managed": "bash scripts/wave-launch.sh",
-    "wave:status": "bash scripts/wave-status.sh",
-    "wave:watch": "bash scripts/wave-watch.sh --follow",
-    "wave:dashboard:current": "bash scripts/wave-dashboard-attach.sh current",
-    "wave:dashboard:global": "bash scripts/wave-dashboard-attach.sh global",
-    "harness:dev": "pnpm --filter @docx-react-component/react-word-editor-harness dev"
-  },
   "keywords": [
     "docx",
     "word",
@@ -205,14 +175,33 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.30"
   },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild",
-      "sharp"
-    ],
-    "overrides": {
-      "react": "19.2.4",
-      "react-dom": "19.2.4"
-    }
+  "scripts": {
+    "build": "tsup",
+    "test": "bash scripts/run-workspace-tests.sh",
+    "test:repo": "node scripts/ci-check-layout-engine-version.mjs && node scripts/run-repo-tests.mjs core",
+    "test:repo:all": "node scripts/run-repo-tests.mjs all",
+    "test:repo:optional": "node scripts/run-repo-tests.mjs optional",
+    "test:repo:browser-ui": "node scripts/run-repo-tests.mjs browser-ui",
+    "test:wcag-audit": "node scripts/run-repo-tests.mjs wcag-audit",
+    "test:harness": "pnpm --filter @docx-react-component/react-word-editor-harness test",
+    "test:visual": "VISUAL_SMOKE_PROFILE=bare pnpm exec playwright test --project=chromium",
+    "test:visual:chrome": "VISUAL_SMOKE_PROFILE=chrome-cycle pnpm exec playwright test --project=chromium",
+    "visual:list-runs": "node scripts/visual-smoke-list-runs.mjs",
+    "mcp:visual-smoke": "node scripts/visual-smoke-mcp.mjs",
+    "lint": "pnpm run lint:no-authored-js && pnpm run lint:docs-contracts && pnpm run lint:tsgo && pnpm run lint:tsgo:harness",
+    "lint:docs-contracts": "bash scripts/check-reference-load-contract.sh",
+    "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",
+    "wave:launch": "bash scripts/context7-export-env.sh run pnpm exec wave launch --lane main",
+    "wave:launch:managed": "bash scripts/wave-launch.sh",
+    "wave:status": "bash scripts/wave-status.sh",
+    "wave:watch": "bash scripts/wave-watch.sh --follow",
+    "wave:dashboard:current": "bash scripts/wave-dashboard-attach.sh current",
+    "wave:dashboard:global": "bash scripts/wave-dashboard-attach.sh global",
+    "harness:dev": "pnpm --filter @docx-react-component/react-word-editor-harness dev"
   }
-}
+}

package/src/api/public-types.ts

@@ -1,8 +1,10 @@
 import type { PersistedEditorSnapshot as RuntimePersistedEditorSnapshot } from "../core/state/editor-state.ts";
-import type { CanonicalParagraphFormatting, CanonicalRunFormatting } from "../model/canonical-document.ts";
+import type { HarnessDebugPorts } from "../internal/harness-debug-ports.ts";
+import type { CanonicalParagraphFormatting, CanonicalRunFormatting, TextMark } from "../model/canonical-document.ts";
 import type { WordReviewEditorLayoutFacet } from "../runtime/layout/public-facet.ts";
 import type { RenderFrameRect } from "../runtime/render/index.ts";
 import type { ScopeRailPosture } from "../runtime/workflow-rail-segments.ts";
+import type { SharedWorkflowState } from "../runtime/collab/workflow-shared.ts";
 import type {
   MetadataPersistenceMode,
   ScopeMetadataPersistence,
@@ -46,6 +48,7 @@ export type {
 };
 
 export type { CanonicalParagraphFormatting, CanonicalRunFormatting };
+export type { SharedWorkflowState };
 
 export type {
   WordReviewEditorLayoutFacet,
@@ -750,6 +753,25 @@ export interface InsertImageOptions {
   altText?: string;
 }
 
+/** Re-export canonical `TextMark` so hosts can construct explicit-mode directives for I7 `replaceText`. */
+export type { TextMark };
+
+/**
+ * I7 — `replaceText` / `text.insert` formatting directive.
+ *
+ * - `paragraph-default` (default): inserted text carries no run marks; the paragraph-level
+ *   cascade applies. Pre-I7 behavior.
+ * - `match-replaced-range`: walk text units within the replaced range; if all share the
+ *   same marks, apply them to the inserted text. Mixed ranges fall back to
+ *   `paragraph-default`. For collapsed (empty) ranges the marks of the run immediately
+ *   left of the caret are used (Word-matching behavior).
+ * - `explicit`: apply the caller-supplied `marks` verbatim.
+ */
+export type TextFormattingDirective =
+  | { mode: "paragraph-default" }
+  | { mode: "match-replaced-range" }
+  | { mode: "explicit"; marks: TextMark[] };
+
 export type SurfaceTextMark =
   | "bold"
   | "italic"
@@ -1685,6 +1707,16 @@ export interface AddCommentParams {
   anchor?: EditorAnchorProjection;
   body?: string;
   authorId?: string;
+  /**
+   * I8 — When `true`, anchors that would be rejected with reason
+   * `comment_anchor_table_adjacent` are auto-snapped to the enclosing
+   * paragraph boundaries before the comment is created. Defaults to
+   * `false` for back-compat. Removed once Lane 3 §O8 lands the deep
+   * serializer fix and mid-run-near-table anchors no longer need
+   * mitigation — the option stays useful for hosts that prefer
+   * boundary-aligned comments regardless.
+   */
+  snapToSafeBoundary?: boolean;
 }
 
 export interface AddCommentResult {
@@ -1697,6 +1729,38 @@ export interface AddCommentReplyResult {
   entryId: string;
 }
 
+/**
+ * S1 — Scope marker anchoring. Parameters for `WordReviewEditorRef.addScope`.
+ * The runtime inserts a pair of zero-width `scope_marker_*` inline nodes at
+ * the anchor's range boundaries so PM handles position bookkeeping through
+ * text edits structurally (no remap-on-mutation required).
+ */
+export interface AddScopeParams {
+  /** Range anchor (typically `getRenderSnapshot().selection.activeRange`). */
+  anchor: EditorAnchorProjection;
+  /** Optional explicit scopeId; runtime mints one when omitted. */
+  scopeId?: string;
+  /** Workflow mode the scope enters (default `"comment"`). */
+  mode?: WorkflowScopeMode;
+  /** 3-mode persistence (A/B/C). Defaults to the overlay default. */
+  persistence?: WorkflowMetadataPersistence;
+  /**
+   * Optional metadata payload. Persistence mode decides whether this is
+   * held runtime-only, split across doc + workblock, or fully embedded.
+   */
+  metadata?: Partial<WorkflowMetadataEntry>;
+  /** Non-main-body stories (footnote / header / endnote). */
+  storyTarget?: EditorStoryTarget;
+  /** Optional display label for the scope card / rail. */
+  label?: string;
+}
+
+export interface AddScopeResult {
+  scopeId: string;
+  /** Range anchor derived from the just-inserted marker positions. */
+  anchor: EditorAnchorProjection;
+}
+
 export interface ExportDocxOptions {
   fileName?: string;
   reason?: string;
@@ -1975,6 +2039,7 @@ export interface WorkflowBlockedCommandReason {
   code:
     | "outside_workflow_scope"
     | "workflow_comment_only"
+    | "workflow_round_locked"
     | "workflow_view_only"
     | "workflow_preserve_only"
     | "workflow_blocked_import"
@@ -2803,6 +2868,24 @@ export interface WordReviewEditorRef {
   addCommentReply(commentId: string, body: string): AddCommentReplyResult;
   editCommentBody(commentId: string, body: string): void;
   deleteComment(commentId: string): void;
+  /**
+   * S1 — Insert a workflow scope anchored by marker nodes. Returns
+   * `{scopeId, anchor}` where the anchor is derived from the newly-inserted
+   * markers' positions. Subsequent text edits inside / around / through the
+   * scope update the anchor structurally (no remap bookkeeping).
+   */
+  addScope(params: AddScopeParams): AddScopeResult;
+  /**
+   * S1 — Resolve a scopeId to a live `WorkflowScope` with an anchor derived
+   * from the marker positions currently in the document. Returns null when
+   * the scope has been removed or was never added.
+   */
+  getScope(scopeId: string): WorkflowScope | null;
+  /**
+   * S1 — Remove a scope's markers from the document and drop the scope's
+   * metadata record. No-op when the scopeId is unknown.
+   */
+  removeScope(scopeId: string): void;
   acceptChange(changeId: string): void;
   rejectChange(changeId: string): void;
   acceptAllChanges(): void;
@@ -2831,7 +2914,11 @@ export interface WordReviewEditorRef {
   isDirty(): boolean;
   getFormattingState(): FormattingStateSnapshot;
   getStyleCatalog(): StyleCatalogSnapshot;
-  replaceText(text: string, target?: EditorAnchorProjection): void;
+  replaceText(
+    text: string,
+    target?: EditorAnchorProjection,
+    formatting?: TextFormattingDirective,
+  ): void;
   toggleBulletedList(): void;
   toggleNumberedList(): void;
   toggleBold(): void;
@@ -2919,6 +3006,7 @@ export interface WordReviewEditorRef {
   setImageFrame(mediaId: string, offsets: { horizontalOffsetEmu?: number; verticalOffsetEmu?: number }): void;
   setWorkflowOverlay(overlay: WorkflowOverlay): void;
   clearWorkflowOverlay(): void;
+  setSharedWorkflowState(state: SharedWorkflowState | null): void;
   getWorkflowScopeSnapshot(): WorkflowScopeSnapshot | null;
   getInteractionGuardSnapshot(): InteractionGuardSnapshot;
   getWorkflowMarkupSnapshot(): WorkflowMarkupSnapshot;
@@ -3158,20 +3246,54 @@ export interface WordReviewEditorProps {
   chromeOptions?: Partial<WordReviewEditorChromeOptions>;
   markupDisplay?: "clean" | "simple" | "all";
   /**
-   * Harness/debug-only preview toggle for preserve-only features
-   * (charts, SmartArt, shapes, WordArt, VML rendered as typed atoms;
-   * the "N preserve-only features detected" banner; lock-callouts).
+   * @internal HARNESS-ONLY debug-ports token.
+   *
+   * **Do not set this from downstream consumer code.** This prop
+   * replaces the former `showUnsupportedObjectPreviews?: boolean`
+   * toggle, which regressed to `true` three times through merges
+   * (PRs #124, #131, #160) and leaked preserve-only preview chrome
+   * (charts, SmartArt, shapes, WordArt, VML, "N preserve-only
+   * features detected" banner, lock-callouts) into consumer apps.
+   *
+   * A valid value is only obtainable from the internal module
+   * `src/internal/harness-debug-ports.ts` via
+   * `__createHarnessDebugPorts()`. That module is deliberately **not
+   * listed in `package.json#exports`**, so downstream consumers
+   * cannot import it through any public subpath. The token type is
+   * branded with a module-local `unique symbol`, so downstream
+   * callers cannot construct a value structurally either — any
+   * attempt to set this prop from outside the in-repo harness will
+   * produce a TypeScript error.
+   *
+   * At runtime, even a successfully-constructed token is
+   * gated by `globalThis.__DOCX_REACT_COMPONENT_HARNESS__ === true`,
+   * which only the harness sets via `__markHarnessEnvironment()`.
+   * The permissions field (`unsupportedObjectPreviews`) is forced
+   * to `false` outside the harness environment regardless of input.
    *
-   * MUST default to `false`. Consumer hosts MUST NOT hard-code `true` —
-   * this is a dev opt-in gated by the harness dev drawer's
-   * `debugMode && showUnsupportedObjectPreviews` AND-gate. Flipping the
-   * default or dropping the AND-gate is a regression that has landed
-   * three times (PRs #124, #131, #160); the invariant is locked by
+   * Invariant locked at
    * `test/ui/unsupported-previews-invariant.test.ts`.
+   */
+  __harnessDebugPorts?: HarnessDebugPorts;
+  /**
+   * Declarative policy for showing preserve-only previews
+   * (charts, SmartArt, shapes, WordArt, VML) and the
+   * "N preserve-only features detected" banner. Orthogonal to the
+   * harness-only `__harnessDebugPorts` token: hosts can opt into
+   * previews without a harness environment.
+   *
+   * - `"never"` — previews are hidden (default).
+   * - `"review-only"` — previews show when `reviewMode === "review"`
+   *   and hide when `reviewMode === "editing"`.
+   * - `"always"` — previews show in every review mode.
    *
-   * @default false
+   * Effective visibility rule:
+   *   `policy === "always"` OR
+   *   (`policy === "review-only"` AND `reviewMode === "review"`)
+   *
+   * @default "never"
    */
-  showUnsupportedObjectPreviews?: boolean;
+  unsupportedPreviewsPolicy?: "never" | "review-only" | "always";
   showReviewPanel?: boolean;
   chromeVisibility?: Partial<WordReviewEditorChromeVisibility>;
   hostAdapter?: EditorHostAdapter;
@@ -3231,11 +3353,75 @@ export interface WordReviewEditorProps {
    * `shortcut.zoom-reset`.
    */
   onZoomRequested?: (direction: "in" | "out" | "reset") => void;
+  /**
+   * Optional: fires when the user invokes Replace (Ctrl+H) with the
+   * editor focused. When wired, the editor calls this callback and
+   * suppresses the browser's native Find-and-Replace fallback; when
+   * omitted, the shortcut falls through to the browser. The callback
+   * receives the current selection so the host can pre-populate its
+   * Replace panel with the selected text.
+   *
+   * Capability id: `shortcut.replace`.
+   */
+  onReplaceRequested?: (context: ShortcutDelegationContext) => void;
+  /**
+   * Optional: fires when the user invokes Go To (Ctrl+G, Cmd+Option+G,
+   * or F5) with the editor focused. When wired, the editor calls this
+   * callback and suppresses the browser's native navigation; when
+   * omitted, the shortcut falls through to the browser default. Use
+   * the context's `selectionRange` to scope navigation (e.g.,
+   * "go to the same clause in a sibling document").
+   *
+   * Capability id: `shortcut.go-to`.
+   */
+  onGoToRequested?: (context: ShortcutDelegationContext) => void;
+  /**
+   * Optional: fires when the user invokes Check Spelling (F7) with
+   * the editor focused. The mounted editor does not ship a built-in
+   * spell checker; when wired, this callback hands control off so
+   * the host can open its own spell-check UI (or invoke a native
+   * browser spellcheck). When omitted, F7 falls through to the
+   * browser default.
+   *
+   * Capability id: `shortcut.spell`.
+   */
+  onSpellRequested?: (context: ShortcutDelegationContext) => void;
+  /**
+   * Optional: fires when the user invokes Thesaurus (Shift+F7). When
+   * wired, the host opens its own thesaurus panel, typically seeded
+   * with the currently-selected word from `context.selectionText`.
+   * When omitted, Shift+F7 falls through to the browser default.
+   *
+   * Capability id: `shortcut.thesaurus`.
+   */
+  onThesaurusRequested?: (context: ShortcutDelegationContext) => void;
+  /**
+   * Optional: fires when the user invokes Extend-selection mode
+   * (F8 in Word; repeated presses extend by word / sentence / paragraph).
+   * The mounted editor does not today implement the F8 state machine;
+   * when wired, the host owns the state-machine + UI feedback.  When
+   * omitted, F8 falls through to the browser default.
+   *
+   * Capability id: `shortcut.extend-selection`.
+   */
+  onExtendSelectionRequested?: (context: ShortcutDelegationContext) => void;
+  /**
+   * Optional: fires when the user invokes Return-to-last-edit
+   * (Shift+F5). The mounted editor does not today track the
+   * last-edit location; when wired, the host owns the history stack
+   * and performs the scroll/selection move. When omitted, Shift+F5
+   * falls through to the browser default.
+   *
+   * Capability id: `shortcut.last-edit`.
+   */
+  onLastEditRequested?: (context: ShortcutDelegationContext) => void;
 }
 
 /**
  * Selection context handed to host-delegated shortcut callbacks
- * (`onFindRequested`, future `onReplaceRequested`, etc.) so the host
+ * (`onFindRequested`, `onReplaceRequested`, `onGoToRequested`,
+ * `onSpellRequested`, `onThesaurusRequested`,
+ * `onExtendSelectionRequested`, `onLastEditRequested`) so the host
  * can pre-populate its own UI with the user's current selection.
  *
  * - `selectionText` is truncated to the first 500 characters —

package/src/compare/diff-engine.ts

@@ -515,6 +515,8 @@ function getInlineLength(node: InlineNode): number {
     case "footnote_ref":
     case "bookmark_start":
     case "bookmark_end":
+    case "scope_marker_start":
+    case "scope_marker_end":
     case "chart_preview":
     case "smartart_preview":
     case "shape":
@@ -566,6 +568,8 @@ function getInlineDisplayText(node: InlineNode): string {
       return "[Footnote]";
     case "bookmark_start":
     case "bookmark_end":
+    case "scope_marker_start":
+    case "scope_marker_end":
       return "";
     case "chart_preview":
       return "[Chart]";