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

package/dist/runtime-sync.js

@@ -0,0 +1,321 @@
+export const DEFAULT_SITE_EDIT_RUNTIME_READY_TIMEOUT_MS = 1500;
+export const SITE_EDIT_RUNTIME_READY_POLL_INTERVAL_MS = 16;
+export const SITE_EDIT_RUNTIME_ATTRIBUTES = {
+    key: "data-vcp-edit-key",
+    parentKey: "data-vcp-edit-parent-key",
+    movable: "data-vcp-movable",
+    removable: "data-vcp-removable",
+    flags: "data-vcp-flags",
+};
+const CONTAINER_TAGS = new Set([
+    "article",
+    "aside",
+    "div",
+    "footer",
+    "form",
+    "header",
+    "li",
+    "main",
+    "nav",
+    "ol",
+    "section",
+    "ul",
+]);
+const TEXT_TAGS = new Set([
+    "a",
+    "button",
+    "em",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "label",
+    "p",
+    "small",
+    "span",
+    "strong",
+]);
+const STRONG_SYNC_OPERATION_KINDS = new Set([
+    "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",
+]);
+export function diffSiteEditRenderDocuments(previous_document, next_document) {
+    const previousEntries = new Map(previous_document.entries.map((entry) => [entry.key, entry]));
+    const nextEntries = new Map(next_document.entries.map((entry) => [entry.key, entry]));
+    const added_keys = next_document.entries
+        .map((entry) => entry.key)
+        .filter((key) => !previousEntries.has(key));
+    const removed_keys = previous_document.entries
+        .map((entry) => entry.key)
+        .filter((key) => !nextEntries.has(key));
+    const retained_keys = next_document.entries
+        .map((entry) => entry.key)
+        .filter((key) => previousEntries.has(key));
+    const changed_parentKeys = retained_keys.filter((key) => previousEntries.get(key)?.parentKey !== nextEntries.get(key)?.parentKey);
+    const changed_child_order_keys = retained_keys.filter((key) => {
+        const previousChildren = previousEntries.get(key)?.childKeys ?? [];
+        const nextChildren = nextEntries.get(key)?.childKeys ?? [];
+        return previousChildren.join("\u0000") !== nextChildren.join("\u0000");
+    });
+    return {
+        added_keys,
+        removed_keys,
+        retained_keys,
+        changed_parentKeys,
+        changed_child_order_keys,
+    };
+}
+export function isSiteEditRuntimeSyncedOperation(kind) {
+    return STRONG_SYNC_OPERATION_KINDS.has(kind);
+}
+export class SiteEditRuntimeDomAdapter {
+    constructor(documentLike, attributes = SITE_EDIT_RUNTIME_ATTRIBUTES) {
+        this.documentLike = documentLike;
+        this.attributes = attributes;
+    }
+    getKeyFromElement(element) {
+        return element.getAttribute(this.attributes.key);
+    }
+    findEditableElement(element) {
+        return element?.closest(`[${this.attributes.key}]`) ?? null;
+    }
+    findElementByKey(key) {
+        return (this.documentLike?.querySelector(`[${this.attributes.key}="${escapeAttributeValue(key)}"]`) ?? null);
+    }
+    findElementByRef(ref) {
+        if (typeof ref.instance_index !== "number" ||
+            typeof ref.instance_count !== "number" ||
+            ref.instance_count <= 1 ||
+            !this.documentLike?.querySelectorAll) {
+            return this.findElementByKey(ref.key);
+        }
+        const matches = Array.from(this.documentLike.querySelectorAll(`[${this.attributes.key}]`)).filter((item) => item.getAttribute(this.attributes.key) === ref.key);
+        return matches[ref.instance_index] ?? null;
+    }
+    snapshot(element) {
+        const attributes = Object.fromEntries(element
+            .getAttributeNames()
+            .map((name) => [name, element.getAttribute(name) ?? ""]));
+        const key = element.getAttribute(this.attributes.key) ?? "";
+        const tagName = element.tagName.toLowerCase();
+        const textPreview = element.textContent?.trim().slice(0, 80);
+        const snapshot = {
+            key,
+            tag_name: tagName,
+            attributes,
+            runtime_flags: {
+                editable: true,
+                movable: element.getAttribute(this.attributes.movable) !== "false",
+                removable: element.getAttribute(this.attributes.removable) !== "false",
+                text_editable: TEXT_TAGS.has(tagName),
+                container: CONTAINER_TAGS.has(tagName),
+            },
+        };
+        const instancePosition = this.resolveInstancePosition(element, key);
+        if (instancePosition) {
+            snapshot.instance_index = instancePosition.index;
+            snapshot.instance_count = instancePosition.count;
+        }
+        if (textPreview !== undefined) {
+            snapshot.text_preview = textPreview;
+        }
+        return snapshot;
+    }
+    resolveInstancePosition(element, key) {
+        if (!key || !this.documentLike?.querySelectorAll) {
+            return null;
+        }
+        const matches = Array.from(this.documentLike.querySelectorAll(`[${this.attributes.key}]`)).filter((item) => item.getAttribute(this.attributes.key) === key);
+        if (matches.length <= 1) {
+            return null;
+        }
+        const index = matches.indexOf(element);
+        if (index < 0) {
+            return null;
+        }
+        return {
+            count: matches.length,
+            index,
+        };
+    }
+}
+export class SiteEditRuntimeReadyProbe {
+    constructor(documentLike, attributes = SITE_EDIT_RUNTIME_ATTRIBUTES) {
+        this.dom = new SiteEditRuntimeDomAdapter(documentLike, attributes);
+    }
+    probe(input, diff = diffSiteEditRenderDocuments(input.previous_document, input.next_document)) {
+        const rootKeys = input.next_document.rootKeys.length > 0
+            ? input.next_document.rootKeys
+            : input.next_document.entries.slice(0, 1).map((entry) => entry.key);
+        const missingRoot = rootKeys.find((key) => !this.dom.findElementByKey(key));
+        if (missingRoot) {
+            return failure(input, "missing-root", "document-root", `preview root is missing: ${missingRoot}`);
+        }
+        if (input.selected_key &&
+            hasDocumentKey(input.next_document, input.selected_key) &&
+            !this.dom.findElementByKey(input.selected_key)) {
+            return failure(input, "missing-selected-key", "selected-node", `selected node is missing from preview DOM: ${input.selected_key}`);
+        }
+        const kind = input.request?.kind ?? input.result.kind;
+        if (!isSiteEditRuntimeSyncedOperation(kind)) {
+            return failure(input, "unsupported-operation", "operation-specific", `runtime ready check is not implemented for ${kind}`);
+        }
+        return this.checkOperationProjection(input, diff);
+    }
+    checkOperationProjection(input, diff) {
+        const kind = input.request?.kind ?? input.result.kind;
+        const targetKey = getNodeTargetKey(input.request) ?? getNodeTargetKey(input.result);
+        if (kind === "update-text" &&
+            input.request?.params.kind === "update-text") {
+            return this.checkTextProjection(input, targetKey);
+        }
+        if (kind === "remove-node" &&
+            targetKey &&
+            !hasDocumentKey(input.next_document, targetKey)) {
+            if (this.dom.findElementByKey(targetKey)) {
+                return failure(input, "removed-target-still-present", "removed-node", `removed node is still present in preview DOM: ${targetKey}`);
+            }
+            return this.checkGenericDiffProjection(input, diff, "removed-node");
+        }
+        if (kind === "insert-child") {
+            const addedResult = this.checkAddedKeys(input, diff, "inserted-node");
+            return addedResult.ok
+                ? this.checkGenericDiffProjection(input, diff, "inserted-node")
+                : addedResult;
+        }
+        if (kind === "move-node") {
+            return this.checkMovedNodeProjection(input, diff, targetKey);
+        }
+        return this.checkGenericDiffProjection(input, diff, "document-diff");
+    }
+    checkTextProjection(input, targetKey) {
+        if (!targetKey) {
+            return failure(input, "missing-target", "text-content", "update-text target key is missing");
+        }
+        const target = this.dom.findElementByKey(targetKey);
+        if (!target) {
+            return failure(input, "missing-target", "text-content", `update-text target is missing: ${targetKey}`);
+        }
+        const actualText = normalizeText(target.textContent ?? "");
+        const params = input.request?.params;
+        const expectedText = normalizeText(params?.kind === "update-text" ? params.value : "");
+        if (actualText !== expectedText) {
+            return failure(input, "text-mismatch", "text-content", `preview text has not updated for ${targetKey}`);
+        }
+        return success(input, "text-content", [targetKey]);
+    }
+    checkMovedNodeProjection(input, diff, targetKey) {
+        if (targetKey && !this.dom.findElementByKey(targetKey)) {
+            return failure(input, "missing-target", "moved-node", `moved node is missing: ${targetKey}`);
+        }
+        for (const parentKey of diff.changed_child_order_keys) {
+            const parent = input.next_document.entries.find((entry) => entry.key === parentKey);
+            if (!parent || !this.isChildOrderReady(parent.childKeys)) {
+                return failure(input, "order-mismatch", "child-order", `child order is not ready for ${parentKey}`);
+            }
+        }
+        return this.checkGenericDiffProjection(input, diff, "moved-node");
+    }
+    checkGenericDiffProjection(input, diff, check) {
+        const addedResult = this.checkAddedKeys(input, diff, check);
+        if (!addedResult.ok) {
+            return addedResult;
+        }
+        const presentRemovedKey = diff.removed_keys.find((key) => this.dom.findElementByKey(key));
+        if (presentRemovedKey) {
+            return failure(input, "removed-target-still-present", check, `removed node is still present in preview DOM: ${presentRemovedKey}`);
+        }
+        return success(input, check, [
+            ...input.next_document.rootKeys,
+            ...diff.added_keys,
+            ...diff.changed_parentKeys,
+            ...diff.changed_child_order_keys,
+        ]);
+    }
+    checkAddedKeys(input, diff, check) {
+        const missingAddedKey = diff.added_keys.find((key) => !this.dom.findElementByKey(key));
+        if (missingAddedKey) {
+            return failure(input, "missing-added-key", check, `added node is missing from preview DOM: ${missingAddedKey}`);
+        }
+        return success(input, check, diff.added_keys);
+    }
+    isChildOrderReady(childKeys) {
+        const elements = childKeys
+            .map((key) => this.dom.findElementByKey(key))
+            .filter((element) => Boolean(element));
+        if (elements.length < 2) {
+            return elements.length === childKeys.length;
+        }
+        for (let index = 1; index < elements.length; index += 1) {
+            const previous = elements[index - 1];
+            const current = elements[index];
+            if (previous &&
+                current &&
+                (previous.compareDocumentPosition(current) & 4) === 0) {
+                return false;
+            }
+        }
+        return elements.length === childKeys.length;
+    }
+}
+export function getSiteEditNodeTargetKey(input) {
+    return getNodeTargetKey(input);
+}
+export function hasSiteEditDocumentKey(document, key) {
+    return hasDocumentKey(document, key);
+}
+function getNodeTargetKey(input) {
+    return input?.target.kind === "node" ? input.target.key : null;
+}
+function hasDocumentKey(document, key) {
+    return document.entries.some((entry) => entry.key === key);
+}
+function normalizeText(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+function success(input, check, observed_keys) {
+    return {
+        ok: true,
+        version: input.next_document.version,
+        observed_keys: [...new Set(observed_keys.filter(Boolean))],
+        check,
+    };
+}
+function failure(input, reason, check, message) {
+    return {
+        ok: false,
+        version: input.next_document.version,
+        reason,
+        check,
+        message,
+    };
+}
+function escapeAttributeValue(value) {
+    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}

package/dist/runtime.d.ts

@@ -0,0 +1,340 @@
+import type { SiteEditEngineRuntime, SiteEditEngineRuntimeOptions, SiteEditPlanOperationResult } from "./types.js";
+export declare class SnapshotSiteEditEngineRuntime implements SiteEditEngineRuntime {
+    private readonly options;
+    private readonly engine;
+    private readonly fileSystem;
+    constructor(options: SiteEditEngineRuntimeOptions);
+    get status(): SiteEditEngineRuntime["status"];
+    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<SiteEditEngineRuntime["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;
+    }>;
+    planOperation(request: Parameters<SiteEditEngineRuntime["planOperation"]>[0]): Promise<SiteEditPlanOperationResult>;
+    dispose(): void;
+    private createEngine;
+    private getChangedRouteIds;
+}
+export declare function createSiteEditEngineRuntime(options: SiteEditEngineRuntimeOptions): SiteEditEngineRuntime;