@beyondwork/docx-react-component 1.0.131 → 1.0.133

package/dist/core/commands/text-commands.cjs

@@ -934,11 +934,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
@@ -955,6 +958,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),
@@ -1000,7 +1004,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)
           )
         );
       }
@@ -1529,7 +1534,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;
@@ -1540,19 +1545,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
     }
@@ -1593,11 +1618,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";
 }
@@ -2366,6 +2442,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 } : {},
@@ -2400,6 +2477,119 @@ 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 resolveParagraphStyleNumbering(doc, styleId) {
+  const visited = /* @__PURE__ */ new Set();
+  let currentStyleId = styleId;
+  while (currentStyleId !== void 0 && !visited.has(currentStyleId)) {
+    visited.add(currentStyleId);
+    const style = doc.styles?.paragraphs?.[currentStyleId];
+    if (style === void 0) {
+      return void 0;
+    }
+    if (style.numbering !== void 0) {
+      return style.numbering;
+    }
+    currentStyleId = style.basedOn;
+  }
+  return void 0;
+}
 function collectCanonicalFieldRegionIdentities(doc) {
   const registry = doc.fieldRegistry;
   const byFieldIndex = new Map(
@@ -3846,6 +4036,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,
@@ -3854,14 +4048,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 } : {},
@@ -3871,7 +4071,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 {
@@ -3887,6 +4089,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) {
@@ -3949,7 +4214,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,
@@ -4043,6 +4308,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",
@@ -4080,10 +4376,6 @@ var exactNumberingFormatEntries = [
   }
 ];
 var approximatedDecimalFormats = [
-  "decimalEnclosedCircle",
-  "decimalEnclosedFullstop",
-  "decimalEnclosedParen",
-  "decimalFullWidth",
   "decimalHalfWidth",
   "aiueo",
   "iroha",
@@ -4135,6 +4427,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);
@@ -4908,6 +5224,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 } : {},
@@ -4920,7 +5237,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) {
@@ -5432,6 +5751,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: {
@@ -5441,7 +5761,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;
 }
@@ -7358,6 +7679,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 } : {},
@@ -7370,7 +7692,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) {
@@ -7592,7 +7916,38 @@ var TextTransactionError = class extends Error {
     this.code = code;
   }
 };
