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

package/dist/internal/graph/import-resolver.d.ts

@@ -1,31 +0,0 @@
-import * as t from "@babel/types";
-/**
- * 从源文件中提取所有本地 import 路径。
- * 不做路径解析，只返回原始 specifier。
- */
-export declare function extractLocalImports(source: string): string[];
-export declare function extractLocalImportsFromAst(ast: t.File): string[];
-export declare function isLocalProjectSpecifier(specifier: string): boolean;
-/**
- * 将 import specifier 解析为相对于 fromFile 的完整路径（不含扩展名）。
- * 返回已规范化但不含扩展名的路径字符串。
- *
- * 例：
- *   fromFile = 'src/page.tsx', specifier = '../components/Card'
- *   → 'components/Card'
- */
-export declare function resolveImportBase(fromFile: string, specifier: string): string;
-/**
- * 给定一个无扩展路径（如 'components/Card'），通过 `exists` 探测
- * 实际存在的文件路径，返回第一个匹配的路径，或 null。
- *
- * 探测顺序：
- *   1. 直接加扩展名 (.tsx, .ts, .jsx, .js)
- *   2. 当作目录，探测 /index.tsx 等
- */
-export declare function resolveFile(basePath: string, exists: (path: string) => Promise<boolean>): Promise<string | null>;
-/**
- * 从 fromFile 解析并定位 specifier 对应的真实文件路径。
- * 返回 resolved 文件路径，或 null（文件不存在）。
- */
-export declare function resolveLocalImport(fromFile: string, specifier: string, exists: (path: string) => Promise<boolean>): Promise<string | null>;

package/dist/internal/graph/import-resolver.js

@@ -1,109 +0,0 @@
-// ─── Import Resolver ─────────────────────────────────
-// 从源文件 AST 中提取本地 import，并将其解析为真实文件路径。
-// 支持相对路径和 Next.js 常见 project-root alias `@/`，跳过 node_modules。
-import * as parser from "@babel/parser";
-import * as t from "@babel/types";
-import * as nodePath from "node:path";
-// ── Constants ──
-const EXTENSIONS = [".tsx", ".ts", ".jsx", ".js"];
-const INDEX_SUFFIXES = EXTENSIONS.map((ext) => `${nodePath.sep === "\\" ? "\\" : "/"}index${ext}`);
-// ── Extract local import specifiers from source ──
-/**
- * 从源文件中提取所有本地 import 路径。
- * 不做路径解析，只返回原始 specifier。
- */
-export function extractLocalImports(source) {
-    let ast = null;
-    try {
-        ast = parser.parse(source, {
-            sourceType: "module",
-            plugins: ["jsx", "typescript"],
-        });
-    }
-    catch {
-        return [];
-    }
-    return extractLocalImportsFromAst(ast);
-}
-export function extractLocalImportsFromAst(ast) {
-    const specifiers = [];
-    for (const node of ast.program.body) {
-        // import ... from '...'
-        if (t.isImportDeclaration(node) &&
-            typeof node.source.value === "string" &&
-            isLocalProjectSpecifier(node.source.value)) {
-            specifiers.push(node.source.value);
-        }
-        // export { ... } from '...'
-        if (t.isExportNamedDeclaration(node) &&
-            node.source &&
-            typeof node.source.value === "string" &&
-            isLocalProjectSpecifier(node.source.value)) {
-            specifiers.push(node.source.value);
-        }
-        // export * from '...'
-        if (t.isExportAllDeclaration(node) &&
-            typeof node.source.value === "string" &&
-            isLocalProjectSpecifier(node.source.value)) {
-            specifiers.push(node.source.value);
-        }
-    }
-    return specifiers;
-}
-export function isLocalProjectSpecifier(specifier) {
-    return (specifier.startsWith("./") ||
-        specifier.startsWith("../") ||
-        specifier.startsWith("@/"));
-}
-// ── Resolve import specifier relative to a file ──
-/**
- * 将 import specifier 解析为相对于 fromFile 的完整路径（不含扩展名）。
- * 返回已规范化但不含扩展名的路径字符串。
- *
- * 例：
- *   fromFile = 'src/page.tsx', specifier = '../components/Card'
- *   → 'components/Card'
- */
-export function resolveImportBase(fromFile, specifier) {
-    if (specifier.startsWith("@/")) {
-        return specifier.slice(2).replace(/\\/g, "/");
-    }
-    const dir = nodePath.dirname(fromFile);
-    // Use POSIX join for consistency with forward-slash paths used in the engine
-    const joined = nodePath.join(dir, specifier);
-    // Normalize away any .. / . segments; use forward slashes for consistency
-    return joined.replace(/\\/g, "/");
-}
-// ── Resolve to actual file path with extension ──
-/**
- * 给定一个无扩展路径（如 'components/Card'），通过 `exists` 探测
- * 实际存在的文件路径，返回第一个匹配的路径，或 null。
- *
- * 探测顺序：
- *   1. 直接加扩展名 (.tsx, .ts, .jsx, .js)
- *   2. 当作目录，探测 /index.tsx 等
- */
-export async function resolveFile(basePath, exists) {
-    // 1. Try direct extensions
-    for (const ext of EXTENSIONS) {
-        const candidate = `${basePath}${ext}`;
-        if (await exists(candidate))
-            return candidate;
-    }
-    // 2. Try index variants
-    for (const suffix of INDEX_SUFFIXES) {
-        const candidate = `${basePath}${suffix}`;
-        if (await exists(candidate))
-            return candidate;
-    }
-    return null;
-}
-// ── Combined helper ──
-/**
- * 从 fromFile 解析并定位 specifier 对应的真实文件路径。
- * 返回 resolved 文件路径，或 null（文件不存在）。
- */
-export async function resolveLocalImport(fromFile, specifier, exists) {
-    const base = resolveImportBase(fromFile, specifier);
-    return resolveFile(base, exists);
-}

