@beyondwork/docx-react-component 1.0.124 → 1.0.126

package/dist/api/v3.d.cts

@@ -1,9 +1,9 @@
-import { u as MockPayload, A as ApiStatus, U as UxIntent, v as RuntimeApiHandle, w as UiControllerFactory, x as ApiV3Ui } from '../public-types-DajNGKV4.cjs';
-export { y as AgentMetadata, z as AiPe2EvidenceOptions, B as AiPe2GraphOracleReference, D as AiPe2OracleEvidence, F as AiPe2OracleEvidenceProvider, G as AiPe2OracleEvidenceProviderInput, H as AiPe2OracleVerdict, J as ApiV3, K as ApiV3FnMetadata, N as ApiV3UiChrome, O as ApiV3UiDebug, Q as ApiV3UiOverlays, V as ApiV3UiSession, W as ApiV3UiSurface, X as ApiV3UiViewport, Y as BroadcastsVia, Z as ChromeDebugMode, _ as ChromeDocumentMode, $ as ChromeHostPosture, a0 as ChromeMarkupDisplay, a1 as ChromePosture, a2 as ChromeReviewMode, a3 as ChromeSurface, a4 as ChromeSurfaceKind, a5 as CreateApiV3Opts, a6 as DebugAttachment, a7 as DebugSession, a8 as GeometryRect, a9 as LiveEvidence, aa as MockShape, ab as OverlayAnchorQuery, ac as PersistsTo, ad as ScrollTarget, ae as ScrollTargetBehavior, af as SelectionRangeInput, ag as SourceLayer, ah as StateClass, ai as SubscriptionShape, aj as UiBinding, ak as UiController, al as UiControllerKind, am as UiListener, an as UiUnsubscribe, ao as ViewportState, ap as createApiV3, aq as validateApiV3Metadata } from '../public-types-DajNGKV4.cjs';
+import { u as MockPayload, A as ApiStatus, U as UxIntent, v as RuntimeApiHandle, w as UiControllerFactory, x as ApiV3Ui } from '../public-types-BP3vqJR5.cjs';
+export { y as AgentMetadata, z as AiPe2EvidenceOptions, B as AiPe2GraphOracleReference, D as AiPe2OracleEvidence, F as AiPe2OracleEvidenceProvider, G as AiPe2OracleEvidenceProviderInput, H as AiPe2OracleVerdict, J as ApiV3, K as ApiV3FnMetadata, N as ApiV3UiChrome, O as ApiV3UiDebug, Q as ApiV3UiOverlays, V as ApiV3UiSession, W as ApiV3UiSurface, X as ApiV3UiViewport, Y as BroadcastsVia, Z as ChromeDebugMode, _ as ChromeDocumentMode, $ as ChromeHostPosture, a0 as ChromeMarkupDisplay, a1 as ChromePosture, a2 as ChromeReviewMode, a3 as ChromeSurface, a4 as ChromeSurfaceKind, a5 as CreateApiV3Opts, a6 as DebugAttachment, a7 as DebugSession, a8 as GeometryRect, a9 as LiveEvidence, aa as MockShape, ab as OverlayAnchorQuery, ac as PersistsTo, ad as ScrollTarget, ae as ScrollTargetBehavior, af as SelectionRangeInput, ag as SourceLayer, ah as StateClass, ai as SubscriptionShape, aj as UiBinding, ak as UiController, al as UiControllerKind, am as UiListener, an as UiUnsubscribe, ao as ViewportState, ap as createApiV3, aq as validateApiV3Metadata } from '../public-types-BP3vqJR5.cjs';
 import 'react';
 import 'yjs';
 import 'y-protocols/awareness';
-import '../canonical-document-CG2TgAzj.cjs';
+import '../canonical-document-CXCFCbAz.cjs';
 import 'prosemirror-state';
 import 'prosemirror-model';
 

package/dist/api/v3.d.ts