+function isUsableScopeSurface(surface, document) {
+  if (surface.viewportBlockRanges !== null) return false;
+  const root = document.content;
+  if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
+    return false;
+  }
+  return surface.blocks.length === root.children.length;
+}
+function createScopeSurfaceCache(document, selection, precomputedSurface, telemetry) {
+  let cached;
+  if (precomputedSurface && isUsableScopeSurface(precomputedSurface, document)) {
+    cached = precomputedSurface;
+    telemetry?.onPrecomputedSurfaceHit?.();
+  }
+  return {
+    get() {
+      if (cached) return cached;
+      telemetry?.onScopeSurfaceBuild?.();
+      cached = createEditorSurfaceSnapshot(document, selection, void 0, {
+        editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
+      });
+      return cached;
+    }
+  };
+}
 function applyTextTransaction(document, selection, intent, options) {
+  const scopeSurfaceCache = createScopeSurfaceCache(
+    document,
+    selection,
+    options.precomputedSurface,
+    options.surfaceTelemetry
+  );
   if (options.textTarget) {
     if (options.textTarget.kind === "hyperlink-display") {
       const targetedHyperlinkResult = tryApplyHyperlinkDisplayTransaction(
@@ -7628,7 +7983,8 @@ function applyTextTransaction(document, selection, intent, options) {
       document,
       selection,
       intent,
-      options
+      options,
+      scopeSurfaceCache
     );
     if (targetedTableResult) {
       return targetedTableResult;
@@ -7642,7 +7998,8 @@ function applyTextTransaction(document, selection, intent, options) {
     const tableStructureRefusal = resolveTargetlessTableStructureInsertRefusal(
       document,
       selection,
-      intent
+      intent,
+      scopeSurfaceCache
     );
     if (tableStructureRefusal) {
       throw new TextTransactionError("unsupported_content", tableStructureRefusal);
@@ -7652,7 +8009,8 @@ function applyTextTransaction(document, selection, intent, options) {
     document,
     selection,
     intent,
-    options
+    options,
+    scopeSurfaceCache
   );
   if (topLevelParagraphResult) {
     return topLevelParagraphResult;
@@ -7661,7 +8019,8 @@ function applyTextTransaction(document, selection, intent, options) {
     document,
     selection,
     intent,
-    options
+    options,
+    scopeSurfaceCache
   );
   if (sdtScopedResult) {
     return sdtScopedResult;
@@ -7670,7 +8029,8 @@ function applyTextTransaction(document, selection, intent, options) {
     document,
     selection,
     intent,
-    options
+    options,
+    scopeSurfaceCache
   );
   if (tableScopedResult) {
     return tableScopedResult;
@@ -7723,9 +8083,9 @@ function applyLinearTextTransaction(document, selection, intent, options) {
     storyText: createPlainText(nextStory)
   };
 }
-function tryApplyTableParagraphTransaction(document, selection, intent, options) {
+function tryApplyTableParagraphTransaction(document, selection, intent, options, scopeSurfaceCache) {
   const tableTarget = options.textTarget?.kind === "table-paragraph" ? options.textTarget : void 0;
-  const scope = resolveTableParagraphScope(document, selection, tableTarget);
+  const scope = resolveTableParagraphScope(document, selection, tableTarget, scopeSurfaceCache);
   if (!scope) {
     return null;
   }
@@ -7848,7 +8208,11 @@ function tryApplyTargetedTextLeafTransaction(document, selection, intent, option
   };
 }
 function tryApplyHyperlinkDisplayTransaction(document, selection, intent, options) {
-  const scope = resolveTargetedHyperlinkDisplayScope(document, selection, options.textTarget);
+  const scope = resolveTargetedHyperlinkDisplayScope(
+    document,
+    selection,
+    options.textTarget
+  );
   if (!scope) {
     return null;
   }
@@ -7906,8 +8270,8 @@ function tryApplyHyperlinkDisplayTransaction(document, selection, intent, option
     storyText: localResult.storyText
   };
 }
-function tryApplyTopLevelSdtParagraphTransaction(document, selection, intent, options) {
-  const scope = resolveTopLevelSdtParagraphScope(document, selection);
+function tryApplyTopLevelSdtParagraphTransaction(document, selection, intent, options, scopeSurfaceCache) {
+  const scope = resolveTopLevelSdtParagraphScope(document, selection, scopeSurfaceCache);
   if (!scope) {
     return null;
   }
@@ -7959,8 +8323,8 @@ function tryApplyTopLevelSdtParagraphTransaction(document, selection, intent, op
     storyText: localResult.storyText
   };
 }
-function tryApplyTopLevelParagraphTransaction(document, selection, intent, options) {
-  const scope = resolveTopLevelParagraphScope(document, selection);
+function tryApplyTopLevelParagraphTransaction(document, selection, intent, options, scopeSurfaceCache) {
+  const scope = resolveTopLevelParagraphScope(document, selection, scopeSurfaceCache);
   if (!scope) {
     return null;
   }
@@ -8070,17 +8434,15 @@ function resolveTargetedHyperlinkDisplayScope(document, selection, target) {
     replace: resolved.replace
   };
 }
-function resolveTableParagraphScope(document, selection, target) {
+function resolveTableParagraphScope(document, selection, target, scopeSurfaceCache) {
   if (target) {
-    return resolveTargetedTableParagraphScope(document, selection, target);
+    return resolveTargetedTableParagraphScope(document, selection, target, scopeSurfaceCache);
   }
   const root = document.content;
   if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
     return null;
   }
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   const selectionFrom = Math.min(selection.anchor, selection.head);
   const selectionTo = Math.max(selection.anchor, selection.head);
   for (let blockIndex = 0; blockIndex < root.children.length; blockIndex += 1) {
@@ -8185,7 +8547,7 @@ function resolveTableParagraphScope(document, selection, target) {
   }
   return null;
 }
-function resolveTargetlessTableStructureInsertRefusal(document, selection, intent) {
+function resolveTargetlessTableStructureInsertRefusal(document, selection, intent, scopeSurfaceCache) {
   if (!isCollapsedInsertIntent(intent, selection)) {
     return null;
   }
@@ -8193,9 +8555,7 @@ function resolveTargetlessTableStructureInsertRefusal(document, selection, inten
   if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
     return null;
   }
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   if (!selectionTouchesTableStructureBoundary(surface.blocks, selection.anchor)) {
     return null;
   }
@@ -8209,7 +8569,7 @@ function isCollapsedInsertIntent(intent, selection) {
   const rangeTo = intent.range ? Math.max(intent.range.from, intent.range.to) : Math.max(selection.anchor, selection.head);
   return rangeFrom === rangeTo;
 }
-function resolveTargetedTableParagraphScope(document, selection, target) {
+function resolveTargetedTableParagraphScope(document, selection, target, scopeSurfaceCache) {
   const root = document.content;
   if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
     return null;
@@ -8222,7 +8582,8 @@ function resolveTargetedTableParagraphScope(document, selection, target) {
       root,
       document,
       selection,
-      target
+      target,
+      scopeSurfaceCache
     );
     if (targetScope) {
       return targetScope;
@@ -8245,9 +8606,7 @@ function resolveTargetedTableParagraphScope(document, selection, target) {
   if (cell.verticalMerge === "continue") {
     return "unsupported";
   }
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   const surfaceBlock = surface.blocks[target.tableBlockIndex];
   const surfaceRow = surfaceBlock?.kind === "table" ? surfaceBlock.rows[target.rowIndex] : void 0;
   const surfaceCell = surfaceRow?.cells[target.cellIndex];
@@ -8311,16 +8670,14 @@ function resolveTargetedTableParagraphScope(document, selection, target) {
     }
   };
 }
-function resolveTargetedTableParagraphScopeByPath(root, document, selection, target) {
+function resolveTargetedTableParagraphScopeByPath(root, document, selection, target, scopeSurfaceCache) {
   if (!target.blockPath) return null;
   const tokens = parseCanonicalBlockPath(target.blockPath);
   if (!tokens) return null;
   const resolved = resolveBlockPathInCanonicalBlocks(root.children, tokens, 0);
   if (!resolved || resolved.block.type !== "paragraph") return null;
   if (resolved.hasVerticalMergeContinuation) return null;
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   const surfaceResolved = resolveBlockPathInSurfaceBlocks(surface.blocks, tokens, 0);
   if (!surfaceResolved || surfaceResolved.kind !== "paragraph") return null;
   if (surfaceResolved.hasVerticalMergeContinuation) return null;
@@ -8775,14 +9132,12 @@ function resolveBlockPathInSurfaceBlocks(blocks, tokens, tokenIndex, hasVertical
     hasVerticalMergeContinuation || cell.verticalMerge === "continue"
   );
 }
-function resolveTopLevelParagraphScope(document, selection) {
+function resolveTopLevelParagraphScope(document, selection, scopeSurfaceCache) {
   const root = document.content;
   if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
     return null;
   }
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   const selectionFrom = Math.min(selection.anchor, selection.head);
   const selectionTo = Math.max(selection.anchor, selection.head);
   for (let blockIndex = 0; blockIndex < root.children.length; blockIndex += 1) {
@@ -8811,14 +9166,12 @@ function resolveTopLevelParagraphScope(document, selection) {
   }
   return null;
 }
-function resolveTopLevelSdtParagraphScope(document, selection) {
+function resolveTopLevelSdtParagraphScope(document, selection, scopeSurfaceCache) {
   const root = document.content;
   if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
     return null;
   }
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   const selectionFrom = Math.min(selection.anchor, selection.head);
   const selectionTo = Math.max(selection.anchor, selection.head);
   for (let blockIndex = 0; blockIndex < root.children.length; blockIndex += 1) {