@vcp-dev/site-edit-engine 0.6.0 → 0.6.2

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

@@ -31,6 +31,7 @@ export interface RenderEntry {
     childKeys: string[];
     pageCompositionUnitKey?: string;
     operationSummary: OperationSummary;
+    dynamicDataSummary?: DynamicDataSummaryView;
 }
 /**
  * 能力概要 —— 标记该节点支持的四个核心操作。
@@ -42,6 +43,40 @@ export interface OperationSummary {
     canMove: boolean;
     canRemove: boolean;
 }
+export type DynamicSourceKindView = "vcp-cms-collection" | "vcp-cms-form" | "vcp-cms-settings" | "vcp-cms-navigation" | "site-api-route" | "external-api" | "unknown-api";
+export type DynamicSourceTypeView = "cms-field" | "api-field";
+export type DynamicTargetKindView = "text" | "attribute" | "richtext" | "repeat-region" | "component-prop";
+export type DynamicConfidenceView = "exact" | "safe-derived" | "partial" | "unknown";
+export interface DynamicEvidenceView {
+    file: string;
+    symbol?: string;
+    reason: string;
+}
+export interface DynamicDataBindingView {
+    sourceKind: DynamicSourceKindView;
+    sourceType: DynamicSourceTypeView;
+    endpointPattern?: string;
+    operation?: string;
+    collection?: string;
+    fieldPath?: string;
+    valuePath?: string;
+    targetKind: DynamicTargetKindView;
+    targetName: string;
+    confidence: DynamicConfidenceView;
+    readonly: true;
+    evidence: DynamicEvidenceView[];
+}
+export interface DynamicDataDetailView {
+    hasDynamicData: boolean;
+    bindings: DynamicDataBindingView[];
+}
+export interface DynamicDataSummaryView {
+    hasDynamicData: boolean;
+    sourceKinds: DynamicSourceKindView[];
+    primaryEndpoint?: string;
+    primaryCollection?: string;
+    primaryFieldPath?: string;
+}
 /**
  * 选中节点的详细信息 —— 按需加载。
  * 包含完整 capability、text segments、boundary 信息、邻接关系。
@@ -62,6 +97,7 @@ export interface RenderObjectDetail {
     mediaModel?: MediaModelView;
     styleSource?: StyleSourceView;
     conditional?: ConditionalDetailView;
+    dynamicData?: DynamicDataDetailView;
     textSegments: TextSegmentView[];
     boundaryKind: BoundaryKind | null;
     isOpaque: boolean;
@@ -69,6 +105,30 @@ export interface RenderObjectDetail {
     children: RenderEntryRef[];
     siblings: RenderEntryRef[];
 }
+/**
+ * 面向 get-object-edit-context 的紧凑投影。
+ * 只包含 Wire DTO 实际消费的字段，避免为了选中态读取并构造 children / siblings
+ * 以及完整 provenance chain、文本值等 detail-only 数据。
+ */
+export interface RenderObjectEditContext {
+    key: string;
+    tag: string;
+    componentName: string;
+    sourceFile: string;
+    sourceLocator?: SourceLocatorView;
+    label: string;
+    capabilities: NodeCapabilitySnapshot;
+    provenanceChain?: Pick<ProvenanceChainView, "editMode" | "diagnostics">;
+    dynamicData?: DynamicDataDetailView;
+    textSegments: Array<{
+        index: number;
+        editable: boolean;
+        source: Pick<TextSourceView, "kind"> | null;
+    }>;
+    boundaryKind: BoundaryKind | null;
+    isOpaque: boolean;
+    ancestors: RenderEntryRef[];
+}
 export interface SourceLocatorRangeView {
     startLine: number;
     startColumn: number;

package/dist/internal/protocol.d.ts

@@ -6,4 +6,4 @@ export type { DesignerEvent } from "./protocol/event.js";
 export type { OperationError } from "./protocol/error.js";
 export type { SourceIdentity } from "./protocol/identity.js";
 export type { InsertableTag, InsertNodeSpec, MoveTarget, OperationParams, OperationRequest, OperationResult, OperationSelectionRef, OperationTarget, OperationType, OperationValue, StyleBreakpoint, StyleProperty, StyleStateMode, } from "./protocol/operation.js";
-export type { ComponentSemanticDescriptor, ConditionalDetailView, ContentModelView, EffectiveWriteTargetView, MediaModelView, OperationSummary, ProvenanceChainView, ProvenanceHopView, RenderDocument, RenderEntry, RenderEntryRef, RenderObjectDetail, SemanticSourceView, SourceLocatorRangeView, SourceLocatorView, StyleSourceOperation, StyleSourceView, TextSegmentView, TextSourceView, WriteTargetView, } from "./protocol/render.js";
+export type { ComponentSemanticDescriptor, ConditionalDetailView, DynamicConfidenceView, DynamicDataBindingView, DynamicDataDetailView, DynamicDataSummaryView, DynamicEvidenceView, DynamicSourceKindView, DynamicSourceTypeView, DynamicTargetKindView, ContentModelView, EffectiveWriteTargetView, MediaModelView, OperationSummary, ProvenanceChainView, ProvenanceHopView, RenderDocument, RenderEntry, RenderEntryRef, RenderObjectEditContext, RenderObjectDetail, SemanticSourceView, SourceLocatorRangeView, SourceLocatorView, StyleSourceOperation, StyleSourceView, TextSegmentView, TextSourceView, WriteTargetView, } from "./protocol/render.js";

package/dist/preview-runtime.d.ts

@@ -25,6 +25,13 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
                     canRemove: boolean;
                 };
                 pageCompositionUnitKey?: string | undefined;
