@trojanbox-vcp-test/site-edit-engine 0.1.0

package/dist/preview-runtime.d.ts

@@ -0,0 +1,394 @@
+import type { PreviewSiteEditEngineRuntime, PreviewSiteEditEngineRuntimeOptions } from "./types.js";
+export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSiteEditEngineRuntime {
+    private readonly options;
+    private readonly engine;
+    private readonly listeners;
+    constructor(options: PreviewSiteEditEngineRuntimeOptions);
+    get status(): PreviewSiteEditEngineRuntime["status"];
+    registerRoute(routeId: string, entryFile: string): void;
+    setActiveRoute(routeId: string): Promise<void>;
+    getDocument(routeId: string): {
+        siteId: string;
+        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;
+            };
+        }[];
+    };
+    getObjectCapabilities(key: string, routeId?: string): {
+        key: string;
+        canUpdateText: boolean;
+        canInsertChild: boolean;
+        canMove: boolean;
+        canRemove: boolean;
+        boundaryKind: "component-boundary" | "repeat-region" | "conditional-region" | "fragment-region" | "opaque-region" | null;
+        isOpaque: boolean;
+    };
+    getObjectSummary(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;
+        }[];
+        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: {
+            key: string;
+            canUpdateText: boolean;
+            canInsertChild: boolean;
+            canMove: boolean;
+            canRemove: boolean;
+            constraints: {
+                kind: "component-boundary" | "repeat-region" | "conditional-region" | "opaque-region" | "void-element" | "read-only" | "cross-file-required" | "import-required";
+                message: string;
+            }[];
+            editModes?: {
+                updateText?: {
+                    mode: "direct" | "proxy" | "upstream" | "readonly" | "unsupported";
+                    reasonCode?: string | undefined;
+                } | undefined;
+                insertChild?: {
+                    mode: "direct" | "proxy" | "upstream" | "readonly" | "unsupported";
+                    reasonCode?: string | undefined;
+                } | undefined;
+                move?: {
+                    mode: "direct" | "proxy" | "upstream" | "readonly" | "unsupported";
+                    reasonCode?: string | undefined;
+                } | undefined;
+                remove?: {
+                    mode: "direct" | "proxy" | "upstream" | "readonly" | "unsupported";
+                    reasonCode?: string | undefined;
+                } | 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;
+        }[];
+        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;
+        } | 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;
+    };
+    getObjectStyleDetail(key: string, routeId?: string): {
+        key: string;
+        styleSource?: {
+            kind: "class-name-source";
+            className: string;
+            sourceKind: "missing" | "static-attribute" | "static-expression" | "dynamic-expression";
+            editable: boolean;
+            operationBoundary: ("update-text" | "remove-node" | "insert-child" | "move-node" | "replace-rich-text-content" | "insert-rich-text-block" | "remove-rich-text-block" | "set-media-field" | "set-component-slot-content" | "set-object-field" | "insert-object-field" | "remove-object-field" | "update-array-item" | "insert-array-item" | "remove-array-item" | "move-array-item" | "replace-conditional-expression" | "set-conditional-branch-content" | "set-jsx-prop" | "remove-jsx-prop" | "set-class-name" | "add-class-token" | "remove-class-token" | "set-style-property" | "set-style-properties" | "set-css-module-class" | "set-directive" | "remove-directive" | "set-route-export" | "set-metadata-field" | "set-generate-metadata")[];
+            sourcePath?: string | undefined;
+            diagnostics?: {
+                code: "missing-class-name" | "dynamic-binding" | "non-string-binding";
+                message: string;
+            }[] | undefined;
+        } | undefined;
+        styleModel?: Record<string, unknown> | {
+            kind: "css-style-model";
+            properties: {
+                property: "display" | "position" | "top" | "right" | "bottom" | "left" | "zIndex" | "flexDirection" | "flexWrap" | "flexGrow" | "flexShrink" | "flexBasis" | "order" | "gridTemplateColumns" | "gridTemplateRows" | "columns" | "gridColumn" | "gridRow" | "gap" | "gapX" | "gapY" | "spaceX" | "spaceY" | "alignItems" | "justifyContent" | "marginTop" | "marginRight" | "marginBottom" | "marginLeft" | "paddingTop" | "paddingRight" | "paddingBottom" | "paddingLeft" | "width" | "height" | "minWidth" | "minHeight" | "maxWidth" | "maxHeight" | "overflow" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "textTransform" | "textDecoration" | "textOverflow" | "textIndent" | "writingMode" | "whiteSpace" | "wordBreak" | "lineClamp" | "fontVariantNumeric" | "screenReaderOnly" | "color" | "backgroundColor" | "backgroundImage" | "borderStyle" | "borderWidth" | "borderRadius" | "borderColor" | "objectFit" | "objectPosition" | "aspectRatio" | "opacity" | "boxShadow" | "transform" | "transformOrigin" | "transitionProperty" | "transitionDuration" | "transitionTimingFunction" | "animation" | "pointerEvents" | "cursor" | "userSelect" | "fontStyle" | "textUnderlineOffset" | "scrollMarginTop" | "alignSelf" | "flex" | "outlineStyle" | "resize" | "ringWidth" | "ringColor" | "backdropFilter" | "overscrollBehavior" | "divideWidth" | "divideColor";
+                value: string | number | boolean | null;
+                editable: boolean;
+                resolvedValue?: string | number | boolean | null | undefined;
+                breakpoint?: "sm" | "md" | "lg" | "xl" | "2xl" | undefined;
+                state?: "hover" | "active" | "focus" | "disabled" | undefined;
+                variants?: string[] | undefined;
+                options?: (string | number)[] | undefined;
+                diagnostics?: {
+                    code: string;
+                    message: string;
+                }[] | undefined;
+                operationBoundary?: ("update-text" | "remove-node" | "insert-child" | "move-node" | "replace-rich-text-content" | "insert-rich-text-block" | "remove-rich-text-block" | "set-media-field" | "set-component-slot-content" | "set-object-field" | "insert-object-field" | "remove-object-field" | "update-array-item" | "insert-array-item" | "remove-array-item" | "move-array-item" | "replace-conditional-expression" | "set-conditional-branch-content" | "set-jsx-prop" | "remove-jsx-prop" | "set-class-name" | "add-class-token" | "remove-class-token" | "set-style-property" | "set-style-properties" | "set-css-module-class" | "set-directive" | "remove-directive" | "set-route-export" | "set-metadata-field" | "set-generate-metadata")[] | undefined;
+            }[];
+        } | undefined;
+    };
+    getObjectContentDetail(key: string, routeId?: string): {
+        key: string;
+        contentModel?: Record<string, unknown> | undefined;
+    };
+    getObjectMediaDetail(key: string, routeId?: string): {
+        key: string;
+        mediaModel?: Record<string, unknown> | undefined;
+    };
+    getClassNameSource(key: string, routeId?: string): {
+        key: string;
+        routeId: string;
+        filePath: string;
+        componentName: string;
+        sourceKind: "missing" | "expression" | "stringLiteral";
+        attrRaw: string | null;
+        valueRaw: string | null;
+        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;
+        }[];
+    };
+    setClassNameSource(request: Parameters<PreviewSiteEditEngineRuntime["setClassNameSource"]>[0]): Promise<{
+        ok: true;
+        source: {
+            key: string;
+            routeId: string;
+            filePath: string;
+            componentName: string;
+            sourceKind: "missing" | "expression" | "stringLiteral";
+            attrRaw: string | null;
+            valueRaw: string | null;
+            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;
+            }[];
+        };
+    } | {
+        ok: false;
+        reason: "node_not_found" | "document_version_stale" | "file_hash_mismatch" | "range_mismatch" | "old_attr_mismatch" | "invalid_new_attr" | "unsupported_target" | "write_failed";
+        diagnostics: {
+            code: "missing-class-name" | "unsupported-attribute-name" | "source-locator-warning" | "invalid-new-attr" | "version-conflict" | "write-failed";
+            message: string;
+        }[];
+        current?: {
+            key: string;
+            routeId: string;
+            filePath: string;
+            componentName: string;
+            sourceKind: "missing" | "expression" | "stringLiteral";
+            attrRaw: string | null;
+            valueRaw: string | null;
+            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;
+            }[];
+        } | undefined;
+    }>;
+    executeOperation(request: Parameters<PreviewSiteEditEngineRuntime["executeOperation"]>[0]): Promise<{
+        requestId: string;
+        kind: "update-text" | "remove-node" | "insert-child" | "move-node" | "replace-rich-text-content" | "insert-rich-text-block" | "remove-rich-text-block" | "set-media-field" | "set-component-slot-content" | "set-object-field" | "insert-object-field" | "remove-object-field" | "update-array-item" | "insert-array-item" | "remove-array-item" | "move-array-item" | "replace-conditional-expression" | "set-conditional-branch-content" | "set-jsx-prop" | "remove-jsx-prop" | "set-class-name" | "add-class-token" | "remove-class-token" | "set-style-property" | "set-style-properties" | "set-css-module-class" | "set-directive" | "remove-directive" | "set-route-export" | "set-metadata-field" | "set-generate-metadata";
+        target: {
+            kind: "node";
+            key: string;
+        } | {
+            kind: "route";
+            routeId: string;
+        };
+        ok: boolean;
+        resultVersion: number;
+        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";
+            message: string;
+            details?: Record<string, unknown> | undefined;
+        } | undefined;
+    }>;
+    undo(): Promise<{
+        requestId: string;
+        kind: "update-text" | "remove-node" | "insert-child" | "move-node" | "replace-rich-text-content" | "insert-rich-text-block" | "remove-rich-text-block" | "set-media-field" | "set-component-slot-content" | "set-object-field" | "insert-object-field" | "remove-object-field" | "update-array-item" | "insert-array-item" | "remove-array-item" | "move-array-item" | "replace-conditional-expression" | "set-conditional-branch-content" | "set-jsx-prop" | "remove-jsx-prop" | "set-class-name" | "add-class-token" | "remove-class-token" | "set-style-property" | "set-style-properties" | "set-css-module-class" | "set-directive" | "remove-directive" | "set-route-export" | "set-metadata-field" | "set-generate-metadata";
+        target: {
+            kind: "node";
+            key: string;
+        } | {
+            kind: "route";
+            routeId: string;
+        };
+        ok: boolean;
+        resultVersion: number;
+        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";
+            message: string;
+            details?: Record<string, unknown> | undefined;
+        } | undefined;
+    }>;
+    redo(): Promise<{
+        requestId: string;
+        kind: "update-text" | "remove-node" | "insert-child" | "move-node" | "replace-rich-text-content" | "insert-rich-text-block" | "remove-rich-text-block" | "set-media-field" | "set-component-slot-content" | "set-object-field" | "insert-object-field" | "remove-object-field" | "update-array-item" | "insert-array-item" | "remove-array-item" | "move-array-item" | "replace-conditional-expression" | "set-conditional-branch-content" | "set-jsx-prop" | "remove-jsx-prop" | "set-class-name" | "add-class-token" | "remove-class-token" | "set-style-property" | "set-style-properties" | "set-css-module-class" | "set-directive" | "remove-directive" | "set-route-export" | "set-metadata-field" | "set-generate-metadata";
+        target: {
+            kind: "node";
+            key: string;
+        } | {
+            kind: "route";
+            routeId: string;
+        };
+        ok: boolean;
+        resultVersion: number;
+        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";
+            message: string;
+            details?: Record<string, unknown> | undefined;
+        } | undefined;
+    }>;
+    notifyFileChanged(file: string): void;
+    subscribe(listener: Parameters<PreviewSiteEditEngineRuntime["subscribe"]>[0]): () => void;
+    dispose(): void;
+}
+export declare function createPreviewSiteEditEngineRuntime(options: PreviewSiteEditEngineRuntimeOptions): PreviewSiteEditEngineRuntime;

