@beyondwork/docx-react-component 1.0.53 → 1.0.55

package/src/runtime/page-number-format.ts

@@ -0,0 +1,207 @@
+/**
+ * OOXML page number format codes (ECMA-376 §17.18.59).
+ *
+ * This module is intentionally dependency-free so it can be unit-tested
+ * without any runtime or model imports.
+ */
+
+const ROMAN_PAIRS: [number, string][] = [
+  [1000, "M"],
+  [900, "CM"],
+  [500, "D"],
+  [400, "CD"],
+  [100, "C"],
+  [90, "XC"],
+  [50, "L"],
+  [40, "XL"],
+  [10, "X"],
+  [9, "IX"],
+  [5, "V"],
+  [4, "IV"],
+  [1, "I"],
+];
+
+function toRoman(n: number): string {
+  if (n <= 0 || n >= 4000) {
+    return String(n);
+  }
+  let result = "";
+  let remainder = n;
+  for (const [value, numeral] of ROMAN_PAIRS) {
+    while (remainder >= value) {
+      result += numeral;
+      remainder -= value;
+    }
+  }
+  return result;
+}
+
+function toAlphabetic(n: number): string {
+  if (n <= 0) {
+    return String(n);
+  }
+  let result = "";
+  let remainder = n;
+  while (remainder > 0) {
+    remainder -= 1;
+    result = String.fromCharCode(65 + (remainder % 26)) + result;
+    remainder = Math.floor(remainder / 26);
+  }
+  return result;
+}
+
+function toOrdinal(n: number): string {
+  const abs = Math.abs(n);
+  const mod100 = abs % 100;
+  const mod10 = abs % 10;
+  if (mod100 >= 11 && mod100 <= 13) {
+    return `${n}th`;
+  }
+  if (mod10 === 1) return `${n}st`;
+  if (mod10 === 2) return `${n}nd`;
+  if (mod10 === 3) return `${n}rd`;
+  return `${n}th`;
+}
+
+const ONES = [
+  "",
+  "one",
+  "two",
+  "three",
+  "four",
+  "five",
+  "six",
+  "seven",
+  "eight",
+  "nine",
+  "ten",
+  "eleven",
+  "twelve",
+  "thirteen",
+  "fourteen",
+  "fifteen",
+  "sixteen",
+  "seventeen",
+  "eighteen",
+  "nineteen",
+];
+
+const TENS = [
+  "",
+  "",
+  "twenty",
+  "thirty",
+  "forty",
+  "fifty",
+  "sixty",
+  "seventy",
+  "eighty",
+  "ninety",
+];
+
+function toCardinalText(n: number): string {
+  if (n <= 0 || n >= 100) {
+    return String(n);
+  }
+  if (n < 20) {
+    return ONES[n]!;
+  }
+  const tensWord = TENS[Math.floor(n / 10)]!;
+  const onesDigit = n % 10;
+  if (onesDigit === 0) {
+    return tensWord;
+  }
+  return `${tensWord}-${ONES[onesDigit]}`;
+}
+
+const ORDINAL_IRREGULARS: Record<string, string> = {
+  one: "first",
+  two: "second",
+  three: "third",
+  four: "fourth",
+  five: "fifth",
+  six: "sixth",
+  seven: "seventh",
+  eight: "eighth",
+  nine: "ninth",
+  ten: "tenth",
+  eleven: "eleventh",
+  twelve: "twelfth",
+  thirteen: "thirteenth",
+  fifteen: "fifteenth",
+  twenty: "twentieth",
+  thirty: "thirtieth",
+  forty: "fortieth",
+  fifty: "fiftieth",
+  sixty: "sixtieth",
+  seventy: "seventieth",
+  eighty: "eightieth",
+  ninety: "ninetieth",
+};
+
+function toOrdinalText(n: number): string {
+  if (n <= 0 || n >= 100) {
+    return `${n}th`;
+  }
+  const cardinal = toCardinalText(n);
+  // Check if it's a hyphenated compound like "twenty-one"
+  const hyphenIdx = cardinal.lastIndexOf("-");
+  if (hyphenIdx !== -1) {
+    const prefix = cardinal.slice(0, hyphenIdx + 1);
+    const suffix = cardinal.slice(hyphenIdx + 1);
+    const ordinalSuffix = ORDINAL_IRREGULARS[suffix] ?? `${suffix}th`;
+    return `${prefix}${ordinalSuffix}`;
+  }
+  return ORDINAL_IRREGULARS[cardinal] ?? `${cardinal}th`;
+}
+
+const CHICAGO_SYMBOLS = ["*", "†", "‡", "§", "‖", "¶"];
+
+function toChicago(n: number): string {
+  if (n <= 0) {
+    return String(n);
+  }
+  const symbolCount = CHICAGO_SYMBOLS.length;
+  // Which cycle: 1-6 → repeat 1×, 7-12 → repeat 2×, etc.
+  const cycleIndex = Math.ceil(n / symbolCount) - 1; // 0-based repeat count
+  const symbolIndex = ((n - 1) % symbolCount);
+  const symbol = CHICAGO_SYMBOLS[symbolIndex]!;
+  return symbol.repeat(cycleIndex + 1);
+}
+
+/**
+ * Format a page number integer using an OOXML ST_NumberFormat code.
+ *
+ * @param n - The raw page number (1-based within section).
+ * @param format - The OOXML format code from `<w:pgNumType w:fmt="…"/>`.
+ * @returns Formatted string for display.
+ */
+export function formatPageNumber(n: number, format: string | undefined): string {
+  switch (format) {
+    case undefined:
+    case "decimal":
+      return String(n);
+    case "upperRoman":
+      return toRoman(n);
+    case "lowerRoman":
+      return toRoman(n).toLowerCase();
+    case "upperLetter":
+      return toAlphabetic(n);
+    case "lowerLetter":
+      return toAlphabetic(n).toLowerCase();
+    case "none":
+      return "";
+    case "ordinal":
+      return toOrdinal(n);
+    case "cardinalText":
+      return toCardinalText(n);
+    case "ordinalText":
+      return toOrdinalText(n);
+    case "hex":
+      return n.toString(16).toUpperCase();
+    case "chicago":
+      return toChicago(n);
+    default:
+      return String(n);
+  }
+}

