@vcp-dev/site-edit-engine 0.6.11 → 0.7.1

package/dist/internal/protocol/capability.d.ts

@@ -1,3 +1,4 @@
+import type { SiteEditCompositionContext } from "@vcp-dev/contracts";
 /**
  * 节点能力快照 —— 描述该节点支持的操作及约束。
  *
@@ -7,6 +8,7 @@
  * 不能被收窄为 "只能插入 button"。
  */
 export interface NodeCapabilitySnapshot {
+    composition: SiteEditCompositionContext;
     key: string;
     canUpdateText: boolean;
     canInsertChild: boolean;

package/dist/internal/protocol/event.d.ts

@@ -1,5 +1,6 @@
 import type { OperationResult } from "./operation.js";
 import type { OperationError } from "./error.js";
+import type { SiteEditCompositionContext } from "@vcp-dev/contracts";
 /**
  * 设计器事件联合类型 —— engine 向 client 推送的所有事件。
  *
@@ -13,27 +14,30 @@ import type { OperationError } from "./error.js";
  */
 export type DesignerEvent = {
     type: "document-changed";
-    routeId: string;
+    composition: SiteEditCompositionContext;
     version: number;
 } | {
     type: "operation-completed";
+    composition: SiteEditCompositionContext;
     result: OperationResult;
 } | {
     type: "operation-failed";
     requestId: string;
+    composition: SiteEditCompositionContext;
     error: OperationError;
 } | {
     type: "graph-invalidated";
-    routeId: string;
+    composition: SiteEditCompositionContext;
 } | {
     type: "graph-ready";
-    routeId: string;
+    composition: SiteEditCompositionContext;
     version: number;
 } | {
     type: "graph-error";
-    routeId: string;
+    composition: SiteEditCompositionContext;
     message: string;
 } | {
     type: "capability-changed";
+    composition: SiteEditCompositionContext;
     keys: string[];
 };

package/dist/internal/protocol/operation.d.ts

@@ -1,4 +1,4 @@
-import type { SiteEditInsertNodeSpec, SiteEditMoveTarget, SiteEditOperationParams, SiteEditOperationRequest, SiteEditOperationTarget, SiteEditOperationType, SiteEditOperationValue, SiteEditStyleBreakpoint, SiteEditStyleProperty, SiteEditStyleStateMode, SiteEditOperationOutput } from "@vcp-dev/contracts";
+import type { SiteEditCompositionContext, SiteEditInsertNodeSpec, SiteEditMoveTarget, SiteEditOperationParams, SiteEditOperationRequest, SiteEditOperationTarget, SiteEditOperationType, SiteEditOperationValue, SiteEditStyleBreakpoint, SiteEditStyleProperty, SiteEditStyleStateMode, SiteEditOperationOutput } from "@vcp-dev/contracts";
 import type { OperationError } from "./error.js";
 /** caller-facing 操作类型 */
 export type OperationType = SiteEditOperationType;
@@ -58,6 +58,8 @@ export interface OperationSelectionRef {
     instanceCount?: number;
 }
 export interface OperationResult {
+    /** Normalized composition that owned this operation. */
+    composition: SiteEditCompositionContext;
     /** 对应的请求 ID */
     requestId: string;
     /** 操作类型 */

package/dist/internal/protocol/render.d.ts

@@ -1,4 +1,4 @@
-import type { SiteEditClassNameSourceStyleContext, SiteEditPageComposition } from "@vcp-dev/contracts";
+import type { SiteEditClassNameSourceStyleContext, SiteEditCompositionContext, SiteEditPageComposition } from "@vcp-dev/contracts";
 import type { NodeCapabilitySnapshot } from "./capability.js";
 import type { BoundaryKind } from "./boundary.js";
 import type { OperationType } from "./operation.js";
@@ -13,6 +13,7 @@ export interface ExternalSourceView {
  * 由 engine 从 graph 投影而来，client 用于构建大纲 / 画布。
  */
 export interface RenderDocument {
+    composition: SiteEditCompositionContext;
     routeId: string;
     version: number;
     rootKeys: string[];
@@ -82,6 +83,7 @@ export interface DynamicDataSummaryView {
  * 包含完整 capability、text segments、boundary 信息、邻接关系。
  */
 export interface RenderObjectDetail {
+    composition: SiteEditCompositionContext;
     key: string;
     tag: string;
     componentName: string;
@@ -111,6 +113,7 @@ export interface RenderObjectDetail {
  * 以及完整 provenance chain、文本值等 detail-only 数据。
  */
 export interface RenderObjectEditContext {
+    composition: SiteEditCompositionContext;
     key: string;
     tag: string;
     componentName: string;

package/dist/next-app-router.d.ts

@@ -6,6 +6,7 @@ export { scanNextAppRouterRoutes } from "./next-app-router-fs.js";
 export type SiteEditRouteSourceFile = {
     path: string;
 };
-export declare function scanNextAppRouterRoutesFromFiles(files: SiteEditRouteSourceFile[]): SiteEditNextRouteConfig[];
+export declare function scanNextAppRouterRoutesFromFiles(files: readonly SiteEditRouteSourceFile[]): SiteEditNextRouteConfig[];
 export declare function resolveNextAppRouteId(pathname: string | null | undefined, routes: SiteEditNextRouteConfig[], basePath?: string): string | undefined;
+export declare function isNextAppRouterDynamicRoute(routeId: string): boolean;
 export declare function normalizeNextRoutePath(pathname: string | null | undefined, basePath?: string): string;

package/dist/next-app-router.js

@@ -1 +1 @@
-import c from"node:fs";import u from"node:path";var I=/^page\.(?:tsx|ts|jsx|js|mjs|cjs)$/;function x(t){let e=$(t);return e?f(e).map(r=>({routeId:P(e,r),entryFile:d(u.relative(t,r))})).sort((r,n)=>r.routeId.localeCompare(n.routeId)):[]}function $(t){for(let e of["app","src/app"]){let r=u.join(t,e);if(c.existsSync(r)&&c.statSync(r).isDirectory())return r}return null}function f(t){let e=[];for(let r of c.readdirSync(t,{withFileTypes:!0})){let n=u.join(t,r.name);if(r.isDirectory()){if(r.name==="node_modules"||r.name.startsWith(".")||r.name.startsWith("_"))continue;e.push(...f(n));continue}r.isFile()&&I.test(r.name)&&e.push(n)}return e}function P(t,e){let r=d(u.relative(t,u.dirname(e))),n=r?r.split("/").map(g).filter(i=>!!i):[];return n.length===0?"/":`/${n.join("/")}`}function W(t){return t.startsWith("(")&&t.endsWith(")")}function g(t){return!t||t.startsWith("@")||t.startsWith("_")||W(t)?null:y(t)}function y(t){return t.replace(/^\((?:\.|\.\.|\.\.\.)\)/,"")}function d(t){return t.replace(/\\/g,"/")}var S=/^page\.(?:tsx|ts|jsx|js|mjs|cjs)$/,l=/^\[[^\]]+\]$/,p=/^\[\.\.\.[^\]]+\]$/,h=/^\[\[\.\.\.[^\]]+\]\]$/,m=new WeakMap;function G(t){let e=t.map(n=>M(n.path)),r=v(e);return r?e.filter(n=>w(r,n)).map(n=>({routeId:B(r,n),entryFile:n})).sort((n,i)=>n.routeId.localeCompare(i.routeId)):[]}function k(t,e,r=""){let n=F(t,r),i=j(e);return i.exactRouteIds.has(n)?n:i.dynamicMatchers.find(o=>o.matcher.test(n))?.routeId}function j(t){let e=t.map(o=>`${o.routeId}\0${o.entryFile}`).join("\0"),r=m.get(t);if(r?.signature===e)return r;let n=new Set(t.map(o=>o.routeId)),i=t.filter(o=>o.routeId!=="/"&&A(o.routeId)).sort((o,s)=>R(s.routeId)-R(o.routeId)||s.routeId.length-o.routeId.length||o.routeId.localeCompare(s.routeId)).map(o=>({routeId:o.routeId,matcher:D(o.routeId)})),a={signature:e,exactRouteIds:n,dynamicMatchers:i};return m.set(t,a),a}function A(t){return t.split("/").filter(Boolean).some(e=>l.test(e)||p.test(e)||h.test(e))}function F(t,e=""){let n=((t??"/").trim()||"/").split(/[?#]/,1)[0]||"/",i=n.startsWith("/")?n:`/${n}`,a=N(e),o=a&&(i===a||i.startsWith(`${a}/`))?i.slice(a.length)||"/":i,s=o.startsWith("/")?o:`/${o}`;return s==="/"?"/":s.replace(/\/+$/,"")}function v(t){return t.some(n=>n.startsWith("app/"))?"app":t.some(n=>n.startsWith("src/app/"))?"src/app":null}function w(t,e){if(!e.startsWith(`${t}/`))return!1;let r=e.slice(e.lastIndexOf("/")+1);return S.test(r)?e.slice(t.length+1,-r.length-1).split("/").filter(Boolean).every(n=>!n.startsWith("_")):!1}function B(t,e){let r=e.slice(t.length+1).split("/").slice(0,-1).map(b).filter(n=>!!n);return r.length===0?"/":`/${r.join("/")}`}function z(t){return t.startsWith("(")&&t.endsWith(")")}function b(t){return!t||t.startsWith("@")||t.startsWith("_")||z(t)?null:C(t)}function C(t){return t.replace(/^\((?:\.|\.\.|\.\.\.)\)/,"")}function D(t){if(t==="/")return/^\/$/;let e=t.split("/").filter(Boolean).map(r=>h.test(r)?"(?:/.*)?":p.test(r)?"/.+":l.test(r)?"/[^/]+":`/${_(r)}`).join("");return new RegExp(`^${e}$`)}function R(t){return t.split("/").filter(Boolean).reduce((e,r)=>h.test(r)?e+1:p.test(r)?e+2:l.test(r)?e+3:e+4,0)}function N(t){let e=t.trim();return!e||e==="/"?"":(e.startsWith("/")?e:`/${e}`).replace(/\/+$/,"")}function _(t){return t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function M(t){return t.replace(/\\/g,"/").replace(/^\.\//,"")}export{F as normalizeNextRoutePath,k as resolveNextAppRouteId,x as scanNextAppRouterRoutes,G as scanNextAppRouterRoutesFromFiles};
+import c from"node:fs";import u from"node:path";var P=/^page\.(?:tsx|ts|jsx|js|mjs|cjs)$/;function $(t){let r=W(t);return r?p(r).map(e=>({routeId:g(r,e),entryFile:d(u.relative(t,e))})).sort((e,n)=>e.routeId.localeCompare(n.routeId)):[]}function W(t){for(let r of["app","src/app"]){let e=u.join(t,r);if(c.existsSync(e)&&c.statSync(e).isDirectory()&&p(e).length>0)return e}return null}function p(t){let r=[];for(let e of c.readdirSync(t,{withFileTypes:!0})){let n=u.join(t,e.name);if(e.isDirectory()){if(e.name==="node_modules"||e.name.startsWith(".")||e.name.startsWith("_"))continue;r.push(...p(n));continue}e.isFile()&&P.test(e.name)&&r.push(n)}return r}function g(t,r){let e=d(u.relative(t,u.dirname(r))),n=e?e.split("/").map(S).filter(i=>!!i):[];return n.length===0?"/":`/${n.join("/")}`}function y(t){return t.startsWith("(")&&t.endsWith(")")}function S(t){return!t||t.startsWith("@")||t.startsWith("_")||y(t)?null:A(t)}function A(t){return t.replace(/^\((?:\.|\.\.|\.\.\.)\)/,"")}function d(t){return t.replace(/\\/g,"/")}var j=/^page\.(?:tsx|ts|jsx|js|mjs|cjs)$/,l=/^\[[^\]]+\]$/,h=/^\[\.\.\.[^\]]+\]$/,f=/^\[\[\.\.\.[^\]]+\]\]$/,m=new WeakMap;function k(t){let r=t.map(n=>T(n.path)),e=F(r);return e?r.filter(n=>B(e,n)).map(n=>({routeId:z(e,n),entryFile:n})).sort((n,i)=>n.routeId.localeCompare(i.routeId)):[]}function O(t,r,e=""){let n=x(t,e),i=v(r);return i.exactRouteIds.has(n)?n:i.dynamicMatchers.find(o=>o.matcher.test(n))?.routeId}function v(t){let r=t.map(o=>`${o.routeId}\0${o.entryFile}`).join("\0"),e=m.get(t);if(e?.signature===r)return e;let n=new Set(t.map(o=>o.routeId)),i=t.filter(o=>o.routeId!=="/"&&I(o.routeId)).sort((o,s)=>R(s.routeId)-R(o.routeId)||s.routeId.length-o.routeId.length||o.routeId.localeCompare(s.routeId)).map(o=>({routeId:o.routeId,matcher:D(o.routeId)})),a={signature:r,exactRouteIds:n,dynamicMatchers:i};return m.set(t,a),a}function I(t){return t.split("/").filter(Boolean).some(r=>l.test(r)||h.test(r)||f.test(r))}function Q(t){return I(x(t))}function x(t,r=""){let n=((t??"/").trim()||"/").split(/[?#]/,1)[0]||"/",i=n.startsWith("/")?n:`/${n}`,a=N(r),o=a&&(i===a||i.startsWith(`${a}/`))?i.slice(a.length)||"/":i,s=o.startsWith("/")?o:`/${o}`;return s==="/"?"/":s.replace(/\/+$/,"")}function F(t){return t.some(n=>n.startsWith("app/")&&!w(n))?"app":t.some(n=>n.startsWith("src/app/"))?"src/app":null}function w(t){return t.startsWith("app/_vcp/")||t.startsWith("src/app/_vcp/")}function B(t,r){if(!r.startsWith(`${t}/`))return!1;let e=r.slice(r.lastIndexOf("/")+1);return j.test(e)?r.slice(t.length+1,-e.length-1).split("/").filter(Boolean).every(n=>!n.startsWith("_")):!1}function z(t,r){let e=r.slice(t.length+1).split("/").slice(0,-1).map(_).filter(n=>!!n);return e.length===0?"/":`/${e.join("/")}`}function b(t){return t.startsWith("(")&&t.endsWith(")")}function _(t){return!t||t.startsWith("@")||t.startsWith("_")||b(t)?null:C(t)}function C(t){return t.replace(/^\((?:\.|\.\.|\.\.\.)\)/,"")}function D(t){if(t==="/")return/^\/$/;let r=t.split("/").filter(Boolean).map(e=>f.test(e)?"(?:/.*)?":h.test(e)?"/.+":l.test(e)?"/[^/]+":`/${M(e)}`).join("");return new RegExp(`^${r}$`)}function R(t){return t.split("/").filter(Boolean).reduce((r,e)=>f.test(e)?r+1:h.test(e)?r+2:l.test(e)?r+3:r+4,0)}function N(t){let r=t.trim();return!r||r==="/"?"":(r.startsWith("/")?r:`/${r}`).replace(/\/+$/,"")}function M(t){return t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function T(t){return t.replace(/\\/g,"/").replace(/^\.\//,"")}export{Q as isNextAppRouterDynamicRoute,x as normalizeNextRoutePath,O as resolveNextAppRouteId,$ as scanNextAppRouterRoutes,k as scanNextAppRouterRoutesFromFiles};

package/dist/page-template-managed-source.d.ts

@@ -0,0 +1,59 @@
+import { type SiteEditCompositionContext, type SiteEditCompositionSelector, type ManagedPageTemplateRouteManifestV1 } from "@vcp-dev/contracts";
+import type { SiteEditSnapshotFile } from "./types.js";
+/** A synchronous source view used by the pure managed-source helpers. */
+export type SiteEditFileSystem = ReadonlyMap<string, string>;
+export type SiteEditManagedSourceFiles = SiteEditFileSystem | readonly SiteEditSnapshotFile[];
+export interface ManagedPageTemplatePaths {
+    routeRoot: string;
+    manifestFile: string;
+    runtimeFile: string;
+    registryFile: string;
+    templateEntryFile: string;
+}
+export type SiteEditEngineComposition = {
+    context: SiteEditCompositionContext;
+    entryFile: string;
+};
+export type PageTemplateCompositionSelector = SiteEditCompositionSelector;
+export type ManagedPageTemplateCompositionResolution = SiteEditEngineComposition & {
+    mode: "direct" | "delegated";
+    /** The server-only source file selected for this resolution. */
+    effectiveEntryFile: string;
+};
+export type PageTemplateManagedSourceErrorCode = "PAGE_TEMPLATE_MANAGED_SOURCE_INVALID" | "PAGE_TEMPLATE_ID_COLLISION" | "PAGE_TEMPLATE_ROUTE_AMBIGUOUS";
+export interface PageTemplateManagedSourceErrorDetails {
+    reason: string;
+    routeId?: string;
+    path?: string;
+    templateId?: string;
+    safeName?: string;
+    candidates?: readonly string[];
+    issues?: readonly string[];
+}
+export declare class PageTemplateManagedSourceError extends Error {
+    readonly code: PageTemplateManagedSourceErrorCode;
+    readonly details: PageTemplateManagedSourceErrorDetails;
+    constructor(code: PageTemplateManagedSourceErrorCode, message: string, details: PageTemplateManagedSourceErrorDetails);
+}
+export declare function computePageTemplateRouteKey(routeId: string): string;
+export declare function computePageTemplateSafeName(rawTemplateId: string): string;
+export declare function computeManagedPageTemplatePaths(routeId: string, rawTemplateId: string): ManagedPageTemplatePaths;
+export declare function assertNoPageTemplateSafeNameCollision(input: readonly string[] | readonly {
+    template_id: string;
+}[] | {
+    rawTemplateIds: readonly string[];
+} | {
+    templateIds: readonly string[];
+}): void;
+export declare function parseManagedPageTemplateManifest(input: {
+    routeId: string;
+    files: SiteEditManagedSourceFiles;
+}): ManagedPageTemplateRouteManifestV1 | null;
+export declare function resolveManagedPageTemplateComposition(input: {
+    selector: PageTemplateCompositionSelector;
+    files: SiteEditManagedSourceFiles;
+    canonicalEntryFile: string;
+}): ManagedPageTemplateCompositionResolution;
+export declare function scanSiteEditCompositionsFromFiles(input: {
+    files: SiteEditManagedSourceFiles;
+}): SiteEditEngineComposition[];