@vcp-dev/site-edit-engine 0.4.9 → 0.6.1

package/dist/preview-runtime.d.ts

@@ -1,5 +1,5 @@
-import type { SiteEditOperationCommandResult, SiteEditResolveSourceLocationInput } from "@vcp-dev/contracts";
-import type { PreviewSiteEditEngineRuntime, PreviewSiteEditEngineRuntimeOptions } from "./types.js";
+import type { SiteEditCommandSuccess, SiteEditMutationContext, SiteEditOperationCommandResult, SiteEditResolveSourceLocationInput } from "@vcp-dev/contracts";
+import type { SiteEditEngineHistoryStatus, PreviewSiteEditEngineRuntime, PreviewSiteEditEngineRuntimeOptions } from "./types.js";
 export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSiteEditEngineRuntime {
     private readonly options;
     private readonly engine;
@@ -16,65 +16,65 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
             snapshotId: string;
             routeId: string;
             version: number;
-            rootKeys: string[];
             entries: {
                 key: string;
-                tag: string;
-                label: string;
-                parentKey: string | null;
-                childKeys: string[];
                 operationSummary: {
                     canUpdateText: boolean;
                     canInsertChild: boolean;
                     canMove: boolean;
                     canRemove: boolean;
                 };
+                pageCompositionUnitKey?: string | undefined;
             }[];
+            pageComposition: {
+                status: "supported";
+                containerKey: string;
+                hasBusinessMembers: boolean;
+                placementUnitKeys: string[];
+                placements: {
+                    placementKey: string;
+                    placementUnitKey: string;
+                    relation: "before" | "after" | "prepend" | "append";
+                }[];
+            } | {
+                status: "unsupported";
+                reason: "VERSION_STALE" | "RECOVERY_REQUIRED" | "MULTIPLE_PAGE_RETURNS" | "INDIRECT_RETURN_ONLY" | "PAGE_CONTAINER_AMBIGUOUS" | "NO_SAFE_PAGE_PLACEMENT" | "MEMBER_NOT_INDEPENDENT" | "UNSUPPORTED_ROUTE_STRUCTURE" | "RUNTIME_ANCHOR_UNRESOLVED" | "ROUTE_RETURN_NOT_FOUND";
+                diagnostics: {
+                    code: string;
+                    message: string;
+                }[];
+            };
         };
     };