package/src/runtime/render/render-frame-diff.ts

@@ -22,6 +22,7 @@ import type {
   RenderPage,
   RenderStoryRegion,
   DecorationIndex,
+  PageChromeReservations,
 } from "./render-frame-types.ts";
 
 // ---------------------------------------------------------------------------
@@ -46,6 +47,14 @@ export interface ChangedPageEntry {
      */
     changedBlockIds: readonly string[];
   }[];
+  /**
+   * R1: Set when the page's physical frame rect changed but no individual
+   * block regions changed. Consumers that iterate `regions` for targeted
+   * re-render targets must also honour this flag to avoid silently skipping
+   * pages whose geometry shifted without block-level changes (e.g. zoom
+   * change or page margin edit that shifts every page frame uniformly).
+   */
+  pageFrameChanged?: boolean;
 }
 
 export interface RenderFrameDiff {
@@ -110,10 +119,21 @@ export function diffRenderFrames(
       continue;
     }
     const regions = diffPage(prevPage, nextPage, prev.decorationIndex, next.decorationIndex);
-    if (regions.length === 0 && rectEquals(prevPage.frame, nextPage.frame)) {
+    // R1: track page-frame geometry changes independently of block regions.
+    const frameChanged = !rectEquals(prevPage.frame, nextPage.frame);
+    // R2: track chrome-reservation changes so chrome re-projection isn't skipped.
+    const reservationsChanged = !reservationsEqual(
+      prevPage.chromeReservations,
+      nextPage.chromeReservations,
+    );
+    if (regions.length === 0 && !frameChanged && !reservationsChanged) {
       unchangedPages.push(pageIndex);
     } else {
-      changedPages.push({ pageIndex, regions });
+      changedPages.push({
+        pageIndex,
+        regions,
+        ...(frameChanged ? { pageFrameChanged: true } : {}),
+      });
     }
   }
 
@@ -268,6 +288,22 @@ function decorationHashForBlock(
   return tokens.join("|");
 }
 
+// ---------------------------------------------------------------------------
+// Chrome reservations compare
+// ---------------------------------------------------------------------------
+
+// R2: Compare all five reservation fields so changes to rail/balloon lanes
+// or footnote area trigger changedPages, not unchangedPages.
+function reservationsEqual(a: PageChromeReservations, b: PageChromeReservations): boolean {
+  return (
+    a.railLaneTwips === b.railLaneTwips &&
+    a.balloonLaneTwips === b.balloonLaneTwips &&
+    a.footnoteAreaTwips === b.footnoteAreaTwips &&
+    a.pageFrameWidthPx === b.pageFrameWidthPx &&
+    a.pageFrameHeightPx === b.pageFrameHeightPx
+  );
+}
+
 // ---------------------------------------------------------------------------
 // Geometry compare
 // ---------------------------------------------------------------------------

package/src/runtime/surface-projection.ts

@@ -8,6 +8,11 @@ import type {
   SurfaceTableRowSnapshot,
   SurfaceTextMark,
 } from "../api/public-types";
+import {
+  chartModelStore,
+  extractChartDimensions,
+  stableChartId,
+} from "./chart/chart-model-store.ts";
 import type {
   CanonicalDocumentEnvelope,
   SelectionSnapshot,
@@ -1011,10 +1016,25 @@ function appendInlineSegments(
       });
       return { nextCursor: start + 1, lockedFragmentIds: [node.fragmentId] };
     }
