@beyondwork/docx-react-component 1.0.124 → 1.0.126

package/dist/legal.cjs

@@ -1017,7 +1017,8 @@ var SCOPE_MARKER_BOOKMARK_PREFIX = "bw:scope:";
 // 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_RE = /<(?:\w+:)?fldSimple\b[^>]*(?:\bw:instr|\binstr)\s*=\s*(["'])([\s\S]*?)\1/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;
@@ -1036,11 +1037,22 @@ function scanBookmarkReferences(documentXml, callerAllowlist = []) {
   }
   INSTR_TEXT_RE.lastIndex = 0;
   while ((m = INSTR_TEXT_RE.exec(documentXml)) !== null) {
-    if (scanInstructionText(m[1] ?? "", retained)) retainAllToc = true;
+    const instrText = m[1] ?? "";
+    scanFieldInstruction(instrText, retained, () => {
+      retainAllToc = true;
+    });
   }
-  FLD_SIMPLE_INSTR_RE.lastIndex = 0;
-  while ((m = FLD_SIMPLE_INSTR_RE.exec(documentXml)) !== null) {
-    if (scanInstructionText(m[2] ?? "", 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 {
@@ -1049,14 +1061,16 @@ function scanBookmarkReferences(documentXml, callerAllowlist = []) {
     retainAll
   };
 }
-function scanInstructionText(instrText, retained) {
-  const hasTocField = TOC_FIELD_RE.test(instrText);
+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]);
   }
-  return hasTocField;
+}
+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();
@@ -4813,7 +4827,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 = readParagraphSpacing(child);
         contextualSpacing = readOptionalOnOffParagraphProperty(child, "contextualSpacing");
@@ -5896,7 +5914,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"
   );
@@ -5916,16 +5934,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
   };

package/dist/legal.d.cts

@@ -1,4 +1,4 @@
-import { C as CanonicalDocument, e as DocumentNode } from './canonical-document-CG2TgAzj.cjs';
+import { C as CanonicalDocument, e as DocumentNode } from './canonical-document-CXCFCbAz.cjs';
 
 interface LegalBookmark {
     bookmarkId: string;

package/dist/legal.d.ts

@@ -1,4 +1,4 @@
-import { C as CanonicalDocument, e as DocumentNode } from './canonical-document-CG2TgAzj.js';
+import { C as CanonicalDocument, e as DocumentNode } from './canonical-document-CXCFCbAz.js';
 
 interface LegalBookmark {
     bookmarkId: string;

package/dist/legal.js

@@ -4,13 +4,13 @@ import {
   isHiddenBookmarkName,
   parseBookmarksFromDocumentXml,
   resolveWalkableRoot
-} from "./chunk-NAMAWCXN.js";
+} from "./chunk-YD2JE54B.js";
 import {
   extractComplexFieldsFromBodyXml,
   parseFieldsFromParagraphXml,
   parseMainDocumentXml
-} from "./chunk-A74Y5NE4.js";
-import "./chunk-FNWKE74J.js";
+} from "./chunk-4YJVRIUB.js";
+import "./chunk-5DGKFNQT.js";
 import "./chunk-IHE7YOAY.js";
 import "./chunk-UTL65BUI.js";
 import "./chunk-DNXYUIIS.js";

package/dist/{loader-D9y4ZRjj.d.ts → loader-CS9-9KFa.d.ts}

