@djvlc/runtime-web 1.0.4 → 1.0.5

package/dist/index.d.ts

@@ -1,77 +1,1325 @@
-import { mount, lazyMount, batchMount, warmup } from './mount';
-import { createTrackingManager } from './tracking';
-import { createErrorReporter } from './error-reporter';
-import { createPerformanceMonitor, getPagePerformance, getResourcePerformance, getRuntimeResourcePerformance } from './performance';
-import { createStorageHelper } from './storage';
-import { preconnect, preloadAssets, getDeviceId, generateTraceId, generateSpanId, generateTraceparent, onVisibilityChange, onNetworkChange, isMobile, isWeChat, supportsWebP } from './utils';
-import { createRuntime } from '@djvlc/runtime-core';
-/**
- * @djvlc/runtime-web - DJV 低代码平台浏览器版运行时
- *
- * 用于 CDN 发布，提供：
- * - runtime.esm.js - ES Module 版本
- * - runtime.iife.js - IIFE 版本（全局变量 DJVRuntime）
- * - runtime.css - 运行时样式
- *
- * @example
- * ```html
- * <!-- IIFE 方式 -->
- * <script src="https://cdn.example.com/runtime/1.0.0/runtime.iife.js"></script>
- * <script>
- *   DJVRuntime.mount('#app', { pageUid: 'page_123', apiBaseUrl: '...' });
- * </script>
- *
- * <!-- ESM 方式 -->
- * <script type="module">
- *   import { mount } from 'https://cdn.example.com/runtime/1.0.0/runtime.esm.js';
- *   mount('#app', { pageUid: 'page_123', apiBaseUrl: '...' });
- * </script>
- * ```
- */
-export { RUNTIME_VERSION } from './version';
-export { mount, lazyMount, batchMount, warmup, } from './mount';
-export type { MountOptions, MountResult, LazyMountOptions, BatchMountResult, } from './mount';
-export { TrackingManager, createTrackingManager, } from './tracking';
-export type { TrackEvent, TrackingConfig, } from './tracking';
-export { ErrorReporter, createErrorReporter, } from './error-reporter';
-export type { ErrorReport, ErrorReporterConfig, } from './error-reporter';
-export { PerformanceMonitor, createPerformanceMonitor, collectWebVitalsMetrics, getPagePerformance, getResourcePerformance, getRuntimeResourcePerformance, } from './performance';
-export type { PerformanceMetrics, } from './performance';
-export { StorageHelper, createStorageHelper, } from './storage';
-export { preconnect, preloadAssets, getDeviceId, generateTraceId, generateSpanId, generateTraceparent, urlUtils, onVisibilityChange, onNetworkChange, isMobile, isWeChat, supportsWebP, } from './utils';
-export { createRuntime } from '@djvlc/runtime-core';
-export type { RuntimeOptions, RuntimeState, LoadedComponent, Logger } from '@djvlc/runtime-core';
-declare const _default: {
-    RUNTIME_VERSION: string;
-    mount: typeof mount;
-    lazyMount: typeof lazyMount;
-    batchMount: typeof batchMount;
-    warmup: typeof warmup;
-    createTrackingManager: typeof createTrackingManager;
-    createErrorReporter: typeof createErrorReporter;
-    createPerformanceMonitor: typeof createPerformanceMonitor;
-    getPagePerformance: typeof getPagePerformance;
-    getResourcePerformance: typeof getResourcePerformance;
-    getRuntimeResourcePerformance: typeof getRuntimeResourcePerformance;
-    createStorageHelper: typeof createStorageHelper;
-    preconnect: typeof preconnect;
-    preloadAssets: typeof preloadAssets;
-    getDeviceId: typeof getDeviceId;
-    generateTraceId: typeof generateTraceId;
-    generateSpanId: typeof generateSpanId;
-    generateTraceparent: typeof generateTraceparent;
-    urlUtils: {
-        getParam(name: string, url?: string): string | null;
-        setParam(name: string, value: string): void;
-        removeParam(name: string): void;
-        build(base: string, params: Record<string, string | number | boolean | undefined>): string;
-    };
-    onVisibilityChange: typeof onVisibilityChange;
-    onNetworkChange: typeof onNetworkChange;
-    isMobile: typeof isMobile;
-    isWeChat: typeof isWeChat;
-    supportsWebP: typeof supportsWebP;
-    createRuntime: typeof createRuntime;
-};
-export default _default;
-//# sourceMappingURL=index.d.ts.map
+import { ActionResult } from '@djvlc/contracts-types';
+import { ActionSheetOptions } from '@djvlc/contracts-types';
+import { ActionSheetResult } from '@djvlc/contracts-types';
+import { ClipboardApi } from '@djvlc/contracts-types';
+import { ComponentContext } from '@djvlc/contracts-types';
+import { ConfirmOptions } from '@djvlc/contracts-types';
+import { DialogOptions } from '@djvlc/contracts-types';
+import { DialogResult } from '@djvlc/contracts-types';
+import * as _djvlc_contracts_types from '@djvlc/contracts-types';
+import { Expression } from '@djvlc/contracts-types';
+import { ExpressionContext } from '@djvlc/contracts-types';
+import { ExpressionValidationResult } from '@djvlc/contracts-types';
+import { HostApi } from '@djvlc/contracts-types';
+import { NavigateOptions } from '@djvlc/contracts-types';
+import { PreviewImageOptions } from '@djvlc/contracts-types';
+import { ScanCodeResult } from '@djvlc/contracts-types';
+import { ShareOptions } from '@djvlc/contracts-types';
+import { ShareResult } from '@djvlc/contracts-types';
+import { StorageApi } from '@djvlc/contracts-types';
+import { ToastOptions } from '@djvlc/contracts-types';
+import { TrackEvent as TrackEvent_3 } from '@djvlc/contracts-types';
+
+declare interface ArrayASTNode extends BaseASTNode {
+    type: 'array';
+    elements: ASTNode[];
+}
+
+declare type ASTNode = LiteralASTNode | IdentifierASTNode | MemberASTNode | CallASTNode | BinaryASTNode | UnaryASTNode | ConditionalASTNode | ArrayASTNode;
+
+/**
+ * 表达式解析器
+ * 将 Token 列表解析为 AST
+ */
+
+/**
+ * AST 基础节点接口
+ */
+declare interface BaseASTNode {
+    type: string;
+    /** 起始位置（可选，用于错误定位） */
+    start?: number;
+    /** 结束位置（可选，用于错误定位） */
+    end?: number;
+    /** 原始字符串（可选，用于调试） */
+    raw?: string;
+}
+
+/**
+ * 批量挂载
+ */
+export declare function batchMount(mounts: Array<{
+    id: string;
+    container: string | HTMLElement;
+    options: MountOptions;
+}>, options?: {
+    concurrency?: number;
+    continueOnError?: boolean;
+}): Promise<BatchMountResult>;
+
+/**
+ * 批量挂载结果
+ */
+export declare interface BatchMountResult {
+    /** 成功的挂载结果 */
+    results: Map<string, MountResult>;
+    /** 失败的错误 */
+    errors: Map<string, Error>;
+    /** 总耗时 */
+    totalTime: number;
+}
+
+declare interface BinaryASTNode extends BaseASTNode {
+    type: 'binary';
+    operator: string;
+    left: ASTNode;
+    right: ASTNode;
+}
+
+declare interface CallASTNode extends BaseASTNode {
+    type: 'call';
+    callee: string;
+    arguments: ASTNode[];
+}
+
+/**
+ * 采集 Web Vitals 指标
+ */
+export declare function collectWebVitalsMetrics(metrics: PerformanceMetrics): void;
+
+/**
+ * 组件加载结果
+ */
+declare interface ComponentLoadResult {
+    /** 组件名称 */
+    name: string;
+    /** 组件版本 */
+    version: string;
+    /** 加载状态 */
+    status: ComponentLoadStatus;
+    /** 组件构造函数（加载成功时） */
+    component?: CustomElementConstructor | unknown;
+    /** 加载耗时（毫秒） */
+    loadTime?: number;
+    /** 错误信息（加载失败时） */
+    error?: string;
+}
+
+/**
+ * 组件加载状态
+ */
+declare type ComponentLoadStatus = 'loading' | 'loaded' | 'failed' | 'blocked';
+
+declare interface ConditionalASTNode extends BaseASTNode {
+    type: 'conditional';
+    test: ASTNode;
+    consequent: ASTNode;
+    alternate: ASTNode;
+}
+
+/**
+ * 创建错误报告器
+ */
+export declare function createErrorReporter(config?: ErrorReporterConfig): ErrorReporter;
+
+/**
+ * 创建性能监控器
+ */
+export declare function createPerformanceMonitor(enabled?: boolean): PerformanceMonitor;
+
+/**
+ * 创建运行时实例
+ */
+export declare function createRuntime(options: RuntimeOptions): DjvlcRuntime;
+
+/**
+ * 创建存储辅助类
+ */
+export declare function createStorageHelper(namespace?: string, useSession?: boolean): StorageHelper;
+
+/**
+ * 创建埋点管理器
+ */
+export declare function createTrackingManager(config?: TrackingConfig): TrackingManager;
+
+declare const _default: {
+    RUNTIME_VERSION: string;
+    mount: typeof mount;
+    lazyMount: typeof lazyMount;
+    batchMount: typeof batchMount;
+    warmup: typeof warmup;
+    createTrackingManager: typeof createTrackingManager;
+    createErrorReporter: typeof createErrorReporter;
+    createPerformanceMonitor: typeof createPerformanceMonitor;
+    getPagePerformance: typeof getPagePerformance;
+    getResourcePerformance: typeof getResourcePerformance;
+    getRuntimeResourcePerformance: typeof getRuntimeResourcePerformance;
+    createStorageHelper: typeof createStorageHelper;
+    preconnect: typeof preconnect;
+    preloadAssets: typeof preloadAssets;
+    getDeviceId: typeof getDeviceId;
+    generateTraceId: typeof generateTraceId;
+    generateSpanId: typeof generateSpanId;
+    generateTraceparent: typeof generateTraceparent;
+    urlUtils: {
+        getParam(name: string, url?: string): string | null;
+        setParam(name: string, value: string): void;
+        removeParam(name: string): void;
+        build(base: string, params: Record<string, string | number | boolean | undefined>): string;
+    };
+    onVisibilityChange: typeof onVisibilityChange;
+    onNetworkChange: typeof onNetworkChange;
+    isMobile: typeof isMobile;
+    isWeChat: typeof isWeChat;
+    supportsWebP: typeof supportsWebP;
+    createRuntime: typeof createRuntime;
+};
+export default _default;
+
+/**
+ * DJVLC 运行时
+ *
+ * 核心职责：
+ * 1. resolve & load：拿到 pageVersion 与 manifest，按 componentVersion 拉资源
+ * 2. render：把 schema 变成 UI（基于 Web Components）
+ * 3. boundary：组件只能通过 hostApi 触发 data/action/navigate/track
+ */
+declare class DjvlcRuntime {
+    private options;
+    private container;
+    private pageLoader;
+    private componentLoader;
+    private assetLoader;
+    private stateManager;
+    private dataBindingManager;
+    private eventBus;
+    private actionBridge;
+    private expressionEngine;
+    private securityManager;
+    private telemetryManager;
+    private renderer;
+    private hostApi;
+    private lifecycleManager;
+    private logger;
+    constructor(options: RuntimeOptions);
+    /**
+     * 初始化运行时
+     */
+    init(): Promise<void>;
+    /**
+     * 加载页面
+     */
+    load(): Promise<PageResolveResult>;
+    /**
+     * 渲染页面
+     */
+    render(): Promise<void>;
+    /**
+     * 获取 Host API
+     */
+    getHostApi(): HostAPIImpl;
+    /**
+     * 获取当前状态
+     */
+    getState(): RuntimeState;
+    /**
+     * 订阅状态变更
+     */
+    onStateChange(listener: (state: RuntimeState) => void): () => void;
+    /**
+     * 订阅事件
+     */
+    on<T>(type: RuntimeEvent<T>['type'], handler: (event: RuntimeEvent<T>) => void): () => void;
+    /**
+     * 更新组件
+     */
+    updateComponent(componentId: string, props: Record<string, unknown>): void;
+    /**
+     * 设置变量
+     */
+    setVariable(key: string, value: unknown): void;
+    /**
+     * 获取变量
+     */
+    getVariable<T = unknown>(key: string): T | undefined;
+    /**
+     * 刷新数据
+     */
+    refreshData(queryId: string): Promise<void>;
+    /**
+     * 执行动作
+     */
+    executeAction(actionType: string, params?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * 销毁运行时
+     */
+    destroy(): Promise<void>;
+    /**
+     * 验证 Schema 版本
+     */
+    private validateSchemaVersion;
+    private resolveContainer;
+    private initHostApi;
+    private initActionBridge;
+    private initDataBindingManager;
+    private initLifecycleManager;
+    private initRenderer;
+    /**
+     * 处理组件事件
+     */
+    private handleComponentEvent;
+    private handleError;
+    private emitEvent;
+    private createLogger;
+    private log;
+}
+
+/**
+ * 错误报告
+ */
+export declare interface ErrorReport {
+    /** 错误消息 */
+    message: string;
+    /** 错误堆栈 */
+    stack?: string;
+    /** 错误类型 */
+    type: 'error' | 'unhandledrejection' | 'resource' | 'runtime';
+    /** 发生时间 */
+    timestamp: number;
+    /** 页面 URL */
+    url: string;
+    /** 用户代理 */
+    userAgent: string;
+    /** 额外上下文 */
+    context?: Record<string, unknown>;
+    /** 追踪 ID */
+    traceId?: string;
+}
+
+/**
+ * 错误报告器
+ */
+export declare class ErrorReporter {
+    private config;
+    private traceId;
+    private boundHandlers;
+    constructor(config?: ErrorReporterConfig);
+    /**
+     * 开始监听全局错误
+     */
+    start(): void;
+    /**
+     * 停止监听
+     */
+    stop(): void;
+    /**
+     * 手动报告错误
+     */
+    report(error: Error, context?: Record<string, unknown>): void;
+    /**
+     * 设置追踪 ID
+     */
+    setTraceId(traceId: string): void;
+    private handleError;
+    private handleUnhandledRejection;
+    private shouldIgnore;
+    private truncateStack;
+    private defaultReporter;
+}
+
+/**
+ * 错误报告
+ */
+/**
+ * 错误报告配置
+ */
+export declare interface ErrorReporterConfig {
+    /** 上报端点 */
+    endpoint?: string;
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 采样率 */
+    sampleRate?: number;
+    /** 忽略的错误模式 */
+    ignorePatterns?: RegExp[];
+    /** 自定义上报函数 */
+    reporter?: (error: ErrorReport) => void | Promise<void>;
+    /** 最大堆栈深度 */
+    maxStackDepth?: number;
+}
+
+/**
+ * 表达式求值器
+ * 安全地执行 AST，无 eval
+ */
+
+/**
+ * 求值结果
+ */
+declare interface EvaluationResult {
+    value: unknown;
+    error?: Error;
+}
+
+/**
+ * 求值器配置
+ */
+declare interface EvaluatorOptions {
+    /** 最大递归深度 */
+    maxDepth?: number;
+    /** 最大执行时间（毫秒） */
+    timeout?: number;
+    /** 调试模式 */
+    debug?: boolean;
+}
+
+/**
+ * 事件总线实现
+ */
+declare class EventBus {
+    private handlers;
+    private options;
+    constructor(options?: EventBusOptions);
+    /**
+     * 发送事件
+     */
+    emit<T>(event: RuntimeEvent<T>): void;
+    /**
+     * 订阅事件
+     */
+    on<T>(type: RuntimeEventType, handler: EventHandlerFn<T>): Unsubscribe;
+    /**
+     * 取消订阅
+     */
+    off<T>(type: RuntimeEventType, handler: EventHandlerFn<T>): void;
+    /**
+     * 一次性订阅
+     */
+    once<T>(type: RuntimeEventType, handler: EventHandlerFn<T>): Unsubscribe;
+    /**
+     * 清除所有监听器
+     */
+    clear(type?: RuntimeEventType): void;
+    /**
+     * 获取监听器数量
+     */
+    listenerCount(type: RuntimeEventType): number;
+    /**
+     * 创建事件
+     */
+    static createEvent<T>(type: RuntimeEventType, data: T, traceId?: string): RuntimeEvent<T>;
+    private log;
+}
+
+/**
+ * 事件总线
+ * 运行时事件系统
+ */
+
+/**
+ * 事件总线配置
+ */
+declare interface EventBusOptions {
+    /** 是否开启调试 */
+    debug?: boolean;
+    /** 日志器 */
+    logger?: Logger;
+    /** 最大监听器数量 */
+    maxListeners?: number;
+}
+
+/**
+ * 事件处理器函数
+ */
+declare type EventHandlerFn<T = unknown> = (event: RuntimeEvent<T>) => void;
+
+/**
+ * 表达式引擎
+ * 安全的表达式解析和求值，无 eval/new Function
+ */
+declare class ExpressionEngine {
+    private options;
+    private evaluator;
+    private astCache;
+    constructor(options?: ExpressionEngineOptions);
+    /**
+     * 求值表达式
+     */
+    evaluate(expression: string, context: ExpressionContext): EvaluationResult;
+    /**
+     * 求值表达式并返回值
+     * 出错时返回 fallback 值
+     *
+     * @param expression - 表达式字符串或 Expression 对象
+     * @param context - 表达式上下文
+     * @param fallback - 求值失败时的默认值
+     */
+    evaluateWithFallback<T>(expression: string | Expression, context: ExpressionContext, fallback?: T): T;
+    /**
+     * 求值模板字符串
+     * 支持 ${expression} 语法
+     */
+    evaluateTemplate(template: string, context: ExpressionContext): string;
+    /**
+     * 解析表达式为 AST
+     */
+    parse(expression: string): ASTNode;
+    /**
+     * 校验表达式
+     */
+    validate(expression: string): ExpressionValidationResult;
+    /**
+     * 清除 AST 缓存
+     */
+    clearCache(): void;
+    private collectReferences;
+    private buildMemberPath;
+    private log;
+}
+
+/**
+ * 表达式引擎
+ * 统一的表达式解析和求值入口
+ */
+
+/**
+ * 表达式引擎配置
+ */
+declare interface ExpressionEngineOptions extends EvaluatorOptions {
+    /** 是否缓存 AST */
+    cacheAST?: boolean;
+    /** 最大缓存大小 */
+    maxCacheSize?: number;
+    /** 日志器 */
+    logger?: Logger;
+}
+
+/**
+ * 生成 Span ID
+ */
+export declare function generateSpanId(): string;
+
+/**
+ * 生成追踪 ID
+ */
+export declare function generateTraceId(): string;
+
+/**
+ * 生成 traceparent 头
+ */
+export declare function generateTraceparent(): string;
+
+/**
+ * 获取设备 ID
+ */
+export declare function getDeviceId(): string;
+
+/**
+ * 获取页面性能指标
+ */
+export declare function getPagePerformance(): Record<string, number>;
+
+/**
+ * 获取资源加载性能
+ */
+export declare function getResourcePerformance(filter?: (entry: PerformanceResourceTiming) => boolean): Array<{
+    name: string;
+    type: string;
+    duration: number;
+    size: number;
+}>;
+
+/**
+ * 获取运行时资源性能
+ */
+export declare function getRuntimeResourcePerformance(): Array<{
+    name: string;
+    type: string;
+    duration: number;
+    size: number;
+}>;
+
+/**
+ * Host API 实现
+ * 完全实现 @djvlc/contracts-types 中定义的 HostApi 接口
+ */
+declare class HostAPIImpl implements HostApi {
+    private options;
+    private storageNamespace;
+    private loadingCount;
+    private loadingElement;
+    constructor(options: HostAPIOptions);
+    navigate(options: NavigateOptions): Promise<void>;
+    track(event: TrackEvent_3): void;
+    requestData<T = unknown>(queryId: string, params?: Record<string, unknown>): Promise<T>;
+    executeAction<T = unknown>(actionType: string, params?: Record<string, unknown>): Promise<ActionResult<T>>;
+    openDialog(options: DialogOptions): Promise<DialogResult>;
+    closeDialog(dialogId?: string): void;
+    showToast(options: ToastOptions): void;
+    showLoading(message?: string): void;
+    hideLoading(): void;
+    clipboard: ClipboardApi;
+    storage: StorageApi;
+    share(options: ShareOptions): Promise<ShareResult>;
+    confirm(options: ConfirmOptions): Promise<boolean>;
+    showActionSheet(options: ActionSheetOptions): Promise<ActionSheetResult>;
+    previewImage(options: PreviewImageOptions): void;
+    scanCode(): Promise<ScanCodeResult>;
+    getState<T = unknown>(path: string): T | undefined;
+    setState(path: string, value: unknown): void;
+    getContext(): ComponentContext;
+    private buildHeaders;
+    private generateIdempotencyKey;
+    private simpleHash;
+    private fallbackCopy;
+    private log;
+}
+
+/**
+ * Host API 配置
+ */
+declare interface HostAPIOptions {
+    /** API 基础 URL */
+    apiBaseUrl: string;
+    /** 认证 Token */
+    authToken?: string;
+    /** 请求头 */
+    headers?: Record<string, string>;
+    /** 状态管理器 */
+    stateManager: StateManager;
+    /** 事件总线 */
+    eventBus: EventBus;
+    /** 表达式引擎 */
+    expressionEngine: ExpressionEngine;
+    /** 运行时上下文 */
+    context: RuntimeContext;
+    /** 调试模式 */
+    debug?: boolean;
+    /** 日志器 */
+    logger?: Logger;
+}
+
+declare interface IdentifierASTNode extends BaseASTNode {
+    type: 'identifier';
+    name: string;
+}
+
+/**
+ * 检测是否为移动端
+ */
+export declare function isMobile(): boolean;
+
+/**
+ * 检测是否为微信环境
+ */
+export declare function isWeChat(): boolean;
+
+/**
+ * 懒加载挂载
+ */
+export declare function lazyMount(container: string | HTMLElement, options: LazyMountOptions): {
+    cancel: () => void;
+    promise: Promise<MountResult>;
+};
+
+/**
+ * 懒加载选项
+ */
+export declare interface LazyMountOptions extends MountOptions {
+    /** 根边距 */
+    rootMargin?: string;
+    /** 可见阈值 */
+    threshold?: number;
+    /** 占位元素 */
+    placeholder?: HTMLElement | string;
+}
+
+/**
+ * AST 节点类型
+ */
+declare interface LiteralASTNode extends BaseASTNode {
+    type: 'literal';
+    value: string | number | boolean | null;
+}
+
+/**
+ * 已加载的组件模块
+ */
+export declare interface LoadedComponent {
+    /** 组件名称 */
+    name: string;
+    /** 组件版本 */
+    version: string;
+    /** 组件类/构造函数 */
+    Component: CustomElementConstructor | unknown;
+    /** 加载耗时 */
+    loadTime: number;
+    /** 元数据 */
+    meta?: _djvlc_contracts_types.ComponentMeta;
+}
+
+/**
+ * 日志器接口
+ */
+export declare interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+
+declare interface MemberASTNode extends BaseASTNode {
+    type: 'member';
+    object: ASTNode;
+    property: string | ASTNode;
+    computed: boolean;
+}
+
+/**
+ * 性能指标类型
+ */
+declare type MetricType = 'pageResolveTime' | 'pageLoadTime' | 'componentLoadTime' | 'firstRenderTime' | 'actionExecuteTime' | 'queryFetchTime' | 'expressionEvalTime';
+
+/**
+ * 挂载运行时到指定容器
+ */
+export declare function mount(container: string | HTMLElement, options: MountOptions): Promise<MountResult>;
+
+/**
+ * 挂载选项
+ */
+export declare interface MountOptions {
+    /** 页面 UID */
+    pageUid: string;
+    /** API 基础 URL */
+    apiBaseUrl: string;
+    /** CDN 基础 URL */
+    cdnBaseUrl: string;
+    /** 渠道 */
+    channel?: 'preview' | 'prod' | 'gray';
+    /** 用户 ID */
+    userId?: string;
+    /** 设备 ID */
+    deviceId?: string;
+    /** 认证 Token */
+    authToken?: string;
+    /** 预览 Token */
+    previewToken?: string;
+    /** 调试模式 */
+    debug?: boolean;
+    /** 是否启用 SRI 校验 */
+    enableSRI?: boolean;
+    /** 自定义请求头 */
+    headers?: Record<string, string>;
+    /** 加载完成回调 */
+    onLoad?: (data: unknown) => void;
+    /** 错误回调 */
+    onError?: (error: Error) => void;
+    /** 性能指标回调 */
+    onMetric?: (metric: PerformanceMetrics) => void;
+    /** 阶段变化回调 */
+    onPhaseChange?: (phase: string) => void;
+    /** 重试次数 */
+    retryCount?: number;
+    /** 重试延迟 */
+    retryDelay?: number;
+    /** 超时时间 */
+    timeout?: number;
+    /** 是否采集 Web Vitals */
+    collectWebVitals?: boolean;
+}
+
+/**
+ * 挂载结果
+ */
+export declare interface MountResult {
+    /** 运行时实例 */
+    runtime: ReturnType<typeof createRuntime>;
+    /** 销毁函数 */
+    destroy: () => void;
+    /** 性能指标 */
+    metrics: PerformanceMetrics;
+    /** 刷新页面 */
+    refresh: () => Promise<void>;
+    /** 设置变量 */
+    setVariable: (key: string, value: unknown) => void;
+    /** 刷新数据 */
+    refreshData: (queryId: string) => Promise<void>;
+}
+
+/**
+ * 网络状态监听
+ */
+export declare function onNetworkChange(callback: (online: boolean) => void): () => void;
+
+/**
+ * 可见性监听
+ */
+export declare function onVisibilityChange(callback: (visible: boolean) => void): () => void;
+
+/**
+ * 页面解析结果（Runtime 使用）
+ */
+declare interface PageResolveResult {
+    /** 页面 UID */
+    pageUid: string;
+    /** 页面版本 ID */
+    pageVersionId: string;
+    /** 页面 JSON（PageSchema） */
+    pageJson: _djvlc_contracts_types.PageSchema;
+    /** 组件清单 */
+    manifest: _djvlc_contracts_types.PageManifest;
+    /** 运行时配置 */
+    runtimeConfig?: {
+        /** 被阻断的组件列表 */
+        blockedComponents?: Array<{
+            name: string;
+            version: string;
+            reason: string;
+        }>;
+        /** Kill Switch 状态 */
+        killSwitches?: Array<{
+            type: string;
+            enabled: boolean;
+        }>;
+        /** 功能开关 */
+        features?: Record<string, boolean>;
+    };
+    /** 是否为预览模式 */
+    isPreview?: boolean;
+    /** 预加载的数据 */
+    preloadedData?: Record<string, unknown>;
+}
+
+/**
+ * 性能指标
+ */
+declare interface PerformanceMetric {
+    /** 指标类型 */
+    type: MetricType;
+    /** 指标值（毫秒） */
+    value: number;
+    /** 页面版本 ID */
+    pageVersionId?: string;
+    /** 组件名称 */
+    componentName?: string;
+    /** 组件版本 */
+    componentVersion?: string;
+    /** 动作类型 */
+    actionType?: string;
+    /** 查询 ID */
+    queryId?: string;
+    /** 时间戳 */
+    timestamp: number;
+}
+
+/**
+ * 性能监控工具
+ */
+/**
+ * 性能指标
+ */
+export declare interface PerformanceMetrics {
+    /** 初始化耗时 */
+    initTime: number;
+    /** 加载耗时 */
+    loadTime: number;
+    /** 渲染耗时 */
+    renderTime: number;
+    /** 总耗时 */
+    totalTime: number;
+    /** 首次内容绘制时间 */
+    fcp?: number;
+    /** 最大内容绘制时间 */
+    lcp?: number;
+    /** 首次输入延迟 */
+    fid?: number;
+    /** 累计布局偏移 */
+    cls?: number;
+    /** 组件加载次数 */
+    componentLoadCount: number;
+    /** 组件加载失败次数 */
+    componentLoadErrors: number;
+    /** 数据请求次数 */
+    dataRequestCount: number;
+    /** 数据请求失败次数 */
+    dataRequestErrors: number;
+}
+
+/**
+ * 性能监控器
+ */
+export declare class PerformanceMonitor {
+    private marks;
+    private measures;
+    private enabled;
+    constructor(enabled?: boolean);
+    /**
+     * 标记开始时间
+     */
+    mark(name: string): void;
+    /**
+     * 测量耗时
+     */
+    measure(name: string, startMark: string, endMark?: string): number;
+    /**
+     * 获取所有测量结果
+     */
+    getMeasures(): Record<string, number>;
+    /**
+     * 清空
+     */
+    clear(): void;
+}
+
+/**
+ * 工具函数
+ */
+/**
+ * 预连接 CDN/API 域名
+ */
+export declare function preconnect(hosts: string[]): void;
+
+/**
+ * 预加载 runtime 资源
+ */
+export declare function preloadAssets(cdnBaseUrl: string, version?: string): void;
+
+/**
+ * 版本信息
+ */
+export declare const RUNTIME_VERSION: string;
+
+/**
+ * Host API 实现
+ * 提供给组件的安全 API，完全对齐 @djvlc/contracts-types 中的 HostApi 定义
+ *
+ * 组件只能通过 HostAPI 与外界交互，禁止：
+ * - 直接调用 window.fetch（绕过 Data Proxy）
+ * - 直接操作 location.href（绕过权限/埋点）
+ * - 随意访问 localStorage（乱写）
+ * - 随意上报（污染数据）
+ */
+
+/**
+ * 运行时上下文
+ */
+declare interface RuntimeContext {
+    pageUid: string;
+    pageVersionId: string;
+    runtimeVersion: string;
+    userId?: string;
+    deviceId?: string;
+    channel?: string;
+    appId: string;
+    env: 'development' | 'staging' | 'production';
+    isEditMode: boolean;
+    isPreviewMode: boolean;
+}
+
+/**
+ * 运行时错误
+ */
+declare interface RuntimeError {
+    /** 错误类型 */
+    type: RuntimeErrorType;
+    /** 错误消息 */
+    message: string;
+    /** 错误码 */
+    code?: string;
+    /** 详细信息 */
+    details?: Record<string, unknown>;
+    /** 原始错误 */
+    cause?: Error;
+    /** 追踪 ID */
+    traceId?: string;
+    /** 时间戳 */
+    timestamp: number;
+}
+
+/**
+ * 运行时错误类型
+ */
+declare type RuntimeErrorType = 'LOAD_ERROR' | 'RENDER_ERROR' | 'ACTION_ERROR' | 'QUERY_ERROR' | 'EXPRESSION_ERROR' | 'COMPONENT_ERROR' | 'SECURITY_ERROR' | 'NETWORK_ERROR' | 'UNKNOWN_ERROR';
+
+/**
+ * 运行时事件
+ */
+declare interface RuntimeEvent<T = unknown> {
+    /** 事件类型 */
+    type: RuntimeEventType;
+    /** 事件数据 */
+    data: T;
+    /** 追踪 ID */
+    traceId?: string;
+    /** 时间戳 */
+    timestamp: number;
+}
+
+/**
+ * 运行时事件类型
+ */
+declare type RuntimeEventType = 'page:resolving' | 'page:resolved' | 'page:loading' | 'page:loaded' | 'page:rendered' | 'page:error' | 'page:destroyed' | 'component:loading' | 'component:loaded' | 'component:error' | 'action:executing' | 'action:executed' | 'action:error' | 'query:fetching' | 'query:fetched' | 'query:error' | 'state:changed';
+
+/**
+ * 运行时初始化选项
+ */
+export declare interface RuntimeOptions {
+    /** 容器元素或选择器 */
+    container: string | HTMLElement;
+    /** 页面 UID（pageId） */
+    pageUid: string;
+    /** API 基础 URL */
+    apiBaseUrl: string;
+    /** CDN 基础 URL */
+    cdnBaseUrl: string;
+    /** 渠道 */
+    channel?: 'preview' | 'prod' | 'gray';
+    /** 用户 ID */
+    userId?: string;
+    /** 设备 ID */
+    deviceId?: string;
+    /** 认证 Token */
+    authToken?: string;
+    /** 预览 Token */
+    previewToken?: string;
+    /** 调试模式 */
+    debug?: boolean;
+    /** 是否启用 SRI 校验 */
+    enableSRI?: boolean;
+    /** 自定义请求头 */
+    headers?: Record<string, string>;
+    /** 应用 ID */
+    appId?: string;
+    /** 环境 */
+    env?: 'development' | 'staging' | 'production';
+    /** 错误回调 */
+    onError?: (error: RuntimeError) => void;
+    /** 事件回调 */
+    onEvent?: (event: RuntimeEvent) => void;
+    /** 性能指标回调 */
+    onMetric?: (metric: PerformanceMetric) => void;
+    /** 加载完成回调 */
+    onLoad?: (data: PageResolveResult) => void;
+}
+
+/**
+ * 运行时阶段
+ */
+declare type RuntimePhase = 'idle' | 'resolving' | 'loading' | 'rendering' | 'ready' | 'error' | 'destroyed';
+
+/**
+ * 运行时状态
+ */
+export declare interface RuntimeState {
+    /** 当前阶段 */
+    phase: RuntimePhase;
+    /** 页面解析结果 */
+    page: PageResolveResult | null;
+    /** 页面状态变量（可变） */
+    variables: Record<string, unknown>;
+    /** 数据查询结果缓存 */
+    queries: Record<string, unknown>;
+    /** 组件加载状态 */
+    components: Map<string, ComponentLoadResult>;
+    /** 错误信息 */
+    error: RuntimeError | null;
+    /** 是否已销毁 */
+    destroyed: boolean;
+}
+
+/**
+ * 状态变更回调
+ */
+declare type StateChangeCallback = (detail: StateChangeDetail) => void;
+
+/**
+ * 状态变更详情
+ */
+declare interface StateChangeDetail {
+    /** 变更的键 */
+    key: string;
+    /** 旧值 */
+    oldValue: unknown;
+    /** 新值 */
+    newValue: unknown;
+}
+
+/**
+ * 状态管理器
+ * 管理页面运行时状态，兼容 PageSchema V2
+ */
+
+/**
+ * 状态变更监听器
+ */
+declare type StateListener = (state: RuntimeState) => void;
+
+/**
+ * 状态管理器
+ */
+declare class StateManager {
+    private state;
+    private listeners;
+    private changeCallbacks;
+    constructor();
+    /**
+     * 获取当前状态
+     */
+    getState(): RuntimeState;
+    /**
+     * 获取当前阶段
+     */
+    getPhase(): RuntimePhase;
+    /**
+     * 设置阶段
+     */
+    setPhase(phase: RuntimePhase): void;
+    /**
+     * 设置页面数据（兼容 V2 PageSchema）
+     */
+    setPage(page: PageResolveResult): void;
+    /**
+     * 初始化页面状态（从 PageSchema V2 的 state 定义）
+     */
+    private initializePageState;
+    /**
+     * 设置错误
+     */
+    setError(error: RuntimeError): void;
+    /**
+     * 清除错误
+     */
+    clearError(): void;
+    /**
+     * 获取变量值
+     */
+    getVariable<T = unknown>(key: string): T | undefined;
+    /**
+     * 设置变量值
+     */
+    setVariable(key: string, value: unknown): void;
+    /**
+     * 批量设置变量
+     */
+    setVariables(variables: Record<string, unknown>): void;
+    /**
+     * 获取查询结果
+     */
+    getQuery<T = unknown>(queryId: string): T | undefined;
+    /**
+     * 设置查询结果
+     */
+    setQuery(queryId: string, data: unknown): void;
+    /**
+     * 清除查询结果
+     */
+    clearQuery(queryId: string): void;
+    /**
+     * 更新组件加载状态
+     */
+    setComponentStatus(key: string, result: ComponentLoadResult): void;
+    /**
+     * 获取组件加载状态
+     */
+    getComponentStatus(key: string): ComponentLoadResult | undefined;
+    /**
+     * 标记为已销毁
+     */
+    setDestroyed(): void;
+    /**
+     * 检查是否已销毁
+     */
+    isDestroyed(): boolean;
+    /**
+     * 订阅状态变更
+     */
+    subscribe(listener: StateListener): () => void;
+    /**
+     * 订阅特定状态键的变更
+     */
+    onStateChange(callback: StateChangeCallback): () => void;
+    /**
+     * 重置状态
+     */
+    reset(): void;
+    /**
+     * 获取表达式上下文
+     * 对齐 contracts 中的 ExpressionContext 定义：
+     * - state: 页面状态变量
+     * - binding: 数据绑定结果（即查询结果）
+     * - local: 局部变量（循环变量、事件参数等，由渲染器管理）
+     * - context: 运行时上下文（额外信息）
+     */
+    getExpressionContext(): {
+        state: Record<string, unknown>;
+        binding: Record<string, unknown>;
+        local: Record<string, unknown>;
+        context: Record<string, unknown>;
+    };
+    private setState;
+    private notifyListeners;
+    private notifyChange;
+    private getNestedValue;
+    private setNestedValue;
+    private createInitialState;
+}
+
+/**
+ * 存储辅助工具
+ */
+/**
+ * 存储辅助类（带命名空间和 TTL）
+ */
+export declare class StorageHelper {
+    private namespace;
+    private storage;
+    constructor(namespace?: string, useSession?: boolean);
+    private getKey;
+    /**
+     * 获取值
+     */
+    get<T>(key: string): T | null;
+    /**
+     * 设置值
+     */
+    set<T>(key: string, value: T, ttl?: number): void;
+    /**
+     * 删除值
+     */
+    remove(key: string): void;
+    /**
+     * 清空命名空间下所有值
+     */
+    clear(): void;
+}
+
+/**
+ * 检测是否支持 WebP
+ */
+export declare function supportsWebP(): Promise<boolean>;
+
+/**
+ * 埋点与追踪
+ */
+/**
+ * 埋点事件
+ */
+declare interface TrackEvent_2 {
+    /** 事件名称 */
+    event: string;
+    /** 事件数据 */
+    data?: Record<string, unknown>;
+    /** 页面 UID */
+    pageUid?: string;
+    /** 页面版本 ID */
+    pageVersionId?: string;
+    /** 组件 ID */
+    componentId?: string;
+    /** 时间戳 */
+    timestamp: number;
+    /** 追踪 ID */
+    traceId?: string;
+}
+export { TrackEvent_2 as TrackEvent }
+
+/**
+ * 埋点配置
+ */
+export declare interface TrackingConfig {
+    /** 上报端点 */
+    endpoint?: string;
+    /** 批量上报阈值 */
+    batchSize?: number;
+    /** 上报间隔 */
+    flushInterval?: number;
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 采样率 */
+    sampleRate?: number;
+    /** 自定义上报函数 */
+    reporter?: (events: TrackEvent_2[]) => void | Promise<void>;
+}
+
+/**
+ * 埋点管理器
+ */
+export declare class TrackingManager {
+    private events;
+    private config;
+    private flushTimer;
+    private traceId;
+    constructor(config?: TrackingConfig);
+    /**
+     * 追踪事件
+     */
+    track(event: string, data?: Record<string, unknown>, context?: Partial<TrackEvent_2>): void;
+    /**
+     * 追踪页面访问
+     */
+    trackPageView(pageUid: string, pageVersionId?: string): void;
+    /**
+     * 追踪组件曝光
+     */
+    trackComponentView(componentId: string, componentType: string, pageUid?: string): void;
+    /**
+     * 追踪组件点击
+     */
+    trackComponentClick(componentId: string, componentType: string, pageUid?: string): void;
+    /**
+     * 追踪动作执行
+     */
+    trackAction(actionType: string, success: boolean, duration: number, pageUid?: string): void;
+    /**
+     * 追踪错误
+     */
+    trackError(error: Error, context?: Record<string, unknown>): void;
+    /**
+     * 立即上报
+     */
+    flush(): Promise<void>;
+    /**
+     * 销毁
+     */
+    destroy(): void;
+    private defaultReporter;
+}
+
+declare interface UnaryASTNode extends BaseASTNode {
+    type: 'unary';
+    operator: string;
+    argument: ASTNode;
+}
+
+/**
+ * 事件订阅取消函数
+ */
+declare type Unsubscribe = () => void;
+
+export declare const urlUtils: {
+    /**
+     * 获取 URL 参数
+     */
+    getParam(name: string, url?: string): string | null;
+    /**
+     * 设置 URL 参数
+     */
+    setParam(name: string, value: string): void;
+    /**
+     * 删除 URL 参数
+     */
+    removeParam(name: string): void;
+    /**
+     * 构建 URL
+     */
+    build(base: string, params: Record<string, string | number | boolean | undefined>): string;
+};
+
+/**
+ * 预热挂载
+ */
+export declare function warmup(options: MountOptions): Promise<{
+    mount: (container: string | HTMLElement) => Promise<MountResult>;
+}>;
+
+export { }