@@ -1,9 +1,9 @@
-import { u as MockPayload, A as ApiStatus, U as UxIntent, v as RuntimeApiHandle, w as UiControllerFactory, x as ApiV3Ui } from '../public-types-CNnMHZM9.js';
-export { y as AgentMetadata, z as AiPe2EvidenceOptions, B as AiPe2GraphOracleReference, D as AiPe2OracleEvidence, F as AiPe2OracleEvidenceProvider, G as AiPe2OracleEvidenceProviderInput, H as AiPe2OracleVerdict, J as ApiV3, K as ApiV3FnMetadata, N as ApiV3UiChrome, O as ApiV3UiDebug, Q as ApiV3UiOverlays, V as ApiV3UiSession, W as ApiV3UiSurface, X as ApiV3UiViewport, Y as BroadcastsVia, Z as ChromeDebugMode, _ as ChromeDocumentMode, $ as ChromeHostPosture, a0 as ChromeMarkupDisplay, a1 as ChromePosture, a2 as ChromeReviewMode, a3 as ChromeSurface, a4 as ChromeSurfaceKind, a5 as CreateApiV3Opts, a6 as DebugAttachment, a7 as DebugSession, a8 as GeometryRect, a9 as LiveEvidence, aa as MockShape, ab as OverlayAnchorQuery, ac as PersistsTo, ad as ScrollTarget, ae as ScrollTargetBehavior, af as SelectionRangeInput, ag as SourceLayer, ah as StateClass, ai as SubscriptionShape, aj as UiBinding, ak as UiController, al as UiControllerKind, am as UiListener, an as UiUnsubscribe, ao as ViewportState, ap as createApiV3, aq as validateApiV3Metadata } from '../public-types-CNnMHZM9.js';
+import { u as MockPayload, A as ApiStatus, U as UxIntent, v as RuntimeApiHandle, w as UiControllerFactory, x as ApiV3Ui } from '../public-types-DdcHqcow.js';
+export { y as AgentMetadata, z as AiPe2EvidenceOptions, B as AiPe2GraphOracleReference, D as AiPe2OracleEvidence, F as AiPe2OracleEvidenceProvider, G as AiPe2OracleEvidenceProviderInput, H as AiPe2OracleVerdict, J as ApiV3, K as ApiV3FnMetadata, N as ApiV3UiChrome, O as ApiV3UiDebug, Q as ApiV3UiOverlays, V as ApiV3UiSession, W as ApiV3UiSurface, X as ApiV3UiViewport, Y as BroadcastsVia, Z as ChromeDebugMode, _ as ChromeDocumentMode, $ as ChromeHostPosture, a0 as ChromeMarkupDisplay, a1 as ChromePosture, a2 as ChromeReviewMode, a3 as ChromeSurface, a4 as ChromeSurfaceKind, a5 as CreateApiV3Opts, a6 as DebugAttachment, a7 as DebugSession, a8 as GeometryRect, a9 as LiveEvidence, aa as MockShape, ab as OverlayAnchorQuery, ac as PersistsTo, ad as ScrollTarget, ae as ScrollTargetBehavior, af as SelectionRangeInput, ag as SourceLayer, ah as StateClass, ai as SubscriptionShape, aj as UiBinding, ak as UiController, al as UiControllerKind, am as UiListener, an as UiUnsubscribe, ao as ViewportState, ap as createApiV3, aq as validateApiV3Metadata } from '../public-types-DdcHqcow.js';
 import 'react';
 import 'yjs';
 import 'y-protocols/awareness';
-import '../canonical-document-CG2TgAzj.js';
+import '../canonical-document-CXCFCbAz.js';
 import 'prosemirror-state';
 import 'prosemirror-model';
 

package/dist/api/v3.js

@@ -5,24 +5,24 @@ import {
   mockId,
   mockPayload,
   validateApiV3Metadata
-} from "../chunk-ZMRO6P3A.js";
-import "../chunk-Q76XPPTA.js";
+} from "../chunk-6IGWPAR4.js";
+import "../chunk-FPRWV54X.js";
 import "../chunk-C2LWJ4CZ.js";
 import {
   createUiApi,
   emitUxResponse
-} from "../chunk-HXHQA4BU.js";
-import "../chunk-ZRHLLPSJ.js";
+} from "../chunk-YIYM4ZAP.js";
+import "../chunk-YHZHPXDB.js";
 import "../chunk-KFCQYZXR.js";
 import "../chunk-QIO6V46H.js";
-import "../chunk-H6IL5ABU.js";
+import "../chunk-CXSYRB37.js";
 import "../chunk-OYGMRRR7.js";
