@beyondwork/docx-react-component 1.0.124 → 1.0.125

package/dist/{chunk-IR7QV2BX.js → chunk-KV435YXO.js}

@@ -10,7 +10,7 @@ import {
 import {
   NO_EDITABLE_TARGETS_INDEX,
   createEditorSurfaceSnapshot
-} from "./chunk-H6IL5ABU.js";
+} from "./chunk-CXSYRB37.js";
 import {
   createSelectionSnapshot
 } from "./chunk-OYGMRRR7.js";
@@ -803,7 +803,7 @@ function parseCanonicalTextLeafPath(path) {
     if (normalized[offset] !== "/") return null;
     offset += 1;
   }
-  return tokens.some((token) => token.kind === "txbx") ? tokens : null;
+  return tokens.length > 0 ? tokens : null;
 }
 function parseCanonicalHyperlinkPath(path) {
   const blockStart = path.indexOf("/block[");

package/dist/{chunk-N4VIXI2Z.js → chunk-MWSBGJQO.js}

@@ -3,17 +3,17 @@ import {
   PAGE_STACK_GAP_PX,
   defaultChromeReservations,
   resolveDefaultZoom
-} from "./chunk-ZRHLLPSJ.js";
+} from "./chunk-YHZHPXDB.js";
 import {
   storyTargetKey
-} from "./chunk-H6IL5ABU.js";
+} from "./chunk-CXSYRB37.js";
 import {
   MAIN_STORY_KEY,
   collectCanonicalLayoutInputs,
   collectStoryBlockContexts,
   createHeaderFooterStoryKey,
   createNoteStoryKey
-} from "./chunk-FNWKE74J.js";
+} from "./chunk-5DGKFNQT.js";
 import {
   MAIN_STORY_TARGET
 } from "./chunk-M2HUK3KF.js";
@@ -1198,6 +1198,27 @@ function hitTestRegion(index, region, point) {
     (target2) => target2.regionId === region.regionId
   );
   const containing = targets.filter((target2) => containsPoint(target2.rect, point));
+  const generatedTarget = containing.find(
+    (target2) => target2.generatedContentKind === "numbering-marker"
+  );
+  if (generatedTarget) {
+    const anchorHit2 = firstLineAnchor(index, generatedTarget)?.runtimeOffset !== void 0 ? {
+      runtimeOffset: firstLineAnchor(index, generatedTarget).runtimeOffset,
+      assoc: "before"
+    } : resolveLineAnchorHit(index, generatedTarget, point);
+    return {
+      pageIndex: generatedTarget.pageIndex,
+      regionKind: generatedTarget.regionKind,
+      blockId: generatedTarget.blockId,
+      fragmentId: generatedTarget.fragmentId,
+      lineIndex: generatedTarget.lineIndex,
+      runtimeOffset: anchorHit2?.runtimeOffset ?? 0,
+      assoc: "before",
+      generatedContentKind: generatedTarget.generatedContentKind,
+      generatedContentBoundary: generatedTarget.generatedContentBoundary?.policy,
+      semanticEntryId: generatedTarget.targetId.startsWith("hit:") ? generatedTarget.targetId.slice("hit:".length) : generatedTarget.targetId
+    };
+  }
   const target = nearestTarget(containing, point) ?? nearestTarget(targets, point);
   if (!target) return null;
   const anchorHit = resolveLineAnchorHit(index, target, point);