+                dynamicDataSummary?: {
+                    hasDynamicData: boolean;
+                    sourceKinds: ("vcp-cms-collection" | "vcp-cms-form" | "vcp-cms-settings" | "vcp-cms-navigation" | "site-api-route" | "external-api" | "unknown-api")[];
+                    primaryEndpoint?: string | undefined;
+                    primaryCollection?: string | undefined;
+                    primaryFieldPath?: string | undefined;
+                } | undefined;
             }[];
             pageComposition: {
                 status: "supported";
@@ -131,6 +138,27 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
                     message: string;
                 }[];
             } | undefined;
+            dynamicData?: {
+                hasDynamicData: boolean;
+                bindings: {
+                    sourceKind: "vcp-cms-collection" | "vcp-cms-form" | "vcp-cms-settings" | "vcp-cms-navigation" | "site-api-route" | "external-api" | "unknown-api";
+                    sourceType: "api-field" | "cms-field";
+                    targetKind: "repeat-region" | "text" | "attribute" | "richtext" | "component-prop";
+                    targetName: string;
+                    confidence: "exact" | "safe-derived" | "partial" | "unknown";
+                    readonly: true;
+                    evidence: {
+                        file: string;
+                        reason: string;
+                        symbol?: string | undefined;
+                    }[];
+                    endpointPattern?: string | undefined;
+                    operation?: string | undefined;
+                    collection?: string | undefined;
+                    fieldPath?: string | undefined;
+                    valuePath?: string | undefined;
+                }[];
+            } | undefined;
         };
     };
     getClassNameSource(key: string, routeId?: string): {
@@ -140,7 +168,7 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
             routeId: string;
             filePath: string;
             componentName: string;
-            sourceKind: "missing" | "expression" | "stringLiteral";
+            sourceKind: "expression" | "missing" | "stringLiteral";
             attrRaw: string | null;
             valueRaw: string | null;
             attrRange: {
@@ -218,8 +246,8 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
         };
     };
     refreshSourceForKey(key: string, routeId?: string): Promise<void>;
