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

package/dist/internal/runtime/EditEngineRuntime.d.ts

@@ -0,0 +1,25 @@
+import type { SiteEditGetClassNameSourceResult, SiteEditObjectCapabilities, SiteEditSetClassNameSourceRequest, SiteEditSetClassNameSourceResult } from "@trojanbox-vcp-test/contracts";
+import type { DesignerEvent, OperationRequest, OperationResult, RenderDocument, RenderObjectDetail } from "../protocol.js";
+import type { IEditEngineRuntime } from "../contracts/IEditEngineRuntime.js";
+import type { EditEngineRuntimeOptions } from "./EditEngineRuntimeSnapshot.js";
+export declare class EditEngineRuntime implements IEditEngineRuntime {
+    private readonly engine;
+    private readonly options;
+    constructor(options: EditEngineRuntimeOptions);
+    get status(): IEditEngineRuntime["status"];
+    registerRoute(routeId: string, entryFile: string): void;
+    setActiveRoute(routeId: string): Promise<void>;
+    getDocument(routeId: string): RenderDocument;
+    getObjectCapabilities(key: string, routeId?: string): SiteEditObjectCapabilities;
+    getRenderDetail(key: string, routeId?: string): RenderObjectDetail;
+    getClassNameSource(key: string, routeId?: string): SiteEditGetClassNameSourceResult;
+    setClassNameSource(request: SiteEditSetClassNameSourceRequest): Promise<SiteEditSetClassNameSourceResult>;
+    execute(request: OperationRequest): Promise<OperationResult>;
+    undo(): Promise<OperationResult>;
+    redo(): Promise<OperationResult>;
+    notifyFileChanged(file: string): void;
+    subscribe(listener: (event: DesignerEvent) => void): () => void;
+    dispose(): void;
+    private createFileSystem;
+}
+export declare function createEditEngineRuntime(options: EditEngineRuntimeOptions): IEditEngineRuntime;

package/dist/internal/runtime/EditEngineRuntime.js

@@ -0,0 +1,89 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { createInternalEditEngine, } from "./InternalEditEngine.js";
+export class EditEngineRuntime {
+    constructor(options) {
+        this.options = options;
+        this.engine = createInternalEditEngine({
+            ...options,
+            fileSystem: this.createFileSystem(),
+        });
+    }
+    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 this.engine.getDocument(routeId);
+    }
+    getObjectCapabilities(key, routeId) {
+        return this.engine.getObjectCapabilities(key, routeId);
+    }
+    getRenderDetail(key, routeId) {
+        return this.engine.getRenderDetail(key, routeId);
+    }
+    getClassNameSource(key, routeId) {
+        return this.engine.getClassNameSource(key, routeId);
+    }
+    setClassNameSource(request) {
+        return this.engine.setClassNameSource(request);
+    }
+    execute(request) {
+        return this.engine.execute(request);
+    }
+    undo() {
+        return this.engine.undo();
+    }
+    redo() {
+        return this.engine.redo();
+    }
+    notifyFileChanged(file) {
+        this.engine.notifyFileChanged(file);
+    }
+    subscribe(listener) {
+        return this.engine.subscribe(listener);
+    }
+    dispose() {
+        this.engine.dispose();
+    }
+    createFileSystem() {
+        if (this.options.fileSystem) {
+            return this.options.fileSystem;
+        }
+        const versions = new Map();
+        const { projectRoot } = this.options;
+        return {
+            async readFile(file) {
+                return fs.readFile(path.join(projectRoot, file), "utf8");
+            },
+            async writeFile(file, content) {
+                await fs.writeFile(path.join(projectRoot, file), content, "utf8");
+            },
+            async exists(file) {
+                try {
+                    await fs.access(path.join(projectRoot, file));
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            },
+            getVersion(file) {
+                return versions.get(file) ?? 0;
+            },
+            bumpVersion(file) {
+                const nextVersion = (versions.get(file) ?? 0) + 1;
+                versions.set(file, nextVersion);
+                return nextVersion;
+            },
+        };
+    }
+}
+export function createEditEngineRuntime(options) {
+    return new EditEngineRuntime(options);
+}

package/dist/internal/runtime/EditEngineRuntimeSnapshot.d.ts

