@djvlc/contracts-types 1.3.0 → 1.5.0

package/dist/index.d.mts

@@ -223,6 +223,246 @@ type GenericStatus = 'active' | 'inactive' | 'pending' | 'archived';
  * 审计状态
  */
 type AuditStatus = 'pending' | 'approved' | 'rejected';
+/**
+ * 基础上下文（所有场景共用）
+ * ActionContext/DataQueryContext/RuntimeContext 继承此接口
+ */
+interface BaseContext {
+    /** 页面版本 ID */
+    pageVersionId?: string;
+    /** 用户 ID */
+    uid?: string;
+    /** 设备 ID */
+    deviceId?: string;
+    /** 渠道 */
+    channel?: string;
+    /** 追踪 ID */
+    traceId?: string;
+}
+/**
+ * 灰度规则类型
+ */
+type RolloutRuleType = 'user' | 'ip' | 'device' | 'header' | 'cookie' | 'percentage' | 'custom';
+/**
+ * 灰度规则
+ */
+interface RolloutRule {
+    /** 规则 ID */
+    id: string;
+    /** 规则名称 */
+    name: string;
+    /** 规则类型 */
+    type: RolloutRuleType;
+    /** 匹配条件/值 */
+    value: string | number | string[];
+    /** 是否启用 */
+    enabled: boolean;
+    /** 优先级（数字越小优先级越高） */
+    priority?: number;
+}
+/**
+ * 灰度配置（统一版本）
+ * 用于页面发布灰度、功能开关等场景
+ */
+interface RolloutConfig {
+    /** 是否启用灰度 */
+    enabled: boolean;
+    /** 灰度百分比 (0-100)，与规则并行生效 */
+    percentage?: number;
+    /** 白名单用户 UID */
+    whitelistUsers?: string[];
+    /** 黑名单用户 UID */
+    blacklistUsers?: string[];
+    /** 白名单 IP */
+    whitelistIps?: string[];
+    /** 黑名单 IP */
+    blacklistIps?: string[];
+    /** 自定义规则 */
+    rules?: RolloutRule[];
+    /** 开始时间 */
+    startAt?: string;
+    /** 结束时间 */
+    endAt?: string;
+}
+/**
+ * Kill-Switch 配置项
+ */
+interface KillSwitchConfig {
+    /** 开关 ID */
+    id: string;
+    /** 开关名称 */
+    name: string;
+    /** 目标类型 */
+    targetType: 'action' | 'component' | 'feature' | 'page';
+    /** 目标标识（actionType / componentName / featureKey / pageUid） */
+    targetId: string;
+    /** 是否启用 */
+    enabled: boolean;
+    /** 原因 */
+    reason: string;
+    /** 启用时间 */
+    enabledAt?: string;
+    /** 启用者 */
+    enabledBy?: string;
+    /** 影响范围（可选：特定租户/全局） */
+    scope?: 'global' | 'tenant';
+    /** 租户 ID（scope 为 tenant 时） */
+    tenantId?: string;
+}
+/**
+ * 租户配置
+ */
+interface TenantConfig {
+    /** 租户 ID */
+    tenantId: string;
+    /** 租户名称 */
+    name: string;
+    /** 租户状态 */
+    status: 'active' | 'suspended' | 'deleted';
+    /** 域名列表 */
+    domains?: string[];
+    /** API Key */
+    apiKey?: string;
+    /** 功能开关 */
+    features?: Record<string, boolean>;
+    /** 配额限制 */
+    quotas?: TenantQuotas;
+    /** 创建时间 */
+    createdAt: string;
+}
+/**
+ * 租户配额
+ */
+interface TenantQuotas {
+    /** 最大页面数 */
+    maxPages?: number;
+    /** 最大组件数 */
+    maxComponents?: number;
+    /** 最大活动数 */
+    maxActivities?: number;
+    /** API 请求限制（每分钟） */
+    apiRateLimit?: number;
+}
+/**
+ * App 配置
+ */
+interface AppConfig {
+    /** App ID */
+    appId: string;
+    /** App 名称 */
+    name: string;
+    /** App Key */
+    appKey: string;
+    /** 所属租户 */
+    tenantId: string;
+    /** App 状态 */
+    status: 'active' | 'inactive';
+    /** 运行时版本要求 */
+    runtimeVersion?: string;
+    /** CDN 域名 */
+    cdnDomain?: string;
+    /** 环境 */
+    environment: 'development' | 'staging' | 'production';
+    /** 创建时间 */
+    createdAt: string;
+}
+/**
+ * 预览 Token
+ */
+interface PreviewToken {
+    /** Token 值 */
+    token: string;
+    /** 页面 UID */
+    pageUid: string;
+    /** 页面版本 ID */
+    pageVersionId: string;
+    /** 创建者 */
+    createdBy: string;
+    /** 过期时间 */
+    expiresAt: string;
+    /** 创建时间 */
+    createdAt: string;
+    /** 是否已使用 */
+    used?: boolean;
+}
+/**
+ * 预览 Token 创建请求
+ */
+interface CreatePreviewTokenRequest {
+    /** 页面 UID */
+    pageUid: string;
+    /** 页面版本 ID（可选，默认使用草稿） */
+    pageVersionId?: string;
+    /** 有效期（秒），默认 3600 */
+    ttl?: number;
+}
+/**
+ * Bootstrap 配置
+ * 页面静态导出产物之一，用于运行时初始化
+ */
+interface BootstrapConfig {
+    /** 版本 */
+    version: string;
+    /** 页面 UID */
+    pageUid: string;
+    /** 页面版本 ID */
+    pageVersionId: string;
+    /** 运行时版本 */
+    runtimeVersion: string;
+    /** 运行时入口 URL */
+    runtimeEntryUrl: string;
+    /** 页面 JSON URL */
+    pageJsonUrl: string;
+    /** Manifest URL */
+    manifestUrl: string;
+    /** CDN 基础路径 */
+    cdnBaseUrl: string;
+    /** API 基础路径 */
+    apiBaseUrl: string;
+    /** 功能开关 */
+    features?: Record<string, boolean>;
+    /** 生成时间 */
+    generatedAt: string;
+}
+/**
+ * 变更类型
+ */
+type ChangeType = 'create' | 'update' | 'delete' | 'publish' | 'rollback' | 'status_change' | 'config_change';
+/**
+ * 字段变更记录
+ */
+interface FieldChange {
+    /** 字段路径 */
+    path: string;
+    /** 旧值 */
+    oldValue: unknown;
+    /** 新值 */
+    newValue: unknown;
+    /** 变更类型 */
+    changeType: 'added' | 'modified' | 'removed';
+}
+/**
+ * 变更摘要（统一版本）
+ * 用于审计日志、版本对比、操作记录等场景
+ */
+interface ChangeSummary {
+    /** 变更类型 */
+    type: ChangeType;
+    /** 变更前快照（关键字段） */
+    before?: Record<string, unknown>;
+    /** 变更后快照（关键字段） */
+    after?: Record<string, unknown>;
+    /** 变更字段列表（简单版本） */
+    changedFields?: string[];
+    /** 变更字段详情（详细版本） */
+    fieldChanges?: FieldChange[];
+    /** 变更数量（批量操作） */
+    affectedCount?: number;
+    /** 人类可读的变更描述 */
+    description?: string;
+}
+/** @deprecated 使用 ChangeSummary 替代 */
+type ChangeRecord = ChangeSummary;
 /**
  * 深度只读类型
  */
@@ -424,32 +664,7 @@ interface EventAction {
     enabled?: boolean;
     delay?: number;
 }
-/**
- * 灰度规则
- */
-interface GrayRule {
-    /** 规则名称 */
-    name: string;
-    /** 规则类型 */
-    type: 'user' | 'ip' | 'header' | 'cookie' | 'custom';
-    /** 匹配条件 */
-    condition: string;
-    /** 是否启用 */
-    enabled: boolean;
-}
-/**
- * 灰度发布配置
- */
-interface GrayPublishConfig {
-    /** 灰度比例 (0-100) */
-    percentage?: number;
-    /** 白名单用户 UID */
-    whitelistUsers?: string[];
-    /** 白名单 IP */
-    whitelistIps?: string[];
-    /** 自定义规则 */
-    rules?: GrayRule[];
-}
+
 /**
  * 发布配置
  */
@@ -459,12 +674,15 @@ interface PublishConfig {
     /** 发布描述 */
     description?: string;
     /** 灰度配置（仅 gray 渠道） */
-    grayConfig?: GrayPublishConfig;
+    rolloutConfig?: RolloutConfig;
     /** 是否自动发布（跳过审核） */
     autoPublish?: boolean;
     /** 定时发布时间 */
     scheduledAt?: string;
 }
+/** @deprecated 使用 RolloutConfig 替代 */
+type GrayPublishConfig = RolloutConfig;
+
 /**
  * 版本信息
  */