-    getObjectSummary(key: string, routeId?: string): {
+    getStyleContext(routeId: string): {
+        ok: true;
+        data: {
+            revision: string;
+            entryCss: {
+                path: string;
+                content: string;
+                hash?: string | undefined;
+            };
+            stylesheets: {
+                path: string;
+                content: string;
+                hash?: string | undefined;
+            }[];
+        } | null;
+    };
+    getHistoryStatus(): Promise<SiteEditCommandSuccess<SiteEditEngineHistoryStatus>>;
+    getObjectEditContext(key: string, routeId?: string): {
         readonly ok: true;
         readonly data: {
             key: string;
             tag: string;
             label: string;
-            capabilities: {
-                constraints: {
-                    kind: "component-boundary" | "repeat-region" | "conditional-region" | "opaque-region" | "void-element" | "read-only" | "cross-file-required" | "import-required";
-                    message: string;
-                }[];
-            };
             isOpaque: boolean;
             ancestors: {
                 key: string;
                 label: string;
                 tag: string;
             }[];
-            sourceLocator?: {
-                sourceFile: string;
-                componentName: string;
-                openingElementRange: {
-                    startLine: number;
-                    startColumn: number;
-                    endLine: number;
-                    endColumn: number;
-                };
-                structuralPath: string;
-                textPreview?: string | undefined;
-            } | undefined;
-            provenanceChain?: {
-                editMode: "direct" | "proxy" | "upstream" | "readonly" | "unsupported";
-                diagnostics: {
-                    code: string;
-                    message: string;
-                }[];
-            } | undefined;
-        };
-    };
-    getObjectEditContext(key: string, routeId?: string): {
-        readonly ok: true;
-        readonly data: {
-            key: string;
             componentName: string;
             sourceFile: string;
             capabilities: {
@@ -106,68 +106,31 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
                     } | undefined;
                 } | undefined;
             };
-            writeTarget: {
-                kind: "jsx-node" | "component-proxy" | "value-binding" | "route-export";
-                file: string;
-                componentName: string;
-                isProxy: boolean;
-            };
             textSegments: {
                 index: number;
-                value: string;
                 editable: boolean;
-                source: {
-                    kind: "literal" | "binding" | "imported-binding" | "repeat-template";
-                    file: string;
-                    expression: string;
-                    bindingName?: string | undefined;
-                    path?: (string | number)[] | undefined;
-                } | null;
+                sourceKind: "literal" | "binding" | "imported-binding" | "repeat-template" | null;
             }[];
             boundaryKind: "component-boundary" | "repeat-region" | "conditional-region" | "fragment-region" | "opaque-region" | null;
-            children: {
-                key: string;
-                label: string;
-                tag: string;
-            }[];
-            siblings: {
-                key: string;
-                label: string;
-                tag: string;
-            }[];
-            effectiveWriteTarget?: {
-                kind: "jsx-node" | "route-export" | "value-path" | "external-entry";
-                isProxy: boolean;
-                file?: string | undefined;
-                displayPath?: string | undefined;
-                sourceType?: "api-field" | "cms-field" | "i18n-message" | "config-entry" | undefined;
-                sourceId?: string | undefined;
+            sourceLocator?: {
+                sourceFile: string;
+                componentName: string;
+                openingElementRange: {
+                    startLine: number;
+                    startColumn: number;
+                    endLine: number;
+                    endColumn: number;
+                };
+                structuralPath: string;
+                textPreview?: string | undefined;
             } | undefined;
             provenanceChain?: {
-                finalSource: {
-                    kind: "api-field" | "cms-field" | "i18n-message" | "config-entry" | "binding" | "imported-binding" | "repeat-template" | "jsx-literal" | "component-prop" | "object-field" | "array-item" | "conditional-branch";
-                    file: string;
-                    displayPath: string;
-                    externalSource?: {
-                        sourceType: "api-field" | "cms-field" | "i18n-message" | "config-entry";
-                        sourceId: string;
-                        adapterId?: string | undefined;
-                    } | undefined;
-                } | null;
-                chain: {
-                    kind: "api-field" | "cms-field" | "i18n-message" | "config-entry" | "binding" | "imported-binding" | "repeat-template" | "jsx-literal" | "component-prop" | "object-field" | "array-item" | "conditional-branch";
-                    file: string;
-                    displayName: string;
-                    canEditHere: boolean;
-                }[];
-                confidence: "exact" | "safe-derived" | "partial" | "unknown";
                 editMode: "direct" | "proxy" | "upstream" | "readonly" | "unsupported";
                 diagnostics: {
                     code: string;
                     message: string;
                 }[];
             } | undefined;
-            componentSemantic?: Record<string, unknown> | undefined;
         };
     };
     getClassNameSource(key: string, routeId?: string): {
@@ -183,50 +146,20 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
             attrRange: {
                 start: number;
                 end: number;
-                startLine?: number | undefined;
-                startColumn?: number | undefined;
-                endLine?: number | undefined;
-                endColumn?: number | undefined;
-            } | null;
-            valueRange: {
-                start: number;
-                end: number;
-                startLine?: number | undefined;
-                startColumn?: number | undefined;
-                endLine?: number | undefined;
-                endColumn?: number | undefined;
             } | null;
             openingElementRange: {
                 start: number;
                 end: number;
-                startLine?: number | undefined;
-                startColumn?: number | undefined;
-                endLine?: number | undefined;
-                endColumn?: number | undefined;
             };
             version: {
                 documentVersion: number;
                 contentHash: string;
-                parserVersion: string;
             };
             diagnostics: {
                 code: "missing-class-name" | "unsupported-attribute-name" | "source-locator-warning" | "invalid-new-attr" | "version-conflict" | "write-failed";
                 message: string;
             }[];
-            styleContext?: {
-                revision: string;
-                entryCss: {
-                    path: string;
-                    content: string;
-                    hash?: string | undefined;
-                };
-                stylesheets: {
-                    path: string;
-                    content: string;
-                    hash?: string | undefined;
-                }[];
-                computedStyle?: Record<string, string> | undefined;
-            } | undefined;
+            computedStyle?: Record<string, string> | undefined;
         };
     };
     getSourceTree(): Promise<{
@@ -285,19 +218,23 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
         };
     };
     refreshSourceForKey(key: string, routeId?: string): Promise<void>;