package/dist/internal/graph/project-graph-builder.d.ts

@@ -1,32 +0,0 @@
-import type { RenderSourceGraph } from "./types.js";
-/**
- * 多文件构建结果：
- * - graph: 合并后的 RenderSourceGraph（多文件 fileIndex）
- * - allSources: 本次加载的所有文件源码（供 engine 更新缓存用）
- */
-export interface MultiFileGraphResult {
-    graph: RenderSourceGraph;
-    /** 所有参与构建的文件源码，key = 文件路径 */
-    allSources: Map<string, string>;
-}
-export interface MultiFileGraphOptions {
-    /** 递归最大深度，默认 10 */
-    maxDepth?: number;
-    /** 目标 graph 版本号，默认 1 */
-    version?: number;
-    /** Additional entry files that are rendered with the primary route entry. */
-    additionalEntries?: Array<{
-        file: string;
-        source: string;
-    }>;
-}
-/**
- * 构建多文件 RenderSourceGraph。
- *
- * @param entryFile   入口文件路径（例如 'src/app/page.tsx'）
- * @param entrySource 入口文件源码（已预先读取，避免重复 IO）
- * @param readFile    读取文件内容（async）
- * @param exists      判断文件是否存在（async）
- * @param opts        可选配置
- */
-export declare function buildMultiFileRenderGraph(entryFile: string, entrySource: string, readFile: (path: string) => Promise<string>, exists: (path: string) => Promise<boolean>, opts?: MultiFileGraphOptions): Promise<MultiFileGraphResult>;

package/dist/internal/graph/project-graph-builder.js

