@beyondwork/docx-react-component 1.0.124 → 1.0.126

package/dist/{chunk-KOHQFZMM.js → chunk-BYSRJ4FE.js}

@@ -1,7 +1,7 @@
 import {
   NO_EDITABLE_TARGETS_INDEX,
   createEditorSurfaceSnapshot
-} from "./chunk-H6IL5ABU.js";
+} from "./chunk-CXSYRB37.js";
 import {
   createSelectionSnapshot
 } from "./chunk-OYGMRRR7.js";

package/dist/{chunk-H6IL5ABU.js → chunk-CXSYRB37.js}

@@ -4,7 +4,7 @@ import {
   MAIN_STORY_KEY,
   collectCanonicalFieldRegionIdentities,
   collectEditableTargetRefs
-} from "./chunk-FNWKE74J.js";
+} from "./chunk-5DGKFNQT.js";
 import {
   describeOpaqueFragment,
   describeStructuredWrapperBlock,
@@ -1100,6 +1100,7 @@ function mergeLevelDefinition(base, override, startOverride, fallbackLevel) {
   );
   const runProperties = override?.runProperties ?? base?.runProperties;
   const restartAfterLevel = override?.restartAfterLevel ?? base?.restartAfterLevel;
+  const picBulletId = override?.picBulletId ?? base?.picBulletId;
   return {
     level,
     format,
@@ -1110,7 +1111,8 @@ function mergeLevelDefinition(base, override, startOverride, fallbackLevel) {
     ...override?.suffix ?? base?.suffix ? { suffix: override?.suffix ?? base?.suffix } : {},
     ...paragraphGeometry ? { paragraphGeometry } : {},
     ...runProperties ? { runProperties } : {},
-    ...restartAfterLevel !== void 0 ? { restartAfterLevel } : {}
+    ...restartAfterLevel !== void 0 ? { restartAfterLevel } : {},
+    ...picBulletId !== void 0 ? { picBulletId } : {}
   };
 }
 function withDefaultStartAt(level) {
@@ -1238,7 +1240,7 @@ function resolveHangingWidth(indentation) {
 // src/runtime/formatting/numbering/prefix.ts
 function createNumberingPrefixResolver(catalog) {
   const sequenceStates = /* @__PURE__ */ new Map();
-  function resolveInternal(numbering, paragraph) {
+  function resolveInternal(numbering, paragraph, options = {}) {
     const resolved = resolveNumberingDefinitionSet(
       catalog,
       paragraph?.numbering ?? numbering,
@@ -1251,29 +1253,44 @@ function createNumberingPrefixResolver(catalog) {
     if (!resolvedNumbering) {
       return null;
     }
-    const sequenceState = getSequenceState(sequenceStates, resolvedNumbering.numberingInstanceId);
-    advanceSequence(sequenceState, resolved.effectiveLevel.level, resolved.effectiveLevels);
+    const advance = options.advance !== false;
+    const sequenceState = getSequenceState(
+      sequenceStates,
+      resolvedNumbering.numberingInstanceId,
+      { create: advance }
+    );
+    if (!sequenceState) {
+      return null;
+    }
+    const workingState = advance ? sequenceState : cloneSequenceState(sequenceState);
+    advanceSequence(workingState, resolved.effectiveLevel.level, resolved.effectiveLevels);
+    const currentCounter = workingState.counters[resolved.effectiveLevel.level];
     const effectiveLevelDefs = resolved.effectiveLevel.isLegalNumbering ? new Map(
       Array.from(resolved.effectiveLevels.entries()).map(([level, definition]) => [
         level,
         { ...definition, format: "decimal" }
       ])
     ) : resolved.effectiveLevels;
+    const picBulletId = resolved.effectiveLevel.picBulletId;
     const text = renderLevelText(
       resolved.effectiveLevel.text,
-      sequenceState.counters,
+      workingState.counters,
       effectiveLevelDefs
     );
-    if (resolved.effectiveLevel.format !== "none" && text === null) {
+    if (picBulletId == null && resolved.effectiveLevel.format !== "none" && text === null) {
       return null;
     }
     const visibleText = resolved.effectiveLevel.format === "none" ? null : text;
-    const picBulletId = resolved.effectiveLevel.picBulletId;
+    const formatPosture = getNumberingFormatPosture(
+      resolved.effectiveLevel.format,
+      currentCounter
+    );
     const picBulletMediaId = picBulletId != null ? catalog.numPicBullets?.[picBulletId]?.mediaId : void 0;
     return {
       text: visibleText,
       level: resolved.effectiveLevel.level,
       format: resolved.effectiveLevel.format,
+      ...formatPosture !== void 0 ? { formatPosture } : {},
       startAt: resolved.effectiveLevel.startAt ?? DEFAULT_NUMBERING_START_AT,
       ...resolved.effectiveLevel.suffix ? { suffix: resolved.effectiveLevel.suffix } : {},
       ...resolved.effectiveLevel.paragraphStyleId ? { paragraphStyleId: resolved.effectiveLevel.paragraphStyleId } : {},
@@ -1284,23 +1301,26 @@ function createNumberingPrefixResolver(catalog) {
     };
   }
   return {
-    resolve(numbering) {
-      const result = resolveInternal(numbering);
+    resolve(numbering, options) {
+      const result = resolveInternal(numbering, void 0, options);
       return result?.text ?? null;
     },
-    resolveDetailed(numbering, paragraph) {
-      return resolveInternal(numbering, paragraph);
+    resolveDetailed(numbering, paragraph, options) {
+      return resolveInternal(numbering, paragraph, options);
     },
-    resolveParagraph(paragraph) {
-      return resolveInternal(paragraph.numbering, paragraph);
+    resolveParagraph(paragraph, options) {
+      return resolveInternal(paragraph.numbering, paragraph, options);
     }
   };
 }
-function getSequenceState(states, numberingInstanceId) {
+function getSequenceState(states, numberingInstanceId, options = { create: true }) {
   const existing = states.get(numberingInstanceId);
   if (existing) {
     return existing;
   }
+  if (options.create === false) {
+    return { counters: [], lastLevel: null };
+  }
   const created = {
     counters: [],
     lastLevel: null
@@ -1308,6 +1328,12 @@ function getSequenceState(states, numberingInstanceId) {
   states.set(numberingInstanceId, created);
   return created;
 }
+function cloneSequenceState(state) {
+  return {
+    counters: [...state.counters],
+    lastLevel: state.lastLevel
+  };
+}
 function advanceSequence(state, currentLevel, levelDefinitions) {
   for (let level = currentLevel + 1; level < state.counters.length; level += 1) {
     if (shouldResetDeeperLevel(level, currentLevel, levelDefinitions)) {
@@ -1339,6 +1365,25 @@ function shouldResetDeeperLevel(level, triggeringLevel, levelDefinitions) {
 function getLevelStartAt(level, levelDefinitions) {
   return levelDefinitions.get(level)?.startAt ?? DEFAULT_NUMBERING_START_AT;
 }
+function getNumberingFormatPosture(format, value) {
+  if (!isSupportedNumberingFormat(format)) {
+    return {
+      status: "approximated",
+      requestedFormat: format,
+      renderedFormat: "decimal",
+      reason: "unsupported-numbering-format-decimal-fallback"
+    };
+  }
+  if (value !== void 0 && ((format === "upperRoman" || format === "lowerRoman") && (value <= 0 || value >= 4e3) || (format === "cardinalText" || format === "ordinalText") && (!Number.isInteger(value) || value < 1 || value > 999) || (format === "upperLetter" || format === "lowerLetter" || format === "chicago") && value < 1)) {
+    return {
+      status: "approximated",
+      requestedFormat: format,
+      renderedFormat: "decimal",
+      reason: "numbering-format-range-decimal-fallback"
+    };
+  }
+  return void 0;
+}
 function renderLevelText(text, counters, levelDefinitions) {
   if (!text) {
     return null;
@@ -2181,6 +2226,7 @@ function toNumberingLayoutInput(numbering) {
     associatedTabStops: toLayoutTabStops(numbering.geometry.tabStops, "numbering"),
     level: numbering.level,
     format: numbering.format,
+    ...numbering.formatPosture !== void 0 ? { formatPosture: { ...numbering.formatPosture } } : {},
     startAt: numbering.startAt,
     ...numbering.isLegalNumbering ? { isLegalNumbering: true } : {},
     ...numbering.picBulletMediaId ? { pictureBulletMediaId: numbering.picBulletMediaId } : {}
@@ -2410,13 +2456,10 @@ var FormattingContextImpl = class {
     const effectiveNumbering = this.resolveEffectiveParagraphNumbering(para);
     if (!effectiveNumbering) return null;
     if (!emitGeometry) {
-      if (advance) this.numbering.resolve(effectiveNumbering);
+      this.numbering.resolve(effectiveNumbering, { advance });
       return null;
     }
-    if (!advance) {
-      console.warn("[formatting-context] resolveParagraphNumbering({advance:false}) is not supported; counter always advances");
-    }
-    return this.numbering.resolveDetailed(effectiveNumbering, para);
+    return this.numbering.resolveDetailed(effectiveNumbering, para, { advance });
   }
   resolveNumberingLayoutInput(para, options = {}) {
     return toNumberingLayoutInput(this.resolveParagraphNumbering(para, options));
@@ -4692,6 +4735,7 @@ function toSurfaceResolvedNumbering(numbering) {
   return {
     level: numbering.level,
     format: numbering.format,
+    ...numbering.formatPosture !== void 0 ? { formatPosture: { ...numbering.formatPosture } } : {},
     ...numbering.text !== null ? { text: numbering.text } : {},
     startAt: numbering.startAt,
     ...numbering.paragraphStyleId ? { paragraphStyleId: numbering.paragraphStyleId } : {},

package/dist/{chunk-32ZAOQ54.js → chunk-D5HYZQTG.js}

@@ -8,7 +8,7 @@ import {
   getRevisionRangeState,
   selectionTouchesRange,
   shouldHideInCleanMode
-} from "./chunk-PFYUJU3Q.js";
+} from "./chunk-2QL5DAKF.js";
 
 // src/ui-tailwind/editor-surface/tw-editor-surface.tsx
 import { useMemo } from "react";

package/dist/{chunk-TY4DIJO3.js → chunk-ESJ2MES5.js}

@@ -1,6 +1,6 @@
 import {
   classifyFieldInstruction
-} from "./chunk-A74Y5NE4.js";
+} from "./chunk-4YJVRIUB.js";
 import {
   describeOpaqueFragment,
   describeStructuredWrapperBlock,

package/dist/{chunk-Q76XPPTA.js → chunk-FPRWV54X.js}

@@ -7,27 +7,27 @@ import {
   resolveSectionForStoryTarget,
   searchSecondaryStories,
   searchSurfaceBlocks
-} from "./chunk-ZRHLLPSJ.js";
+} from "./chunk-YHZHPXDB.js";
 import {
   createEditorSurfaceSnapshot,
   createFormattingContext,
   resolveTableStyleResolution
-} from "./chunk-H6IL5ABU.js";
+} from "./chunk-CXSYRB37.js";
 import {
   createSelectionSnapshot
 } from "./chunk-OYGMRRR7.js";
 import {
   normalizeParsedTextDocument
-} from "./chunk-TY4DIJO3.js";
+} from "./chunk-ESJ2MES5.js";
 import {
   buildFieldRegistry,
   parseMainDocumentXml,
   parseTocLevelRange
-} from "./chunk-A74Y5NE4.js";
+} from "./chunk-4YJVRIUB.js";
 import {
   collectEditableTargetRefs,
   validateEditableTargetRef
-} from "./chunk-FNWKE74J.js";
+} from "./chunk-5DGKFNQT.js";
 import {
   serializeMainDocument
 } from "./chunk-EB6M3GE6.js";
@@ -530,6 +530,24 @@ function refusalIdForPostureBlocker(target, blocker) {
       return "editable_target_opaque_content";
     case "synthetic-layout-cell":
       return "editable_target_synthetic_layout_cell";
+    case "list-text-readback-missing":
+      return "list_text_readback_missing";
+    case "list-structure-command-missing":
+      return "list_structure_command_missing";
+    case "list-target-stale":
+      return "list_target_stale";
+    case "list-secondary-story-unsupported":
+      return "list_secondary_story_unsupported";
+    case "list-table-target-missing":
+      return "list_table_target_missing";
+    case "list-export-persistence-missing":
+      return "list_export_persistence_missing";
+    case "numbering-format-unsupported":
+      return "numbering_format_unsupported";
+    case "picture-bullet-preserve-only":
+      return "picture_bullet_preserve_only";
+    case "marker-geometry-unavailable":
+      return "marker_geometry_unavailable";
     case "unmodeled-target":
       return target.commandFamily === "link-bookmark" ? "editable_target_linked_content_unmodeled" : "editable_target_unmodeled";
   }
@@ -552,12 +570,42 @@ function auditCategoryForPostureBlocker(target, blocker) {
       return target.commandFamily === "link-bookmark" ? "linked-content" : "unsupported-command";
     case "synthetic-layout-cell":
       return "synthetic-cell";
+    case "list-target-stale":
+      return "stale-ref";
+    case "picture-bullet-preserve-only":
+    case "list-export-persistence-missing":
+      return "preserve-only";
+    case "list-text-readback-missing":
+    case "list-structure-command-missing":
+    case "list-secondary-story-unsupported":
+    case "list-table-target-missing":
+    case "numbering-format-unsupported":
+    case "marker-geometry-unavailable":
+      return "unsupported-command";
   }
 }
 function messageForPostureBlocker(blocker) {
   switch (blocker) {
     case "synthetic-layout-cell":
       return "Hidden vertical-merge continuation or synthetic layout cells are not editable targets.";
+    case "list-text-readback-missing":
+      return "List text edits need an authoritative list-item text target before mutation.";
+    case "list-structure-command-missing":
+      return "List structure changes need a supported list command envelope before mutation.";
+    case "list-target-stale":
+      return "List target identity is stale for the current canonical document.";
+    case "list-secondary-story-unsupported":
+      return "List edits in this secondary story are not yet supported.";
+    case "list-table-target-missing":
+      return "Table-contained list item is missing a command-safe list target.";
+    case "list-export-persistence-missing":
+      return "List mutation is blocked until export/reopen persistence is available.";
+    case "numbering-format-unsupported":
+      return "Numbering format is unsupported for this list command.";
+    case "picture-bullet-preserve-only":
+      return "Picture bullet lists are preserve-only until picture bullet mutation is supported.";
+    case "marker-geometry-unavailable":
+      return "List marker geometry is unavailable for this target.";
     default:
       return void 0;
   }
@@ -1841,6 +1889,21 @@ function compileParagraphScope(entry, options = {}) {
     partial: true
   };
 }
+function storyKeyFromHandle(handle) {
+  const target = handle.storyTarget;
+  if (target.kind === "main") return "main";
+  return null;
+}
+function textLeafEditableTargetHint(entry, semanticBlockRange) {
+  const storyKey = storyKeyFromHandle(entry.handle);
+  if (!storyKey) return void 0;
+  return {
+    kind: "text-leaf",
+    storyKey,
+    blockPath: `${storyKey}/block[${entry.blockIndex}]`,
+    semanticBlockRange
+  };
+}
 function compileParagraphReplacement(entry, proposed, options) {
   if (proposed.operation !== "replace" && proposed.operation !== "insert-before" && proposed.operation !== "insert-after") {
     return null;
@@ -1896,6 +1959,7 @@ function compileParagraphReplacement(entry, proposed, options) {
         {
           kind: stepKind,
           summary: stepKind === "text-replace" ? actionSummary : `suggest-mode ${actionSummary}`,
+          ...textLeafEditableTargetHint(entry, blockRange) ? { editableTargetHint: textLeafEditableTargetHint(entry, blockRange) } : {},
           range: { from: operationRange.from, to: operationRange.to },
           text,
           ...proposed.formatting ? { formatting: proposed.formatting } : {}
@@ -1923,6 +1987,7 @@ function compileParagraphReplacement(entry, proposed, options) {
         {
           kind: "fragment-replace",
           summary: actionSummary,
+          ...textLeafEditableTargetHint(entry, blockRange) ? { editableTargetHint: textLeafEditableTargetHint(entry, blockRange) } : {},
           range: { from: operationRange.from, to: operationRange.to },
           fragment
         }
@@ -3845,14 +3910,17 @@ function paragraphHasBookmarkId(paragraph, bookmarkId) {
 function commandActionHandleForAddress(commandFamily, address) {
   return address ? `scope-command:${commandFamily}:${address.addressKey}` : void 0;
 }
-function withCommandAction(evidence, target) {
-  if (evidence.status !== "supported" || !target.canonicalAddress) return evidence;
+function withCommandAction(evidence, target, canonicalAddress = target.canonicalAddress) {
+  if (evidence.status !== "supported" || !canonicalAddress) return evidence;
   return {
     ...evidence,
-    actionHandle: commandActionHandleForAddress(target.commandFamily, target.canonicalAddress),
-    canonicalAddress: target.canonicalAddress
+    actionHandle: commandActionHandleForAddress(target.commandFamily, canonicalAddress),
+    canonicalAddress
   };
 }
+function commandAddressForTarget(target, scopeKind) {
+  return scopeKind === "list-item" && target.listAddress !== void 0 ? target.listAddress : target.canonicalAddress;
+}
 function runtimeTextCommandEvidence(target, workflowBlockers) {
   const shapeIssues = validateEditableTargetRef(target);
   if (shapeIssues.length > 0) {
@@ -3905,6 +3973,9 @@ var TABLE_TEXT_TARGET_KINDS2 = /* @__PURE__ */ new Set([
 var LIST_TEXT_TARGET_KINDS2 = /* @__PURE__ */ new Set([
   "paragraph-text",
   "sdt-paragraph-text",
+  "table-cell-paragraph-text",
+  "nested-table-cell-paragraph-text",
+  "sdt-table-cell-paragraph-text",
   "secondary-story-paragraph-text"
 ]);
 function tableTextScopeReplacementPosture(target) {
@@ -3955,7 +4026,7 @@ function runtimeCommandEvidence(target, workflowBlockers, textCommand, scopeKind
       intents: commandIntentsForTarget(target, scopeKind),
       reason: textCommand.reason,
       ...textCommand.blockers ? { blockers: textCommand.blockers } : {}
-    }, target);
+    }, target, commandAddressForTarget(target, scopeKind));
   }
   if (target.commandFamily === "comment-revision") {
     const isOpen = target.review?.status === "open";
@@ -8023,7 +8094,8 @@ function rejectCommand(code, message) {
   };
 }
 function sameResolvedTarget2(left, right) {
-  return left.kind === right.kind && left.storyKey === right.storyKey && left.blockPath === right.blockPath && left.leafPath === right.leafPath && left.commandFamily === right.commandFamily && left.editability === right.editability && sameTextTargetStaleCheck(left, right) && left.staleCheck.inlineCount === right.staleCheck.inlineCount && left.staleCheck.targetHash === right.staleCheck.targetHash && left.staleCheck.targetTextLength === right.staleCheck.targetTextLength && left.staleCheck.childCount === right.staleCheck.childCount && left.staleCheck.blockType === right.staleCheck.blockType && left.staleCheck.wordParaId === right.staleCheck.wordParaId && left.staleCheck.wordTextId === right.staleCheck.wordTextId && jsonStable(left.staleCheck.sourceRef) === jsonStable(right.staleCheck.sourceRef) && jsonStable(left.sourceRef) === jsonStable(right.sourceRef) && jsonStable(left.table) === jsonStable(right.table) && jsonStable(left.editableOwner) === jsonStable(right.editableOwner);
+  const textTargetLengthDrift = hasTextTargetLengthDrift(left, right);
+  return left.kind === right.kind && left.storyKey === right.storyKey && left.blockPath === right.blockPath && left.leafPath === right.leafPath && left.commandFamily === right.commandFamily && left.editability === right.editability && sameTextTargetStaleCheck(left, right) && left.staleCheck.inlineCount === right.staleCheck.inlineCount && left.staleCheck.targetHash === right.staleCheck.targetHash && left.staleCheck.targetTextLength === right.staleCheck.targetTextLength && left.staleCheck.childCount === right.staleCheck.childCount && left.staleCheck.blockType === right.staleCheck.blockType && left.staleCheck.wordParaId === right.staleCheck.wordParaId && left.staleCheck.wordTextId === right.staleCheck.wordTextId && (textTargetLengthDrift || jsonStable(left.staleCheck.sourceRef) === jsonStable(right.staleCheck.sourceRef)) && (textTargetLengthDrift || jsonStable(left.sourceRef) === jsonStable(right.sourceRef)) && jsonStable(left.table) === jsonStable(right.table) && jsonStable(left.editableOwner) === jsonStable(right.editableOwner);
 }
 function sameTextTargetStaleCheck(left, right) {
   if (left.staleCheck.paragraphTextHash === right.staleCheck.paragraphTextHash && left.staleCheck.paragraphTextLength === right.staleCheck.paragraphTextLength) {
@@ -8031,6 +8103,9 @@ function sameTextTargetStaleCheck(left, right) {
   }
   return left.commandFamily === "text-leaf" && left.staleCheck.paragraphTextLength !== void 0 && right.staleCheck.paragraphTextLength !== void 0 && left.staleCheck.paragraphTextLength !== right.staleCheck.paragraphTextLength;
 }
+function hasTextTargetLengthDrift(left, right) {
+  return left.commandFamily === "text-leaf" && left.staleCheck.paragraphTextLength !== void 0 && right.staleCheck.paragraphTextLength !== void 0 && left.staleCheck.paragraphTextLength !== right.staleCheck.paragraphTextLength;
+}
 function locateTargetRange(document, surface, target) {
   if (target.kind === "hyperlink-text") {
     return locateHyperlinkDisplayRange(document, surface, target);
@@ -8061,19 +8136,19 @@ function locateTargetRange(document, surface, target) {
     if (!sdt || sdt.kind !== "sdt_block") return null;
     const paragraph = sdt.children[sdtPath.childIndex];
     if (!paragraph || paragraph.kind !== "paragraph") return null;
-    return { from: paragraph.from, to: paragraph.to };
+    return textLeafTargetRange(target, paragraph.from, paragraph.to);
   }
   const paragraphPath = parseTopLevelParagraphPath(target.blockPath);
   if (paragraphPath) {
     const paragraph = surface[paragraphPath.blockIndex];
     if (!paragraph || paragraph.kind !== "paragraph") return null;
-    return { from: paragraph.from, to: paragraph.to };
+    return textLeafTargetRange(target, paragraph.from, paragraph.to);
   }
   const secondaryParagraphPath = parseSecondaryStoryParagraphPath(target.blockPath);
   if (secondaryParagraphPath) {
     const paragraph = surface[secondaryParagraphPath.blockIndex];
     if (!paragraph || paragraph.kind !== "paragraph") return null;
-    return { from: paragraph.from, to: paragraph.to };
+    return textLeafTargetRange(target, paragraph.from, paragraph.to);
   }
   if (target.kind === "textbox-paragraph-text") {
     return {
@@ -8089,6 +8164,18 @@ function locateTargetRange(document, surface, target) {
   }
   return null;
 }
+function textLeafTargetRange(target, from, to) {
+  return {
+    from,
+    to,
+    textTarget: {
+      kind: "text-leaf",
+      blockPath: target.blockPath,
+      paragraphStart: from,
+      paragraphEnd: to
+    }
+  };
+}
 function locateHyperlinkDisplayRange(document, surface, target) {
   const canonical = resolveHyperlinkDisplayPath(document, target.blockPath);
   if (!canonical) return null;