@@ -505,290 +723,81 @@ interface ChangeLogItem {
 type ChangeLog = Record<string, ChangeLogItem>;
 
 /**
- * 组件 Meta Schema 类型定义
- * 定义每个组件版本必须包含的元数据
+ * Action 规范类型定义
+ * 用于 Action Gateway 的动作执行
  */
-/** JSON Schema 类型定义 */
-interface JsonSchema {
-    type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null';
-    title?: string;
-    description?: string;
-    default?: unknown;
-    enum?: unknown[];
-    properties?: Record<string, JsonSchema>;
-    items?: JsonSchema;
-    required?: string[];
-    minimum?: number;
-    maximum?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    format?: string;
-    $ref?: string;
+/** 内置动作类型 */
+type BuiltinActionType = 'claim' | 'signin' | 'lottery' | 'reserve' | 'share' | 'navigate' | 'track' | 'custom';
+/** 动作执行请求 */
+interface ActionExecuteRequest {
+    /** 动作类型 */
+    actionType: string;
+    /** 动作参数 */
+    params: Record<string, unknown>;
+    /** 上下文 */
+    context: ActionContext;
+    /** 幂等键 */
+    idempotencyKey?: string;
 }
-/** Props Schema - 组件属性定义 */
-interface PropsSchema {
-    $schema?: string;
-    type: 'object';
-    title: string;
-    description?: string;
-    properties: Record<string, JsonSchema & {
-        /** 属性分组 */
-        group?: string;
-        /** 编辑器中的控件类型 */
-        'x-editor-widget'?: string;
-        /** 是否支持表达式绑定 */
-        'x-expression-enabled'?: boolean;
-    }>;
-    required?: string[];
+
+/** 动作上下文（扩展自 BaseContext） */
+interface ActionContext extends BaseContext {
+    /** 组件版本 */
+    componentVersion?: string;
+    /** 组件 ID */
+    componentId?: string;
+    /** 动作 ID */
+    actionId?: string;
+    /** 扩展数据 */
+    extra?: Record<string, unknown>;
 }
-/** 事件定义 */
-interface EventDefinition {
-    /** 事件名称 */
+/** 动作执行响应 */
+interface ActionExecuteResponse<T = unknown> {
+    /** 是否成功 */
+    success: boolean;
+    /** 响应数据 */
+    data?: T;
+    /** 错误码 */
+    code?: number;
+    /** 错误信息 */
+    message?: string;
+    /** 追踪 ID */
+    traceId?: string;
+}
+/** 动作定义状态 */
+type ActionDefinitionStatus = 'active' | 'deprecated' | 'disabled';
+/** 动作定义 */
+interface ActionDefinition {
+    /** 动作 ID */
+    id: string;
+    /** 动作名称 */
     name: string;
-    /** 事件显示名 */
-    label: string;
-    /** 事件描述 */
+    /** 动作类型 */
+    actionType: string;
+    /** 描述 */
     description?: string;
-    /** 事件参数 Schema */
-    payload?: JsonSchema;
-}
-/** 组件事件列表 */
-interface EventsDefinition {
-    /** 事件版本 */
+    /** 参数 Schema */
+    paramsSchema: Record<string, unknown>;
+    /** 响应 Schema */
+    responseSchema?: Record<string, unknown>;
+    /** 是否需要认证 */
+    requiresAuth: boolean;
+    /** 幂等规则 */
+    idempotencyRule?: IdempotencyRule;
+    /** 频控规则 */
+    rateLimitRule?: RateLimitRule;
+    /** 版本 */
     version: string;
-    /** 事件列表 */
-    events: EventDefinition[];
+    /** 状态 */
+    status: ActionDefinitionStatus;
 }
-/** 组件能力声明 */
-interface CapabilitiesDefinition {
-    /** 能力版本 */
-    version: string;
-    /** 是否需要用户登录态 */
-    requiresAuth?: boolean;
-    /** 是否需要执行 Action */
-    requiresAction?: boolean;
-    /** 需要的 Action 类型 */
-    actionTypes?: string[];
-    /** 是否需要 Data Query */
-    requiresDataQuery?: boolean;
-    /** 需要的 Query 类型 */
-    queryTypes?: string[];
-    /** 是否需要导航能力 */
-    requiresNavigation?: boolean;
-    /** 是否需要埋点能力 */
-    requiresTrack?: boolean;
-    /** 是否需要对话框能力 */
-    requiresDialog?: boolean;
-    /** 是否需要剪贴板能力 */
-    requiresClipboard?: boolean;
-    /** 自定义能力 */
-    custom?: string[];
-}
-/** 兼容性定义 */
-interface CompatDefinition {
-    /** 兼容版本 */
-    version: string;
-    /** 最低运行时版本 */
-    minRuntime: string;
-    /** 最高运行时版本（可选） */
-    maxRuntime?: string;
-    /** 是否有破坏性变更 */
-    breaking?: boolean;
-    /** 破坏性变更说明 */
-    breakingChanges?: string[];
-    /** 从哪个版本可以无缝升级 */
-    upgradeFrom?: string[];
-}
-/** 组件分类 */
-type ComponentCategory = 'basic' | 'form' | 'layout' | 'navigation' | 'feedback' | 'display' | 'data' | 'business' | 'chart' | 'other';
-/** 组件分类列表（用于校验和 UI） */
-declare const COMPONENT_CATEGORIES: ComponentCategory[];
-/** SRI 完整性校验 */
-interface IntegrityDefinition {
-    /** 完整性版本 */
-    version: string;
-    /** 主入口文件哈希 */
-    main: string;
-    /** 所有文件哈希 */
-    files: Record<string, string>;
-    /** 生成时间 */
-    generatedAt: string;
-    /** 哈希算法 */
-    algorithm: 'sha256' | 'sha384' | 'sha512';
-}
-/** 组件状态 */
-type ComponentStatus = 'draft' | 'canary' | 'stable' | 'deprecated' | 'blocked';
-/** 组件版本元数据（完整） */
-interface ComponentMeta {
-    /** 组件名称 */
-    name: string;
-    /** 组件版本 */
-    version: string;
-    /** 显示名称 */
-    label: string;
-    /** 组件描述 */
-    description?: string;
-    /** 组件图标 */
-    icon?: string;
-    /** 组件分类 */
-    category: ComponentCategory;
-    /** 组件标签 */
-    tags?: string[];
-    /** 组件作者 */
-    author?: string;
-    /** 属性定义 */
-    props: PropsSchema;
-    /** 事件定义 */
-    events: EventsDefinition;
-    /** 能力声明 */
-    capabilities: CapabilitiesDefinition;
-    /** 兼容性 */
-    compat: CompatDefinition;
-    /** 完整性校验 */
-    integrity: IntegrityDefinition;
-    /** 组件状态 */
-    status: ComponentStatus;
-    /** 预览图 */
-    preview?: string;
-    /** 入口文件（相对路径） */
-    entry: string;
-    /** 样式文件（相对路径） */
-    styles?: string[];
-}
-/** Registry 中的组件版本记录 */
-interface ComponentVersionRecord {
-    /** 组件 ID */
-    componentId: string;
-    /** 组件名称 */
-    name: string;
-    /** 版本号 */
-    version: string;
-    /** CDN 入口 URL */
-    entryUrl: string;
-    /** 元数据 */
-    meta: ComponentMeta;
-    /** 状态 */
-    status: ComponentStatus;
-    /** 发布时间 */
-    publishedAt: string;
-    /** 发布者 */
-    publishedBy: string;
-    /** 阻断信息（如果被阻断） */
-    blockInfo?: {
-        reason: string;
-        blockedAt: string;
-        blockedBy: string;
-    };
-}
-/** Manifest 中的组件引用 */
-interface ManifestItem {
-    /** 组件名称 */
-    name: string;
-    /** 组件版本 */
-    version: string;
-    /** 入口 URL */
-    entryUrl: string;
-    /** SRI 哈希 */
-    integrity: string;
-    /** 是否必须成功加载 */
-    critical?: boolean;
-}
-/** 页面 Manifest */
-interface PageManifest {
-    /** Manifest 版本 */
-    manifestVersion: string;
-    /** 内容哈希 */
-    contentHash: string;
-    /** 运行时版本 */
-    runtimeVersion: string;
-    /** 组件清单 */
-    components: ManifestItem[];
-    /** 生成时间 */
-    generatedAt: string;
-}
-
-/**
- * Action 规范类型定义
- * 用于 Action Gateway 的动作执行
- */
-/** 内置动作类型 */
-type BuiltinActionType = 'claim' | 'signin' | 'lottery' | 'reserve' | 'share' | 'navigate' | 'track' | 'custom';
-/** 动作执行请求 */
-interface ActionExecuteRequest {
-    /** 动作类型 */
-    actionType: string;
-    /** 动作参数 */
-    params: Record<string, unknown>;
-    /** 上下文 */
-    context: ActionContext;
-    /** 幂等键 */
-    idempotencyKey?: string;
-}
-/** 动作上下文 */
-interface ActionContext {
-    /** 页面版本 ID */
-    pageVersionId?: string;
-    /** 组件版本 */
-    componentVersion?: string;
-    /** 用户 ID */
-    uid?: string;
-    /** 设备 ID */
-    deviceId?: string;
-    /** 渠道 */
-    channel?: string;
-    /** 追踪 ID */
-    traceId?: string;
-    /** 扩展数据 */
-    extra?: Record<string, unknown>;
-}
-/** 动作执行响应 */
-interface ActionExecuteResponse<T = unknown> {
-    /** 是否成功 */
-    success: boolean;
-    /** 响应数据 */
-    data?: T;
-    /** 错误码 */
-    code?: number;
-    /** 错误信息 */
-    message?: string;
-    /** 追踪 ID */
-    traceId?: string;
-}
-/** 动作定义状态 */
-type ActionDefinitionStatus = 'active' | 'deprecated' | 'disabled';
-/** 动作定义 */
-interface ActionDefinition {
-    /** 动作 ID */
-    id: string;
-    /** 动作名称 */
-    name: string;
-    /** 动作类型 */
-    actionType: string;
-    /** 描述 */
-    description?: string;
-    /** 参数 Schema */
-    paramsSchema: Record<string, unknown>;
-    /** 响应 Schema */
-    responseSchema?: Record<string, unknown>;
-    /** 是否需要认证 */
-    requiresAuth: boolean;
-    /** 幂等规则 */
-    idempotencyRule?: IdempotencyRule;
-    /** 频控规则 */
-    rateLimitRule?: RateLimitRule;
-    /** 版本 */
-    version: string;
-    /** 状态 */
-    status: ActionDefinitionStatus;
-}
-/** 动作定义版本（不可变） */
-interface ActionDefinitionVersion {
-    /** 版本 ID */
-    id: string;
-    /** 所属定义 ID */
-    definitionId: string;
-    /** 版本号 */
+/** 动作定义版本（不可变） */
+interface ActionDefinitionVersion {
+    /** 版本 ID */
+    id: string;
+    /** 所属定义 ID */
+    definitionId: string;
+    /** 版本号 */
     version: string;
     /** 定义快照 */
     spec: ActionDefinition;
@@ -843,12 +852,17 @@ interface RiskCheckResult {
     /** 拒绝原因 */
     rejectReason?: string;
 }
-/** 动作审计日志 */
-interface ActionAuditLog {
+/**
+ * 动作执行日志
+ * 记录动作执行的请求/响应详情，用于问题排查和性能分析
+ */
+interface ActionExecutionLog {
     /** 日志 ID */
     id: string;
     /** 动作类型 */
     actionType: string;
+    /** 动作定义版本 ID */
+    actionDefVersionId?: string;
     /** 请求参数 */
     params: Record<string, unknown>;
     /** 上下文 */
@@ -866,6 +880,8 @@ interface ActionAuditLog {
     /** 创建时间 */
     createdAt: string;
 }
+/** @deprecated 使用 ActionExecutionLog 替代 */
+type ActionAuditLog = ActionExecutionLog;
 
 /**
  * Data Query 规范类型定义
@@ -880,14 +896,13 @@ interface DataQueryRequest {
     /** 上下文 */
     context?: DataQueryContext;
 }
-/** 查询上下文 */
-interface DataQueryContext {
-    /** 页面版本 ID */
-    pageVersionId?: string;
-    /** 用户 ID */
-    uid?: string;
-    /** 追踪 ID */
-    traceId?: string;
+
+/** 查询上下文（扩展自 BaseContext） */
+interface DataQueryContext extends BaseContext {
+    /** 来源组件 ID */
+    sourceComponentId?: string;
+    /** 来源组件类型 */
+    sourceComponentType?: string;
 }
 /** 数据查询响应 */
 interface DataQueryResponse<T = unknown> {
@@ -1009,8 +1024,11 @@ interface QueryPermissionConfig {
     /** 字段权限 */
     fieldPermissions?: FieldPermission[];
 }
-/** 查询审计日志 */
-interface QueryAuditLog {
+/**
+ * 查询执行日志
+ * 记录查询执行的请求/响应详情，用于问题排查和性能分析
+ */
+interface QueryExecutionLog {
     /** 日志 ID */
     id: string;
     /** 查询版本 ID */
@@ -1025,6 +1043,8 @@ interface QueryAuditLog {
     fromCache?: boolean;
     /** 错误码 */
     code?: number;
+    /** 错误信息 */
+    message?: string;
     /** 耗时（ms） */
     duration: number;
     /** 追踪 ID */
@@ -1032,6 +1052,8 @@ interface QueryAuditLog {
     /** 创建时间 */
     createdAt: string;
 }
+/** @deprecated 使用 QueryExecutionLog 替代 */
+type QueryAuditLog = QueryExecutionLog;
 
 /**
  * HostAPI 类型定义
@@ -1186,690 +1208,3404 @@ interface HostAPI {
      */
     getContext(): RuntimeContext;
 }
-/** 运行时上下文 */
-interface RuntimeContext {
+
+/** 运行时上下文（扩展自 BaseContext） */
+interface RuntimeContext extends BaseContext {
     /** 页面 UID */
     pageUid: string;
-    /** 页面版本 ID */
+    /** 页面版本 ID（重写为必填） */
     pageVersionId: string;
     /** 运行时版本 */
     runtimeVersion: string;
-    /** 用户 ID */
+    /** 用户 ID（别名，与 uid 同义） */
     userId?: string;
-    /** 设备 ID */
-    deviceId?: string;
-    /** 渠道 */
-    channel?: string;
     /** 是否编辑模式 */
     isEditMode: boolean;
     /** 是否预览模式 */
     isPreviewMode: boolean;
+    /** 会话 ID */
+    sessionId?: string;
 }
 
 /**
- * 资源相关类型定义
- * 用于管理图片、视频、文档等资源
+ * Web Component 开发相关类型定义
+ * 组件必须遵循这些接口规范
  */
+
 /**
- * 资源状态
- * - active: 活跃
- * - archived: 已归档
+ * 组件生命周期阶段
  */
-type AssetStatus = 'active' | 'archived';
+type ComponentLifecyclePhase = 'created' | 'connected' | 'ready' | 'updated' | 'disconnected' | 'error';
 /**
- * 资源类型
- * - image: 图片
- * - video: 视频
- * - audio: 音频
- * - document: 文档
- * - other: 其他
+ * 组件生命周期回调
  */
-type AssetType = 'image' | 'video' | 'audio' | 'document' | 'other';
+interface ComponentLifecycleCallbacks {
+    /** 组件创建时调用 */
+    onCreated?: () => void;
+    /** 组件挂载到 DOM 时调用 */
+    onConnected?: () => void;
+    /** 组件首次渲染完成时调用 */
+    onReady?: () => void;
+    /** 组件属性更新时调用 */
+    onUpdated?: (changedProps: string[]) => void;
+    /** 组件从 DOM 移除时调用 */
+    onDisconnected?: () => void;
+    /** 组件发生错误时调用 */
+    onError?: (error: Error) => void;
+}
 /**
- * 资源排序字段
+ * DJV 组件基础接口
+ * 所有低代码组件必须实现此接口
  */
-type AssetSortField = 'id' | 'createdAt' | 'size' | 'filename';
+interface DjvComponent extends HTMLElement {
+    /** 组件名称 */
+    readonly componentName: string;
+    /** 组件版本 */
+    readonly componentVersion: string;
+    /** HostAPI 引用（由运行时注入） */
+    hostApi?: HostAPI;
+    /** 组件配置属性 */
+    props: Record<string, unknown>;
+    /** 组件内部状态 */
+    state?: Record<string, unknown>;
+    /** 组件初始化 */
+    init?(): void;
+    /** 组件销毁清理 */
+    destroy?(): void;
+    /** 属性变化回调 */
+    onPropsChange?(changedProps: Record<string, {
+        oldValue: unknown;
+        newValue: unknown;
+    }>): void;
+}
 /**
- * 资源元数据
+ * 组件构造器类型
  */
-interface AssetMeta {
-    /** 原始文件名 */
-    originalName: string;
-    /** MIME 类型 */
-    mimeType: string;
-    /** 文件大小（字节） */
-    size: number;
-    /** 宽度（仅图片/视频） */
-    width?: number;
-    /** 高度（仅图片/视频） */
-    height?: number;
-    /** 时长（仅音频/视频，秒） */
-    duration?: number;
-    /** 扩展信息 */
-    extra?: Record<string, unknown>;
-}
+type DjvComponentConstructor = {
+    new (): DjvComponent;
+    /** 观察的属性列表（用于属性反射） */
+    observedAttributes?: string[];
+    /** 组件元数据 */
+    componentMeta?: ComponentMetaLite;
+};
 /**
- * 资源信息
+ * 组件元数据精简版（用于运行时）
  */
-interface Asset {
-    /** 资源 ID */
-    id: string;
-    /** 资源名称 */
+interface ComponentMetaLite {
     name: string;
-    /** 资源类型 */
-    type: AssetType;
-    /** 资源状态 */
-    status: AssetStatus;
-    /** 存储路径/URL */
-    url: string;
-    /** 缩略图 URL */
-    thumbnailUrl?: string;
-    /** 元数据 */
-    meta: AssetMeta;
-    /** 标签 */
-    tags?: string[];
-    /** 所属目录 */
-    folderId?: string;
-    /** 创建时间 */
-    createdAt: string;
-    /** 创建者 */
-    createdBy: string;
-    /** 更新时间 */
-    updatedAt?: string;
+    version: string;
+    label: string;
+    category: string;
 }
-
 /**
- * 运行时相关类型定义
- * 包括页面解析结果、运行时配置、Manifest 等
+ * 属性变更事件
  */
-
+interface PropChangeEvent {
+    /** 属性名 */
+    propName: string;
+    /** 旧值 */
+    oldValue: unknown;
+    /** 新值 */
+    newValue: unknown;
+    /** 变更时间 */
+    timestamp: number;
+}
 /**
- * 运行时配置
- * 控制运行时行为的动态配置
+ * 属性观察器配置
  */
-interface RuntimeConfig {
-    /** Kill Switch 列表（紧急禁用的 actionType） */
-    killSwitches?: string[];
-    /** 被阻断的组件版本列表 */
-    blockedComponents?: BlockedComponent[];
-    /** 功能开关 */
-    features?: Record<string, boolean>;
-    /** 灰度配置 */
-    rollout?: RolloutConfig;
-    /** 调试模式 */
-    debug?: boolean;
+interface PropObserverConfig {
+    /** 属性名 */
+    propName: string;
+    /** 是否深度监听 */
+    deep?: boolean;
+    /** 是否立即触发 */
+    immediate?: boolean;
+    /** 防抖时间（ms） */
+    debounce?: number;
 }
 /**
- * 被阻断的组件信息
+ * 插槽类型
  */
-interface BlockedComponent {
-    /** 组件名称 */
-    name: string;
-    /** 被阻断的版本（支持 semver range） */
-    version: string;
-    /** 阻断原因 */
-    reason: string;
-    /** 阻断时间 */
-    blockedAt: string;
-}
+type SlotType = 'default' | 'named';
 /**
- * 灰度配置
+ * 插槽定义
  */
-interface RolloutConfig {
-    /** 是否启用 */
-    enabled: boolean;
-    /** 灰度百分比 (0-100) */
-    percentage?: number;
-    /** 白名单用户 */
-    whitelistUsers?: string[];
-    /** 黑名单用户 */
-    blacklistUsers?: string[];
+interface SlotDefinition {
+    /** 插槽名称（default 为默认插槽） */
+    name: string;
+    /** 插槽显示名 */
+    label: string;
+    /** 插槽描述 */
+    description?: string;
+    /** 是否必填 */
+    required?: boolean;
+    /** 允许的子组件类型（空数组表示允许所有） */
+    allowedComponents?: string[];
+    /** 最大子组件数量 */
+    maxChildren?: number;
+    /** 最小子组件数量 */
+    minChildren?: number;
 }
 /**
- * 页面解析请求
- * GET /page/resolve
+ * 组件插槽配置
  */
-interface PageResolveRequest {
-    /** 页面 UID */
-    pageUid: string;
-    /** 渠道 */
-    channel?: string;
-    /** 用户 ID（用于灰度） */
-    uid?: string;
-    /** 设备 ID */
-    deviceId?: string;
-    /** 预览 Token */
-    previewToken?: string;
+interface SlotsDefinition {
+    /** 版本 */
+    version: string;
+    /** 插槽列表 */
+    slots: SlotDefinition[];
+    /** 是否支持任意插槽 */
+    allowCustomSlots?: boolean;
 }
 /**
- * 页面解析结果
- * GET /page/resolve 的响应数据
+ * 组件渲染上下文
+ * 运行时传递给组件的上下文信息
  */
-interface PageResolveResult {
-    /** 页面 UID */
-    pageUid: string;
+interface ComponentRenderContext {
+    /** 组件实例 ID */
+    instanceId: string;
     /** 页面版本 ID */
     pageVersionId: string;
-    /** 页面 JSON */
-    pageJson: PageSchema;
-    /** 组件清单 */
-    manifest: PageManifest;
-    /** 运行时配置 */
-    runtimeConfig: RuntimeConfig;
-    /** 运行时版本要求 */
+    /** 运行时版本 */
     runtimeVersion: string;
+    /** 是否编辑模式 */
+    isEditMode: boolean;
     /** 是否预览模式 */
-    isPreview?: boolean;
+    isPreviewMode: boolean;
+    /** 父组件 ID */
+    parentId?: string;
+    /** 在父组件中的位置索引 */
+    index?: number;
+    /** 循环渲染时的数据项 */
+    loopItem?: unknown;
+    /** 循环渲染时的索引 */
+    loopIndex?: number;
 }
 /**
- * 组件加载状态
+ * 组件事件发射器接口
  */
-type ComponentLoadStatus = 'pending' | 'loading' | 'loaded' | 'failed' | 'blocked';
+interface ComponentEventEmitter {
+    /**
+     * 发射组件事件
+     * @param eventName 事件名称（需在 events.json 中声明）
+     * @param payload 事件数据
+     */
+    emit(eventName: string, payload?: Record<string, unknown>): void;
+}
 /**
- * 组件加载结果
+ * 组件事件详情
  */
-interface ComponentLoadResult {
-    /** 组件名称 */
-    name: string;
-    /** 组件版本 */
-    version: string;
-    /** 加载状态 */
-    status: ComponentLoadStatus;
-    /** 组件类/构造函数 */
-    component?: unknown;
-    /** 错误信息 */
-    error?: string;
-    /** 加载耗时（ms） */
-    loadTime?: number;
+interface ComponentEventDetail<T = unknown> {
+    /** 事件来源组件 ID */
+    sourceComponentId: string;
+    /** 事件来源组件类型 */
+    sourceComponentType: string;
+    /** 事件来源组件版本 */
+    sourceComponentVersion: string;
+    /** 事件数据 */
+    payload: T;
+    /** 事件时间戳 */
+    timestamp: number;
 }
 /**
- * 组件注册表
+ * 样式隔离模式
  */
-interface ComponentRegistry {
-    /** 已注册的组件 */
-    components: Map<string, ComponentLoadResult>;
-    /** 注册组件 */
-    register(name: string, component: unknown): void;
-    /** 获取组件 */
-    get(name: string): ComponentLoadResult | undefined;
-    /** 检查组件是否已加载 */
-    has(name: string): boolean;
-}
+type StyleIsolationMode = 'shadow' | 'scoped' | 'none';
 /**
- * 运行时错误类型
+ * Shadow DOM 配置
  */
-type RuntimeErrorType = 'LOAD_ERROR' | 'RENDER_ERROR' | 'ACTION_ERROR' | 'QUERY_ERROR' | 'EXPRESSION_ERROR' | 'INTEGRITY_ERROR' | 'BLOCKED_ERROR';
+interface ShadowDomConfig {
+    /** 模式 */
+    mode: 'open' | 'closed';
+    /** 是否可委托焦点 */
+    delegatesFocus?: boolean;
+    /** 插槽分配模式 */
+    slotAssignment?: 'named' | 'manual';
+}
 /**
- * 运行时错误
+ * 组件注册选项
  */
-interface RuntimeError {
-    /** 错误类型 */
-    type: RuntimeErrorType;
-    /** 错误消息 */
-    message: string;
-    /** 组件 ID */
-    componentId?: string;
-    /** 组件类型 */
-    componentType?: string;
-    /** 组件版本 */
-    componentVersion?: string;
-    /** 动作 ID */
-    actionId?: string;
-    /** 堆栈 */
-    stack?: string;
-    /** 追踪 ID */
-    traceId?: string;
-    /** 发生时间 */
-    timestamp: number;
+interface ComponentRegisterOptions {
+    /** 自定义元素名称 */
+    tagName: string;
+    /** 组件构造器 */
+    constructor: DjvComponentConstructor;
+    /** 样式隔离模式 */
+    styleIsolation?: StyleIsolationMode;
+    /** Shadow DOM 配置 */
+    shadowConfig?: ShadowDomConfig;
+    /** 是否延迟注册 */
+    lazy?: boolean;
 }
 /**
- * 错误边界处理器
+ * 组件注册结果
  */
-interface ErrorBoundaryHandler {
-    /** 处理错误 */
-    handleError(error: RuntimeError): void;
-    /** 渲染 fallback */
-    renderFallback(error: RuntimeError): unknown;
+interface ComponentRegisterResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 注册的标签名 */
+    tagName?: string;
+    /** 错误信息 */
+    error?: string;
 }
+
 /**
- * 性能指标类型
+ * 编辑器控件类型定义
+ * 定义属性面板中可用的编辑控件
  */
-type PerformanceMetricType = 'page_resolve' | 'component_load' | 'first_render' | 'action_execute' | 'query_execute';
 /**
- * 性能指标
+ * 编辑器控件类型枚举
+ * 对应属性 Schema 中的 x-editor-widget 字段
  */
-interface PerformanceMetric {
-    /** 指标类型 */
-    type: PerformanceMetricType;
-    /** 名称/标识 */
-    name: string;
-    /** 耗时（ms） */
-    duration: number;
-    /** 开始时间 */
-    startTime: number;
-    /** 额外数据 */
-    extra?: Record<string, unknown>;
+type EditorWidgetType = 'input' | 'textarea' | 'number' | 'slider' | 'switch' | 'checkbox' | 'radio' | 'select' | 'multi-select' | 'color' | 'color-palette' | 'gradient' | 'size' | 'spacing' | 'border' | 'border-radius' | 'position' | 'alignment' | 'image' | 'video' | 'icon' | 'file' | 'rich-text' | 'markdown' | 'code' | 'json' | 'expression' | 'data-binding' | 'action' | 'event' | 'flex' | 'grid' | 'array' | 'object' | 'condition' | 'formula' | 'link' | 'page-link' | 'date' | 'time' | 'datetime' | 'date-range' | 'custom';
+/**
+ * 控件基础配置
+ */
+interface WidgetBaseConfig {
+    /** 控件类型 */
+    type: EditorWidgetType;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 占位文本 */
+    placeholder?: string;
+    /** 帮助文本 */
+    help?: string;
+    /** 是否隐藏 */
+    hidden?: boolean;
+    /** 显示条件（表达式） */
+    showWhen?: string;
 }
 /**
- * 运行时事件类型
+ * 文本输入控件配置
  */
-type RuntimeEventType = 'page:loaded' | 'page:error' | 'component:mounted' | 'component:unmounted' | 'component:error' | 'action:start' | 'action:success' | 'action:error' | 'query:start' | 'query:success' | 'query:error';
+interface InputWidgetConfig extends WidgetBaseConfig {
+    type: 'input' | 'textarea';
+    /** 最大长度 */
+    maxLength?: number;
+    /** 最小长度 */
+    minLength?: number;
+    /** 输入模式 */
+    inputMode?: 'text' | 'email' | 'url' | 'tel' | 'numeric';
+    /** 前缀 */
+    prefix?: string;
+    /** 后缀 */
+    suffix?: string;
+    /** 是否显示字数统计 */
+    showCount?: boolean;
+    /** 行数（仅 textarea） */
+    rows?: number;
+}
 /**
- * 运行时事件
+ * 数字输入控件配置
  */
-interface RuntimeEvent<T = unknown> {
-    /** 事件类型 */
-    type: RuntimeEventType;
-    /** 事件数据 */
-    data: T;
-    /** 时间戳 */
-    timestamp: number;
-    /** 追踪 ID */
-    traceId?: string;
+interface NumberWidgetConfig extends WidgetBaseConfig {
+    type: 'number' | 'slider';
+    /** 最小值 */
+    min?: number;
+    /** 最大值 */
+    max?: number;
+    /** 步长 */
+    step?: number;
+    /** 精度 */
+    precision?: number;
+    /** 单位 */
+    unit?: string;
+    /** 是否显示增减按钮 */
+    showButtons?: boolean;
 }
 /**
- * 事件总线接口
+ * 选择控件配置
  */
-interface EventBus {
-    /** 发送事件 */
-    emit<T>(event: RuntimeEvent<T>): void;
-    /** 订阅事件 */
-    on<T>(type: RuntimeEventType, handler: (event: RuntimeEvent<T>) => void): () => void;
-    /** 取消订阅 */
-    off<T>(type: RuntimeEventType, handler: (event: RuntimeEvent<T>) => void): void;
+interface SelectWidgetConfig extends WidgetBaseConfig {
+    type: 'select' | 'multi-select' | 'radio' | 'checkbox';
+    /** 选项列表 */
+    options: SelectOption[];
+    /** 是否可搜索 */
+    searchable?: boolean;
+    /** 是否可清除 */
+    clearable?: boolean;
+    /** 是否允许创建新选项 */
+    allowCreate?: boolean;
+    /** 最大选择数量（多选） */
+    maxSelect?: number;
+    /** 选项来源（动态选项） */
+    optionsSource?: OptionsSource;
 }
-
 /**
- * 统一 API 响应类型定义
- * 所有 API 响应遵循统一格式
+ * 选择选项
  */
-
+interface SelectOption {
+    /** 选项值 */
+    value: string | number | boolean;
+    /** 显示标签 */
+    label: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 图标 */
+    icon?: string;
+    /** 描述 */
+    description?: string;
+    /** 分组 */
+    group?: string;
+}
 /**
- * 统一 API 响应格式
+ * 动态选项来源
  */
-interface ApiResponse<T = unknown> {
-    /** 是否成功 */
-    success: boolean;
-    /** 响应数据 */
-    data?: T;
-    /** 错误码 */
-    code?: ErrorCode | number;
-    /** 错误信息 */
-    message?: string;
-    /** 追踪 ID */
-    traceId?: string;
-    /** 请求 ID */
-    requestId?: string;
-    /** 时间戳 */
-    timestamp?: number;
+interface OptionsSource {
+    /** 来源类型 */
+    type: 'static' | 'api' | 'query';
+    /** API URL（api 类型） */
+    url?: string;
+    /** Query ID（query 类型） */
+    queryId?: string;
+    /** 值字段路径 */
+    valuePath?: string;
+    /** 标签字段路径 */
+    labelPath?: string;
+    /** 依赖的属性 */
+    dependsOn?: string[];
 }
 /**
- * 分页 API 响应格式
+ * 颜色控件配置
  */
-interface PaginatedApiResponse<T> extends ApiResponse<T[]> {
-    /** 分页信息 */
-    pagination?: {
-        /** 当前页码 */
-        page: number;
-        /** 每页数量 */
-        pageSize: number;
-        /** 总数量 */
-        total: number;
-        /** 总页数 */
-        totalPages: number;
-    };
+interface ColorWidgetConfig extends WidgetBaseConfig {
+    type: 'color' | 'color-palette' | 'gradient';
+    /** 预设颜色 */
+    presets?: string[];
+    /** 是否支持透明度 */
+    allowAlpha?: boolean;
+    /** 颜色格式 */
+    format?: 'hex' | 'rgb' | 'hsl';
+    /** 是否使用设计系统变量 */
+    useDesignTokens?: boolean;
 }
 /**
- * 标准请求头
+ * 尺寸控件配置
  */
-interface StandardRequestHeaders {
-    /** 追踪 ID */
-    'x-trace-id'?: string;
-    /** 请求 ID */
-    'x-request-id'?: string;
-    /** 页面版本 ID */
-    'x-page-version-id'?: string;
-    /** 组件版本 */
-    'x-component-version'?: string;
-    /** 用户 ID */
-    'x-user-id'?: string;
-    /** 设备 ID */
-    'x-device-id'?: string;
-    /** 渠道 */
-    'x-channel'?: string;
-    /** 应用 ID */
-    'x-app-id'?: string;
+interface SizeWidgetConfig extends WidgetBaseConfig {
+    type: 'size' | 'spacing' | 'border-radius';
+    /** 允许的单位 */
+    units?: ('px' | 'rem' | 'em' | '%' | 'vw' | 'vh' | 'auto')[];
+    /** 是否联动 */
+    linked?: boolean;
+    /** 最小值 */
+    min?: number;
+    /** 最大值 */
+    max?: number;
 }
 /**
- * 标准响应头
+ * 媒体控件配置
  */
-interface StandardResponseHeaders {
+interface MediaWidgetConfig extends WidgetBaseConfig {
+    type: 'image' | 'video' | 'file';
+    /** 接受的文件类型 */
+    accept?: string;
+    /** 最大文件大小（字节） */
+    maxSize?: number;
+    /** 是否支持多选 */
+    multiple?: boolean;
+    /** 是否显示裁剪器 */
+    crop?: boolean;
+    /** 裁剪比例 */
+    aspectRatio?: number;
+}
+/**
+ * 代码控件配置
+ */
+interface CodeWidgetConfig extends WidgetBaseConfig {
+    type: 'code' | 'json' | 'expression';
+    /** 代码语言 */
+    language?: 'javascript' | 'typescript' | 'json' | 'css' | 'html';
+    /** 是否显示行号 */
+    lineNumbers?: boolean;
+    /** 主题 */
+    theme?: 'light' | 'dark' | 'auto';
+    /** 最大高度 */
+    maxHeight?: number;
+}
+/**
+ * 数组控件配置
+ */
+interface ArrayWidgetConfig extends WidgetBaseConfig {
+    type: 'array';
+    /** 子项 Schema */
+    itemSchema: Record<string, unknown>;
+    /** 最小数量 */
+    minItems?: number;
+    /** 最大数量 */
+    maxItems?: number;
+    /** 是否可排序 */
+    sortable?: boolean;
+    /** 是否可折叠 */
+    collapsible?: boolean;
+    /** 默认折叠 */
+    defaultCollapsed?: boolean;
+    /** 项标题模板 */
+    itemTitleTemplate?: string;
+}
+/**
+ * 对象控件配置
+ */
+interface ObjectWidgetConfig extends WidgetBaseConfig {
+    type: 'object';
+    /** 属性 Schema */
+    properties: Record<string, unknown>;
+    /** 是否可折叠 */
+    collapsible?: boolean;
+    /** 默认折叠 */
+    defaultCollapsed?: boolean;
+    /** 布局模式 */
+    layout?: 'vertical' | 'horizontal' | 'inline';
+}
+/**
+ * 自定义控件配置
+ */
+interface CustomWidgetConfig extends WidgetBaseConfig {
+    type: 'custom';
+    /** 自定义控件组件名 */
+    component: string;
+    /** 传递给自定义控件的额外属性 */
+    componentProps?: Record<string, unknown>;
+}
+/**
+ * 所有控件配置联合类型
+ */
+type WidgetConfig = InputWidgetConfig | NumberWidgetConfig | SelectWidgetConfig | ColorWidgetConfig | SizeWidgetConfig | MediaWidgetConfig | CodeWidgetConfig | ArrayWidgetConfig | ObjectWidgetConfig | CustomWidgetConfig | WidgetBaseConfig;
+/**
+ * 属性分组定义
+ */
+interface PropertyGroup {
+    /** 分组 ID */
+    id: string;
+    /** 分组名称 */
+    label: string;
+    /** 分组图标 */
+    icon?: string;
+    /** 排序权重 */
+    order?: number;
+    /** 是否默认展开 */
+    defaultExpanded?: boolean;
+    /** 包含的属性名列表 */
+    properties?: string[];
+}
+/**
+ * 属性面板配置
+ */
+interface PropertyPanelConfig {
+    /** 分组列表 */
+    groups: PropertyGroup[];
+    /** 默认分组（未指定分组的属性归入） */
+    defaultGroup?: string;
+    /** 是否显示高级属性 */
+    showAdvanced?: boolean;
+}
+/**
+ * 内置属性分组
+ */
+declare const BUILTIN_PROPERTY_GROUPS: PropertyGroup[];
+
+/**
+ * 组件 Registry 相关类型定义
+ * 用于组件版本解析、搜索筛选
+ */
+
+/**
+ * 版本解析请求
+ */
+interface ResolveVersionsRequest {
+    /** 需要解析的组件列表 */
+    components: ComponentVersionQuery[];
+    /** 运行时版本（用于兼容性检查） */
+    runtimeVersion?: string;
+    /** 是否包含预发布版本 */
+    includePrerelease?: boolean;
+    /** 是否跳过被阻断的版本 */
+    skipBlocked?: boolean;
+}
+/**
+ * 组件版本查询
+ */
+interface ComponentVersionQuery {
+    /** 组件名称 */
+    name: string;
+    /** 版本范围（semver range），如 "^1.0.0", "~1.2.0", ">=1.0.0 <2.0.0" */
+    versionRange: string;
+}
+/**
+ * 版本解析响应
+ */
+interface ResolveVersionsResponse {
+    /** 解析成功的组件 */
+    resolved: ResolvedComponent[];
+    /** 解析失败的组件 */
+    failed: FailedComponent[];
+    /** 有警告的组件（如使用了 deprecated 版本） */
+    warnings: ComponentWarning[];
+}
+/**
+ * 解析成功的组件
+ */
+interface ResolvedComponent {
+    /** 组件名称 */
+    name: string;
+    /** 请求的版本范围 */
+    requestedRange: string;
+    /** 解析到的版本 */
+    resolvedVersion: string;
+    /** 组件入口 URL */
+    entryUrl: string;
+    /** SRI 完整性哈希 */
+    integrity: string;
+    /** 样式 URL */
+    styleUrl?: string;
+    /** 组件状态 */
+    status: ComponentStatus;
+    /** 是否有更新版本可用 */
+    hasNewerVersion?: boolean;
+    /** 最新稳定版本 */
+    latestStableVersion?: string;
+}
+/**
+ * 解析失败的组件
+ */
+interface FailedComponent {
+    /** 组件名称 */
+    name: string;
+    /** 请求的版本范围 */
+    requestedRange: string;
+    /** 失败原因 */
+    reason: ResolveFailReason;
+    /** 详细错误信息 */
+    message: string;
+    /** 建议的版本（如有） */
+    suggestedVersion?: string;
+}
+/**
+ * 解析失败原因
+ */
+type ResolveFailReason = 'NOT_FOUND' | 'VERSION_NOT_FOUND' | 'ALL_BLOCKED' | 'INCOMPATIBLE' | 'INVALID_RANGE' | 'ACCESS_DENIED';
+/**
+ * 组件警告信息
+ */
+interface ComponentWarning {
+    /** 组件名称 */
+    name: string;
+    /** 版本 */
+    version: string;
+    /** 警告类型 */
+    type: ComponentWarningType;
+    /** 警告信息 */
+    message: string;
+}
+/**
+ * 组件警告类型
+ */
+type ComponentWarningType = 'DEPRECATED' | 'SECURITY' | 'BREAKING_CHANGE' | 'NEAR_EOL';
+/**
+ * 组件搜索请求
+ */
+interface SearchComponentsRequest extends PaginationParams {
+    /** 搜索关键词 */
+    keyword?: string;
+    /** 分类筛选 */
+    categories?: ComponentCategory[];
+    /** 状态筛选 */
+    statuses?: ComponentStatus[];
+    /** 标签筛选 */
+    tags?: string[];
+    /** 作者筛选 */
+    author?: string;
+    /** 排序字段 */
+    sortBy?: ComponentSortField;
+    /** 排序方向 */
+    sortOrder?: SortOrder;
+    /** 是否只返回最新版本 */
+    latestOnly?: boolean;
+    /** 最低运行时版本兼容 */
+    minRuntimeVersion?: string;
+}
+/**
+ * 组件排序字段
+ */
+type ComponentSortField = 'name' | 'publishedAt' | 'updatedAt' | 'downloadCount' | 'version';
+/**
+ * 组件搜索响应
+ */
+interface SearchComponentsResponse {
+    /** 组件列表 */
+    items: ComponentSearchItem[];
+    /** 分页信息 */
+    meta: PaginationMeta;
+    /** 筛选聚合 */
+    aggregations?: ComponentAggregations;
+}
+/**
+ * 组件搜索结果项
+ */
+interface ComponentSearchItem {
+    /** 组件 ID */
+    id: string;
+    /** 组件名称 */
+    name: string;
+    /** 最新版本 */
+    latestVersion: string;
+    /** 显示名称 */
+    label: string;
+    /** 描述 */
+    description?: string;
+    /** 分类 */
+    category: ComponentCategory;
+    /** 标签 */
+    tags?: string[];
+    /** 作者 */
+    author?: string;
+    /** 状态 */
+    status: ComponentStatus;
+    /** 预览图 */
+    previewUrl?: string;
+    /** 下载次数 */
+    downloadCount?: number;
+    /** 发布时间 */
+    publishedAt: string;
+    /** 版本数量 */
+    versionCount: number;
+}
+/**
+ * 筛选聚合结果
+ */
+interface ComponentAggregations {
+    /** 分类分布 */
+    categories: AggregationBucket[];
+    /** 状态分布 */
+    statuses: AggregationBucket[];
+    /** 标签分布 */
+    tags: AggregationBucket[];
+    /** 作者分布 */
+    authors: AggregationBucket[];
+}
+/**
+ * 聚合桶
+ */
+interface AggregationBucket {
+    /** 值 */
+    key: string;
+    /** 数量 */
+    count: number;
+}
+/**
+ * 获取组件版本列表请求
+ */
+interface ListComponentVersionsRequest extends PaginationParams {
+    /** 组件名称 */
+    name: string;
+    /** 状态筛选 */
+    statuses?: ComponentStatus[];
+    /** 是否包含预发布版本 */
+    includePrerelease?: boolean;
+}
+/**
+ * 组件版本列表响应
+ */
+interface ListComponentVersionsResponse {
+    /** 版本列表 */
+    items: ComponentVersionInfo[];
+    /** 分页信息 */
+    meta: PaginationMeta;
+}
+/**
+ * 组件版本信息
+ */
+interface ComponentVersionInfo {
+    /** 版本 ID */
+    id: string;
+    /** 版本号 */
+    version: string;
+    /** 状态 */
+    status: ComponentStatus;
+    /** 是否预发布 */
+    prerelease: boolean;
+    /** 变更日志 */
+    changelog?: string;
+    /** 发布时间 */
+    publishedAt: string;
+    /** 发布者 */
+    publishedBy: string;
+    /** 下载次数 */
+    downloadCount?: number;
+    /** 兼容性信息 */
+    compat?: {
+        minRuntime: string;
+        maxRuntime?: string;
+        breaking?: boolean;
+    };
+    /** 阻断信息 */
+    blockInfo?: {
+        reason: string;
+        blockedAt: string;
+        blockedBy: string;
+    };
+}
+/**
+ * 注册组件版本请求
+ */
+interface RegisterComponentVersionRequest {
+    /** 组件名称 */
+    name: string;
+    /** 版本号 */
+    version: string;
+    /** 组件元数据 */
+    meta: ComponentMeta;
+    /** CDN 资源 URL 前缀 */
+    assetsBaseUrl: string;
+    /** 变更日志 */
+    changelog?: string;
+    /** 是否自动发布（跳过 draft 状态） */
+    autoPublish?: boolean;
+}
+/**
+ * 注册组件版本响应
+ */
+interface RegisterComponentVersionResponse {
+    /** 是否成功 */
+    success: boolean;
+    /** 版本 ID */
+    versionId?: string;
+    /** 组件 ID */
+    componentId?: string;
+    /** 当前状态 */
+    status?: ComponentStatus;
+    /** 错误信息 */
+    error?: string;
+}
+/**
+ * 变更组件版本状态请求
+ */
+interface ChangeComponentStatusRequest {
+    /** 组件名称 */
+    name: string;
+    /** 版本号 */
+    version: string;
+    /** 目标状态 */
+    targetStatus: ComponentStatus;
+    /** 变更原因 */
+    reason?: string;
+}
+/**
+ * 阻断组件请求
+ */
+interface BlockComponentRequest {
+    /** 组件名称 */
+    name: string;
+    /** 版本范围（支持 semver range） */
+    versionRange: string;
+    /** 阻断原因 */
+    reason: string;
+    /** 是否紧急阻断（跳过确认） */
+    urgent?: boolean;
+}
+/**
+ * 解除阻断请求
+ */
+interface UnblockComponentRequest {
+    /** 组件名称 */
+    name: string;
+    /** 版本范围 */
+    versionRange: string;
+    /** 解除原因 */
+    reason: string;
+}
+
+/**
+ * 运行时相关类型定义
+ * 包括页面解析结果、运行时配置、Manifest 等
+ *
+ * 注意：以下接口属于运行时实现，已移至 @djvlc/runtime-core：
+ * - ComponentRegistry（组件注册表实现）
+ * - EventBus（事件总线实现）
+ * - ErrorBoundaryHandler（错误边界处理实现）
+ *
+ * contracts 只定义协议与数据结构，不定义实现接口。
+ */
+
+/**
+ * Manifest 中的组件引用
+ */
+interface ManifestItem {
+    /** 组件名称 */
+    name: string;
+    /** 组件版本 */
+    version: string;
+    /** 入口 URL */
+    entryUrl: string;
+    /** 样式 URL */
+    styleUrl?: string;
+    /** SRI 哈希 */
+    integrity: string;
+    /** 是否必须成功加载 */
+    critical?: boolean;
+    /** 预加载优先级 */
+    preloadPriority?: 'high' | 'low' | 'auto';
+}
+/**
+ * 页面 Manifest
+ * 记录页面使用的组件版本及其加载信息
+ */
+interface PageManifest {
+    /** Manifest 版本 */
+    manifestVersion: string;
+    /** 内容哈希 */
+    contentHash: string;
+    /** 运行时版本 */
+    runtimeVersion: string;
+    /** 组件清单 */
+    components: ManifestItem[];
+    /** 生成时间 */
+    generatedAt: string;
+}
+/**
+ * 被阻断的组件信息
+ */
+interface BlockedComponent {
+    /** 组件名称 */
+    name: string;
+    /** 被阻断的版本（支持 semver range） */
+    version: string;
+    /** 阻断原因 */
+    reason: string;
+    /** 阻断时间 */
+    blockedAt: string;
+    /** 阻断者 */
+    blockedBy?: string;
+}
+/**
+ * 运行时配置
+ * 控制运行时行为的动态配置
+ */
+interface RuntimeConfig {
+    /** Kill Switch 列表（紧急禁用的 actionType） */
+    killSwitches?: string[];
+    /** Kill Switch 详细配置 */
+    killSwitchConfigs?: KillSwitchConfig[];
+    /** 被阻断的组件版本列表 */
+    blockedComponents?: BlockedComponent[];
+    /** 功能开关 */
+    features?: Record<string, boolean>;
+    /** 灰度配置 */
+    rollout?: RolloutConfig;
+    /** 调试模式 */
+    debug?: boolean;
+    /** API 基础路径覆盖 */
+    apiBaseUrl?: string;
+    /** CDN 基础路径覆盖 */
+    cdnBaseUrl?: string;
+}
+/**
+ * 页面解析请求
+ * GET /page/resolve
+ */
+interface PageResolveRequest {
+    /** 页面 UID */
+    pageUid: string;
+    /** 渠道 */
+    channel?: string;
+    /** 用户 ID（用于灰度） */
+    uid?: string;
+    /** 设备 ID */
+    deviceId?: string;
+    /** 预览 Token */
+    previewToken?: string;
+}
+/**
+ * 页面解析结果
+ * GET /page/resolve 的响应数据
+ */
+interface PageResolveResult {
+    /** 页面 UID */
+    pageUid: string;
+    /** 页面版本 ID */
+    pageVersionId: string;
+    /** 页面 JSON */
+    pageJson: PageSchema;
+    /** 组件清单 */
+    manifest: PageManifest;
+    /** 运行时配置 */
+    runtimeConfig: RuntimeConfig;
+    /** 运行时版本要求 */
+    runtimeVersion: string;
+    /** 是否预览模式 */
+    isPreview?: boolean;
+}
+/**
+ * 组件加载状态
+ */
+type ComponentLoadStatus = 'pending' | 'loading' | 'loaded' | 'failed' | 'blocked';
+/**
+ * 组件加载结果
+ */
+interface ComponentLoadResult {
+    /** 组件名称 */
+    name: string;
+    /** 组件版本 */
+    version: string;
+    /** 加载状态 */
+    status: ComponentLoadStatus;
+    /** 组件类/构造函数 */
+    component?: unknown;
+    /** 错误信息 */
+    error?: string;
+    /** 加载耗时（ms） */
+    loadTime?: number;
+}
+/**
+ * 运行时错误类型
+ */
+type RuntimeErrorType = 'LOAD_ERROR' | 'RENDER_ERROR' | 'ACTION_ERROR' | 'QUERY_ERROR' | 'EXPRESSION_ERROR' | 'INTEGRITY_ERROR' | 'BLOCKED_ERROR';
+/**
+ * 运行时错误
+ */
+interface RuntimeError {
+    /** 错误类型 */
+    type: RuntimeErrorType;
+    /** 错误消息 */
+    message: string;
+    /** 组件 ID */
+    componentId?: string;
+    /** 组件类型 */
+    componentType?: string;
+    /** 组件版本 */
+    componentVersion?: string;
+    /** 动作 ID */
+    actionId?: string;
+    /** 堆栈 */
+    stack?: string;
+    /** 追踪 ID */
+    traceId?: string;
+    /** 发生时间 */
+    timestamp: number;
+}
+/**
+ * 性能指标类型
+ */
+type PerformanceMetricType = 'page_resolve' | 'component_load' | 'first_render' | 'action_execute' | 'query_execute';
+/**
+ * 性能指标
+ */
+interface PerformanceMetric {
+    /** 指标类型 */
+    type: PerformanceMetricType;
+    /** 名称/标识 */
+    name: string;
+    /** 耗时（ms） */
+    duration: number;
+    /** 开始时间 */
+    startTime: number;
+    /** 额外数据 */
+    extra?: Record<string, unknown>;
+}
+/**
+ * 运行时事件类型
+ */
+type RuntimeEventType = 'page:loaded' | 'page:error' | 'component:mounted' | 'component:unmounted' | 'component:error' | 'action:start' | 'action:success' | 'action:error' | 'query:start' | 'query:success' | 'query:error';
+/**
+ * 运行时事件
+ */
+interface RuntimeEvent<T = unknown> {
+    /** 事件类型 */
+    type: RuntimeEventType;
+    /** 事件数据 */
+    data: T;
+    /** 时间戳 */
+    timestamp: number;
+    /** 追踪 ID */
+    traceId?: string;
+}
+/**
+ * 埋点事件类型
+ */
+type TrackEventType = 'page_view' | 'component_view' | 'component_click' | 'action_trigger' | 'action_success' | 'action_fail' | 'error' | 'performance' | 'custom';
+/**
+ * 埋点请求
+ */
+interface TrackRequest {
+    /** 事件类型 */
+    eventType: TrackEventType;
+    /** 事件名称 */
+    eventName: string;
+    /** 事件参数 */
+    params?: Record<string, unknown>;
+    /** 页面上下文 */
+    context: TrackContext;
+    /** 客户端时间戳 */
+    clientTimestamp: number;
+}
+/**
+ * 埋点上下文（继承 RuntimeContext）
+ * 扩展运行时上下文，添加埋点特有的字段
+ */
+interface TrackContext extends RuntimeContext {
+    /** 设备 ID（必填，重写为必填） */
+    deviceId: string;
+    /** 组件 ID */
+    componentId?: string;
+    /** 组件类型 */
+    componentType?: string;
+    /** 组件版本 */
+    componentVersion?: string;
+    /** 用户代理 */
+    userAgent?: string;
+    /** 屏幕分辨率 */
+    screenResolution?: string;
+    /** 页面 URL */
+    pageUrl?: string;
+    /** 来源页面 */
+    referrer?: string;
+}
+/**
+ * 批量埋点请求
+ */
+interface BatchTrackRequest {
+    /** 事件列表 */
+    events: TrackRequest[];
+    /** 公共上下文 */
+    commonContext?: Partial<TrackContext>;
+}
+/**
+ * 埋点响应
+ */
+interface TrackResponse {
+    /** 是否成功 */
+    success: boolean;
+    /** 接收的事件数量 */
+    received: number;
+    /** 服务器时间戳 */
+    serverTimestamp: number;
+}
+
+/**
+ * 组件 Meta Schema 类型定义
+ * 定义每个组件版本必须包含的元数据
+ */
+
+/** JSON Schema 类型定义 */
+interface JsonSchema {
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'null';
+    title?: string;
+    description?: string;
+    default?: unknown;
+    enum?: unknown[];
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    required?: string[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    $ref?: string;
+}
+/** Props Schema - 组件属性定义 */
+interface PropsSchema {
+    $schema?: string;
+    type: 'object';
+    title: string;
+    description?: string;
+    properties: Record<string, JsonSchema & {
+        /** 属性分组 */
+        group?: string;
+        /** 编辑器中的控件类型 */
+        'x-editor-widget'?: string;
+        /** 是否支持表达式绑定 */
+        'x-expression-enabled'?: boolean;
+    }>;
+    required?: string[];
+}
+/** 事件定义 */
+interface EventDefinition {
+    /** 事件名称 */
+    name: string;
+    /** 事件显示名 */
+    label: string;
+    /** 事件描述 */
+    description?: string;
+    /** 事件参数 Schema */
+    payload?: JsonSchema;
+}
+/** 组件事件列表 */
+interface EventsDefinition {
+    /** 事件版本 */
+    version: string;
+    /** 事件列表 */
+    events: EventDefinition[];
+}
+/** 组件能力声明 */
+interface CapabilitiesDefinition {
+    /** 能力版本 */
+    version: string;
+    /** 是否需要用户登录态 */
+    requiresAuth?: boolean;
+    /** 是否需要执行 Action */
+    requiresAction?: boolean;
+    /** 需要的 Action 类型 */
+    actionTypes?: string[];
+    /** 是否需要 Data Query */
+    requiresDataQuery?: boolean;
+    /** 需要的 Query 类型 */
+    queryTypes?: string[];
+    /** 是否需要导航能力 */
+    requiresNavigation?: boolean;
+    /** 是否需要埋点能力 */
+    requiresTrack?: boolean;
+    /** 是否需要对话框能力 */
+    requiresDialog?: boolean;
+    /** 是否需要剪贴板能力 */
+    requiresClipboard?: boolean;
+    /** 自定义能力 */
+    custom?: string[];
+}
+/** 兼容性定义 */
+interface CompatDefinition {
+    /** 兼容版本 */
+    version: string;
+    /** 最低运行时版本 */
+    minRuntime: string;
+    /** 最高运行时版本（可选） */
+    maxRuntime?: string;
+    /** 是否有破坏性变更 */
+    breaking?: boolean;
+    /** 破坏性变更说明 */
+    breakingChanges?: string[];
+    /** 从哪个版本可以无缝升级 */
+    upgradeFrom?: string[];
+}
+/** 组件分类 */
+type ComponentCategory = 'basic' | 'form' | 'layout' | 'navigation' | 'feedback' | 'display' | 'data' | 'business' | 'chart' | 'other';
+/** 组件分类列表（用于校验和 UI） */
+declare const COMPONENT_CATEGORIES: ComponentCategory[];
+/** SRI 完整性校验 */
+interface IntegrityDefinition {
+    /** 完整性版本 */
+    version: string;
+    /** 主入口文件哈希 */
+    main: string;
+    /** 所有文件哈希 */
+    files: Record<string, string>;
+    /** 生成时间 */
+    generatedAt: string;
+    /** 哈希算法 */
+    algorithm: 'sha256' | 'sha384' | 'sha512';
+}
+/** 组件状态 */
+type ComponentStatus = 'draft' | 'canary' | 'stable' | 'deprecated' | 'blocked';
+/** 组件版本元数据（完整） */
+interface ComponentMeta {
+    /** 组件名称 */
+    name: string;
+    /** 组件版本 */
+    version: string;
+    /** 显示名称 */
+    label: string;
+    /** 组件描述 */
+    description?: string;
+    /** 组件图标 */
+    icon?: string;
+    /** 组件分类 */
+    category: ComponentCategory;
+    /** 组件标签 */
+    tags?: string[];
+    /** 组件作者 */
+    author?: string;
+    /** 属性定义 */
+    props: PropsSchema;
+    /** 事件定义 */
+    events: EventsDefinition;
+    /** 插槽定义 */
+    slots?: SlotsDefinition;
+    /** 能力声明 */
+    capabilities: CapabilitiesDefinition;
+    /** 兼容性 */
+    compat: CompatDefinition;
+    /** 完整性校验 */
+    integrity: IntegrityDefinition;
+    /** 组件状态 */
+    status: ComponentStatus;
+    /** 预览图 */
+    preview?: string;
+    /** 入口文件（相对路径） */
+    entry: string;
+    /** 样式文件（相对路径） */
+    styles?: string[];
+}
+
+/**
+ * 资源相关类型定义
+ * 用于管理图片、视频、文档等资源
+ */
+/**
+ * 资源状态
+ * - active: 活跃
+ * - archived: 已归档
+ */
+type AssetStatus = 'active' | 'archived';
+/**
+ * 资源类型
+ * - image: 图片
+ * - video: 视频
+ * - audio: 音频
+ * - document: 文档
+ * - other: 其他
+ */
+type AssetType = 'image' | 'video' | 'audio' | 'document' | 'other';
+/**
+ * 资源排序字段
+ */
+type AssetSortField = 'id' | 'createdAt' | 'size' | 'filename';
+/**
+ * 资源元数据
+ */
+interface AssetMeta {
+    /** 原始文件名 */
+    originalName: string;
+    /** MIME 类型 */
+    mimeType: string;
+    /** 文件大小（字节） */
+    size: number;
+    /** 宽度（仅图片/视频） */
+    width?: number;
+    /** 高度（仅图片/视频） */
+    height?: number;
+    /** 时长（仅音频/视频，秒） */
+    duration?: number;
+    /** 扩展信息 */
+    extra?: Record<string, unknown>;
+}
+/**
+ * 资源信息
+ */
+interface Asset {
+    /** 资源 ID */
+    id: string;
+    /** 资源名称 */
+    name: string;
+    /** 资源类型 */
+    type: AssetType;
+    /** 资源状态 */
+    status: AssetStatus;
+    /** 存储路径/URL */
+    url: string;
+    /** 缩略图 URL */
+    thumbnailUrl?: string;
+    /** 元数据 */
+    meta: AssetMeta;
+    /** 标签 */
+    tags?: string[];
+    /** 所属目录 */
+    folderId?: string;
+    /** 创建时间 */
+    createdAt: string;
+    /** 创建者 */
+    createdBy: string;
+    /** 更新时间 */
+    updatedAt?: string;
+}
+
+/**
+ * 统一 API 响应类型定义
+ * 所有 API 响应遵循统一格式
+ */
+
+/**
+ * 统一 API 响应格式
+ */
+interface ApiResponse<T = unknown> {
+    /** 是否成功 */
+    success: boolean;
+    /** 响应数据 */
+    data?: T;
+    /** 错误码 */
+    code?: ErrorCode | number;
+    /** 错误信息 */
+    message?: string;
+    /** 追踪 ID */
+    traceId?: string;
+    /** 请求 ID */
+    requestId?: string;
+    /** 时间戳 */
+    timestamp?: number;
+}
+/**
+ * 分页 API 响应格式
+ */
+interface PaginatedApiResponse<T> extends ApiResponse<T[]> {
+    /** 分页信息 */
+    pagination?: {
+        /** 当前页码 */
+        page: number;
+        /** 每页数量 */
+        pageSize: number;
+        /** 总数量 */
+        total: number;
+        /** 总页数 */
+        totalPages: number;
+    };
+}
+/**
+ * 标准请求头
+ */
+interface StandardRequestHeaders {
+    /** 追踪 ID */
+    'x-trace-id'?: string;
+    /** 请求 ID */
+    'x-request-id'?: string;
+    /** 页面版本 ID */
+    'x-page-version-id'?: string;
+    /** 组件版本 */
+    'x-component-version'?: string;
+    /** 用户 ID */
+    'x-user-id'?: string;
+    /** 设备 ID */
+    'x-device-id'?: string;
+    /** 渠道 */
+    'x-channel'?: string;
+    /** 应用 ID */
+    'x-app-id'?: string;
+}
+/**
+ * 标准响应头
+ */
+interface StandardResponseHeaders {
+    /** 追踪 ID */
+    'x-trace-id'?: string;
+    /** 请求 ID */
+    'x-request-id'?: string;
+    /** 服务器时间戳 */
+    'x-server-time'?: string;
+    /** 缓存状态 */
+    'x-cache-status'?: 'HIT' | 'MISS' | 'BYPASS';
+}
+/**
+ * 健康检查响应
+ */
+interface HealthCheckResponse {
+    /** 状态 */
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    /** 版本 */
+    version: string;
+    /** 服务名 */
+    service: string;
+    /** 依赖服务状态 */
+    dependencies?: Record<string, DependencyHealth>;
+    /** 时间戳 */
+    timestamp: number;
+}
+/**
+ * 依赖服务健康状态
+ */
+interface DependencyHealth {
+    /** 状态 */
+    status: 'up' | 'down';
+    /** 延迟（ms） */
+    latency?: number;
+    /** 错误信息 */
+    error?: string;
+}
+/**
+ * 批量操作请求
+ */
+interface BatchRequest<T> {
+    /** 操作列表 */
+    items: T[];
+    /** 是否原子操作（全部成功或全部失败） */
+    atomic?: boolean;
+}
+/**
+ * 批量操作结果
+ */
+interface BatchResult<T> {
+    /** 成功数量 */
+    successCount: number;
+    /** 失败数量 */
+    failedCount: number;
+    /** 结果列表 */
+    results: BatchItemResult<T>[];
+}
+/**
+ * 单个批量操作项结果
+ */
+interface BatchItemResult<T> {
+    /** 索引 */
+    index: number;
+    /** 是否成功 */
+    success: boolean;
+    /** 数据 */
+    data?: T;
+    /** 错误码 */
+    code?: number;
+    /** 错误信息 */
+    message?: string;
+}
+/**
+ * 上传凭证请求
+ */
+interface UploadCredentialRequest {
+    /** 文件名 */
+    filename: string;
+    /** 文件类型 */
+    contentType: string;
+    /** 文件大小 */
+    size: number;
+    /** 目录 */
+    directory?: string;
+}
+/**
+ * 上传凭证响应
+ */
+interface UploadCredentialResponse {
+    /** 上传 URL */
+    uploadUrl: string;
+    /** 上传方法 */
+    method: 'PUT' | 'POST';
+    /** 需要的请求头 */
+    headers: Record<string, string>;
+    /** 表单字段（POST multipart 时） */
+    formFields?: Record<string, string>;
+    /** 最终文件 URL */
+    fileUrl: string;
+    /** 凭证过期时间 */
+    expiresAt: string;
+}
+/**
+ * WebSocket 消息类型
+ */
+type WsMessageType = 'ping' | 'pong' | 'subscribe' | 'unsubscribe' | 'publish' | 'error';
+/**
+ * WebSocket 消息
+ */
+interface WsMessage<T = unknown> {
+    /** 消息类型 */
+    type: WsMessageType;
+    /** 频道 */
+    channel?: string;
+    /** 消息数据 */
+    data?: T;
+    /** 消息 ID */
+    id?: string;
+    /** 时间戳 */
+    timestamp: number;
+}
+
+/**
+ * 表达式引擎类型定义
+ * 无 eval 的安全 DSL，支持发布期校验
+ */
+/**
+ * 表达式类型
+ */
+type ExpressionType = 'literal' | 'identifier' | 'member' | 'index' | 'call' | 'binary' | 'unary' | 'conditional' | 'array' | 'object';
+/**
+ * 表达式 AST 节点基类
+ */
+interface ExpressionNode {
+    /** 节点类型 */
+    type: ExpressionType;
+    /** 原始表达式 */
+    raw?: string;
+    /** 起始位置 */
+    start?: number;
+    /** 结束位置 */
+    end?: number;
+}
+/**
+ * 字面量节点
+ */
+interface LiteralNode extends ExpressionNode {
+    type: 'literal';
+    value: string | number | boolean | null;
+}
+/**
+ * 标识符节点
+ */
+interface IdentifierNode extends ExpressionNode {
+    type: 'identifier';
+    name: string;
+}
+/**
+ * 成员访问节点
+ */
+interface MemberNode extends ExpressionNode {
+    type: 'member';
+    object: ExpressionNode;
+    property: string;
+}
+/**
+ * 函数调用节点
+ */
+interface CallNode extends ExpressionNode {
+    type: 'call';
+    callee: string;
+    arguments: ExpressionNode[];
+}
+/**
+ * 二元运算节点
+ */
+interface BinaryNode extends ExpressionNode {
+    type: 'binary';
+    operator: BinaryOperator;
+    left: ExpressionNode;
+    right: ExpressionNode;
+}
+/**
+ * 二元运算符
+ */
+type BinaryOperator = '+' | '-' | '*' | '/' | '%' | '==' | '!=' | '>' | '<' | '>=' | '<=' | '&&' | '||' | '??';
+/**
+ * 一元运算符
+ */
+type UnaryOperator = '!' | '-' | '+';
+/**
+ * 内置函数定义
+ */
+interface BuiltinFunction {
+    /** 函数名 */
+    name: string;
+    /** 描述 */
+    description: string;
+    /** 参数定义 */
+    params: FunctionParam[];
+    /** 返回类型 */
+    returnType: ValueType;
+    /** 示例 */
+    examples?: string[];
+}
+/**
+ * 函数参数定义
+ */
+interface FunctionParam {
+    /** 参数名 */
+    name: string;
+    /** 参数类型 */
+    type: ValueType;
+    /** 是否必填 */
+    required: boolean;
+    /** 默认值 */
+    defaultValue?: unknown;
+    /** 描述 */
+    description?: string;
+}
+/**
+ * 值类型
+ */
+type ValueType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'null' | 'any' | 'void';
+/**
+ * 内置函数白名单
+ * 表达式中只能调用这些函数
+ */
+declare const BUILTIN_FUNCTIONS: BuiltinFunction[];
+/**
+ * 内置函数名称集合（用于快速校验）
+ */
+declare const BUILTIN_FUNCTION_NAMES: Set<string>;
+/**
+ * 表达式上下文
+ * 表达式执行时可访问的变量
+ */
+interface ExpressionContext {
+    /** 页面状态 */
+    state: Record<string, unknown>;
+    /** 查询结果 */
+    query: Record<string, unknown>;
+    /** 运行时上下文 */
+    context: {
+        userId?: string;
+        deviceId?: string;
+        channel?: string;
+        pageVersionId?: string;
+        [key: string]: unknown;
+    };
+    /** 事件参数 */
+    event?: Record<string, unknown>;
+    /** 循环变量 */
+    item?: unknown;
+    /** 循环索引 */
+    index?: number;
+}
+/**
+ * 表达式允许访问的根变量
+ */
+declare const ALLOWED_ROOT_VARIABLES: readonly ["state", "query", "context", "event", "item", "index"];
+/**
+ * 表达式校验结果
+ */
+interface ExpressionValidationResult {
+    /** 是否有效 */
+    valid: boolean;
+    /** 错误列表 */
+    errors: ExpressionError[];
+    /** 警告列表 */
+    warnings: ExpressionWarning[];
+    /** 引用的变量路径 */
+    referencedPaths: string[];
+    /** 调用的函数 */
+    calledFunctions: string[];
+}
+/**
+ * 表达式错误
+ */
+interface ExpressionError {
+    /** 错误类型 */
+    type: ExpressionErrorType;
+    /** 错误消息 */
+    message: string;
+    /** 位置 */
+    position?: {
+        start: number;
+        end: number;
+    };
+}
+/**
+ * 表达式错误类型
+ */
+type ExpressionErrorType = 'SYNTAX_ERROR' | 'UNKNOWN_FUNCTION' | 'INVALID_ARGUMENT' | 'UNKNOWN_VARIABLE' | 'TYPE_MISMATCH' | 'ACCESS_DENIED';
+/**
+ * 表达式警告
+ */
+interface ExpressionWarning {
+    /** 警告类型 */
+    type: 'DEPRECATED' | 'PERFORMANCE' | 'NULLABLE';
+    /** 警告消息 */
+    message: string;
+    /** 位置 */
+    position?: {
+        start: number;
+        end: number;
+    };
+}
+/**
+ * 表达式绑定
+ * 用于属性值的动态绑定
+ */
+interface ExpressionBinding {
+    /** 是否为表达式 */
+    __isExpression: true;
+    /** 表达式字符串 */
+    expression: string;
+    /** 默认值（表达式失败时使用） */
+    fallback?: unknown;
+}
+/**
+ * 检查是否为表达式绑定
+ */
+declare function isExpressionBinding(value: unknown): value is ExpressionBinding;
+/**
+ * 创建表达式绑定
+ */
+declare function createExpressionBinding(expression: string, fallback?: unknown): ExpressionBinding;
+
+/**
+ * 活动业务类型定义
+ * 领取、签到、抽奖、预约等活动规则配置
+ */
+/**
+ * 活动类型
+ */
+type ActivityType = 'claim' | 'signin' | 'lottery' | 'reserve' | 'task' | 'bind' | 'survey' | 'share' | 'invite' | 'custom';
+/**
+ * 活动状态
+ */
+type ActivityStatus = 'draft' | 'pending' | 'active' | 'paused' | 'ended' | 'cancelled';
+/**
+ * 活动基础信息
+ */
+interface Activity {
+    /** 活动 ID */
+    id: string;
+    /** 活动名称 */
+    name: string;
+    /** 活动类型 */
+    type: ActivityType;
+    /** 活动描述 */
+    description?: string;
+    /** 活动状态 */
+    status: ActivityStatus;
+    /** 开始时间 */
+    startAt: string;
+    /** 结束时间 */
+    endAt: string;
+    /** 活动规则 */
+    rules: ActivityRules;
+    /** 关联的页面 UID */
+    pageUid?: string;
+    /** 创建时间 */
+    createdAt: string;
+    /** 创建者 */
+    createdBy: string;
+    /** 更新时间 */
+    updatedAt?: string;
+}
+/**
+ * 活动规则（通用）
+ */
+interface ActivityRules {
+    /** 参与条件 */
+    eligibility?: EligibilityRules;
+    /** 限制规则 */
+    limits?: LimitRules;
+    /** 奖励规则 */
+    rewards?: RewardRules;
+    /** 风控规则 */
+    risk?: RiskRules;
+    /** 扩展配置（不同活动类型特有） */
+    extra?: Record<string, unknown>;
+}
+/**
+ * 参与条件
+ */
+interface EligibilityRules {
+    /** 是否需要登录 */
+    requireLogin?: boolean;
+    /** 是否需要实名 */
+    requireRealName?: boolean;
+    /** 是否需要绑定手机 */
+    requirePhone?: boolean;
+    /** 会员等级要求 */
+    minMemberLevel?: number;
+    /** 用户白名单 */
+    whitelistUsers?: string[];
+    /** 用户黑名单 */
+    blacklistUsers?: string[];
+    /** 渠道限制 */
+    allowedChannels?: string[];
+    /** 地区限制 */
+    allowedRegions?: string[];
+    /** 自定义条件表达式 */
+    customCondition?: string;
+}
+/**
+ * 限制规则
+ */
+interface LimitRules {
+    /** 总参与次数限制 */
+    totalLimit?: number;
+    /** 每用户参与次数限制 */
+    perUserLimit?: number;
+    /** 每日参与次数限制 */
+    dailyLimit?: number;
+    /** 每用户每日限制 */
+    perUserDailyLimit?: number;
+    /** 库存限制（奖品数量） */
+    stockLimit?: number;
+    /** 并发限制 */
+    concurrentLimit?: number;
+    /** 时段限制 */
+    timeSlots?: TimeSlot[];
+}
+/**
+ * 时段定义
+ */
+interface TimeSlot {
+    /** 开始时间（HH:mm 格式） */
+    startTime: string;
+    /** 结束时间 */
+    endTime: string;
+    /** 生效的星期几（0-6，0 为周日） */
+    daysOfWeek?: number[];
+}
+/**
+ * 奖励规则
+ */
+interface RewardRules {
+    /** 奖励类型 */
+    type: RewardType;
+    /** 奖励配置 */
+    config: RewardConfig;
+    /** 发放方式 */
+    deliveryMethod: RewardDeliveryMethod;
+    /** 发放延迟（秒） */
+    deliveryDelay?: number;
+}
+/**
+ * 奖励类型
+ */
+type RewardType = 'coupon' | 'points' | 'virtual' | 'physical' | 'balance' | 'membership' | 'custom';
+/**
+ * 奖励配置
+ */
+interface RewardConfig {
+    /** 奖励 ID */
+    rewardId?: string;
+    /** 奖励名称 */
+    name: string;
+    /** 奖励数量/金额 */
+    amount?: number;
+    /** 奖励单位 */
+    unit?: string;
+    /** 有效期（天） */
+    validDays?: number;
+    /** 额外配置 */
+    extra?: Record<string, unknown>;
+}
+/**
+ * 奖励发放方式
+ */
+type RewardDeliveryMethod = 'instant' | 'async' | 'manual' | 'scheduled';
+/**
+ * 风控规则
+ */
+interface RiskRules {
+    /** 是否启用风控 */
+    enabled?: boolean;
+    /** 频控（每分钟） */
+    rateLimit?: number;
+    /** 设备指纹校验 */
+    deviceCheck?: boolean;
+    /** IP 限制 */
+    ipLimit?: number;
+    /** 需要验证码的阈值 */
+    captchaThreshold?: number;
+    /** 黑名单 IP */
+    blacklistIps?: string[];
+}
+/**
+ * 领取活动规则
+ */
+interface ClaimActivityRules extends ActivityRules {
+    extra: {
+        /** 领取类型 */
+        claimType: 'single' | 'multiple' | 'choice';
+        /** 可选奖品列表（choice 类型） */
+        rewardOptions?: RewardOption[];
+        /** 是否需要填写收货地址（实物奖品） */
+        requireAddress?: boolean;
+        /** 是否需要确认协议 */
+        requireAgreement?: boolean;
+    };
+}
+/**
+ * 奖品选项
+ */
+interface RewardOption {
+    /** 选项 ID */
+    id: string;
+    /** 选项名称 */
+    name: string;
+    /** 奖励配置 */
+    reward: RewardConfig;
+    /** 库存 */
+    stock?: number;
+    /** 排序 */
+    order?: number;
+}
+/**
+ * 签到活动规则
+ */
+interface SigninActivityRules extends ActivityRules {
+    extra: {
+        /** 签到周期类型 */
+        cycleType: 'daily' | 'weekly' | 'monthly' | 'custom';
+        /** 自定义周期天数 */
+        cycleDays?: number;
+        /** 是否允许补签 */
+        allowMakeup?: boolean;
+        /** 补签扣除的积分/次数 */
+        makeupCost?: number;
+        /** 最大补签次数 */
+        maxMakeupCount?: number;
+        /** 连续签到奖励 */
+        streakRewards?: StreakReward[];
+        /** 累计签到奖励 */
+        accumulateRewards?: AccumulateReward[];
+        /** 每日基础奖励 */
+        dailyReward?: RewardConfig;
+    };
+}
+/**
+ * 连续签到奖励
+ */
+interface StreakReward {
+    /** 连续天数 */
+    days: number;
+    /** 奖励配置 */
+    reward: RewardConfig;
+}
+/**
+ * 累计签到奖励
+ */
+interface AccumulateReward {
+    /** 累计天数 */
+    days: number;
+    /** 奖励配置 */
+    reward: RewardConfig;
+}
+/**
+ * 抽奖活动规则
+ */
+interface LotteryActivityRules extends ActivityRules {
+    extra: {
+        /** 抽奖类型 */
+        lotteryType: 'wheel' | 'box' | 'card' | 'scratch' | 'slot';
+        /** 奖池配置 */
+        prizePool: PrizePoolConfig;
+        /** 抽奖消耗 */
+        cost?: LotteryCost;
+        /** 保底规则 */
+        guarantee?: GuaranteeRule;
+        /** 是否显示中奖记录 */
+        showWinners?: boolean;
+        /** 中奖公示数量 */
+        winnersDisplayCount?: number;
+    };
+}
+/**
+ * 奖池配置
+ */
+interface PrizePoolConfig {
+    /** 奖品列表 */
+    prizes: PrizeConfig[];
+    /** 是否启用概率调整 */
+    dynamicProbability?: boolean;
+    /** 概率模式 */
+    probabilityMode: 'fixed' | 'weight' | 'stock';
+}
+/**
+ * 奖品配置
+ */
+interface PrizeConfig {
+    /** 奖品 ID */
+    id: string;
+    /** 奖品名称 */
+    name: string;
+    /** 奖品图片 */
+    image?: string;
+    /** 奖励配置 */
+    reward: RewardConfig;
+    /** 概率/权重 */
+    probability: number;
+    /** 库存 */
+    stock?: number;
+    /** 已发放数量 */
+    issued?: number;
+    /** 每日发放上限 */
+    dailyLimit?: number;
+    /** 每用户中奖上限 */
+    perUserLimit?: number;
+    /** 是否为谢谢参与 */
+    isDefault?: boolean;
+    /** 排序（显示用） */
+    order?: number;
+}
+/**
+ * 抽奖消耗
+ */
+interface LotteryCost {
+    /** 消耗类型 */
+    type: 'free' | 'points' | 'times' | 'token';
+    /** 消耗数量 */
+    amount: number;
+    /** 免费次数 */
+    freeCount?: number;
+    /** 每日免费次数 */
+    dailyFreeCount?: number;
+}
+/**
+ * 保底规则
+ */
+interface GuaranteeRule {
+    /** 是否启用 */
+    enabled: boolean;
+    /** 保底次数 */
+    count: number;
+    /** 保底奖品 ID */
+    prizeId: string;
+    /** 是否重置计数（获得保底后） */
+    resetAfterHit?: boolean;
+}
+/**
+ * 预约活动规则
+ */
+interface ReserveActivityRules extends ActivityRules {
+    extra: {
+        /** 预约类型 */
+        reserveType: 'product' | 'event' | 'service';
+        /** 预约需要的信息 */
+        requiredFields: ReserveField[];
+        /** 提醒设置 */
+        reminder?: ReminderConfig;
+        /** 预约生效时间 */
+        effectiveAt?: string;
+        /** 是否可取消 */
+        cancelable?: boolean;
+        /** 取消截止时间（相对于生效时间的秒数） */
+        cancelDeadline?: number;
+    };
+}
+/**
+ * 预约信息字段
+ */
+interface ReserveField {
+    /** 字段名 */
+    name: string;
+    /** 字段标签 */
+    label: string;
+    /** 字段类型 */
+    type: 'text' | 'phone' | 'email' | 'date' | 'time' | 'select' | 'address';
+    /** 是否必填 */
+    required: boolean;
+    /** 选项（select 类型） */
+    options?: string[];
+    /** 校验规则 */
+    validation?: string;
+}
+/**
+ * 提醒配置
+ */
+interface ReminderConfig {
+    /** 是否启用 */
+    enabled: boolean;
+    /** 提醒方式 */
+    methods: ('sms' | 'push' | 'email')[];
+    /** 提前提醒时间（分钟） */
+    advanceMinutes: number[];
+}
+/**
+ * 任务活动规则
+ */
+interface TaskActivityRules extends ActivityRules {
+    extra: {
+        /** 任务列表 */
+        tasks: TaskConfig[];
+        /** 是否按顺序完成 */
+        sequential?: boolean;
+        /** 全部完成奖励 */
+        completionReward?: RewardConfig;
+    };
+}
+/**
+ * 任务配置
+ */
+interface TaskConfig {
+    /** 任务 ID */
+    id: string;
+    /** 任务名称 */
+    name: string;
+    /** 任务描述 */
+    description?: string;
+    /** 任务类型 */
+    type: TaskType;
+    /** 目标值 */
+    target: number;
+    /** 任务奖励 */
+    reward: RewardConfig;
+    /** 任务条件配置 */
+    condition: TaskCondition;
+    /** 是否可重复 */
+    repeatable?: boolean;
+    /** 重复周期 */
+    repeatCycle?: 'daily' | 'weekly' | 'monthly';
+}
+/**
+ * 任务类型
+ */
+type TaskType = 'visit' | 'share' | 'invite' | 'purchase' | 'browse' | 'interact' | 'bind' | 'profile' | 'custom';
+/**
+ * 任务条件
+ */
+interface TaskCondition {
+    /** 条件类型 */
+    type: string;
+    /** 条件参数 */
+    params: Record<string, unknown>;
+    /** 自定义检查表达式 */
+    expression?: string;
+}
+/**
+ * 用户活动状态
+ */
+interface UserActivityState {
+    /** 活动 ID */
+    activityId: string;
+    /** 用户 ID */
+    userId: string;
+    /** 参与次数 */
+    participationCount: number;
+    /** 今日参与次数 */
+    todayCount: number;
+    /** 剩余次数（如有限制） */
+    remainingCount?: number;
+    /** 是否已领取/完成 */
+    completed: boolean;
+    /** 最后参与时间 */
+    lastParticipatedAt?: string;
+    /** 扩展状态数据 */
+    extra?: Record<string, unknown>;
+}
+/**
+ * 签到状态（扩展）
+ */
+interface SigninState extends UserActivityState {
+    extra: {
+        /** 当前周期签到记录 */
+        signedDays: string[];
+        /** 连续签到天数 */
+        streakDays: number;
+        /** 累计签到天数 */
+        totalDays: number;
+        /** 补签剩余次数 */
+        makeupRemaining: number;
+        /** 下一个奖励 */
+        nextReward?: {
+            type: 'streak' | 'accumulate';
+            days: number;
+            reward: RewardConfig;
+        };
+    };
+}
+/**
+ * 抽奖状态（扩展）
+ */
+interface LotteryState extends UserActivityState {
+    extra: {
+        /** 免费次数剩余 */
+        freeRemaining: number;
+        /** 保底进度 */
+        guaranteeProgress?: number;
+        /** 今日中奖记录 */
+        todayWins?: string[];
+    };
+}
+/**
+ * 任务状态（扩展）
+ */
+interface TaskState extends UserActivityState {
+    extra: {
+        /** 各任务进度 */
+        taskProgress: Record<string, {
+            current: number;
+            target: number;
+            completed: boolean;
+            claimedReward: boolean;
+        }>;
+        /** 已完成任务数 */
+        completedTaskCount: number;
+        /** 总任务数 */
+        totalTaskCount: number;
+    };
+}
+
+/**
+ * Outbox 和 Worker 事件类型定义
+ * 用于异步任务处理、事件驱动架构
+ */
+/**
+ * Outbox 事件状态
+ */
+type OutboxEventStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'dead' | 'cancelled';
+/**
+ * Outbox 事件基础结构
+ */
+interface OutboxEvent<T = unknown> {
+    /** 事件 ID（用于幂等） */
+    id: string;
+    /** 事件类型 */
+    type: OutboxEventType;
+    /** 事件数据 */
+    payload: T;
+    /** 事件状态 */
+    status: OutboxEventStatus;
+    /** 重试次数 */
+    retryCount: number;
+    /** 最大重试次数 */
+    maxRetries: number;
+    /** 下次重试时间 */
+    nextRetryAt?: string;
+    /** 最后错误信息 */
+    lastError?: string;
+    /** 创建时间 */
+    createdAt: string;
+    /** 更新时间 */
+    updatedAt?: string;
+    /** 完成时间 */
+    completedAt?: string;
     /** 追踪 ID */
-    'x-trace-id'?: string;
-    /** 请求 ID */
-    'x-request-id'?: string;
-    /** 服务器时间戳 */
-    'x-server-time'?: string;
-    /** 缓存状态 */
-    'x-cache-status'?: 'HIT' | 'MISS' | 'BYPASS';
+    traceId?: string;
+    /** 优先级（数字越小优先级越高） */
+    priority?: number;
+    /** 聚合 ID（用于确保同一聚合的事件顺序处理） */
+    aggregateId?: string;
+}
+/**
+ * Outbox 事件类型
+ */
+type OutboxEventType = 'page.published' | 'page.rolled_back' | 'page.static_export' | 'page.cdn_refresh' | 'page.cdn_preheat' | 'component.registered' | 'component.blocked' | 'component.unblocked' | 'component.deprecated' | 'activity.started' | 'activity.ended' | 'activity.reward_deliver' | 'activity.stock_alert' | 'audit.log' | 'audit.alert' | 'notification.send' | 'notification.batch' | 'analytics.aggregate' | 'analytics.report' | 'sync.external' | 'sync.cache' | `custom.${string}`;
+/**
+ * 页面发布事件 Payload
+ */
+interface PagePublishedPayload {
+    /** 页面 UID */
+    pageUid: string;
+    /** 页面版本 ID */
+    pageVersionId: string;
+    /** 发布渠道 */
+    channel: 'preview' | 'prod' | 'gray';
+    /** 发布者 */
+    publishedBy: string;
+    /** 变更摘要 */
+    changeSummary?: string;
+    /** 需要刷新的 CDN URL */
+    cdnUrls?: string[];
+}
+/**
+ * 页面回滚事件 Payload
+ */
+interface PageRolledBackPayload {
+    /** 页面 UID */
+    pageUid: string;
+    /** 原版本 ID */
+    fromVersionId: string;
+    /** 目标版本 ID */
+    toVersionId: string;
+    /** 回滚者 */
+    rolledBackBy: string;
+    /** 回滚原因 */
+    reason: string;
+}
+/**
+ * 静态导出事件 Payload
+ */
+interface StaticExportPayload {
+    /** 页面 UID */
+    pageUid: string;
+    /** 页面版本 ID */
+    pageVersionId: string;
+    /** 导出目标路径 */
+    targetPath: string;
+    /** 包含的文件类型 */
+    fileTypes: ('page.json' | 'manifest.json' | 'bootstrap.json')[];
+    /** 是否预热 CDN */
+    preheatCdn?: boolean;
 }
 /**
- * 健康检查响应
+ * CDN 刷新事件 Payload
  */
-interface HealthCheckResponse {
-    /** 状态 */
-    status: 'healthy' | 'degraded' | 'unhealthy';
-    /** 版本 */
-    version: string;
-    /** 服务名 */
-    service: string;
-    /** 依赖服务状态 */
-    dependencies?: Record<string, DependencyHealth>;
-    /** 时间戳 */
-    timestamp: number;
+interface CdnRefreshPayload {
+    /** 刷新类型 */
+    type: 'url' | 'directory';
+    /** URL 列表或目录路径 */
+    targets: string[];
+    /** CDN 提供商 */
+    provider?: string;
 }
 /**
- * 依赖服务健康状态
+ * 组件阻断事件 Payload
  */
-interface DependencyHealth {
-    /** 状态 */
-    status: 'up' | 'down';
-    /** 延迟（ms） */
-    latency?: number;
+interface ComponentBlockedPayload {
+    /** 组件名称 */
+    componentName: string;
+    /** 版本范围 */
+    versionRange: string;
+    /** 阻断原因 */
+    reason: string;
+    /** 阻断者 */
+    blockedBy: string;
+    /** 是否紧急 */
+    urgent: boolean;
+    /** 受影响的页面数量 */
+    affectedPageCount?: number;
+}
+/**
+ * 奖励发放事件 Payload
+ */
+interface RewardDeliverPayload {
+    /** 活动 ID */
+    activityId: string;
+    /** 用户 ID */
+    userId: string;
+    /** 奖励类型 */
+    rewardType: string;
+    /** 奖励 ID */
+    rewardId: string;
+    /** 奖励数量 */
+    amount: number;
+    /** 发放原因 */
+    reason: string;
+    /** 幂等键 */
+    idempotencyKey: string;
+    /** 过期时间 */
+    expiresAt?: string;
+}
+/**
+ * 通知发送事件 Payload
+ */
+interface NotificationSendPayload {
+    /** 接收者 ID */
+    recipientId: string;
+    /** 通知渠道 */
+    channels: ('push' | 'sms' | 'email' | 'wechat')[];
+    /** 通知模板 ID */
+    templateId: string;
+    /** 模板参数 */
+    templateParams: Record<string, string>;
+    /** 优先级 */
+    priority?: 'high' | 'normal' | 'low';
+    /** 发送时间（定时发送） */
+    scheduledAt?: string;
+}
+/**
+ * Worker 任务状态
+ */
+type WorkerTaskStatus = 'queued' | 'running' | 'completed' | 'failed' | 'timeout' | 'cancelled';
+/**
+ * Worker 任务基础结构
+ */
+interface WorkerTask<T = unknown> {
+    /** 任务 ID */
+    id: string;
+    /** 任务类型 */
+    type: string;
+    /** 任务数据 */
+    data: T;
+    /** 任务状态 */
+    status: WorkerTaskStatus;
+    /** Worker ID */
+    workerId?: string;
+    /** 开始时间 */
+    startedAt?: string;
+    /** 完成时间 */
+    completedAt?: string;
+    /** 执行时长（ms） */
+    duration?: number;
     /** 错误信息 */
     error?: string;
+    /** 进度（0-100） */
+    progress?: number;
+    /** 创建时间 */
+    createdAt: string;
 }
 /**
- * 批量操作请求
+ * Worker 任务结果
  */
-interface BatchRequest<T> {
-    /** 操作列表 */
-    items: T[];
-    /** 是否原子操作（全部成功或全部失败） */
-    atomic?: boolean;
+interface WorkerTaskResult<T = unknown> {
+    /** 任务 ID */
+    taskId: string;
+    /** 是否成功 */
+    success: boolean;
+    /** 结果数据 */
+    data?: T;
+    /** 错误码 */
+    errorCode?: string;
+    /** 错误信息 */
+    errorMessage?: string;
+    /** 执行时长（ms） */
+    duration: number;
 }
 /**
- * 批量操作结果
+ * 事件消费配置
  */
-interface BatchResult<T> {
-    /** 成功数量 */
-    successCount: number;
-    /** 失败数量 */
-    failedCount: number;
-    /** 结果列表 */
-    results: BatchItemResult<T>[];
+interface EventConsumerConfig {
+    /** 消费者 ID */
+    consumerId: string;
+    /** 监听的事件类型 */
+    eventTypes: OutboxEventType[];
+    /** 批量大小 */
+    batchSize: number;
+    /** 并发数 */
+    concurrency: number;
+    /** 轮询间隔（ms） */
+    pollInterval: number;
+    /** 可见性超时（秒） */
+    visibilityTimeout: number;
+    /** 重试策略 */
+    retryStrategy: RetryStrategy;
 }
 /**
- * 单个批量操作项结果
+ * 重试策略
  */
-interface BatchItemResult<T> {
-    /** 索引 */
-    index: number;
+interface RetryStrategy {
+    /** 最大重试次数 */
+    maxRetries: number;
+    /** 基础延迟（ms） */
+    baseDelay: number;
+    /** 最大延迟（ms） */
+    maxDelay: number;
+    /** 是否使用指数退避 */
+    exponentialBackoff: boolean;
+    /** 退避因子 */
+    backoffFactor?: number;
+    /** 可重试的错误类型 */
+    retryableErrors?: string[];
+}
+/**
+ * 死信事件
+ */
+interface DeadLetterEvent extends OutboxEvent {
+    /** 进入死信队列时间 */
+    deadAt: string;
+    /** 进入原因 */
+    deadReason: 'max_retries' | 'manual' | 'timeout' | 'poison';
+    /** 错误历史 */
+    errorHistory: ErrorHistoryItem[];
+    /** 是否已处理 */
+    resolved: boolean;
+    /** 处理时间 */
+    resolvedAt?: string;
+    /** 处理者 */
+    resolvedBy?: string;
+    /** 处理备注 */
+    resolveNote?: string;
+}
+/**
+ * 错误历史项
+ */
+interface ErrorHistoryItem {
+    /** 尝试次数 */
+    attempt: number;
+    /** 错误信息 */
+    error: string;
+    /** 错误时间 */
+    timestamp: string;
+    /** Worker ID */
+    workerId?: string;
+}
+/**
+ * 发布事件请求
+ */
+interface PublishEventRequest<T = unknown> {
+    /** 事件类型 */
+    type: OutboxEventType;
+    /** 事件数据 */
+    payload: T;
+    /** 优先级 */
+    priority?: number;
+    /** 延迟执行（秒） */
+    delaySeconds?: number;
+    /** 聚合 ID */
+    aggregateId?: string;
+    /** 去重键 */
+    deduplicationId?: string;
+    /** 追踪 ID */
+    traceId?: string;
+}
+/**
+ * 发布事件响应
+ */
+interface PublishEventResponse {
+    /** 事件 ID */
+    eventId: string;
+    /** 是否去重 */
+    deduplicated: boolean;
+    /** 预计处理时间 */
+    estimatedProcessAt?: string;
+}
+
+/**
+ * 审计日志类型定义
+ * 用于操作记录、变更追踪、合规审计
+ */
+
+/**
+ * 审计日志级别
+ */
+type AuditLogLevel = 'info' | 'warning' | 'critical' | 'security';
+/**
+ * 审计目标类型
+ */
+type AuditTargetType = 'page' | 'page_version' | 'component' | 'component_version' | 'activity' | 'action_definition' | 'query_definition' | 'user' | 'role' | 'permission' | 'config' | 'system';
+/**
+ * 审计日志
+ */
+interface AuditLog {
+    /** 日志 ID */
+    id: string;
+    /** 日志级别 */
+    level: AuditLogLevel;
+    /** 操作类型 */
+    action: LowcodeAction;
+    /** 操作描述 */
+    description: string;
+    /** 目标类型 */
+    targetType: AuditTargetType;
+    /** 目标 ID */
+    targetId: string;
+    /** 目标名称 */
+    targetName?: string;
+    /** 操作者信息 */
+    operator: OperatorInfo;
+    /** 操作来源 */
+    source: AuditSource;
+    /** 变更摘要 */
+    changeSummary?: ChangeSummary;
+    /** 请求上下文 */
+    context: AuditContext;
+    /** 操作结果 */
+    result: AuditResult;
+    /** 创建时间 */
+    createdAt: string;
+}
+/**
+ * 操作来源
+ */
+interface AuditSource {
+    /** 来源类型 */
+    type: 'web' | 'api' | 'cli' | 'scheduler' | 'system';
+    /** IP 地址 */
+    ip?: string;
+    /** 用户代理 */
+    userAgent?: string;
+    /** 设备 ID */
+    deviceId?: string;
+    /** 应用 ID */
+    appId?: string;
+    /** API Key ID */
+    apiKeyId?: string;
+}
+/**
+ * 审计上下文
+ */
+interface AuditContext {
+    /** 追踪 ID */
+    traceId: string;
+    /** 请求 ID */
+    requestId: string;
+    /** 会话 ID */
+    sessionId?: string;
+    /** 环境 */
+    environment?: 'development' | 'staging' | 'production';
+    /** 服务名 */
+    service?: string;
+    /** 额外上下文 */
+    extra?: Record<string, unknown>;
+}
+/**
+ * 操作结果
+ */
+interface AuditResult {
     /** 是否成功 */
     success: boolean;
-    /** 数据 */
-    data?: T;
     /** 错误码 */
-    code?: number;
+    errorCode?: string;
     /** 错误信息 */
-    message?: string;
+    errorMessage?: string;
+    /** 执行时长（ms） */
+    duration?: number;
+}
+/**
+ * 页面发布审计详情
+ */
+interface PagePublishAuditDetails {
+    /** 页面 UID */
+    pageUid: string;
+    /** 页面版本 ID */
+    pageVersionId: string;
+    /** 发布渠道 */
+    channel: 'preview' | 'prod' | 'gray';
+    /** 之前的发布版本 */
+    previousVersionId?: string;
+    /** Manifest 内容哈希 */
+    manifestHash: string;
+    /** 包含的组件版本 */
+    componentVersions: Array<{
+        name: string;
+        version: string;
+    }>;
+    /** 灰度配置 */
+    grayConfig?: Record<string, unknown>;
+    /** 审批信息 */
+    approval?: ApprovalInfo;
+}
+/**
+ * 页面回滚审计详情
+ */
+interface PageRollbackAuditDetails {
+    /** 页面 UID */
+    pageUid: string;
+    /** 原版本 ID */
+    fromVersionId: string;
+    /** 目标版本 ID */
+    toVersionId: string;
+    /** 回滚原因 */
+    reason: string;
+    /** 回滚时长（ms） */
+    rollbackDuration: number;
+    /** 是否紧急回滚 */
+    isEmergency: boolean;
+}
+/**
+ * 组件阻断审计详情
+ */
+interface ComponentBlockAuditDetails {
+    /** 组件名称 */
+    componentName: string;
+    /** 阻断版本范围 */
+    versionRange: string;
+    /** 阻断原因 */
+    reason: string;
+    /** 是否紧急 */
+    isUrgent: boolean;
+    /** 受影响页面 */
+    affectedPages: Array<{
+        pageUid: string;
+        pageName: string;
+        componentVersion: string;
+    }>;
+    /** 受影响页面数量 */
+    affectedPageCount: number;
+}
+/**
+ * 审批信息
+ */
+interface ApprovalInfo {
+    /** 审批 ID */
+    approvalId: string;
+    /** 审批状态 */
+    status: 'pending' | 'approved' | 'rejected';
+    /** 审批者 */
+    approvers: ApproverInfo[];
+    /** 审批时间 */
+    approvedAt?: string;
+    /** 审批备注 */
+    comment?: string;
+}
+/**
+ * 审批者信息
+ */
+interface ApproverInfo {
+    /** 用户 ID */
+    uid: string;
+    /** 用户名 */
+    username: string;
+    /** 审批决定 */
+    decision: 'approved' | 'rejected' | 'pending';
+    /** 审批时间 */
+    decidedAt?: string;
+    /** 备注 */
+    comment?: string;
+}
+/**
+ * 安全审计日志
+ */
+interface SecurityAuditLog extends AuditLog {
+    level: 'security';
+    /** 安全事件类型 */
+    securityEventType: SecurityEventType;
+    /** 风险评分 */
+    riskScore?: number;
+    /** 威胁指标 */
+    threatIndicators?: ThreatIndicator[];
+    /** 是否已处理 */
+    handled: boolean;
+    /** 处理结果 */
+    handlingResult?: string;
+}
+/**
+ * 安全事件类型
+ */
+type SecurityEventType = 'unauthorized_access' | 'permission_escalation' | 'suspicious_activity' | 'rate_limit_exceeded' | 'integrity_violation' | 'config_tampering' | 'sensitive_data_access' | 'login_anomaly' | 'api_abuse';
+/**
+ * 威胁指标
+ */
+interface ThreatIndicator {
+    /** 指标类型 */
+    type: 'ip' | 'user' | 'device' | 'behavior' | 'pattern';
+    /** 指标值 */
+    value: string;
+    /** 风险等级 */
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    /** 描述 */
+    description?: string;
+}
+/**
+ * 审计日志查询请求
+ */
+interface AuditLogQueryRequest {
+    /** 时间范围 - 开始 */
+    startTime?: string;
+    /** 时间范围 - 结束 */
+    endTime?: string;
+    /** 操作类型 */
+    actions?: string[];
+    /** 目标类型 */
+    targetTypes?: AuditTargetType[];
+    /** 目标 ID */
+    targetId?: string;
+    /** 操作者 UID */
+    operatorUid?: string;
+    /** 日志级别 */
+    levels?: AuditLogLevel[];
+    /** 是否仅失败 */
+    failedOnly?: boolean;
+    /** 关键词搜索 */
+    keyword?: string;
+    /** 追踪 ID */
+    traceId?: string;
+    /** 页码 */
+    page?: number;
+    /** 每页数量 */
+    pageSize?: number;
+    /** 排序字段 */
+    sortBy?: 'createdAt' | 'level' | 'action';
+    /** 排序方向 */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * 审计统计
+ */
+interface AuditStatistics {
+    /** 统计周期 */
+    period: {
+        start: string;
+        end: string;
+    };
+    /** 总操作数 */
+    totalOperations: number;
+    /** 成功操作数 */
+    successCount: number;
+    /** 失败操作数 */
+    failedCount: number;
+    /** 各级别分布 */
+    levelDistribution: Record<AuditLogLevel, number>;
+    /** 各操作类型分布 */
+    actionDistribution: Record<string, number>;
+    /** 各目标类型分布 */
+    targetTypeDistribution: Record<AuditTargetType, number>;
+    /** 活跃操作者 Top N */
+    topOperators: Array<{
+        operator: OperatorInfo;
+        count: number;
+    }>;
+    /** 高危操作统计 */
+    criticalOperations: number;
+}
+/**
+ * 审计导出格式
+ */
+type AuditExportFormat = 'json' | 'csv' | 'excel';
+/**
+ * 审计导出请求
+ */
+interface AuditExportRequest extends AuditLogQueryRequest {
+    /** 导出格式 */
+    format: AuditExportFormat;
+    /** 是否包含详情 */
+    includeDetails?: boolean;
+    /** 字段选择 */
+    fields?: string[];
+    /** 时区 */
+    timezone?: string;
+}
+/**
+ * 审计导出响应
+ */
+interface AuditExportResponse {
+    /** 导出任务 ID */
+    taskId: string;
+    /** 状态 */
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    /** 下载 URL（完成后） */
+    downloadUrl?: string;
+    /** 过期时间 */
+    expiresAt?: string;
+    /** 记录数量 */
+    recordCount?: number;
+}
+
+/**
+ * RBAC 权限模型类型定义
+ * 用于角色、权限、访问控制
+ *
+ * 设计原则：MVP 最小闭环
+ * - 发布/回滚/阻断属于高危权限
+ * - 支持 global/tenant/app 三级作用域
+ */
+/**
+ * 权限作用域
+ */
+type PermissionScope = 'global' | 'tenant' | 'app';
+/**
+ * 资源类型
+ */
+type ResourceType = 'page' | 'page_version' | 'component' | 'component_version' | 'activity' | 'action_definition' | 'query_definition' | 'user' | 'role' | 'config' | '*';
+/**
+ * 操作类型
+ */
+type PermissionAction = 'read' | 'create' | 'update' | 'delete' | 'publish' | 'unpublish' | 'rollback' | 'block' | 'unblock' | 'approve' | 'reject' | '*';
+/**
+ * 权限定义
+ */
+interface Permission {
+    /** 权限 ID */
+    id: string;
+    /** 权限名称 */
+    name: string;
+    /** 权限描述 */
+    description?: string;
+    /** 资源类型 */
+    resource: ResourceType;
+    /** 操作类型 */
+    action: PermissionAction;
+    /** 是否为高危权限 */
+    dangerous?: boolean;
+    /** 创建时间 */
+    createdAt: string;
+}
+/**
+ * 内置权限常量
+ */
+declare const BUILTIN_PERMISSIONS: {
+    readonly PAGE_READ: "page:read";
+    readonly PAGE_CREATE: "page:create";
+    readonly PAGE_UPDATE: "page:update";
+    readonly PAGE_DELETE: "page:delete";
+    readonly PAGE_PUBLISH: "page:publish";
+    readonly PAGE_ROLLBACK: "page:rollback";
+    readonly COMPONENT_READ: "component:read";
+    readonly COMPONENT_CREATE: "component:create";
+    readonly COMPONENT_BLOCK: "component:block";
+    readonly COMPONENT_UNBLOCK: "component:unblock";
+    readonly ACTIVITY_READ: "activity:read";
+    readonly ACTIVITY_CREATE: "activity:create";
+    readonly ACTIVITY_UPDATE: "activity:update";
+    readonly DEFINITION_READ: "definition:read";
+    readonly DEFINITION_CREATE: "definition:create";
+    readonly DEFINITION_UPDATE: "definition:update";
+    readonly ADMIN_ALL: "*:*";
+};
+/**
+ * 角色状态
+ */
+type RoleStatus = 'active' | 'inactive' | 'deleted';
+/**
+ * 角色定义
+ */
+interface Role {
+    /** 角色 ID */
+    id: string;
+    /** 角色名称 */
+    name: string;
+    /** 角色显示名 */
+    label: string;
+    /** 角色描述 */
+    description?: string;
+    /** 权限列表 */
+    permissions: string[];
+    /** 作用域 */
+    scope: PermissionScope;
+    /** 作用域 ID（tenant/app ID） */
+    scopeId?: string;
+    /** 是否为系统角色（不可删除） */
+    isSystem?: boolean;
+    /** 状态 */
+    status: RoleStatus;
+    /** 创建时间 */
+    createdAt: string;
+    /** 更新时间 */
+    updatedAt?: string;
+}
+/**
+ * 内置角色
+ */
+declare const BUILTIN_ROLES: {
+    /** 超级管理员 */
+    readonly SUPER_ADMIN: "super_admin";
+    /** 租户管理员 */
+    readonly TENANT_ADMIN: "tenant_admin";
+    /** 应用管理员 */
+    readonly APP_ADMIN: "app_admin";
+    /** 编辑者 */
+    readonly EDITOR: "editor";
+    /** 发布者 */
+    readonly PUBLISHER: "publisher";
+    /** 审核者 */
+    readonly REVIEWER: "reviewer";
+    /** 查看者 */
+    readonly VIEWER: "viewer";
+};
+/**
+ * 角色绑定
+ * 将用户与角色关联
+ */
+interface RoleBinding {
+    /** 绑定 ID */
+    id: string;
+    /** 用户 ID */
+    userId: string;
+    /** 角色 ID */
+    roleId: string;
+    /** 作用域 */
+    scope: PermissionScope;
+    /** 作用域 ID */
+    scopeId?: string;
+    /** 是否启用 */
+    enabled: boolean;
+    /** 过期时间（可选，用于临时授权） */
+    expiresAt?: string;
+    /** 创建时间 */
+    createdAt: string;
+    /** 创建者 */
+    createdBy: string;
+}
+/**
+ * 权限检查请求
+ */
+interface PermissionCheckRequest {
+    /** 用户 ID */
+    userId: string;
+    /** 资源类型 */
+    resource: ResourceType;
+    /** 操作类型 */
+    action: PermissionAction;
+    /** 资源 ID（可选，用于实例级权限检查） */
+    resourceId?: string;
+    /** 作用域 */
+    scope?: PermissionScope;
+    /** 作用域 ID */
+    scopeId?: string;
 }
 /**
- * 上传凭证请求
+ * 权限检查结果
  */
-interface UploadCredentialRequest {
-    /** 文件名 */
-    filename: string;
-    /** 文件类型 */
-    contentType: string;
-    /** 文件大小 */
-    size: number;
-    /** 目录 */
-    directory?: string;
+interface PermissionCheckResult {
+    /** 是否允许 */
+    allowed: boolean;
+    /** 匹配的权限 */
+    matchedPermission?: string;
+    /** 匹配的角色 */
+    matchedRole?: string;
+    /** 拒绝原因 */
+    denyReason?: string;
 }
 /**
- * 上传凭证响应
+ * 用户权限摘要
  */
-interface UploadCredentialResponse {
-    /** 上传 URL */
-    uploadUrl: string;
-    /** 上传方法 */
-    method: 'PUT' | 'POST';
-    /** 需要的请求头 */
-    headers: Record<string, string>;
-    /** 表单字段（POST multipart 时） */
-    formFields?: Record<string, string>;
-    /** 最终文件 URL */
-    fileUrl: string;
-    /** 凭证过期时间 */
-    expiresAt: string;
+interface UserPermissionSummary {
+    /** 用户 ID */
+    userId: string;
+    /** 角色列表 */
+    roles: RoleSummary[];
+    /** 有效权限列表 */
+    effectivePermissions: string[];
+    /** 高危权限列表 */
+    dangerousPermissions: string[];
 }
 /**
- * WebSocket 消息类型
+ * 角色摘要
  */
-type WsMessageType = 'ping' | 'pong' | 'subscribe' | 'unsubscribe' | 'publish' | 'error';
+interface RoleSummary {
+    /** 角色 ID */
+    id: string;
+    /** 角色名称 */
+    name: string;
+    /** 角色显示名 */
+    label: string;
+    /** 作用域 */
+    scope: PermissionScope;
+    /** 作用域 ID */
+    scopeId?: string;
+}
 /**
- * WebSocket 消息
+ * 高危操作确认请求
+ * 用于发布、回滚、阻断等危险操作
  */
-interface WsMessage<T = unknown> {
-    /** 消息类型 */
-    type: WsMessageType;
-    /** 频道 */
-    channel?: string;
-    /** 消息数据 */
-    data?: T;
-    /** 消息 ID */
-    id?: string;
-    /** 时间戳 */
-    timestamp: number;
+interface DangerousOperationConfirmation {
+    /** 操作类型 */
+    operation: 'publish' | 'rollback' | 'block' | 'delete';
+    /** 目标资源类型 */
+    targetType: ResourceType;
+    /** 目标资源 ID */
+    targetId: string;
+    /** 操作原因 */
+    reason: string;
+    /** 影响范围描述 */
+    impactDescription?: string;
+    /** 是否需要二次确认 */
+    requireDoubleConfirm?: boolean;
+    /** 确认码（用于二次确认） */
+    confirmationCode?: string;
 }
-
 /**
- * 表达式引擎类型定义
- * 无 eval 的安全 DSL，支持发布期校验
+ * 审批节点类型
  */
+type ApprovalNodeType = 'single' | 'all' | 'any';
 /**
- * 表达式类型
+ * 审批节点
  */
-type ExpressionType = 'literal' | 'identifier' | 'member' | 'index' | 'call' | 'binary' | 'unary' | 'conditional' | 'array' | 'object';
+interface ApprovalNode {
+    /** 节点 ID */
+    id: string;
+    /** 节点名称 */
+    name: string;
+    /** 节点类型 */
+    type: ApprovalNodeType;
+    /** 审批人列表（用户 ID 或角色 ID） */
+    approvers: string[];
+    /** 审批人类型 */
+    approverType: 'user' | 'role';
+    /** 超时时间（小时） */
+    timeoutHours?: number;
+    /** 下一节点 ID */
+    nextNodeId?: string;
+}
 /**
- * 表达式 AST 节点基类
+ * 审批工作流
  */
-interface ExpressionNode {
-    /** 节点类型 */
-    type: ExpressionType;
-    /** 原始表达式 */
-    raw?: string;
-    /** 起始位置 */
-    start?: number;
-    /** 结束位置 */
-    end?: number;
+interface ApprovalWorkflow {
+    /** 工作流 ID */
+    id: string;
+    /** 工作流名称 */
+    name: string;
+    /** 适用的操作类型 */
+    applicableOperations: PermissionAction[];
+    /** 适用的资源类型 */
+    applicableResources: ResourceType[];
+    /** 审批节点列表 */
+    nodes: ApprovalNode[];
+    /** 起始节点 ID */
+    startNodeId: string;
+    /** 是否启用 */
+    enabled: boolean;
+    /** 创建时间 */
+    createdAt: string;
 }
 /**
- * 字面量节点
+ * 审批实例状态
  */
-interface LiteralNode extends ExpressionNode {
-    type: 'literal';
-    value: string | number | boolean | null;
+type ApprovalInstanceStatus = 'pending' | 'in_progress' | 'approved' | 'rejected' | 'cancelled' | 'expired';
+/**
+ * 审批实例
+ */
+interface ApprovalInstance {
+    /** 实例 ID */
+    id: string;
+    /** 工作流 ID */
+    workflowId: string;
+    /** 申请人 */
+    applicantId: string;
+    /** 申请原因 */
+    reason: string;
+    /** 操作类型 */
+    operation: PermissionAction;
+    /** 资源类型 */
+    resourceType: ResourceType;
+    /** 资源 ID */
+    resourceId: string;
+    /** 当前状态 */
+    status: ApprovalInstanceStatus;
+    /** 当前节点 ID */
+    currentNodeId: string;
+    /** 审批记录 */
+    approvalRecords: ApprovalRecord[];
+    /** 创建时间 */
+    createdAt: string;
+    /** 完成时间 */
+    completedAt?: string;
 }
 /**
- * 标识符节点
+ * 审批记录
  */
-interface IdentifierNode extends ExpressionNode {
-    type: 'identifier';
-    name: string;
+interface ApprovalRecord {
+    /** 节点 ID */
+    nodeId: string;
+    /** 审批人 ID */
+    approverId: string;
+    /** 审批人名称 */
+    approverName: string;
+    /** 审批决定 */
+    decision: 'approved' | 'rejected';
+    /** 审批意见 */
+    comment?: string;
+    /** 审批时间 */
+    decidedAt: string;
 }
+
 /**
- * 成员访问节点
+ * 安全相关类型定义
+ * 用于签名验证、供应链安全、CSP 配置等
+ *
+ * 设计原则：
+ * - SRI(integrity) 校验强制
+ * - Registry block 支持秒级止血
+ * - CSP：script-src 限制到 CDN 域 + nonce/hash
+ * - 可选：产物签名（防对象存储被替换）
  */
-interface MemberNode extends ExpressionNode {
-    type: 'member';
-    object: ExpressionNode;
-    property: string;
+/**
+ * 签名算法
+ */
+type SignatureAlgorithm = 'ed25519' | 'rsa-sha256' | 'ecdsa-p256';
+/**
+ * 资源签名
+ * 用于验证组件、运行时等产物的完整性
+ */
+interface ResourceSignature {
+    /** 签名算法 */
+    algorithm: SignatureAlgorithm;
+    /** 公钥（用于验证） */
+    publicKey: string;
+    /** 签名值（Base64 编码） */
+    signature: string;
+    /** 签名时间 */
+    signedAt: string;
+    /** 签名者标识 */
+    signedBy: string;
+    /** 签名者密钥 ID */
+    keyId?: string;
+    /** 有效期（可选） */
+    expiresAt?: string;
 }
 /**
- * 函数调用节点
+ * 签名验证请求
  */
-interface CallNode extends ExpressionNode {
-    type: 'call';
-    callee: string;
-    arguments: ExpressionNode[];
+interface SignatureVerifyRequest {
+    /** 待验证内容的哈希 */
+    contentHash: string;
+    /** 签名信息 */
+    signature: ResourceSignature;
+    /** 预期的签名者 */
+    expectedSigner?: string;
 }
 /**
- * 二元运算节点
+ * 签名验证结果
  */
-interface BinaryNode extends ExpressionNode {
-    type: 'binary';
-    operator: BinaryOperator;
-    left: ExpressionNode;
-    right: ExpressionNode;
+interface SignatureVerifyResult {
+    /** 是否有效 */
+    valid: boolean;
+    /** 验证失败原因 */
+    reason?: SignatureInvalidReason;
+    /** 签名者信息 */
+    signer?: string;
+    /** 签名时间 */
+    signedAt?: string;
 }
 /**
- * 二元运算符
+ * 签名无效原因
  */
-type BinaryOperator = '+' | '-' | '*' | '/' | '%' | '==' | '!=' | '>' | '<' | '>=' | '<=' | '&&' | '||' | '??';
+type SignatureInvalidReason = 'SIGNATURE_MISMATCH' | 'KEY_NOT_FOUND' | 'KEY_EXPIRED' | 'SIGNATURE_EXPIRED' | 'ALGORITHM_NOT_SUPPORTED' | 'SIGNER_NOT_TRUSTED';
 /**
- * 一元运算符
+ * SRI 哈希算法
  */
-type UnaryOperator = '!' | '-' | '+';
+type SriAlgorithm = 'sha256' | 'sha384' | 'sha512';
 /**
- * 内置函数定义
+ * SRI 完整性定义
+ * 格式：algorithm-base64hash
  */
-interface BuiltinFunction {
-    /** 函数名 */
-    name: string;
-    /** 描述 */
-    description: string;
-    /** 参数定义 */
-    params: FunctionParam[];
-    /** 返回类型 */
-    returnType: ValueType;
-    /** 示例 */
-    examples?: string[];
+interface SriIntegrity {
+    /** 算法 */
+    algorithm: SriAlgorithm;
+    /** 哈希值（Base64 编码） */
+    hash: string;
+    /** 完整的 integrity 字符串 */
+    value: string;
 }
 /**
- * 函数参数定义
+ * 完整性校验请求
  */
-interface FunctionParam {
-    /** 参数名 */
-    name: string;
-    /** 参数类型 */
-    type: ValueType;
-    /** 是否必填 */
-    required: boolean;
-    /** 默认值 */
-    defaultValue?: unknown;
-    /** 描述 */
-    description?: string;
+interface IntegrityCheckRequest {
+    /** 资源 URL */
+    url: string;
+    /** 预期的 integrity 值 */
+    expectedIntegrity: string;
+    /** 资源内容（可选，用于离线校验） */
+    content?: ArrayBuffer;
 }
 /**
- * 值类型
+ * 完整性校验结果
  */
-type ValueType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'null' | 'any' | 'void';
+interface IntegrityCheckResult {
+    /** 是否匹配 */
+    matched: boolean;
+    /** 实际计算的哈希 */
+    actualHash?: string;
+    /** 预期的哈希 */
+    expectedHash?: string;
+    /** 校验时间 */
+    checkedAt: string;
+}
 /**
- * 内置函数白名单
- * 表达式中只能调用这些函数
+ * CSP 指令类型
  */
-declare const BUILTIN_FUNCTIONS: BuiltinFunction[];
+type CspDirective = 'default-src' | 'script-src' | 'style-src' | 'img-src' | 'font-src' | 'connect-src' | 'frame-src' | 'object-src' | 'base-uri' | 'form-action' | 'frame-ancestors' | 'report-uri' | 'report-to';
 /**
- * 内置函数名称集合（用于快速校验）
+ * CSP 来源值
+ * 使用 (string & {}) 技巧保持自动补全同时允许任意 URL
  */
-declare const BUILTIN_FUNCTION_NAMES: Set<string>;
+type CspSourceValue = "'self'" | "'unsafe-inline'" | "'unsafe-eval'" | "'strict-dynamic'" | "'none'" | `'nonce-${string}'` | `'sha256-${string}'` | `'sha384-${string}'` | `'sha512-${string}'` | (string & NonNullable<unknown>);
 /**
- * 表达式上下文
- * 表达式执行时可访问的变量
+ * CSP 配置
  */
-interface ExpressionContext {
-    /** 页面状态 */
-    state: Record<string, unknown>;
-    /** 查询结果 */
-    query: Record<string, unknown>;
-    /** 运行时上下文 */
-    context: {
-        userId?: string;
-        deviceId?: string;
-        channel?: string;
-        pageVersionId?: string;
-        [key: string]: unknown;
-    };
-    /** 事件参数 */
-    event?: Record<string, unknown>;
-    /** 循环变量 */
-    item?: unknown;
-    /** 循环索引 */
-    index?: number;
+interface CspConfig {
+    /** 是否启用 */
+    enabled: boolean;
+    /** 是否仅报告模式 */
+    reportOnly?: boolean;
+    /** 指令配置 */
+    directives: Partial<Record<CspDirective, CspSourceValue[]>>;
+    /** 报告端点 */
+    reportUri?: string;
+    /** Nonce 值（运行时生成） */
+    nonce?: string;
 }
 /**
- * 表达式允许访问的根变量
+ * CSP 违规报告
  */
-declare const ALLOWED_ROOT_VARIABLES: readonly ["state", "query", "context", "event", "item", "index"];
+interface CspViolationReport {
+    /** 文档 URL */
+    documentUri: string;
+    /** 被阻止的资源 URL */
+    blockedUri: string;
+    /** 违规的指令 */
+    violatedDirective: string;
+    /** 原始策略 */
+    originalPolicy: string;
+    /** 来源文件 */
+    sourceFile?: string;
+    /** 行号 */
+    lineNumber?: number;
+    /** 列号 */
+    columnNumber?: number;
+    /** 状态码 */
+    statusCode?: number;
+    /** 时间戳 */
+    timestamp: string;
+}
 /**
- * 表达式校验结果
+ * 受信任的签名者
  */
-interface ExpressionValidationResult {
-    /** 是否有效 */
-    valid: boolean;
-    /** 错误列表 */
-    errors: ExpressionError[];
-    /** 警告列表 */
-    warnings: ExpressionWarning[];
-    /** 引用的变量路径 */
-    referencedPaths: string[];
-    /** 调用的函数 */
-    calledFunctions: string[];
+interface TrustedSigner {
+    /** 签名者 ID */
+    id: string;
+    /** 签名者名称 */
+    name: string;
+    /** 公钥列表 */
+    publicKeys: SignerPublicKey[];
+    /** 信任级别 */
+    trustLevel: 'full' | 'limited' | 'revoked';
+    /** 创建时间 */
+    createdAt: string;
+    /** 吊销时间 */
+    revokedAt?: string;
 }
 /**
- * 表达式错误
+ * 签名者公钥
  */
-interface ExpressionError {
-    /** 错误类型 */
-    type: ExpressionErrorType;
-    /** 错误消息 */
-    message: string;
-    /** 位置 */
-    position?: {
-        start: number;
-        end: number;
-    };
+interface SignerPublicKey {
+    /** 密钥 ID */
+    keyId: string;
+    /** 算法 */
+    algorithm: SignatureAlgorithm;
+    /** 公钥（PEM 或 Base64 编码） */
+    publicKey: string;
+    /** 创建时间 */
+    createdAt: string;
+    /** 过期时间 */
+    expiresAt?: string;
+    /** 是否激活 */
+    active: boolean;
 }
 /**
- * 表达式错误类型
+ * 安全策略配置
  */
-type ExpressionErrorType = 'SYNTAX_ERROR' | 'UNKNOWN_FUNCTION' | 'INVALID_ARGUMENT' | 'UNKNOWN_VARIABLE' | 'TYPE_MISMATCH' | 'ACCESS_DENIED';
+interface SecurityPolicy {
+    /** 策略 ID */
+    id: string;
+    /** 策略名称 */
+    name: string;
+    /** 是否启用 SRI 校验 */
+    requireIntegrity: boolean;
+    /** 是否启用签名校验 */
+    requireSignature: boolean;
+    /** 受信任的签名者列表 */
+    trustedSigners?: string[];
+    /** CSP 配置 */
+    csp?: CspConfig;
+    /** 允许的 CDN 域名 */
+    allowedCdnDomains: string[];
+    /** 允许的 API 域名 */
+    allowedApiDomains: string[];
+    /** 创建时间 */
+    createdAt: string;
+    /** 更新时间 */
+    updatedAt?: string;
+}
 /**
- * 表达式警告
+ * 资源安全事件类型
+ * 用于供应链安全、完整性校验等场景
+ * 注意：审计相关的安全事件类型见 audit/index.ts 中的 SecurityEventType
  */
-interface ExpressionWarning {
-    /** 警告类型 */
-    type: 'DEPRECATED' | 'PERFORMANCE' | 'NULLABLE';
-    /** 警告消息 */
+type ResourceSecurityEventType = 'integrity_violation' | 'signature_invalid' | 'csp_violation' | 'unauthorized_resource' | 'blocked_component_load' | 'suspicious_behavior';
+/**
+ * 资源安全事件
+ * 用于运行时资源加载和供应链安全
+ */
+interface ResourceSecurityEvent {
+    /** 事件 ID */
+    id: string;
+    /** 事件类型 */
+    type: ResourceSecurityEventType;
+    /** 严重程度 */
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    /** 事件描述 */
     message: string;
-    /** 位置 */
-    position?: {
-        start: number;
-        end: number;
+    /** 相关资源 */
+    resource?: {
+        type: string;
+        url?: string;
+        name?: string;
+        version?: string;
+    };
+    /** 上下文信息 */
+    context: {
+        pageVersionId?: string;
+        componentVersion?: string;
+        userId?: string;
+        deviceId?: string;
+        ip?: string;
+        userAgent?: string;
     };
+    /** 事件时间 */
+    timestamp: string;
+    /** 追踪 ID */
+    traceId?: string;
 }
 /**
- * 表达式绑定
- * 用于属性值的动态绑定
+ * 密钥用途
  */
-interface ExpressionBinding {
-    /** 是否为表达式 */
-    __isExpression: true;
-    /** 表达式字符串 */
-    expression: string;
-    /** 默认值（表达式失败时使用） */
-    fallback?: unknown;
-}
+type KeyPurpose = 'component_signing' | 'runtime_signing' | 'api_signing' | 'token_signing';
 /**
- * 检查是否为表达式绑定
+ * 密钥元数据
+ * 注意：仅包含元数据，不包含私钥
  */
-declare function isExpressionBinding(value: unknown): value is ExpressionBinding;
+interface KeyMetadata {
+    /** 密钥 ID */
+    keyId: string;
+    /** 密钥用途 */
+    purpose: KeyPurpose;
+    /** 算法 */
+    algorithm: SignatureAlgorithm;
+    /** 公钥 */
+    publicKey: string;
+    /** 创建时间 */
+    createdAt: string;
+    /** 过期时间 */
+    expiresAt?: string;
+    /** 轮换时间 */
+    rotatedAt?: string;
+    /** 是否为当前活动密钥 */
+    isActive: boolean;
+    /** 创建者 */
+    createdBy: string;
+}
 /**
- * 创建表达式绑定
+ * 密钥轮换请求
  */
-declare function createExpressionBinding(expression: string, fallback?: unknown): ExpressionBinding;
+interface KeyRotationRequest {
+    /** 当前密钥 ID */
+    currentKeyId: string;
+    /** 密钥用途 */
+    purpose: KeyPurpose;
+    /** 算法 */
+    algorithm: SignatureAlgorithm;
+    /** 过渡期（小时），在此期间新旧密钥都有效 */
+    transitionHours?: number;
+    /** 轮换原因 */
+    reason: string;
+}
 
 /**
  * Schema 迁移脚本
@@ -1955,4 +4691,4 @@ declare function getVersionInfo(version: string): {
  */
 declare function compareVersions(a: string, b: string): number;
 
-export { ACTION_SPEC_VERSION, ALLOWED_ROOT_VARIABLES, type ActionAuditLog, type ActionContext, type ActionDefVersionId, type ActionDefinition, type ActionDefinitionStatus, type ActionDefinitionVersion, type ActionExecuteRequest, type ActionExecuteResponse, type ApiConfig, type ApiResponse, type Asset, type AssetMeta, type AssetSortField, type AssetStatus, type AssetType, type AuditStatus, BUILTIN_FUNCTIONS, BUILTIN_FUNCTION_NAMES, type BatchItemResult, type BatchRequest, type BatchResult, type BinaryNode, type BinaryOperator, type BlockedComponent, type BuiltinActionType, type BuiltinFunction, COMPONENT_CATEGORIES, COMPONENT_META_SCHEMA_VERSION, CURRENT_SCHEMA_VERSION, type CacheConfig, type CallNode, type CanvasConfig, type CanvasType, type CapabilitiesDefinition, type ChangeLog, type ChangeLogItem, type ClipboardResult, type CompatDefinition, type ComponentCategory, type ComponentEvent, type ComponentInstance, type ComponentLayout, type ComponentLoadResult, type ComponentLoadStatus, type ComponentMeta, type ComponentRegistry, type ComponentStatus, type ComponentStyle, type ComponentVersionId, type ComponentVersionRecord, type ContractsVersion, DATA_QUERY_SPEC_VERSION, type DataQueryContext, type DataQueryDefinition, type DataQueryDefinitionStatus, type DataQueryDefinitionVersion, type DataQueryRequest, type DataQueryResponse, type DataQueryVersionId, type DataSourceConfig, type DataSourceType, type DeepReadonly, type DependencyHealth, type DialogOptions, type DjvlcError, type ErrorBoundaryHandler, ErrorCode, ErrorCodeCategory, ErrorMessages, type EventAction, type EventBus, type EventDefinition, type EventsDefinition, type ExpressionBinding, type ExpressionContext, type ExpressionError, type ExpressionErrorType, type ExpressionNode, type ExpressionType, type ExpressionValidationResult, type ExpressionWarning, type FieldPermission, type FunctionParam, type GenericStatus, type GrayPublishConfig, type GrayRule, type Guide, type HealthCheckResponse, type HostAPI, type IdempotencyRule, type IdentifierNode, type IntegrityDefinition, type JsonSchema, type KeyValuePair, type LiteralNode, type LowcodeAction, type ManifestItem, type MaskRule, type MemberNode, type Migration, type MigrationFn, type MigrationResult, type NavigateOptions, type NonNullableProperties, type OperatorInfo, PAGE_SCHEMA_VERSION, type PageConfig, type PageManifest, type PageMeta, type PageResolveRequest, type PageResolveResult, type PageSchema, type PageSortField, type PageStatus, type PageUid, type PageVersionId, type PaginatedApiResponse, type PaginatedResult, type PaginationMeta, type PaginationParams, type PartialBy, type PerformanceMetric, type PerformanceMetricType, type PropsSchema, type PublishChannel, type PublishConfig, PublishStatus, type QueryAuditLog, type QueryPermissionConfig, type RateLimitRule, type RequiredBy, type RiskCheckRequest, type RiskCheckResult, type RolloutConfig, type RuntimeConfig, type RuntimeContext, type RuntimeError, type RuntimeErrorType, type RuntimeEvent, type RuntimeEventType, SCHEMA_VERSIONS, type SchemaVersion, type SortConfig, type SortOrder, type StandardRequestHeaders, type StandardResponseHeaders, type StorageOptions, type TemplateCategory, type TemplateSortField, type TimeRange, type ToastOptions, type TraceId, type TrackEvent, type UnaryOperator, type UploadCredentialRequest, type UploadCredentialResponse, type ValueType, type VersionDiff, type VersionInfo, type WsMessage, type WsMessageType, compareVersions, createDjvlcError, createExpressionBinding, findMigrationPath, getAllMigrations, getContractsVersion, getHttpStatusFromErrorCode, getVersionInfo, isExpressionBinding, isRetryableError, isVersionCompatible, migratePageSchema, needsMigration, registerMigration };
+export { ACTION_SPEC_VERSION, ALLOWED_ROOT_VARIABLES, type AccumulateReward, type ActionAuditLog, type ActionContext, type ActionDefVersionId, type ActionDefinition, type ActionDefinitionStatus, type ActionDefinitionVersion, type ActionExecuteRequest, type ActionExecuteResponse, type ActionExecutionLog, type Activity, type ActivityRules, type ActivityStatus, type ActivityType, type AggregationBucket, type ApiConfig, type ApiResponse, type AppConfig, type ApprovalInfo, type ApprovalInstance, type ApprovalInstanceStatus, type ApprovalNode, type ApprovalNodeType, type ApprovalRecord, type ApprovalWorkflow, type ApproverInfo, type ArrayWidgetConfig, type Asset, type AssetMeta, type AssetSortField, type AssetStatus, type AssetType, type AuditContext, type AuditExportFormat, type AuditExportRequest, type AuditExportResponse, type AuditLog, type AuditLogLevel, type AuditLogQueryRequest, type AuditResult, type AuditSource, type AuditStatistics, type AuditStatus, type AuditTargetType, BUILTIN_FUNCTIONS, BUILTIN_FUNCTION_NAMES, BUILTIN_PERMISSIONS, BUILTIN_PROPERTY_GROUPS, BUILTIN_ROLES, type BaseContext, type BatchItemResult, type BatchRequest, type BatchResult, type BatchTrackRequest, type BinaryNode, type BinaryOperator, type BlockComponentRequest, type BlockedComponent, type BootstrapConfig, type BuiltinActionType, type BuiltinFunction, COMPONENT_CATEGORIES, COMPONENT_META_SCHEMA_VERSION, CURRENT_SCHEMA_VERSION, type CacheConfig, type CallNode, type CanvasConfig, type CanvasType, type CapabilitiesDefinition, type CdnRefreshPayload, type ChangeComponentStatusRequest, type ChangeLog, type ChangeLogItem, type ChangeRecord, type ChangeSummary, type ChangeType, type ClaimActivityRules, type ClipboardResult, type CodeWidgetConfig, type ColorWidgetConfig, type CompatDefinition, type ComponentAggregations, type ComponentBlockAuditDetails, type ComponentBlockedPayload, type ComponentCategory, type ComponentEvent, type ComponentEventDetail, type ComponentEventEmitter, type ComponentInstance, type ComponentLayout, type ComponentLifecycleCallbacks, type ComponentLifecyclePhase, type ComponentLoadResult, type ComponentLoadStatus, type ComponentMeta, type ComponentMetaLite, type ComponentRegisterOptions, type ComponentRegisterResult, type ComponentRenderContext, type ComponentSearchItem, type ComponentSortField, type ComponentStatus, type ComponentStyle, type ComponentVersionId, type ComponentVersionInfo, type ComponentVersionQuery, type ComponentVersionInfo as ComponentVersionRecord, type ComponentWarning, type ComponentWarningType, type ContractsVersion, type CreatePreviewTokenRequest, type CspConfig, type CspDirective, type CspSourceValue, type CspViolationReport, type CustomWidgetConfig, DATA_QUERY_SPEC_VERSION, type DangerousOperationConfirmation, type DataQueryContext, type DataQueryDefinition, type DataQueryDefinitionStatus, type DataQueryDefinitionVersion, type DataQueryRequest, type DataQueryResponse, type DataQueryVersionId, type DataSourceConfig, type DataSourceType, type DeadLetterEvent, type DeepReadonly, type DependencyHealth, type DialogOptions, type DjvComponent, type DjvComponentConstructor, type DjvlcError, type EditorWidgetType, type EligibilityRules, ErrorCode, ErrorCodeCategory, type ErrorHistoryItem, ErrorMessages, type EventAction, type EventConsumerConfig, type EventDefinition, type EventsDefinition, type ExpressionBinding, type ExpressionContext, type ExpressionError, type ExpressionErrorType, type ExpressionNode, type ExpressionType, type ExpressionValidationResult, type ExpressionWarning, type FailedComponent, type FieldChange, type FieldPermission, type FunctionParam, type GenericStatus, type GrayPublishConfig, type RolloutRule as GrayRule, type GuaranteeRule, type Guide, type HealthCheckResponse, type HostAPI, type IdempotencyRule, type IdentifierNode, type InputWidgetConfig, type IntegrityCheckRequest, type IntegrityCheckResult, type IntegrityDefinition, type JsonSchema, type KeyMetadata, type KeyPurpose, type KeyRotationRequest, type KeyValuePair, type KillSwitchConfig, type LimitRules, type ListComponentVersionsRequest, type ListComponentVersionsResponse, type LiteralNode, type LotteryActivityRules, type LotteryCost, type LotteryState, type LowcodeAction, type ManifestItem, type MaskRule, type MediaWidgetConfig, type MemberNode, type Migration, type MigrationFn, type MigrationResult, type NavigateOptions, type NonNullableProperties, type NotificationSendPayload, type NumberWidgetConfig, type ObjectWidgetConfig, type OperatorInfo, type OptionsSource, type OutboxEvent, type OutboxEventStatus, type OutboxEventType, PAGE_SCHEMA_VERSION, type PageConfig, type PageManifest, type PageMeta, type PagePublishAuditDetails, type PagePublishedPayload, type PageResolveRequest, type PageResolveResult, type PageRollbackAuditDetails, type PageRolledBackPayload, type PageSchema, type PageSortField, type PageStatus, type PageUid, type PageVersionId, type PaginatedApiResponse, type PaginatedResult, type PaginationMeta, type PaginationParams, type PartialBy, type PerformanceMetric, type PerformanceMetricType, type Permission, type PermissionAction, type PermissionCheckRequest, type PermissionCheckResult, type PermissionScope, type PreviewToken, type PrizeConfig, type PrizePoolConfig, type PropChangeEvent, type PropObserverConfig, type PropertyGroup, type PropertyPanelConfig, type PropsSchema, type PublishChannel, type PublishConfig, type PublishEventRequest, type PublishEventResponse, PublishStatus, type QueryAuditLog, type QueryExecutionLog, type QueryPermissionConfig, type RateLimitRule, type RegisterComponentVersionRequest, type RegisterComponentVersionResponse, type ReminderConfig, type RequiredBy, type ReserveActivityRules, type ReserveField, type ResolveFailReason, type ResolveVersionsRequest, type ResolveVersionsResponse, type ResolvedComponent, type ResourceSecurityEvent, type ResourceSecurityEventType, type ResourceSignature, type ResourceType, type RetryStrategy, type RewardConfig, type RewardDeliverPayload, type RewardDeliveryMethod, type RewardOption, type RewardRules, type RewardType, type RiskCheckRequest, type RiskCheckResult, type RiskRules, type Role, type RoleBinding, type RoleStatus, type RoleSummary, type RolloutConfig, type RolloutRule, type RolloutRuleType, type RuntimeConfig, type RuntimeContext, type RuntimeError, type RuntimeErrorType, type RuntimeEvent, type RuntimeEventType, SCHEMA_VERSIONS, type SchemaVersion, type SearchComponentsRequest, type SearchComponentsResponse, type SecurityAuditLog, type SecurityEventType, type SecurityPolicy, type SelectOption, type SelectWidgetConfig, type ShadowDomConfig, type SignatureAlgorithm, type SignatureInvalidReason, type SignatureVerifyRequest, type SignatureVerifyResult, type SignerPublicKey, type SigninActivityRules, type SigninState, type SizeWidgetConfig, type SlotDefinition, type SlotType, type SlotsDefinition, type SortConfig, type SortOrder, type SriAlgorithm, type SriIntegrity, type StandardRequestHeaders, type StandardResponseHeaders, type StaticExportPayload, type StorageOptions, type StreakReward, type StyleIsolationMode, type TaskActivityRules, type TaskCondition, type TaskConfig, type TaskState, type TaskType, type TemplateCategory, type TemplateSortField, type TenantConfig, type TenantQuotas, type ThreatIndicator, type TimeRange, type TimeSlot, type ToastOptions, type TraceId, type TrackContext, type TrackEvent, type TrackEventType, type TrackRequest, type TrackResponse, type TrustedSigner, type UnaryOperator, type UnblockComponentRequest, type UploadCredentialRequest, type UploadCredentialResponse, type UserActivityState, type UserPermissionSummary, type ValueType, type VersionDiff, type VersionInfo, type WidgetBaseConfig, type WidgetConfig, type WorkerTask, type WorkerTaskResult, type WorkerTaskStatus, type WsMessage, type WsMessageType, compareVersions, createDjvlcError, createExpressionBinding, findMigrationPath, getAllMigrations, getContractsVersion, getHttpStatusFromErrorCode, getVersionInfo, isExpressionBinding, isRetryableError, isVersionCompatible, migratePageSchema, needsMigration, registerMigration };