@beyondwork/docx-react-component 1.0.131 → 1.0.133

package/dist/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: () => {
@@ -6486,6 +6575,187 @@ function createNodeAnchor(at, assoc = 1) {
 }
 var MAIN_STORY_TARGET = { kind: "main" };
 
+// src/runtime/telemetry/perf-probe.ts
+function recordPerfSample(kind, durationMs = 0) {
+  const state = getEnabledState();
+  if (!state) {
+    return null;
+  }
+  const token = `${kind}-${state.nextToken ?? 0}`;
+  state.nextToken = (state.nextToken ?? 0) + 1;
+  const sample = {
+    token,
+    kind,
+    durationMs,
+    recordedAt: Date.now()
+  };
+  pushSample(state, sample);
+  return sample;
+}
+function incrementInvalidationCounter(counter, amount = 1) {
+  const state = getEnabledState();
+  if (!state) {
+    return 0;
+  }
+  state.invalidationCounts ??= {};
+  state.invalidationCounts[counter] = (state.invalidationCounts[counter] ?? 0) + amount;
+  return state.invalidationCounts[counter];
+}
+function getEnabledState() {
+  if (typeof window === "undefined") {
+    return null;
+  }
+  const state = window.__DOCX_REACT_PERF_PROBE__;
+  if (!state?.enabled) {
+    return null;
+  }
+  return state;
+}
+function pushSample(state, sample) {
+  state.samples ??= [];
+  state.samples.push(sample);
+  const maxSamples = state.maxSamples ?? 20;
+  if (state.samples.length > maxSamples) {
+    state.samples.splice(0, state.samples.length - maxSamples);
+  }
+}
+
+// src/runtime/story-context.ts
+function collectSectionContexts(document2) {
+  const sections = [];
+  let sectionIndex = 0;
+  for (const block of document2.content.children) {
+    if (block.type !== "section_break") {
+      continue;
+    }
+    sections.push({
+      index: sectionIndex,
+      properties: block.sectionProperties
+    });
+    sectionIndex += 1;
+  }
+  sections.push({
+    index: sectionIndex,
+    properties: document2.subParts?.finalSectionProperties
+  });
+  return sections;
+}
+function resolveSectionVariants(kind, sectionIndex, explicitReferences, documents) {
+  if (explicitReferences && explicitReferences.length > 0) {
+    return explicitReferences.map((ref) => ({
+      variant: ref.variant,
+      relationshipId: ref.relationshipId
+    }));
+  }
+  return documents.filter(
+    (entry) => entry.sectionIndex === void 0 || entry.sectionIndex === sectionIndex
+  ).map((entry) => ({
+    variant: entry.variant,
+    relationshipId: entry.relationshipId
+  }));
+}
+function findHeaderFooterDocumentEntry(document2, target) {
+  const documents = target.kind === "header" ? document2.subParts?.headers ?? [] : document2.subParts?.footers ?? [];
+  const matches = documents.filter(
+    (entry) => entry.relationshipId === target.relationshipId && entry.variant === target.variant
+  );
+  if (matches.length === 0) {
+    return void 0;
+  }
+  if (target.sectionIndex !== void 0) {
+    return matches.find((entry) => entry.sectionIndex === target.sectionIndex) ?? matches.find((entry) => entry.sectionIndex === void 0) ?? matches[0];
+  }
+  return matches[0];
+}
+function sectionSupportsStoryTarget(document2, sectionIndex, target) {
+  if (!findHeaderFooterDocumentEntry(document2, target)) {
+    return false;
+  }
+  const section = collectSectionContexts(document2).find(
+    (candidate) => candidate.index === sectionIndex
+  );
+  if (!section) {
+    return false;
+  }
+  const variants = resolveSectionVariants(
+    target.kind,
+    sectionIndex,
+    target.kind === "header" ? section.properties?.headerReferences : section.properties?.footerReferences,
+    target.kind === "header" ? document2.subParts?.headers ?? [] : document2.subParts?.footers ?? []
+  );
+  return variants.some(
+    (variant) => variant.relationshipId === target.relationshipId && variant.variant === target.variant
+  );
+}
+function normalizeHeaderFooterTarget(document2, target, preferredSectionIndex) {
+  if (!findHeaderFooterDocumentEntry(document2, target)) {
+    return void 0;
+  }
+  if (target.sectionIndex !== void 0) {
+    return sectionSupportsStoryTarget(document2, target.sectionIndex, target) ? target : void 0;
+  }
+  const candidateIndexes = collectSectionContexts(document2).map((section) => section.index).filter(
+    (sectionIndex) => sectionSupportsStoryTarget(document2, sectionIndex, target)
+  );
+  if (candidateIndexes.length === 0) {
+    return void 0;
+  }
+  const resolvedSectionIndex = preferredSectionIndex !== void 0 && candidateIndexes.includes(preferredSectionIndex) ? preferredSectionIndex : candidateIndexes[0];
+  return {
+    ...target,
+    sectionIndex: resolvedSectionIndex
+  };
+}
+
+// src/runtime/story-targeting.ts
+function storyTargetKey(target) {
+  switch (target.kind) {
+    case "main":
+      return "main";
+    case "header":
+      return `header:${target.relationshipId}:${target.variant}:${target.sectionIndex ?? "*"}`;
+    case "footer":
+      return `footer:${target.relationshipId}:${target.variant}:${target.sectionIndex ?? "*"}`;
+    case "footnote":
+      return `footnote:${target.noteId}`;
+    case "endnote":
+      return `endnote:${target.noteId}`;
+  }
+}
+function getStoryBlocks(document2, target) {
+  if (target.kind === "main") {
+    return document2.content.children;
+  }
+  const subParts = document2.subParts;
+  if (!subParts) {
+    return [];
+  }
+  switch (target.kind) {
+    case "header": {
+      const resolvedTarget = normalizeHeaderFooterTarget(document2, target);
+      return (resolvedTarget && findHeaderFooterDocumentEntry(document2, resolvedTarget)?.blocks) ?? [];
+    }
+    case "footer": {
+      const resolvedTarget = normalizeHeaderFooterTarget(document2, target);
+      return (resolvedTarget && findHeaderFooterDocumentEntry(document2, resolvedTarget)?.blocks) ?? [];
+    }
+    case "footnote":
+      return subParts.footnoteCollection?.footnotes[target.noteId]?.blocks ?? [];
+    case "endnote":
+      return subParts.footnoteCollection?.endnotes[target.noteId]?.blocks ?? [];
+  }
+}
+
+// src/runtime/render/render-frame-types.ts
+var DEFAULT_PX_PER_TWIP = 96 / 1440;
+var EMPTY_DECORATION_INDEX = Object.freeze({
+  workflow: Object.freeze([]),
+  comments: Object.freeze([]),
+  revisions: Object.freeze([]),
+  search: Object.freeze([]),
+  locked: Object.freeze([])
+});
+
 // src/core/schema/text-schema.ts
 function parseTextStory(content) {
   const root = normalizeDocumentRoot(content);
@@ -6893,151 +7163,25 @@ function deriveCapabilities(snapshot, reviewMode, workflowScope) {
     healthIssueCount,
     workflowOverlayPresent,
     workflowBlocked,
-    isDirty: snapshot.isDirty,
-    isReady,
-    hasFatalError
-  };
-}
-function toRuntimeAnchor(anchor) {
-  switch (anchor.kind) {
-    case "range":
-      return createRangeAnchor(anchor.from, anchor.to, anchor.assoc);
-    case "node":
-      return createNodeAnchor(anchor.at, anchor.assoc);
-    case "detached":
-      return createDetachedAnchor(anchor.lastKnownRange, anchor.reason);
-  }
-}
-
-// src/api/public-types.ts
-init_measurement_backend_canvas();
-
-// src/runtime/story-context.ts
-function collectSectionContexts(document2) {
-  const sections = [];
-  let sectionIndex = 0;
-  for (const block of document2.content.children) {
-    if (block.type !== "section_break") {
-      continue;
-    }
-    sections.push({
-      index: sectionIndex,
-      properties: block.sectionProperties
-    });
-    sectionIndex += 1;
-  }
-  sections.push({
-    index: sectionIndex,
-    properties: document2.subParts?.finalSectionProperties
-  });
-  return sections;
-}
-function resolveSectionVariants(kind, sectionIndex, explicitReferences, documents) {
-  if (explicitReferences && explicitReferences.length > 0) {
-    return explicitReferences.map((ref) => ({
-      variant: ref.variant,
-      relationshipId: ref.relationshipId
-    }));
-  }
-  return documents.filter(
-    (entry) => entry.sectionIndex === void 0 || entry.sectionIndex === sectionIndex
-  ).map((entry) => ({
-    variant: entry.variant,
-    relationshipId: entry.relationshipId
-  }));
-}
-function findHeaderFooterDocumentEntry(document2, target) {
-  const documents = target.kind === "header" ? document2.subParts?.headers ?? [] : document2.subParts?.footers ?? [];
-  const matches = documents.filter(
-    (entry) => entry.relationshipId === target.relationshipId && entry.variant === target.variant
-  );
-  if (matches.length === 0) {
-    return void 0;
-  }
-  if (target.sectionIndex !== void 0) {
-    return matches.find((entry) => entry.sectionIndex === target.sectionIndex) ?? matches.find((entry) => entry.sectionIndex === void 0) ?? matches[0];
-  }
-  return matches[0];
-}
-function sectionSupportsStoryTarget(document2, sectionIndex, target) {
-  if (!findHeaderFooterDocumentEntry(document2, target)) {
-    return false;
-  }
-  const section = collectSectionContexts(document2).find(
-    (candidate) => candidate.index === sectionIndex
-  );
-  if (!section) {
-    return false;
-  }
-  const variants = resolveSectionVariants(
-    target.kind,
-    sectionIndex,
-    target.kind === "header" ? section.properties?.headerReferences : section.properties?.footerReferences,
-    target.kind === "header" ? document2.subParts?.headers ?? [] : document2.subParts?.footers ?? []
-  );
-  return variants.some(
-    (variant) => variant.relationshipId === target.relationshipId && variant.variant === target.variant
-  );
-}
-function normalizeHeaderFooterTarget(document2, target, preferredSectionIndex) {
-  if (!findHeaderFooterDocumentEntry(document2, target)) {
-    return void 0;
-  }
-  if (target.sectionIndex !== void 0) {
-    return sectionSupportsStoryTarget(document2, target.sectionIndex, target) ? target : void 0;
-  }
-  const candidateIndexes = collectSectionContexts(document2).map((section) => section.index).filter(
-    (sectionIndex) => sectionSupportsStoryTarget(document2, sectionIndex, target)
-  );
-  if (candidateIndexes.length === 0) {
-    return void 0;
-  }
-  const resolvedSectionIndex = preferredSectionIndex !== void 0 && candidateIndexes.includes(preferredSectionIndex) ? preferredSectionIndex : candidateIndexes[0];
-  return {
-    ...target,
-    sectionIndex: resolvedSectionIndex
-  };
-}
-
-// src/runtime/story-targeting.ts
-function storyTargetKey(target) {
-  switch (target.kind) {
-    case "main":
-      return "main";
-    case "header":
-      return `header:${target.relationshipId}:${target.variant}:${target.sectionIndex ?? "*"}`;
-    case "footer":
-      return `footer:${target.relationshipId}:${target.variant}:${target.sectionIndex ?? "*"}`;
-    case "footnote":
-      return `footnote:${target.noteId}`;
-    case "endnote":
-      return `endnote:${target.noteId}`;
-  }
+    isDirty: snapshot.isDirty,
+    isReady,
+    hasFatalError
+  };
 }