package/dist/preview-runtime.js

@@ -0,0 +1,102 @@
+import { toInternalOperationRequest, toSiteEditEvent, toSiteEditObjectContentDetail, toSiteEditObjectDetail, toSiteEditObjectEditContext, toSiteEditObjectMediaDetail, toSiteEditObjectStyleDetail, toSiteEditObjectSummary, toSiteEditOperationResult, toSiteEditRenderDocument, } from "./internal-adapter.js";
+import { createEditEngineRuntime } from "./internal/runtime.js";
+export class PreviewFileSystemSiteEditEngineRuntime {
+    constructor(options) {
+        this.options = options;
+        this.listeners = new Set();
+        this.engine = createEditEngineRuntime({
+            projectRoot: options.projectRoot,
+            fileSystem: options.fileSystem,
+            routes: options.routes.map((route) => ({
+                routeId: route.routeId,
+                entryFile: route.entryFile,
+            })),
+            onEvent: (event) => {
+                const siteEditEvent = toSiteEditEvent(event, {
+                    siteId: options.siteId,
+                    snapshotId: options.snapshotId,
+                });
+                if (siteEditEvent) {
+                    options.onEvent?.(siteEditEvent);
+                    for (const listener of this.listeners) {
+                        listener(siteEditEvent);
+                    }
+                }
+            },
+            dev: options.dev,
+        });
+    }
+    get status() {
+        return this.engine.status;
+    }
+    registerRoute(routeId, entryFile) {
+        this.engine.registerRoute(routeId, entryFile);
+    }
+    async setActiveRoute(routeId) {
+        await this.engine.setActiveRoute(routeId);
+    }
+    getDocument(routeId) {
+        return toSiteEditRenderDocument(this.engine.getDocument(routeId), {
+            siteId: this.options.siteId,
+            snapshotId: this.options.snapshotId,
+        });
+    }
+    getObjectCapabilities(key, routeId) {
+        const detail = toSiteEditObjectDetail(this.engine.getRenderDetail(key, routeId));
+        return {
+            key: detail.key,
+            canUpdateText: detail.capabilities.canUpdateText,
+            canInsertChild: detail.capabilities.canInsertChild,
+            canMove: detail.capabilities.canMove,
+            canRemove: detail.capabilities.canRemove,
+            boundaryKind: detail.boundaryKind,
+            isOpaque: detail.isOpaque,
+        };
+    }
+    getObjectSummary(key, routeId) {
+        return toSiteEditObjectSummary(this.engine.getRenderDetail(key, routeId));
+    }
+    getObjectEditContext(key, routeId) {
+        return toSiteEditObjectEditContext(this.engine.getRenderDetail(key, routeId));
+    }
+    getObjectStyleDetail(key, routeId) {
+        return toSiteEditObjectStyleDetail(this.engine.getRenderDetail(key, routeId));
+    }
+    getObjectContentDetail(key, routeId) {
+        return toSiteEditObjectContentDetail(this.engine.getRenderDetail(key, routeId));
+    }
+    getObjectMediaDetail(key, routeId) {
+        return toSiteEditObjectMediaDetail(this.engine.getRenderDetail(key, routeId));
+    }
+    getClassNameSource(key, routeId) {
+        return this.engine.getClassNameSource(key, routeId);
+    }
+    setClassNameSource(request) {
+        return this.engine.setClassNameSource(request);
+    }
+    async executeOperation(request) {
+        return toSiteEditOperationResult(await this.engine.execute(toInternalOperationRequest(request)));
+    }
+    async undo() {
+        return toSiteEditOperationResult(await this.engine.undo());
+    }
+    async redo() {
+        return toSiteEditOperationResult(await this.engine.redo());
+    }
+    notifyFileChanged(file) {
+        this.engine.notifyFileChanged(file);
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    dispose() {
+        this.listeners.clear();
+        this.engine.dispose();
+    }
+}
+export function createPreviewSiteEditEngineRuntime(options) {
+    return new PreviewFileSystemSiteEditEngineRuntime(options);
+}

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

@@ -0,0 +1,7 @@
+export interface SiteEditProjectFileSystem {
+    readFile(file: string): Promise<string>;
+    writeFile(file: string, content: string): Promise<void>;
+    exists(file: string): Promise<boolean>;
+    getVersion(file: string): number;
+    bumpVersion(file: string): number;
+}

package/dist/public-file-system.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime-sync.d.ts

@@ -0,0 +1,95 @@
+import type { SiteEditOperationRequest, SiteEditOperationResult, SiteEditOperationType, SiteEditRenderDocument } from "@trojanbox-vcp-test/contracts";
+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: {
+    readonly key: "data-vcp-edit-key";
+    readonly parentKey: "data-vcp-edit-parent-key";
+    readonly movable: "data-vcp-movable";
+    readonly removable: "data-vcp-removable";
+    readonly flags: "data-vcp-flags";
+};
+export type SiteEditRuntimeAttributes = {
+    readonly [key in keyof typeof SITE_EDIT_RUNTIME_ATTRIBUTES]: string;
+};
+export type SiteEditRenderDocumentDiff = {
+    added_keys: string[];
+    removed_keys: string[];
+    retained_keys: string[];
+    changed_parentKeys: string[];
+    changed_child_order_keys: string[];
+};
+export type SiteEditRuntimeElementSnapshot = {
+    key: string;
+    instance_index?: number;
+    instance_count?: number;
+    tag_name: string;
+    source_kind?: string;
+    componentName?: string;
+    sourceFile?: string;
+    parentKey?: string;
+    text_preview?: string;
+    attributes: Record<string, string>;
+    runtime_flags: {
+        editable: boolean;
+        movable: boolean;
+        removable: boolean;
+        text_editable: boolean;
+        container: boolean;
+    };
+};
+export type SiteEditRuntimeElementRef = {
+    key: string;
+    instance_index?: number;
+    instance_count?: number;
+};
+export type SiteEditQueryDocument = Pick<Document, "querySelector"> & Partial<Pick<Document, "querySelectorAll">>;
+export type SiteEditRuntimeReadySuccess = {
+    ok: true;
+    version: number;
+    observed_keys: string[];
+    check: string;
+};
+export type SiteEditRuntimeReadyFailure = {
+    ok: false;
+    version: number;
+    reason: "missing-root" | "missing-target" | "removed-target-still-present" | "missing-added-key" | "missing-selected-key" | "text-mismatch" | "order-mismatch" | "unsupported-operation" | "timeout";
+    check: string;
+    message: string;
+    observed_keys?: string[];
+};
+export type SiteEditRuntimeReadyResult = SiteEditRuntimeReadySuccess | SiteEditRuntimeReadyFailure;
+export type SiteEditRuntimeReadyInput = {
+    routeId: string;
+    previous_document: SiteEditRenderDocument;
+    next_document: SiteEditRenderDocument;
+    request?: SiteEditOperationRequest;
+    result: SiteEditOperationResult;
+    selected_key?: string | null;
+    timeout_ms?: number;
+};
+export declare function diffSiteEditRenderDocuments(previous_document: SiteEditRenderDocument, next_document: SiteEditRenderDocument): SiteEditRenderDocumentDiff;
+export declare function isSiteEditRuntimeSyncedOperation(kind: SiteEditOperationType): boolean;
+export declare class SiteEditRuntimeDomAdapter {
+    private readonly documentLike;
+    private readonly attributes;
+    constructor(documentLike?: SiteEditQueryDocument | null, attributes?: SiteEditRuntimeAttributes);
+    getKeyFromElement(element: Element): string | null;
+    findEditableElement(element: Element | null): Element | null;
+    findElementByKey(key: string): Element | null;
+    findElementByRef(ref: SiteEditRuntimeElementRef): Element | null;
+    snapshot(element: Element): SiteEditRuntimeElementSnapshot;
+    private resolveInstancePosition;
+}
+export declare class SiteEditRuntimeReadyProbe {
+    private readonly dom;
+    constructor(documentLike: SiteEditQueryDocument, attributes?: SiteEditRuntimeAttributes);
+    probe(input: SiteEditRuntimeReadyInput, diff?: SiteEditRenderDocumentDiff): SiteEditRuntimeReadyResult;
+    private checkOperationProjection;
+    private checkTextProjection;
+    private checkMovedNodeProjection;
+    private checkGenericDiffProjection;
+    private checkAddedKeys;
+    private isChildOrderReady;
+}
+export declare function getSiteEditNodeTargetKey(input?: Pick<SiteEditOperationRequest | SiteEditOperationResult, "target">): string | null;
+export declare function hasSiteEditDocumentKey(document: SiteEditRenderDocument, key: string): boolean;