-import "../chunk-7PC6XUNO.js";
-import "../chunk-4B74ETJI.js";
-import "../chunk-TY4DIJO3.js";
-import "../chunk-A74Y5NE4.js";
+import "../chunk-TQDQU2E3.js";
+import "../chunk-V6XVZFFH.js";
+import "../chunk-ESJ2MES5.js";
+import "../chunk-4YJVRIUB.js";
 import "../chunk-4BJ6K26R.js";
-import "../chunk-FNWKE74J.js";
+import "../chunk-5DGKFNQT.js";
 import "../chunk-OL2UEHRP.js";
 import "../chunk-EB6M3GE6.js";
 import "../chunk-IHE7YOAY.js";

package/dist/{canonical-document-CG2TgAzj.d.cts → canonical-document-CXCFCbAz.d.cts}

@@ -597,6 +597,8 @@ interface NumberingCatalog {
 interface NumPicBullet {
     /** `w:numPicBulletId` attribute value — the lookup key. */
     readonly numPicBulletId: string;
+    /** Source numbering-part pointer for Word telemetry joins. */
+    readonly sourceRef?: CanonicalSourceRef;
     /** Verbatim XML for the `<w:numPicBullet>` element. */
     readonly rawXml: string;
     /**

package/dist/{canonical-document-CG2TgAzj.d.ts → canonical-document-CXCFCbAz.d.ts}

@@ -597,6 +597,8 @@ interface NumberingCatalog {
 interface NumPicBullet {
     /** `w:numPicBulletId` attribute value — the lookup key. */
     readonly numPicBulletId: string;
+    /** Source numbering-part pointer for Word telemetry joins. */
+    readonly sourceRef?: CanonicalSourceRef;
     /** Verbatim XML for the `<w:numPicBullet>` element. */
     readonly rawXml: string;
     /**

package/dist/{chunk-PFYUJU3Q.js → chunk-2QL5DAKF.js}

@@ -2,7 +2,7 @@ import {
   incrementInvalidationCounter,
   recordPerfSample,
   resolvePageOverlayRectsFromGeometry
-} from "./chunk-N4VIXI2Z.js";
+} from "./chunk-MWSBGJQO.js";
 import {
   buildPageAnchorAttributes,
   buildPageAnchorSelector,
@@ -10,7 +10,7 @@ import {
   resolveChromePreset,
   resolveChromePresetOptions,
   resolveChromeVisibilityForPreset
-} from "./chunk-HXHQA4BU.js";
+} from "./chunk-YIYM4ZAP.js";
 import {
   DEFAULT_PAGE_ESTIMATE_PX_PER_TWIP,
   DEFAULT_PX_PER_TWIP,
@@ -20,19 +20,19 @@ import {
   findPageForOffset,
   getUsableColumnWidth,
   sanitizeMarkdown
-} from "./chunk-ZRHLLPSJ.js";
+} from "./chunk-YHZHPXDB.js";
 import {
   createCanvasBackend
 } from "./chunk-KFCQYZXR.js";
 import {
   storyTargetKey
-} from "./chunk-H6IL5ABU.js";
+} from "./chunk-CXSYRB37.js";
 import {
   EMU_PER_INCH,
   EMU_PER_PX,
   ROTATION_UNITS_PER_DEGREE,
   TWIPS_PER_PX
-} from "./chunk-FNWKE74J.js";
+} from "./chunk-5DGKFNQT.js";
 import {
   createPublicNodeAnchor,
   createPublicRangeAnchor
@@ -13801,26 +13801,42 @@ function resolveTopBarCommentAvailability(input) {
 
 // src/ui-tailwind/review-workspace/use-status-bar-page-facts.ts
 import { useMemo as useMemo8 } from "react";
-function useStatusBarPageFacts(options) {
-  const { layoutFacet, selectionPosition, activeStory, renderFrameRevision } = options;
-  return useMemo8(() => {
-    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 useMemo8(() => {
+    return resolveStatusBarPageFacts({
+      layoutFacet,
+      selectionPosition,
+      activeStory,
+      viewportPageIndexRange
+    });
+  }, [layoutFacet, selectionPosition, activeStory, viewportPageIndexRange, renderFrameRevision]);
 }
 
 // src/ui-tailwind/review-workspace/use-grabbed-segment-offsets.ts
@@ -14448,6 +14464,12 @@ function readCompatibilityScopeCardFromWorkflowFacet(workflowFacet, scopeId) {
 // src/ui-tailwind/review-workspace/use-page-markers.ts
 import { useEffect as useEffect23, useMemo as useMemo12, useState as useState22 } from "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
 import * as React26 from "react";
 var ESTIMATED_BLOCKS_PER_PAGE_FALLBACK = 50;
@@ -14828,7 +14850,7 @@ function pageMarkersEqual(a, b) {
   }
   return true;
 }
-function useGeometryVisiblePageIndexRange(input) {
+function useGeometryVisiblePageIndexRanges(input) {
   const {
     scrollRoot,
     geometryFacet,
@@ -14838,10 +14860,12 @@ function useGeometryVisiblePageIndexRange(input) {
     renderFrameRevision,
     viewportScale
   } = input;
-  const [range, setRange] = useState22(null);
+  const [ranges, setRanges] = useState22({ visiblePageIndexRange: null, viewportPageIndexRange: null });
   useEffect23(() => {
     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;
@@ -14851,7 +14875,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,
@@ -14861,7 +14885,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;
@@ -14898,7 +14937,7 @@ function useGeometryVisiblePageIndexRange(input) {
     scrollRoot,
     viewportScale
   ]);
-  return range;
+  return ranges;
 }
 function shouldUseCompatibilityPageMarkerScan(input) {
   return !input.geometryFacet || !input.layoutFacet;
@@ -14999,7 +15038,11 @@ function usePageMarkers(options) {
     pageMarkers,
     overscanPages
   });
-  const geometryVisiblePageIndexRange = useGeometryVisiblePageIndexRange({
+  const markerViewportPageIndexRange = useVisiblePageIndexRange({
+    pageMarkers,
+    overscanPages: 0
+  });
+  const geometryPageIndexRanges = useGeometryVisiblePageIndexRanges({
     scrollRoot: pageStackScrollRoot,
     geometryFacet,
     layoutFacet,
@@ -15008,7 +15051,8 @@ function usePageMarkers(options) {
     renderFrameRevision,
     viewportScale
   });
-  const visiblePageIndexRange = geometryVisiblePageIndexRange ?? markerVisiblePageIndexRange;
+  const visiblePageIndexRange = geometryPageIndexRanges.visiblePageIndexRange ?? markerVisiblePageIndexRange;
+  const viewportPageIndexRange = geometryPageIndexRanges.viewportPageIndexRange ?? markerViewportPageIndexRange;
   const visibleBlockRangesFromPageOffsets = useMemo12(
     () => visiblePageIndexRange && layoutFacet ? resolveVisibleBlockRangesFromPageOffsets({
       blocks: snapshot.surface?.blocks ?? [],
@@ -15044,9 +15088,11 @@ function usePageMarkers(options) {
     ]
   );
   const visibleBlockRanges = visibleBlockRangesFromPageOffsets ?? visibleBlockRangesFromPageRange ?? markerVisibleBlockRanges;
+  const totalBlockCount = snapshot.surface?.blocks.length ?? 0;
+  const shouldCullSurface = shouldUseMountedSurfaceViewportCulling(totalBlockCount);
   const visibleRangesKey = useMemo12(
-    () => visibleBlockRanges.map((r) => `${r.start}:${r.end}`).join("|"),
-    [visibleBlockRanges]
+    () => shouldCullSurface ? visibleBlockRanges.map((r) => `${r.start}:${r.end}`).join("|") : "full",
+    [shouldCullSurface, visibleBlockRanges]
   );
   useEffect23(() => {
     if (!layoutFacet) return;
@@ -15055,13 +15101,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
   };
 }
 
@@ -15530,11 +15582,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);
@@ -15560,14 +15621,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,
@@ -18705,6 +18758,8 @@ export {
   resolveSelectionToolRegistry,
   resolveScopedChromePolicy,
   shouldRenderSelectionToolKind,
+  MOUNTED_SURFACE_VIEWPORT_BLOCK_THRESHOLD,
+  shouldUseMountedSurfaceViewportCulling,
   findScrollAnchor,
   resolveScrollTopForAnchor,
   TwAlertBanner,

package/dist/{chunk-4IPEZYQX.js → chunk-4EENH4FG.js}

@@ -1,6 +1,6 @@
 import {
   buildSearchPattern
-} from "./chunk-ZRHLLPSJ.js";
+} from "./chunk-YHZHPXDB.js";
 
 // src/ui-tailwind/editor-surface/search-plugin.ts
 import { Plugin, PluginKey } from "prosemirror-state";

package/dist/{chunk-BOHHIVQ2.js → chunk-4G3OS2H6.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-Y4XZCMCS.js";
 import {
   applyTextTransaction
-} from "./chunk-IR7QV2BX.js";
+} from "./chunk-KV435YXO.js";
 import {
   createInsertedTableBlock,
   createNoopStructuralMutation,
@@ -11,11 +11,11 @@ import {
   replaceParagraphScope,
   resolveInsertedTableStyleId,
   resolveParagraphScope
-} from "./chunk-KOHQFZMM.js";
+} from "./chunk-BYSRJ4FE.js";
 import {
   NO_EDITABLE_TARGETS_INDEX,
   createEditorSurfaceSnapshot
-} from "./chunk-H6IL5ABU.js";
+} from "./chunk-CXSYRB37.js";
 import {
   createSelectionSnapshot
 } from "./chunk-OYGMRRR7.js";

package/dist/{chunk-A74Y5NE4.js → chunk-4YJVRIUB.js}

@@ -6,7 +6,7 @@ import {
   createHeaderFooterStoryKey,
   createNoteStoryKey,
   sha256TextHex
-} from "./chunk-FNWKE74J.js";
+} from "./chunk-5DGKFNQT.js";
 import {
   SCOPE_MARKER_BOOKMARK_PREFIX,
   buildGrabBagSourceChildFromParsed,
@@ -1031,18 +1031,23 @@ function parseNumberingXml(xml, context) {
   const abstractDefinitions = {};
   const instances = {};
   const numPicBullets = {};
+  const topLevelOrdinals = /* @__PURE__ */ new Map();
   for (const child of numberingElement.children) {
     if (child.type !== "element") {
       continue;
     }
-    if (localName(child.name) === "numPicBullet") {
+    const childName = localName(child.name);
+    const childOrdinal = (topLevelOrdinals.get(childName) ?? 0) + 1;
+    topLevelOrdinals.set(childName, childOrdinal);
+    const childXmlPath = `/numbering[1]/${childName}[${childOrdinal}]`;
+    if (childName === "numPicBullet") {
       const rawId = readStringAttr(child, "w:numPicBulletId");
       if (rawId) {
-        numPicBullets[rawId] = readNumPicBullet(child, rawId, context);
+        numPicBullets[rawId] = readNumPicBullet(child, rawId, context, childXmlPath);
       }
       continue;
     }
-    switch (localName(child.name)) {
+    switch (childName) {
       case "abstractNum": {
         const rawId = readStringAttr(child, "w:abstractNumId");
         if (!rawId) {
@@ -1062,7 +1067,7 @@ function parseNumberingXml(xml, context) {
         const numStyleLink = numStyleLinkEl ? readStringAttr(numStyleLinkEl, "w:val") : void 0;
         abstractDefinitions[abstractNumberingId] = {
           abstractNumberingId,
-          ...context?.partPath !== void 0 ? { sourceRef: createNumberingSourceRef(context.partPath, "abstractNum", rawId) } : {},
+          ...context?.partPath !== void 0 ? { sourceRef: createNumberingSourceRef(context.partPath, "abstractNum", rawId, childXmlPath) } : {},
           levels: readLevels(child),
           ...nsid ? { nsid } : {},
           ...multiLevelType ? { multiLevelType } : {},
@@ -1082,7 +1087,7 @@ function parseNumberingXml(xml, context) {
         const numberingInstanceId = toCanonicalNumberingInstanceId(rawId);
         instances[numberingInstanceId] = {
           numberingInstanceId,
-          ...context?.partPath !== void 0 ? { sourceRef: createNumberingSourceRef(context.partPath, "num", rawId) } : {},
+          ...context?.partPath !== void 0 ? { sourceRef: createNumberingSourceRef(context.partPath, "num", rawId, childXmlPath) } : {},
           abstractNumberingId: toCanonicalAbstractNumberingId(rawAbstractId),
           overrides: readOverrides(child)
         };
@@ -1096,15 +1101,16 @@ function parseNumberingXml(xml, context) {
     ...Object.keys(numPicBullets).length > 0 ? { numPicBullets } : {}
   };
 }
-function createNumberingSourceRef(partPath, element, rawId) {
+function createNumberingSourceRef(partPath, element, rawId, xmlPath) {
   return {
     sourceId: `part:${partPath}#${element}:${rawId}`,
     partPath,
     storyKind: "numbering",
-    element
+    element,
+    ...xmlPath !== void 0 ? { xmlPath } : {}
   };
 }
-function readNumPicBullet(node, numPicBulletId, context) {
+function readNumPicBullet(node, numPicBulletId, context, xmlPath) {
   let widthEmu;
   let heightEmu;
   let mediaId;
@@ -1167,6 +1173,7 @@ function readNumPicBullet(node, numPicBulletId, context) {
   }
   return {
     numPicBulletId,
+    ...context?.partPath !== void 0 ? { sourceRef: createNumberingSourceRef(context.partPath, "numPicBullet", numPicBulletId, xmlPath) } : {},
     rawXml: serializeXmlElementToString(node),
     ...widthEmu !== void 0 ? { widthEmu } : {},
     ...heightEmu !== void 0 ? { heightEmu } : {},
@@ -1487,7 +1494,8 @@ function parseInteger(value) {
 // src/io/ooxml/parse-bookmark-references.ts
 var HYPERLINK_ANCHOR_RE = /<(?:\w+:)?hyperlink\b[^>]*\bw:anchor\s*=\s*"([^"]*)"/gi;
 var INSTR_TEXT_RE = /<(?:\w+:)?instrText\b[^>]*>([\s\S]*?)<\/(?:\w+:)?instrText>/gi;
-var FLD_SIMPLE_INSTR_RE = /<(?:\w+:)?fldSimple\b[^>]*(?:\bw:instr|\binstr)\s*=\s*(["'])([\s\S]*?)\1/gi;
+var FLD_SIMPLE_INSTR_DOUBLE_RE = /<(?:\w+:)?fldSimple\b[^>]*?\b(?:w:)?instr\s*=\s*"([^"]*)"/gi;
+var FLD_SIMPLE_INSTR_SINGLE_RE = /<(?:\w+:)?fldSimple\b[^>]*?\b(?:w:)?instr\s*=\s*'([^']*)'/gi;
 var TOC_FIELD_RE = /\bTOC\b/;
 var REFLIKE_FIELD_RE = /\b(?:HYPERLINK|REF|PAGEREF|NOTEREF)\s+([A-Za-z0-9_:.\-]+)/g;
 var DATA_BINDING_RE = /<(?:\w+:)?dataBinding\b/i;
@@ -1506,11 +1514,22 @@ function scanBookmarkReferences(documentXml, callerAllowlist = []) {
   }
   INSTR_TEXT_RE.lastIndex = 0;
   while ((m = INSTR_TEXT_RE.exec(documentXml)) !== null) {
-    if (scanInstructionText(m[1] ?? "", retained)) retainAllToc = true;
+    const instrText = m[1] ?? "";
+    scanFieldInstruction(instrText, retained, () => {
+      retainAllToc = true;
+    });
   }
-  FLD_SIMPLE_INSTR_RE.lastIndex = 0;
-  while ((m = FLD_SIMPLE_INSTR_RE.exec(documentXml)) !== null) {
-    if (scanInstructionText(m[2] ?? "", retained)) retainAllToc = true;
+  FLD_SIMPLE_INSTR_DOUBLE_RE.lastIndex = 0;
+  while ((m = FLD_SIMPLE_INSTR_DOUBLE_RE.exec(documentXml)) !== null) {
+    scanFieldInstruction(decodeXmlAttribute(m[1] ?? ""), retained, () => {
+      retainAllToc = true;
+    });
+  }
+  FLD_SIMPLE_INSTR_SINGLE_RE.lastIndex = 0;
+  while ((m = FLD_SIMPLE_INSTR_SINGLE_RE.exec(documentXml)) !== null) {
+    scanFieldInstruction(decodeXmlAttribute(m[1] ?? ""), retained, () => {
+      retainAllToc = true;
+    });
   }
   retainRevisionBoundedBookmarks(documentXml, retained);
   return {
@@ -1519,14 +1538,16 @@ function scanBookmarkReferences(documentXml, callerAllowlist = []) {
     retainAll
   };
 }
-function scanInstructionText(instrText, retained) {
-  const hasTocField = TOC_FIELD_RE.test(instrText);
+function scanFieldInstruction(instrText, retained, retainToc) {
+  if (TOC_FIELD_RE.test(instrText)) retainToc();
   REFLIKE_FIELD_RE.lastIndex = 0;
   let r;
   while ((r = REFLIKE_FIELD_RE.exec(instrText)) !== null) {
     if (r[1]) retained.add(r[1]);
   }
-  return hasTocField;
+}
+function decodeXmlAttribute(value) {
+  return value.replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
 }
 function retainRevisionBoundedBookmarks(documentXml, retained) {
   const starts = /* @__PURE__ */ new Map();
@@ -5381,7 +5402,11 @@ function parseBodyChild(node, sourceXml, relationshipMap, relationships, mediaPa
     switch (localName(child.name)) {
       case "pPr":
         styleId = readParagraphStyleId(child);
-        numbering = readParagraphNumbering(child, sourcePartPath);
+        numbering = readParagraphNumbering(
+          child,
+          sourcePartPath,
+          `${sourceXmlPath}/pPr[${countPriorElementSiblingsByName(node, child) + 1}]`
+        );
         alignment = readParagraphAlignment(child);
         spacing = readParagraphSpacing2(child);
         contextualSpacing = readOptionalOnOffParagraphProperty(child, "contextualSpacing");
@@ -6464,7 +6489,7 @@ function readParagraphStyleId(node) {
   }
   return void 0;
 }
-function readParagraphNumbering(node, sourcePartPath) {
+function readParagraphNumbering(node, sourcePartPath, sourceXmlPath) {
   const numberingProperties = node.children.find(
     (child) => child.type === "element" && localName(child.name) === "numPr"
   );
@@ -6484,16 +6509,22 @@ function readParagraphNumbering(node, sourcePartPath) {
   }
   return {
     numberingInstanceId: toCanonicalNumberingInstanceId(rawInstanceId),
-    sourceRef: createElementSourceRef(sourcePartPath, "numPr", numberingProperties),
+    sourceRef: createElementSourceRef(
+      sourcePartPath,
+      "numPr",
+      numberingProperties,
+      sourceXmlPath !== void 0 ? `${sourceXmlPath}/numPr[${countPriorElementSiblingsByName(node, numberingProperties) + 1}]` : void 0
+    ),
     level: Number.parseInt(rawLevel, 10)
   };
 }
-function createElementSourceRef(partPath, element, node) {
+function createElementSourceRef(partPath, element, node, xmlPath) {
   return {
     sourceId: `part:${partPath}#${element}:${node.start}`,
     partPath,
     storyKind: storyKindFromPartPath(partPath),
     element,
+    ...xmlPath !== void 0 ? { xmlPath } : {},
     startOffset: node.start,
     endOffset: node.end
   };

package/dist/{chunk-FNWKE74J.js → chunk-5DGKFNQT.js}

@@ -916,7 +916,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",
@@ -950,6 +950,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,
@@ -1813,6 +1814,9 @@ function validateEditableTargetRef(value, path = "$") {
   if (record.canonicalAddress !== void 0) {
     validateTargetCanonicalAddress(record.canonicalAddress, `${path}.canonicalAddress`, issues);
   }
+  if (record.listAddress !== void 0) {
+    validateTargetCanonicalAddress(record.listAddress, `${path}.listAddress`, issues);
+  }
   const staleCheck = asPlainObject(record.staleCheck, `${path}.staleCheck`, issues);
   if (staleCheck) {
     if (staleCheck.paragraphTextHash !== void 0) {

package/dist/{chunk-RSYN6FTS.js → chunk-6F5QW44A.js}

@@ -1,10 +1,10 @@
 import {
   TextTransactionError
-} from "./chunk-IR7QV2BX.js";
+} from "./chunk-KV435YXO.js";
 import {
   replaceParagraphScope,
   resolveParagraphScope
-} from "./chunk-KOHQFZMM.js";
+} from "./chunk-BYSRJ4FE.js";
 import {
   cloneParagraphProperties,
   cloneStoryUnit,