@beyondwork/docx-react-component 1.0.123 → 1.0.125

package/dist/api/v3.cjs

@@ -13436,7 +13436,7 @@ function createParagraphEditableTarget(paragraph, kind, storyKey, blockPath, tar
     context: { storyKey, insideSdt: contentControl !== void 0 },
     ...tableTarget
   }) : void 0;
-  const listAddress = tableIdentity === void 0 && paragraph.numbering !== void 0 ? createCanonicalAddress({
+  const listAddress = paragraph.numbering !== void 0 ? createCanonicalAddress({
     addressKind: "list-item-text",
     storyKey,
     staleCheckKind: "paragraph",
@@ -13470,6 +13470,7 @@ function createParagraphEditableTarget(paragraph, kind, storyKey, blockPath, tar
     ...contentControl !== void 0 ? { contentControl } : {},
     ...tableIdentity !== void 0 ? { table: tableIdentity } : {},
     ...editableOwner !== void 0 ? { editableOwner } : {},
+    ...listAddress !== void 0 ? { listAddress } : {},
     ...tableIdentity !== void 0 ? {
       canonicalAddress: createTableTargetCanonicalAddress(
         tableIdentity,
@@ -14333,6 +14334,9 @@ function validateEditableTargetRef(value, path = "$") {
   if (record.canonicalAddress !== void 0) {
     validateTargetCanonicalAddress(record.canonicalAddress, `${path}.canonicalAddress`, issues);
   }
+  if (record.listAddress !== void 0) {
+    validateTargetCanonicalAddress(record.listAddress, `${path}.listAddress`, issues);
+  }
   const staleCheck = asPlainObject(record.staleCheck, `${path}.staleCheck`, issues);
   if (staleCheck) {
     if (staleCheck.paragraphTextHash !== void 0) {
@@ -18405,6 +18409,8 @@ function resolveContentType(path, contentTypes) {
 // src/io/ooxml/parse-bookmark-references.ts
 var HYPERLINK_ANCHOR_RE = /<(?:\w+:)?hyperlink\b[^>]*\bw:anchor\s*=\s*"([^"]*)"/gi;
 var INSTR_TEXT_RE = /<(?:\w+:)?instrText\b[^>]*>([\s\S]*?)<\/(?:\w+:)?instrText>/gi;
+var FLD_SIMPLE_INSTR_DOUBLE_RE = /<(?:\w+:)?fldSimple\b[^>]*?\b(?:w:)?instr\s*=\s*"([^"]*)"/gi;
+var FLD_SIMPLE_INSTR_SINGLE_RE = /<(?:\w+:)?fldSimple\b[^>]*?\b(?:w:)?instr\s*=\s*'([^']*)'/gi;
 var TOC_FIELD_RE = /\bTOC\b/;
 var REFLIKE_FIELD_RE = /\b(?:HYPERLINK|REF|PAGEREF|NOTEREF)\s+([A-Za-z0-9_:.\-]+)/g;
 var DATA_BINDING_RE = /<(?:\w+:)?dataBinding\b/i;
@@ -18424,12 +18430,21 @@ function scanBookmarkReferences(documentXml, callerAllowlist = []) {
   INSTR_TEXT_RE.lastIndex = 0;
   while ((m = INSTR_TEXT_RE.exec(documentXml)) !== null) {
     const instrText = m[1] ?? "";
-    if (TOC_FIELD_RE.test(instrText)) retainAllToc = true;
-    REFLIKE_FIELD_RE.lastIndex = 0;
-    let r;
-    while ((r = REFLIKE_FIELD_RE.exec(instrText)) !== null) {
-      if (r[1]) retained.add(r[1]);
-    }
+    scanFieldInstruction(instrText, retained, () => {
+      retainAllToc = true;
+    });
+  }
+  FLD_SIMPLE_INSTR_DOUBLE_RE.lastIndex = 0;
+  while ((m = FLD_SIMPLE_INSTR_DOUBLE_RE.exec(documentXml)) !== null) {
+    scanFieldInstruction(decodeXmlAttribute(m[1] ?? ""), retained, () => {
+      retainAllToc = true;
+    });
+  }
+  FLD_SIMPLE_INSTR_SINGLE_RE.lastIndex = 0;
+  while ((m = FLD_SIMPLE_INSTR_SINGLE_RE.exec(documentXml)) !== null) {
+    scanFieldInstruction(decodeXmlAttribute(m[1] ?? ""), retained, () => {
+      retainAllToc = true;
+    });
   }
   retainRevisionBoundedBookmarks(documentXml, retained);
   return {
@@ -18438,6 +18453,17 @@ function scanBookmarkReferences(documentXml, callerAllowlist = []) {
     retainAll
   };
 }
+function scanFieldInstruction(instrText, retained, retainToc) {
+  if (TOC_FIELD_RE.test(instrText)) retainToc();
+  REFLIKE_FIELD_RE.lastIndex = 0;
+  let r;
+  while ((r = REFLIKE_FIELD_RE.exec(instrText)) !== null) {
+    if (r[1]) retained.add(r[1]);
+  }
+}
+function decodeXmlAttribute(value) {
+  return value.replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+}
 function retainRevisionBoundedBookmarks(documentXml, retained) {
   const starts = /* @__PURE__ */ new Map();
   BOOKMARK_START_RE.lastIndex = 0;
@@ -18789,18 +18815,23 @@ function parseNumberingXml(xml, context) {
   const abstractDefinitions = {};
   const instances = {};
   const numPicBullets = {};
+  const topLevelOrdinals = /* @__PURE__ */ new Map();
   for (const child of numberingElement.children) {
     if (child.type !== "element") {
       continue;
     }
-    if (localName(child.name) === "numPicBullet") {
+    const childName = localName(child.name);
+    const childOrdinal = (topLevelOrdinals.get(childName) ?? 0) + 1;
+    topLevelOrdinals.set(childName, childOrdinal);
+    const childXmlPath = `/numbering[1]/${childName}[${childOrdinal}]`;
+    if (childName === "numPicBullet") {
       const rawId = readStringAttr(child, "w:numPicBulletId");
       if (rawId) {
-        numPicBullets[rawId] = readNumPicBullet(child, rawId, context);
+        numPicBullets[rawId] = readNumPicBullet(child, rawId, context, childXmlPath);
       }
       continue;
     }
-    switch (localName(child.name)) {
+    switch (childName) {
       case "abstractNum": {
         const rawId = readStringAttr(child, "w:abstractNumId");
         if (!rawId) {
@@ -18820,7 +18851,7 @@ function parseNumberingXml(xml, context) {
         const numStyleLink = numStyleLinkEl ? readStringAttr(numStyleLinkEl, "w:val") : void 0;
         abstractDefinitions[abstractNumberingId] = {
           abstractNumberingId,
-          ...context?.partPath !== void 0 ? { sourceRef: createNumberingSourceRef(context.partPath, "abstractNum", rawId) } : {},
+          ...context?.partPath !== void 0 ? { sourceRef: createNumberingSourceRef(context.partPath, "abstractNum", rawId, childXmlPath) } : {},
           levels: readLevels(child),
           ...nsid ? { nsid } : {},
           ...multiLevelType ? { multiLevelType } : {},
@@ -18840,7 +18871,7 @@ function parseNumberingXml(xml, context) {
         const numberingInstanceId = toCanonicalNumberingInstanceId(rawId);
         instances[numberingInstanceId] = {
           numberingInstanceId,
-          ...context?.partPath !== void 0 ? { sourceRef: createNumberingSourceRef(context.partPath, "num", rawId) } : {},
+          ...context?.partPath !== void 0 ? { sourceRef: createNumberingSourceRef(context.partPath, "num", rawId, childXmlPath) } : {},
           abstractNumberingId: toCanonicalAbstractNumberingId(rawAbstractId),
           overrides: readOverrides(child)
         };
@@ -18854,15 +18885,16 @@ function parseNumberingXml(xml, context) {
     ...Object.keys(numPicBullets).length > 0 ? { numPicBullets } : {}
   };
 }
-function createNumberingSourceRef(partPath, element, rawId) {
+function createNumberingSourceRef(partPath, element, rawId, xmlPath) {
   return {
     sourceId: `part:${partPath}#${element}:${rawId}`,
     partPath,
     storyKind: "numbering",
-    element
+    element,
+    ...xmlPath !== void 0 ? { xmlPath } : {}
   };
 }
-function readNumPicBullet(node, numPicBulletId, context) {
+function readNumPicBullet(node, numPicBulletId, context, xmlPath) {
   let widthEmu;
   let heightEmu;
   let mediaId;
@@ -18925,6 +18957,7 @@ function readNumPicBullet(node, numPicBulletId, context) {
   }
   return {
     numPicBulletId,
+    ...context?.partPath !== void 0 ? { sourceRef: createNumberingSourceRef(context.partPath, "numPicBullet", numPicBulletId, xmlPath) } : {},
     rawXml: serializeXmlElementToString(node),
     ...widthEmu !== void 0 ? { widthEmu } : {},
     ...heightEmu !== void 0 ? { heightEmu } : {},
@@ -22898,7 +22931,11 @@ function parseBodyChild(node, sourceXml, relationshipMap, relationships, mediaPa
     switch (localName(child.name)) {
       case "pPr":
         styleId = readParagraphStyleId(child);
-        numbering = readParagraphNumbering(child, sourcePartPath);
+        numbering = readParagraphNumbering(
+          child,
+          sourcePartPath,
+          `${sourceXmlPath}/pPr[${countPriorElementSiblingsByName(node, child) + 1}]`
+        );
         alignment = readParagraphAlignment(child);
         spacing = readParagraphSpacing2(child);
         contextualSpacing = readOptionalOnOffParagraphProperty(child, "contextualSpacing");
@@ -23981,7 +24018,7 @@ function readParagraphStyleId(node) {
   }
   return void 0;
 }
-function readParagraphNumbering(node, sourcePartPath) {
+function readParagraphNumbering(node, sourcePartPath, sourceXmlPath) {
   const numberingProperties = node.children.find(
     (child) => child.type === "element" && localName(child.name) === "numPr"
   );
@@ -24001,16 +24038,22 @@ function readParagraphNumbering(node, sourcePartPath) {
   }
   return {
     numberingInstanceId: toCanonicalNumberingInstanceId(rawInstanceId),
-    sourceRef: createElementSourceRef(sourcePartPath, "numPr", numberingProperties),
+    sourceRef: createElementSourceRef(
+      sourcePartPath,
+      "numPr",
+      numberingProperties,
+      sourceXmlPath !== void 0 ? `${sourceXmlPath}/numPr[${countPriorElementSiblingsByName(node, numberingProperties) + 1}]` : void 0
+    ),
     level: Number.parseInt(rawLevel, 10)
   };
 }
-function createElementSourceRef(partPath, element, node) {
+function createElementSourceRef(partPath, element, node, xmlPath) {
   return {
     sourceId: `part:${partPath}#${element}:${node.start}`,
     partPath,
     storyKind: storyKindFromPartPath(partPath),
     element,
+    ...xmlPath !== void 0 ? { xmlPath } : {},
     startOffset: node.start,
     endOffset: node.end
   };
@@ -32535,8 +32578,8 @@ async function computeStructuralHash(blocks) {
 }
 
 // src/runtime/layout/layout-engine-version.ts
-var LAYOUT_ENGINE_VERSION = 87;
-var LAYCACHE_SCHEMA_VERSION = 11;
+var LAYOUT_ENGINE_VERSION = 88;
+var LAYCACHE_SCHEMA_VERSION = 12;
 
 // src/runtime/prerender/customxml-cache.ts
 var LAYCACHE_NAMESPACE_NAME = "laycache";
@@ -34207,14 +34250,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) {
@@ -34267,6 +34313,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) {
@@ -34317,7 +34366,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";
@@ -36778,6 +36827,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,
@@ -36788,7 +36838,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) {
@@ -36916,7 +36967,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,
@@ -36929,29 +36980,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 } : {},
@@ -36962,23 +37028,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
@@ -36986,6 +37055,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)) {
@@ -37017,6 +37092,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;
@@ -37859,6 +37953,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 } : {}
@@ -38088,13 +38183,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));
@@ -39184,6 +39276,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;
@@ -39239,6 +39346,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 } : {}
@@ -39266,6 +39374,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
         }
@@ -42307,6 +42416,24 @@ function refusalIdForPostureBlocker(target, blocker2) {
       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";
   }
@@ -42329,12 +42456,42 @@ function auditCategoryForPostureBlocker(target, blocker2) {
       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(blocker2) {
   switch (blocker2) {
     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;
   }
@@ -48016,6 +48173,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 } : {},
@@ -52339,8 +52497,9 @@ function projectSurfaceBlocksToPageFragments(surface, pages, splits, columnByBlo
   const perPageCounter = /* @__PURE__ */ new Map();
   const fieldRegionsByParagraphIndex = buildFieldRegionsByParagraphIndex(fieldRegions);
   const generatedTargets = buildGeneratedTargets(editableTargets);
+  const numberingTargets = buildNumberingTargets(editableTargets);
   const bookmarkRanges = buildBookmarkRanges(editableTargets);
-  const numberingByParagraphIndex = buildNumberingByParagraphIndex(numberingInputs);
+  const numberingIndex = buildNumberingInputIndex(numberingInputs);
   const pushFragment = (pageIndex, fragment) => {
     const existing = byPage.get(pageIndex);
     if (existing) {
@@ -52376,8 +52535,9 @@ function projectSurfaceBlocksToPageFragments(surface, pages, splits, columnByBlo
           },
           fieldRegionsByParagraphIndex,
           generatedTargets,
+          numberingTargets,
           bookmarkRanges,
-          numberingByParagraphIndex,
+          numberingIndex,
           blockPath
         );
         continue;
@@ -52398,8 +52558,9 @@ function projectSurfaceBlocksToPageFragments(surface, pages, splits, columnByBlo
         },
         fieldRegionsByParagraphIndex,
         generatedTargets,
+        numberingTargets,
         bookmarkRanges,
-        numberingByParagraphIndex,
+        numberingIndex,
         blockPath
       );
       continue;
@@ -52431,8 +52592,9 @@ function projectSurfaceBlocksToPageFragments(surface, pages, splits, columnByBlo
         paginationRole: "whole",
         fieldRegionsByParagraphIndex,
         generatedTargets,
+        numberingTargets,
         bookmarkRanges,
-        numberingByParagraphIndex,
+        numberingIndex,
         blockPath
       }),
       ...columnIndex !== void 0 ? { columnIndex } : {}
@@ -52579,7 +52741,7 @@ function buildRunAnchorsForLine(input) {
   }
   return anchors;
 }
-function emitSlicedParagraph(block, slices, emit2, fieldRegionsByParagraphIndex = /* @__PURE__ */ new Map(), generatedTargets = [], bookmarkRanges = [], numberingByParagraphIndex = /* @__PURE__ */ new Map(), blockPath) {
+function emitSlicedParagraph(block, slices, emit2, fieldRegionsByParagraphIndex = /* @__PURE__ */ new Map(), generatedTargets = [], numberingTargets = [], bookmarkRanges = [], numberingIndex = EMPTY_NUMBERING_INPUT_INDEX, blockPath) {
   for (let i = 0; i < slices.length; i += 1) {
     const slice = slices[i];
     const heightTwips = slice.heightTwips ?? estimateSliceHeightFromLines(slice.lineRange);
@@ -52604,8 +52766,9 @@ function emitSlicedParagraph(block, slices, emit2, fieldRegionsByParagraphIndex
         paginationRole: slice.lineRange.from > 0 ? "continuation" : "slice",
         fieldRegionsByParagraphIndex,
         generatedTargets,
+        numberingTargets,
         bookmarkRanges,
-        numberingByParagraphIndex,
+        numberingIndex,
         blockPath
       })
     };
@@ -52626,7 +52789,7 @@ function estimateSliceHeightFromLines(lineRange) {
   const lines = Math.max(0, lineRange.to - lineRange.from);
   return lines * 240;
 }
-function emitSlicedTable(block, slices, emit2, fieldRegionsByParagraphIndex = /* @__PURE__ */ new Map(), generatedTargets = [], bookmarkRanges = [], numberingByParagraphIndex = /* @__PURE__ */ new Map(), blockPath) {
+function emitSlicedTable(block, slices, emit2, fieldRegionsByParagraphIndex = /* @__PURE__ */ new Map(), generatedTargets = [], numberingTargets = [], bookmarkRanges = [], numberingIndex = EMPTY_NUMBERING_INPUT_INDEX, blockPath) {
   for (let i = 0; i < slices.length; i += 1) {
     const slice = slices[i];
     const heightTwips = slice.heightTwips ?? estimateSliceHeightFromRows(slice.rowRange);
@@ -52650,8 +52813,9 @@ function emitSlicedTable(block, slices, emit2, fieldRegionsByParagraphIndex = /*
         paginationRole: slice.rowRange.from > 0 ? "continuation" : "slice",
         fieldRegionsByParagraphIndex,
         generatedTargets,
+        numberingTargets,
         bookmarkRanges,
-        numberingByParagraphIndex,
+        numberingIndex,
         blockPath
       }),
       ...slice.columnIndex !== void 0 ? { columnIndex: slice.columnIndex } : {}
@@ -52725,7 +52889,8 @@ function buildFragmentLayoutObject(input) {
   const numberingRows = collectNumberingLayoutFactsForBlock(
     input.block,
     input.blockPath,
-    input.numberingByParagraphIndex
+    input.numberingIndex,
+    input.numberingTargets
   );
   const numbering = input.block.kind === "paragraph" ? numberingRows[0] : void 0;
   const fieldRegions = collectFieldRegionLayoutFacts(
@@ -52896,6 +53061,11 @@ function buildGeneratedTargets(targets) {
     (target) => target.kind === "field-result-text" || target.kind === "hyperlink-text" || target.kind === "hyperlink-destination" || target.kind === "bookmark-anchor" || target.kind === "bookmark-content-range"
   );
 }
+function buildNumberingTargets(targets) {
+  return targets.filter(
+    (target) => target.listAddress !== void 0 || target.canonicalAddress?.addressKind === "list-item-text"
+  );
+}
 function buildBookmarkRanges(targets) {
   const anchors = /* @__PURE__ */ new Map();
   const contentRanges = /* @__PURE__ */ new Map();
@@ -52943,14 +53113,27 @@ function buildBookmarkRanges(targets) {
   }
   return ranges;
 }
-function buildNumberingByParagraphIndex(numberingInputs) {
+var EMPTY_NUMBERING_INPUT_INDEX = {
+  byNumberingKey: /* @__PURE__ */ new Map(),
+  byBlockPath: /* @__PURE__ */ new Map(),
+  byParagraphIndex: /* @__PURE__ */ new Map()
+};
+function buildNumberingInputIndex(numberingInputs) {
+  const byNumberingKey = /* @__PURE__ */ new Map();
+  const byBlockPath = /* @__PURE__ */ new Map();
   const byParagraph = /* @__PURE__ */ new Map();
   for (const input of numberingInputs) {
+    if (!byNumberingKey.has(input.numberingKey)) {
+      byNumberingKey.set(input.numberingKey, input);
+    }
+    if (!byBlockPath.has(input.blockPath)) {
+      byBlockPath.set(input.blockPath, input);
+    }
     if (!byParagraph.has(input.paragraphIndex)) {
       byParagraph.set(input.paragraphIndex, input);
     }
   }
-  return byParagraph;
+  return { byNumberingKey, byBlockPath, byParagraphIndex: byParagraph };
 }
 function collectBookmarkRangeLayoutFacts(fragmentId, blockPath, bookmarkRanges) {
   if (!blockPath || !bookmarkRanges || bookmarkRanges.length === 0) return [];
@@ -53031,6 +53214,7 @@ function collectNumberingLayoutFacts(block) {
     ...block.numbering?.numberingInstanceId !== void 0 ? { numberingInstanceId: block.numbering.numberingInstanceId } : {},
     ...block.numbering?.level !== void 0 ? { level: block.numbering.level } : {},
     ...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.numberingSuffix !== void 0 ? { markerSuffix: block.numberingSuffix } : {},
     ...block.resolvedNumbering?.geometry.markerJustification !== void 0 ? { markerJustification: block.resolvedNumbering.geometry.markerJustification } : {},
@@ -53058,15 +53242,21 @@ function collectNumberingLayoutFacts(block) {
     } : {}
   };
 }
-function collectNumberingLayoutFactsForBlock(block, blockPath, numberingByParagraphIndex) {
+function collectNumberingLayoutFactsForBlock(block, blockPath, numberingIndex, numberingTargets = []) {
   const rows = [];
   const seen = /* @__PURE__ */ new Set();
   visitParagraphBlocks(block, (paragraph, context) => {
     const numbering = collectNumberingLayoutFacts(paragraph);
     if (!numbering) return;
     const paragraphIndex = parseParagraphBlockIndex(paragraph.blockId);
-    const canonical = paragraphIndex !== void 0 ? numberingByParagraphIndex?.get(paragraphIndex) : void 0;
     const numberingKey = context.path !== void 0 ? `main:${context.path}:numbering` : void 0;
+    const canonical = lookupNumberingInput(
+      numberingIndex,
+      numberingKey,
+      context.path,
+      paragraphIndex
+    );
+    const target = findNumberingTarget(numberingTargets, context.path);
     const numberingLayoutId = numberingKey ?? [
       "numbering",
       paragraph.blockId,
@@ -53075,6 +53265,7 @@ function collectNumberingLayoutFactsForBlock(block, blockPath, numberingByParagr
     ].join(":");
     if (seen.has(numberingLayoutId)) return;
     seen.add(numberingLayoutId);
+    const unavailableReasons = collectNumberingUnavailableReasons(numbering, canonical);
     rows.push({
       numberingLayoutId,
       ...numberingKey !== void 0 ? { numberingKey } : {},
@@ -53082,6 +53273,10 @@ function collectNumberingLayoutFactsForBlock(block, blockPath, numberingByParagr
       ...canonical?.blockPath !== void 0 ? { sourceBlockPath: canonical.blockPath } : context.path !== void 0 ? { sourceBlockPath: context.path } : {},
       sourceBlockId: paragraph.blockId,
       ...paragraphIndex !== void 0 ? { paragraphIndex } : {},
+      ...target?.targetKey !== void 0 ? { targetKey: target.targetKey } : {},
+      ...target?.kind !== void 0 ? { targetKind: target.kind } : {},
+      ...target?.canonicalAddress?.addressKey !== void 0 ? { canonicalAddressKey: target.canonicalAddress.addressKey } : {},
+      ...target?.listAddress?.addressKey !== void 0 ? { listAddressKey: target.listAddress.addressKey } : {},
       ...canonical?.sourceRef !== void 0 ? { sourceRef: { ...canonical.sourceRef } } : {},
       ...canonical?.numberingSourceRef !== void 0 ? { numberingSourceRef: { ...canonical.numberingSourceRef } } : {},
       ...canonical?.numberingOrigin !== void 0 ? { numberingOrigin: canonical.numberingOrigin } : {},
@@ -53089,11 +53284,41 @@ function collectNumberingLayoutFactsForBlock(block, blockPath, numberingByParagr
       ...canonical?.numberingInstanceSourceRef !== void 0 ? { numberingInstanceSourceRef: { ...canonical.numberingInstanceSourceRef } } : {},
       ...canonical?.abstractNumberingId !== void 0 ? { abstractNumberingId: canonical.abstractNumberingId } : {},
       ...canonical?.abstractNumberingSourceRef !== void 0 ? { abstractNumberingSourceRef: { ...canonical.abstractNumberingSourceRef } } : {},
-      ...numbering
+      ...numbering,
+      ...unavailableReasons.length > 0 ? { unavailableReasons } : {}
     });
   }, blockPath);
   return rows;
 }
+function findNumberingTarget(numberingTargets, blockPath) {
+  if (blockPath === void 0) return void 0;
+  return numberingTargets.find((target) => target.blockPath === blockPath);
+}
+function lookupNumberingInput(numberingIndex, numberingKey, blockPath, paragraphIndex) {
+  if (!numberingIndex) return void 0;
+  if (numberingKey !== void 0) {
+    const byKey = numberingIndex.byNumberingKey.get(numberingKey);
+    if (byKey !== void 0) return byKey;
+  }
+  if (blockPath !== void 0) {
+    const byPath = numberingIndex.byBlockPath.get(blockPath);
+    if (byPath !== void 0) return byPath;
+  }
+  return paragraphIndex !== void 0 ? numberingIndex.byParagraphIndex.get(paragraphIndex) : void 0;
+}
+function collectNumberingUnavailableReasons(numbering, canonical) {
+  const reasons = [];
+  if (canonical === void 0) {
+    reasons.push("canonical-numbering-input-missing");
+  }
+  if (numbering.markerLane === void 0) {
+    reasons.push("numbering-marker-lane-unavailable");
+  }
+  if (numbering.textColumn === void 0) {
+    reasons.push("numbering-text-column-unavailable");
+  }
+  return reasons;
+}
 function findPageIndexForOffset(pages, offset) {
   for (let i = 0; i < pages.length; i += 1) {
     const page = pages[i];
@@ -56549,19 +56774,19 @@ function locateTargetRange(document2, 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 {
@@ -56577,6 +56802,18 @@ function locateTargetRange(document2, 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(document2, surface, target) {
   const canonical = resolveHyperlinkDisplayPath(document2, target.blockPath);
   if (!canonical) return null;
@@ -57696,6 +57933,17 @@ var hyperlinkDestinationEditMetadata = actionMethodMetadata(
     expectedDelta: "hyperlink destination changes"
   }
 );
+var hyperlinkTextEditMetadata = actionMethodMetadata(
+  "hyperlinkTextEdit",
+  "mutate",
+  "actions-link-bookmark",
+  "Edit supported hyperlink display text through the L07 text-leaf command target; broad carrier scope rewrite remains refused.",
+  {
+    uiVisible: true,
+    expectsUxResponse: "inline-change",
+    expectedDelta: "hyperlink display text changes"
+  }
+);
 var listOperationMetadata = actionMethodMetadata(
   "listOperation",
   "mutate",
@@ -57755,6 +58003,7 @@ var ACTION_METHODS = Object.freeze([
   "tocRefresh",
   "bookmarkEdit",
   "hyperlinkDestinationEdit",
+  "hyperlinkTextEdit",
   "listOperation",
   "tableFragment",
   "tableSelection",
@@ -57764,6 +58013,9 @@ var DEFAULT_LOCATE_LIMIT = 20;
 var DEFAULT_REWRITE_ALL_LIMIT = 10;
 var DEFAULT_TABLE_TEXT_SCOPE_LIMIT = 3;
 var DEFAULT_PLAN_STEP_LIMIT = 20;
+function documentContentHash(runtime) {
+  return JSON.stringify(runtime.getCanonicalDocument().content);
+}
 function createActionsFamily(runtime) {
   const category = {
     discover(input) {
@@ -58010,6 +58262,14 @@ function createActionsFamily(runtime) {
           ...readback ? { text: readback.text, excerpt: excerpt(readback.text) } : {}
         };
       }
+      if (resolved.target.kind === "editable-text") {
+        return {
+          status: "read",
+          target: summarizeTarget(resolved.target),
+          text: resolved.target.readback.text,
+          excerpt: excerpt(resolved.target.readback.text)
+        };
+      }
       const text = resolved.target.scope.content.text;
       return {
         status: "read",
@@ -58090,6 +58350,31 @@ function createActionsFamily(runtime) {
         input
       );
     },
+    hyperlinkTextEdit(input) {
+      if (input.text === void 0) {
+        return blockedApply(
+          "actions:hyperlink-text-edit:text-required",
+          "input",
+          "Hyperlink display text edit actions require a text value.",
+          "Retry with a text string."
+        );
+      }
+      const resolved = resolveTarget(runtime, input.target);
+      if (!resolved.ok) return blockedApplyFromResolution(resolved);
+      if (resolved.target.kind !== "editable-text" || resolved.target.targetKind !== "hyperlink-text") {
+        return blockedApply(
+          "actions:hyperlink-text-edit:hyperlink-text-handle-required",
+          "unsupported",
+          "Hyperlink display text edits require an exact hyperlink-text actionHandle.",
+          "Call ai.actions.locateAll and retry with a returned scope-command:text-leaf actionHandle."
+        );
+      }
+      return applyEditableTextRewrite(runtime, resolved.target, {
+        text: input.text,
+        actorId: input.actorId,
+        origin: input.origin
+      });
+    },
     listOperation(input) {
       return applyListOperation(runtime, input);
     },
@@ -58138,6 +58423,7 @@ function runPlan(runtime, input) {
   for (const step of input.steps) {
     const result = runPlanStep(runtime, mode, step, input);
     results.push(result);
+    if (isSuspectMutationStep(result)) break;
     if (stopOnBlocker && (result.status === "blocked" || result.status === "unsupported")) {
       break;
     }
@@ -58202,24 +58488,27 @@ function runPlanStep(runtime, mode, step, plan) {
       ...before.readback ? { beforeReadback: before.readback } : {}
     };
   }
+  const documentHashBeforeApply = documentContentHash(runtime);
   const applied = applyPlanStep(runtime, step, plan);
+  const documentHashAfterApply = documentContentHash(runtime);
+  const projectedApply = !applied.applied && documentHashAfterApply !== documentHashBeforeApply ? withSuspectMutationApplyResult(applied, step.id, applied.target ?? before.target) : applied;
   const after = step.kind === "flag" ? before : step.target ? readPlanTarget(runtime, step.target) : before;
   return {
     id: step.id,
     kind: step.kind,
-    status: applied.status === "unsupported" ? "unsupported" : applied.applied ? "applied" : "blocked",
-    applied: applied.applied,
-    changed: applied.changed,
-    ...applied.target ?? before.target ? { target: applied.target ?? before.target } : {},
+    status: projectedApply.status === "unsupported" ? "unsupported" : projectedApply.applied ? "applied" : "blocked",
+    applied: projectedApply.applied,
+    changed: projectedApply.changed,
+    ...projectedApply.target ?? before.target ? { target: projectedApply.target ?? before.target } : {},
     ...before.tableAction ? { tableAction: before.tableAction } : {},
     ...before.readback ? { beforeReadback: before.readback } : {},
     ...after.ok && after.readback ? { afterReadback: after.readback } : {},
-    ...applied.proposalId ? { proposalId: applied.proposalId } : {},
-    ...applied.posture ? { posture: applied.posture } : {},
-    ...applied.blockers ? { blockers: applied.blockers } : {},
-    ...applied.blockerDetails ? { blockerDetails: applied.blockerDetails } : {},
-    ...applied.auditReference ? { auditReference: applied.auditReference } : {},
-    ...applied.commandReference ? { commandReference: applied.commandReference } : {}
+    ...projectedApply.proposalId ? { proposalId: projectedApply.proposalId } : {},
+    ...projectedApply.posture ? { posture: projectedApply.posture } : {},
+    ...projectedApply.blockers ? { blockers: projectedApply.blockers } : {},
+    ...projectedApply.blockerDetails ? { blockerDetails: projectedApply.blockerDetails } : {},
+    ...projectedApply.auditReference ? { auditReference: projectedApply.auditReference } : {},
+    ...projectedApply.commandReference ? { commandReference: projectedApply.commandReference } : {}
   };
 }
 function runPlanTableActionStep(runtime, mode, step, plan) {
@@ -58347,6 +58636,23 @@ function locateAll(runtime, input) {
       isEmpty: text.trim().length === 0
     });
   }
+  if (matches.length < limit && !input.kind) {
+    for (const scope of scopes) {
+      if (matches.length >= limit) break;
+      for (const action of editableTextActionsForScope(runtime, scope.handle)) {
+        if (matches.length >= limit) break;
+        if (!textMatches(action.readback.text, input.query, input.matchCase)) continue;
+        matches.push({
+          kind: action.targetKind,
+          text: action.readback.text,
+          excerpt: excerpt(action.readback.text),
+          actionHandle: action.actionHandle,
+          readback: action.readback,
+          isEmpty: action.readback.isEmpty
+        });
+      }
+    }
+  }
   if (matches.length < limit && shouldScanTableText) {
     const tableTextScopeLimit = Math.max(
       0,
@@ -58381,23 +58687,27 @@ function locateAll(runtime, input) {
 function resolveTarget(runtime, target) {
   if ("actionHandle" in target) {
     const action = findTableAction(runtime, target.actionHandle);
-    if (!action) {
-      return blockedResolution(
-        `actions:target:action-handle-not-found:${target.actionHandle}`,
-        "unresolved-target",
-        "No current table text action matches the supplied actionHandle.",
-        "Call ai.actions.locateAll or ai.listTableActions again and retry with a fresh actionHandle."
-      );
+    if (action) {
+      if (action.family !== "table-text") {
+        return blockedResolution(
+          `actions:target:action-handle-not-text:${target.actionHandle}`,
+          "unsupported",
+          "This actionHandle is not a table text action.",
+          "Use table structure handles with ai.applyTableAction, or use a table text actionHandle for rewrite."
+        );
+      }
+      return { ok: true, target: { kind: "table-text", action } };
     }
-    if (action.family !== "table-text") {
-      return blockedResolution(
-        `actions:target:action-handle-not-text:${target.actionHandle}`,
-        "unsupported",
-        "This actionHandle is not a table text action.",
-        "Use table structure handles with ai.applyTableAction, or use a table text actionHandle for rewrite."
-      );
+    const editableTextAction = findEditableTextAction(runtime, target.actionHandle);
+    if (editableTextAction) {
+      return { ok: true, target: editableTextAction };
     }
-    return { ok: true, target: { kind: "table-text", action } };
+    return blockedResolution(
+      `actions:target:action-handle-not-found:${target.actionHandle}`,
+      "unresolved-target",
+      "No current table text or editable text action matches the supplied actionHandle.",
+      "Call ai.actions.locateAll again and retry with a fresh actionHandle."
+    );
   }
   if ("handle" in target) {
     const compiled = createScopeCompilerService(runtime).compileScopeById(target.handle.scopeId);
@@ -58482,7 +58792,21 @@ function applyRewrite(runtime, target, input) {
       ...result2.afterReadback ? { afterReadback: result2.afterReadback } : {}
     };
   }
+  if (target.kind === "editable-text") {
+    return applyEditableTextRewrite(runtime, target, input);
+  }
+  const rewriteBlocker = scopeRewriteCapabilityBlocker(target.scope);
+  if (rewriteBlocker) {
+    return blockedApply(
+      rewriteBlocker.code,
+      rewriteBlocker.category,
+      rewriteBlocker.message,
+      rewriteBlocker.nextStep,
+      [rewriteBlocker]
+    );
+  }
   const beforeText = target.scope.content.text;
+  const documentHashBeforeApply = documentContentHash(runtime);
   const result = createReplacementFamily(runtime).applyReplacementScope({
     targetScopeId: target.handle.scopeId,
     operation: "replace",
@@ -58494,7 +58818,22 @@ function applyRewrite(runtime, target, input) {
     ...input.origin ? { origin: input.origin } : {},
     ...input.proposalId ? { proposalId: input.proposalId } : {}
   });
-  return projectRewriteScopeResult(runtime, result, target, beforeText, input.text);
+  const documentMutated = documentContentHash(runtime) !== documentHashBeforeApply;
+  if (!result.applied) {
+    return documentMutated ? withSuspectMutationApplyResult(
+      projectApplyResult(result, target),
+      target.handle.scopeId,
+      summarizeTarget(target)
+    ) : projectApplyResult(result, target);
+  }
+  return projectRewriteScopeResult(
+    runtime,
+    result,
+    target,
+    beforeText,
+    input.text,
+    documentMutated
+  );
 }
 function projectApplyResult(result, target) {
   return {
@@ -58515,7 +58854,79 @@ function projectApplyResult(result, target) {
     ...result.auditReference ? { auditReference: result.auditReference } : {}
   };
 }
-function projectRewriteScopeResult(runtime, result, target, beforeText, proposedText) {
+function applyEditableTextRewrite(runtime, target, input) {
+  const before = runtime.getCanonicalDocument();
+  runtime.dispatch({
+    type: "selection.set",
+    selection: target.selection,
+    origin: actionOrigin(runtime, input)
+  });
+  runtime.applyActiveStoryTextCommand({
+    type: "text.insert",
+    text: input.text,
+    editableTarget: target.editableTarget,
+    origin: actionOrigin(runtime, input)
+  });
+  const changed = runtime.getCanonicalDocument() !== before;
+  if (!changed) {
+    return blockedApply(
+      `actions:editable-text:runtime-noop:${target.actionHandle}`,
+      "blocked",
+      "The editable text command was accepted but produced no document change.",
+      "Refresh the action handle with ai.actions.locateAll and retry; route persistent failures to L07 text command support.",
+      [
+        blockerWithOwner(
+          `actions:editable-text:runtime-noop:${target.actionHandle}`,
+          "blocked",
+          "The editable text command was accepted but produced no document change.",
+          "Refresh the action handle with ai.actions.locateAll and retry; route persistent failures to L07 text command support.",
+          "L07 runtime text command support"
+        )
+      ]
+    );
+  }
+  const afterTarget = findEditableTextActionByTargetKey(
+    runtime,
+    target.editableTarget.targetKey
+  );
+  const afterReadback = afterTarget?.readback ?? editableTextTargetState(
+    runtime.getCanonicalDocument(),
+    target.editableTarget
+  )?.readback;
+  if (!afterReadback || afterReadback.text !== input.text) {
+    return {
+      status: "blocked",
+      applied: false,
+      changed: true,
+      target: summarizeTarget(afterTarget ?? target),
+      posture: "suspect-readback",
+      blockers: Object.freeze([`actions:editable-text:readback-mismatch:${target.actionHandle}`]),
+      blockerDetails: Object.freeze([
+        blocker(
+          `actions:editable-text:readback-mismatch:${target.actionHandle}`,
+          "blocked",
+          "The editable text command changed the document, but exact target readback did not match the proposed text.",
+          "Treat the mutation as suspect. Re-read the target and export before claiming success."
+        )
+      ]),
+      ...afterReadback ? { afterReadback } : {}
+    };
+  }
+  return {
+    status: "applied",
+    applied: true,
+    changed: true,
+    target: summarizeTarget(afterTarget ?? { ...target, readback: afterReadback }),
+    commandReference: {
+      command: "text.insert",
+      actorId: input.actorId ?? "v3-ai-api",
+      origin: input.origin ?? "agent",
+      emittedAtUtc: currentAuditTimestamp(runtime)
+    },
+    afterReadback
+  };
+}
+function projectRewriteScopeResult(runtime, result, target, beforeText, proposedText, documentMutated) {
   if (!result.applied) return projectApplyResult(result, target);
   const compiledAfter = createScopeCompilerService(runtime).compileScopeById(
     target.handle.scopeId
@@ -58526,7 +58937,8 @@ function projectRewriteScopeResult(runtime, result, target, beforeText, proposed
       target,
       `actions:rewrite:authoritative-readback-unresolvable:${target.handle.scopeId}`,
       "The replacement primitive reported success, but the target scope could not be re-read afterwards.",
-      "Treat the mutation as untrusted. Re-locate the target and retry only after the scope resolves, or create an issue flag instead."
+      "Treat the mutation as untrusted. Re-locate the target and retry only after the scope resolves, or create an issue flag instead.",
+      documentMutated
     );
   }
   const afterText = compiledAfter.scope.content.text;
@@ -58538,7 +58950,8 @@ function projectRewriteScopeResult(runtime, result, target, beforeText, proposed
       { ...target, scope: compiledAfter.scope, handle: compiledAfter.scope.handle },
       `actions:rewrite:authoritative-readback-unchanged:${target.handle.scopeId}`,
       "The replacement primitive reported success, but authoritative scope readback showed unchanged text.",
-      "Treat the mutation as not applied. Retry with a narrower scope or create an issue flag; do not claim the replacement succeeded."
+      "Treat the mutation as not applied. Retry with a narrower scope or create an issue flag; do not claim the replacement succeeded.",
+      documentMutated
     );
   }
   if (!expectedPresent) {
@@ -58547,7 +58960,8 @@ function projectRewriteScopeResult(runtime, result, target, beforeText, proposed
       { ...target, scope: compiledAfter.scope, handle: compiledAfter.scope.handle },
       `actions:rewrite:authoritative-readback-mismatch:${target.handle.scopeId}`,
       "The replacement primitive reported success, but authoritative scope readback did not contain the proposed text.",
-      "Treat the mutation as suspect. Re-read the target, inspect the exported package when available, and retry only with a verified target."
+      "Treat the mutation as suspect. Re-read the target, inspect the exported package when available, and retry only with a verified target.",
+      documentMutated
     );
   }
   return {
@@ -58564,17 +58978,27 @@ function projectRewriteScopeResult(runtime, result, target, beforeText, proposed
     ...result.auditReference ? { auditReference: result.auditReference } : {}
   };
 }
-function blockedRewriteReadback(result, target, code, message, nextStep) {
+function blockedRewriteReadback(result, target, code, message, nextStep, documentMutated = false) {
   const detail = blocker(code, "blocked", message, nextStep);
+  const details = documentMutated ? [
+    detail,
+    blockerWithOwner(
+      `actions:rewrite:suspect-mutation:${target.handle.scopeId}`,
+      "blocked",
+      "The document changed even though authoritative target readback failed.",
+      "Abort the plan, inspect the export/readback evidence, and route the target to L08/L07 scope edit-target mapping before retrying.",
+      "L08 semantic scopes and L07 runtime text commands"
+    )
+  ] : [detail];
   return {
     status: "blocked",
     applied: false,
-    changed: false,
+    changed: documentMutated,
     target: summarizeTarget(target),
     proposalId: result.proposalId,
-    posture: "suspect-readback",
-    blockers: Object.freeze([detail.code]),
-    blockerDetails: Object.freeze([detail]),
+    posture: documentMutated ? "suspect-mutation" : "suspect-readback",
+    blockers: Object.freeze(details.map((entry) => entry.code)),
+    blockerDetails: Object.freeze(details),
     ...result.auditReference ? { auditReference: result.auditReference } : {}
   };
 }
@@ -58590,11 +59014,23 @@ function summarizeTarget(target) {
       canMark: false
     };
   }
+  if (target.kind === "editable-text") {
+    return {
+      kind: target.targetKind,
+      handle: target.ownerHandle,
+      actionHandle: target.actionHandle,
+      readback: target.readback,
+      canRewriteText: true,
+      canInsertAdjacentText: false,
+      canFlag: false,
+      canMark: false
+    };
+  }
   return {
     kind: target.scope.kind,
     handle: target.handle,
     canRewriteText: canRewriteScopeText(target.scope),
-    canInsertAdjacentText: canRewriteScopeText(target.scope),
+    canInsertAdjacentText: canInsertAdjacentScopeText(target.scope),
     canFlag: true,
     canMark: canMarkScope(target.scope)
   };
@@ -58606,6 +59042,34 @@ function tableTextActionsForScope(runtime, handle) {
   });
   return result.actions.filter((action) => action.family === "table-text");
 }
+function editableTextActionsForScope(runtime, handle) {
+  const bundle = createScopeCompilerService(runtime).compileBundleById(
+    handle.scopeId,
+    currentAuditTimestamp(runtime)
+  );
+  const entries = bundle?.evidence.editableTargets?.entries ?? [];
+  const currentTargets = collectEditableTargetRefs(runtime.getCanonicalDocument());
+  const actions2 = [];
+  for (const entry of entries) {
+    if (entry.kind !== "hyperlink-text" || entry.commandFamily !== "text-leaf" || entry.runtimeCommand.status !== "supported" || !entry.runtimeCommand.actionHandle) {
+      continue;
+    }
+    const currentTarget = currentTargets.find((target) => target.targetKey === entry.targetKey);
+    if (!currentTarget || currentTarget.kind !== "hyperlink-text") continue;
+    const targetState = editableTextTargetState(runtime.getCanonicalDocument(), currentTarget);
+    if (!targetState) continue;
+    actions2.push({
+      kind: "editable-text",
+      targetKind: "hyperlink-text",
+      actionHandle: entry.runtimeCommand.actionHandle,
+      editableTarget: currentTarget,
+      ownerHandle: handle,
+      readback: targetState.readback,
+      selection: targetState.selection
+    });
+  }
+  return Object.freeze(actions2);
+}
 function findTableAction(runtime, actionHandle) {
   const action = findAnyTableAction(runtime, actionHandle);
   return action?.family === "table-text" ? action : null;
@@ -58625,6 +59089,27 @@ function findAnyTableAction(runtime, actionHandle) {
   }
   return null;
 }
+function findEditableTextAction(runtime, actionHandle) {
+  if (!actionHandle.startsWith("scope-command:text-leaf:")) return null;
+  const compiler = createScopeCompilerService(runtime);
+  for (const scope of compiler.compileAllScopes()) {
+    const action = editableTextActionsForScope(runtime, scope.handle).find(
+      (candidate) => candidate.actionHandle === actionHandle
+    );
+    if (action) return action;
+  }
+  return null;
+}
+function findEditableTextActionByTargetKey(runtime, targetKey) {
+  const compiler = createScopeCompilerService(runtime);
+  for (const scope of compiler.compileAllScopes()) {
+    const action = editableTextActionsForScope(runtime, scope.handle).find(
+      (candidate) => candidate.editableTarget.targetKey === targetKey
+    );
+    if (action) return action;
+  }
+  return null;
+}
 function readDocumentPlanTarget(runtime) {
   const document2 = createInspectFamily(runtime).inspectDocument();
   return {
@@ -58681,6 +59166,18 @@ function readPlanTarget(runtime, target) {
       ])
     };
   }
+  const editableText = findEditableTextAction(runtime, target.actionHandle);
+  if (editableText) {
+    return {
+      ok: true,
+      target: summarizeTarget(editableText),
+      readback: {
+        text: editableText.readback.text,
+        excerpt: excerpt(editableText.readback.text),
+        isEmpty: editableText.readback.isEmpty
+      }
+    };
+  }
   return readPlanTableAction(runtime, target.actionHandle);
 }
 function readPlanTableAction(runtime, actionHandle) {
@@ -58743,6 +59240,15 @@ function checkPlanStepCapability(runtime, step, before) {
       "Regenerate the plan with a ScopeHandle or opaque actionHandle returned by L09."
     );
   }
+  if (step.kind === "rewrite" && target.kind === "list-item") {
+    return blockerWithOwner(
+      "capability:list-item:authoritative-readback-required",
+      "blocked",
+      "List-item text replacement is not yet backed by an authoritative mutation/readback route.",
+      "Use listOperation for numbering changes, or create an issue/explanation until L08/L07 list-item text replacement is proven.",
+      "L08 semantic scopes and L07 runtime text commands"
+    );
+  }
   if (step.kind === "rewrite" && !target.canRewriteText) {
     return blocker(
       `actions:plan:target-not-rewriteable:${step.id}`,
@@ -58775,7 +59281,20 @@ function checkPlanStepCapability(runtime, step, before) {
       "Use a supported semantic scope or create an issue flag instead."
     );
   }
-  if (step.kind === "fieldRefresh" || step.kind === "tocRefresh" || step.kind === "bookmarkEdit" || step.kind === "hyperlinkDestinationEdit") {
+  if (step.kind === "fieldRefresh" || step.kind === "tocRefresh" || step.kind === "bookmarkEdit" || step.kind === "hyperlinkDestinationEdit" || step.kind === "hyperlinkTextEdit") {
+    if (step.kind === "hyperlinkTextEdit") {
+      const resolved2 = resolveTarget(runtime, step.target);
+      if (!resolved2.ok) return resolved2.blockerDetails[0] ?? null;
+      if (resolved2.target.kind !== "editable-text" || resolved2.target.targetKind !== "hyperlink-text") {
+        return blocker(
+          `actions:hyperlink-text-edit:hyperlink-text-handle-required:${step.id}`,
+          "unsupported",
+          "Hyperlink display text plan steps require an exact hyperlink-text actionHandle.",
+          "Regenerate the plan with a scope-command:text-leaf actionHandle returned by ai.actions.locateAll."
+        );
+      }
+      return null;
+    }
     const resolved = resolveScopeExactTarget(runtime, step.target, step.kind);
     if (!resolved.ok) return resolved.blockerDetails[0] ?? null;
     const targetRef = resolveModeledEditableTarget(runtime, resolved.target, step.kind);
@@ -58880,6 +59399,13 @@ function applyPlanStep(runtime, step, plan) {
         actorId: step.actorId ?? plan.actorId,
         origin: step.origin ?? plan.origin
       });
+    case "hyperlinkTextEdit":
+      return createActionsFamily(runtime).actions.hyperlinkTextEdit({
+        target: step.target,
+        text: step.text,
+        actorId: step.actorId ?? plan.actorId,
+        origin: step.origin ?? plan.origin
+      });
     case "listOperation":
       return createActionsFamily(runtime).actions.listOperation({
         target: step.target,
@@ -59196,11 +59722,159 @@ function isTableFamilyScope(kind) {
   return kind === "table" || kind === "table-row" || kind === "table-cell";
 }
 function canRewriteScopeText(scope) {
+  return !isTableFamilyScope(scope.kind) && scope.kind !== "list-item" && (scope.replaceability.level === "full" || scope.replaceability.level === "text-only");
+}
+function canInsertAdjacentScopeText(scope) {
   return !isTableFamilyScope(scope.kind) && (scope.replaceability.level === "full" || scope.replaceability.level === "text-only");
 }
+function scopeRewriteCapabilityBlocker(scope) {
+  if (scope.kind === "list-item") {
+    return blockerWithOwner(
+      "capability:list-item:authoritative-readback-required",
+      "blocked",
+      "List-item text replacement is not yet backed by an authoritative mutation/readback route.",
+      "Use listOperation for numbering changes, or create an issue/explanation until L08/L07 list-item text replacement is proven.",
+      "L08 semantic scopes and L07 runtime text commands"
+    );
+  }
+  if (!canRewriteScopeText(scope)) {
+    return blocker(
+      `actions:rewrite:target-not-rewriteable:${scope.handle.scopeId}`,
+      "unsupported",
+      "The target capability posture does not allow text rewrite.",
+      "Use a supported text target, table text actionHandle, or create an issue flag instead."
+    );
+  }
+  return null;
+}
 function canMarkScope(scope) {
   return !isTableFamilyScope(scope.kind) && scope.replaceability.level !== "blocked" && scope.replaceability.level !== "preserve-only";
 }
+function editableTextTargetState(document2, target) {
+  if (target.kind !== "hyperlink-text") return void 0;
+  const resolved = resolveHyperlinkTarget(document2, target);
+  if (!resolved) return void 0;
+  const text = collectInlineText2(resolved.hyperlink.children);
+  return {
+    readback: { text, isEmpty: text.length === 0 },
+    selection: {
+      anchor: resolved.from,
+      head: resolved.to,
+      isCollapsed: resolved.from === resolved.to,
+      activeRange: {
+        kind: "range",
+        from: resolved.from,
+        to: resolved.to,
+        assoc: { start: -1, end: 1 }
+      }
+    }
+  };
+}
+function resolveHyperlinkTarget(document2, target) {
+  const parsed = parseBlockInlinePath(target.blockPath);
+  if (!parsed) return null;
+  let blocks = document2.content.children;
+  let block;
+  let row;
+  let offset = 0;
+  for (const token of parsed) {
+    switch (token.kind) {
+      case "block":
+        for (let index = 0; index < token.index; index += 1) {
+          offset += blockTextLength(blocks[index]);
+        }
+        block = blocks[token.index];
+        row = void 0;
+        if (!block) return null;
+        break;
+      case "row":
+        if (block?.type !== "table") return null;
+        row = block.rows[token.index];
+        block = void 0;
+        if (!row) return null;
+        break;
+      case "cell": {
+        const cell = row?.cells[token.index];
+        if (!cell) return null;
+        blocks = cell.children;
+        block = void 0;
+        row = void 0;
+        break;
+      }
+      case "inline": {
+        if (block?.type !== "paragraph") return null;
+        for (let index = 0; index < token.index; index += 1) {
+          offset += inlineTextLength(block.children[index]);
+        }
+        const inline = block.children[token.index];
+        if (inline?.type !== "hyperlink") return null;
+        const length = collectInlineText2(inline.children).length;
+        return { hyperlink: inline, from: offset, to: offset + length };
+      }
+    }
+  }
+  return null;
+}
+function parseBlockInlinePath(path) {
+  if (!path.startsWith("main/")) return null;
+  const tokens = [];
+  const re = /(block|row|cell|inline)\[(\d+)\]/gu;
+  let match;
+  while ((match = re.exec(path)) !== null) {
+    const kind = match[1];
+    tokens.push({ kind, index: Number(match[2]) });
+  }
+  return tokens.length > 0 ? Object.freeze(tokens) : null;
+}
+function collectInlineText2(inlines) {
+  let text = "";
+  for (const inline of inlines) {
+    switch (inline.type) {
+      case "text":
+        text += inline.text;
+        break;
+      case "hyperlink":
+      case "field":
+        text += collectInlineText2(inline.children);
+        break;
+      default:
+        break;
+    }
+  }
+  return text;
+}
+function blockTextLength(block) {
+  if (!block) return 0;
+  switch (block.type) {
+    case "paragraph":
+      return collectInlineText2(block.children).length;
+    case "table":
+      return block.rows.reduce(
+        (rowSum, row) => rowSum + row.cells.reduce(
+          (cellSum, cell) => cellSum + cell.children.reduce((blockSum, child) => blockSum + blockTextLength(child), 0),
+          0
+        ),
+        0
+      );
+    case "sdt":
+    case "custom_xml":
+      return block.children.reduce((sum, child) => sum + blockTextLength(child), 0);
+    default:
+      return 0;
+  }
+}
+function inlineTextLength(inline) {
+  if (!inline) return 0;
+  switch (inline.type) {
+    case "text":
+      return inline.text.length;
+    case "hyperlink":
+    case "field":
+      return collectInlineText2(inline.children).length;
+    default:
+      return 0;
+  }
+}
 function textMatches(text, query, matchCase) {
   if (matchCase) return text.includes(query);
   return text.toLocaleLowerCase().includes(query.toLocaleLowerCase());
@@ -59259,6 +59933,30 @@ function blockedApplyFromResolution(resolution) {
     blockerDetails: resolution.blockerDetails
   };
 }
+function withSuspectMutationApplyResult(result, stepOrScopeId, target) {
+  const detail = blockerWithOwner(
+    `actions:plan:suspect-mutation:${stepOrScopeId}`,
+    "blocked",
+    "The document changed even though the action did not return an applied result.",
+    "Abort the remaining plan, inspect authoritative readback/export evidence, and route the target to the owning edit-target/readback layer before retrying.",
+    "L08 semantic scopes and L07 runtime text commands"
+  );
+  return {
+    ...result,
+    status: "blocked",
+    applied: false,
+    changed: true,
+    ...target ? { target } : {},
+    posture: "suspect-mutation",
+    blockers: Object.freeze([...result.blockers ?? [], detail.code]),
+    blockerDetails: Object.freeze([...result.blockerDetails ?? [], detail])
+  };
+}
+function isSuspectMutationStep(step) {
+  return step.posture === "suspect-mutation" || (step.blockers ?? []).some(
+    (code) => code.startsWith("actions:plan:suspect-mutation:") || code.startsWith("actions:rewrite:suspect-mutation:")
+  );
+}
 function blockedPlan(mode, code, category, message, nextStep) {
   const detail = blocker(code, category, message, nextStep);
   return {