@beyondwork/docx-react-component 1.0.132 → 1.0.133

package/dist/ui-tailwind.cjs

@@ -2668,6 +2668,43 @@ function TwToolbar(props) {
   const showPostFormattingDivider = showListActionsInRow || showSpacingActionsInRow || showInsertActionsInRow || showUpdateActionsInRow || showCompactOverflow;
   const zoomLabel = typeof zoomLevel === "number" ? `${zoomLevel}%` : zoomLevel === "pageWidth" ? "Fit width" : "Fit page";
   const showZoomSteppers = responsiveTier === "wide";
+  const bulletedListState = resolveListCommandControl({
+    canEdit,
+    editDisabledReason,
+    callback: props.onToggleBulletedList,
+    availability: getListCommandAvailability(props.activeListReadback, "toggle-bulleted")
+  });
+  const numberedListState = resolveListCommandControl({
+    canEdit,
+    editDisabledReason,
+    callback: props.onToggleNumberedList,
+    availability: getListCommandAvailability(props.activeListReadback, "toggle-numbered")
+  });
+  const outdentState = resolveListCommandControl({
+    canEdit,
+    editDisabledReason,
+    callback: props.onOutdent,
+    availability: getListCommandAvailability(props.activeListReadback, "outdent")
+  });
+  const indentState = resolveListCommandControl({
+    canEdit,
+    editDisabledReason,
+    callback: props.onIndent,
+    availability: getListCommandAvailability(props.activeListReadback, "indent")
+  });
+  const restartNumberingState = resolveListCommandControl({
+    canEdit,
+    editDisabledReason,
+    callback: props.onRestartNumbering,
+    availability: getListCommandAvailability(props.activeListReadback, "restart-numbering")
+  });
+  const continueNumberingState = resolveListCommandControl({
+    canEdit,
+    editDisabledReason,
+    callback: props.onContinueNumbering,
+    availability: getListCommandAvailability(props.activeListReadback, "continue-numbering")
+  });
+  const activeListKind = props.activeListReadback?.listKind;
   return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
     "header",
     {
@@ -2683,7 +2720,7 @@ function TwToolbar(props) {
       },
       className: [
         "shrink-0 rounded-[var(--radius-sm)] border border-[var(--color-border-subtle)]",
-        "bg-[var(--color-bg-chrome)] px-2.5",
+        "bg-[var(--color-bg-chrome)] px-2.5 shadow-[var(--shadow-soft)]",
         isCompact ? "flex min-h-10 flex-wrap items-center gap-1.5 py-1.5" : "flex items-center gap-1"
       ].join(" "),
       children: [
@@ -2852,9 +2889,9 @@ function TwToolbar(props) {
               {
                 icon: import_lucide_react5.List,
                 label: "Bulleted list",
-                active: Boolean(props.activeListContext && !props.activeListContext.isOrdered),
-                disabled: !canEdit || !props.onToggleBulletedList,
-                disabledReason: editDisabledReason,
+                active: activeListKind ? activeListKind === "bulleted" : Boolean(props.activeListContext && !props.activeListContext.isOrdered),
+                disabled: bulletedListState.disabled,
+                disabledReason: bulletedListState.disabledReason,
                 onClick: props.onToggleBulletedList
               }
             ),
@@ -2863,9 +2900,9 @@ function TwToolbar(props) {
               {
                 icon: import_lucide_react5.Rows3,
                 label: "Numbered list",
-                active: Boolean(props.activeListContext?.isOrdered),
-                disabled: !canEdit || !props.onToggleNumberedList,
-                disabledReason: editDisabledReason,
+                active: activeListKind ? activeListKind === "numbered" : Boolean(props.activeListContext?.isOrdered),
+                disabled: numberedListState.disabled,
+                disabledReason: numberedListState.disabledReason,
                 onClick: props.onToggleNumberedList
               }
             )
@@ -2876,8 +2913,8 @@ function TwToolbar(props) {
               {
                 icon: import_lucide_react5.Outdent,
                 label: "Outdent",
-                disabled: !canEdit || !props.onOutdent,
-                disabledReason: editDisabledReason,
+                disabled: outdentState.disabled,
+                disabledReason: outdentState.disabledReason,
                 onClick: props.onOutdent
               }
             ),
@@ -2886,8 +2923,8 @@ function TwToolbar(props) {
               {
                 icon: import_lucide_react5.Indent,
                 label: "Indent",
-                disabled: !canEdit || !props.onIndent,
-                disabledReason: editDisabledReason,
+                disabled: indentState.disabled,
+                disabledReason: indentState.disabledReason,
                 onClick: props.onIndent
               }
             )
@@ -2897,8 +2934,8 @@ function TwToolbar(props) {
               ToolbarTextButton,
               {
                 ariaLabel: "Restart numbering",
-                disabled: !canEdit || !props.onRestartNumbering,
-                disabledReason: editDisabledReason,
+                disabled: restartNumberingState.disabled,
+                disabledReason: restartNumberingState.disabledReason,
                 onClick: props.onRestartNumbering,
                 children: "Restart"
               }
@@ -2907,8 +2944,8 @@ function TwToolbar(props) {
               ToolbarTextButton,
               {
                 ariaLabel: "Continue numbering",
-                disabled: !canEdit || !props.onContinueNumbering,
-                disabledReason: editDisabledReason,
+                disabled: continueNumberingState.disabled,
+                disabledReason: continueNumberingState.disabledReason,
                 onClick: props.onContinueNumbering,
                 children: "Continue"
               }
@@ -2952,6 +2989,7 @@ function TwToolbar(props) {
             ToolbarCompactOverflow,
             {
               activeListContext: props.activeListContext,
+              activeListReadback: props.activeListReadback,
               canEdit,
               canInsertStructural,
               editDisabledReason,
@@ -3485,8 +3523,59 @@ function ToolbarFontSizeSelect(props) {
     }
   );
 }
+function getListCommandAvailability(readback, command) {
+  return readback?.commandSupport.find((entry) => entry.command === command);
+}
+function resolveListCommandControl(input) {
+  if (!input.canEdit) {
+    return { disabled: true, disabledReason: input.editDisabledReason };
+  }
+  if (!input.callback) {
+    return { disabled: true };
+  }
+  if (input.availability?.enabled === false) {
+    return { disabled: true, disabledReason: input.availability.reason };
+  }
+  return { disabled: false };
+}
 function ToolbarCompactOverflow(props) {
   const [open, setOpen] = import_react4.default.useState(false);
+  const bulletedListState = resolveListCommandControl({
+    canEdit: props.canEdit,
+    editDisabledReason: props.editDisabledReason,
+    callback: props.onToggleBulletedList,
+    availability: getListCommandAvailability(props.activeListReadback, "toggle-bulleted")
+  });
+  const numberedListState = resolveListCommandControl({
+    canEdit: props.canEdit,
+    editDisabledReason: props.editDisabledReason,
+    callback: props.onToggleNumberedList,
+    availability: getListCommandAvailability(props.activeListReadback, "toggle-numbered")
+  });
+  const outdentState = resolveListCommandControl({
+    canEdit: props.canEdit,
+    editDisabledReason: props.editDisabledReason,
+    callback: props.onOutdent,
+    availability: getListCommandAvailability(props.activeListReadback, "outdent")
+  });
+  const indentState = resolveListCommandControl({
+    canEdit: props.canEdit,
+    editDisabledReason: props.editDisabledReason,
+    callback: props.onIndent,
+    availability: getListCommandAvailability(props.activeListReadback, "indent")
+  });
+  const restartNumberingState = resolveListCommandControl({
+    canEdit: props.canEdit,
+    editDisabledReason: props.editDisabledReason,
+    callback: props.onRestartNumbering,
+    availability: getListCommandAvailability(props.activeListReadback, "restart-numbering")
+  });
+  const continueNumberingState = resolveListCommandControl({
+    canEdit: props.canEdit,
+    editDisabledReason: props.editDisabledReason,
+    callback: props.onContinueNumbering,
+    availability: getListCommandAvailability(props.activeListReadback, "continue-numbering")
+  });
   const overflowGroups = [
     props.showStyleSelectors || props.showInlineFormatting || props.showTextColors ? "Format" : null,
     props.showListActions || props.showParagraphActions || props.showParagraphAlignment || props.showListContinuation ? "Paragraph" : null,
@@ -3703,8 +3792,8 @@ function ToolbarCompactOverflow(props) {
           ToolbarMenuButton,
           {
             ariaLabel: "Bulleted list",
-            disabled: !props.canEdit || !props.onToggleBulletedList,
-            disabledReason: props.editDisabledReason,
+            disabled: bulletedListState.disabled,
+            disabledReason: bulletedListState.disabledReason,
             icon: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_lucide_react5.List, { className: "h-3.5 w-3.5" }),
             label: "Bulleted list",
             onClick: () => {
@@ -3717,8 +3806,8 @@ function ToolbarCompactOverflow(props) {
           ToolbarMenuButton,
           {
             ariaLabel: "Numbered list",
-            disabled: !props.canEdit || !props.onToggleNumberedList,
-            disabledReason: props.editDisabledReason,
+            disabled: numberedListState.disabled,
+            disabledReason: numberedListState.disabledReason,
             icon: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_lucide_react5.Rows3, { className: "h-3.5 w-3.5" }),
             label: "Numbered list",
             onClick: () => {
@@ -3747,8 +3836,8 @@ function ToolbarCompactOverflow(props) {
             ToolbarMenuButton,
             {
               ariaLabel: "Outdent",
-              disabled: !props.canEdit || !props.onOutdent,
-              disabledReason: props.editDisabledReason,
+              disabled: outdentState.disabled,
+              disabledReason: outdentState.disabledReason,
               icon: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_lucide_react5.Outdent, { className: "h-3.5 w-3.5" }),
               label: "Outdent",
               onClick: () => {
@@ -3761,8 +3850,8 @@ function ToolbarCompactOverflow(props) {
             ToolbarMenuButton,
             {
               ariaLabel: "Indent",
-              disabled: !props.canEdit || !props.onIndent,
-              disabledReason: props.editDisabledReason,
+              disabled: indentState.disabled,
+              disabledReason: indentState.disabledReason,
               icon: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_lucide_react5.Indent, { className: "h-3.5 w-3.5" }),
               label: "Indent",
               onClick: () => {
@@ -3777,8 +3866,8 @@ function ToolbarCompactOverflow(props) {
             ToolbarMenuButton,
             {
               ariaLabel: "Restart numbering",
-              disabled: !props.canEdit || !props.onRestartNumbering,
-              disabledReason: props.editDisabledReason,
+              disabled: restartNumberingState.disabled,
+              disabledReason: restartNumberingState.disabledReason,
               icon: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_lucide_react5.Rows3, { className: "h-3.5 w-3.5" }),
               label: "Restart numbering",
               onClick: () => {
@@ -3791,8 +3880,8 @@ function ToolbarCompactOverflow(props) {
             ToolbarMenuButton,
             {
               ariaLabel: "Continue numbering",
-              disabled: !props.canEdit || !props.onContinueNumbering,
-              disabledReason: props.editDisabledReason,
+              disabled: continueNumberingState.disabled,
+              disabledReason: continueNumberingState.disabledReason,
               icon: /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_lucide_react5.Rows3, { className: "h-3.5 w-3.5" }),
               label: "Continue numbering",
               onClick: () => {
@@ -9131,7 +9220,20 @@ function sourceJoinHash(refs) {
   if (sourceIds.length === 0) return void 0;
   return hashText(sourceIds.join("\0"));
 }
+var numberingCatalogHashCache = /* @__PURE__ */ new WeakMap();
+var numberingTargetHashCache = /* @__PURE__ */ new WeakMap();
 function createNumberingCatalogRevisionHash(doc) {
+  const numbering = doc.numbering;
+  if (numbering !== void 0) {
+    const cached = numberingCatalogHashCache.get(numbering);
+    if (cached !== void 0) return cached;
+    const fresh = computeNumberingCatalogRevisionHash(doc);
+    numberingCatalogHashCache.set(numbering, fresh);
+    return fresh;
+  }
+  return computeNumberingCatalogRevisionHash(doc);
+}
+function computeNumberingCatalogRevisionHash(doc) {
   const catalog = doc.numbering ?? { abstractDefinitions: {}, instances: {} };
   const abstractDefinitions = catalog.abstractDefinitions ?? {};
   const instances = catalog.instances ?? {};
@@ -9182,8 +9284,27 @@ function createNumberingCatalogRevisionHash(doc) {
   }));
 }
 function createNumberingTargetRevisionHash(doc) {
+  const numbering = doc.numbering;
+  const styles = doc.styles;
+  if (numbering !== void 0 && styles !== void 0) {
+    let inner = numberingTargetHashCache.get(numbering);
+    if (inner === void 0) {
+      inner = /* @__PURE__ */ new WeakMap();
+      numberingTargetHashCache.set(numbering, inner);
+    }
+    const cached = inner.get(styles);
+    if (cached !== void 0) return cached;
+    const fresh = computeNumberingTargetRevisionHash(doc);
+    inner.set(styles, fresh);
+    return fresh;
+  }
+  return computeNumberingTargetRevisionHash(doc);
+}
+function computeNumberingTargetRevisionHash(doc) {
   const paragraphStyles = doc.styles?.paragraphs ?? {};
   return hashText(JSON.stringify({
+    // Reuses the memoized catalog hash on the hot path so a typing edit
+    // pays for the catalog hash at most once across both helpers.
     numberingCatalogHash: createNumberingCatalogRevisionHash(doc),
     paragraphStyleNumbering: Object.keys(paragraphStyles).sort().map((styleId) => {
       const style = paragraphStyles[styleId];
@@ -20368,7 +20489,7 @@ function fnv1a2(input) {
 }
 
 // src/runtime/layout/layout-engine-version.ts
-var LAYOUT_ENGINE_VERSION = 93;
+var LAYOUT_ENGINE_VERSION = 94;
 
 // src/runtime/layout/layout-engine-instance.ts
 var FULL_VIEWPORT_WINDOW_KEY = "full";
@@ -20594,11 +20715,45 @@ function createLayoutEngine(options = {}) {
   const telemetryBus = options.telemetryBus;
   const dirtyFieldFamilies = /* @__PURE__ */ new Set();
   const listeners = /* @__PURE__ */ new Set();
-  let cachedKey = null;
-  let cachedGraph = null;
-  let cachedFormatting = null;
-  let cachedMapper = null;
+  let cachedFull = null;
+  let cachedWindowed = null;
   let previousPageCount = 0;
+  function isFullViewportKey(key) {
+    return key === FULL_VIEWPORT_WINDOW_KEY;
+  }
+  function getCachedSlot(viewportWindowKeyValue) {
+    return isFullViewportKey(viewportWindowKeyValue) ? cachedFull : cachedWindowed;
+  }
+  function preferredCachedGraph() {
+    return cachedFull?.graph ?? cachedWindowed?.graph ?? null;
+  }
+  function clearAllSlots() {
+    cachedFull = null;
+    cachedWindowed = null;
+  }
+  function clearWindowedSlot() {
+    cachedWindowed = null;
+  }
+  function evictStaleSiblingSlot(freshKey) {
+    const sibling = isFullViewportKey(freshKey.viewportWindowKey) ? cachedWindowed : cachedFull;
+    if (sibling === null) return;
+    if (sibling.key.content === freshKey.content && sibling.key.styles === freshKey.styles && sibling.key.subParts === freshKey.subParts) {
+      return;
+    }
+    if (isFullViewportKey(freshKey.viewportWindowKey)) {
+      cachedWindowed = null;
+    } else {
+      cachedFull = null;
+    }
+  }
+  function commitSlot(slot) {
+    if (isFullViewportKey(slot.key.viewportWindowKey)) {
+      cachedFull = slot;
+    } else {
+      cachedWindowed = slot;
+    }
+    evictStaleSiblingSlot(slot.key);
+  }
   let pendingInvalidation = null;
   function emit(event) {
     for (const listener of listeners) {
@@ -20744,27 +20899,31 @@ function createLayoutEngine(options = {}) {
       subParts: document2.subParts,
       anchors: layoutInputs.anchors
     });
+    const priorGraphForMaterialization = preferredCachedGraph();
     const graph = applyViewportWindowMaterialization(
       measuredGraph,
       viewportWindow,
-      cachedGraph
+      priorGraphForMaterialization
     );
-    const dirtyFamilies = computeFieldDirtiness(cachedGraph, graph);
+    const priorGraphForFieldDirtiness = preferredCachedGraph();
+    const dirtyFamilies = computeFieldDirtiness(priorGraphForFieldDirtiness, graph);
     for (const family of dirtyFamilies) {
       dirtyFieldFamilies.add(family);
     }
     const formatting = buildResolvedFormattingState(document2, mainSurface);
     const currentPageCount = graph.contentPageCount;
     const pageCountDelta = currentPageCount !== previousPageCount ? { previous: previousPageCount, current: currentPageCount } : void 0;
-    cachedKey = {
-      content: document2.content,
-      styles: document2.styles,
-      subParts: document2.subParts,
-      viewportWindowKey: viewportWindowKey(viewportWindow)
-    };
-    cachedGraph = graph;
-    cachedFormatting = formatting;
-    cachedMapper = createPageFragmentMapper(graph);
+    commitSlot({
+      key: {
+        content: document2.content,
+        styles: document2.styles,
+        subParts: document2.subParts,
+        viewportWindowKey: viewportWindowKey(viewportWindow)
+      },
+      graph,
+      formatting,
+      mapper: createPageFragmentMapper(graph)
+    });
     if (pageCountDelta) {
       emit({
         kind: "page_count_changed",
@@ -20805,7 +20964,7 @@ function createLayoutEngine(options = {}) {
     return graph;
   }
   function incrementalRelayout(input, pending) {
-    const priorGraph = cachedGraph;
+    const priorGraph = cachedFull?.graph ?? null;
     const range = pending.result.dirtyPageRange;
     if (!priorGraph || !range) return null;
     const telemetryOn = telemetryBus?.isEnabled("layout") ?? false;
@@ -20898,6 +21057,22 @@ function createLayoutEngine(options = {}) {
       deriveDocumentPageSnapshots(splicedGraph)
     );
     const pageCountDelta = currentPageCount !== previousPageCount ? { previous: previousPageCount, current: currentPageCount } : void 0;
+    const priorMapper = cachedFull?.mapper ?? null;
+    commitSlot({
+      key: {
+        content: document2.content,
+        styles: document2.styles,
+        subParts: document2.subParts,
+        viewportWindowKey: FULL_VIEWPORT_WINDOW_KEY
+      },
+      graph: splicedGraph,
+      formatting,
+      mapper: rebuildMapper(
+        priorMapper ?? createPageFragmentMapper(splicedGraph),
+        splicedGraph,
+        firstDirty
+      )
+    });
     if (pageCountDelta) {
       emit({
         kind: "page_count_changed",
@@ -20927,19 +21102,6 @@ function createLayoutEngine(options = {}) {
       ...dirtyFamilies.length > 0 ? { dirtyFieldFamilies: dirtyFamilies } : {},
       ...pageCountDelta ? { pageCountDelta } : {}
     });
-    cachedKey = {
-      content: document2.content,
-      styles: document2.styles,
-      subParts: document2.subParts,
-      viewportWindowKey: FULL_VIEWPORT_WINDOW_KEY
-    };
-    cachedGraph = splicedGraph;
-    cachedFormatting = formatting;
-    cachedMapper = rebuildMapper(
-      cachedMapper ?? createPageFragmentMapper(splicedGraph),
-      splicedGraph,
-      firstDirty
-    );
     if (telemetryOn) {
       emitRecomputeCompleted(
         "bounded",
@@ -20956,13 +21118,14 @@ function createLayoutEngine(options = {}) {
     const document2 = input.document;
     const normalizedWindow = normalizeViewportPageWindow(input.viewportPageWindow);
     const currentViewportWindowKey = viewportWindowKey(normalizedWindow);
-    const keyEqual = cachedGraph !== null && cachedKey !== null && cachedKey.content === document2.content && cachedKey.styles === document2.styles && cachedKey.subParts === document2.subParts && cachedKey.viewportWindowKey === currentViewportWindowKey;
+    const slot = getCachedSlot(currentViewportWindowKey);
+    const keyEqual = slot !== null && slot.key.content === document2.content && slot.key.styles === document2.styles && slot.key.subParts === document2.subParts && slot.key.viewportWindowKey === currentViewportWindowKey;
     if (keyEqual && pendingInvalidation === null) {
-      return cachedGraph;
+      return slot.graph;
     }
     const pending = pendingInvalidation;
     pendingInvalidation = null;
-    if (pending !== null && pending.result.scope === "bounded" && cachedGraph !== null && normalizedWindow === void 0) {
+    if (pending !== null && pending.result.scope === "bounded" && cachedFull !== null && normalizedWindow === void 0) {
       const spliced = incrementalRelayout(input, pending);
       if (spliced !== null) {
         return spliced;
@@ -20971,16 +21134,39 @@ function createLayoutEngine(options = {}) {
     }
     return fullRebuild(input, pending?.reason);
   }
+  function ensureSlotMapperAndFormatting(slot, document2) {
+    if (slot.mapper === null) {
+      slot.mapper = createPageFragmentMapper(slot.graph);
+    }
+    if (slot.formatting === null) {
+      const mainSurface = createEditorSurfaceSnapshot(
+        document2,
+        createSelectionSnapshot(0, 0),
+        MAIN_STORY_TARGET
+      );
+      slot.formatting = buildResolvedFormattingState(document2, mainSurface);
+    }
+  }
   function getMapper(input) {
     getGraphInternal(input);
-    return cachedMapper;
+    const currentViewportWindowKey = viewportWindowKey(
+      normalizeViewportPageWindow(input.viewportPageWindow)
+    );
+    const slot = getCachedSlot(currentViewportWindowKey);
+    ensureSlotMapperAndFormatting(slot, input.document);
+    return slot.mapper;
   }
   function getFormatting(input) {
     getGraphInternal(input);
-    return cachedFormatting;
+    const currentViewportWindowKey = viewportWindowKey(
+      normalizeViewportPageWindow(input.viewportPageWindow)
+    );
+    const slot = getCachedSlot(currentViewportWindowKey);
+    ensureSlotMapperAndFormatting(slot, input.document);
+    return slot.formatting;
   }
   if (autoUpgradeToCanvas && options.measurementProvider === void 0 && typeof document !== "undefined" && typeof HTMLCanvasElement !== "undefined") {
-    const readCachedRevision = () => cachedGraph?.revision ?? 0;
+    const readCachedRevision = () => preferredCachedGraph()?.revision ?? 0;
     void (async () => {
       try {
         const mod = await Promise.resolve().then(() => (init_measurement_backend_canvas(), measurement_backend_canvas_exports));
@@ -20990,10 +21176,7 @@ function createLayoutEngine(options = {}) {
           options.measurementCache,
           telemetryBus
         );
-        cachedKey = null;
-        cachedGraph = null;
-        cachedFormatting = null;
-        cachedMapper = null;
+        clearAllSlots();
         emit({
           kind: "measurement_backend_ready",
           revision: readCachedRevision(),
@@ -21037,22 +21220,19 @@ function createLayoutEngine(options = {}) {
       return getMapper(input);
     },
     invalidate(reason) {
-      const result = analyzeInvalidation(reason, cachedGraph);
+      const result = analyzeInvalidation(reason, preferredCachedGraph());
       for (const family of result.dirtyFieldFamilies) {
         dirtyFieldFamilies.add(family);
       }
       if (result.scope === "bounded") {
         pendingInvalidation = { reason, result };
       } else {
-        cachedKey = null;
-        cachedGraph = null;
-        cachedFormatting = null;
-        cachedMapper = null;
+        clearAllSlots();
         pendingInvalidation = { reason, result };
       }
     },
     analyzeInvalidation(reason) {
-      return analyzeInvalidation(reason, cachedGraph);
+      return analyzeInvalidation(reason, preferredCachedGraph());
     },
     getDirtyFieldFamilies() {
       return Array.from(dirtyFieldFamilies);
@@ -21080,14 +21260,11 @@ function createLayoutEngine(options = {}) {
         telemetryBus
       );
       if (previousFidelity !== provider.fidelity) {
-        cachedKey = null;
-        cachedGraph = null;
-        cachedFormatting = null;
-        cachedMapper = null;
+        clearAllSlots();
       }
       emit({
         kind: "measurement_backend_ready",
-        revision: cachedGraph?.revision ?? 0,
+        revision: preferredCachedGraph()?.revision ?? 0,
         fidelity: provider.fidelity
       });
     },
@@ -21102,30 +21279,33 @@ function createLayoutEngine(options = {}) {
      */
     invalidateMeasurementCache() {
       measurementProvider.invalidateCache();
-      cachedKey = null;
-      cachedGraph = null;
-      cachedFormatting = null;
-      cachedMapper = null;
+      clearAllSlots();
     },
     getMeasurementCacheStats() {
       if (!isCachedLayoutMeasurementProvider(measurementProvider)) return null;
       return measurementProvider.measurementCacheStats();
     },
     /**
-     * L7 Phase 2.5 — seed the cached graph from a prerender envelope.
-     * Populates both `cachedGraph` and `cachedKey` (keyed on the provided
-     * document's identity-equal slots) so the next getPageGraph query
-     * returns the seeded graph directly. Any subsequent mutation
-     * invalidates normally through the existing path.
+     * L7 Phase 2.5 — seed the full-slot cached graph from a prerender
+     * envelope. Populates the full slot (graph + key, with formatting and
+     * mapper computed lazily on first read) so the next viewport-
+     * independent `getPageGraph` query returns the seeded graph directly.
+     * Any subsequent mutation invalidates normally through the existing
+     * path; sibling eviction in `commitSlot` clears `cachedWindowed` if
+     * it carried a different document tuple.
      */
     seedCachedGraph(graph, document2) {
-      cachedGraph = graph;
-      cachedKey = {
-        content: document2.content,
-        styles: document2.styles,
-        subParts: document2.subParts,
-        viewportWindowKey: FULL_VIEWPORT_WINDOW_KEY
-      };
+      commitSlot({
+        key: {
+          content: document2.content,
+          styles: document2.styles,
+          subParts: document2.subParts,
+          viewportWindowKey: FULL_VIEWPORT_WINDOW_KEY
+        },
+        graph,
+        formatting: null,
+        mapper: null
+      });
       previousPageCount = graph.contentPageCount;
     }
   };
@@ -22032,7 +22212,17 @@ function TwSelectionToolStructure(props) {
           onSetCellVerticalAlign: props.onSetCellVerticalAlign
         }
       );
-    case "list":
+    case "list": {
+      const continueState = resolveListToolbarButtonState({
+        canMutate: props.model.canMutate,
+        callback: props.onContinueNumbering,
+        availability: getListCommandAvailability2(props.activeListReadback, "continue-numbering")
+      });
+      const restartState = resolveListToolbarButtonState({
+        canMutate: props.model.canMutate,
+        callback: props.onRestartNumbering,
+        availability: getListCommandAvailability2(props.activeListReadback, "restart-numbering")
+      });
       return /* @__PURE__ */ (0, import_jsx_runtime25.jsxs)(
         "div",
         {
@@ -22044,7 +22234,8 @@ function TwSelectionToolStructure(props) {
               ToolbarButton3,
               {
                 ariaLabel: "Continue numbering",
-                disabled: !props.model.canMutate || !props.onContinueNumbering,
+                disabled: continueState.disabled,
+                disabledReason: continueState.disabledReason,
                 onClick: props.onContinueNumbering,
                 children: "Continue"
               }
@@ -22053,7 +22244,8 @@ function TwSelectionToolStructure(props) {
               ToolbarButton3,
               {
                 ariaLabel: "Restart numbering",
-                disabled: !props.model.canMutate || !props.onRestartNumbering,
+                disabled: restartState.disabled,
+                disabledReason: restartState.disabledReason,
                 onClick: props.onRestartNumbering,
                 children: "Restart"
               }
@@ -22061,15 +22253,31 @@ function TwSelectionToolStructure(props) {
           ]
         }
       );
+    }
   }
 }
+function getListCommandAvailability2(readback, command) {
+  return readback?.commandSupport.find((entry) => entry.command === command);
+}
+function resolveListToolbarButtonState(input) {
+  if (!input.canMutate || !input.callback) {
+    return { disabled: true };
+  }
+  if (input.availability?.enabled === false) {
+    return { disabled: true, disabledReason: input.availability.reason };
+  }
+  return { disabled: false };
+}
 function ToolbarButton3(props) {
+  const disabledReason = props.disabled && props.disabledReason ? props.disabledReason : void 0;
   return /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(
     "button",
     {
       type: "button",
       "aria-label": props.ariaLabel,
       disabled: props.disabled,
+      "data-disabled-reason": disabledReason,
+      title: disabledReason ? `Not available: ${disabledReason}` : void 0,
       onMouseDown: preserveEditorSelectionMouseDown,
       onClick: props.onClick,
       className: "inline-flex h-7 items-center rounded-md border border-border px-2 text-[length:var(--text-xs)] font-medium text-secondary transition-colors hover:bg-surface disabled:cursor-not-allowed disabled:opacity-40",
@@ -22458,6 +22666,7 @@ function renderTool(props, tool, density) {
           onSetImageFrame: props.onSetImageFrame,
           onRestartNumbering: props.onRestartNumbering,
           onContinueNumbering: props.onContinueNumbering,
+          activeListReadback: props.activeListReadback,
           onToggleRowHeader: props.onToggleRowHeader,
           onToggleRowCantSplit: props.onToggleRowCantSplit,
           onDistributeColumnsEvenly: props.onDistributeColumnsEvenly,
@@ -24419,6 +24628,7 @@ var EDITOR_ACTION_REGISTRY = [
     group: "clipboard",
     targetKinds: [
       "plain-text",
+      "list-item",
       "table-cell",
       "image",
       "hyperlink",
@@ -24437,9 +24647,11 @@ var EDITOR_ACTION_REGISTRY = [
     group: "clipboard",
     targetKinds: [
       "plain-text",
+      "list-item",
       "table-cell",
       "image",
       "hyperlink",
+      "generated-field",
       "suggestion",
       "comment-anchor",
       "opaque-block",
@@ -24454,6 +24666,7 @@ var EDITOR_ACTION_REGISTRY = [
     group: "clipboard",
     targetKinds: [
       "plain-text",
+      "list-item",
       "table-cell",
       "hyperlink",
       "suggestion",
@@ -24614,28 +24827,28 @@ var EDITOR_ACTION_REGISTRY = [
     id: "list-bulleted",
     label: "Bulleted list",
     group: "formatting",
-    targetKinds: ["plain-text", "table-cell"],
+    targetKinds: ["list-item", "plain-text", "table-cell"],
     callback: "onToggleBulletedList"
   }),
   mk({
     id: "list-numbered",
     label: "Numbered list",
     group: "formatting",
-    targetKinds: ["plain-text", "table-cell"],
+    targetKinds: ["list-item", "plain-text", "table-cell"],
     callback: "onToggleNumberedList"
   }),
   mk({
     id: "paragraph-outdent",
     label: "Decrease indent",
     group: "formatting",
-    targetKinds: ["plain-text", "table-cell"],
+    targetKinds: ["list-item", "plain-text", "table-cell"],
     callback: "onOutdent"
   }),
   mk({
     id: "paragraph-indent",
     label: "Increase indent",
     group: "formatting",
-    targetKinds: ["plain-text", "table-cell"],
+    targetKinds: ["list-item", "plain-text", "table-cell"],
     callback: "onIndent"
   }),
   mkArg({
@@ -24984,6 +25197,15 @@ var EDITOR_ACTION_REGISTRY = [
     targetKinds: ["hyperlink"],
     callback: "onOpenHyperlink"
   }),
+  // -------- Generated fields --------
+  mk({
+    id: "field-refresh",
+    label: "Refresh field",
+    description: "Refresh generated field results through the runtime field updater.",
+    group: "misc",
+    targetKinds: ["generated-field"],
+    callback: "onUpdateFields"
+  }),
   // -------- Workflow scope --------
   mk({
     id: "scope-open-card",
@@ -25882,8 +26104,18 @@ function resolveTargetKind(target, options = {}) {
   const el = toElement(target);
   if (el) {
     const { root } = options;
+    const insideNumberingMarker = hasAncestorAttributeValue(
+      el,
+      "data-numbering-marker",
+      "true",
+      root
+    );
+    const insideListItem = insideNumberingMarker || hasAncestorAttributeValue(el, "data-numbered", "true", root);
+    const insideGeneratedField = hasAncestorAttributeValue(el, "data-generated-field", "true", root) || hasAncestorAttributeValue(el, "data-node-type", "field_ref_atom", root) || hasAncestorAttributeValue(el, "data-node-type", "field_ref", root);
+    if (insideListItem) kinds.push("list-item");
+    if (insideGeneratedField) kinds.push("generated-field");
     if (hasAncestorTag(el, "a", root)) kinds.push("hyperlink");
-    if (hasAncestorTag(el, "img", root)) {
+    if (!insideNumberingMarker && hasAncestorTag(el, "img", root)) {
       kinds.push("image");
     }
     if (hasAncestorTag(el, "td", root) || hasAncestorTag(el, "th", root)) {
@@ -25919,7 +26151,9 @@ function resolveTargetKind(target, options = {}) {
       if (!kinds.includes("template-slot")) kinds.push("template-slot");
     }
   }
-  if (!kinds.includes("plain-text")) kinds.push("plain-text");
+  if (!kinds.includes("generated-field") && !kinds.includes("plain-text")) {
+    kinds.push("plain-text");
+  }
   return kinds;
 }
 
@@ -28140,6 +28374,18 @@ function emuToPx(emu, pxPerTwip) {
   return emu / EMU_PER_PX * zoomFactor;
 }
 
+// src/ui-tailwind/editor-surface/media-src-policy.ts
+var SAFE_DATA_IMAGE_PREFIX_RE = /^data:image\/(?:png|jpe?g|gif|webp|bmp);base64,/iu;
+var MAX_NUMBERING_PICTURE_BULLET_DATA_URL_LENGTH = 1024 * 1024;
+function sanitizeNumberingPictureBulletSrc(src) {
+  if (typeof src !== "string") return null;
+  const trimmed = src.trim();
+  if (trimmed.length === 0) return null;
+  if (trimmed.length > MAX_NUMBERING_PICTURE_BULLET_DATA_URL_LENGTH) return null;
+  if (!SAFE_DATA_IMAGE_PREFIX_RE.test(trimmed)) return null;
+  return trimmed;
+}
+
 // src/ui-tailwind/page-stack/tw-region-block-renderer.tsx
 var import_jsx_runtime49 = require("react/jsx-runtime");
 var EMU_PER_PX2 = 9525;
@@ -28254,6 +28500,10 @@ function renderSegment(seg, mediaPreviews, fallbackDisplay, tabInfoBySegment) {
         "span",
         {
           "data-node-type": "field_ref",
+          "data-generated-field": "true",
+          "data-field-family": seg.fieldFamily,
+          "data-field-target": seg.fieldTarget,
+          "data-field-refresh-status": seg.refreshStatus,
           style: { opacity: 0.6, fontSize: "0.85em" },
           children: seg.displayText ?? seg.label
         },
@@ -28303,6 +28553,9 @@ function RegionParagraph({
   const markerWidth = resolvedNumbering?.geometry?.markerLane?.width;
   const markerStart = resolvedNumbering?.geometry?.markerLane?.start;
   const markerJustification = resolvedNumbering?.geometry?.markerJustification;
+  const pictureBulletSrc = sanitizeNumberingPictureBulletSrc(
+    resolvedNumbering?.picBulletMediaId ? mediaPreviews[resolvedNumbering.picBulletMediaId]?.src : null
+  );
   const prefixSpan = numberingPrefix != null ? /* @__PURE__ */ (0, import_jsx_runtime49.jsx)(
     "span",
     {
@@ -28313,7 +28566,9 @@ function RegionParagraph({
         ...!markerRunProperties ? ["text-tertiary", "font-[family-name:var(--font-legal-sans)]"] : []
       ].join(" "),
       contentEditable: false,
-      "data-numbering-prefix": numberingPrefix,
+      "data-numbering-marker": "true",
+      "data-numbering-prefix": pictureBulletSrc ? "" : numberingPrefix,
+      ...pictureBulletSrc ? { "data-numbering-picture-bullet": resolvedNumbering?.pictureBulletPosture?.status ?? "media-rendered" } : {},
       ...typeof resolvedNumbering?.level === "number" ? { "data-numbering-level": String(resolvedNumbering.level) } : {},
       ...numberingSuffix ? { "data-numbering-suffix": numberingSuffix } : {},
       style: buildMarkerStyle(
@@ -28324,7 +28579,20 @@ function RegionParagraph({
         markerStart,
         markerJustification
       ),
-      children: numberingPrefix
+      children: pictureBulletSrc ? /* @__PURE__ */ (0, import_jsx_runtime49.jsx)(
+        "img",
+        {
+          src: pictureBulletSrc,
+          alt: "",
+          "aria-hidden": "true",
+          style: {
+            maxWidth: "100%",
+            maxHeight: "100%",
+            objectFit: "contain",
+            display: "block"
+          }
+        }
+      ) : numberingPrefix
     }
   ) : null;
   const attrs = {
@@ -33694,6 +33962,21 @@ function resolveRoleChromePreset(basePreset, role) {
   }
   return basePreset;
 }
+function resolveActiveListReadback(rows, activeListContext, selection) {
+  if (!activeListContext) {
+    return null;
+  }
+  const selectionPoint = selection.activeRange.kind === "range" ? selection.head : selection.activeRange.kind === "node" ? selection.activeRange.at : selection.activeRange.lastKnownRange.from;
+  const matchingSelectionRow = rows.find(
+    (row) => row.numberingInstanceId === activeListContext.numberingInstanceId && row.level === activeListContext.level && selectionPoint >= row.authoredTextRange.from && selectionPoint <= row.authoredTextRange.to
+  );
+  if (matchingSelectionRow) {
+    return matchingSelectionRow;
+  }
+  return rows.find(
+    (row) => row.numberingInstanceId === activeListContext.numberingInstanceId && row.level === activeListContext.level
+  ) ?? null;
+}
 function TwReviewWorkspace(inputProps) {
   const props = {
     ...inputProps,
@@ -33808,6 +34091,14 @@ function TwReviewWorkspace(inputProps) {
     () => uiApi?.scope.list().length,
     [uiApi, renderFrameRevision]
   );
+  const activeListReadback = (0, import_react51.useMemo)(
+    () => resolveActiveListReadback(
+      uiApi?.lists.list() ?? [],
+      props.activeListContext,
+      viewState.selection
+    ),
+    [uiApi, props.activeListContext, viewState.selection, renderFrameRevision]
+  );
   const headings = props.documentNavigation?.headings ?? [];
   const headerVariant = snapshot.pageLayout?.headerVariants[0]?.variant ?? "default";
   const footerVariant = snapshot.pageLayout?.footerVariants[0]?.variant ?? "default";
@@ -34076,6 +34367,7 @@ function TwReviewWorkspace(inputProps) {
                 zoomLevel: props.zoomLevel,
                 formattingState: props.formattingState,
                 activeListContext: props.activeListContext,
+                activeListReadback,
                 styleCatalog: props.styleCatalog,
                 showTrackedChanges: trackedChangesAuthoringEnabled,
                 showSidebarToggle: responsiveChrome.showSidebarToggle,
@@ -34287,6 +34579,7 @@ function TwReviewWorkspace(inputProps) {
                               onSetImageFrame: props.onSetImageFrame,
                               onRestartNumbering: props.onRestartNumbering,
                               onContinueNumbering: props.onContinueNumbering,
+                              activeListReadback,
                               onToggleRowHeader: props.onToggleRowHeader,
                               onToggleRowCantSplit: props.onToggleRowCantSplit,
                               onDistributeColumnsEvenly: props.onDistributeColumnsEvenly,