-function getStoryBlocks(document2, target) {
-  if (target.kind === "main") {
-    return document2.content.children;
-  }
-  const subParts = document2.subParts;
-  if (!subParts) {
-    return [];
-  }
-  switch (target.kind) {
-    case "header": {
-      const resolvedTarget = normalizeHeaderFooterTarget(document2, target);
-      return (resolvedTarget && findHeaderFooterDocumentEntry(document2, resolvedTarget)?.blocks) ?? [];
-    }
-    case "footer": {
-      const resolvedTarget = normalizeHeaderFooterTarget(document2, target);
-      return (resolvedTarget && findHeaderFooterDocumentEntry(document2, resolvedTarget)?.blocks) ?? [];
-    }
-    case "footnote":
-      return subParts.footnoteCollection?.footnotes[target.noteId]?.blocks ?? [];
-    case "endnote":
-      return subParts.footnoteCollection?.endnotes[target.noteId]?.blocks ?? [];
+function toRuntimeAnchor(anchor) {
+  switch (anchor.kind) {
+    case "range":
+      return createRangeAnchor(anchor.from, anchor.to, anchor.assoc);
+    case "node":
+      return createNodeAnchor(anchor.at, anchor.assoc);
+    case "detached":
+      return createDetachedAnchor(anchor.lastKnownRange, anchor.reason);
   }
 }
 
+// src/api/public-types.ts
+init_measurement_backend_canvas();
+
 // src/core/selection/anchor-conversion.ts
 var DEFAULT_PUBLIC_ASSOC = {
   start: -1,
@@ -7533,11 +7677,14 @@ function collectEditableTargetRefs(doc, cache) {
     collectEditableTargetsInBlocks(
       context.blocks,
       {
+        doc,
         storyKey: context.storyKey,
         basePath: context.basePath,
         insideSdt: false,
         insideTextBox: false,
-        tableDepth: 0
+        tableDepth: 0,
+        numberingCatalogHash: createNumberingCatalogRevisionHash(doc),
+        numberingTargetRevisionHash: createNumberingTargetRevisionHash(doc)
       },
       targets,
       cache
@@ -7554,6 +7701,7 @@ function buildBlockCacheSignature(context, blockIndex) {
   const owner = tt?.editableOwnersByChildIndex?.get(blockIndex);
   return [
     context.storyKey,
+    context.numberingTargetRevisionHash,
     context.insideSdt ? "1" : "0",
     context.insideTextBox ? "1" : "0",
     String(context.tableDepth),
@@ -7599,7 +7747,8 @@ function collectEditableTargetsInBlocks(blocks, context, targets, cache, blockIn
             editableParagraphTargetPosture(targetKind),
             context.contentControl,
             context.tableTarget,
-            context.tableTarget?.editableOwnersByChildIndex?.get(blockIndex)
+            context.tableTarget?.editableOwnersByChildIndex?.get(blockIndex),
+            resolveEditableParagraphListIdentity(block, context)
           )
         );
       }
@@ -8128,7 +8277,7 @@ function collectEditableTargetsInInlines(inlines, basePath, context, targets) {
     }
   }
 }
-function createParagraphEditableTarget(paragraph, kind, storyKey, blockPath, targetPosture = { editability: "editable", posture: { blockers: [] } }, contentControl, tableTarget, editableOwner) {
+function createParagraphEditableTarget(paragraph, kind, storyKey, blockPath, targetPosture = { editability: "editable", posture: { blockers: [] } }, contentControl, tableTarget, editableOwner, listIdentity) {
   const paragraphText = collectParagraphText(paragraph);
   const paragraphTextHash = hashText(paragraphText);
   const sourceRef = paragraph.sourceRef;
@@ -8139,19 +8288,39 @@ function createParagraphEditableTarget(paragraph, kind, storyKey, blockPath, tar
     context: { storyKey, insideSdt: contentControl !== void 0 },
     ...tableTarget
   }) : void 0;
-  const listAddress = paragraph.numbering !== void 0 ? createCanonicalAddress({
+  const listAddress = listIdentity !== void 0 ? createCanonicalAddress({
     addressKind: "list-item-text",
     storyKey,
     staleCheckKind: "paragraph",
     operationScope: "list-text",
-    sourceRefs: [sourceRef],
+    sourceRefs: [
+      sourceRef,
+      listIdentity.paragraphNumberingSourceRef,
+      listIdentity.instanceSourceRef,
+      listIdentity.abstractSourceRef
+    ],
     staleHash: paragraphTextHash,
     rangeBoundary: { boundaryKind: "list-item-text" },
+    list: {
+      numberingOrigin: listIdentity.numberingOrigin,
+      numberingInstanceId: listIdentity.numberingInstanceId,
+      ...listIdentity.abstractNumberingId !== void 0 ? { abstractNumberingId: listIdentity.abstractNumberingId } : {},
+      level: listIdentity.level,
+      ...listIdentity.overrideHash !== void 0 ? { overrideHash: listIdentity.overrideHash } : {},
+      numberingCatalogHash: listIdentity.numberingCatalogHash
+    },
     discriminator: {
       blockPath,
-      numberingInstanceId: paragraph.numbering.numberingInstanceId,
-      level: paragraph.numbering.level,
+      numberingOrigin: listIdentity.numberingOrigin,
+      numberingInstanceId: listIdentity.numberingInstanceId,
+      abstractNumberingId: listIdentity.abstractNumberingId ?? null,
+      level: listIdentity.level,
+      overrideHash: listIdentity.overrideHash ?? null,
+      numberingCatalogHash: listIdentity.numberingCatalogHash,
       sourceId: sourceRef?.sourceId ?? null,
+      numberingSourceId: listIdentity.paragraphNumberingSourceRef?.sourceId ?? null,
+      numberingInstanceSourceId: listIdentity.instanceSourceRef?.sourceId ?? null,
+      abstractNumberingSourceId: listIdentity.abstractSourceRef?.sourceId ?? null,
       paraId: paragraph.wordExtensionIds?.paraId ?? null,
       textId: paragraph.wordExtensionIds?.textId ?? null
     }
@@ -8192,11 +8361,62 @@ function createParagraphEditableTarget(paragraph, kind, storyKey, blockPath, tar
       blockType: "paragraph",
       ...paragraph.wordExtensionIds?.paraId !== void 0 ? { wordParaId: paragraph.wordExtensionIds.paraId } : {},
       ...paragraph.wordExtensionIds?.textId !== void 0 ? { wordTextId: paragraph.wordExtensionIds.textId } : {},
-      ...sourceRef !== void 0 ? { sourceRef } : {}
+      ...sourceRef !== void 0 ? { sourceRef } : {},
+      ...listIdentity !== void 0 ? {
+        listNumberingOrigin: listIdentity.numberingOrigin,
+        listNumberingInstanceId: listIdentity.numberingInstanceId,
+        ...listIdentity.abstractNumberingId !== void 0 ? { listAbstractNumberingId: listIdentity.abstractNumberingId } : {},
+        listLevel: listIdentity.level,
+        ...listIdentity.overrideHash !== void 0 ? { listOverrideHash: listIdentity.overrideHash } : {},
+        numberingCatalogHash: listIdentity.numberingCatalogHash
+      } : {}
     },
     posture
   };
 }
+function resolveEditableParagraphListIdentity(paragraph, context) {
+  const directNumbering = paragraph.numbering;
+  const styleNumbering = directNumbering === void 0 && paragraph.styleId !== void 0 ? resolveParagraphStyleNumbering(context.doc, paragraph.styleId) : void 0;
+  const numbering = directNumbering ?? styleNumbering;
+  if (numbering === void 0) return void 0;
+  const numberingCatalog = context.doc.numbering ?? { abstractDefinitions: {}, instances: {} };
+  const instances = numberingCatalog.instances ?? {};
+  const abstractDefinitions = numberingCatalog.abstractDefinitions ?? {};
+  const instance = instances[numbering.numberingInstanceId];
+  const abstractDefinition = instance !== void 0 ? abstractDefinitions[instance.abstractNumberingId] : void 0;
+  const level = numbering.level ?? 0;
+  const override = instance?.overrides.find((entry) => entry.level === level);
+  const overrideHash = override !== void 0 ? hashText(JSON.stringify(numberingOverrideDiscriminator(override))) : void 0;
+  return {
+    numberingOrigin: directNumbering !== void 0 ? "paragraph" : "paragraph-style",
+    numberingInstanceId: numbering.numberingInstanceId,
+    ...instance?.abstractNumberingId !== void 0 ? { abstractNumberingId: instance.abstractNumberingId } : {},
+    level,
+    ...overrideHash !== void 0 ? { overrideHash } : {},
+    numberingCatalogHash: context.numberingCatalogHash,
+    ...directNumbering?.sourceRef !== void 0 ? { paragraphNumberingSourceRef: directNumbering.sourceRef } : {},
+    ...instance?.sourceRef !== void 0 ? { instanceSourceRef: instance.sourceRef } : {},
+    ...abstractDefinition?.sourceRef !== void 0 ? { abstractSourceRef: abstractDefinition.sourceRef } : {}
+  };
+}
+function numberingOverrideDiscriminator(override) {
+  return {
+    level: override.level,
+    startAt: override.startAt ?? null,
+    sourceId: override.sourceRef?.sourceId ?? null,
+    levelDefinition: override.levelDefinition === void 0 ? null : {
+      sourceId: override.levelDefinition.sourceRef?.sourceId ?? null,
+      format: override.levelDefinition.format ?? null,
+      text: override.levelDefinition.text ?? null,
+      startAt: override.levelDefinition.startAt ?? null,
+      paragraphStyleId: override.levelDefinition.paragraphStyleId ?? null,
+      isLegalNumbering: override.levelDefinition.isLegalNumbering ?? null,
+      suffix: override.levelDefinition.suffix ?? null,
+      restartAfterLevel: override.levelDefinition.restartAfterLevel ?? null,
+      picBulletId: override.levelDefinition.picBulletId ?? null
+    }
+  };
+}
 function contentControlLocksContent(contentControl) {
   return contentControl?.lock !== void 0 && contentControl.lock !== "unlocked" && contentControl.lock !== "none";
 }
@@ -8965,6 +9185,7 @@ function createCanonicalAddress(input) {
     ...input.rowRange !== void 0 ? { rowRange: input.rowRange } : {},
     ...input.columnRange !== void 0 ? { columnRange: input.columnRange } : {},
     ...sourceHash !== void 0 ? { sourceJoinHash: sourceHash } : {},
+    ...input.list !== void 0 ? { list: input.list } : {},
     ...input.secondaryStory === true ? { secondaryStory: true } : {},
     ...input.nestedTable === true ? { nestedTable: true } : {},
     ...input.insideSdt === true ? { insideSdt: true } : {},
@@ -8999,6 +9220,103 @@ 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 ?? {};
+  const numPicBullets = catalog.numPicBullets ?? {};
+  return hashText(JSON.stringify({
+    abstractDefinitions: Object.keys(abstractDefinitions).sort().map((abstractNumberingId) => {
+      const definition = abstractDefinitions[abstractNumberingId];
+      return {
+        abstractNumberingId,
+        sourceId: definition.sourceRef?.sourceId ?? null,
+        nsid: definition.nsid ?? null,
+        tplc: definition.tplc ?? null,
+        styleLink: definition.styleLink ?? null,
+        numStyleLink: definition.numStyleLink ?? null,
+        levels: definition.levels.map((level) => ({
+          sourceId: level.sourceRef?.sourceId ?? null,
+          level: level.level,
+          format: level.format,
+          text: level.text,
+          startAt: level.startAt ?? null,
+          paragraphStyleId: level.paragraphStyleId ?? null,
+          isLegalNumbering: level.isLegalNumbering ?? null,
+          suffix: level.suffix ?? null,
+          restartAfterLevel: level.restartAfterLevel ?? null,
+          picBulletId: level.picBulletId ?? null
+        }))
+      };
+    }),
+    instances: Object.keys(instances).sort().map((numberingInstanceId) => {
+      const instance = instances[numberingInstanceId];
+      return {
+        numberingInstanceId,
+        sourceId: instance.sourceRef?.sourceId ?? null,
+        abstractNumberingId: instance.abstractNumberingId,
+        overrides: instance.overrides.map(numberingOverrideDiscriminator)
+      };
+    }),
+    numPicBullets: Object.keys(numPicBullets).sort().map((numPicBulletId) => {
+      const picBullet = numPicBullets[numPicBulletId];
+      return {
+        numPicBulletId,
+        sourceId: picBullet.sourceRef?.sourceId ?? null,
+        mediaId: picBullet.mediaId ?? null,
+        widthEmu: picBullet.widthEmu ?? null,
+        heightEmu: picBullet.heightEmu ?? null
+      };
+    })
+  }));
+}
+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];
+      return {
+        styleId,
+        basedOn: style.basedOn ?? null,
+        numberingInstanceId: style.numbering?.numberingInstanceId ?? null,
+        level: style.numbering?.level ?? null
+      };
+    })
+  }));
+}
 function collectCanonicalStoryIdentities(doc) {
   const stories = [
     {
@@ -9130,7 +9448,7 @@ function resolveParagraphStyleNumbering(doc, styleId) {
   let currentStyleId = styleId;
   while (currentStyleId !== void 0 && !visited.has(currentStyleId)) {
     visited.add(currentStyleId);
-    const style = doc.styles.paragraphs[currentStyleId];
+    const style = doc.styles?.paragraphs?.[currentStyleId];
     if (style === void 0) {
       return void 0;
     }
@@ -10686,6 +11004,10 @@ function createNumberingPrefixResolver(catalog) {
       ])
     ) : resolved.effectiveLevels;
     const picBulletId = resolved.effectiveLevel.picBulletId;
+    const pictureBulletPosture = resolvePictureBulletRenderPosture(
+      picBulletId,
+      picBulletId != null ? catalog.numPicBullets?.[picBulletId] : void 0
+    );
     const text = renderLevelText(
       resolved.effectiveLevel.text,
       workingState.counters,
@@ -10694,14 +11016,20 @@ function createNumberingPrefixResolver(catalog) {
     if (picBulletId == null && resolved.effectiveLevel.format !== "none" && text === null) {
       return null;
     }
-    const visibleText = resolved.effectiveLevel.format === "none" ? null : text;
+    const visibleText = resolved.effectiveLevel.format === "none" ? null : text ?? pictureBulletPosture?.fallbackGlyph ?? null;
+    const normalizedMarkerText = normalizeMarkerText(
+      visibleText,
+      resolved.effectiveLevel.format,
+      resolved.geometry.markerRunProperties
+    );
     const formatPosture = getNumberingFormatPosture(
       resolved.effectiveLevel.format,
       currentCounter
     );
-    const picBulletMediaId = picBulletId != null ? catalog.numPicBullets?.[picBulletId]?.mediaId : void 0;
+    const picBulletMediaId = pictureBulletPosture?.mediaId;
     return {
-      text: visibleText,
+      text: normalizedMarkerText.text,
+      ...normalizedMarkerText.posture !== void 0 ? { markerTextPosture: normalizedMarkerText.posture } : {},
       level: resolved.effectiveLevel.level,
       format: resolved.effectiveLevel.format,
       ...formatPosture !== void 0 ? { formatPosture } : {},
@@ -10711,7 +11039,9 @@ function createNumberingPrefixResolver(catalog) {
       ...resolved.effectiveLevel.isLegalNumbering ? { isLegalNumbering: true } : {},
       ...resolved.geometry.markerRunProperties ? { markerRunProperties: resolved.geometry.markerRunProperties } : {},
       geometry: resolved.geometry,
-      ...picBulletMediaId != null ? { picBulletMediaId } : {}
+      ...picBulletId != null ? { picBulletId } : {},
+      ...picBulletMediaId != null ? { picBulletMediaId } : {},
+      ...pictureBulletPosture !== void 0 ? { pictureBulletPosture } : {}
     };
   }
   return {
@@ -10727,6 +11057,69 @@ function createNumberingPrefixResolver(catalog) {
     }
   };
 }
+function normalizeMarkerText(text, format, markerRunProperties) {
+  if (text === null || format !== "bullet") {
+    return { text };
+  }
+  const fontFamily = getMarkerFontFamily(markerRunProperties);
+  if (!isKnownSymbolBulletFont(fontFamily)) {
+    return { text };
+  }
+  const renderedText = Array.from(text, (char) => SYMBOL_BULLET_GLYPH_MAP.get(char) ?? char).join("");
+  if (renderedText === text) {
+    return { text };
+  }
+  return {
+    text: renderedText,
+    posture: {
+      status: "normalized",
+      sourceText: text,
+      renderedText,
+      reason: "symbol-font-bullet-normalized",
+      ...fontFamily ? { fontFamily } : {}
+    }
+  };
+}
+function getMarkerFontFamily(markerRunProperties) {
+  return markerRunProperties?.fontFamilyAscii ?? markerRunProperties?.fontFamilyHAnsi ?? markerRunProperties?.fontFamilyEastAsia ?? markerRunProperties?.fontFamilyCs ?? markerRunProperties?.fontFamily;
+}
+function isKnownSymbolBulletFont(fontFamily) {
+  return fontFamily !== void 0 && /^(?:symbol|wingdings|wingdings 2|wingdings 3|webdings)$/iu.test(
+    fontFamily.trim()
+  );
+}
+var SYMBOL_BULLET_GLYPH_MAP = /* @__PURE__ */ new Map([
+  ["\uF0B7", "\u2022"],
+  ["\uF0A7", "\u25AA"],
+  ["\uF0FC", "\u2713"]
+]);
+function resolvePictureBulletRenderPosture(picBulletId, picBullet) {
+  if (picBulletId == null) return void 0;
+  if (!picBullet) {
+    return {
+      status: "preserve-only",
+      picBulletId,
+      fallbackGlyph: "\u2022",
+      reason: "picture-bullet-catalog-entry-missing"
+    };
+  }
+  if (picBullet.mediaId) {
+    return {
+      status: "media-rendered",
+      picBulletId,
+      mediaId: picBullet.mediaId,
+      ...picBullet.sourceRef ? { sourceRef: picBullet.sourceRef } : {},
+      reason: "picture-bullet-media-rendered"
+    };
+  }
+  return {
+    status: "glyph-fallback",
+    picBulletId,
+    fallbackGlyph: "\u2022",
+    ...picBullet.sourceRef ? { sourceRef: picBullet.sourceRef } : {},
+    reason: "picture-bullet-media-unavailable"
+  };
+}
 function getSequenceState(states, numberingInstanceId, options = { create: true }) {
   const existing = states.get(numberingInstanceId);
   if (existing) {
@@ -10789,7 +11182,7 @@ function getNumberingFormatPosture(format, value) {
       reason: registryEntry?.fallbackReason ?? "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)) {
+  if (value !== void 0 && (registryEntry.isInRange !== void 0 && !registryEntry.isInRange(value) || (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,
@@ -10883,6 +11276,37 @@ var exactNumberingFormatEntries = [
     supportsMutation: true,
     render: toOrdinal2
   },
+  {
+    format: "decimalFullWidth",
+    renderSupport: "supported",
+    renderedFormat: "decimalFullWidth",
+    supportsMutation: false,
+    render: toFullWidthDecimal
+  },
+  {
+    format: "decimalEnclosedCircle",
+    renderSupport: "supported",
+    renderedFormat: "decimalEnclosedCircle",
+    supportsMutation: false,
+    render: toCircledDecimal,
+    isInRange: (value) => Number.isInteger(value) && value >= 0 && value <= 50
+  },
+  {
+    format: "decimalEnclosedParen",
+    renderSupport: "supported",
+    renderedFormat: "decimalEnclosedParen",
+    supportsMutation: false,
+    render: (value) => Number.isInteger(value) && value > 0 ? `(${value})` : String(value),
+    isInRange: (value) => Number.isInteger(value) && value > 0
+  },
+  {
+    format: "decimalEnclosedFullstop",
+    renderSupport: "supported",
+    renderedFormat: "decimalEnclosedFullstop",
+    supportsMutation: false,
+    render: (value) => Number.isInteger(value) && value > 0 ? `${value}.` : String(value),
+    isInRange: (value) => Number.isInteger(value) && value > 0
+  },
   {
     format: "cardinalText",
     renderSupport: "supported",
@@ -10920,10 +11344,6 @@ var exactNumberingFormatEntries = [
   }
 ];
 var approximatedDecimalFormats = [
-  "decimalEnclosedCircle",
-  "decimalEnclosedFullstop",
-  "decimalEnclosedParen",
-  "decimalFullWidth",
   "decimalHalfWidth",
   "aiueo",
   "iroha",
@@ -10975,6 +11395,30 @@ function toOrdinal2(value) {
       return `${value}th`;
   }
 }
+function toFullWidthDecimal(value) {
+  return String(value).replace(
+    /[0-9]/g,
+    (digit) => String.fromCharCode(65296 + Number.parseInt(digit, 10))
+  );
+}
+var CIRCLED_DECIMAL_BY_VALUE = new Map([
+  [0, "\u24EA"],
+  ...Array.from({ length: 20 }, (_, index) => [
+    index + 1,
+    String.fromCodePoint(9312 + index)
+  ]),
+  ...Array.from({ length: 15 }, (_, index) => [
+    index + 21,
+    String.fromCodePoint(12881 + index)
+  ]),
+  ...Array.from({ length: 15 }, (_, index) => [
+    index + 36,
+    String.fromCodePoint(12977 + index)
+  ])
+]);
+function toCircledDecimal(value) {
+  return CIRCLED_DECIMAL_BY_VALUE.get(value) ?? String(value);
+}
 function toAlphabetic2(value) {
   if (value <= 0) {
     return String(value);
@@ -11748,6 +12192,7 @@ function toNumberingLayoutInput(numbering) {
   const hangingTwips = textColumn?.hanging ?? numbering.geometry.indentation?.hanging ?? (typeof numbering.geometry.indentation?.firstLine === "number" && numbering.geometry.indentation.firstLine < 0 ? Math.abs(numbering.geometry.indentation.firstLine) : void 0);
   return {
     markerText: numbering.text,
+    ...numbering.markerTextPosture ? { markerTextPosture: { ...numbering.markerTextPosture } } : {},
     ...numbering.markerRunProperties ? { markerRunFormatting: numbering.markerRunProperties } : {},
     markerSuffix: normalizeNumberingMarkerSuffix(numbering.suffix),
     ...markerLane ? { markerLaneStartTwips: markerLane.start } : {},
@@ -11760,7 +12205,9 @@ function toNumberingLayoutInput(numbering) {
     ...numbering.formatPosture !== void 0 ? { formatPosture: { ...numbering.formatPosture } } : {},
     startAt: numbering.startAt,
     ...numbering.isLegalNumbering ? { isLegalNumbering: true } : {},
-    ...numbering.picBulletMediaId ? { pictureBulletMediaId: numbering.picBulletMediaId } : {}
+    ...numbering.picBulletId ? { pictureBulletId: numbering.picBulletId } : {},
+    ...numbering.picBulletMediaId ? { pictureBulletMediaId: numbering.picBulletMediaId } : {},
+    ...numbering.pictureBulletPosture ? { pictureBulletPosture: { ...numbering.pictureBulletPosture } } : {}
   };
 }
 function toFieldLayoutInput(entry, resolved, region) {
@@ -12272,6 +12719,7 @@ function buildEffectiveNumbering(detail) {
   const result = {
     level: detail.level,
     ...detail.text !== null ? { marker: detail.text } : {},
+    ...detail.markerTextPosture ? { markerTextPosture: { ...detail.markerTextPosture } } : {},
     ...detail.markerRunProperties ? { markerRunFormatting: detail.markerRunProperties } : {},
     ...detail.geometry ? {
       indentation: {
@@ -12281,7 +12729,8 @@ function buildEffectiveNumbering(detail) {
         ...detail.geometry.tabStops && detail.geometry.tabStops.length > 0 ? { tab: detail.geometry.tabStops[0].position } : {}
       }
     } : {},
-    ...detail.picBulletMediaId ? { pictureBulletRef: detail.picBulletMediaId } : {}
+    ...detail.picBulletMediaId ? { pictureBulletRef: detail.picBulletMediaId } : {},
+    ...detail.pictureBulletPosture ? { pictureBulletPosture: { ...detail.pictureBulletPosture } } : {}
   };
   return result;
 }
@@ -14197,6 +14646,7 @@ function toSurfaceResolvedNumbering(numbering) {
     format: numbering.format,
     ...numbering.formatPosture !== void 0 ? { formatPosture: { ...numbering.formatPosture } } : {},
     ...numbering.text !== null ? { text: numbering.text } : {},
+    ...numbering.markerTextPosture !== void 0 ? { markerTextPosture: { ...numbering.markerTextPosture } } : {},
     startAt: numbering.startAt,
     ...numbering.paragraphStyleId ? { paragraphStyleId: numbering.paragraphStyleId } : {},
     ...numbering.isLegalNumbering ? { isLegalNumbering: true } : {},
@@ -14209,7 +14659,9 @@ function toSurfaceResolvedNumbering(numbering) {
       ...numbering.geometry.markerLane ? { markerLane: { ...numbering.geometry.markerLane } } : {},
       ...numbering.geometry.textColumn ? { textColumn: { ...numbering.geometry.textColumn } } : {}
     },
-    ...numbering.picBulletMediaId ? { picBulletMediaId: numbering.picBulletMediaId } : {}
+    ...numbering.picBulletId ? { picBulletId: numbering.picBulletId } : {},
+    ...numbering.picBulletMediaId ? { picBulletMediaId: numbering.picBulletMediaId } : {},
+    ...numbering.pictureBulletPosture ? { pictureBulletPosture: { ...numbering.pictureBulletPosture } } : {}
   };
 }
 function describePreservedInlinePreview(payloadReference) {
@@ -18281,6 +18733,11 @@ function freezeNumberingLayoutFacts(numbering) {
   if (numbering.numberingSourceRef) Object.freeze(numbering.numberingSourceRef);
   if (numbering.numberingInstanceSourceRef) Object.freeze(numbering.numberingInstanceSourceRef);
   if (numbering.abstractNumberingSourceRef) Object.freeze(numbering.abstractNumberingSourceRef);
+  if (numbering.markerTextPosture) Object.freeze(numbering.markerTextPosture);
+  if (numbering.pictureBulletPosture) {
+    if (numbering.pictureBulletPosture.sourceRef) Object.freeze(numbering.pictureBulletPosture.sourceRef);
+    Object.freeze(numbering.pictureBulletPosture);
+  }
   if (numbering.markerLane) Object.freeze(numbering.markerLane);
   if (numbering.textColumn) Object.freeze(numbering.textColumn);
   if (numbering.tabStops) {
@@ -19233,8 +19690,17 @@ function collectNumberingLayoutFacts(block) {
     ...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.resolvedNumbering?.markerTextPosture !== void 0 ? { markerTextPosture: { ...block.resolvedNumbering.markerTextPosture } } : {},
     ...block.numberingSuffix !== void 0 ? { markerSuffix: block.numberingSuffix } : {},
     ...block.resolvedNumbering?.geometry.markerJustification !== void 0 ? { markerJustification: block.resolvedNumbering.geometry.markerJustification } : {},
+    ...block.resolvedNumbering?.picBulletId !== void 0 ? { picBulletId: block.resolvedNumbering.picBulletId } : {},
+    ...block.resolvedNumbering?.picBulletMediaId !== void 0 ? { picBulletMediaId: block.resolvedNumbering.picBulletMediaId } : {},
+    ...block.resolvedNumbering?.pictureBulletPosture !== void 0 ? {
+      pictureBulletPosture: {
+        ...block.resolvedNumbering.pictureBulletPosture,
+        ...block.resolvedNumbering.pictureBulletPosture.sourceRef !== void 0 ? { sourceRef: { ...block.resolvedNumbering.pictureBulletPosture.sourceRef } } : {}
+      }
+    } : {},
     ...markerLane ? {
       markerLane: {
         startTwips: markerLane.start,
@@ -20023,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";
@@ -20249,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) {
@@ -20399,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",
@@ -20460,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;
@@ -20553,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",
@@ -20582,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",
@@ -20611,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;
@@ -20626,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));
@@ -20645,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(),
@@ -20692,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);
@@ -20735,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
       });
     },
@@ -20757,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;
     }
   };
@@ -20848,16 +21373,6 @@ function findPageForOffset3(pages, offset) {
   return Math.max(0, pages.length - 1);
 }
 
-// src/runtime/render/render-frame-types.ts
-var DEFAULT_PX_PER_TWIP = 96 / 1440;
-var EMPTY_DECORATION_INDEX = Object.freeze({
-  workflow: Object.freeze([]),
-  comments: Object.freeze([]),
-  revisions: Object.freeze([]),
-  search: Object.freeze([]),
-  locked: Object.freeze([])
-});
-
 // src/runtime/markdown-sanitizer.ts
 function sanitizeMarkdown(raw) {
   let sanitized = false;
@@ -21697,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",
         {
@@ -21709,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"
               }
@@ -21718,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"
               }
@@ -21726,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",
@@ -22123,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,
@@ -24084,6 +24628,7 @@ var EDITOR_ACTION_REGISTRY = [
     group: "clipboard",
     targetKinds: [
       "plain-text",
+      "list-item",
       "table-cell",
       "image",
       "hyperlink",
@@ -24102,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",
@@ -24119,6 +24666,7 @@ var EDITOR_ACTION_REGISTRY = [
     group: "clipboard",
     targetKinds: [
       "plain-text",
+      "list-item",
       "table-cell",
       "hyperlink",
       "suggestion",
@@ -24279,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({
@@ -24649,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",
@@ -25547,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)) {
@@ -25584,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;
 }
 
@@ -25772,51 +26341,6 @@ function noopDismiss() {
 // src/ui-tailwind/chrome-overlay/tw-scope-card-layer.tsx
 var React20 = __toESM(require("react"), 1);
 
-// src/runtime/telemetry/perf-probe.ts
-function recordPerfSample(kind, durationMs = 0) {
-  const state = getEnabledState();
-  if (!state) {
-    return null;
-  }
-  const token = `${kind}-${state.nextToken ?? 0}`;
-  state.nextToken = (state.nextToken ?? 0) + 1;
-  const sample = {
-    token,
-    kind,
-    durationMs,
-    recordedAt: Date.now()
-  };
-  pushSample(state, sample);
-  return sample;
-}
-function incrementInvalidationCounter(counter, amount = 1) {
-  const state = getEnabledState();
-  if (!state) {
-    return 0;
-  }
-  state.invalidationCounts ??= {};
-  state.invalidationCounts[counter] = (state.invalidationCounts[counter] ?? 0) + amount;
-  return state.invalidationCounts[counter];
-}
-function getEnabledState() {
-  if (typeof window === "undefined") {
-    return null;
-  }
-  const state = window.__DOCX_REACT_PERF_PROBE__;
-  if (!state?.enabled) {
-    return null;
-  }
-  return state;
-}
-function pushSample(state, sample) {
-  state.samples ??= [];
-  state.samples.push(sample);
-  const maxSamples = state.maxSamples ?? 20;
-  if (state.samples.length > maxSamples) {
-    state.samples.splice(0, state.samples.length - maxSamples);
-  }
-}
-
 // src/ui-tailwind/chrome-overlay/chrome-overlay-projector.ts
 function projectRectToOverlay(rect2, space = { originLeftPx: 0, originTopPx: 0 }) {
   const t0 = typeof performance !== "undefined" ? performance.now() : 0;
@@ -27850,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;
@@ -27964,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
         },
@@ -28013,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",
     {
@@ -28023,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(
@@ -28034,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 = {
@@ -33404,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,
@@ -33518,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";
@@ -33786,6 +34367,7 @@ function TwReviewWorkspace(inputProps) {
                 zoomLevel: props.zoomLevel,
                 formattingState: props.formattingState,
                 activeListContext: props.activeListContext,
+                activeListReadback,
                 styleCatalog: props.styleCatalog,
                 showTrackedChanges: trackedChangesAuthoringEnabled,
                 showSidebarToggle: responsiveChrome.showSidebarToggle,
@@ -33997,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,