@@ -1,133 +0,0 @@
-// ─── Project Graph Builder ───────────────────────────
-// 基于 import 递归构建多文件 ProjectSourceGraph。
-// 核心职责：
-//   1. 从入口文件出发，提取本地 import
-//   2. 递归加载并解析已导入文件
-//   3. 将所有单文件 graph 合并为完整的 RenderSourceGraph
-//      （多文件 fileIndex、全量 elements/regions）
-//
-// 注意：
-//   - 本阶段 isOpaque 保持 true（组件边界仍然不透明）
-//   - rootKeys 只含 entryFile 的根节点
-//   - 后续 Step 5 会补 importSource / transparent component 能力
-import { buildGraphWithLocalImportsFromSource } from "./graph-builder.js";
-import { isLocalProjectSpecifier, resolveLocalImport, } from "./import-resolver.js";
-// ── Main entry ──
-/**
- * 构建多文件 RenderSourceGraph。
- *
- * @param entryFile   入口文件路径（例如 'src/app/page.tsx'）
- * @param entrySource 入口文件源码（已预先读取，避免重复 IO）
- * @param readFile    读取文件内容（async）
- * @param exists      判断文件是否存在（async）
- * @param opts        可选配置
- */
-export async function buildMultiFileRenderGraph(entryFile, entrySource, readFile, exists, opts = {}) {
-    const maxDepth = opts.maxDepth ?? 10;
-    const version = opts.version ?? 1;
-    // ── State ──
-    const allSources = new Map();
-    const singleFileGraphs = new Map();
-    const queue = [
-        { file: entryFile, source: entrySource, depth: 0 },
-        ...(opts.additionalEntries ?? []).map((entry) => ({
-            file: entry.file,
-            source: entry.source,
-            depth: 0,
-        })),
-    ];
-    const visited = new Set();
-    while (queue.length > 0) {
-        const entry = queue.shift();
-        const { file, source, depth } = entry;
-        if (visited.has(file))
-            continue;
-        visited.add(file);
-        allSources.set(file, source);
-        // Build single-file graph
-        const { graph: fileGraph, localImports } = buildGraphWithLocalImportsFromSource(file, source);
-        // Resolve importedFrom raw specifiers to actual file paths for component nodes.
-        // At this point we have the exists callback available, so we can do it here.
-        for (const element of fileGraph.elements.values()) {
-            if (element.importedFrom &&
-                isLocalProjectSpecifier(element.importedFrom)) {
-                try {
-                    const resolved = await resolveLocalImport(file, element.importedFrom, exists);
-                    if (resolved) {
-                        element.importedFrom = resolved;
-                    }
-                }
-                catch {
-                    // Leave as raw specifier if resolution fails
-                }
-            }
-        }
-        singleFileGraphs.set(file, fileGraph);
-        // Stop recursing at maxDepth
-        if (depth >= maxDepth)
-            continue;
-        // Extract and resolve relative imports
-        for (const spec of localImports) {
-            try {
-                const resolvedFile = await resolveLocalImport(file, spec, exists);
-                if (!resolvedFile || visited.has(resolvedFile))
-                    continue;
-                const importedSource = await readFile(resolvedFile);
-                queue.push({
-                    file: resolvedFile,
-                    source: importedSource,
-                    depth: depth + 1,
-                });
-            }
-            catch {
-                // Silently skip files that can't be read
-            }
-        }
-    }
-    // ── Merge all single-file graphs ──
-    const merged = mergeGraphs(entryFile, singleFileGraphs, version, (opts.additionalEntries ?? []).map((entry) => entry.file));
-    return { graph: merged, allSources };
-}
-// ── Merge helper ──
-/**
- * 将多个单文件 graph 合并为一个 RenderSourceGraph。
- * - rootKeys: 来自 entryFile 的图
- * - elements / regions / fileIndex: 所有文件合并
- */
-function mergeGraphs(entryFile, graphs, version, additionalRootFiles = []) {
-    const elements = new Map();
-    const regions = [];
-    const fileIndex = new Map();
-    let rootKeys = [];
-    for (const [file, graph] of graphs) {
-        // Merge elements
-        for (const [key, node] of graph.elements) {
-            elements.set(key, node);
-        }
-        // Merge regions
-        for (const region of graph.regions) {
-            regions.push(region);
-        }
-        // Merge fileIndex
-        for (const [indexFile, keys] of graph.fileIndex) {
-            const existing = fileIndex.get(indexFile) ?? [];
-            fileIndex.set(indexFile, [...existing, ...keys]);
-        }
-        // Use entry file's rootKeys
-        if (file === entryFile) {
-            rootKeys = graph.rootKeys;
-            continue;
-        }
-        if (additionalRootFiles.includes(file)) {
-            rootKeys = [...rootKeys, ...graph.rootKeys];
-        }
-    }
-    return {
-        routeId: entryFile,
-        rootKeys,
-        elements,
-        regions,
-        fileIndex,
-        version,
-    };
-}

package/dist/internal/graph/types.d.ts

