@djvlc/contracts-types 1.8.0 → 1.8.2

package/dist/index.d.mts

@@ -641,7 +641,7 @@ interface PageConfig {
  * 页面级状态定义
  *
  * @description
- * V2 版本中状态管理扁平化，所有状态集中在页面级。
+ * 状态管理采用扁平化设计，所有状态集中在页面级。
  * 组件通过表达式引用状态：{ type: "state", value: "userInfo.name" }
  */
 interface PageState {
@@ -825,22 +825,110 @@ interface ExpressionValidationWarning {
 
 /**
  * 表达式系统类型
+ *
+ * @description
+ * 表达式是低代码平台的核心能力之一，用于实现数据绑定和动态计算。
+ *
+ * 核心设计：
+ * - 命名一致性：表达式类型 'local'、依赖前缀 'local'、上下文字段 'local' 完全一致
+ * - meta.dependencies 格式统一（都使用 prefix.path 格式）
+ * - 泛型版本 ExpressionContextTyped 支持精确类型提示
+ * - 所有上下文类型使用 DeepReadonly 包装（防止引擎意外修改）
  */
 
+/**
+ * 依赖路径前缀
+ *
+ * @description
+ * 用于 meta.dependencies 的统一格式：`${PREFIX}.${path}`
+ * 确保静态校验时能准确识别依赖来源。
+ */
+declare const DEPENDENCY_PREFIX: {
+    /** 页面状态依赖前缀 */
+    readonly STATE: "state";
+    /** 数据绑定依赖前缀 */
+    readonly BINDING: "binding";
+    /** 局部变量依赖前缀 */
+    readonly LOCAL: "local";
+    /** 组件属性依赖前缀 */
+    readonly PROPS: "props";
+    /** 事件上下文依赖前缀 */
+    readonly EVENT: "event";
+};
+/**
+ * 依赖路径前缀类型
+ */
+type DependencyPrefix = (typeof DEPENDENCY_PREFIX)[keyof typeof DEPENDENCY_PREFIX];
 /**
  * 表达式类型
  *
  * @description
- * V2 版本变化：
- * - query → binding（数据绑定结果引用，更通用）
- * - function → 移除（安全考虑）
- * - literal → 移除（静态值直接使用原始类型，不需要包装）
- * - 新增 template（模板字符串插值）
+ * 支持的表达式类型：
+ * - state: 页面状态引用
+ * - binding: 数据绑定结果引用
+ * - local: 局部变量引用（循环变量、事件参数等）
+ * - template: 模板字符串插值
+ * - computed: 计算表达式
+ */
+type ExpressionType = 'state' | 'binding' | 'local' | 'template' | 'computed';
+/**
+ * 表达式依赖项
+ *
+ * @description
+ * 统一格式的依赖路径，格式为 `${prefix}.${path}`
+ * 例如：'state.count'、'binding.userList.0.name'、'local.item.id'
+ *
+ * @example
+ * ```typescript
+ * const deps: ExpressionDependency[] = [
+ *   'state.count',           // 页面状态
+ *   'binding.users.0.name',  // 数据绑定结果
+ *   'local.item.price',      // 循环变量
+ *   'event.payload.id',      // 事件参数
+ * ];
+ * ```
+ */
+type ExpressionDependency = `${DependencyPrefix}.${string}`;
+/**
+ * 创建类型安全的依赖路径
+ *
+ * @description
+ * 避免在代码中频繁使用 `as ExpressionDependency` 强转。
+ * 提供类型安全的依赖路径创建方式。
+ *
+ * @example
+ * ```typescript
+ * dep('state', 'count')           // => 'state.count'
+ * dep('binding', 'users.0.name')  // => 'binding.users.0.name'
+ * dep('local', 'item.id')         // => 'local.item.id'
+ * ```
+ */
+declare function dep(prefix: DependencyPrefix, path: string): ExpressionDependency;
+/**
+ * 表达式元数据
  *
- * 静态值（literal）不再作为表达式类型，而是直接使用 AnyValueOrExpression 的原始类型分支。
- * 例如：props: { title: "Hello" } 而不是 props: { title: { type: "literal", value: "\"Hello\"" } }
+ * @description
+ * 用于发布期静态校验和依赖追踪。
+ * 所有依赖路径都使用统一的 `prefix.path` 格式。
  */
-type ExpressionType = 'state' | 'binding' | 'context' | 'template' | 'computed';
+interface ExpressionMeta {
+    /**
+     * 引用的依赖路径
+     *
+     * @description
+     * 统一格式：`${type}.${path}`
+     * - state.xxx - 页面状态
+     * - binding.xxx - 数据绑定结果
+     * - local.xxx - 局部变量（循环/事件）
+     * - props.xxx - 组件属性
+     * - event.xxx - 事件上下文
+     */
+    dependencies?: ExpressionDependency[];
+    /** 期望的返回类型 */
+    returnType?: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'any';
+    /** 是否为纯表达式（无副作用） */
+    pure?: boolean;
+}
 /**
  * 表达式定义
  *
@@ -856,83 +944,27 @@ interface Expression {
     /** 默认值（表达式执行失败时使用） */
     fallback?: JsonValue;
     /** 表达式元数据（用于发布期校验） */
-    meta?: {
-        /** 引用的字段路径 */
-        dependencies?: string[];
-        /** 期望的返回类型 */
-        returnType?: string;
-    };
+    meta?: ExpressionMeta;
 }
 /**
- * 表达式求值上下文
+ * 深度只读类型
  *
  * @description
- * 表达式引擎在求值时可访问的上下文对象。
- * 所有动态表达式（state/binding/context/template/computed）都从此上下文获取数据。
- *
- * 使用场景：
- * - Runtime 表达式求值
- * - 编辑器表达式预览
- * - 表达式校验与调试
- *
- * @example
- * ```typescript
- * const ctx: ExpressionContext = {
- *   state: { count: 0, userInfo: { name: 'Alice' } },
- *   binding: { userList: [{ id: 1, name: 'Bob' }] },
- *   context: { item: { id: 1, name: 'Bob' }, index: 0 },
- * };
- *
- * // 求值 { type: 'state', value: 'userInfo.name' } => 'Alice'
- * // 求值 { type: 'context', value: 'item.name' } => 'Bob'
- * ```
+ * 将对象及其所有嵌套属性标记为只读，
+ * 防止表达式引擎在求值过程中意外修改上下文。
+ * 函数类型保持原样（不变成 object）。
  */
-interface ExpressionContext {
-    /**
-     * 页面状态
-     *
-     * @description
-     * 对应 PageState.fields 的运行时值。
-     * 表达式通过 { type: 'state', value: 'fieldName.path' } 访问。
-     */
-    state: Record<string, unknown>;
-    /**
-     * 数据绑定结果
-     *
-     * @description
-     * 对应 DataBinding 查询的返回数据，按 bindingId 组织。
-     * 表达式通过 { type: 'binding', value: 'bindingId.path' } 访问。
-     */
-    binding: Record<string, unknown>;
-    /**
-     * 局部上下文
-     *
-     * @description
-     * 包含循环变量、事件参数等临时作用域数据。
-     * 表达式通过 { type: 'context', value: 'item.path' } 访问。
-     */
-    context: ExpressionLocalContext;
-    /**
-     * 组件属性（可选）
-     *
-     * @description
-     * 当前组件的 props 值，供组件内部表达式访问。
-     * 通常在组件内部求值时提供。
-     */
-    props?: Record<string, unknown>;
-    /**
-     * 当前事件（可选）
-     *
-     * @description
-     * 事件处理器执行时的事件对象。
-     * 仅在事件处理链中可用。
-     */
-    event?: ExpressionEventContext;
-}
+type DeepReadonly<T> = T extends (...args: unknown[]) => unknown ? T : T extends (infer U)[] ? ReadonlyArray<DeepReadonly<U>> : T extends object ? {
+    readonly [K in keyof T]: DeepReadonly<T[K]>;
+} : T;
 /**
- * 局部上下文（循环变量、事件参数等）
+ * 局部变量（循环变量、事件参数等）
+ *
+ * @description
+ * 命名与表达式类型 'local' 和依赖前缀 'local' 保持一致，
+ * 避免引擎实现时的命名混淆。
  */
-interface ExpressionLocalContext {
+interface ExpressionLocal {
     /**
      * 循环项（loop.itemName 指定的变量名）
      *
@@ -973,6 +1005,107 @@ interface ExpressionEventContext {
         keyCode?: number;
     };
 }
+/**
+ * 表达式求值上下文（泛型版本）
+ *
+ * @description
+ * 支持精确类型提示的表达式上下文。
+ * 业务层可以通过泛型参数指定具体的状态、绑定、属性类型。
+ *
+ * @template TState - 页面状态类型
+ * @template TBinding - 数据绑定结果类型
+ * @template TProps - 组件属性类型
+ * @template TLocal - 局部变量类型
+ *
+ * @example
+ * ```typescript
+ * interface MyState {
+ *   count: number;
+ *   userInfo: { name: string; age: number };
+ * }
+ *
+ * interface MyBinding {
+ *   userList: Array<{ id: string; name: string }>;
+ * }
+ *
+ * const ctx: ExpressionContextTyped<MyState, MyBinding> = {
+ *   state: { count: 0, userInfo: { name: 'Alice', age: 25 } },
+ *   binding: { userList: [{ id: '1', name: 'Bob' }] },
+ *   local: { item: { id: '1', name: 'Bob' }, index: 0 },
+ * };
+ *
+ * // ctx.state.userInfo.name 有类型提示
+ * ```
+ */
+interface ExpressionContextTyped<TState extends Record<string, unknown> = Record<string, unknown>, TBinding extends Record<string, unknown> = Record<string, unknown>, TProps extends Record<string, unknown> = Record<string, unknown>, TLocal extends ExpressionLocal = ExpressionLocal> {
+    /**
+     * 页面状态（只读）
+     *
+     * @description
+     * 对应 PageState.fields 的运行时值。
+     * 表达式通过 { type: 'state', value: 'fieldName.path' } 访问。
+     */
+    readonly state: DeepReadonly<TState>;
+    /**
+     * 数据绑定结果（只读）
+     *
+     * @description
+     * 对应 DataBinding 查询的返回数据，按 bindingId 组织。
+     * 表达式通过 { type: 'binding', value: 'bindingId.path' } 访问。
+     */
+    readonly binding: DeepReadonly<TBinding>;
+    /**
+     * 局部变量（只读）
+     *
+     * @description
+     * 包含循环变量、事件参数等临时作用域数据。
+     * 字段名与表达式类型 'local' 和依赖前缀 'local' 保持一致。
+     * 表达式通过 { type: 'local', value: 'item.path' } 访问。
+     */
+    readonly local: DeepReadonly<TLocal>;
+    /**
+     * 组件属性（只读，可选）
+     *
+     * @description
+     * 当前组件的 props 值，供组件内部表达式访问。
+     * 通常在组件内部求值时提供。
+     */
+    readonly props?: DeepReadonly<TProps>;
+    /**
+     * 当前事件（只读，可选）
+     *
+     * @description
+     * 事件处理器执行时的事件对象。
+     * 仅在事件处理链中可用。
+     */
+    readonly event?: DeepReadonly<ExpressionEventContext>;
+}
+/**
+ * 表达式求值上下文（基础版本）
+ *
+ * @description
+ * 表达式引擎在求值时可访问的上下文对象。
+ * 所有动态表达式（state/binding/local/template/computed）都从此上下文获取数据。
+ *
+ * 使用场景：
+ * - Runtime 表达式求值
+ * - 编辑器表达式预览
+ * - 表达式校验与调试
+ *
+ * @example
+ * ```typescript
+ * const ctx: ExpressionContext = {
+ *   state: { count: 0, userInfo: { name: 'Alice' } },
+ *   binding: { userList: [{ id: 1, name: 'Bob' }] },
+ *   local: { item: { id: 1, name: 'Bob' }, index: 0 },
+ * };
+ *
+ * // 求值 { type: 'state', value: 'userInfo.name' } => 'Alice'
+ * // 求值 { type: 'local', value: 'item.name' } => 'Bob'
+ * ```
+ */
+interface ExpressionContext extends ExpressionContextTyped<Record<string, unknown>, Record<string, unknown>, Record<string, unknown>, ExpressionLocal> {
+}
 /**
  * 任意值或表达式
  *
@@ -983,55 +1116,94 @@ interface ExpressionEventContext {
 type AnyValueOrExpression = Expression | string | number | boolean | null | AnyValueOrExpression[] | {
     [key: string]: AnyValueOrExpression;
 };
-/**
- * 属性值类型（兼容旧版本）
- * @deprecated 使用 AnyValueOrExpression 代替
- */
-type PropValue = AnyValueOrExpression;
 /**
  * 创建空的表达式上下文
  *
  * @description
  * 用于初始化表达式求值环境，所有字段都有合理的默认值。
  */
-declare function createExpressionContext(partial?: Partial<ExpressionContext>): ExpressionContext;
+declare function createExpressionContext(partial?: Partial<{
+    state: Record<string, unknown>;
+    binding: Record<string, unknown>;
+    local: ExpressionLocal;
+    props: Record<string, unknown>;
+    event: ExpressionEventContext;
+}>): ExpressionContext;
 /**
- * 创建带循环变量的局部上下文
+ * 创建带循环变量的局部变量
  *
  * @param item - 当前循环项
  * @param index - 当前循环索引
  * @param extras - 额外的局部变量（如嵌套循环）
  */
-declare function createLoopContext(item: unknown, index: number, extras?: Record<string, unknown>): ExpressionLocalContext;
-/**
- * 创建字面量表达式
- * @deprecated V2 版本移除 literal 表达式类型，静态值请直接使用原始类型
- *
- * @example
- * // 旧方式（V1）
- * props: { title: literal("Hello") }
- *
- * // 新方式（V2）
- * props: { title: "Hello" }
- */
-declare function literal(value: JsonValue): JsonValue;
+declare function createLoopLocal(item: unknown, index: number, extras?: Record<string, unknown>): ExpressionLocal;
 /**
  * 创建状态引用表达式
  */
 declare function stateRef(path: string, fallback?: JsonValue): Expression;
 /**
  * 创建数据绑定结果引用表达式
+ *
+ * @throws 如果 bindingId 包含非法字符（如 '.'）
  */
 declare function bindingRef(bindingId: string, path: string, fallback?: JsonValue): Expression;
 /**
- * 创建模板表达式
+ * 创建局部变量引用表达式
+ *
+ * @description
+ * 用于引用循环变量、事件参数等局部作用域数据。
+ *
+ * @example
+ * ```typescript
+ * // 在循环中引用当前项
+ * localRef('item.name')
+ * // => { type: 'local', value: 'item.name', meta: { dependencies: ['local.item.name'] } }
+ * ```
  */
-declare function template(templateString: string, fallback?: JsonValue): Expression;
+declare function localRef(path: string, fallback?: JsonValue): Expression;
+/**
+ * 模板解析模式
+ *
+ * @description
+ * - 'strict': 严格模式，无前缀变量会抛出错误
+ */
+type TemplateParseMode = 'strict';
 /**
- * 创建查询结果引用表达式
- * @deprecated 使用 bindingRef 代替
+ * 模板解析错误
  */
-declare function queryRef(queryId: string, path: string, fallback?: JsonValue): Expression;
+declare class TemplateParseError extends Error {
+    readonly bareVariables: string[];
+    readonly expression: string;
+    constructor(message: string, bareVariables: string[], expression: string);
+}
+/**
+ * 创建模板表达式
+ *
+ * @description
+ * 模板中的变量引用会自动解析并提取依赖。
+ * 变量必须使用完整前缀（state./binding./local./props./event.）
+ *
+ * @throws {TemplateParseError} 检测到无前缀变量（如 ${count} 应改为 ${state.count}）
+ *
+ * @example
+ * ```typescript
+ * // 使用完整路径
+ * template("Hello, ${state.userName}!")
+ * // => dependencies: ['state.userName']
+ *
+ * // 数组索引访问
+ * template("First user: ${binding.users[0].name}")
+ * // => dependencies: ['binding.users[0].name']
+ *
+ * // 表达式中提取多个变量
+ * template("Total: ${state.count + state.offset}")
+ * // => dependencies: ['state.count', 'state.offset']
+ *
+ * // 错误示例（会抛出 TemplateParseError）
+ * template("Count: ${count}")  // ❌ 应使用 ${state.count}
+ * ```
+ */
+declare function template(templateString: string, fallback?: JsonValue): Expression;
 
 /**
  * 数据绑定类型
@@ -1067,7 +1239,7 @@ interface DataBindingErrorConfig {
  * 数据绑定配置
  *
  * @description
- * V2 版本中数据绑定集中在页面级管理。
+ * 数据绑定集中在页面级管理。
  * targetState 为必填字段，绑定结果会写入对应的状态字段。
  */
 interface DataBinding {
@@ -1108,8 +1280,8 @@ interface DataBinding {
  * 内置动作类型
  *
  * @description
- * V2 版本精简了内置动作列表，
- * copyToClipboard、scrollTo 等通过自定义 Action 实现。
+ * 预置的简单动作类型，不需要通过 ActionDefinition 定义。
+ * copyToClipboard、scrollTo 等复杂操作通过自定义 Action 实现。
  */
 type BuiltinActionType = 'setState' | 'navigate' | 'openDialog' | 'closeDialog' | 'showToast' | 'showLoading' | 'hideLoading' | 'refreshData' | 'track';
 /**
@@ -1132,16 +1304,12 @@ interface ActionPolicy {
  * 动作引用
  *
  * @description
- * V2 版本变化：
- * - 必须指定 actionDefinitionVersionId 或 builtinAction 之一
- * - 新增 id 用于追踪
- * - 新增 policy 用于超时、重试、幂等控制
- * - 新增 condition 用于条件执行
- * - 新增 async 用于并行/串行控制
+ * 定义一个动作的执行配置，必须指定 actionDefinitionVersionId 或 builtinAction 之一。
+ * 支持超时、重试、幂等控制、条件执行、并行/串行控制等能力。
  */
 interface ActionRef {
-    /** 动作唯一 ID（用于追踪） */
-    id?: string;
+    /** 动作唯一 ID（用于全链路追踪，必填） */
+    id: string;
     /** 动作别名（用于调试） */
     alias?: string;
     /** 动作定义版本 ID（引用 ActionDefinition） */
@@ -1209,7 +1377,7 @@ interface EventHandler {
  * 页面生命周期钩子
  *
  * @description
- * V2 版本简化了生命周期钩子，
+ * 定义页面级生命周期事件。
  * onScroll、onResize 通过组件内部或扩展实现。
  */
 interface PageLifecycle {
@@ -1260,8 +1428,7 @@ interface LayoutConfig extends LayoutValues {
  * 节点样式配置
  *
  * @description
- * 组件节点的样式配置。
- * V2 版本移除了 responsive，响应式通过 condition 或 CSS 层面处理。
+ * 组件节点的样式配置，响应式通过 condition 或 CSS 层面处理。
  */
 interface NodeStyleConfig {
     /** 内联样式（支持表达式） */
@@ -1286,14 +1453,12 @@ interface LoopConfig {
  * 组件节点（组件树的基本单元）
  *
  * @description
- * V2 版本变化：
- * - 移除组件级 state（状态提升到页面级）
- * - 移除组件级 dataBindings（数据绑定集中管理）
- * - 移除 hidden（使用 condition 代替）
- * - 新增 layout（画布式自由定位）
- * - 新增 slots（具名插槽支持）
- * - 新增 slotName（声明当前节点所属插槽）
- * - props 支持表达式类型
+ * 定义组件树中的基本渲染单元：
+ * - 状态管理在页面级统一管理
+ * - 数据绑定集中在 pageSchema.dataBindings
+ * - 支持 layout（画布式自由定位）
+ * - 支持 slots（具名插槽）
+ * - props 支持静态值或表达式
  */
 interface ComponentNode {
     /** 节点唯一 ID（页面内唯一） */
@@ -1310,11 +1475,6 @@ interface ComponentNode {
     style?: NodeStyleConfig;
     /** 布局配置（画布式自由定位） */
     layout?: LayoutConfig;
-    /**
-     * 默认子节点（向后兼容）
-     * @deprecated 建议使用 slots.default 代替
-     */
-    children?: ComponentNode[];
     /**
      * 具名插槽（推荐使用）
      * @description
@@ -1375,7 +1535,7 @@ declare const CURRENT_SCHEMA_VERSION = "2.0.0";
 /**
  * Schema 版本类型
  */
-type SchemaVersion = typeof CURRENT_SCHEMA_VERSION | '1.0.0' | '0.9.0';
+type SchemaVersion = typeof CURRENT_SCHEMA_VERSION;
 /**
  * 页面 Schema Runtime Core（不可变版本的核心结构）
  *
@@ -2378,41 +2538,6 @@ interface PageResolveWithSnapshotResponse extends PageResolveResponse {
     /** 完整的页面快照（CDN 失败时使用） */
     snapshot: PageSnapshotJson;
 }
-/**
- * 页面解析响应（旧版本）
- * @deprecated 使用 PageResolveResponse 代替
- */
-interface LegacyPageResolveResponse {
-    /** 页面版本 ID */
-    pageVersionId: UniqueId;
-    /** 页面 Schema */
-    schema: PageSchema;
-    /** 组件清单 */
-    manifest: Manifest;
-    /** 运行时配置 */
-    runtimeConfig: RuntimeConfig;
-    /** 预加载的数据 */
-    preloadedData?: Record<string, JsonValue>;
-}
-/**
- * 运行时配置（旧版本）
- * @deprecated 使用 OpsConfig 代替
- */
-interface RuntimeConfig {
-    /** 推荐的运行时版本 */
-    runtimeVersion: SemVer;
-    /** CDN 基础 URL */
-    cdnBaseUrl: string;
-    /** 被阻断的组件列表 */
-    blockedComponents: string[];
-    /** Kill Switch 状态 */
-    killSwitch?: {
-        enabled: boolean;
-        message?: string;
-    };
-    /** 功能开关 */
-    features?: Record<string, boolean>;
-}
 
 /**
  * 属性 Schema 类型定义
@@ -2421,9 +2546,8 @@ interface RuntimeConfig {
  * 属性 Schema（JSON Schema 子集 + 编辑器扩展）
  *
  * @description
- * V2 版本变化：
- * - additionalProperties 默认为 false（严格模式）
- * - 如需允许额外属性，需显式设置 additionalProperties: true
+ * additionalProperties 默认为 false（严格模式）。
+ * 如需允许额外属性，需显式设置 additionalProperties: true。
  */
 interface PropsSchema {
     /** Schema 类型（固定为 object） */
@@ -2439,7 +2563,6 @@ interface PropsSchema {
     /**
      * 是否允许未知属性
      * @default false
-     * @description V2 版本默认 false（严格模式）
      */
     additionalProperties?: boolean;
 }
@@ -2464,8 +2587,7 @@ interface PropGroup {
  * 属性定义（扩展 JSON Schema）
  *
  * @description
- * V2 版本变化：
- * - object 类型的 additionalProperties 默认为 false
+ * object 类型的 additionalProperties 默认为 false。
  */
 interface PropDefinition {
     /** 属性类型 */
@@ -2513,7 +2635,6 @@ interface PropDefinition {
     /**
      * 额外属性定义
      * @default false
-     * @description V2 版本默认 false（严格模式）
      */
     additionalProperties?: boolean | PropDefinition;
     /** 编辑器组件类型 */
@@ -2945,16 +3066,11 @@ type MethodCategory = 'lifecycle' | 'data' | 'display' | 'scroll' | 'custom';
  */
 declare const CURRENT_COMPONENT_META_VERSION: SemVer;
 /**
- * 组件元数据 V2
+ * 组件元数据
  *
  * @description
- * V2 版本变化：
- * - 新增 specVersion 字段
- * - 新增 style 样式配置（包含隔离策略）
- * - 新增 slots 插槽声明（组件嵌套能力）
- * - 新增 methods 方法声明（命令式 API）
- * - PropsSchema.additionalProperties 默认 false
- * - PropDefinition.additionalProperties（object 类型）默认 false
+ * 定义组件的完整元数据，包括属性 Schema、事件声明、能力声明、兼容性信息等。
+ * PropsSchema 和 PropDefinition 的 additionalProperties 默认为 false（严格模式）。
  */
 interface ComponentMeta {
     /** 规格版本号 */
@@ -3567,19 +3683,11 @@ interface RetryPolicy {
  */
 declare const CURRENT_ACTION_SPEC_VERSION: SemVer;
 /**
- * 动作规格（ActionSpec）V2
+ * 动作规格（ActionSpec）
  *
  * @description
- * 定义动作的完整行为规范。
- *
- * V2 版本变化：
- * - 新增 specVersion 字段
- * - timeout → timeoutMs（单位明确化）
- * - keyTtl → keyTtlSeconds（单位明确化）
- * - window → windowSeconds（单位明确化）
- * - initialDelay → initialDelayMs（单位明确化）
- * - maxDelay → maxDelayMs（单位明确化）
- * - errorMapping key 必须符合 ^[A-Z][A-Z0-9_]{2,63}$ 格式
+ * 定义动作的完整行为规范，包括参数校验、幂等规则、频控、风控等。
+ * 时间相关字段均使用明确单位后缀（Ms/Seconds）。
  */
 interface ActionSpec {
     /** 规格版本号 */
@@ -4100,15 +4208,11 @@ interface FallbackCondition {
  */
 declare const CURRENT_DATA_QUERY_SPEC_VERSION: SemVer;
 /**
- * 数据查询规格 V2
+ * 数据查询规格
  *
  * @description
- * V2 版本变化：
- * - 新增 specVersion 字段
- * - 移除顶层 sourceType（通过 sourceConfig.type 区分）
- * - timeout → timeoutMs（单位明确化）
- * - cache.ttl → cache.ttlSeconds（单位明确化）
- * - cache.staleMaxAge → cache.staleMaxAgeSeconds（单位明确化）
+ * 定义数据查询的完整行为规范，包括数据源、字段裁剪、脱敏、缓存等。
+ * 时间相关字段均使用明确单位后缀（Ms/Seconds）。
  */
 interface DataQuerySpec {
     /** 规格版本号 */
@@ -4902,26 +5006,10 @@ interface VersionDiff {
 /**
  * 包版本号
  */
-declare const VERSION = "2.1.0";
+declare const VERSION = "2.0.0";
 /**
  * 协议版本号
  */
 declare const PROTOCOL_VERSION = "2.0.0";
-/**
- * PageSchema 当前版本
- */
-declare const PAGE_SCHEMA_VERSION = "2.0.0";
-/**
- * ComponentMeta 当前版本
- */
-declare const COMPONENT_META_SCHEMA_VERSION = "2.0.0";
-/**
- * ActionSpec 当前版本
- */
-declare const ACTION_SPEC_VERSION = "2.0.0";
-/**
- * DataQuerySpec 当前版本
- */
-declare const DATA_QUERY_SPEC_VERSION = "2.0.0";
 
-export { type ABTestRolloutConfig, ACTION_SPEC_VERSION, ALLOWED_FUNCTION_NAMES, ALL_BUILTIN_FUNCTIONS, ARRAY_FUNCTIONS, type ActionClientContext, type ActionDefinition, type ActionDefinitionVersion, type ActionExecuteRequest, type ActionExecuteResponse, type ActionExecutor, type ActionPolicy, type ActionRef, type ActionResult, type ActionSheetItem, type ActionSheetOptions, type ActionSheetResult, type ActionSpec, ActionType, type Activity, type ActivityPrecondition, type ActivityRule, type ActivityStatus, type ActivityType, type AggregationDataSourceConfig, type AggregationQueryItem, type AnyValueOrExpression, type ApiErrorDetail, type ApiErrorResponse, type ApiResponse, type ApiSuccessResponse, type AppContext, AuditAction, type AuditConfig, type AuditLogEntry, type BackgroundConfig, type BaseActivityRule, type BlacklistRolloutConfig, type BlockedComponentInfo, type BlockedComponentItem, type BootstrapConfig, type BrowserCompat, type BuiltinActionType, COMPONENT_META_SCHEMA_VERSION, CURRENT_ACTION_SPEC_VERSION, CURRENT_COMPONENT_META_VERSION, CURRENT_DATA_QUERY_SPEC_VERSION, CURRENT_SCHEMA_VERSION, type CacheConfig, type CacheLevel, type CanaryHealthCheck, type CanaryRolloutConfig, type CanaryStage, type CanvasType, type CapabilityDeclaration, type CapabilityName, type ChangeLog, type ChangeLogItem, type ClaimActivityRule, type ClaimPrize, type ClaimRecord, type ClaimState, type ClipboardApi, type CompatInfo, type Component, type ComponentCategory, type ComponentContext, type ComponentDependency, type ComponentIntegrity, type ComponentMeta, type ComponentNode, type ComponentQueryParams, type ComponentRegisterRequest, type ComponentStatus, type ComponentStatusChangeRequest, type ComponentVersion, type ConfirmOptions, type ConsecutiveReward, type CreateManifestRequest, type CreatePreviewTokenRequest, type CumulativeReward, DATA_QUERY_SPEC_VERSION, DATE_FUNCTIONS, DEFAULT_EXPRESSION_VALIDATION_CONFIG, type DataBinding, type DataBindingErrorConfig, type DataLoadStrategy, type DataQueryDefinition, type DataQueryDefinitionVersion, type DataQueryRequest, type DataQueryResponse, type DataQuerySpec, type DataSourceConfig, type DataSourceType, type DatabaseDataSourceConfig, type DefinitionVersionDigest, type DefinitionsDigest, type DialogOptions, type DialogResult, type DjvlcError, type EditorComponent, type Environment, ErrorCategory, ErrorCode, ErrorCodeToHttpStatus, type ErrorMapping, ErrorMessages, type EventDeclaration, type EventHandler, type ExecutorContext, type ExecutorResult, type Expression, type ExpressionContext, type ExpressionEventContext, type ExpressionFunctionCategory, type ExpressionFunctionDefinition, type ExpressionLocalContext, type ExpressionType, type ExpressionValidationConfig, type ExpressionValidationError, type ExpressionValidationResult, type ExpressionValidationWarning, FORMAT_FUNCTIONS, type FallbackCondition, type FallbackConfig, type FeatureCondition, type FeatureRolloutConfig, type FieldPermission, type FieldPolicy, type FieldTransform, type FileIntegrity, type FunctionParamDefinition, type GraphQLDataSourceConfig, type HostApi, type HttpDataSourceConfig, type HttpRetryConfig, type I18nDetectionStrategy, type ISODateTime, type IdempotencyKeyStrategy, type IdempotencyRule, type IntegrityHash, type InternalDataSourceConfig, type InventoryConfig, type JsonObject, type JsonValue, type KillSwitchItem, LOGIC_FUNCTIONS, type LayoutConfig, type LayoutValues, type LegacyPageResolveResponse, type LoopConfig, type LotteryActivityRule, type LotteryCost, type LotteryPrize, type LotteryState, type Manifest, type ManifestEntry, type ManifestItem, type ManifestValidationError, type ManifestValidationResult, type ManifestValidationWarning, type MaskingConfig, type MaskingRule, type MaskingType, type MethodCategory, type MethodDeclaration, type MethodParam, NUMBER_FUNCTIONS, type NavigateOptions, type NodeStyleConfig, type OperatorInfo, type OpsConfig, type OrderByItem, PAGE_SCHEMA_VERSION, PROTOCOL_VERSION, type PageAssetsJson, type PageBehaviorConfig, type PageConfig, type PageDraft, type PageI18nConfig, type PageIntegrityJson, type PageLayoutConfig, type PageLifecycle, type PageManifest, type PageMeta, type PageResolveRequest, type PageResolveResponse, type PageResolveWithSnapshotResponse, type PageSEO, type PageSchema, type PageSnapshotJson, type PageSnapshotManifest, type PageSnapshotMeta, type PageSnapshotPage, type PageState, PageStatus, type PageStatusType, type PageStylesConfig, type PageVersion, type PaginatedResponse, type PaginationMeta, type PaginationParams, type ParamPermission, type ParticipationLimit, type PercentageRolloutConfig, type PityConfig, type Precondition, type PreconditionType, type PreviewImageOptions, type PreviewToken, type PreviewTokenValidationResult, type ProbabilityConfig, type PropDefinition, type PropFormat, type PropGroup, type PropType, type PropValue, type PropsSchema, type PublishCdnConfig, PublishChannel, type PublishConfig, type PublishEnvironment, type PublishNotificationConfig, type PublishRecord, type PublishRolloutConfig, PublishStatus, type QueryPermissions, type RateLimitDimension, type RateLimitItem, type RateLimitRule, type RequestContext, type ResolvedManifest, type ResponsiveBreakpoints, type RetryPolicy, type RiskControlConfig, type RolloutConfig, type RolloutMatchRequest, type RolloutMatchResult, type RolloutStrategy, type RolloutStrategyConfig, type RolloutStrategyType, type RuntimeConfig, type RuntimeContext, type RuntimeSpec, type SHAIntegrity, STRING_FUNCTIONS, type ScanCodeResult, type SchemaVersion, type SemVer, type ShareOptions, type ShareResult, type SigninActivityRule, type SigninRecord, type SigninRewardRecord, type SigninState, type SlotCategory, type SlotDeclaration, type SnapshotComponentEntry, type StateFieldDefinition, type StorageApi, type StorageOptions, type StyleConfig, type StyleIsolation, type ThemeConfig, type TimeWindowRolloutConfig, type ToastOptions, type TrackEvent, type URLString, UTILITY_FUNCTIONS, type UniqueId, type UpsertRolloutRequest, type UserActivityState, type UserContext, VERSION, type ValidationRule, type VersionDiff, type VersionInfo, VersionStatus, type VersionStatusType, type ViewportConfig, type WhitelistRolloutConfig, bindingRef, createDjvlcError, createExpressionContext, createLoopContext, isDjvlcError, literal, queryRef, stateRef, template };
+export { type ABTestRolloutConfig, ALLOWED_FUNCTION_NAMES, ALL_BUILTIN_FUNCTIONS, ARRAY_FUNCTIONS, type ActionClientContext, type ActionDefinition, type ActionDefinitionVersion, type ActionExecuteRequest, type ActionExecuteResponse, type ActionExecutor, type ActionPolicy, type ActionRef, type ActionResult, type ActionSheetItem, type ActionSheetOptions, type ActionSheetResult, type ActionSpec, ActionType, type Activity, type ActivityPrecondition, type ActivityRule, type ActivityStatus, type ActivityType, type AggregationDataSourceConfig, type AggregationQueryItem, type AnyValueOrExpression, type ApiErrorDetail, type ApiErrorResponse, type ApiResponse, type ApiSuccessResponse, type AppContext, AuditAction, type AuditConfig, type AuditLogEntry, type BackgroundConfig, type BaseActivityRule, type BlacklistRolloutConfig, type BlockedComponentInfo, type BlockedComponentItem, type BootstrapConfig, type BrowserCompat, type BuiltinActionType, CURRENT_ACTION_SPEC_VERSION, CURRENT_COMPONENT_META_VERSION, CURRENT_DATA_QUERY_SPEC_VERSION, CURRENT_SCHEMA_VERSION, type CacheConfig, type CacheLevel, type CanaryHealthCheck, type CanaryRolloutConfig, type CanaryStage, type CanvasType, type CapabilityDeclaration, type CapabilityName, type ChangeLog, type ChangeLogItem, type ClaimActivityRule, type ClaimPrize, type ClaimRecord, type ClaimState, type ClipboardApi, type CompatInfo, type Component, type ComponentCategory, type ComponentContext, type ComponentDependency, type ComponentIntegrity, type ComponentMeta, type ComponentNode, type ComponentQueryParams, type ComponentRegisterRequest, type ComponentStatus, type ComponentStatusChangeRequest, type ComponentVersion, type ConfirmOptions, type ConsecutiveReward, type CreateManifestRequest, type CreatePreviewTokenRequest, type CumulativeReward, DATE_FUNCTIONS, DEFAULT_EXPRESSION_VALIDATION_CONFIG, DEPENDENCY_PREFIX, type DataBinding, type DataBindingErrorConfig, type DataLoadStrategy, type DataQueryDefinition, type DataQueryDefinitionVersion, type DataQueryRequest, type DataQueryResponse, type DataQuerySpec, type DataSourceConfig, type DataSourceType, type DatabaseDataSourceConfig, type DeepReadonly, type DefinitionVersionDigest, type DefinitionsDigest, type DependencyPrefix, type DialogOptions, type DialogResult, type DjvlcError, type EditorComponent, type Environment, ErrorCategory, ErrorCode, ErrorCodeToHttpStatus, type ErrorMapping, ErrorMessages, type EventDeclaration, type EventHandler, type ExecutorContext, type ExecutorResult, type Expression, type ExpressionContext, type ExpressionContextTyped, type ExpressionDependency, type ExpressionEventContext, type ExpressionFunctionCategory, type ExpressionFunctionDefinition, type ExpressionLocal, type ExpressionMeta, type ExpressionType, type ExpressionValidationConfig, type ExpressionValidationError, type ExpressionValidationResult, type ExpressionValidationWarning, FORMAT_FUNCTIONS, type FallbackCondition, type FallbackConfig, type FeatureCondition, type FeatureRolloutConfig, type FieldPermission, type FieldPolicy, type FieldTransform, type FileIntegrity, type FunctionParamDefinition, type GraphQLDataSourceConfig, type HostApi, type HttpDataSourceConfig, type HttpRetryConfig, type I18nDetectionStrategy, type ISODateTime, type IdempotencyKeyStrategy, type IdempotencyRule, type IntegrityHash, type InternalDataSourceConfig, type InventoryConfig, type JsonObject, type JsonValue, type KillSwitchItem, LOGIC_FUNCTIONS, type LayoutConfig, type LayoutValues, type LoopConfig, type LotteryActivityRule, type LotteryCost, type LotteryPrize, type LotteryState, type Manifest, type ManifestEntry, type ManifestItem, type ManifestValidationError, type ManifestValidationResult, type ManifestValidationWarning, type MaskingConfig, type MaskingRule, type MaskingType, type MethodCategory, type MethodDeclaration, type MethodParam, NUMBER_FUNCTIONS, type NavigateOptions, type NodeStyleConfig, type OperatorInfo, type OpsConfig, type OrderByItem, PROTOCOL_VERSION, type PageAssetsJson, type PageBehaviorConfig, type PageConfig, type PageDraft, type PageI18nConfig, type PageIntegrityJson, type PageLayoutConfig, type PageLifecycle, type PageManifest, type PageMeta, type PageResolveRequest, type PageResolveResponse, type PageResolveWithSnapshotResponse, type PageSEO, type PageSchema, type PageSnapshotJson, type PageSnapshotManifest, type PageSnapshotMeta, type PageSnapshotPage, type PageState, PageStatus, type PageStatusType, type PageStylesConfig, type PageVersion, type PaginatedResponse, type PaginationMeta, type PaginationParams, type ParamPermission, type ParticipationLimit, type PercentageRolloutConfig, type PityConfig, type Precondition, type PreconditionType, type PreviewImageOptions, type PreviewToken, type PreviewTokenValidationResult, type ProbabilityConfig, type PropDefinition, type PropFormat, type PropGroup, type PropType, type PropsSchema, type PublishCdnConfig, PublishChannel, type PublishConfig, type PublishEnvironment, type PublishNotificationConfig, type PublishRecord, type PublishRolloutConfig, PublishStatus, type QueryPermissions, type RateLimitDimension, type RateLimitItem, type RateLimitRule, type RequestContext, type ResolvedManifest, type ResponsiveBreakpoints, type RetryPolicy, type RiskControlConfig, type RolloutConfig, type RolloutMatchRequest, type RolloutMatchResult, type RolloutStrategy, type RolloutStrategyConfig, type RolloutStrategyType, type RuntimeContext, type RuntimeSpec, type SHAIntegrity, STRING_FUNCTIONS, type ScanCodeResult, type SchemaVersion, type SemVer, type ShareOptions, type ShareResult, type SigninActivityRule, type SigninRecord, type SigninRewardRecord, type SigninState, type SlotCategory, type SlotDeclaration, type SnapshotComponentEntry, type StateFieldDefinition, type StorageApi, type StorageOptions, type StyleConfig, type StyleIsolation, TemplateParseError, type TemplateParseMode, type ThemeConfig, type TimeWindowRolloutConfig, type ToastOptions, type TrackEvent, type URLString, UTILITY_FUNCTIONS, type UniqueId, type UpsertRolloutRequest, type UserActivityState, type UserContext, VERSION, type ValidationRule, type VersionDiff, type VersionInfo, VersionStatus, type VersionStatusType, type ViewportConfig, type WhitelistRolloutConfig, bindingRef, createDjvlcError, createExpressionContext, createLoopLocal, dep, isDjvlcError, localRef, stateRef, template };