@@ -1,6 +1,6 @@
-import { C as CanonicalDocument } from './canonical-document-CG2TgAzj.js';
-import { ar as EditorStateNamespace, as as EditorStateLocation, a as EditorSessionState, P as PersistedEditorSnapshot, r as EditorError, t as ProtectionSnapshot, b as ExportDocxOptions, c as ExportResult, L as LoadStage, E as EditorHostAdapter, at as LoadScheduler, o as EditorSurfaceSnapshot } from './public-types-CNnMHZM9.js';
-import { E as EmbeddedDocumentManifest, e as ProgressiveSurfaceProjector } from './types-DjJNaE9c.js';
+import { C as CanonicalDocument } from './canonical-document-CXCFCbAz.js';
+import { ar as EditorStateNamespace, as as EditorStateLocation, a as EditorSessionState, P as PersistedEditorSnapshot, r as EditorError, t as ProtectionSnapshot, b as ExportDocxOptions, c as ExportResult, L as LoadStage, E as EditorHostAdapter, at as LoadScheduler, o as EditorSurfaceSnapshot } from './public-types-DdcHqcow.js';
+import { E as EmbeddedDocumentManifest, e as ProgressiveSurfaceProjector } from './types-bJAgMq1M.js';
 
 interface EditorStatePayloadNamespaceEntry {
     namespace: EditorStateNamespace;

package/dist/{loader-D9KCtj4m.d.cts → loader-OoWJ1_17.d.cts}

@@ -1,6 +1,6 @@
-import { C as CanonicalDocument } from './canonical-document-CG2TgAzj.cjs';
-import { ar as EditorStateNamespace, as as EditorStateLocation, a as EditorSessionState, P as PersistedEditorSnapshot, r as EditorError, t as ProtectionSnapshot, b as ExportDocxOptions, c as ExportResult, L as LoadStage, E as EditorHostAdapter, at as LoadScheduler, o as EditorSurfaceSnapshot } from './public-types-DajNGKV4.cjs';
-import { E as EmbeddedDocumentManifest, e as ProgressiveSurfaceProjector } from './types-CxE1aZiv.cjs';
+import { C as CanonicalDocument } from './canonical-document-CXCFCbAz.cjs';
+import { ar as EditorStateNamespace, as as EditorStateLocation, a as EditorSessionState, P as PersistedEditorSnapshot, r as EditorError, t as ProtectionSnapshot, b as ExportDocxOptions, c as ExportResult, L as LoadStage, E as EditorHostAdapter, at as LoadScheduler, o as EditorSurfaceSnapshot } from './public-types-BP3vqJR5.cjs';
+import { E as EmbeddedDocumentManifest, e as ProgressiveSurfaceProjector } from './types-Bg7D-GD3.cjs';
 
 interface EditorStatePayloadNamespaceEntry {
     namespace: EditorStateNamespace;

package/dist/{public-types-CNnMHZM9.d.ts → public-types-BP3vqJR5.d.cts}

@@ -3,7 +3,7 @@ import { ReactNode } from 'react';
 import * as Y from 'yjs';
 import * as y_protocols_awareness from 'y-protocols/awareness';
 import { Awareness } from 'y-protocols/awareness';
-import { S as SectionProperties, f as PersistedEditorSnapshotVersion, g as CDS_SCHEMA_VERSION, I as ISO8601DateTime, C as CanonicalDocument, h as CompatibilityReportVersion, i as Base64, M as ModelValidationIssue, j as CommentThread, k as CommentEntry, l as CommentResolution, m as RevisionMetadataRecord$1, n as RevisionRecord$1, p as CanonicalSourceRef, q as SdtDataBindingState, F as FieldFamily$1, r as FieldRefreshStatus$1, T as TocRegion, s as CanonicalAnchor, t as PreserveOnlyObjectSizing, u as TableCellNode, v as TableLook, w as TableStyleFormatting, x as TableWidth, y as TableBorders, z as TableStyleConditionalRegion, A as TableCellBorders, E as CellShading, G as TextMark, H as Mutable, J as ParagraphNode, K as TableIndent, L as TableCellMargins, N as TableNode, B as BlockNode, Q as FieldRegistryEntry, U as FootnoteProperties, V as EndnoteProperties, W as CanonicalTheme, X as InlineNode, Y as CanonicalParagraphFormatting, Z as CanonicalRunFormatting, _ as FillSpec, $ as TextProperties, a0 as StrokeSpec, a1 as ChartModel, a2 as ResolvedTheme, a3 as ColorRef, a4 as SupportedFieldFamily$1, a5 as HeaderDocument, a6 as FooterDocument, a7 as ParagraphBorders } from './canonical-document-CG2TgAzj.js';
+import { S as SectionProperties, f as PersistedEditorSnapshotVersion, g as CDS_SCHEMA_VERSION, I as ISO8601DateTime, C as CanonicalDocument, h as CompatibilityReportVersion, i as Base64, M as ModelValidationIssue, j as CommentThread, k as CommentEntry, l as CommentResolution, m as RevisionMetadataRecord$1, n as RevisionRecord$1, p as CanonicalSourceRef, q as SdtDataBindingState, F as FieldFamily$1, r as FieldRefreshStatus$1, T as TocRegion, s as CanonicalAnchor, t as PreserveOnlyObjectSizing, u as TableCellNode, B as BlockNode, v as TableLook, w as TableStyleFormatting, x as TableWidth, y as TableBorders, z as TableStyleConditionalRegion, A as TableCellBorders, E as CellShading, G as TextMark, H as Mutable, J as ParagraphNode, K as TableIndent, L as TableCellMargins, N as TableNode, Q as FieldRegistryEntry, U as FootnoteProperties, V as EndnoteProperties, W as CanonicalTheme, X as InlineNode, Y as CanonicalParagraphFormatting, Z as CanonicalRunFormatting, _ as FillSpec, $ as TextProperties, a0 as StrokeSpec, a1 as ChartModel, a2 as ResolvedTheme, a3 as ColorRef, a4 as SupportedFieldFamily$1, a5 as HeaderDocument, a6 as FooterDocument, a7 as ParagraphBorders } from './canonical-document-CXCFCbAz.cjs';
 import * as prosemirror_state from 'prosemirror-state';
 import { Command } from 'prosemirror-state';
 import { Schema } from 'prosemirror-model';
@@ -2013,6 +2013,10 @@ interface RuntimeNumberingLayoutFacts {
     sourceBlockPath?: string;
     sourceBlockId?: string;
     paragraphIndex?: number;
+    targetKey?: string;
+    targetKind?: string;
+    canonicalAddressKey?: string;
+    listAddressKey?: string;
     sourceRef?: RuntimeFieldRegionLayoutFacts["sourceRef"];
     numberingSourceRef?: RuntimeFieldRegionLayoutFacts["sourceRef"];
     numberingOrigin?: "paragraph" | "paragraph-style";
@@ -2023,6 +2027,12 @@ interface RuntimeNumberingLayoutFacts {
     numberingInstanceId?: string;
     level?: number;
     format?: string;
+    formatPosture?: {
+        status: "approximated";
+        requestedFormat: string;
+        renderedFormat: "decimal";
+        reason: "unsupported-numbering-format-decimal-fallback" | "numbering-format-range-decimal-fallback";
+    };
     markerText?: string;
     markerSuffix?: "tab" | "space" | "nothing";
     markerJustification?: "left" | "center" | "right" | "both" | "distribute";
@@ -2038,7 +2048,9 @@ interface RuntimeNumberingLayoutFacts {
         hangingTwips?: number;
     };
     tabStops?: readonly RuntimeNumberingTabStopFacts[];
+    unavailableReasons?: readonly RuntimeNumberingUnavailableReason[];
 }
+type RuntimeNumberingUnavailableReason = "canonical-numbering-input-missing" | "numbering-marker-lane-unavailable" | "numbering-text-column-unavailable";
 interface RuntimeNumberingTabStopFacts {
     positionTwips: number;
     align?: string;
@@ -2198,7 +2210,7 @@ interface RuntimePageAnchor {
 type EditableTargetKind = "paragraph-text" | "sdt-paragraph-text" | "table-cell-paragraph-text" | "nested-table-cell-paragraph-text" | "sdt-table-cell-paragraph-text" | "table-structure-table" | "table-structure-row" | "table-structure-column" | "table-structure-cell" | "table-structure-span" | "secondary-story-paragraph-text" | "textbox-paragraph-text" | "field-result-text" | "field-region-refresh" | "toc-region-refresh" | "hyperlink-text" | "hyperlink-destination" | "bookmark-anchor" | "bookmark-content-range" | "comment-anchor" | "revision-anchor" | "object-anchor" | "custom-xml-content" | "opaque-content";
 type EditableTargetCommandFamily = "text-leaf" | "table-structure" | "field" | "link-bookmark" | "comment-revision" | "object" | "metadata" | "preserve-only-refusal";
 type EditableTargetEditability = "editable" | "non-editable";
-type EditableTargetBlocker = "protected-section" | "protected-range" | "locked-content-control" | "preserve-only" | "opaque-content" | "field-generated-text" | "review-posture" | "synthetic-layout-cell" | "unmodeled-target";
+type EditableTargetBlocker = "protected-section" | "protected-range" | "locked-content-control" | "preserve-only" | "opaque-content" | "field-generated-text" | "review-posture" | "synthetic-layout-cell" | "unmodeled-target" | "list-text-readback-missing" | "list-structure-command-missing" | "list-target-stale" | "list-secondary-story-unsupported" | "list-table-target-missing" | "list-export-persistence-missing" | "numbering-format-unsupported" | "picture-bullet-preserve-only" | "marker-geometry-unavailable";
 interface EditableTargetPosture {
     readonly blockers: readonly EditableTargetBlocker[];
     readonly protected?: boolean;
@@ -2402,10 +2414,54 @@ interface EditableTargetRef {
     readonly table?: EditableTargetTableIdentity;
     readonly editableOwner?: EditableTargetOwnerIdentity;
     readonly canonicalAddress?: EditableTargetCanonicalAddress;
+    /**
+     * List-specific address for numbered/bulleted paragraph text. Table-cell
+     * list items keep their primary `canonicalAddress` as the table text target
+     * for existing table commands; this additive address lets list consumers use
+     * the same paragraph without narrowing it to table-only authority.
+     */
+    readonly listAddress?: EditableTargetCanonicalAddress;
     readonly staleCheck: EditableTargetStaleCheck;
     readonly posture: EditableTargetPosture;
 }
 type CanonicalAnchorObjectKind = "legacy-image" | "picture" | "shape" | "textbox" | "chart" | "smartart" | "opaque";
+/**
+ * Per-block cache for {@link collectEditableTargetRefs}.
+ *
+ * Each cache entry holds the editable targets produced for one canonical
+ * block (paragraph, table, sdt, etc.) under a specific collection context.
+ * Cache hits short-circuit the per-block walk on subsequent calls when the
+ * block reference is unchanged AND the surrounding context (story key,
+ * blockPath position, table identity, content-control posture) is
+ * identical.
+ *
+ * The intended consumer is the document runtime: instantiate one cache per
+ * runtime instance and reuse it across `getCachedSurface` calls so the
+ * editable-target walk does not run on every keystroke. Block references
+ * are preserved across text-only edits for unchanged paragraphs/tables, so
+ * the cache hit-rate approaches 100 % minus the directly edited block.
+ *
+ * The cache is safe across both text-only and structural edits:
+ *   - Text-only edits replace the affected block's reference, naturally
+ *     missing the cache for that block while leaving siblings cached.
+ *   - Structural edits (paragraph splits, table merges) replace blocks
+ *     and shift `blockPath` indices; the entry's recorded `blockPath` is
+ *     compared against the live walk's `blockPath` so a stale entry whose
+ *     block survived but moved is rejected and recomputed.
+ *
+ * The cache uses {@link WeakMap} so dropped block references are
+ * collected automatically; callers do not need to invalidate entries
+ * manually.
+ */
+interface EditableTargetBlockCache {
+    get(block: BlockNode): EditableTargetBlockCacheEntry | undefined;
+    set(block: BlockNode, entry: EditableTargetBlockCacheEntry): void;
+}
+interface EditableTargetBlockCacheEntry {
+    readonly blockPath: string;
+    readonly signature: string;
+    readonly targets: readonly EditableTargetRef[];
+}
 
 /**
  * Layer 02 · runtime page-graph types.
@@ -4341,6 +4397,12 @@ interface GeometryHitTarget {
     lineIndex: number;
     rect: GeometryRect$1;
     precision: GeometryPrecision;
+    generatedContentKind?: "numbering-marker";
+    generatedContentBoundary?: {
+        policy: "snap-to-authored-text";
+        authoredTextStartsAtPx?: number;
+        selectionPolicy: "exclude-generated-marker";
+    };
 }
 type SemanticDisplayEntryKind = "text-line" | "editable-target" | "field-region" | "page-local-field-ledger" | "numbering-marker" | "table-frame" | "table-row" | "table-column" | "table-cell" | "toc-leader" | "toc-page-label" | "field-result" | "inline-object" | "floating-object" | "placeholder" | "background" | "border" | "debug-classification";
 interface GeometryTableRowRange {
@@ -4374,6 +4436,20 @@ interface GeometryProjectionWarning {
     message: string;
 }
 type GeometryEditableTargetUnavailableReason = "editable-target-block-geometry-missing" | "editable-target-table-geometry-missing" | "editable-target-command-geometry-missing" | "editable-target-page-geometry-unavailable";
+type GeometryNumberingUnavailableReason = "canonical-numbering-input-missing" | "numbering-marker-lane-unavailable" | "numbering-text-column-unavailable";
+interface GeometryNumberingFormatPosture {
+    status: "approximated";
+    requestedFormat: string;
+    renderedFormat: "decimal";
+    reason: "unsupported-numbering-format-decimal-fallback" | "numbering-format-range-decimal-fallback";
+}
+interface GeometryNumberingMarkerBoundary {
+    generatedContent: "numbering-marker";
+    caretPolicy: "snap-to-authored-text";
+    selectionPolicy: "exclude-marker-unless-list-item-action";
+    coordinateSpace: "frame-px";
+    authoredTextStartsAtPx?: number;
+}
 interface SemanticDisplayEntry {
     entryId: string;
     kind: SemanticDisplayEntryKind;
@@ -4417,6 +4493,21 @@ interface SemanticDisplayEntry {
     editableTargetOwnerReason?: string;
     editableTargetOwnerCanonicalAddress?: EditableTargetOwnerAddressRouting;
     editableTargetUnavailableReason?: GeometryEditableTargetUnavailableReason;
+    numberingLayoutId?: string;
+    numberingKey?: string;
+    numberingTargetKey?: string;
+    numberingTargetKind?: string;
+    numberingCanonicalAddressKey?: string;
+    numberingListAddressKey?: string;
+    numberingMarkerText?: string;
+    numberingMarkerSuffix?: "tab" | "space" | "nothing";
+    numberingFormat?: string;
+    numberingFormatPosture?: GeometryNumberingFormatPosture;
+    numberingUnavailableReasons?: readonly GeometryNumberingUnavailableReason[];
+    markerGlyphRect?: GeometryRect$1;
+    markerLaneRect?: GeometryRect$1;
+    textColumnRect?: GeometryRect$1;
+    markerBoundary?: GeometryNumberingMarkerBoundary;
     rect: GeometryRect$1;
     status: GeometryRehydrationStatus;
     precision: GeometryPrecision;
@@ -4489,6 +4580,9 @@ interface HitTestResult$1 {
      * available; missing anchor metadata leaves it undefined.
      */
     assoc?: "before" | "after";
+    generatedContentKind?: "numbering-marker";
+    generatedContentBoundary?: "snap-to-authored-text";
+    semanticEntryId?: string;
 }
 type AnchorQueryKind = "runtime-offset" | "block-id" | "fragment-id" | "scope-id" | "comment-id" | "revision-id" | "page-index";
 interface AnchorQuery {
@@ -5737,24 +5831,29 @@ type EditorCommand = {
 } | {
     type: "list.toggle";
     kind: "bulleted" | "numbered";
-    paragraphIndexes: readonly number[];
+    paragraphIndexes?: readonly number[];
+    editableTargets?: readonly EditableTargetRef[];
     origin?: CommandOrigin;
 } | {
     type: "list.indent";
-    paragraphIndexes: readonly number[];
+    paragraphIndexes?: readonly number[];
+    editableTargets?: readonly EditableTargetRef[];
     origin?: CommandOrigin;
 } | {
     type: "list.outdent";
-    paragraphIndexes: readonly number[];
+    paragraphIndexes?: readonly number[];
+    editableTargets?: readonly EditableTargetRef[];
     origin?: CommandOrigin;
 } | {
     type: "list.restart-numbering";
-    paragraphIndex: number;
+    paragraphIndex?: number;
+    editableTarget?: EditableTargetRef | null;
     startAt?: number;
     origin?: CommandOrigin;
 } | {
     type: "list.continue-numbering";
-    paragraphIndex: number;
+    paragraphIndex?: number;
+    editableTarget?: EditableTargetRef | null;
     origin?: CommandOrigin;
 } | {
     type: "table.apply-structure";
@@ -5883,6 +5982,8 @@ interface CommandExecutionContext {
      */
     renderSnapshot?: RuntimeRenderSnapshot;
     activeStorySize?: number;
+    activeStoryKey?: string;
+    editableTargetCache?: EditableTargetBlockCache;
     textTarget?: TextTransactionTextTarget;
     rejectTargetlessTableStructureInsert?: boolean;
 }
@@ -6950,6 +7051,21 @@ interface RuntimeOperationStep {
     readonly kind: RuntimeOperationStepKind;
     /** Human-readable one-line description; used in audit `compiledOperations`. */
     readonly summary: string;
+    /**
+     * Optional command-surface target hint. Semantic ranges identify intent, but
+     * text mutation must still resolve against the runtime's current editable
+     * target graph before dispatch so table/SDT/nested structure offsets cannot
+     * masquerade as paragraph text positions.
+     */
+    readonly editableTargetHint?: {
+        readonly kind: "text-leaf";
+        readonly storyKey: string;
+        readonly blockPath: string;
+        readonly semanticBlockRange: {
+            readonly from: number;
+            readonly to: number;
+        };
+    };
     /**
      * Document-coordinate range the step operates on. Absent for steps
      * that target the scope as a whole.
@@ -8125,6 +8241,17 @@ interface CreateDocumentRuntimeOptions {
      * See CLAUDE.md (lane status table) §Phase 2.5 §3.7.
      */
     seedLayoutCache?: RuntimePageGraph;
+    /**
+     * Mounted-shell cold-load guard. When provided, only the first editor
+     * surface facet is projected with these realized block ranges. This is a
+     * presentation residency hint, not layout truth: L04 page graph reads must
+     * continue to start from their normal full/lazy layout query state.
+     * Headless callers omit this to preserve full-surface semantics.
+     */
+    initialSurfaceViewportBlockRanges?: readonly {
+        start: number;
+        end: number;
+    }[];
 }
 declare function createDocumentRuntime(options: CreateDocumentRuntimeOptions): DocumentRuntime;
 /**
@@ -8596,7 +8723,7 @@ interface RuntimeWordFieldMatrixProvider {
  * `runtime.collab.*` family graduate its live path when hosts supply it
  * and fall back to deterministic mocks when they don't.
  */
-type RuntimeApiHandle = Pick<DocumentRuntime, "now" | "getSessionState" | "setDocumentMode" | "exportDocx" | "getCompatibilityReport" | "getWarnings" | "getRenderSnapshot" | "getDocumentNavigationSnapshot" | "getCanonicalDocument" | "findAllText" | "replaceText" | "applyFormattingOperation" | "getReviewWorkSnapshot" | "getSuggestionsSnapshot" | "acceptChange" | "rejectChange" | "resolveComment" | "getCommentThreadForChange" | "ensureCommentThreadForChange" | "addReplyToChange" | "queryScopes" | "getWorkflowMarkupSnapshot" | "getInteractionGuardSnapshot" | "getWorkflowOverlay" | "addScope" | "setScopeGuardPolicy" | "getScopeGuardPolicy" | "setWorkflowMetadataEntries" | "getWorkflowMetadataSnapshot" | "getVisibilityPolicy" | "getVisibilityPolicies" | "setVisibilityPolicy" | "clearVisibilityPolicy" | "subscribeVisibilityPolicy" | "getMarkupModePolicy" | "setMarkupModePolicy" | "subscribeMarkupModePolicy" | "getScope" | "getLocationForAnchor" | "compileScopeBundleById" | "compileScopeList" | "compileScopeCardById" | "compileScopeRailSnapshot" | "applyScopeReplacement" | "applyScopeFormatting" | "dispatch" | "debug" | "layout" | "geometry"> & {
+type RuntimeApiHandle = Pick<DocumentRuntime, "now" | "getSessionState" | "setDocumentMode" | "exportDocx" | "getCompatibilityReport" | "getWarnings" | "getRenderSnapshot" | "getDocumentNavigationSnapshot" | "getCanonicalDocument" | "findAllText" | "replaceText" | "applyActiveStoryTextCommand" | "applyFormattingOperation" | "getReviewWorkSnapshot" | "getSuggestionsSnapshot" | "acceptChange" | "rejectChange" | "resolveComment" | "getCommentThreadForChange" | "ensureCommentThreadForChange" | "addReplyToChange" | "queryScopes" | "getWorkflowMarkupSnapshot" | "getInteractionGuardSnapshot" | "getWorkflowOverlay" | "addScope" | "setScopeGuardPolicy" | "getScopeGuardPolicy" | "setWorkflowMetadataEntries" | "getWorkflowMetadataSnapshot" | "getVisibilityPolicy" | "getVisibilityPolicies" | "setVisibilityPolicy" | "clearVisibilityPolicy" | "subscribeVisibilityPolicy" | "getMarkupModePolicy" | "setMarkupModePolicy" | "subscribeMarkupModePolicy" | "getScope" | "getLocationForAnchor" | "compileScopeBundleById" | "compileScopeList" | "compileScopeCardById" | "compileScopeRailSnapshot" | "applyScopeReplacement" | "applyScopeFormatting" | "dispatch" | "debug" | "layout" | "geometry"> & {
     /**
      * Optional collab session — hosts that wire Yjs/Awareness pass the
      * session here so `api.runtime.collab.getPresence` / `.getPosture`
@@ -11400,7 +11527,7 @@ type AiActionsTargetInput = {
     readonly tableTextScopeLimit?: number;
 };
 interface AiActionsMatch {
-    readonly kind: SemanticScopeKind | "table-text";
+    readonly kind: SemanticScopeKind | "table-text" | "hyperlink-text";
     readonly text: string;
     readonly excerpt: string;
     readonly handle?: ScopeHandle;
@@ -11439,7 +11566,7 @@ interface DiscoverActionsResult {
     readonly blockerDetails?: readonly AiActionsBlockerDetail[];
 }
 interface AiActionsTargetSummary {
-    readonly kind: SemanticScopeKind | "table-text";
+    readonly kind: SemanticScopeKind | "table-text" | "hyperlink-text";
     readonly handle?: ScopeHandle;
     readonly actionHandle?: string;
     readonly readback?: AiTableTextReadback;
@@ -11458,6 +11585,12 @@ interface RewriteActionsInput {
     readonly origin?: "ui" | "agent" | "host";
     readonly proposalId?: string;
 }
+interface HyperlinkTextEditActionsInput {
+    readonly target: AiActionsExactTargetInput;
+    readonly text: string;
+    readonly actorId?: string;
+    readonly origin?: "ui" | "agent" | "host";
+}
 interface RewriteAllActionsInput extends Omit<RewriteActionsInput, "target"> {
     readonly query: string;
     readonly kind?: SemanticScopeKind;
@@ -11648,6 +11781,12 @@ type RunPlanActionsStep = (RunPlanStepBase & {
     readonly href: string;
     readonly actorId?: string;
     readonly origin?: "ui" | "agent" | "host";
+}) | (RunPlanStepBase & {
+    readonly kind: "hyperlinkTextEdit";
+    readonly target: AiActionsExactTargetInput;
+    readonly text: string;
+    readonly actorId?: string;
+    readonly origin?: "ui" | "agent" | "host";
 }) | (RunPlanStepBase & {
     readonly kind: "listOperation";
     readonly target: AiActionsExactTargetInput;
@@ -11703,7 +11842,7 @@ interface ApplyActionsResult {
     readonly results?: readonly ApplyActionsResult[];
 }
 interface AiActionsCommandReference {
-    readonly command: NonNullable<ApplyTableActionResult["commandReference"]>["command"] | "field.refresh" | "toc.refresh" | "bookmark.edit-content" | "hyperlink.update-destination" | "list.toggle" | "list.indent" | "list.outdent" | "list.restart-numbering" | "list.continue-numbering";
+    readonly command: NonNullable<ApplyTableActionResult["commandReference"]>["command"] | "field.refresh" | "toc.refresh" | "bookmark.edit-content" | "hyperlink.update-destination" | "text.insert" | "list.toggle" | "list.indent" | "list.outdent" | "list.restart-numbering" | "list.continue-numbering";
     readonly actorId: string;
     readonly origin: "ui" | "agent" | "host";
     readonly emittedAtUtc: string;
@@ -11765,6 +11904,7 @@ declare function createActionsFamily(runtime: RuntimeApiHandle): {
         tocRefresh(input: TocRefreshActionsInput): ApplyActionsResult;
         bookmarkEdit(input: BookmarkEditActionsInput): ApplyActionsResult;
         hyperlinkDestinationEdit(input: HyperlinkDestinationEditActionsInput): ApplyActionsResult;
+        hyperlinkTextEdit(input: HyperlinkTextEditActionsInput): ApplyActionsResult;
         listOperation(input: ListOperationActionsInput): ApplyActionsResult;
         tableFragment(input: TableFragmentActionsInput): ApplyActionsResult;
         tableSelection(input: TableSelectionActionsInput): ApplyActionsResult;
@@ -14155,6 +14295,12 @@ interface ResolvedNumberingGeometrySnapshot {
 interface ResolvedNumberingSnapshot {
     level: number;
     format: string;
+    formatPosture?: {
+        status: "approximated";
+        requestedFormat: string;
+        renderedFormat: "decimal";
+        reason: "unsupported-numbering-format-decimal-fallback" | "numbering-format-range-decimal-fallback";
+    };
     text?: string;
     startAt: number;
     paragraphStyleId?: string;