@@ -1,114 +0,0 @@
-import type { SourceIdentity } from "../protocol.js";
-import type { BoundaryKind } from "../protocol.js";
-export interface SourceRange {
-    startLine: number;
-    startColumn: number;
-    endLine: number;
-    endColumn: number;
-}
-/**
- * 元素节点 —— 对应 JSX 元素 / 组件调用。
- */
-export interface ElementNode {
-    identity: SourceIdentity;
-    tag: string;
-    componentName: string;
-    sourceFile: string;
-    sourceRange: SourceRange;
-    parentKey: string | null;
-    childKeys: string[];
-    textSegments: TextSegment[];
-    attributes?: AttributeSource[];
-    boundaryKind: BoundaryKind | null;
-    isOpaque: boolean;
-    /**
-     * 组件来源文件（已解析路径，相对 projectRoot 或绝对路径）。
-     * 仅 isOpaque=true 的组件节点才会有值；
-     * graph-builder 阶段写入原始 specifier，
-     * project-graph-builder 解析后替换为真实文件路径。
-     */
-    importedFrom?: string;
-    /**
-     * 组件在来源文件中的导出名。
-     * 默认导出为 'default'，具名导出为实际导出标识符名称。
-     */
-    exportName?: string;
-}
-/**
- * 区域节点 —— 描述 repeat / conditional / fragment 等语义区域。
- */
-export interface RegionNode {
-    kind: BoundaryKind;
-    ownerKey: string;
-    childKeys: string[];
-    sourceRange: SourceRange;
-    sourceCandidates?: SourceCandidate[];
-}
-/**
- * 文本段落 —— 对应可编辑的文本内容。
- */
-export interface TextExpressionSource {
-    kind: "identifier" | "member-expression" | "index-expression";
-    expression: string;
-    base: string;
-    path: Array<{
-        kind: "property";
-        name: string;
-    } | {
-        kind: "index";
-        index: number;
-    }>;
-}
-export type StaticAttributeValue = string | number | boolean | null | StaticAttributeValue[] | {
-    [key: string]: StaticAttributeValue;
-};
-export interface AttributeSource {
-    name: string;
-    value: string;
-    sourceRange: SourceRange;
-    source: TextExpressionSource | null;
-    resolvedValue?: StaticAttributeValue;
-}
-export interface RepeatSourceCandidate {
-    kind: "repeat-template";
-    collectionExpression: string;
-    collectionSource: TextExpressionSource | null;
-    itemParamName?: string;
-    indexParamName?: string;
-}
-export interface ConditionalSourceCandidate {
-    kind: "conditional-branch";
-    conditionExpression: string;
-    conditionSource: TextExpressionSource | null;
-}
-export type SourceCandidate = RepeatSourceCandidate | ConditionalSourceCandidate;
-export interface TextSegment {
-    index: number;
-    value: string;
-    sourceRange: SourceRange;
-    editable: boolean;
-    source: TextExpressionSource | null;
-}
-/**
- * 项目源图 —— 跨文件的完整 graph。
- */
-export interface ProjectSourceGraph {
-    /** 所有元素节点，key → ElementNode */
-    elements: Map<string, ElementNode>;
-    /** 所有区域节点 */
-    regions: RegionNode[];
-    /** 文件 → keys 的反向索引 */
-    fileIndex: Map<string, string[]>;
-}
-/**
- * 渲染源图 —— 单路由视角的 graph。
- */
-export interface RenderSourceGraph {
-    routeId: string;
-    rootKeys: string[];
-    elements: Map<string, ElementNode>;
-    regions: RegionNode[];
-    /** 文件 → keys 的反向索引 */
-    fileIndex: Map<string, string[]>;
-    version: number;
-}

package/dist/internal/graph/types.js

@@ -1,6 +0,0 @@
-// ─── Graph 模块类型 ──────────────────────────────────
-// 来源: docs/06-development-checklist.md §4
-//
-// graph-builder 从源文件构建语义图。
-// ElementNode / RegionNode / TextSegment 是图的节点类型。
-export {};

package/dist/internal/history/undo-redo.d.ts

@@ -1,28 +0,0 @@
-export interface FileSnapshot {
-    file: string;
-    content: string;
-    version: number;
-}
-/**
- * 历史条目 —— 一次操作前后的文件快照。
- */
-export interface HistoryEntry {
-    requestId: string;
-    beforeSnapshots: FileSnapshot[];
-    afterSnapshots: FileSnapshot[];
-}
-/**
- * 撤销/重做管理器。
- */
-export interface UndoRedoManager {
-    push(entry: HistoryEntry): void;
-    undo(): HistoryEntry | null;
-    redo(): HistoryEntry | null;
-    canUndo(): boolean;
-    canRedo(): boolean;
-    clear(): void;
-}
-/**
- * 创建撤销/重做管理器。
- */
-export declare function createUndoRedoManager(): UndoRedoManager;

package/dist/internal/history/undo-redo.js

@@ -1,42 +0,0 @@
-// ─── Undo/Redo History ───────────────────────────────
-// 来源: docs/06-development-checklist.md §6
-//
-// 基于 FileSnapshot 的撤销/重做栈。
-/**
- * 创建撤销/重做管理器。
- */
-export function createUndoRedoManager() {
-    const undoStack = [];
-    const redoStack = [];
-    return {
-        push(entry) {
-            undoStack.push(entry);
-            // 新操作清空 redo 栈
-            redoStack.length = 0;
-        },
-        undo() {
-            const entry = undoStack.pop();
-            if (!entry)
-                return null;
-            redoStack.push(entry);
-            return entry;
-        },
-        redo() {
-            const entry = redoStack.pop();
-            if (!entry)
-                return null;
-            undoStack.push(entry);
-            return entry;
-        },
-        canUndo() {
-            return undoStack.length > 0;
-        },
-        canRedo() {
-            return redoStack.length > 0;
-        },
-        clear() {
-            undoStack.length = 0;
-            redoStack.length = 0;
-        },
-    };
-}