-    case "chart_preview":
+    case "chart_preview": {
+      let parsedChartId: string | undefined;
+      if (node.parsedData) {
+        parsedChartId = stableChartId(node.rawXml);
+        if (!chartModelStore.has(parsedChartId)) {
+          const { widthPx, heightPx } = extractChartDimensions(node.rawXml);
+          chartModelStore.set(parsedChartId, {
+            model: node.parsedData,
+            widthPx,
+            heightPx,
+            theme: undefined,
+          });
+        }
+      }
       return appendComplexPreviewSegment(paragraph, node, start, "Embedded chart", createChartDetail(node), {
         previewMediaId: node.previewMediaId,
+        parsedChartId,
       });
+    }
     case "smartart_preview":
       return appendComplexPreviewSegment(paragraph, node, start, "SmartArt diagram", createSmartArtDetail(node), {
         previewMediaId: node.previewMediaId,
@@ -1087,6 +1107,14 @@ function appendInlineSegments(
         node.fieldFamily === "PAGE" ||
         node.fieldFamily === "NUMPAGES";
       if (node.children && node.children.length > 0) {
+        // For REF \h, pass the bookmark as a hyperlink href so child text gets hyperlink styling
+        const refHyperlinkHref =
+          node.fieldFamily === "REF" &&
+          node.switches?.hyperlink === true &&
+          node.fieldTarget
+            ? `#${node.fieldTarget}`
+            : undefined;
+
         let cursor = start;
         const lockedIds: string[] = [];
         for (const child of node.children) {
@@ -1096,7 +1124,7 @@ function appendInlineSegments(
             document,
             cursor,
             promoteSecondaryStoryTextBoxes,
-            undefined,
+            refHyperlinkHref ?? hyperlinkHref,
             cullBuild,
           );
           cursor = result.nextCursor;
@@ -1159,7 +1187,7 @@ function appendComplexPreviewSegment(
   start: number,
   label: string,
   detail: string,
-  extras: { previewMediaId?: string } = {},
+  extras: { previewMediaId?: string; parsedChartId?: string } = {},
 ): { nextCursor: number; lockedFragmentIds: string[] } {
   paragraph.segments.push({
     segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
@@ -1171,6 +1199,7 @@ function appendComplexPreviewSegment(
     label,
     detail,
     ...(extras.previewMediaId ? { previewMediaId: extras.previewMediaId } : {}),
+    ...(extras.parsedChartId ? { parsedChartId: extras.parsedChartId } : {}),
     state: "locked-preserve-only",
   });
   return { nextCursor: start + 1, lockedFragmentIds: [] };

package/src/ui/WordReviewEditor.tsx

@@ -220,6 +220,12 @@ import {
   getCursorColorForUser,
   setLocalCursorState,
 } from "../runtime/collab/remote-cursor-awareness.ts";
+import {
+  stableChartId,
+} from "../runtime/chart/chart-model-store.ts";
+import {
+  projectChartSnapshot,
+} from "../runtime/chart/chart-snapshot.ts";
 
 export {
   __createFallbackRuntime,
@@ -466,6 +472,40 @@ async function runConvertScopesToExternal(args: {
 
 // ---------------------------------------------------------------------------
 
+type CanonicalDocType = ReturnType<WordReviewEditorRuntime["getCanonicalDocument"]>;
+
+function collectChartSnapshots(doc: CanonicalDocType): import("../api/public-types").ChartSnapshot[] {
+  const results: import("../api/public-types").ChartSnapshot[] = [];
+  collectChartSnapshotsFromBlocks(doc.content.children, results);
+  return results;
+}
+
+function collectChartSnapshotsFromBlocks(
+  blocks: CanonicalDocType["content"]["children"],
+  results: import("../api/public-types").ChartSnapshot[],
+): void {
+  for (const block of blocks) {
+    if (block.type === "paragraph") {
+      for (const inline of block.children) {
+        if (inline.type === "chart_preview" && inline.parsedData) {
+          const chartId = stableChartId(inline.rawXml);
+          results.push(projectChartSnapshot(chartId, inline.parsedData));
+        }
+      }
+    } else if (block.type === "table") {
+      for (const row of block.rows) {
+        for (const cell of row.cells) {
+          collectChartSnapshotsFromBlocks(cell.children, results);
+        }
+      }
+    } else if (block.type === "sdt" || block.type === "custom_xml") {
+      collectChartSnapshotsFromBlocks(block.children, results);
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+
 export function __createWordReviewEditorRefBridge(
   runtime: WordReviewEditorRuntime,
   mountedSurface?: TwProseMirrorSurfaceRef | null,
@@ -514,6 +554,12 @@ export function __createWordReviewEditorRefBridge(
     getRenderSnapshot: () => clonePublicValue(runtime.getRenderSnapshot()),
     getCompatibilityReport: () => runtime.getCompatibilityReport(),
     getWarnings: () => runtime.getWarnings(),
+    getChartSnapshot: (chartId) => {
+      return collectChartSnapshots(runtime.getCanonicalDocument()).find(
+        (s) => s.chartId === chartId,
+      ) ?? null;
+    },
+    getChartSnapshots: () => collectChartSnapshots(runtime.getCanonicalDocument()),
     getCommentSidebarSnapshot: () =>
       clonePublicValue(runtime.getRenderSnapshot().comments),
     getTrackedChangesSnapshot: () =>
@@ -782,7 +828,9 @@ export function __createWordReviewEditorRefBridge(
     clearWorkflowOverlay: () => {
       runtime.clearWorkflowOverlay();
     },
-    getWorkflowOverlay: () => clonePublicValue(runtime.getWorkflowOverlay()),
+    getWorkflowOverlay: () => {
+      return clonePublicValue(runtime.getWorkflowOverlay());
+    },
     setSharedWorkflowState: (state) => {
       runtime.setSharedWorkflowState(state === null ? null : clonePublicValue(state));
     },
@@ -1535,6 +1583,11 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
         getRenderSnapshot: () => clonePublicValue(activeRuntime.getRenderSnapshot()),
         getCompatibilityReport: () => activeRuntime.getCompatibilityReport(),
         getWarnings: () => activeRuntime.getWarnings(),
+        getChartSnapshot: (chartId) =>
+          collectChartSnapshots(activeRuntime.getCanonicalDocument()).find(
+            (s) => s.chartId === chartId,
+          ) ?? null,
+        getChartSnapshots: () => collectChartSnapshots(activeRuntime.getCanonicalDocument()),
         getCommentSidebarSnapshot: () =>
           clonePublicValue(activeRuntime.getRenderSnapshot().comments),
         getTrackedChangesSnapshot: () =>
@@ -1834,8 +1887,9 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
         clearWorkflowOverlay: () => {
           activeRuntime.clearWorkflowOverlay();
         },
-        getWorkflowOverlay: () =>
-          clonePublicValue(activeRuntime.getWorkflowOverlay()),
+        getWorkflowOverlay: () => {
+          return clonePublicValue(activeRuntime.getWorkflowOverlay());
+        },
         setSharedWorkflowState: (state) => {
           activeRuntime.setSharedWorkflowState(state === null ? null : clonePublicValue(state));
         },

package/src/ui/headless/comment-decoration-model.ts

@@ -77,7 +77,61 @@ export function getCommentRangeState(
   };
 }
 
-export type MarkupDisplay = "clean" | "simple" | "all";
+/**
+ * Markup display mode — controls how tracked changes and comments render.
+ *
+ * L6d.N2 widens the union to Word's 4-mode grammar (`"all-markup"`,
+ * `"simple-markup"`, `"no-markup"`, `"original"`) while keeping the
+ * legacy aliases `"clean" | "simple" | "all"` for backward compat with
+ * hosts that already pass the old values.  Callers that switch on this
+ * value should either:
+ *   - handle both sets of names (the decoration models do), or
+ *   - normalize via `normalizeMarkupDisplay()` before matching.
+ *
+ * New in 6d.N2:
+ *   - `"original"` — hide insertions entirely, render deletions as
+ *     plain body text.  Shows what the document looked like before the
+ *     current batch of tracked changes.
+ */
+export type MarkupDisplay =
+  | "all-markup"
+  | "simple-markup"
+  | "no-markup"
+  | "original"
+  // Legacy aliases — accepted on the public API; prefer the canonical names above.
+  | "clean"
+  | "simple"
+  | "all";
+
+/**
+ * Collapse legacy `MarkupDisplay` aliases to their canonical Word-grammar
+ * name:
+ *   - `"all"` → `"all-markup"`
+ *   - `"simple"` → `"simple-markup"`
+ *   - `"clean"` → `"no-markup"`
+ *   - `"original"` → `"original"` (identity)
+ *
+ * The two sets remain interchangeable inside the decoration models, but
+ * external surfaces (selector labels, telemetry, host events) should
+ * normalize first so Word's grammar is the single source of truth.
+ */
+export function normalizeMarkupDisplay(
+  value: MarkupDisplay,
+): "all-markup" | "simple-markup" | "no-markup" | "original" {
+  switch (value) {
+    case "all":
+    case "all-markup":
+      return "all-markup";
+    case "simple":
+    case "simple-markup":
+      return "simple-markup";
+    case "clean":
+    case "no-markup":
+      return "no-markup";
+    case "original":
+      return "original";
+  }
+}
 
 export function getCommentHighlightClass(
   model: CommentDecorationModel | undefined,
@@ -90,10 +144,11 @@ export function getCommentHighlightClass(
     return "";
   }
 
-  switch (markupDisplay) {
-    case "clean":
+  switch (normalizeMarkupDisplay(markupDisplay)) {
+    case "no-markup":
+    case "original":
       return state.hasActive ? "bg-comment-soft" : "";
-    case "simple":
+    case "simple-markup":
       if (state.hasActive) {
         return "underline decoration-comment decoration-2 underline-offset-4";
       }
@@ -101,7 +156,7 @@ export function getCommentHighlightClass(
         return "underline decoration-comment/60 decoration-1 underline-offset-4";
       }
       return "underline decoration-comment/40 decoration-1 underline-offset-4";
-    case "all":
+    case "all-markup":
       if (state.hasActive) {
         return "bg-comment-strong";
       }

package/src/ui/headless/revision-decoration-model.ts

@@ -1,5 +1,9 @@
 import type { TrackedChangesSnapshot, TrackedChangeEntrySnapshot } from "../../api/public-types";
-import { rangesOverlap, type MarkupDisplay } from "./comment-decoration-model";
+import {
+  normalizeMarkupDisplay,
+  rangesOverlap,
+  type MarkupDisplay,
+} from "./comment-decoration-model";
 
 export interface RevisionDecorationModel {
   revisions: RevisionDecorationEntry[];
@@ -13,6 +17,65 @@ export interface RevisionDecorationEntry {
   status: TrackedChangeEntrySnapshot["status"];
   actionability: TrackedChangeEntrySnapshot["actionability"];
   isActive: boolean;
+  /** L6d.N3 — source author, used to pick the decoration color. */
+  authorId?: string;
+  /** L6d.N3 — palette slot for `authorId` (0..7, stable via FNV-1a hash). */
+  authorPaletteIndex?: number;
+}
+
+/**
+ * L6d.N3 — author-color assignment.
+ *
+ * Map `authorId` → one of the 8 `--color-chart-categorical-*` vars
+ * using FNV-1a 32-bit hashing.  FNV-1a is deterministic, allocation-
+ * free, and has better avalanche on short ASCII keys than djb2, so
+ * typical author-id alphabets (emails, UUIDs, Slack IDs) distribute
+ * evenly across the 8 slots.
+ *
+ * The palette lives as CSS vars so theme swaps / reduced-contrast
+ * overrides in `tokens.css` cascade automatically — we emit `var(...)`
+ * strings, never hex literals.
+ */
+export const AUTHOR_PALETTE: readonly string[] = [
+  "var(--color-chart-categorical-1)",
+  "var(--color-chart-categorical-2)",
+  "var(--color-chart-categorical-3)",
+  "var(--color-chart-categorical-4)",
+  "var(--color-chart-categorical-5)",
+  "var(--color-chart-categorical-6)",
+  "var(--color-chart-categorical-7)",
+  "var(--color-chart-categorical-8)",
+];
+
+/**
+ * FNV-1a 32-bit hash.  Constants from the Fowler–Noll–Vo reference:
+ *   offset basis = 0x811c9dc5
+ *   prime        = 0x01000193
+ * The `>>> 0` keeps the value in unsigned 32-bit territory after each
+ * multiplication so two identical inputs always produce the same hash.
+ */
+export function hashAuthorId(authorId: string): number {
+  let hash = 0x811c9dc5;
+  for (let i = 0; i < authorId.length; i += 1) {
+    hash ^= authorId.charCodeAt(i);
+    hash = Math.imul(hash, 0x01000193) >>> 0;
+  }
+  return hash;
+}
+
+/** Reduce a hash to a palette slot in `[0, AUTHOR_PALETTE.length)`. */
+export function authorPaletteIndex(authorId: string): number {
+  return hashAuthorId(authorId) % AUTHOR_PALETTE.length;
+}
+
+/**
+ * Resolve a CSS color string for an author.  Returns `undefined` when
+ * `authorId` is missing so callers can fall back to the default
+ * per-kind class (e.g. `bg-insert-soft`).
+ */
+export function getAuthorColor(authorId: string | undefined): string | undefined {
+  if (!authorId) return undefined;
+  return AUTHOR_PALETTE[authorPaletteIndex(authorId)];
 }
 
 export interface RevisionRangeState {
@@ -47,6 +110,8 @@ export function createRevisionDecorationModel(
         status: rev.status,
         actionability: rev.actionability,
         isActive: rev.revisionId === activeRevisionId,
+        authorId: rev.authorId,
+        authorPaletteIndex: rev.authorId ? authorPaletteIndex(rev.authorId) : undefined,
       };
       }),
   };
@@ -94,12 +159,17 @@ export function getRevisionHighlightClass(
 
   const activeRing = state.hasActive ? " ring-1 ring-accent/30" : "";
 
-  switch (markupDisplay) {
-    case "clean":
-      // In clean mode, deletions are hidden entirely (caller should not render).
+  switch (normalizeMarkupDisplay(markupDisplay)) {
+    case "no-markup":
+      // In no-markup mode, deletions are hidden entirely (caller should not render).
       // Insertions render as normal text with no decoration.
       return "";
-    case "simple":
+    case "original":
+      // L6d.N2 — "original" shows what the doc looked like BEFORE the
+      // pending tracked changes: insertions are hidden (caller checks
+      // `shouldHideInOriginalMode`), deletions render as plain body text.
+      return "";
+    case "simple-markup":
       if (state.hasInsertions) {
         return `underline decoration-insert/60 decoration-1 underline-offset-2 text-primary${activeRing}`;
       }
@@ -107,7 +177,7 @@ export function getRevisionHighlightClass(
         return `text-secondary line-through decoration-danger/70 decoration-1${activeRing}`;
       }
       return activeRing;
-    case "all":
+    case "all-markup":
       if (state.hasInsertions) {
         return `text-primary bg-insert-soft/80 ring-1 ring-insert/20${activeRing}`;
       }
@@ -118,6 +188,10 @@ export function getRevisionHighlightClass(
   }
 }
 
+/**
+ * `no-markup` hides deletions (pretending the doc already accepted all
+ * pending changes).  The caller skips rendering affected spans entirely.
+ */
 export function shouldHideInCleanMode(
   model: RevisionDecorationModel | undefined,
   from: number,
@@ -126,3 +200,17 @@ export function shouldHideInCleanMode(
   const state = getRevisionRangeState(model, from, to);
   return state.hasDeletions;
 }
+
+/**
+ * L6d.N2 — `original` mode hides insertions (pretending the pending
+ * batch of tracked changes was rejected).  Caller skips rendering
+ * affected spans entirely.
+ */
+export function shouldHideInOriginalMode(
+  model: RevisionDecorationModel | undefined,
+  from: number,
+  to: number,
+): boolean {
+  const state = getRevisionRangeState(model, from, to);
+  return state.hasInsertions;
+}