@djvlc/runtime-core 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,1228 @@
+import { RuntimeError, RuntimeEvent, PerformanceMetric, PageResolveResult, ComponentLoadResult, PageSchema, HostAPI, ErrorCode, ManifestItem, PageManifest, EventBus as EventBus$1, RuntimeEventType, ComponentEvent, ExpressionNode, ExpressionContext, ExpressionValidationResult, RuntimeContext, DataQueryResponse, ActionExecuteResponse, NavigateOptions, DialogOptions, ToastOptions, TrackEvent, ClipboardResult, StorageOptions, BlockedComponent } from '@djvlc/contracts-types';
+export { ActionExecuteResponse, ComponentInstance, ComponentLoadResult, ComponentLoadStatus, DataQueryResponse, ExpressionContext, HostAPI, ManifestItem, PageManifest, PageResolveResult, PageSchema, PerformanceMetric, RuntimeConfig, RuntimeError, RuntimeEvent, RuntimeEventType } from '@djvlc/contracts-types';
+
+/**
+ * Runtime 类型定义
+ * 基于 @djvlc/contracts-types 扩展的运行时特有类型
+ */
+
+/**
+ * 运行时初始化选项
+ */
+interface RuntimeOptions {
+    /** 容器元素或选择器 */
+    container: string | HTMLElement;
+    /** 页面 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>;
+    /** 错误回调 */
+    onError?: (error: RuntimeError) => void;
+    /** 事件回调 */
+    onEvent?: (event: RuntimeEvent) => void;
+    /** 性能指标回调 */
+    onMetric?: (metric: PerformanceMetric) => void;
+}
+/**
+ * 运行时阶段
+ */
+type RuntimePhase = 'idle' | 'resolving' | 'loading' | 'rendering' | 'ready' | 'error';
+/**
+ * 运行时状态
+ */
+interface RuntimeState {
+    /** 当前阶段 */
+    phase: RuntimePhase;
+    /** 页面数据 */
+    page: PageResolveResult | null;
+    /** 页面状态（可变） */
+    variables: Record<string, unknown>;
+    /** 查询结果缓存 */
+    queries: Record<string, unknown>;
+    /** 组件加载状态 */
+    components: Map<string, ComponentLoadResult>;
+    /** 错误信息 */
+    error: RuntimeError | null;
+    /** 是否已销毁 */
+    destroyed: boolean;
+}
+/**
+ * 已加载的组件模块
+ */
+interface LoadedComponent {
+    /** 组件名称 */
+    name: string;
+    /** 组件版本 */
+    version: string;
+    /** 组件类/构造函数 */
+    Component: CustomElementConstructor | unknown;
+    /** 加载耗时 */
+    loadTime: number;
+    /** 元数据 */
+    meta?: Record<string, unknown>;
+}
+/**
+ * 渲染器接口（框架无关）
+ */
+interface Renderer {
+    /** 初始化 */
+    init(): void;
+    /** 渲染页面 */
+    render(schema: PageSchema, container: HTMLElement): void;
+    /** 更新组件 */
+    updateComponent(componentId: string, props: Record<string, unknown>): void;
+    /** 销毁 */
+    destroy(): void;
+}
+/**
+ * 事件处理器
+ */
+type EventHandler<T = unknown> = (event: RuntimeEvent<T>) => void;
+/**
+ * 事件订阅取消函数
+ */
+type Unsubscribe = () => void;
+/**
+ * 日志级别
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * 日志器接口
+ */
+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 function createRuntime(options: RuntimeOptions): DjvlcRuntime;
+/**
+ * DJVLC 运行时
+ */
+declare class DjvlcRuntime {
+    private options;
+    private container;
+    private pageLoader;
+    private componentLoader;
+    private assetLoader;
+    private stateManager;
+    private eventBus;
+    private expressionEngine;
+    private securityManager;
+    private telemetryManager;
+    private renderer;
+    private hostApi;
+    private logger;
+    constructor(options: RuntimeOptions);
+    /**
+     * 初始化运行时
+     */
+    init(): Promise<void>;
+    /**
+     * 加载页面
+     */
+    load(): Promise<PageResolveResult>;
+    /**
+     * 渲染页面
+     */
+    render(): Promise<void>;
+    /**
+     * 获取 Host API
+     */
+    getHostApi(): HostAPI;
+    /**
+     * 获取当前状态
+     */
+    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;
+    /**
+     * 刷新数据
+     */
+    refreshData(queryId: string): Promise<void>;
+    /**
+     * 销毁运行时
+     */
+    destroy(): void;
+    private resolveContainer;
+    private initHostApi;
+    private initRenderer;
+    private handleError;
+    private emitEvent;
+    private createLogger;
+    private log;
+}
+
+/**
+ * 运行时错误类型定义
+ */
+
+/**
+ * 运行时错误基类
+ */
+declare class DjvlcRuntimeError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: Record<string, unknown>;
+    readonly traceId?: string;
+    readonly timestamp: number;
+    constructor(code: ErrorCode, message?: string, details?: Record<string, unknown>, traceId?: string);
+    toJSON(): {
+        name: string;
+        code: ErrorCode;
+        message: string;
+        details: Record<string, unknown> | undefined;
+        traceId: string | undefined;
+        timestamp: number;
+    };
+}
+/**
+ * 页面加载错误
+ */
+declare class PageLoadError extends DjvlcRuntimeError {
+    constructor(message: string, details?: Record<string, unknown>, traceId?: string);
+}
+/**
+ * 组件加载错误
+ */
+declare class ComponentLoadError extends DjvlcRuntimeError {
+    readonly componentName: string;
+    readonly componentVersion: string;
+    constructor(componentName: string, componentVersion: string, message: string, code?: ErrorCode, details?: Record<string, unknown>);
+}
+/**
+ * 组件完整性校验错误
+ */
+declare class IntegrityError extends DjvlcRuntimeError {
+    readonly componentName: string;
+    readonly componentVersion: string;
+    readonly expectedHash: string;
+    readonly actualHash: string;
+    constructor(componentName: string, componentVersion: string, expectedHash: string, actualHash: string);
+}
+/**
+ * 组件阻断错误
+ */
+declare class ComponentBlockedError extends DjvlcRuntimeError {
+    readonly componentName: string;
+    readonly componentVersion: string;
+    readonly reason: string;
+    constructor(componentName: string, componentVersion: string, reason: string);
+}
+/**
+ * 表达式求值错误
+ */
+declare class ExpressionError extends DjvlcRuntimeError {
+    readonly expression: string;
+    readonly position?: {
+        start: number;
+        end: number;
+    };
+    constructor(expression: string, message: string, position?: {
+        start: number;
+        end: number;
+    }, details?: Record<string, unknown>);
+}
+/**
+ * 动作执行错误
+ */
+declare class ActionError extends DjvlcRuntimeError {
+    readonly actionType: string;
+    readonly actionId?: string;
+    constructor(actionType: string, message: string, code?: ErrorCode, actionId?: string, details?: Record<string, unknown>);
+}
+/**
+ * 数据查询错误
+ */
+declare class QueryError extends DjvlcRuntimeError {
+    readonly queryId: string;
+    constructor(queryId: string, message: string, code?: ErrorCode, details?: Record<string, unknown>);
+}
+/**
+ * 渲染错误
+ */
+declare class RenderError extends DjvlcRuntimeError {
+    readonly componentId: string;
+    readonly componentType: string;
+    constructor(componentId: string, componentType: string, message: string, details?: Record<string, unknown>);
+}
+
+/**
+ * 页面加载器
+ * 负责从 API 解析页面配置
+ */
+
+/**
+ * 页面加载器配置
+ */
+interface PageLoaderOptions {
+    /** API 基础 URL */
+    apiBaseUrl: string;
+    /** 渠道 */
+    channel?: 'preview' | 'prod' | 'gray';
+    /** 认证 Token */
+    authToken?: string;
+    /** 预览 Token */
+    previewToken?: string;
+    /** 请求头 */
+    headers?: Record<string, string>;
+    /** 缓存配置 */
+    cache?: {
+        enabled: boolean;
+        maxAge?: number;
+    };
+    /** 日志器 */
+    logger?: Logger;
+}
+/**
+ * 页面加载器
+ * 负责调用 /page/resolve 接口获取页面数据
+ */
+declare class PageLoader {
+    private options;
+    private cache;
+    constructor(options: PageLoaderOptions);
+    /**
+     * 解析页面
+     * @param pageUid 页面 UID
+     * @param params 额外参数
+     */
+    resolve(pageUid: string, params?: {
+        uid?: string;
+        deviceId?: string;
+    }): Promise<PageResolveResult>;
+    /**
+     * 预连接 API 服务器
+     */
+    preconnect(): void;
+    /**
+     * 清除缓存
+     */
+    clearCache(pageUid?: string): void;
+    private buildResolveUrl;
+    private buildHeaders;
+    private getCacheKey;
+    private isCacheValid;
+    private isValidPageResolveResult;
+    private log;
+}
+
+/**
+ * 组件加载器
+ * 负责从 CDN 加载组件资源
+ */
+
+/**
+ * 组件加载器配置
+ */
+interface ComponentLoaderOptions {
+    /** CDN 基础 URL */
+    cdnBaseUrl: string;
+    /** 是否启用 SRI 校验 */
+    enableSRI?: boolean;
+    /** 被阻断的组件列表 */
+    blockedComponents?: string[];
+    /** 并行加载数量 */
+    concurrency?: number;
+    /** 超时时间（毫秒） */
+    timeout?: number;
+    /** 日志器 */
+    logger?: Logger;
+}
+/**
+ * 组件加载器
+ * 负责加载 Web Components
+ */
+declare class ComponentLoader {
+    private options;
+    private loadedComponents;
+    private loadingPromises;
+    private blockedSet;
+    constructor(options: ComponentLoaderOptions);
+    /**
+     * 加载单个组件
+     */
+    load(item: ManifestItem): Promise<LoadedComponent>;
+    /**
+     * 加载 Manifest 中的所有组件
+     */
+    loadAll(manifest: PageManifest): Promise<Map<string, ComponentLoadResult>>;
+    /**
+     * 预加载组件
+     */
+    preload(items: ManifestItem[]): void;
+    /**
+     * 检查组件是否已加载
+     */
+    isLoaded(name: string, version: string): boolean;
+    /**
+     * 获取已加载的组件
+     */
+    get(name: string, version: string): LoadedComponent | undefined;
+    /**
+     * 检查组件是否被阻断
+     */
+    isBlocked(name: string, version: string): boolean;
+    /**
+     * 更新阻断列表
+     */
+    updateBlockedList(blocked: string[]): void;
+    private loadComponent;
+    private fetchWithTimeout;
+    private validateIntegrity;
+    private executeScript;
+    private resolveUrl;
+    private getComponentKey;
+    private log;
+}
+
+/**
+ * 资源加载器
+ * 负责预连接、预加载等资源优化
+ */
+/**
+ * 资源加载器配置
+ */
+interface AssetLoaderOptions {
+    /** CDN 域名列表 */
+    cdnHosts: string[];
+    /** API 域名列表 */
+    apiHosts: string[];
+}
+/**
+ * 资源加载器
+ * 负责资源预连接、预加载等优化
+ */
+declare class AssetLoader {
+    private options;
+    private preconnectedHosts;
+    private preloadedAssets;
+    constructor(options: AssetLoaderOptions);
+    /**
+     * 预连接所有域名
+     */
+    preconnectAll(): void;
+    /**
+     * 预连接单个域名
+     */
+    preconnect(host: string): void;
+    /**
+     * DNS 预解析
+     */
+    dnsPrefetch(host: string): void;
+    /**
+     * 预加载脚本
+     */
+    preloadScript(url: string, integrity?: string): void;
+    /**
+     * 预加载样式
+     */
+    preloadStyle(url: string, integrity?: string): void;
+    /**
+     * 预加载图片
+     */
+    preloadImage(url: string): void;
+    /**
+     * 预获取资源（低优先级）
+     */
+    prefetch(url: string, as?: 'script' | 'style' | 'image' | 'document'): void;
+    /**
+     * 加载样式表
+     */
+    loadStylesheet(url: string, integrity?: string): Promise<void>;
+    /**
+     * 加载脚本
+     */
+    loadScript(url: string, integrity?: string): Promise<void>;
+}
+
+/**
+ * 状态管理器
+ * 管理页面运行时状态
+ */
+
+/**
+ * 状态变更监听器
+ */
+type StateListener = (state: RuntimeState) => void;
+/**
+ * 状态管理器
+ */
+declare class StateManager {
+    private state;
+    private listeners;
+    constructor();
+    /**
+     * 获取当前状态
+     */
+    getState(): RuntimeState;
+    /**
+     * 获取当前阶段
+     */
+    getPhase(): RuntimePhase;
+    /**
+     * 设置阶段
+     */
+    setPhase(phase: RuntimePhase): void;
+    /**
+     * 设置页面数据
+     */
+    setPage(page: PageResolveResult): void;
+    /**
+     * 设置错误
+     */
+    setError(error: RuntimeError): 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;
+    /**
+     * 更新组件加载状态
+     */
+    setComponentStatus(key: string, result: ComponentLoadResult): void;
+    /**
+     * 标记为已销毁
+     */
+    setDestroyed(): void;
+    /**
+     * 订阅状态变更
+     */
+    subscribe(listener: StateListener): () => void;
+    /**
+     * 重置状态
+     */
+    reset(): void;
+    private setState;
+    private notifyListeners;
+    private createInitialState;
+}
+
+/**
+ * 事件总线
+ * 运行时事件系统
+ */
+
+/**
+ * 事件总线配置
+ */
+interface EventBusOptions {
+    /** 是否开启调试 */
+    debug?: boolean;
+    /** 日志器 */
+    logger?: Logger;
+    /** 最大监听器数量 */
+    maxListeners?: number;
+}
+/**
+ * 事件总线实现
+ */
+declare class EventBus implements EventBus$1 {
+    private handlers;
+    private options;
+    constructor(options?: EventBusOptions);
+    /**
+     * 发送事件
+     */
+    emit<T>(event: RuntimeEvent<T>): void;
+    /**
+     * 订阅事件
+     */
+    on<T>(type: RuntimeEventType, handler: EventHandler<T>): Unsubscribe;
+    /**
+     * 取消订阅
+     */
+    off<T>(type: RuntimeEventType, handler: EventHandler<T>): void;
+    /**
+     * 一次性订阅
+     */
+    once<T>(type: RuntimeEventType, handler: EventHandler<T>): Unsubscribe;
+    /**
+     * 清除所有监听器
+     */
+    clear(type?: RuntimeEventType): void;
+    /**
+     * 获取监听器数量
+     */
+    listenerCount(type: RuntimeEventType): number;
+    /**
+     * 创建事件
+     */
+    static createEvent<T>(type: RuntimeEventType, data: T, traceId?: string): RuntimeEvent<T>;
+    private log;
+}
+
+/**
+ * 动作桥接器
+ * 处理组件事件到动作的映射
+ */
+
+/**
+ * 动作执行器
+ */
+interface ActionExecutor {
+    execute(actionType: string, params: Record<string, unknown>): Promise<unknown>;
+}
+/**
+ * 动作桥接器配置
+ */
+interface ActionBridgeOptions {
+    /** 动作执行器 */
+    executor: ActionExecutor;
+    /** 调试模式 */
+    debug?: boolean;
+    /** 日志器 */
+    logger?: Logger;
+}
+/**
+ * 动作桥接器
+ * 将组件事件转换为动作执行
+ */
+declare class ActionBridge {
+    private options;
+    private debounceTimers;
+    private throttleTimers;
+    constructor(options: ActionBridgeOptions);
+    /**
+     * 处理组件事件
+     */
+    handleEvent(event: ComponentEvent, eventData: Record<string, unknown>, context: Record<string, unknown>): Promise<void>;
+    /**
+     * 销毁
+     */
+    destroy(): void;
+    private executeAction;
+    private resolveParams;
+    private debounce;
+    private throttle;
+    private delay;
+    private log;
+}
+
+/**
+ * 表达式词法分析器
+ * 将表达式字符串分解为 Token
+ */
+/**
+ * Token 类型
+ */
+type TokenType = 'NUMBER' | 'STRING' | 'BOOLEAN' | 'NULL' | 'IDENTIFIER' | 'OPERATOR' | 'DOT' | 'LBRACKET' | 'RBRACKET' | 'LPAREN' | 'RPAREN' | 'COMMA' | 'QUESTION' | 'COLON' | 'EOF';
+/**
+ * Token
+ */
+interface Token {
+    type: TokenType;
+    value: string | number | boolean | null;
+    start: number;
+    end: number;
+}
+/**
+ * 词法分析器
+ */
+declare class Lexer {
+    private input;
+    private pos;
+    private tokens;
+    constructor(input: string);
+    /**
+     * 分析表达式，返回 Token 列表
+     */
+    tokenize(): Token[];
+    private readToken;
+    private readNumber;
+    private readString;
+    private readIdentifier;
+    private readOperator;
+    private skipWhitespace;
+    private isDigit;
+    private isIdentifierStart;
+    private isIdentifierChar;
+    private peek;
+}
+
+/**
+ * 表达式解析器
+ * 将 Token 列表解析为 AST
+ */
+
+/**
+ * AST 节点类型
+ */
+interface LiteralASTNode extends ExpressionNode {
+    type: 'literal';
+    value: string | number | boolean | null;
+}
+interface IdentifierASTNode extends ExpressionNode {
+    type: 'identifier';
+    name: string;
+}
+interface MemberASTNode extends ExpressionNode {
+    type: 'member';
+    object: ASTNode;
+    property: string | ASTNode;
+    computed: boolean;
+}
+interface CallASTNode extends ExpressionNode {
+    type: 'call';
+    callee: string;
+    arguments: ASTNode[];
+}
+interface BinaryASTNode extends ExpressionNode {
+    type: 'binary';
+    operator: string;
+    left: ASTNode;
+    right: ASTNode;
+}
+interface UnaryASTNode extends ExpressionNode {
+    type: 'unary';
+    operator: string;
+    argument: ASTNode;
+}
+interface ConditionalASTNode extends ExpressionNode {
+    type: 'conditional';
+    test: ASTNode;
+    consequent: ASTNode;
+    alternate: ASTNode;
+}
+interface ArrayASTNode extends ExpressionNode {
+    type: 'array';
+    elements: ASTNode[];
+}
+type ASTNode = LiteralASTNode | IdentifierASTNode | MemberASTNode | CallASTNode | BinaryASTNode | UnaryASTNode | ConditionalASTNode | ArrayASTNode;
+/**
+ * 表达式解析器
+ */
+declare class Parser {
+    private tokens;
+    private pos;
+    constructor(tokens: Token[]);
+    /**
+     * 解析表达式
+     */
+    parse(): ASTNode;
+    private parseExpression;
+    private parseTernary;
+    private parseBinary;
+    private parseUnary;
+    private parsePostfix;
+    private parsePrimary;
+    private parseArray;
+    private parseArguments;
+    private current;
+    private advance;
+    private expect;
+}
+
+/**
+ * 表达式求值器
+ * 安全地执行 AST，无 eval
+ */
+
+/**
+ * 求值结果
+ */
+interface EvaluationResult {
+    value: unknown;
+    error?: Error;
+}
+/**
+ * 求值器配置
+ */
+interface EvaluatorOptions {
+    /** 最大递归深度 */
+    maxDepth?: number;
+    /** 最大执行时间（毫秒） */
+    timeout?: number;
+    /** 调试模式 */
+    debug?: boolean;
+}
+/**
+ * 表达式求值器
+ */
+declare class Evaluator {
+    private options;
+    private depth;
+    private startTime;
+    constructor(options?: EvaluatorOptions);
+    /**
+     * 求值表达式
+     */
+    evaluate(ast: ASTNode, context: ExpressionContext): EvaluationResult;
+    private evaluateNode;
+    private evaluateLiteral;
+    private evaluateIdentifier;
+    private evaluateMember;
+    private evaluateCall;
+    private evaluateBinary;
+    private evaluateUnary;
+    private evaluateConditional;
+    private evaluateArray;
+    private checkLimits;
+}
+
+/**
+ * 表达式引擎
+ * 统一的表达式解析和求值入口
+ */
+
+/**
+ * 表达式引擎配置
+ */
+interface ExpressionEngineOptions extends EvaluatorOptions {
+    /** 是否缓存 AST */
+    cacheAST?: boolean;
+    /** 最大缓存大小 */
+    maxCacheSize?: number;
+    /** 日志器 */
+    logger?: Logger;
+}
+/**
+ * 表达式引擎
+ * 安全的表达式解析和求值，无 eval/new Function
+ */
+declare class ExpressionEngine {
+    private options;
+    private evaluator;
+    private astCache;
+    constructor(options?: ExpressionEngineOptions);
+    /**
+     * 求值表达式
+     */
+    evaluate(expression: string, context: ExpressionContext): EvaluationResult;
+    /**
+     * 求值表达式并返回值
+     * 出错时返回 fallback 值
+     */
+    evaluateWithFallback<T>(expression: string, 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;
+}
+
+/**
+ * 内置函数实现
+ * 表达式中可调用的白名单函数
+ */
+type BuiltinFn = (...args: unknown[]) => unknown;
+/**
+ * 内置函数映射
+ */
+declare const builtinFunctions: Record<string, BuiltinFn>;
+
+/**
+ * Host API 实现
+ * 提供给组件的安全 API
+ */
+
+/**
+ * Host API 配置
+ */
+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;
+}
+/**
+ * Host API 实现
+ */
+declare class HostAPIImpl implements HostAPI {
+    private options;
+    private storageNamespace;
+    constructor(options: HostAPIOptions);
+    requestData<T = unknown>(queryId: string, params?: Record<string, unknown>): Promise<DataQueryResponse<T>>;
+    executeAction<T = unknown>(actionType: string, params?: Record<string, unknown>): Promise<ActionExecuteResponse<T>>;
+    navigate(options: NavigateOptions): void;
+    goBack(): void;
+    refresh(): void;
+    openDialog(options: DialogOptions): Promise<boolean | string>;
+    closeDialog(): void;
+    showToast(options: ToastOptions): void;
+    track(event: TrackEvent): void;
+    copyToClipboard(text: string): Promise<ClipboardResult>;
+    readFromClipboard(): Promise<ClipboardResult>;
+    getState<T = unknown>(key: string): T | undefined;
+    setState(key: string, value: unknown): void;
+    getVariable<T = unknown>(name: string): T | undefined;
+    postMessage(componentId: string, message: unknown): void;
+    broadcast(channel: string, message: unknown): void;
+    storage: {
+        get: <T = unknown>(key: string, options?: StorageOptions) => T | undefined;
+        set: (key: string, value: unknown, options?: StorageOptions) => void;
+        remove: (key: string, options?: StorageOptions) => void;
+    };
+    getContext(): RuntimeContext;
+    private buildHeaders;
+    private getStorageKey;
+    private generateIdempotencyKey;
+    private simpleHash;
+    private log;
+}
+
+/**
+ * 安全管理器
+ * SRI 校验、域名白名单、组件阻止等
+ */
+
+/**
+ * 安全管理器配置
+ */
+interface SecurityManagerOptions {
+    /** 是否启用 SRI 校验 */
+    enableSRI?: boolean;
+    /** CDN 域名白名单 */
+    cdnDomains?: string[];
+    /** API 域名白名单 */
+    apiDomains?: string[];
+    /** 被阻断的组件列表 */
+    blockedComponents?: BlockedComponent[];
+    /** 被阻断的动作类型 */
+    blockedActions?: string[];
+    /** 日志器 */
+    logger?: Logger;
+}
+/**
+ * 安全管理器
+ */
+declare class SecurityManager {
+    private options;
+    private blockedComponentsMap;
+    private blockedActionsSet;
+    constructor(options?: SecurityManagerOptions);
+    /**
+     * 更新阻断列表
+     */
+    updateBlockedList(components: BlockedComponent[], actions: string[]): void;
+    /**
+     * 检查组件是否被阻断
+     */
+    isComponentBlocked(name: string, version: string): boolean;
+    /**
+     * 获取组件阻断信息
+     */
+    getBlockedInfo(name: string, version: string): BlockedComponent | undefined;
+    /**
+     * 检查动作是否被阻断
+     */
+    isActionBlocked(actionType: string): boolean;
+    /**
+     * 验证组件完整性
+     */
+    validateComponent(name: string, version: string, content: string, expectedIntegrity: string): Promise<void>;
+    /**
+     * 验证 URL 是否在白名单内
+     */
+    isAllowedUrl(url: string, type: 'cdn' | 'api'): boolean;
+    /**
+     * 生成 CSP 策略
+     */
+    generateCSPPolicy(): string;
+    /**
+     * 应用 CSP 策略
+     */
+    applyCSP(): void;
+    /**
+     * 确保组件未被阻断
+     */
+    assertNotBlocked(name: string, version: string): void;
+    /**
+     * 计算哈希值
+     */
+    private computeHash;
+    private _log;
+    protected get log(): (level: "debug" | "info" | "warn" | "error", message: string) => void;
+}
+
+/**
+ * 基础渲染器
+ * 框架无关的渲染核心
+ */
+
+/**
+ * 渲染器配置
+ */
+interface BaseRendererOptions {
+    /** 表达式引擎 */
+    expressionEngine: ExpressionEngine;
+    /** 组件映射 */
+    components: Map<string, LoadedComponent>;
+    /** Host API 注入函数 */
+    injectHostApi: (element: HTMLElement, componentId: string) => void;
+    /** 调试模式 */
+    debug?: boolean;
+    /** 日志器 */
+    logger?: Logger;
+    /** 错误边界处理 */
+    onRenderError?: (componentId: string, error: Error) => HTMLElement | null;
+}
+/**
+ * 基础渲染器
+ * 将 PageSchema 渲染为 DOM
+ */
+declare class BaseRenderer implements Renderer {
+    private options;
+    private container;
+    private renderedElements;
+    private expressionContext;
+    constructor(options: BaseRendererOptions);
+    /**
+     * 初始化渲染器
+     */
+    init(): void;
+    /**
+     * 渲染页面
+     */
+    render(schema: PageSchema, container: HTMLElement): void;
+    /**
+     * 更新组件属性
+     */
+    updateComponent(componentId: string, props: Record<string, unknown>): void;
+    /**
+     * 更新表达式上下文
+     */
+    updateContext(context: Partial<ExpressionContext>): void;
+    /**
+     * 销毁渲染器
+     */
+    destroy(): void;
+    /**
+     * 渲染单个组件
+     */
+    private renderComponent;
+    /**
+     * 解析 props 中的表达式
+     */
+    private resolveProps;
+    /**
+     * 应用 props 到元素
+     */
+    private applyProps;
+    /**
+     * 应用样式到元素
+     */
+    private applyStyles;
+    /**
+     * 应用页面样式
+     */
+    private applyPageStyles;
+    private log;
+}
+
+/**
+ * Fallback 组件
+ * 组件加载失败或渲染错误时的降级显示
+ */
+/**
+ * 注册 fallback 组件
+ */
+declare function registerFallbackComponents(): void;
+/**
+ * 创建 fallback 元素
+ */
+declare function createFallbackElement(type: 'fallback' | 'blocked' | 'error', message?: string, componentName?: string): HTMLElement;
+
+/**
+ * 遥测管理器
+ * 链路追踪、性能监控、错误上报
+ */
+
+/**
+ * Span 信息
+ */
+interface Span {
+    spanId: string;
+    traceId: string;
+    parentSpanId?: string;
+    name: string;
+    startTime: number;
+    endTime?: number;
+    status?: 'ok' | 'error';
+    attributes?: Record<string, unknown>;
+}
+/**
+ * 遥测管理器配置
+ */
+interface TelemetryManagerOptions {
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 页面版本 ID */
+    pageVersionId: string;
+    /** 应用 ID */
+    appId?: string;
+    /** 采样率 (0-1) */
+    sampleRate?: number;
+    /** 上报 URL */
+    endpoint?: string;
+    /** 日志器 */
+    logger?: Logger;
+    /** 调试模式 */
+    debug?: boolean;
+}
+/**
+ * 遥测管理器
+ */
+declare class TelemetryManager {
+    private options;
+    private traceId;
+    private spans;
+    private metrics;
+    private errors;
+    private shouldSample;
+    constructor(options: TelemetryManagerOptions);
+    /**
+     * 获取 Trace ID
+     */
+    getTraceId(): string;
+    /**
+     * 获取 W3C Trace Context 格式的 traceparent
+     */
+    getTraceparent(): string;
+    /**
+     * 开始一个 Span
+     */
+    startSpan(name: string, parentSpanId?: string, attributes?: Record<string, unknown>): Span;
+    /**
+     * 结束一个 Span
+     */
+    endSpan(spanId: string, status?: 'ok' | 'error'): void;
+    /**
+     * 记录性能指标
+     */
+    recordMetric(type: PerformanceMetric['type'], name: string, duration: number, extra?: Record<string, unknown>): void;
+    /**
+     * 记录错误
+     */
+    recordError(error: Error | RuntimeError, context?: Record<string, unknown>): void;
+    /**
+     * 记录页面加载时间
+     */
+    recordPageLoad(duration: number, extra?: Record<string, unknown>): void;
+    /**
+     * 记录组件加载时间
+     */
+    recordComponentLoad(name: string, version: string, duration: number, success: boolean): void;
+    /**
+     * 记录首次渲染时间
+     */
+    recordFirstRender(duration: number): void;
+    /**
+     * 记录动作执行时间
+     */
+    recordActionExecute(actionType: string, duration: number, success: boolean): void;
+    /**
+     * 记录查询执行时间
+     */
+    recordQueryExecute(queryId: string, duration: number, success: boolean, fromCache: boolean): void;
+    /**
+     * 获取所有指标
+     */
+    getMetrics(): PerformanceMetric[];
+    /**
+     * 获取所有 Span
+     */
+    getSpans(): Span[];
+    /**
+     * 清理数据
+     */
+    clear(): void;
+    /**
+     * 刷新上报
+     */
+    flush(): Promise<void>;
+    private reportError;
+    private generateId;
+    private log;
+}
+declare module './telemetry-manager' {
+    interface TelemetryManagerOptions {
+        onMetric?: (metric: PerformanceMetric) => void;
+    }
+}
+
+export { type ASTNode, ActionBridge, type ActionBridgeOptions, ActionError, type ActionExecutor, AssetLoader, type AssetLoaderOptions, BaseRenderer, type BaseRendererOptions, ComponentBlockedError, ComponentLoadError, ComponentLoader, type ComponentLoaderOptions, DjvlcRuntime, DjvlcRuntimeError, type EvaluationResult, Evaluator, type EvaluatorOptions, EventBus, type EventBusOptions, type EventHandler, ExpressionEngine, type ExpressionEngineOptions, ExpressionError, HostAPIImpl, type HostAPIOptions, IntegrityError, Lexer, type LoadedComponent, type LogLevel, type Logger, PageLoadError, PageLoader, type PageLoaderOptions, Parser, QueryError, RenderError, type Renderer, type RuntimeOptions, type RuntimePhase, type RuntimeState, SecurityManager, type SecurityManagerOptions, type Span, type StateListener, StateManager, TelemetryManager, type TelemetryManagerOptions, type Token, type TokenType, type Unsubscribe, builtinFunctions, createFallbackElement, createRuntime, registerFallbackComponents };