package/dist/internal/index.d.ts

@@ -1,2 +0,0 @@
-export { createEditEngineRuntime, EditEngineRuntime } from "./runtime.js";
-export type { EditEngineRuntimeOptions, ExternalSourceResolver, ExternalWritebackAdapter, FunctionCallContract, IEditEngineRuntime, ProjectFileSystem, RuntimeRouteConfig, } from "./runtime.js";

package/dist/internal/index.js

@@ -1 +0,0 @@
-export { createEditEngineRuntime, EditEngineRuntime } from "./runtime.js";

package/dist/internal/planner/planner.d.ts

@@ -1,104 +0,0 @@
-import type { NodeCapabilitySnapshot, OperationErrorCode, OperationRequest, OperationValue, ResolvedTextWriteTarget, RewritePlan } from "./types.js";
-import { type ValuePathSegment } from "../ast/index.js";
-import type { ComponentSemanticDescriptor, ContentModelView } from "../protocol.js";
-import type { ProvenanceResolution } from "../provenance/types.js";
-export interface PlannerGraphAccess {
-    getNode: (key: string) => NodeInfo | null;
-    getChildNodes?: (key: string) => NodeInfo[];
-    getCapability: (key: string) => NodeCapabilitySnapshot;
-    getFileContent: (file: string) => string;
-    getFileVersion: (file: string) => number;
-    getRouteEntryFile: (routeId: string) => string | null;
-    getComponentSemantic: (key: string) => ComponentSemanticDescriptor | null;
-    getEditableTextSegmentIndex: (key: string) => number | null;
-    getTextWriteTarget: (key: string, segmentIndex: number) => Promise<ResolvedTextWriteTarget | null>;
-    getTextProvenance?: (key: string, segmentIndex: number) => ProvenanceResolution | null;
-}
-export interface NodeInfo {
-    key: string;
-    file: string;
-    component: string;
-    tag?: string;
-    structuralPath: string;
-    sourceRange: {
-        startLine: number;
-        startColumn: number;
-        endLine: number;
-        endColumn: number;
-    };
-    parentKey?: string;
-    writeTarget?: string;
-    isRepeatRegion?: boolean;
-    isTemplateOwner?: boolean;
-    isBoundary?: boolean;
-    /**
-     * 组件来源文件（已解析路径），用于 cross-file move 时自动推导 add-import/remove-import 步骤。
-     * 由 graph-builder + project-graph-builder 阶段填充。
-     */
-    importedFrom?: string;
-    /**
-     * 组件在来源文件中的导出名（'default' 或具名导出名称）。
-     * 由 graph-builder 阶段填充。
-     */
-    exportName?: string;
-    isRepeatItemRoot?: boolean;
-    repeatOwnerKey?: string;
-    contentModel?: ContentModelView;
-    richTextBlock?: {
-        field: string;
-        index: number;
-    };
-    attributes?: Array<{
-        name: string;
-        value: string;
-        source: {
-            expression: string;
-            base: string;
-            path: ValuePathSegment[];
-        } | null;
-        resolvedValue?: OperationValue;
-    }>;
-}
-export type PlanResult = {
-    ok: true;
-    plan: RewritePlan;
-} | {
-    ok: false;
-    errorCode: OperationErrorCode;
-    reason: string;
-};
-export declare class OperationPlanner {
-    private graph;
-    constructor(graph: PlannerGraphAccess);
-    plan(request: OperationRequest): Promise<PlanResult>;
-    private planConditionalOperation;
-    private planRichTextOperation;
-    private planRichTextBlockInsert;
-    private planRichTextBlockRemoval;
-    private planRichTextBlockMove;
-    private planMediaFieldOperation;
-    private buildAttributeRewriteStep;
-    private planComponentSlotOperation;
-    private planValueCollectionOperation;
-    private resolveNodeRequest;
-    private resolveRouteRequest;
-    private planNodeAttributeOperation;
-    private planStyleClassNameOperation;
-    private planRouteOperation;
-    private buildTextRewriteSteps;
-    private checkDocumentVersion;
-    private toTextContent;
-    private planUpdateText;
-    private planRemoveNode;
-    private buildRemoveComponentImportStep;
-    private planInsertChild;
-    private planExternalBackedInsertChild;
-    private findExternalInsertContext;
-    private planRepeatBackedInsertChild;
-    private getUpstreamBackedDescendantReason;
-    private getRepeatBackedTemplateStructureReason;
-    private isInsideMapCallback;
-    private planMoveNode;
-    private planCrossFileMove;
-    private buildPlan;
-}