@beyondwork/docx-react-component 1.0.124 → 1.0.126

package/dist/ui-tailwind.cjs

@@ -7968,7 +7968,7 @@ function createParagraphEditableTarget(paragraph, kind, storyKey, blockPath, tar
     context: { storyKey, insideSdt: contentControl !== void 0 },
     ...tableTarget
   }) : void 0;
-  const listAddress = tableIdentity === void 0 && paragraph.numbering !== void 0 ? createCanonicalAddress({
+  const listAddress = paragraph.numbering !== void 0 ? createCanonicalAddress({
     addressKind: "list-item-text",
     storyKey,
     staleCheckKind: "paragraph",
@@ -8002,6 +8002,7 @@ function createParagraphEditableTarget(paragraph, kind, storyKey, blockPath, tar
     ...contentControl !== void 0 ? { contentControl } : {},
     ...tableIdentity !== void 0 ? { table: tableIdentity } : {},
     ...editableOwner !== void 0 ? { editableOwner } : {},
+    ...listAddress !== void 0 ? { listAddress } : {},
     ...tableIdentity !== void 0 ? {
       canonicalAddress: createTableTargetCanonicalAddress(
         tableIdentity,
@@ -10305,6 +10306,7 @@ function mergeLevelDefinition(base, override, startOverride, fallbackLevel) {
   );
   const runProperties = override?.runProperties ?? base?.runProperties;
   const restartAfterLevel = override?.restartAfterLevel ?? base?.restartAfterLevel;
+  const picBulletId = override?.picBulletId ?? base?.picBulletId;
   return {
     level,
     format,
@@ -10315,7 +10317,8 @@ function mergeLevelDefinition(base, override, startOverride, fallbackLevel) {
     ...override?.suffix ?? base?.suffix ? { suffix: override?.suffix ?? base?.suffix } : {},
     ...paragraphGeometry ? { paragraphGeometry } : {},
     ...runProperties ? { runProperties } : {},
-    ...restartAfterLevel !== void 0 ? { restartAfterLevel } : {}
+    ...restartAfterLevel !== void 0 ? { restartAfterLevel } : {},
+    ...picBulletId !== void 0 ? { picBulletId } : {}
   };
 }
 function withDefaultStartAt(level) {
@@ -10443,7 +10446,7 @@ function resolveHangingWidth(indentation) {
 // src/runtime/formatting/numbering/prefix.ts
 function createNumberingPrefixResolver(catalog) {
   const sequenceStates = /* @__PURE__ */ new Map();
-  function resolveInternal(numbering, paragraph) {
+  function resolveInternal(numbering, paragraph, options = {}) {
     const resolved = resolveNumberingDefinitionSet(
       catalog,
       paragraph?.numbering ?? numbering,
@@ -10456,29 +10459,44 @@ function createNumberingPrefixResolver(catalog) {
     if (!resolvedNumbering) {
       return null;
     }
-    const sequenceState = getSequenceState(sequenceStates, resolvedNumbering.numberingInstanceId);
-    advanceSequence(sequenceState, resolved.effectiveLevel.level, resolved.effectiveLevels);
+    const advance = options.advance !== false;
+    const sequenceState = getSequenceState(
+      sequenceStates,
+      resolvedNumbering.numberingInstanceId,
+      { create: advance }
+    );
+    if (!sequenceState) {
+      return null;
+    }
+    const workingState = advance ? sequenceState : cloneSequenceState(sequenceState);
+    advanceSequence(workingState, resolved.effectiveLevel.level, resolved.effectiveLevels);
+    const currentCounter = workingState.counters[resolved.effectiveLevel.level];
     const effectiveLevelDefs = resolved.effectiveLevel.isLegalNumbering ? new Map(
       Array.from(resolved.effectiveLevels.entries()).map(([level, definition]) => [
         level,
         { ...definition, format: "decimal" }
       ])
     ) : resolved.effectiveLevels;
+    const picBulletId = resolved.effectiveLevel.picBulletId;
     const text = renderLevelText(
       resolved.effectiveLevel.text,
-      sequenceState.counters,
+      workingState.counters,
       effectiveLevelDefs
     );
-    if (resolved.effectiveLevel.format !== "none" && text === null) {
+    if (picBulletId == null && resolved.effectiveLevel.format !== "none" && text === null) {
       return null;
     }
     const visibleText = resolved.effectiveLevel.format === "none" ? null : text;
-    const picBulletId = resolved.effectiveLevel.picBulletId;
+    const formatPosture = getNumberingFormatPosture(
+      resolved.effectiveLevel.format,
+      currentCounter
+    );
     const picBulletMediaId = picBulletId != null ? catalog.numPicBullets?.[picBulletId]?.mediaId : void 0;
     return {
       text: visibleText,
       level: resolved.effectiveLevel.level,
       format: resolved.effectiveLevel.format,
+      ...formatPosture !== void 0 ? { formatPosture } : {},
       startAt: resolved.effectiveLevel.startAt ?? DEFAULT_NUMBERING_START_AT,
       ...resolved.effectiveLevel.suffix ? { suffix: resolved.effectiveLevel.suffix } : {},
       ...resolved.effectiveLevel.paragraphStyleId ? { paragraphStyleId: resolved.effectiveLevel.paragraphStyleId } : {},
@@ -10489,23 +10507,26 @@ function createNumberingPrefixResolver(catalog) {
     };
   }
   return {
-    resolve(numbering) {
-      const result = resolveInternal(numbering);
+    resolve(numbering, options) {
+      const result = resolveInternal(numbering, void 0, options);
       return result?.text ?? null;
     },
-    resolveDetailed(numbering, paragraph) {
-      return resolveInternal(numbering, paragraph);
+    resolveDetailed(numbering, paragraph, options) {
+      return resolveInternal(numbering, paragraph, options);
     },
-    resolveParagraph(paragraph) {
-      return resolveInternal(paragraph.numbering, paragraph);
+    resolveParagraph(paragraph, options) {
+      return resolveInternal(paragraph.numbering, paragraph, options);
     }
   };
 }
-function getSequenceState(states, numberingInstanceId) {
+function getSequenceState(states, numberingInstanceId, options = { create: true }) {
   const existing = states.get(numberingInstanceId);
   if (existing) {
     return existing;
   }
+  if (options.create === false) {
+    return { counters: [], lastLevel: null };
+  }
   const created = {
     counters: [],
     lastLevel: null
@@ -10513,6 +10534,12 @@ function getSequenceState(states, numberingInstanceId) {
   states.set(numberingInstanceId, created);
   return created;
 }
+function cloneSequenceState(state) {
+  return {
+    counters: [...state.counters],
+    lastLevel: state.lastLevel
+  };
+}
 function advanceSequence(state, currentLevel, levelDefinitions) {
   for (let level = currentLevel + 1; level < state.counters.length; level += 1) {
     if (shouldResetDeeperLevel(level, currentLevel, levelDefinitions)) {
@@ -10544,6 +10571,25 @@ function shouldResetDeeperLevel(level, triggeringLevel, levelDefinitions) {
 function getLevelStartAt(level, levelDefinitions) {
   return levelDefinitions.get(level)?.startAt ?? DEFAULT_NUMBERING_START_AT;
 }
+function getNumberingFormatPosture(format, value) {
+  if (!isSupportedNumberingFormat(format)) {
+    return {
+      status: "approximated",
+      requestedFormat: format,
+      renderedFormat: "decimal",
+      reason: "unsupported-numbering-format-decimal-fallback"
+    };
+  }
+  if (value !== void 0 && ((format === "upperRoman" || format === "lowerRoman") && (value <= 0 || value >= 4e3) || (format === "cardinalText" || format === "ordinalText") && (!Number.isInteger(value) || value < 1 || value > 999) || (format === "upperLetter" || format === "lowerLetter" || format === "chicago") && value < 1)) {
+    return {
+      status: "approximated",
+      requestedFormat: format,
+      renderedFormat: "decimal",
+      reason: "numbering-format-range-decimal-fallback"
+    };
+  }
+  return void 0;
+}
 function renderLevelText(text, counters, levelDefinitions) {
   if (!text) {
     return null;
@@ -11386,6 +11432,7 @@ function toNumberingLayoutInput(numbering) {
     associatedTabStops: toLayoutTabStops(numbering.geometry.tabStops, "numbering"),
     level: numbering.level,
     format: numbering.format,
+    ...numbering.formatPosture !== void 0 ? { formatPosture: { ...numbering.formatPosture } } : {},
     startAt: numbering.startAt,
     ...numbering.isLegalNumbering ? { isLegalNumbering: true } : {},
     ...numbering.picBulletMediaId ? { pictureBulletMediaId: numbering.picBulletMediaId } : {}
@@ -11615,13 +11662,10 @@ var FormattingContextImpl = class {
     const effectiveNumbering = this.resolveEffectiveParagraphNumbering(para);
     if (!effectiveNumbering) return null;
     if (!emitGeometry) {
-      if (advance) this.numbering.resolve(effectiveNumbering);
+      this.numbering.resolve(effectiveNumbering, { advance });
       return null;
     }
-    if (!advance) {
-      console.warn("[formatting-context] resolveParagraphNumbering({advance:false}) is not supported; counter always advances");
-    }
-    return this.numbering.resolveDetailed(effectiveNumbering, para);
+    return this.numbering.resolveDetailed(effectiveNumbering, para, { advance });
   }
   resolveNumberingLayoutInput(para, options = {}) {
     return toNumberingLayoutInput(this.resolveParagraphNumbering(para, options));
@@ -13815,6 +13859,7 @@ function toSurfaceResolvedNumbering(numbering) {
   return {
     level: numbering.level,
     format: numbering.format,
+    ...numbering.formatPosture !== void 0 ? { formatPosture: { ...numbering.formatPosture } } : {},
     ...numbering.text !== null ? { text: numbering.text } : {},
     startAt: numbering.startAt,
     ...numbering.paragraphStyleId ? { paragraphStyleId: numbering.paragraphStyleId } : {},
@@ -18095,8 +18140,9 @@ function projectSurfaceBlocksToPageFragments(surface, pages, splits, columnByBlo
   const perPageCounter = /* @__PURE__ */ new Map();
   const fieldRegionsByParagraphIndex = buildFieldRegionsByParagraphIndex(fieldRegions);
   const generatedTargets = buildGeneratedTargets(editableTargets);
+  const numberingTargets = buildNumberingTargets(editableTargets);
   const bookmarkRanges = buildBookmarkRanges(editableTargets);
-  const numberingByParagraphIndex = buildNumberingByParagraphIndex(numberingInputs);
+  const numberingIndex = buildNumberingInputIndex(numberingInputs);
   const pushFragment = (pageIndex, fragment) => {
     const existing = byPage.get(pageIndex);
     if (existing) {
@@ -18132,8 +18178,9 @@ function projectSurfaceBlocksToPageFragments(surface, pages, splits, columnByBlo
           },
           fieldRegionsByParagraphIndex,
           generatedTargets,
+          numberingTargets,
           bookmarkRanges,
-          numberingByParagraphIndex,
+          numberingIndex,
           blockPath
         );
         continue;
@@ -18154,8 +18201,9 @@ function projectSurfaceBlocksToPageFragments(surface, pages, splits, columnByBlo
         },
         fieldRegionsByParagraphIndex,
         generatedTargets,
+        numberingTargets,
         bookmarkRanges,
-        numberingByParagraphIndex,
+        numberingIndex,
         blockPath
       );
       continue;
@@ -18187,8 +18235,9 @@ function projectSurfaceBlocksToPageFragments(surface, pages, splits, columnByBlo
         paginationRole: "whole",
         fieldRegionsByParagraphIndex,
         generatedTargets,
+        numberingTargets,
         bookmarkRanges,
-        numberingByParagraphIndex,
+        numberingIndex,
         blockPath
       }),
       ...columnIndex !== void 0 ? { columnIndex } : {}
@@ -18335,7 +18384,7 @@ function buildRunAnchorsForLine(input) {
   }
   return anchors;
 }
-function emitSlicedParagraph(block, slices, emit, fieldRegionsByParagraphIndex = /* @__PURE__ */ new Map(), generatedTargets = [], bookmarkRanges = [], numberingByParagraphIndex = /* @__PURE__ */ new Map(), blockPath) {
+function emitSlicedParagraph(block, slices, emit, fieldRegionsByParagraphIndex = /* @__PURE__ */ new Map(), generatedTargets = [], numberingTargets = [], bookmarkRanges = [], numberingIndex = EMPTY_NUMBERING_INPUT_INDEX, blockPath) {
   for (let i = 0; i < slices.length; i += 1) {
     const slice = slices[i];
     const heightTwips = slice.heightTwips ?? estimateSliceHeightFromLines(slice.lineRange);
@@ -18360,8 +18409,9 @@ function emitSlicedParagraph(block, slices, emit, fieldRegionsByParagraphIndex =
         paginationRole: slice.lineRange.from > 0 ? "continuation" : "slice",
         fieldRegionsByParagraphIndex,
         generatedTargets,
+        numberingTargets,
         bookmarkRanges,
-        numberingByParagraphIndex,
+        numberingIndex,
         blockPath
       })
     };
@@ -18382,7 +18432,7 @@ function estimateSliceHeightFromLines(lineRange) {
   const lines = Math.max(0, lineRange.to - lineRange.from);
   return lines * 240;
 }
-function emitSlicedTable(block, slices, emit, fieldRegionsByParagraphIndex = /* @__PURE__ */ new Map(), generatedTargets = [], bookmarkRanges = [], numberingByParagraphIndex = /* @__PURE__ */ new Map(), blockPath) {
+function emitSlicedTable(block, slices, emit, fieldRegionsByParagraphIndex = /* @__PURE__ */ new Map(), generatedTargets = [], numberingTargets = [], bookmarkRanges = [], numberingIndex = EMPTY_NUMBERING_INPUT_INDEX, blockPath) {
   for (let i = 0; i < slices.length; i += 1) {
     const slice = slices[i];
     const heightTwips = slice.heightTwips ?? estimateSliceHeightFromRows(slice.rowRange);
@@ -18406,8 +18456,9 @@ function emitSlicedTable(block, slices, emit, fieldRegionsByParagraphIndex = /*
         paginationRole: slice.rowRange.from > 0 ? "continuation" : "slice",
         fieldRegionsByParagraphIndex,
         generatedTargets,
+        numberingTargets,
         bookmarkRanges,
-        numberingByParagraphIndex,
+        numberingIndex,
         blockPath
       }),
       ...slice.columnIndex !== void 0 ? { columnIndex: slice.columnIndex } : {}
@@ -18481,7 +18532,8 @@ function buildFragmentLayoutObject(input) {
   const numberingRows = collectNumberingLayoutFactsForBlock(
     input.block,
     input.blockPath,
-    input.numberingByParagraphIndex
+    input.numberingIndex,
+    input.numberingTargets
   );
   const numbering = input.block.kind === "paragraph" ? numberingRows[0] : void 0;
   const fieldRegions = collectFieldRegionLayoutFacts(
@@ -18652,6 +18704,11 @@ function buildGeneratedTargets(targets) {
     (target) => target.kind === "field-result-text" || target.kind === "hyperlink-text" || target.kind === "hyperlink-destination" || target.kind === "bookmark-anchor" || target.kind === "bookmark-content-range"
   );
 }
+function buildNumberingTargets(targets) {
+  return targets.filter(
+    (target) => target.listAddress !== void 0 || target.canonicalAddress?.addressKind === "list-item-text"
+  );
+}
 function buildBookmarkRanges(targets) {
   const anchors = /* @__PURE__ */ new Map();
   const contentRanges = /* @__PURE__ */ new Map();
@@ -18699,14 +18756,27 @@ function buildBookmarkRanges(targets) {
   }
   return ranges;
 }
-function buildNumberingByParagraphIndex(numberingInputs) {
+var EMPTY_NUMBERING_INPUT_INDEX = {
+  byNumberingKey: /* @__PURE__ */ new Map(),
+  byBlockPath: /* @__PURE__ */ new Map(),
+  byParagraphIndex: /* @__PURE__ */ new Map()
+};
+function buildNumberingInputIndex(numberingInputs) {
+  const byNumberingKey = /* @__PURE__ */ new Map();
+  const byBlockPath = /* @__PURE__ */ new Map();
   const byParagraph = /* @__PURE__ */ new Map();
   for (const input of numberingInputs) {
+    if (!byNumberingKey.has(input.numberingKey)) {
+      byNumberingKey.set(input.numberingKey, input);
+    }
+    if (!byBlockPath.has(input.blockPath)) {
+      byBlockPath.set(input.blockPath, input);
+    }
     if (!byParagraph.has(input.paragraphIndex)) {
       byParagraph.set(input.paragraphIndex, input);
     }
   }
-  return byParagraph;
+  return { byNumberingKey, byBlockPath, byParagraphIndex: byParagraph };
 }
 function collectBookmarkRangeLayoutFacts(fragmentId, blockPath, bookmarkRanges) {
   if (!blockPath || !bookmarkRanges || bookmarkRanges.length === 0) return [];
@@ -18787,6 +18857,7 @@ function collectNumberingLayoutFacts(block) {
     ...block.numbering?.numberingInstanceId !== void 0 ? { numberingInstanceId: block.numbering.numberingInstanceId } : {},
     ...block.numbering?.level !== void 0 ? { level: block.numbering.level } : {},
     ...block.resolvedNumbering?.format !== void 0 ? { format: block.resolvedNumbering.format } : {},
+    ...block.resolvedNumbering?.formatPosture !== void 0 ? { formatPosture: { ...block.resolvedNumbering.formatPosture } } : {},
     ...block.numberingPrefix !== void 0 ? { markerText: block.numberingPrefix } : {},
     ...block.numberingSuffix !== void 0 ? { markerSuffix: block.numberingSuffix } : {},
     ...block.resolvedNumbering?.geometry.markerJustification !== void 0 ? { markerJustification: block.resolvedNumbering.geometry.markerJustification } : {},
@@ -18814,15 +18885,21 @@ function collectNumberingLayoutFacts(block) {
     } : {}
   };
 }
-function collectNumberingLayoutFactsForBlock(block, blockPath, numberingByParagraphIndex) {
+function collectNumberingLayoutFactsForBlock(block, blockPath, numberingIndex, numberingTargets = []) {
   const rows = [];
   const seen = /* @__PURE__ */ new Set();
   visitParagraphBlocks(block, (paragraph, context) => {
     const numbering = collectNumberingLayoutFacts(paragraph);
     if (!numbering) return;
     const paragraphIndex = parseParagraphBlockIndex(paragraph.blockId);
-    const canonical = paragraphIndex !== void 0 ? numberingByParagraphIndex?.get(paragraphIndex) : void 0;
     const numberingKey = context.path !== void 0 ? `main:${context.path}:numbering` : void 0;
+    const canonical = lookupNumberingInput(
+      numberingIndex,
+      numberingKey,
+      context.path,
+      paragraphIndex
+    );
+    const target = findNumberingTarget(numberingTargets, context.path);
     const numberingLayoutId = numberingKey ?? [
       "numbering",
       paragraph.blockId,
@@ -18831,6 +18908,7 @@ function collectNumberingLayoutFactsForBlock(block, blockPath, numberingByParagr
     ].join(":");
     if (seen.has(numberingLayoutId)) return;
     seen.add(numberingLayoutId);
+    const unavailableReasons = collectNumberingUnavailableReasons(numbering, canonical);
     rows.push({
       numberingLayoutId,
       ...numberingKey !== void 0 ? { numberingKey } : {},
@@ -18838,6 +18916,10 @@ function collectNumberingLayoutFactsForBlock(block, blockPath, numberingByParagr
       ...canonical?.blockPath !== void 0 ? { sourceBlockPath: canonical.blockPath } : context.path !== void 0 ? { sourceBlockPath: context.path } : {},
       sourceBlockId: paragraph.blockId,
       ...paragraphIndex !== void 0 ? { paragraphIndex } : {},
+      ...target?.targetKey !== void 0 ? { targetKey: target.targetKey } : {},
+      ...target?.kind !== void 0 ? { targetKind: target.kind } : {},
+      ...target?.canonicalAddress?.addressKey !== void 0 ? { canonicalAddressKey: target.canonicalAddress.addressKey } : {},
+      ...target?.listAddress?.addressKey !== void 0 ? { listAddressKey: target.listAddress.addressKey } : {},
       ...canonical?.sourceRef !== void 0 ? { sourceRef: { ...canonical.sourceRef } } : {},
       ...canonical?.numberingSourceRef !== void 0 ? { numberingSourceRef: { ...canonical.numberingSourceRef } } : {},
       ...canonical?.numberingOrigin !== void 0 ? { numberingOrigin: canonical.numberingOrigin } : {},
@@ -18845,11 +18927,41 @@ function collectNumberingLayoutFactsForBlock(block, blockPath, numberingByParagr
       ...canonical?.numberingInstanceSourceRef !== void 0 ? { numberingInstanceSourceRef: { ...canonical.numberingInstanceSourceRef } } : {},
       ...canonical?.abstractNumberingId !== void 0 ? { abstractNumberingId: canonical.abstractNumberingId } : {},
       ...canonical?.abstractNumberingSourceRef !== void 0 ? { abstractNumberingSourceRef: { ...canonical.abstractNumberingSourceRef } } : {},
-      ...numbering
+      ...numbering,
+      ...unavailableReasons.length > 0 ? { unavailableReasons } : {}
     });
   }, blockPath);
   return rows;
 }
+function findNumberingTarget(numberingTargets, blockPath) {
+  if (blockPath === void 0) return void 0;
+  return numberingTargets.find((target) => target.blockPath === blockPath);
+}
+function lookupNumberingInput(numberingIndex, numberingKey, blockPath, paragraphIndex) {
+  if (!numberingIndex) return void 0;
+  if (numberingKey !== void 0) {
+    const byKey = numberingIndex.byNumberingKey.get(numberingKey);
+    if (byKey !== void 0) return byKey;
+  }
+  if (blockPath !== void 0) {
+    const byPath = numberingIndex.byBlockPath.get(blockPath);
+    if (byPath !== void 0) return byPath;
+  }
+  return paragraphIndex !== void 0 ? numberingIndex.byParagraphIndex.get(paragraphIndex) : void 0;
+}
+function collectNumberingUnavailableReasons(numbering, canonical) {
+  const reasons = [];
+  if (canonical === void 0) {
+    reasons.push("canonical-numbering-input-missing");
+  }
+  if (numbering.markerLane === void 0) {
+    reasons.push("numbering-marker-lane-unavailable");
+  }
+  if (numbering.textColumn === void 0) {
+    reasons.push("numbering-text-column-unavailable");
+  }
+  return reasons;
+}
 function findPageIndexForOffset(pages, offset) {
   for (let i = 0; i < pages.length; i += 1) {
     const page = pages[i];
@@ -19226,7 +19338,7 @@ function createEmpiricalProvider() {
 }
 
 // src/runtime/layout/layout-engine-version.ts
-var LAYOUT_ENGINE_VERSION = 87;
+var LAYOUT_ENGINE_VERSION = 88;
 
 // src/runtime/layout/layout-engine-instance.ts
 var FULL_VIEWPORT_WINDOW_KEY = "full";
@@ -30823,26 +30935,42 @@ function resolveTopBarCommentAvailability(input) {
 
 // src/ui-tailwind/review-workspace/use-status-bar-page-facts.ts
 var import_react36 = require("react");
-function useStatusBarPageFacts(options) {
-  const { layoutFacet, selectionPosition, activeStory, renderFrameRevision } = options;
-  return (0, import_react36.useMemo)(() => {
-    const facet = layoutFacet;
-    if (!facet) {
-      return {
-        displayPageNumber: null,
-        pageCount: null,
-        measurementFidelity: void 0
-      };
-    }
-    const pageRef = facet.getPageForOffset(selectionPosition, activeStory);
-    const displayPageNumber = pageRef !== null && typeof pageRef.pageIndex === "number" ? facet.getDisplayPageNumber(pageRef.pageIndex) ?? pageRef.pageIndex + 1 : null;
-    const pageCount = facet.getPageCount();
+function resolveStatusBarPageFacts(options) {
+  const { layoutFacet: facet, selectionPosition, activeStory, viewportPageIndexRange } = options;
+  if (!facet) {
     return {
-      displayPageNumber,
-      pageCount,
-      measurementFidelity: facet.getMeasurementFidelity()
+      displayPageNumber: null,
+      pageCount: null,
+      measurementFidelity: void 0
     };
-  }, [layoutFacet, selectionPosition, activeStory, renderFrameRevision]);
+  }
+  const pageCount = facet.getPageCount();
+  const viewportPageIndex = viewportPageIndexRange && viewportPageIndexRange.start >= 0 && viewportPageIndexRange.start < pageCount ? viewportPageIndexRange.start : null;
+  const pageRef = viewportPageIndex !== null ? { pageIndex: viewportPageIndex } : facet.getPageForOffset(selectionPosition, activeStory);
+  const displayPageNumber = normalizeStatusDisplayPageNumber(
+    pageRef !== null && typeof pageRef.pageIndex === "number" ? facet.getDisplayPageNumber(pageRef.pageIndex) : null,
+    pageRef !== null && typeof pageRef.pageIndex === "number" ? pageRef.pageIndex : null
+  );
+  return {
+    displayPageNumber,
+    pageCount,
+    measurementFidelity: facet.getMeasurementFidelity()
+  };
+}
+function normalizeStatusDisplayPageNumber(displayPageNumber, pageIndex) {
+  if (pageIndex === null) return null;
+  return typeof displayPageNumber === "number" && displayPageNumber > 0 ? displayPageNumber : pageIndex + 1;
+}
+function useStatusBarPageFacts(options) {
+  const { layoutFacet, selectionPosition, activeStory, renderFrameRevision, viewportPageIndexRange } = options;
+  return (0, import_react36.useMemo)(() => {
+    return resolveStatusBarPageFacts({
+      layoutFacet,
+      selectionPosition,
+      activeStory,
+      viewportPageIndexRange
+    });
+  }, [layoutFacet, selectionPosition, activeStory, viewportPageIndexRange, renderFrameRevision]);
 }
 
 // src/ui-tailwind/review-workspace/use-grabbed-segment-offsets.ts
@@ -31470,6 +31598,12 @@ function readCompatibilityScopeCardFromWorkflowFacet(workflowFacet, scopeId) {
 // src/ui-tailwind/review-workspace/use-page-markers.ts
 var import_react43 = require("react");
 
+// src/api/mounted-surface-residency.ts
+var MOUNTED_SURFACE_VIEWPORT_BLOCK_THRESHOLD = 250;
+function shouldUseMountedSurfaceViewportCulling(totalBlockCount) {
+  return totalBlockCount > MOUNTED_SURFACE_VIEWPORT_BLOCK_THRESHOLD;
+}
+
 // src/ui-tailwind/page-stack/use-visible-block-range.ts
 var React38 = __toESM(require("react"), 1);
 var ESTIMATED_BLOCKS_PER_PAGE_FALLBACK = 50;
@@ -31850,7 +31984,7 @@ function pageMarkersEqual(a, b) {
   }
   return true;
 }
-function useGeometryVisiblePageIndexRange(input) {
+function useGeometryVisiblePageIndexRanges(input) {
   const {
     scrollRoot,
     geometryFacet,
@@ -31860,10 +31994,12 @@ function useGeometryVisiblePageIndexRange(input) {
     renderFrameRevision,
     viewportScale
   } = input;
-  const [range, setRange] = (0, import_react43.useState)(null);
+  const [ranges, setRanges] = (0, import_react43.useState)({ visiblePageIndexRange: null, viewportPageIndexRange: null });
   (0, import_react43.useEffect)(() => {
     if (!scrollRoot || !geometryFacet) {
-      setRange((prev) => prev === null ? prev : null);
+      setRanges(
+        (prev) => prev.visiblePageIndexRange === null && prev.viewportPageIndexRange === null ? prev : { visiblePageIndexRange: null, viewportPageIndexRange: null }
+      );
       return void 0;
     }
     const runtime = scrollRoot.ownerDocument?.defaultView;
@@ -31873,7 +32009,7 @@ function useGeometryVisiblePageIndexRange(input) {
       if (disposed) return;
       const pageCount = layoutFacet?.getPageCount() ?? pageMarkerCount;
       const scale = typeof viewportScale === "number" && Number.isFinite(viewportScale) && viewportScale > 0 ? viewportScale : 1;
-      const next = resolveVisiblePageIndexRangeFromViewport({
+      const nextVisible = resolveVisiblePageIndexRangeFromViewport({
         pageCount,
         viewportTopPx: scrollRoot.scrollTop / scale,
         viewportHeightPx: scrollRoot.clientHeight / scale,
@@ -31883,7 +32019,22 @@ function useGeometryVisiblePageIndexRange(input) {
           return page ? page.frame : null;
         }
       });
-      setRange((prev) => pageRangeEqual(prev, next) ? prev : next);
+      const nextViewport = resolveVisiblePageIndexRangeFromViewport({
+        pageCount,
+        viewportTopPx: scrollRoot.scrollTop / scale,
+        viewportHeightPx: scrollRoot.clientHeight / scale,
+        overscanPages: 0,
+        getPageFrame: (pageIndex) => {
+          const page = geometryFacet.getPage(pageIndex);
+          return page ? page.frame : null;
+        }
+      });
+      setRanges(
+        (prev) => pageRangeEqual(prev.visiblePageIndexRange, nextVisible) && pageRangeEqual(prev.viewportPageIndexRange, nextViewport) ? prev : {
+          visiblePageIndexRange: nextVisible,
+          viewportPageIndexRange: nextViewport
+        }
+      );
     };
     const schedule = () => {
       if (disposed || rafHandle !== null) return;
@@ -31920,7 +32071,7 @@ function useGeometryVisiblePageIndexRange(input) {
     scrollRoot,
     viewportScale
   ]);
-  return range;
+  return ranges;
 }
 function shouldUseCompatibilityPageMarkerScan(input) {
   return !input.geometryFacet || !input.layoutFacet;
@@ -32021,7 +32172,11 @@ function usePageMarkers(options) {
     pageMarkers,
     overscanPages
   });
-  const geometryVisiblePageIndexRange = useGeometryVisiblePageIndexRange({
+  const markerViewportPageIndexRange = useVisiblePageIndexRange({
+    pageMarkers,
+    overscanPages: 0
+  });
+  const geometryPageIndexRanges = useGeometryVisiblePageIndexRanges({
     scrollRoot: pageStackScrollRoot,
     geometryFacet,
     layoutFacet,
@@ -32030,7 +32185,8 @@ function usePageMarkers(options) {
     renderFrameRevision,
     viewportScale
   });
-  const visiblePageIndexRange = geometryVisiblePageIndexRange ?? markerVisiblePageIndexRange;
+  const visiblePageIndexRange = geometryPageIndexRanges.visiblePageIndexRange ?? markerVisiblePageIndexRange;
+  const viewportPageIndexRange = geometryPageIndexRanges.viewportPageIndexRange ?? markerViewportPageIndexRange;
   const visibleBlockRangesFromPageOffsets = (0, import_react43.useMemo)(
     () => visiblePageIndexRange && layoutFacet ? resolveVisibleBlockRangesFromPageOffsets({
       blocks: snapshot.surface?.blocks ?? [],
@@ -32066,9 +32222,11 @@ function usePageMarkers(options) {
     ]
   );
   const visibleBlockRanges = visibleBlockRangesFromPageOffsets ?? visibleBlockRangesFromPageRange ?? markerVisibleBlockRanges;
+  const totalBlockCount = snapshot.surface?.blocks.length ?? 0;
+  const shouldCullSurface = shouldUseMountedSurfaceViewportCulling(totalBlockCount);
   const visibleRangesKey = (0, import_react43.useMemo)(
-    () => visibleBlockRanges.map((r) => `${r.start}:${r.end}`).join("|"),
-    [visibleBlockRanges]
+    () => shouldCullSurface ? visibleBlockRanges.map((r) => `${r.start}:${r.end}`).join("|") : "full",
+    [shouldCullSurface, visibleBlockRanges]
   );
   (0, import_react43.useEffect)(() => {
     if (!layoutFacet) return;
@@ -32077,13 +32235,19 @@ function usePageMarkers(options) {
       layoutFacet.requestViewportRefresh();
       return;
     }
+    if (!shouldCullSurface) {
+      layoutFacet.setVisibleBlockRanges([]);
+      layoutFacet.requestViewportRefresh();
+      return;
+    }
     layoutFacet.setVisibleBlockRanges(visibleBlockRanges);
     layoutFacet.requestViewportRefresh();
-  }, [layoutFacet, visibleRangesKey]);
+  }, [layoutFacet, shouldCullSurface, visibleRangesKey]);
   return {
     pageMarkers,
     visibleBlockRanges,
-    visiblePageIndexRange: VIEWPORT_CULLING_ENABLED ? visiblePageIndexRange : null
+    visiblePageIndexRange: VIEWPORT_CULLING_ENABLED ? visiblePageIndexRange : null,
+    viewportPageIndexRange: VIEWPORT_CULLING_ENABLED ? viewportPageIndexRange : null
   };
 }
 
@@ -32686,11 +32850,20 @@ function TwReviewWorkspace(inputProps) {
     selectionToolbarRootRef
   });
   const activePage = props.documentNavigation?.pages[props.documentNavigation.activePageIndex] ?? null;
+  const { visiblePageIndexRange, viewportPageIndexRange } = usePageMarkers({
+    pageStackScrollRoot,
+    snapshot,
+    layoutFacet: props.layoutFacet,
+    geometryFacet: props.geometryFacet,
+    renderFrameRevision,
+    viewportScale: zoomScale
+  });
   const grabbedSegmentOffsets = useGrabbedSegmentOffsets(snapshot);
   const statusBarPageFacts = useStatusBarPageFacts({
     layoutFacet: props.layoutFacet,
     selectionPosition,
     activeStory: snapshot.activeStory,
+    viewportPageIndexRange,
     renderFrameRevision
   });
   const hidePageBorderForActiveEditing = isPageWorkspace && snapshot.activeStory.kind === "main" && shouldHidePageBorderForSelection(viewState.selection);
@@ -32716,14 +32889,6 @@ function TwReviewWorkspace(inputProps) {
   });
   const suppressFloatingToolDuringEditorInput = viewState.editorRole === "editor" && viewState.selection.isCollapsed;
   const shouldRenderFloatingSelectionTool = chromeVisibility.selectionOverlay && gatedSelectionTool && !suppressFloatingToolDuringEditorInput && shouldRenderSelectionToolKind(scopedChromePolicy, gatedSelectionTool.kind);
-  const { visiblePageIndexRange } = usePageMarkers({
-    pageStackScrollRoot,
-    snapshot,
-    layoutFacet: props.layoutFacet,
-    geometryFacet: props.geometryFacet,
-    renderFrameRevision,
-    viewportScale: zoomScale
-  });
   const { dismissSelectionToolbar, runWithSelectionToolbarDismiss } = useWorkspaceSideEffects({
     layoutFacet: props.layoutFacet,
     activeParagraphLayout,