-    executeOperation(request: Parameters<PreviewSiteEditEngineRuntime["executeOperation"]>[0]): Promise<SiteEditOperationCommandResult>;
-    undo(): Promise<{
+    executeOperation(request: Parameters<PreviewSiteEditEngineRuntime["executeOperation"]>[0], mutationContext?: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
+    undo(_mutationContext?: SiteEditMutationContext): Promise<{
         ok: false;
         error: {
-            code: "NODE_NOT_FOUND" | "ROUTE_NOT_FOUND" | "CAPABILITY_REJECTED" | "CONSTRAINT_VIOLATED" | "INVALID_PARAMS" | "PLAN_FAILED" | "VERSION_STALE" | "AST_PARSE_ERROR" | "UNSUPPORTED_OPERATION" | "LOCATOR_FAILED" | "INVALID_TARGET" | "WRITE_IO_ERROR" | "CONCURRENT_MODIFIED" | "ROLLBACK_FAILED" | "INTERNAL_ERROR";
+            code: "VERSION_STALE" | "RECOVERY_REQUIRED" | "NODE_NOT_FOUND" | "ROUTE_NOT_FOUND" | "CAPABILITY_REJECTED" | "CONSTRAINT_VIOLATED" | "INVALID_PARAMS" | "PLAN_FAILED" | "TRANSACTION_PREFLIGHT_FAILED" | "ROUTE_REBUILD_FAILED" | "HISTORY_COMMIT_FAILED" | "MATERIALIZATION_CONFLICT" | "MATERIALIZATION_REJECTED" | "MUTATION_ASSERTION_REQUIRED" | "MUTATION_ASSERTION_INVALID" | "AST_PARSE_ERROR" | "UNSUPPORTED_OPERATION" | "LOCATOR_FAILED" | "INVALID_TARGET" | "WRITE_IO_ERROR" | "CONCURRENT_MODIFIED" | "ROLLBACK_FAILED" | "RECOVERY_PERSIST_FAILED" | "MUTATION_SESSION_REQUIRED" | "LEASE_ASSERTION_INVALID" | "LEASE_ASSERTION_EXPIRED" | "LEASE_ASSERTION_SCOPE_MISMATCH" | "CROSS_PAGE_MOVE_UNSUPPORTED" | "INTERNAL_ERROR";
             message: string;
         };
         data: {
             requestId: string;
-            kind: "update-text" | "update-array-item" | "remove-node" | "insert-child" | "move-node" | "set-class-name-source" | "set-props" | "apply-style-draft" | "source-edit";
+            kind: "insert-child" | "update-text" | "update-array-item" | "remove-node" | "move-node" | "set-class-name-source" | "set-props" | "apply-style-draft" | "source-edit";
             target: {
                 kind: "node";
                 key: string;
+            } | {
+                kind: "page-unit";
+                routeId: string;
+                placementUnitKey: string;
             } | {
                 kind: "route";
                 routeId: string;
@@ -314,10 +251,14 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
         ok: true;
         data: {
             requestId: string;
-            kind: "update-text" | "update-array-item" | "remove-node" | "insert-child" | "move-node" | "set-class-name-source" | "set-props" | "apply-style-draft" | "source-edit";
+            kind: "insert-child" | "update-text" | "update-array-item" | "remove-node" | "move-node" | "set-class-name-source" | "set-props" | "apply-style-draft" | "source-edit";
             target: {
                 kind: "node";
                 key: string;
+            } | {
+                kind: "page-unit";
+                routeId: string;
+                placementUnitKey: string;
             } | {
                 kind: "route";
                 routeId: string;
@@ -338,18 +279,22 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
         };
         error?: undefined;
     }>;
-    redo(): Promise<{
+    redo(_mutationContext?: SiteEditMutationContext): Promise<{
         ok: false;
         error: {
-            code: "NODE_NOT_FOUND" | "ROUTE_NOT_FOUND" | "CAPABILITY_REJECTED" | "CONSTRAINT_VIOLATED" | "INVALID_PARAMS" | "PLAN_FAILED" | "VERSION_STALE" | "AST_PARSE_ERROR" | "UNSUPPORTED_OPERATION" | "LOCATOR_FAILED" | "INVALID_TARGET" | "WRITE_IO_ERROR" | "CONCURRENT_MODIFIED" | "ROLLBACK_FAILED" | "INTERNAL_ERROR";
+            code: "VERSION_STALE" | "RECOVERY_REQUIRED" | "NODE_NOT_FOUND" | "ROUTE_NOT_FOUND" | "CAPABILITY_REJECTED" | "CONSTRAINT_VIOLATED" | "INVALID_PARAMS" | "PLAN_FAILED" | "TRANSACTION_PREFLIGHT_FAILED" | "ROUTE_REBUILD_FAILED" | "HISTORY_COMMIT_FAILED" | "MATERIALIZATION_CONFLICT" | "MATERIALIZATION_REJECTED" | "MUTATION_ASSERTION_REQUIRED" | "MUTATION_ASSERTION_INVALID" | "AST_PARSE_ERROR" | "UNSUPPORTED_OPERATION" | "LOCATOR_FAILED" | "INVALID_TARGET" | "WRITE_IO_ERROR" | "CONCURRENT_MODIFIED" | "ROLLBACK_FAILED" | "RECOVERY_PERSIST_FAILED" | "MUTATION_SESSION_REQUIRED" | "LEASE_ASSERTION_INVALID" | "LEASE_ASSERTION_EXPIRED" | "LEASE_ASSERTION_SCOPE_MISMATCH" | "CROSS_PAGE_MOVE_UNSUPPORTED" | "INTERNAL_ERROR";
             message: string;
         };
         data: {
             requestId: string;
-            kind: "update-text" | "update-array-item" | "remove-node" | "insert-child" | "move-node" | "set-class-name-source" | "set-props" | "apply-style-draft" | "source-edit";
+            kind: "insert-child" | "update-text" | "update-array-item" | "remove-node" | "move-node" | "set-class-name-source" | "set-props" | "apply-style-draft" | "source-edit";
             target: {
                 kind: "node";
                 key: string;
+            } | {
+                kind: "page-unit";
+                routeId: string;
+                placementUnitKey: string;
             } | {
                 kind: "route";
                 routeId: string;
@@ -366,10 +311,14 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
         ok: true;
         data: {
             requestId: string;
-            kind: "update-text" | "update-array-item" | "remove-node" | "insert-child" | "move-node" | "set-class-name-source" | "set-props" | "apply-style-draft" | "source-edit";
+            kind: "insert-child" | "update-text" | "update-array-item" | "remove-node" | "move-node" | "set-class-name-source" | "set-props" | "apply-style-draft" | "source-edit";
             target: {
                 kind: "node";
                 key: string;
+            } | {
+                kind: "page-unit";
+                routeId: string;
+                placementUnitKey: string;
             } | {
                 kind: "route";
                 routeId: string;

package/dist/public-file-system.d.ts

@@ -14,6 +14,8 @@ export interface SiteEditProjectFileSystem {
     readFileBytes?(file: string): Promise<Uint8Array>;
     getFileInfo?(file: string): Promise<SiteEditProjectFileInfo | null>;
     writeFile(file: string, content: string): Promise<void>;
+    /** Atomically creates a new file and fails when the target already exists. */
+    createExclusive?(file: string, content: string): Promise<void>;
     deleteFile(file: string): Promise<void>;
     exists(file: string): Promise<boolean>;
     listFiles?(input?: {

package/dist/runtime-sync.d.ts

@@ -1,4 +1,6 @@
-import type { SiteEditOperationRequest, SiteEditOperationResult, SiteEditOperationType, SiteEditRenderDocument } from "@vcp-dev/contracts";
+import type { SiteEditOperationRequest, SiteEditOperationResult, SiteEditOperationType } from "@vcp-dev/contracts";
+import type { RenderDocument as SiteEditRenderDocument, RenderEntry as SiteEditRenderEntry } from "./internal/protocol.js";
+export type { SiteEditRenderDocument, SiteEditRenderEntry };
 export declare const DEFAULT_SITE_EDIT_RUNTIME_READY_TIMEOUT_MS = 1500;
 export declare const SITE_EDIT_RUNTIME_READY_POLL_INTERVAL_MS = 16;
 export declare const SITE_EDIT_RUNTIME_ATTRIBUTES: {

package/dist/runtime.d.ts

@@ -12,59 +12,58 @@ export declare class SnapshotSiteEditEngineRuntime implements SiteEditEngineRunt
         snapshotId: string;
         routeId: string;
         version: number;
-        rootKeys: string[];
         entries: {
             key: string;
-            tag: string;
-            label: string;
-            parentKey: string | null;
-            childKeys: string[];
             operationSummary: {
                 canUpdateText: boolean;
                 canInsertChild: boolean;
                 canMove: boolean;
                 canRemove: boolean;
             };
+            pageCompositionUnitKey?: string | undefined;
         }[];
+        pageComposition: {
+            status: "supported";
+            containerKey: string;
+            hasBusinessMembers: boolean;
+            placementUnitKeys: string[];
+            placements: {
+                placementKey: string;
+                placementUnitKey: string;
+                relation: "before" | "after" | "prepend" | "append";
+            }[];
+        } | {
+            status: "unsupported";
+            reason: "VERSION_STALE" | "RECOVERY_REQUIRED" | "MULTIPLE_PAGE_RETURNS" | "INDIRECT_RETURN_ONLY" | "PAGE_CONTAINER_AMBIGUOUS" | "NO_SAFE_PAGE_PLACEMENT" | "MEMBER_NOT_INDEPENDENT" | "UNSUPPORTED_ROUTE_STRUCTURE" | "RUNTIME_ANCHOR_UNRESOLVED" | "ROUTE_RETURN_NOT_FOUND";
+            diagnostics: {
+                code: string;
+                message: string;
+            }[];
+        };
     };
-    getObjectSummary(key: string, routeId?: string): {
+    getStyleContext(routeId: string): {
+        revision: string;
+        entryCss: {
+            path: string;
+            content: string;
+            hash?: string | undefined;
+        };
+        stylesheets: {
+            path: string;
+            content: string;
+            hash?: string | undefined;
+        }[];
+    } | null;
+    getObjectEditContext(key: string, routeId?: string): {
         key: string;
         tag: string;
         label: string;
-        capabilities: {
-            constraints: {
-                kind: "component-boundary" | "repeat-region" | "conditional-region" | "opaque-region" | "void-element" | "read-only" | "cross-file-required" | "import-required";
-                message: string;
-            }[];
-        };
         isOpaque: boolean;
         ancestors: {
             key: string;
             label: string;
             tag: string;
         }[];
-        sourceLocator?: {
-            sourceFile: string;
-            componentName: string;
-            openingElementRange: {
-                startLine: number;
-                startColumn: number;
-                endLine: number;
-                endColumn: number;
-            };
-            structuralPath: string;
-            textPreview?: string | undefined;
-        } | undefined;
-        provenanceChain?: {
-            editMode: "direct" | "proxy" | "upstream" | "readonly" | "unsupported";
-            diagnostics: {
-                code: string;
-                message: string;
-            }[];
-        } | undefined;
-    };
-    getObjectEditContext(key: string, routeId?: string): {
-        key: string;
         componentName: string;
         sourceFile: string;
         capabilities: {
@@ -96,68 +95,31 @@ export declare class SnapshotSiteEditEngineRuntime implements SiteEditEngineRunt
                 } | undefined;
             } | undefined;
         };
-        writeTarget: {
-            kind: "jsx-node" | "component-proxy" | "value-binding" | "route-export";
-            file: string;
-            componentName: string;
-            isProxy: boolean;
-        };
         textSegments: {
             index: number;
-            value: string;
             editable: boolean;
-            source: {
-                kind: "literal" | "binding" | "imported-binding" | "repeat-template";
-                file: string;
-                expression: string;
-                bindingName?: string | undefined;
-                path?: (string | number)[] | undefined;
-            } | null;
+            sourceKind: "literal" | "binding" | "imported-binding" | "repeat-template" | null;
         }[];
         boundaryKind: "component-boundary" | "repeat-region" | "conditional-region" | "fragment-region" | "opaque-region" | null;
-        children: {
-            key: string;
-            label: string;
-            tag: string;
-        }[];
-        siblings: {
-            key: string;
-            label: string;
-            tag: string;
-        }[];
-        effectiveWriteTarget?: {
-            kind: "jsx-node" | "route-export" | "value-path" | "external-entry";
-            isProxy: boolean;
-            file?: string | undefined;
-            displayPath?: string | undefined;
-            sourceType?: "api-field" | "cms-field" | "i18n-message" | "config-entry" | undefined;
-            sourceId?: string | undefined;
+        sourceLocator?: {
+            sourceFile: string;
+            componentName: string;
+            openingElementRange: {
+                startLine: number;
+                startColumn: number;
+                endLine: number;
+                endColumn: number;
+            };
+            structuralPath: string;
+            textPreview?: string | undefined;
         } | undefined;
         provenanceChain?: {
-            finalSource: {
-                kind: "api-field" | "cms-field" | "i18n-message" | "config-entry" | "binding" | "imported-binding" | "repeat-template" | "jsx-literal" | "component-prop" | "object-field" | "array-item" | "conditional-branch";
-                file: string;
-                displayPath: string;
-                externalSource?: {
-                    sourceType: "api-field" | "cms-field" | "i18n-message" | "config-entry";
-                    sourceId: string;
-                    adapterId?: string | undefined;
-                } | undefined;
-            } | null;
-            chain: {
-                kind: "api-field" | "cms-field" | "i18n-message" | "config-entry" | "binding" | "imported-binding" | "repeat-template" | "jsx-literal" | "component-prop" | "object-field" | "array-item" | "conditional-branch";
-                file: string;
-                displayName: string;
-                canEditHere: boolean;
-            }[];
-            confidence: "exact" | "safe-derived" | "partial" | "unknown";
             editMode: "direct" | "proxy" | "upstream" | "readonly" | "unsupported";
             diagnostics: {
                 code: string;
                 message: string;
             }[];
         } | undefined;
-        componentSemantic?: Record<string, unknown> | undefined;
     };
     getClassNameSource(key: string, routeId?: string): {
         key: string;
@@ -170,50 +132,20 @@ export declare class SnapshotSiteEditEngineRuntime implements SiteEditEngineRunt
         attrRange: {
             start: number;
             end: number;
-            startLine?: number | undefined;
-            startColumn?: number | undefined;
-            endLine?: number | undefined;
-            endColumn?: number | undefined;
-        } | null;
-        valueRange: {
-            start: number;
-            end: number;
-            startLine?: number | undefined;
-            startColumn?: number | undefined;
-            endLine?: number | undefined;
-            endColumn?: number | undefined;
         } | null;
         openingElementRange: {
             start: number;
             end: number;
-            startLine?: number | undefined;
-            startColumn?: number | undefined;
-            endLine?: number | undefined;
-            endColumn?: number | undefined;
         };
         version: {
             documentVersion: number;
             contentHash: string;
-            parserVersion: string;
         };
         diagnostics: {
             code: "missing-class-name" | "unsupported-attribute-name" | "source-locator-warning" | "invalid-new-attr" | "version-conflict" | "write-failed";
             message: string;
         }[];
-        styleContext?: {
-            revision: string;
-            entryCss: {
-                path: string;
-                content: string;
-                hash?: string | undefined;
-            };
-            stylesheets: {
-                path: string;
-                content: string;
-                hash?: string | undefined;
-            }[];
-            computedStyle?: Record<string, string> | undefined;
-        } | undefined;
+        computedStyle?: Record<string, string> | undefined;
     };
     getSourceTree(): Promise<{
         nodes: import("@vcp-dev/contracts").SiteEditSourceTreeNode[];

package/dist/types.d.ts

@@ -1,5 +1,6 @@
-import type { SiteEditCommandSuccess, SiteEditEvent, SiteEditGetClassNameSourceCommandResult, SiteEditGetClassNameSourceResult, SiteEditObjectEditContext, SiteEditObjectSummary, SiteEditOperationCommandResult, SiteEditOperationRequest, SiteEditPatchPlan, SiteEditRenderDocument, SiteEditResolveSourceLocationInput, SiteEditSourceFileResponse, SiteEditSourceLocation, SiteEditSourceTreeResponse } from "@vcp-dev/contracts";
+import type { SiteEditCommandSuccess, SiteEditEvent, SiteEditGetClassNameSourceCommandResult, SiteEditGetClassNameSourceResult, SiteEditClassNameSourceStyleContext, SiteEditObjectEditContext, SiteEditOperationCommandResult, SiteEditMutationContext, SiteEditOperationRequest, SiteEditPatchPlan, SiteEditRenderDocument, SiteEditResolveSourceLocationInput, SiteEditSourceFileResponse, SiteEditSourceLocation, SiteEditSourceTreeResponse } from "@vcp-dev/contracts";
 import type { SiteEditProjectFileSystem } from "./public-file-system.js";
+import type { FileHistoryStore } from "./history/file-history-store.js";
 export type { SiteEditProjectFileSystem } from "./public-file-system.js";
 export interface SiteEditSnapshotFile {
     path: string;
@@ -11,22 +12,31 @@ export interface SiteEditEngineRoute {
     entryFile: string;
 }
 export interface SiteEditEngineRuntimeOptions {
+    tenantId?: string;
     siteId: string;
     snapshotId: string;
     files: SiteEditSnapshotFile[];
     routes: SiteEditEngineRoute[];
     onEvent?: (event: SiteEditEvent) => void;
     dev?: boolean;
+    historyStore?: FileHistoryStore;
 }
 export interface SiteEditPlanOperationResult {
     result: SiteEditOperationCommandResult;
     patchPlan?: SiteEditPatchPlan;
 }
+export interface SiteEditEngineHistoryStatus {
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    readonly undoDepth: number;
+    readonly redoDepth: number;
+    readonly recoveryRequired: boolean;
+}
 export interface SiteEditEngineRuntime {
     readonly status: "idle" | "building" | "ready" | "disposed";
     setActiveRoute(routeId: string): Promise<void>;
     getDocument(routeId: string): SiteEditRenderDocument;
-    getObjectSummary(key: string, routeId?: string): SiteEditObjectSummary;
+    getStyleContext(routeId: string): SiteEditClassNameSourceStyleContext | null;
     getObjectEditContext(key: string, routeId?: string): SiteEditObjectEditContext;
     getClassNameSource(key: string, routeId?: string): SiteEditGetClassNameSourceResult;
     getSourceTree(): Promise<SiteEditSourceTreeResponse>;
@@ -38,6 +48,7 @@ export interface SiteEditEngineRuntime {
     dispose(): void;
 }
 export interface PreviewSiteEditEngineRuntimeOptions {
+    tenantId?: string;
     siteId: string;
     snapshotId: string;
     projectRoot: string;
@@ -45,6 +56,9 @@ export interface PreviewSiteEditEngineRuntimeOptions {
     onEvent?: (event: SiteEditEvent) => void;
     dev?: boolean;
     fileSystem?: SiteEditProjectFileSystem;
+    historyStore?: FileHistoryStore;
+    /** Preserves monotonic document versions when a Bridge swaps runtimes. */
+    initialDocumentVersion?: number;
 }
 export interface PreviewSiteEditEngineRuntime {
     readonly status: "idle" | "building" | "ready" | "error" | "disposed";
@@ -52,7 +66,8 @@ export interface PreviewSiteEditEngineRuntime {
     unregisterRoute(routeId: string): void;
     setActiveRoute(routeId: string): Promise<void>;
     getDocument(routeId: string): SiteEditCommandSuccess<SiteEditRenderDocument>;
-    getObjectSummary(key: string, routeId?: string): SiteEditCommandSuccess<SiteEditObjectSummary>;
+    getStyleContext(routeId: string): SiteEditCommandSuccess<SiteEditClassNameSourceStyleContext | null>;
+    getHistoryStatus(): Promise<SiteEditCommandSuccess<SiteEditEngineHistoryStatus>>;
     getObjectEditContext(key: string, routeId?: string): SiteEditCommandSuccess<SiteEditObjectEditContext>;
     getClassNameSource(key: string, routeId?: string): SiteEditGetClassNameSourceCommandResult;
     getSourceTree(): Promise<SiteEditCommandSuccess<SiteEditSourceTreeResponse>>;
@@ -61,9 +76,9 @@ export interface PreviewSiteEditEngineRuntime {
     }): Promise<SiteEditCommandSuccess<SiteEditSourceFileResponse>>;
     resolveSourceLocation(input: SiteEditResolveSourceLocationInput): SiteEditCommandSuccess<SiteEditSourceLocation>;
     refreshSourceForKey(key: string, routeId?: string): Promise<void>;
-    executeOperation(request: SiteEditOperationRequest): Promise<SiteEditOperationCommandResult>;
-    undo(): Promise<SiteEditOperationCommandResult>;
-    redo(): Promise<SiteEditOperationCommandResult>;
+    executeOperation(request: SiteEditOperationRequest, mutationContext?: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
+    undo(mutationContext?: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
+    redo(mutationContext?: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
     notifyFileChanged(file: string): void;
     subscribe(listener: (event: SiteEditEvent) => void): () => void;
     dispose(): void;