@@ -1574,6 +1595,7 @@ function projectGeometryIndexFromFrame(frame, options) {
           identities,
           storyKey: storyKey2,
           entries: semanticEntries,
+          hitTargets,
           projectedBlocksByStory,
           projectedCommandTargetsByKey,
           precision,
@@ -1844,6 +1866,7 @@ function appendBlockSemanticEntries(input) {
     identities,
     storyKey: storyKey2,
     entries,
+    hitTargets,
     projectedBlocksByStory,
     projectedCommandTargetsByKey,
     precision,
@@ -1873,6 +1896,7 @@ function appendBlockSemanticEntries(input) {
     block,
     sourceIdentity: sliceIdentity,
     entries,
+    hitTargets,
     projectedCommandTargetsByKey,
     precision,
     frameCompleteness,
@@ -2054,6 +2078,7 @@ function appendFragmentLayoutObjectSemanticEntries(input) {
     block,
     sourceIdentity,
     entries,
+    hitTargets,
     projectedCommandTargetsByKey,
     precision,
     frameCompleteness,
@@ -2138,18 +2163,57 @@ function appendFragmentLayoutObjectSemanticEntries(input) {
     }
     return;
   }
-  if (layoutObject.kind === "numbered-paragraph") {
-    const markerProjection = resolveNumberingMarkerProjection(block);
+  const numberingRows = layoutObject.numberingRows && layoutObject.numberingRows.length > 0 ? layoutObject.numberingRows : layoutObject.kind === "numbered-paragraph" && layoutObject.numbering ? [layoutObject.numbering] : [];
+  for (let index = 0; index < numberingRows.length; index += 1) {
+    const numbering = numberingRows[index];
+    const markerProjection = resolveNumberingMarkerProjection(block, numbering);
+    const entryId = layoutObject.kind === "numbered-paragraph" && index === 0 ? `semantic:numbering-marker:${base.sliceId}` : `semantic:numbering-marker:${base.sliceId}:${stableGeometryId(
+      numbering.numberingLayoutId ?? numbering.numberingKey ?? String(index)
+    )}`;
+    const source = numberingSourceIdentity(numbering, sourceIdentity);
     entries.push({
       ...base,
-      entryId: `semantic:numbering-marker:${base.sliceId}`,
+      entryId,
       kind: "numbering-marker",
       layoutObjectId: layoutObject.objectId,
+      numberingLayoutId: numbering.numberingLayoutId,
+      numberingKey: numbering.numberingKey,
+      numberingTargetKey: numbering.targetKey,
+      numberingTargetKind: numbering.targetKind,
+      numberingCanonicalAddressKey: numbering.canonicalAddressKey,
+      numberingListAddressKey: numbering.listAddressKey,
+      numberingMarkerText: numbering.markerText,
+      numberingMarkerSuffix: numbering.markerSuffix,
+      numberingFormat: numbering.format,
+      numberingFormatPosture: numbering.formatPosture,
+      numberingUnavailableReasons: numbering.unavailableReasons,
+      markerGlyphRect: markerProjection.rect,
+      markerLaneRect: markerProjection.markerLaneRect,
+      textColumnRect: markerProjection.textColumnRect,
+      markerBoundary: markerProjection.markerBoundary,
       rect: markerProjection.rect,
       status: markerProjection.status,
       precision: markerProjection.precision,
       frameCompleteness,
-      ...sourceIdentity ? { sourceIdentity } : {}
+      ...source ? { sourceIdentity: source } : {}
+    });
+    hitTargets.push({
+      targetId: `hit:${entryId}`,
+      pageId: base.pageId,
+      pageIndex: base.pageIndex,
+      regionId: base.regionId,
+      regionKind: base.regionKind,
+      blockId: base.blockId,
+      fragmentId: base.fragmentId,
+      lineIndex: firstLineIndex(block),
+      rect: markerProjection.rect,
+      precision: markerProjection.precision,
+      generatedContentKind: "numbering-marker",
+      generatedContentBoundary: {
+        policy: "snap-to-authored-text",
+        authoredTextStartsAtPx: markerProjection.markerBoundary.authoredTextStartsAtPx,
+        selectionPolicy: "exclude-generated-marker"
+      }
     });
     recordPrecision(precision, markerProjection.precision);
   }
@@ -2240,8 +2304,8 @@ function bookmarkRangeSourceIdentity(fact, fallback) {
     joinKind: "block-scoped"
   };
 }
-function resolveNumberingMarkerProjection(block) {
-  const metadata = resolveNumberingMarkerProjectionMetadata(block);
+function resolveNumberingMarkerProjection(block, numbering) {
+  const metadata = resolveNumberingMarkerProjectionMetadata(block, numbering);
   const blockFrame = block.frame;
   if (metadata.markerLane && metadata.measuredWidthTwips !== void 0) {
     const markerLane = metadata.markerLane;
@@ -2252,14 +2316,25 @@ function resolveNumberingMarkerProjection(block) {
     const rawRightPx = rawLeftPx + markerLane.widthTwips * pxPerTwip;
     const leftPx = clamp(rawLeftPx, blockLeftPx, blockRightPx);
     const rightPx = clamp(rawRightPx, leftPx, blockRightPx);
+    const markerLaneRect = {
+      leftPx,
+      topPx: blockFrame.topPx,
+      widthPx: rightPx - leftPx,
+      heightPx: blockFrame.heightPx,
+      space: "frame",
+      precision: metadata.precision
+    };
+    const textColumnRect = metadata.textColumn ? projectTextColumnRect(blockFrame, metadata.measuredWidthTwips, metadata.textColumn) : void 0;
     return {
-      rect: {
-        leftPx,
-        topPx: blockFrame.topPx,
-        widthPx: rightPx - leftPx,
-        heightPx: blockFrame.heightPx,
-        space: "frame",
-        precision: metadata.precision
+      rect: markerLaneRect,
+      markerLaneRect,
+      ...textColumnRect ? { textColumnRect } : {},
+      markerBoundary: {
+        generatedContent: "numbering-marker",
+        caretPolicy: "snap-to-authored-text",
+        selectionPolicy: "exclude-marker-unless-list-item-action",
+        coordinateSpace: "frame-px",
+        ...textColumnRect ? { authoredTextStartsAtPx: textColumnRect.leftPx } : {}
       },
       precision: metadata.precision,
       status: metadata.status
@@ -2278,20 +2353,28 @@ function resolveNumberingMarkerProjection(block) {
       space: "frame",
       precision: metadata.precision
     },
+    markerBoundary: {
+      generatedContent: "numbering-marker",
+      caretPolicy: "snap-to-authored-text",
+      selectionPolicy: "exclude-marker-unless-list-item-action",
+      coordinateSpace: "frame-px"
+    },
     precision: metadata.precision,
     status: metadata.status
   };
 }
-function resolveNumberingMarkerProjectionMetadata(block) {
+function resolveNumberingMarkerProjectionMetadata(block, numbering) {
   const blockFrame = block.frame;
   const layoutObject = block.fragment.layoutObject;
-  const markerLane = layoutObject?.kind === "numbered-paragraph" ? layoutObject.numbering?.markerLane : void 0;
+  const markerLane = numbering?.markerLane ?? (layoutObject?.kind === "numbered-paragraph" ? layoutObject.numbering?.markerLane : void 0);
+  const textColumn = numbering?.textColumn ?? (layoutObject?.kind === "numbered-paragraph" ? layoutObject.numbering?.textColumn : void 0);
   const measuredWidthTwips = layoutObject?.measuredExtentTwips.widthTwips;
   if (markerLane && markerLane.widthTwips > 0 && measuredWidthTwips !== void 0 && measuredWidthTwips > 0 && Number.isFinite(blockFrame.widthPx)) {
     return {
       precision: "within-tolerance",
       status: "realized",
       markerLane,
+      ...textColumn ? { textColumn } : {},
       measuredWidthTwips
     };
   }
@@ -2300,6 +2383,42 @@ function resolveNumberingMarkerProjectionMetadata(block) {
     status: "requires-rehydration"
   };
 }
+function projectTextColumnRect(blockFrame, measuredWidthTwips, textColumn) {
+  if (measuredWidthTwips <= 0 || !Number.isFinite(blockFrame.widthPx)) {
+    return void 0;
+  }
+  const pxPerTwip = blockFrame.widthPx / measuredWidthTwips;
+  const leftPx = blockFrame.leftPx + textColumn.startTwips * pxPerTwip;
+  const rightInsetPx = (textColumn.rightTwips ?? 0) * pxPerTwip;
+  const rightPx = blockFrame.leftPx + blockFrame.widthPx - rightInsetPx;
+  if (rightPx < leftPx) return void 0;
+  return {
+    leftPx,
+    topPx: blockFrame.topPx,
+    widthPx: rightPx - leftPx,
+    heightPx: blockFrame.heightPx,
+    space: "frame",
+    precision: "within-tolerance"
+  };
+}
+function numberingSourceIdentity(numbering, fallback) {
+  const storyKey2 = numbering.storyKey ?? fallback?.storyKey;
+  if (!storyKey2) return fallback;
+  return {
+    storyKey: storyKey2,
+    ...numbering.sourceBlockPath ?? fallback?.blockPath ? { blockPath: numbering.sourceBlockPath ?? fallback?.blockPath } : {},
+    ...numbering.numberingKey ?? fallback?.scopeKey ? { scopeKey: numbering.numberingKey ?? fallback?.scopeKey } : {},
+    ...numbering.numberingInstanceId ?? fallback?.scopeId ? { scopeId: numbering.numberingInstanceId ?? fallback?.scopeId } : {},
+    ...numbering.numberingSourceRef ?? numbering.sourceRef ?? fallback?.sourceRef ? { sourceRef: numbering.numberingSourceRef ?? numbering.sourceRef ?? fallback?.sourceRef } : {},
+    joinKind: "block-scoped"
+  };
+}
+function stableGeometryId(value) {
+  return value.replace(/[^A-Za-z0-9_.:-]+/gu, "_");
+}
+function firstLineIndex(block) {
+  return block.lines[0]?.line.lineIndex ?? 0;
+}
 function countBlockSemanticEntries(block) {
   const counts = createPrecisionCounts();
   const layoutObject = block.fragment.layoutObject;

package/dist/{chunk-Q76XPPTA.js → chunk-OHTK7F3F.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";
@@ -8061,19 +8132,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 +8160,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;