@beyondwork/docx-react-component 1.0.127 → 1.0.129

package/dist/{public-types-beSYFJRR.d.cts → public-types-B5CRoR6f.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, 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 { 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-BMtONpgf.cjs';
 import * as prosemirror_state from 'prosemirror-state';
 import { Command } from 'prosemirror-state';
 import { Schema } from 'prosemirror-model';
@@ -2606,6 +2606,21 @@ interface ViewState {
     chromePins: ChromePinsState;
 }
 
+type HotEditTier = "patch" | "bounded-projection" | "full-refresh" | "blocked";
+type HotEditPatchMissReason = "none" | "not-local-text" | "multi-step" | "unsupported-story" | "unsupported-surface-shape" | "budget-exceeded" | "effect-disqualified" | "participant-blocked";
+interface HotEditTrace {
+    readonly sequence: number;
+    readonly startedAtUtc: string;
+    readonly commandType: string;
+    readonly tier: HotEditTier;
+    readonly patchMissReason: HotEditPatchMissReason;
+    readonly totalDurationUs: number;
+    readonly refreshAllCount: number;
+    readonly patchHitCount: number;
+    readonly patchBudgetFallbackCount: number;
+    readonly boundedEditableTargetBuildCount: number;
+}
+
 /**
  * Layer-06 Slice 3 — `WorkflowDebugEntry` projector.
  *
@@ -5233,6 +5248,8 @@ interface RuntimeDebugFacet {
     setChannels(flags: Partial<Record<TelemetryChannel, boolean>>): Record<TelemetryChannel, boolean>;
     /** Current channel state. */
     getChannels(): Record<TelemetryChannel, boolean>;
+    /** Recent hot-edit traces used to explain typing fast-path choices. */
+    getHotEditTraces(): readonly HotEditTrace[];
 }
 
 declare function makeToggleBold(schema: Schema): Command;
@@ -5721,6 +5738,11 @@ type EditorCommand = {
      */
     type: "fragment.insert";
     fragment: CanonicalDocumentFragment;
+    /**
+     * Optional command-local selection for target-backed callers that do
+     * not want to move the mounted runtime selection before dispatch.
+     */
+    selection?: SelectionSnapshot$1;
     editableTarget?: EditableTargetRef;
     origin?: CommandOrigin;
 } | {
@@ -6380,6 +6402,12 @@ interface ScopeBundleEvidence {
      * not make a broad scope replacement safe by themselves.
      */
     readonly editableTargets?: ScopeEditableTargetEvidence;
+    /**
+     * Object / media / preserve-only evidence projected from intersecting
+     * editable targets. This is a read/routing surface; mutation authority still
+     * comes from capability verdicts and lower-layer command posture.
+     */
+    readonly objects?: ScopeObjectEvidence;
     /**
      * Structured table facts and semantic table action handles for table-family
      * scopes. Raw `table:*` / `row:*` / `cell:*` ids and `EditableTargetRef`
@@ -6657,6 +6685,26 @@ interface ScopeEditableTargetEvidence {
     readonly blockers: readonly ScopeEditableTargetBlocker[];
     readonly entries: readonly ScopeEditableTargetEvidenceEntry[];
 }
+type ScopeObjectEvidenceStatus = "none" | "present";
+interface ScopeObjectEvidenceEntry {
+    readonly targetKey: string;
+    readonly kind: EditableTargetKind;
+    readonly objectKind?: EditableTargetObjectIdentity["objectKind"];
+    readonly relation: ScopeEditableTargetRelation;
+    readonly commandFamily: EditableTargetCommandFamily;
+    readonly editability: EditableTargetEditability;
+    readonly sourceRef?: CanonicalSourceRef;
+    readonly object?: EditableTargetObjectIdentity;
+    readonly runtimeCommand: ScopeEditableTargetRuntimeCommandEvidence;
+    readonly blockers: readonly string[];
+    readonly preserveOnly?: boolean;
+}
+interface ScopeObjectEvidence {
+    readonly status: ScopeObjectEvidenceStatus;
+    readonly count: number;
+    readonly blockers: readonly string[];
+    readonly entries: readonly ScopeObjectEvidenceEntry[];
+}
 type ScopeTableEvidenceStatus = "present";
 type ScopeTableEvidenceKind = "table" | "table-row" | "table-cell";
 type ScopeTableVerticalMergeRole = "none" | "owner" | "continuation";
@@ -6890,6 +6938,7 @@ interface ScopeCapabilities {
     readonly canUseTableContinuationEvidence: ScopeCapabilityVerdict;
     readonly canEditListText: ScopeCapabilityVerdict;
     readonly canEditListStructure: ScopeCapabilityVerdict;
+    readonly canEditObject: ScopeCapabilityVerdict;
 }
 type ScopeContentControlEvidenceStatus = "none" | "present";
 interface ScopeContentControlEvidenceEntry {
@@ -10588,6 +10637,83 @@ declare function createViewportFamily(runtime: RuntimeApiHandle): {
     getPageGeometry(pageNumber: number): PageGeometry | null;
 };
 
+/**
+ * @endStateApi v3 — `runtime.lists` family.
+ *
+ * Stable list-command namespace over the L07 command surface. The first
+ * slice exposes readback and preflight for current list-item targets, and
+ * routes only the list mutations that already exist. Future list vocabulary
+ * returns typed blockers here until the underlying command/export/readback
+ * path is proven.
+ */
+
+type RuntimeListCommand = "toggle-numbered" | "toggle-bulleted" | "indent" | "outdent" | "restart-numbering" | "continue-numbering" | "create" | "attach" | "detach" | "join" | "separate" | "split" | "set-value" | "apply-template" | "capture-template" | "apply-preset" | "set-level-numbering" | "set-level-bullet" | "set-level-picture-bullet" | "set-level-alignment" | "set-level-indents" | "set-level-trailing-character" | "set-level-marker-font" | "set-level-text" | "set-level-start" | "set-level-layout" | "convert-to-text" | "paste-fragment" | "drop-fragment";
+type RuntimeListBlockerCode = "list-target-required" | "list-target-malformed" | "list-target-not-found" | "list-target-stale" | "list-target-non-editable" | "list-command-unsupported" | "list-command-preflight-blocked" | "list-continue-target-missing" | "list-join-target-missing";
+interface RuntimeListTargetInput {
+    readonly targetKey?: string;
+    readonly addressKey?: string;
+    readonly editableTarget?: EditableTargetRef | null;
+}
+interface RuntimeListBlocker {
+    readonly code: RuntimeListBlockerCode;
+    readonly ownerLayer: "L07";
+    readonly message: string;
+    readonly targetKey?: string;
+    readonly addressKey?: string;
+}
+interface RuntimeListReadback {
+    readonly targetKey: string;
+    readonly actionHandle: string;
+    readonly kind: EditableTargetRef["kind"];
+    readonly storyKey: string;
+    readonly blockPath: string;
+    readonly leafPath: string;
+    readonly addressKey: string;
+    readonly numberingInstanceId: string;
+    readonly abstractNumberingId?: string;
+    readonly level: number;
+    readonly listKind?: "numbered" | "bulleted";
+    readonly editability: EditableTargetRef["editability"];
+    readonly blockers: readonly string[];
+    readonly supportedCommands: readonly RuntimeListCommand[];
+    readonly unsupportedCommands: readonly RuntimeListCommand[];
+    readonly staleDiscriminators: {
+        readonly paragraphTextHash?: string;
+        readonly paragraphTextLength?: number;
+        readonly inlineCount?: number;
+        readonly listAddressStaleHash?: string;
+    };
+}
+interface RuntimeListCommandPreview {
+    readonly command: RuntimeListCommand;
+    readonly supported: boolean;
+    readonly target?: RuntimeListReadback;
+    readonly affectedTargets: readonly RuntimeListReadback[];
+    readonly blockers: readonly RuntimeListBlocker[];
+    readonly canJoin?: boolean;
+    readonly canContinuePrevious?: boolean;
+}
+interface RuntimeListApplyInput extends RuntimeListTargetInput {
+    readonly command: RuntimeListCommand;
+    readonly startAt?: number;
+}
+interface RuntimeListApplyResult {
+    readonly applied: boolean;
+    readonly command: RuntimeListCommand;
+    readonly before?: RuntimeListReadback;
+    readonly after?: RuntimeListReadback;
+    readonly blockers: readonly RuntimeListBlocker[];
+}
+declare function createListsFamily(runtime: RuntimeApiHandle): {
+    list(input?: {
+        readonly storyKey?: string;
+        readonly limit?: number;
+    }): RuntimeListReadback[];
+    get(input: RuntimeListTargetInput): RuntimeListReadback | null;
+    previewCommand(input: RuntimeListApplyInput): RuntimeListCommandPreview;
+    applyCommand(input: RuntimeListApplyInput): RuntimeListApplyResult;
+};
+
 /**
  * Layer 09 PE2 evidence projection.
  *
@@ -11592,6 +11718,88 @@ interface HyperlinkTextEditActionsInput {
     readonly actorId?: string;
     readonly origin?: "ui" | "agent" | "host";
 }
+interface TemplateTargetOccurrenceInput {
+    readonly refId?: string;
+    readonly occurrenceIndexInRef?: number;
+    readonly occurrenceIndexGlobal?: number;
+}
+interface TemplateTargetLocationInput {
+    readonly story?: string;
+    readonly refId?: string;
+    readonly blockKind?: "paragraph" | "table-cell" | "list-item" | "heading" | "field" | "hyperlink" | "unknown";
+    readonly start?: number;
+    readonly end?: number;
+    readonly tableRefId?: string;
+    readonly rowRefId?: string;
+    readonly cellRefId?: string;
+    readonly rowIndex?: number | null;
+    readonly columnIndex?: number | null;
+    readonly columnHeader?: string;
+    readonly rowLabel?: string;
+    readonly prefix?: string;
+    readonly suffix?: string;
+    readonly bindingHash?: string;
+}
+interface TemplateTargetInput {
+    readonly kind?: "template-field" | "template-clause";
+    readonly fieldId?: string;
+    readonly clauseId?: string;
+    readonly name?: string;
+    readonly groupId?: string;
+    readonly valueType?: "text" | "number" | "date" | "currency" | "boolean" | "option" | "clause" | "unknown";
+    readonly placeholderText?: string;
+    readonly expectedText?: string;
+    readonly location?: TemplateTargetLocationInput;
+    readonly occurrence?: TemplateTargetOccurrenceInput;
+    readonly target?: AiActionsExactTargetInput;
+}
+interface TemplateTargetReadback {
+    readonly text?: string;
+    readonly excerpt?: string;
+    readonly isEmpty?: boolean;
+    readonly occurrenceCount?: number;
+}
+interface TemplateTargetValidationItem {
+    readonly status: "valid" | "warning" | "blocked";
+    readonly targetKind: "template-field" | "template-clause";
+    readonly fieldId?: string;
+    readonly clauseId?: string;
+    readonly name?: string;
+    readonly groupId?: string;
+    readonly canFill: boolean;
+    readonly target?: AiActionsTargetSummary;
+    readonly readback?: TemplateTargetReadback;
+    readonly blockers?: readonly string[];
+    readonly blockerDetails?: readonly AiActionsBlockerDetail[];
+    readonly warnings?: readonly string[];
+}
+interface ValidateTemplateTargetsActionsInput {
+    readonly targets: readonly TemplateTargetInput[];
+    readonly allowDuplicateRanges?: boolean;
+}
+interface ValidateTemplateTargetsActionsResult {
+    readonly status: "valid" | "partial" | "blocked";
+    readonly targets: readonly TemplateTargetValidationItem[];
+    readonly blockers?: readonly string[];
+    readonly blockerDetails?: readonly AiActionsBlockerDetail[];
+}
+interface TemplateTargetReadActionsInput {
+    readonly target: TemplateTargetInput;
+}
+interface TemplateTargetReadActionsResult {
+    readonly status: "read" | "blocked";
+    readonly target?: AiActionsTargetSummary;
+    readonly readback?: TemplateTargetReadback;
+    readonly blockers?: readonly string[];
+    readonly blockerDetails?: readonly AiActionsBlockerDetail[];
+}
+interface TemplateFieldFillActionsInput {
+    readonly field: TemplateTargetInput;
+    readonly text: string;
+    readonly actorId?: string;
+    readonly origin?: "ui" | "agent" | "host";
+    readonly proposalId?: string;
+}
 interface RewriteAllActionsInput extends Omit<RewriteActionsInput, "target"> {
     readonly query: string;
     readonly kind?: SemanticScopeKind;
@@ -11788,6 +11996,13 @@ type RunPlanActionsStep = (RunPlanStepBase & {
     readonly text: string;
     readonly actorId?: string;
     readonly origin?: "ui" | "agent" | "host";
+}) | (RunPlanStepBase & {
+    readonly kind: "templateFieldFill";
+    readonly field: TemplateTargetInput;
+    readonly text: string;
+    readonly actorId?: string;
+    readonly origin?: "ui" | "agent" | "host";
+    readonly proposalId?: string;
 }) | (RunPlanStepBase & {
     readonly kind: "listOperation";
     readonly target: AiActionsExactTargetInput;
@@ -11906,6 +12121,9 @@ declare function createActionsFamily(runtime: RuntimeApiHandle): {
         bookmarkEdit(input: BookmarkEditActionsInput): ApplyActionsResult;
         hyperlinkDestinationEdit(input: HyperlinkDestinationEditActionsInput): ApplyActionsResult;
         hyperlinkTextEdit(input: HyperlinkTextEditActionsInput): ApplyActionsResult;
+        validateTemplateTargets(input: ValidateTemplateTargetsActionsInput): ValidateTemplateTargetsActionsResult;
+        templateTargetRead(input: TemplateTargetReadActionsInput): TemplateTargetReadActionsResult;
+        templateFieldFill(input: TemplateFieldFillActionsInput): ApplyActionsResult;
         listOperation(input: ListOperationActionsInput): ApplyActionsResult;
         tableFragment(input: TableFragmentActionsInput): ApplyActionsResult;
         tableSelection(input: TableSelectionActionsInput): ApplyActionsResult;
@@ -12672,6 +12890,7 @@ type ApiV3Runtime = {
     readonly search: ReturnType<typeof createSearchFamily>;
     readonly table: ReturnType<typeof createTableFamily>;
     readonly viewport: ReturnType<typeof createViewportFamily>;
+    readonly lists: ReturnType<typeof createListsFamily>;
 };
 type ApiV3Ai = ReturnType<typeof createInspectFamily> & ReturnType<typeof createResolveFamily> & ReturnType<typeof createBundleFamily> & ReturnType<typeof createReplacementFamily> & ReturnType<typeof createAttachFamily> & ReturnType<typeof createExportFamily> & ReturnType<typeof createExplainFamily> & ReturnType<typeof createPolicyFamily> & ReturnType<typeof createReviewFamily> & ReturnType<typeof createEvaluateFamily> & ReturnType<typeof createStatsFamily> & ReturnType<typeof createOutlineFamily> & ReturnType<typeof createTableActionFamily> & ReturnType<typeof createActionsFamily>;
 interface ApiV3 {

package/dist/{public-types-Cgl3efbO.d.ts → public-types-p9b8rfy8.d.ts}

@@ -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, 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.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-BMtONpgf.js';
 import * as prosemirror_state from 'prosemirror-state';
 import { Command } from 'prosemirror-state';
 import { Schema } from 'prosemirror-model';
@@ -2606,6 +2606,21 @@ interface ViewState {
     chromePins: ChromePinsState;
 }
 
+type HotEditTier = "patch" | "bounded-projection" | "full-refresh" | "blocked";
+type HotEditPatchMissReason = "none" | "not-local-text" | "multi-step" | "unsupported-story" | "unsupported-surface-shape" | "budget-exceeded" | "effect-disqualified" | "participant-blocked";
+interface HotEditTrace {
+    readonly sequence: number;
+    readonly startedAtUtc: string;
+    readonly commandType: string;
+    readonly tier: HotEditTier;
+    readonly patchMissReason: HotEditPatchMissReason;
+    readonly totalDurationUs: number;
+    readonly refreshAllCount: number;
+    readonly patchHitCount: number;
+    readonly patchBudgetFallbackCount: number;
+    readonly boundedEditableTargetBuildCount: number;
+}
+
 /**
  * Layer-06 Slice 3 — `WorkflowDebugEntry` projector.
  *
@@ -5233,6 +5248,8 @@ interface RuntimeDebugFacet {
     setChannels(flags: Partial<Record<TelemetryChannel, boolean>>): Record<TelemetryChannel, boolean>;
     /** Current channel state. */
     getChannels(): Record<TelemetryChannel, boolean>;
+    /** Recent hot-edit traces used to explain typing fast-path choices. */
+    getHotEditTraces(): readonly HotEditTrace[];
 }
 
 declare function makeToggleBold(schema: Schema): Command;
@@ -5721,6 +5738,11 @@ type EditorCommand = {
      */
     type: "fragment.insert";
     fragment: CanonicalDocumentFragment;
+    /**
+     * Optional command-local selection for target-backed callers that do
+     * not want to move the mounted runtime selection before dispatch.
+     */
+    selection?: SelectionSnapshot$1;
     editableTarget?: EditableTargetRef;
     origin?: CommandOrigin;
 } | {
@@ -6380,6 +6402,12 @@ interface ScopeBundleEvidence {
      * not make a broad scope replacement safe by themselves.
      */
     readonly editableTargets?: ScopeEditableTargetEvidence;
+    /**
+     * Object / media / preserve-only evidence projected from intersecting
+     * editable targets. This is a read/routing surface; mutation authority still
+     * comes from capability verdicts and lower-layer command posture.
+     */
+    readonly objects?: ScopeObjectEvidence;
     /**
      * Structured table facts and semantic table action handles for table-family
      * scopes. Raw `table:*` / `row:*` / `cell:*` ids and `EditableTargetRef`
@@ -6657,6 +6685,26 @@ interface ScopeEditableTargetEvidence {
     readonly blockers: readonly ScopeEditableTargetBlocker[];
     readonly entries: readonly ScopeEditableTargetEvidenceEntry[];
 }
+type ScopeObjectEvidenceStatus = "none" | "present";
+interface ScopeObjectEvidenceEntry {
+    readonly targetKey: string;
+    readonly kind: EditableTargetKind;
+    readonly objectKind?: EditableTargetObjectIdentity["objectKind"];
+    readonly relation: ScopeEditableTargetRelation;
+    readonly commandFamily: EditableTargetCommandFamily;
+    readonly editability: EditableTargetEditability;
+    readonly sourceRef?: CanonicalSourceRef;
+    readonly object?: EditableTargetObjectIdentity;
+    readonly runtimeCommand: ScopeEditableTargetRuntimeCommandEvidence;
+    readonly blockers: readonly string[];
+    readonly preserveOnly?: boolean;
+}
+interface ScopeObjectEvidence {
+    readonly status: ScopeObjectEvidenceStatus;
+    readonly count: number;
+    readonly blockers: readonly string[];
+    readonly entries: readonly ScopeObjectEvidenceEntry[];
+}
 type ScopeTableEvidenceStatus = "present";
 type ScopeTableEvidenceKind = "table" | "table-row" | "table-cell";
 type ScopeTableVerticalMergeRole = "none" | "owner" | "continuation";
@@ -6890,6 +6938,7 @@ interface ScopeCapabilities {
     readonly canUseTableContinuationEvidence: ScopeCapabilityVerdict;
     readonly canEditListText: ScopeCapabilityVerdict;
     readonly canEditListStructure: ScopeCapabilityVerdict;
+    readonly canEditObject: ScopeCapabilityVerdict;
 }
 type ScopeContentControlEvidenceStatus = "none" | "present";
 interface ScopeContentControlEvidenceEntry {
@@ -10588,6 +10637,83 @@ declare function createViewportFamily(runtime: RuntimeApiHandle): {
     getPageGeometry(pageNumber: number): PageGeometry | null;
 };
 
+/**
+ * @endStateApi v3 — `runtime.lists` family.
+ *
+ * Stable list-command namespace over the L07 command surface. The first
+ * slice exposes readback and preflight for current list-item targets, and
+ * routes only the list mutations that already exist. Future list vocabulary
+ * returns typed blockers here until the underlying command/export/readback
+ * path is proven.
+ */
+
+type RuntimeListCommand = "toggle-numbered" | "toggle-bulleted" | "indent" | "outdent" | "restart-numbering" | "continue-numbering" | "create" | "attach" | "detach" | "join" | "separate" | "split" | "set-value" | "apply-template" | "capture-template" | "apply-preset" | "set-level-numbering" | "set-level-bullet" | "set-level-picture-bullet" | "set-level-alignment" | "set-level-indents" | "set-level-trailing-character" | "set-level-marker-font" | "set-level-text" | "set-level-start" | "set-level-layout" | "convert-to-text" | "paste-fragment" | "drop-fragment";
+type RuntimeListBlockerCode = "list-target-required" | "list-target-malformed" | "list-target-not-found" | "list-target-stale" | "list-target-non-editable" | "list-command-unsupported" | "list-command-preflight-blocked" | "list-continue-target-missing" | "list-join-target-missing";
+interface RuntimeListTargetInput {
+    readonly targetKey?: string;
+    readonly addressKey?: string;
+    readonly editableTarget?: EditableTargetRef | null;
+}
+interface RuntimeListBlocker {
+    readonly code: RuntimeListBlockerCode;
+    readonly ownerLayer: "L07";
+    readonly message: string;
+    readonly targetKey?: string;
+    readonly addressKey?: string;
+}
+interface RuntimeListReadback {
+    readonly targetKey: string;
+    readonly actionHandle: string;
+    readonly kind: EditableTargetRef["kind"];
+    readonly storyKey: string;
+    readonly blockPath: string;
+    readonly leafPath: string;
+    readonly addressKey: string;
+    readonly numberingInstanceId: string;
+    readonly abstractNumberingId?: string;
+    readonly level: number;
+    readonly listKind?: "numbered" | "bulleted";
+    readonly editability: EditableTargetRef["editability"];
+    readonly blockers: readonly string[];
+    readonly supportedCommands: readonly RuntimeListCommand[];
+    readonly unsupportedCommands: readonly RuntimeListCommand[];
+    readonly staleDiscriminators: {
+        readonly paragraphTextHash?: string;
+        readonly paragraphTextLength?: number;
+        readonly inlineCount?: number;
+        readonly listAddressStaleHash?: string;
+    };
+}
+interface RuntimeListCommandPreview {
+    readonly command: RuntimeListCommand;
+    readonly supported: boolean;
+    readonly target?: RuntimeListReadback;
+    readonly affectedTargets: readonly RuntimeListReadback[];
+    readonly blockers: readonly RuntimeListBlocker[];
+    readonly canJoin?: boolean;
+    readonly canContinuePrevious?: boolean;
+}
+interface RuntimeListApplyInput extends RuntimeListTargetInput {
+    readonly command: RuntimeListCommand;
+    readonly startAt?: number;
+}
+interface RuntimeListApplyResult {
+    readonly applied: boolean;
+    readonly command: RuntimeListCommand;
+    readonly before?: RuntimeListReadback;
+    readonly after?: RuntimeListReadback;
+    readonly blockers: readonly RuntimeListBlocker[];
+}
+declare function createListsFamily(runtime: RuntimeApiHandle): {
+    list(input?: {
+        readonly storyKey?: string;
+        readonly limit?: number;
+    }): RuntimeListReadback[];
+    get(input: RuntimeListTargetInput): RuntimeListReadback | null;
+    previewCommand(input: RuntimeListApplyInput): RuntimeListCommandPreview;
+    applyCommand(input: RuntimeListApplyInput): RuntimeListApplyResult;
+};
+
 /**
  * Layer 09 PE2 evidence projection.
  *
@@ -11592,6 +11718,88 @@ interface HyperlinkTextEditActionsInput {
     readonly actorId?: string;
     readonly origin?: "ui" | "agent" | "host";
 }
+interface TemplateTargetOccurrenceInput {
+    readonly refId?: string;
+    readonly occurrenceIndexInRef?: number;
+    readonly occurrenceIndexGlobal?: number;
+}
+interface TemplateTargetLocationInput {
+    readonly story?: string;
+    readonly refId?: string;
+    readonly blockKind?: "paragraph" | "table-cell" | "list-item" | "heading" | "field" | "hyperlink" | "unknown";
+    readonly start?: number;
+    readonly end?: number;
+    readonly tableRefId?: string;
+    readonly rowRefId?: string;
+    readonly cellRefId?: string;
+    readonly rowIndex?: number | null;
+    readonly columnIndex?: number | null;
+    readonly columnHeader?: string;
+    readonly rowLabel?: string;
+    readonly prefix?: string;
+    readonly suffix?: string;
+    readonly bindingHash?: string;
+}
+interface TemplateTargetInput {
+    readonly kind?: "template-field" | "template-clause";
+    readonly fieldId?: string;
+    readonly clauseId?: string;
+    readonly name?: string;
+    readonly groupId?: string;
+    readonly valueType?: "text" | "number" | "date" | "currency" | "boolean" | "option" | "clause" | "unknown";
+    readonly placeholderText?: string;
+    readonly expectedText?: string;
+    readonly location?: TemplateTargetLocationInput;
+    readonly occurrence?: TemplateTargetOccurrenceInput;
+    readonly target?: AiActionsExactTargetInput;
+}
+interface TemplateTargetReadback {
+    readonly text?: string;
+    readonly excerpt?: string;
+    readonly isEmpty?: boolean;
+    readonly occurrenceCount?: number;
+}
+interface TemplateTargetValidationItem {
+    readonly status: "valid" | "warning" | "blocked";
+    readonly targetKind: "template-field" | "template-clause";
+    readonly fieldId?: string;
+    readonly clauseId?: string;
+    readonly name?: string;
+    readonly groupId?: string;
+    readonly canFill: boolean;
+    readonly target?: AiActionsTargetSummary;
+    readonly readback?: TemplateTargetReadback;
+    readonly blockers?: readonly string[];
+    readonly blockerDetails?: readonly AiActionsBlockerDetail[];
+    readonly warnings?: readonly string[];
+}
+interface ValidateTemplateTargetsActionsInput {
+    readonly targets: readonly TemplateTargetInput[];
+    readonly allowDuplicateRanges?: boolean;
+}
+interface ValidateTemplateTargetsActionsResult {
+    readonly status: "valid" | "partial" | "blocked";
+    readonly targets: readonly TemplateTargetValidationItem[];
+    readonly blockers?: readonly string[];
+    readonly blockerDetails?: readonly AiActionsBlockerDetail[];
+}
+interface TemplateTargetReadActionsInput {
+    readonly target: TemplateTargetInput;
+}
+interface TemplateTargetReadActionsResult {
+    readonly status: "read" | "blocked";
+    readonly target?: AiActionsTargetSummary;
+    readonly readback?: TemplateTargetReadback;
+    readonly blockers?: readonly string[];
+    readonly blockerDetails?: readonly AiActionsBlockerDetail[];
+}
+interface TemplateFieldFillActionsInput {
+    readonly field: TemplateTargetInput;
+    readonly text: string;
+    readonly actorId?: string;
+    readonly origin?: "ui" | "agent" | "host";
+    readonly proposalId?: string;
+}
 interface RewriteAllActionsInput extends Omit<RewriteActionsInput, "target"> {
     readonly query: string;
     readonly kind?: SemanticScopeKind;
@@ -11788,6 +11996,13 @@ type RunPlanActionsStep = (RunPlanStepBase & {
     readonly text: string;
     readonly actorId?: string;
     readonly origin?: "ui" | "agent" | "host";
+}) | (RunPlanStepBase & {
+    readonly kind: "templateFieldFill";
+    readonly field: TemplateTargetInput;
+    readonly text: string;
+    readonly actorId?: string;
+    readonly origin?: "ui" | "agent" | "host";
+    readonly proposalId?: string;
 }) | (RunPlanStepBase & {
     readonly kind: "listOperation";
     readonly target: AiActionsExactTargetInput;
@@ -11906,6 +12121,9 @@ declare function createActionsFamily(runtime: RuntimeApiHandle): {
         bookmarkEdit(input: BookmarkEditActionsInput): ApplyActionsResult;
         hyperlinkDestinationEdit(input: HyperlinkDestinationEditActionsInput): ApplyActionsResult;
         hyperlinkTextEdit(input: HyperlinkTextEditActionsInput): ApplyActionsResult;
+        validateTemplateTargets(input: ValidateTemplateTargetsActionsInput): ValidateTemplateTargetsActionsResult;
+        templateTargetRead(input: TemplateTargetReadActionsInput): TemplateTargetReadActionsResult;
+        templateFieldFill(input: TemplateFieldFillActionsInput): ApplyActionsResult;
         listOperation(input: ListOperationActionsInput): ApplyActionsResult;
         tableFragment(input: TableFragmentActionsInput): ApplyActionsResult;
         tableSelection(input: TableSelectionActionsInput): ApplyActionsResult;
@@ -12672,6 +12890,7 @@ type ApiV3Runtime = {
     readonly search: ReturnType<typeof createSearchFamily>;
     readonly table: ReturnType<typeof createTableFamily>;
     readonly viewport: ReturnType<typeof createViewportFamily>;
+    readonly lists: ReturnType<typeof createListsFamily>;
 };
 type ApiV3Ai = ReturnType<typeof createInspectFamily> & ReturnType<typeof createResolveFamily> & ReturnType<typeof createBundleFamily> & ReturnType<typeof createReplacementFamily> & ReturnType<typeof createAttachFamily> & ReturnType<typeof createExportFamily> & ReturnType<typeof createExplainFamily> & ReturnType<typeof createPolicyFamily> & ReturnType<typeof createReviewFamily> & ReturnType<typeof createEvaluateFamily> & ReturnType<typeof createStatsFamily> & ReturnType<typeof createOutlineFamily> & ReturnType<typeof createTableActionFamily> & ReturnType<typeof createActionsFamily>;
 interface ApiV3 {