@@ -0,0 +1,31 @@
+import type { DesignerEvent, RenderDocument, RenderObjectDetail } from "../protocol.js";
+import type { ExternalSourceResolver, FunctionCallContract } from "../provenance/types.js";
+import type { ProjectFileSystem } from "../types.js";
+import type { ExternalWritebackAdapter } from "../writeback/types.js";
+export type { ExternalSourceResolver, FunctionCallContract, } from "../provenance/types.js";
+export type { ProjectFileSystem } from "../types.js";
+export type { ExternalWritebackAdapter } from "../writeback/types.js";
+export type RuntimeRouteConfig = {
+    routeId: string;
+    entryFile: string;
+};
+export type EditEngineRuntimeOptions = {
+    projectRoot: string;
+    fileSystem?: ProjectFileSystem;
+    externalAdapters?: ExternalWritebackAdapter[];
+    externalSourceResolvers?: ExternalSourceResolver[];
+    functionCallContracts?: FunctionCallContract[];
+    onEvent?: (event: DesignerEvent) => void;
+    dev?: boolean;
+    routes: RuntimeRouteConfig[];
+};
+export declare class EditEngineRuntimeSnapshot {
+    readonly routeId: string;
+    readonly initialDocument: RenderDocument;
+    readonly initialDetails: Record<string, RenderObjectDetail>;
+    constructor(routeId: string, initialDocument: RenderDocument, initialDetails: Record<string, RenderObjectDetail>);
+    static capture(routeId: string, runtime: Pick<{
+        getDocument(routeId: string): RenderDocument;
+        getRenderDetail(key: string): RenderObjectDetail;
+    }, "getDocument" | "getRenderDetail">): EditEngineRuntimeSnapshot;
+}

package/dist/internal/runtime/EditEngineRuntimeSnapshot.js

@@ -0,0 +1,15 @@
+export class EditEngineRuntimeSnapshot {
+    constructor(routeId, initialDocument, initialDetails) {
+        this.routeId = routeId;
+        this.initialDocument = initialDocument;
+        this.initialDetails = initialDetails;
+    }
+    static capture(routeId, runtime) {
+        const initialDocument = runtime.getDocument(routeId);
+        const initialDetails = Object.fromEntries(initialDocument.entries.map((entry) => [
+            entry.key,
+            runtime.getRenderDetail(entry.key),
+        ]));
+        return new EditEngineRuntimeSnapshot(routeId, initialDocument, initialDetails);
+    }
+}

package/dist/internal/runtime/InternalEditEngine.d.ts

@@ -0,0 +1,44 @@
+import type { SiteEditGetClassNameSourceResult, SiteEditObjectCapabilities, SiteEditSetClassNameSourceRequest, SiteEditSetClassNameSourceResult } from "@trojanbox-vcp-test/contracts";
+import type { RenderDocument, RenderObjectDetail, OperationRequest, OperationResult, DesignerEvent } from "../protocol.js";
+import type { ProjectFileSystem } from "./EditEngineRuntimeSnapshot.js";
+import type { ExternalSourceResolver, FunctionCallContract } from "../provenance/types.js";
+import type { ExternalWritebackAdapter } from "../writeback/types.js";
+/**
+ * Engine 配置。
+ */
+export interface InternalEditEngineConfig {
+    projectRoot: string;
+    routes?: Array<{
+        routeId: string;
+        entryFile: string;
+    }>;
+    fileSystem?: ProjectFileSystem;
+    externalAdapters?: ExternalWritebackAdapter[];
+    externalSourceResolvers?: ExternalSourceResolver[];
+    functionCallContracts?: FunctionCallContract[];
+    onEvent?: (event: DesignerEvent) => void;
+    dev?: boolean;
+}
+/**
+ * DesignerEngine —— 核心引擎接口。
+ */
+export interface InternalEditEngine {
+    readonly status: "idle" | "building" | "ready" | "disposed";
+    dispose(): void;
+    registerRoute(routeId: string, entryFile: string): void;
+    setActiveRoute(routeId: string): Promise<void>;
+    getDocument(routeId: string): RenderDocument;
+    getObjectCapabilities(key: string, routeId?: string): SiteEditObjectCapabilities;
+    getRenderDetail(key: string, routeId?: string): RenderObjectDetail;
+    getClassNameSource(key: string, routeId?: string): SiteEditGetClassNameSourceResult;
+    setClassNameSource(request: SiteEditSetClassNameSourceRequest): Promise<SiteEditSetClassNameSourceResult>;
+    execute(request: OperationRequest): Promise<OperationResult>;
+    undo(): Promise<OperationResult>;
+    redo(): Promise<OperationResult>;
+    notifyFileChanged(file: string): void;
+    subscribe(listener: (event: DesignerEvent) => void): () => void;
+}
+/**
+ * 创建 DesignerEngine 实例。
+ */
+export declare function createInternalEditEngine(config: InternalEditEngineConfig): InternalEditEngine;