-    executeOperation(request: Parameters<PreviewSiteEditEngineRuntime["executeOperation"]>[0], mutationContext: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
-    undo(mutationContext: SiteEditMutationContext): Promise<{
+    executeOperation(request: Parameters<PreviewSiteEditEngineRuntime["executeOperation"]>[0], mutationContext?: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
+    undo(_mutationContext?: SiteEditMutationContext): Promise<{
         ok: false;
         error: {
             code: "VERSION_STALE" | "RECOVERY_REQUIRED" | "NODE_NOT_FOUND" | "ROUTE_NOT_FOUND" | "CAPABILITY_REJECTED" | "CONSTRAINT_VIOLATED" | "INVALID_PARAMS" | "PLAN_FAILED" | "TRANSACTION_PREFLIGHT_FAILED" | "ROUTE_REBUILD_FAILED" | "HISTORY_COMMIT_FAILED" | "MATERIALIZATION_CONFLICT" | "MATERIALIZATION_REJECTED" | "MUTATION_ASSERTION_REQUIRED" | "MUTATION_ASSERTION_INVALID" | "AST_PARSE_ERROR" | "UNSUPPORTED_OPERATION" | "LOCATOR_FAILED" | "INVALID_TARGET" | "WRITE_IO_ERROR" | "CONCURRENT_MODIFIED" | "ROLLBACK_FAILED" | "RECOVERY_PERSIST_FAILED" | "MUTATION_SESSION_REQUIRED" | "LEASE_ASSERTION_INVALID" | "LEASE_ASSERTION_EXPIRED" | "LEASE_ASSERTION_SCOPE_MISMATCH" | "CROSS_PAGE_MOVE_UNSUPPORTED" | "INTERNAL_ERROR";
@@ -279,7 +307,7 @@ export declare class PreviewFileSystemSiteEditEngineRuntime implements PreviewSi
         };
         error?: undefined;
     }>;
-    redo(mutationContext: SiteEditMutationContext): Promise<{
+    redo(_mutationContext?: SiteEditMutationContext): Promise<{
         ok: false;
         error: {
             code: "VERSION_STALE" | "RECOVERY_REQUIRED" | "NODE_NOT_FOUND" | "ROUTE_NOT_FOUND" | "CAPABILITY_REJECTED" | "CONSTRAINT_VIOLATED" | "INVALID_PARAMS" | "PLAN_FAILED" | "TRANSACTION_PREFLIGHT_FAILED" | "ROUTE_REBUILD_FAILED" | "HISTORY_COMMIT_FAILED" | "MATERIALIZATION_CONFLICT" | "MATERIALIZATION_REJECTED" | "MUTATION_ASSERTION_REQUIRED" | "MUTATION_ASSERTION_INVALID" | "AST_PARSE_ERROR" | "UNSUPPORTED_OPERATION" | "LOCATOR_FAILED" | "INVALID_TARGET" | "WRITE_IO_ERROR" | "CONCURRENT_MODIFIED" | "ROLLBACK_FAILED" | "RECOVERY_PERSIST_FAILED" | "MUTATION_SESSION_REQUIRED" | "LEASE_ASSERTION_INVALID" | "LEASE_ASSERTION_EXPIRED" | "LEASE_ASSERTION_SCOPE_MISMATCH" | "CROSS_PAGE_MOVE_UNSUPPORTED" | "INTERNAL_ERROR";

package/dist/runtime.d.ts

@@ -21,6 +21,13 @@ export declare class SnapshotSiteEditEngineRuntime implements SiteEditEngineRunt
                 canRemove: boolean;
             };
             pageCompositionUnitKey?: string | undefined;
+            dynamicDataSummary?: {
+                hasDynamicData: boolean;
+                sourceKinds: ("vcp-cms-collection" | "vcp-cms-form" | "vcp-cms-settings" | "vcp-cms-navigation" | "site-api-route" | "external-api" | "unknown-api")[];
+                primaryEndpoint?: string | undefined;
+                primaryCollection?: string | undefined;
+                primaryFieldPath?: string | undefined;
+            } | undefined;
         }[];
         pageComposition: {
             status: "supported";
@@ -120,13 +127,34 @@ export declare class SnapshotSiteEditEngineRuntime implements SiteEditEngineRunt
                 message: string;
             }[];
         } | undefined;
+        dynamicData?: {
+            hasDynamicData: boolean;
+            bindings: {
+                sourceKind: "vcp-cms-collection" | "vcp-cms-form" | "vcp-cms-settings" | "vcp-cms-navigation" | "site-api-route" | "external-api" | "unknown-api";
+                sourceType: "api-field" | "cms-field";
+                targetKind: "repeat-region" | "text" | "attribute" | "richtext" | "component-prop";
+                targetName: string;
+                confidence: "exact" | "safe-derived" | "partial" | "unknown";
+                readonly: true;
+                evidence: {
+                    file: string;
+                    reason: string;
+                    symbol?: string | undefined;
+                }[];
+                endpointPattern?: string | undefined;
+                operation?: string | undefined;
+                collection?: string | undefined;
+                fieldPath?: string | undefined;
+                valuePath?: string | undefined;
+            }[];
+        } | undefined;
     };
     getClassNameSource(key: string, routeId?: string): {
         key: string;
         routeId: string;
         filePath: string;
         componentName: string;
-        sourceKind: "missing" | "expression" | "stringLiteral";
+        sourceKind: "expression" | "missing" | "stringLiteral";
         attrRaw: string | null;
         valueRaw: string | null;
         attrRange: {

package/dist/types.d.ts

@@ -1,7 +1,6 @@
 import type { SiteEditCommandSuccess, SiteEditEvent, SiteEditGetClassNameSourceCommandResult, SiteEditGetClassNameSourceResult, SiteEditClassNameSourceStyleContext, SiteEditObjectEditContext, SiteEditOperationCommandResult, SiteEditMutationContext, SiteEditOperationRequest, SiteEditPatchPlan, SiteEditRenderDocument, SiteEditResolveSourceLocationInput, SiteEditSourceFileResponse, SiteEditSourceLocation, SiteEditSourceTreeResponse } from "@vcp-dev/contracts";
 import type { SiteEditProjectFileSystem } from "./public-file-system.js";
 import type { FileHistoryStore } from "./history/file-history-store.js";
-import type { SiteEditMutationContextVerifier } from "./mutation-context-verifier.js";
 export type { SiteEditProjectFileSystem } from "./public-file-system.js";
 export interface SiteEditSnapshotFile {
     path: string;
@@ -21,7 +20,6 @@ export interface SiteEditEngineRuntimeOptions {
     onEvent?: (event: SiteEditEvent) => void;
     dev?: boolean;
     historyStore?: FileHistoryStore;
-    mutationContextVerifier?: SiteEditMutationContextVerifier;
 }
 export interface SiteEditPlanOperationResult {
     result: SiteEditOperationCommandResult;
@@ -59,7 +57,6 @@ export interface PreviewSiteEditEngineRuntimeOptions {
     dev?: boolean;
     fileSystem?: SiteEditProjectFileSystem;
     historyStore?: FileHistoryStore;
-    mutationContextVerifier?: SiteEditMutationContextVerifier;
     /** Preserves monotonic document versions when a Bridge swaps runtimes. */
     initialDocumentVersion?: number;
 }
@@ -79,9 +76,9 @@ export interface PreviewSiteEditEngineRuntime {
     }): Promise<SiteEditCommandSuccess<SiteEditSourceFileResponse>>;
     resolveSourceLocation(input: SiteEditResolveSourceLocationInput): SiteEditCommandSuccess<SiteEditSourceLocation>;
     refreshSourceForKey(key: string, routeId?: string): Promise<void>;
-    executeOperation(request: SiteEditOperationRequest, mutationContext: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
-    undo(mutationContext: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
-    redo(mutationContext: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
+    executeOperation(request: SiteEditOperationRequest, mutationContext?: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
+    undo(mutationContext?: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
+    redo(mutationContext?: SiteEditMutationContext): Promise<SiteEditOperationCommandResult>;
     notifyFileChanged(file: string): void;
     subscribe(listener: (event: SiteEditEvent) => void): () => void;
     dispose(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vcp-dev/site-edit-engine",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {
@@ -60,7 +60,7 @@
     "@babel/parser": "^7.29.3",
     "@babel/traverse": "^7.29.0",
     "@babel/types": "^7.29.0",
-    "@vcp-dev/contracts": "0.6.0",
+    "@vcp-dev/contracts": "0.6.2",
     "yaml": "^2.9.0"
   },
   "devDependencies": {

package/dist/mutation-context-verifier.d.ts

@@ -1,30 +0,0 @@
-import { type KeyObject } from "node:crypto";
-import type { SiteEditMutationContext, SiteEditOperationErrorCode } from "@vcp-dev/contracts";
-export type SiteEditMutationVerificationFailureCode = Extract<SiteEditOperationErrorCode, "MUTATION_SESSION_REQUIRED" | "LEASE_ASSERTION_INVALID" | "LEASE_ASSERTION_EXPIRED" | "LEASE_ASSERTION_SCOPE_MISMATCH">;
-export type SiteEditMutationVerificationResult = {
-    ok: true;
-} | {
-    ok: false;
-    code: SiteEditMutationVerificationFailureCode;
-    message: string;
-};
-export interface SiteEditMutationAssertionExpected {
-    tenantId: string;
-    siteId: string;
-    snapshotId: string;
-    editingSessionId: string;
-    lockId: string;
-    ownerId: string;
-}
-export interface SiteEditMutationContextVerifier {
-    verify(context: SiteEditMutationContext, expected: SiteEditMutationAssertionExpected): Promise<SiteEditMutationVerificationResult>;
-}
-export interface Ed25519MutationContextVerifierOptions {
-    publicKey: string | KeyObject;
-    issuer?: string;
-    audience?: string;
-    keyId: string;
-    now?: () => number;
-    clockSkewSeconds?: number;
-}
-export declare function createEd25519MutationContextVerifier(options: Ed25519MutationContextVerifierOptions): SiteEditMutationContextVerifier;