@djvlc/runtime-core 1.2.0 → 1.2.2

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as _djvlc_contracts_types from '@djvlc/contracts-types';
-import { PageResolveResponse, ActionResult, ExpressionContext, Expression, ExpressionValidationResult, ActionRef, EventHandler, HostApi, NavigateOptions, TrackEvent as TrackEvent$1, DialogOptions, DialogResult, ToastOptions, ClipboardApi, StorageApi, ShareOptions, ShareResult, ConfirmOptions, ActionSheetOptions, ActionSheetResult, PreviewImageOptions, ScanCodeResult, ComponentContext, ErrorCode, ManifestItem, PageManifest, PageSchema, CapabilityName, PageLifecycle } from '@djvlc/contracts-types';
-export { ActionExecuteRequest, ActionExecuteResponse, ActionPolicy, ActionRef, ActionResult, AnyValueOrExpression, BlockedComponentInfo, BuiltinActionType, CapabilityDeclaration, CompatInfo, ComponentContext, ComponentMeta, ComponentNode, DataBinding, DataLoadStrategy, DataQueryRequest, DataQueryResponse, DialogOptions, DialogResult, ErrorCode, ErrorMessages, EventDeclaration, EventHandler, Expression, ExpressionContext, ExpressionLocal, ExpressionMeta, ExpressionType, ExpressionValidationResult, HostApi as HostAPI, HostApi, JsonValue, LayoutConfig, LayoutValues, LoopConfig, ManifestItem, NavigateOptions, NodeStyleConfig, PageConfig, PageLifecycle, PageManifest, PageMeta, PageSEO, PageSchema, PageState, PropDefinition, PropsSchema, RuntimeSpec, SchemaVersion, SemVer, StateFieldDefinition, ToastOptions, TrackEvent, UniqueId } from '@djvlc/contracts-types';
+import { PageResolveResponse, ActionResult, ExpressionContext, Expression, ExpressionValidationResult, EventBinding, HostApi, NavigateOptions, TrackEvent as TrackEvent$1, DialogOptions, DialogResult, ToastOptions, ClipboardApi, StorageApi, ShareOptions, ShareResult, ConfirmOptions, ActionSheetOptions, ActionSheetResult, PreviewImageOptions, ScanCodeResult, ComponentContext, ErrorCode, ManifestItem, PageManifest, PageSchema, CapabilityName, PageLifecycle } from '@djvlc/contracts-types';
+export { ACTION_STEP_DEFAULTS, ActionExecuteRequest, ActionExecuteResponse, ActionRef, ActionResult, ActionStep, AnyValueOrExpression, BlockedComponentInfo, BuiltinActionRef, BuiltinActionType, CapabilityDeclaration, CompatInfo, ComponentContext, ComponentMeta, ComponentNode, CustomActionRef, DataBinding, DataLoadStrategy, DataQueryRequest, DataQueryResponse, DialogOptions, DialogResult, EVENT_BINDING_DEFAULTS, ErrorCode, ErrorMessages, EventBinding, EventDeclaration, EventErrorStrategy, EventStep, EventStrategy, Expression, ExpressionContext, ExpressionLocal, ExpressionMeta, ExpressionType, ExpressionValidationResult, HostApi as HostAPI, HostApi, JsonValue, LayoutConfig, LayoutValues, LoopConfig, ManifestItem, NavigateOptions, NodeStyleConfig, PageConfig, PageLifecycle, PageManifest, PageMeta, PageSEO, PageSchema, PageState, PropDefinition, PropsSchema, RateLimitConfig, RuntimeSpec, SchemaVersion, SemVer, StateFieldDefinition, StepOutputConfig, StepRunMode, ToastOptions, TrackEvent, UniqueId, VersionedActionRef } from '@djvlc/contracts-types';
 
 /**
  * User API Adapter（端口接口）
@@ -850,28 +850,30 @@ declare class EventBus {
  */
 interface ActionExecutor {
     /** 执行自定义动作（通过 Action Gateway） */
-    executeAction<T = unknown>(actionType: string, params: Record<string, unknown>): Promise<{
+    executeAction<T = unknown>(actionKey: string, params: Record<string, unknown>, meta?: {
+        version?: string;
+        actionDefinitionVersionId?: string;
+    }): Promise<{
         success: boolean;
         data?: T;
         errorCode?: string;
         errorMessage?: string;
     }>;
-    /** 执行数据查询（通过 Data Proxy） */
-    requestData<T = unknown>(queryId: string, params?: Record<string, unknown>): Promise<{
-        success: boolean;
-        data?: T;
-        message?: string;
-    }>;
     /** 导航 */
     navigate(options: _djvlc_contracts_types.NavigateOptions): void;
-    /** 打开对话框 */
-    openDialog(options: {
+    /**
+     * 显示系统级对话框（DOM 浮层，复用 djvlc-dialog 视觉风格）
+     *
+     * @description
+     * 仅用于"系统对话框"模式（无 dialogId 时）。
+     * "组件弹窗"模式由 ActionBridge 内部通过 DOM 直接操作，不走此接口。
+     * 弹窗关闭时 resolve，不返回确认/取消结果。
+     */
+    showSystemDialog(options: {
         type: string;
-        content: string;
         title?: string;
-    }): Promise<unknown>;
-    /** 关闭对话框 */
-    closeDialog(dialogId?: string): void;
+        content: string;
+    }): Promise<void>;
     /** 显示 Toast */
     showToast(options: {
         message: string;
@@ -906,51 +908,41 @@ interface ActionBridgeOptions {
     debug?: boolean;
     /** 日志器 */
     logger?: Logger;
-    /** 动作执行前回调 */
-    onActionStart?: (actionRef: ActionRef, params: Record<string, unknown>) => void;
-    /** 动作执行后回调 */
-    onActionComplete?: (actionRef: ActionRef, result: {
-        success: boolean;
-        data?: unknown;
-        error?: Error;
-    }) => void;
-}
-/**
- * 动作执行上下文
- */
-interface ActionExecutionContext {
-    /** 事件数据 */
-    $event: unknown;
-    /** 上一个动作的结果 */
-    $prevResult: unknown;
-    /** 所有动作的结果 */
-    $results: Record<string, unknown>;
 }
 /**
  * 动作桥接器
- * 将组件事件转换为动作执行，支持动作链、条件执行、重试等
+ *
+ * 统一入口：executeEventBinding
+ * 将 EventBinding 的声明式配置转换为实际执行。
  */
 declare class ActionBridge {
     private options;
     private debounceTimers;
     private throttleTimers;
+    private concurrentCount;
+    /** 记录 rateLimit.once 已触发的 binding */
+    private onceFired;
     constructor(options: ActionBridgeOptions);
     /**
-     * 处理事件处理器
+     * 执行事件绑定
+     *
+     * 统一入口，严格按 contracts EventBinding 语义执行。
      */
-    handleEvent(handler: EventHandler, eventData: unknown, baseContext: ExpressionContext): Promise<void>;
+    executeEventBinding(binding: EventBinding, eventData: unknown, baseContext: ExpressionContext): Promise<void>;
+    private executeSequential;
+    private executeParallel;
     /**
-     * 执行动作链
+     * 准备并执行单个步骤（sequential 模式专用，处理 runMode）
      */
-    executeActionChain(actions: ActionRef[], baseContext: ExpressionContext, executionContext: ActionExecutionContext): Promise<void>;
+    private prepareAndExecuteStep;
     /**
-     * 执行单个动作
+     * 安全执行单个步骤（捕获错误，返回 StepResult）
      */
-    private executeSingleAction;
+    private executeStepSafe;
     /**
-     * 执行动作（带重试）
+     * 根据 ActionRef 分发到具体执行器
      */
-    private executeWithRetry;
+    private dispatchAction;
     /**
      * 执行内置动作
      */
@@ -960,56 +952,41 @@ declare class ActionBridge {
      */
     private executeCustomAction;
     /**
-     * Expression 类型列表（用于判断是否为 Expression 对象）
+     * 设置画布上弹窗组件的可见性
+     *
+     * @param dialogId - 组件 data-component-id
+     * @param visible - true 打开 / false 关闭
+     * @returns 执行结果
+     * @throws ActionError 如果组件不存在
      */
+    private setDialogVisibility;
+    /** Expression.type 列表（用于识别 Expression 对象） */
     private static readonly EXPRESSION_TYPES;
     /**
      * 解析参数中的表达式
-     *
-     * @param params - ActionRef.params，类型为 Record<string, AnyValueOrExpression>
      */
     private resolveParams;
     /**
      * 解析单个值（支持 AnyValueOrExpression）
-     *
-     * AnyValueOrExpression 可以是：
-     * - Expression 对象：{ type: 'state' | 'binding' | 'local' | 'template' | 'computed', value: string, fallback?: any }
-     * - 原始值：string | number | boolean | null
-     * - 嵌套数组：AnyValueOrExpression[]
-     * - 嵌套对象：{ [key: string]: AnyValueOrExpression }
      */
     private resolveValue;
     /**
      * 求值条件表达式
-     * 将事件数据注入到 local 上下文中（对齐 contracts 的 ExpressionContext）
-     *
-     * @param condition - Expression 对象，包含 type、value、fallback
      */
     private evaluateCondition;
     /**
-     * 构建动作执行上下文
-     * 将事件数据和动作结果注入到 local 上下文中
-     */
-    private buildActionContext;
-    /**
-     * 带超时的 Promise
+     * 构建步骤执行上下文
      */
+    private buildStepContext;
+    /** 描述 ActionRef（日志用） */
+    private describeRef;
+    /** 带超时的 Promise */
     private withTimeout;
-    /**
-     * 防抖
-     */
-    private debounce;
-    /**
-     * 节流
-     */
-    private throttle;
-    /**
-     * 延迟
-     */
-    private delay;
-    /**
-     * 销毁
-     */
+    /** 节流检查 */
+    private checkThrottle;
+    /** 防抖 */
+    private applyDebounce;
+    /** 销毁 */
     destroy(): void;
     private log;
 }
@@ -1068,6 +1045,10 @@ declare class HostAPIImpl implements HostApi {
     private storageNamespace;
     private loadingCount;
     private loadingElement;
+    /** 当前活跃的系统弹窗元素（同一时间只显示一个，新弹窗替换旧弹窗） */
+    private systemDialogOverlay;
+    /** 当前系统弹窗的 resolve 回调 */
+    private systemDialogResolve;
     constructor(options: HostAPIOptions);
     navigate(options: NavigateOptions): Promise<void>;
     track(event: TrackEvent$1): void;
@@ -1078,6 +1059,26 @@ declare class HostAPIImpl implements HostApi {
     showToast(options: ToastOptions): void;
     showLoading(message?: string): void;
     hideLoading(): void;
+    /**
+     * 显示系统级对话框（DOM 浮层）
+     *
+     * 与 showToast / showLoading 同级，直接用 DOM 创建弹窗浮层，
+     * 复用 djvlc-dialog 的视觉风格（遮罩 + 居中卡片 + 标题 + 内容 + 确认按钮）。
+     *
+     * - 同一时间只显示一个系统弹窗（新弹窗替换旧弹窗）
+     * - 点击"我知道了"按钮或遮罩 → 关闭弹窗 → resolve
+     * - type 映射按钮颜色：info/confirm/alert=蓝色，warning=橙色，error=红色
+     *
+     * @param options.type - 弹窗类型：info / warning / error / confirm / alert
+     * @param options.title - 标题（可选）
+     * @param options.content - 内容
+     * @returns Promise<void> — 弹窗关闭时 resolve（不返回确认/取消结果）
+     */
+    showSystemDialog(options: {
+        type: string;
+        title?: string;
+        content: string;
+    }): Promise<void>;
     clipboard: ClipboardApi;
     storage: StorageApi;
     share(options: ShareOptions): Promise<ShareResult>;
@@ -1091,6 +1092,7 @@ declare class HostAPIImpl implements HostApi {
     private generateIdempotencyKey;
     private simpleHash;
     private fallbackCopy;
+    private escapeHtml;
     private log;
 }
 
@@ -1935,7 +1937,7 @@ interface BaseRendererOptions {
     /** Host API 注入函数 */
     injectHostApi: (element: HTMLElement, componentId: string) => void;
     /** 事件处理器 */
-    onComponentEvent?: (componentId: string, eventName: string, handlers: EventHandler[], eventData: unknown) => void;
+    onComponentEvent?: (componentId: string, eventName: string, bindings: EventBinding[], eventData: unknown) => void;
     /** 调试模式 */
     debug?: boolean;
     /** 日志器 */
@@ -2014,7 +2016,7 @@ declare class BaseRenderer implements Renderer {
      */
     private createSlotContainer;
     /**
-     * 绑定事件处理器
+     * 绑定事件处理器（新 EventBinding 结构）
      */
     private bindEventHandlers;
     /**
@@ -2080,6 +2082,30 @@ declare class BaseRenderer implements Renderer {
      * 将布局值转换为 CSS
      */
     private layoutToCSS;
+    /**
+     * 应用 SEO 配置
+     *
+     * 按照 PageSEO 定义设置 document.title / <meta> / Open Graph / JSON-LD：
+     * - title  → document.title + <meta property="og:title">
+     * - description → <meta name="description"> + <meta property="og:description">
+     * - keywords → <meta name="keywords">
+     * - canonicalUrl → <link rel="canonical">
+     * - ogImage → <meta property="og:image">
+     * - ogType → <meta property="og:type">
+     * - indexable → <meta name="robots">
+     * - structuredData → <script type="application/ld+json">
+     *
+     * 优先级：seo.title > meta.title（seo 是面向搜索引擎的，meta 是面向编辑器的）
+     */
+    private applySEO;
+    /** 设置或更新 <meta name="..."> 标签 */
+    private _setMeta;
+    /** 设置或更新 <meta property="..."> 标签（Open Graph） */
+    private _setMetaProperty;
+    /** 设置或更新 <link rel="..."> 标签 */
+    private _setLink;
+    /** 注入 JSON-LD 结构化数据 */
+    private _injectJsonLd;
     /**
      * 应用页面配置（PageConfig 结构）
      *
@@ -2463,13 +2489,13 @@ declare class LifecycleManager {
      */
     private setupVisibilityListener;
     /**
-     * 执行生命周期动作
+     * 执行生命周期步骤
      */
-    private executeLifecycleActions;
+    private executeLifecycleSteps;
     /**
-     * 使用指定上下文执行生命周期动作
+     * 使用指定上下文执行生命周期步骤
      */
-    private executeLifecycleActionsWithContext;
+    private executeLifecycleStepsWithContext;
     private log;
 }
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _djvlc_contracts_types from '@djvlc/contracts-types';
-import { PageResolveResponse, ActionResult, ExpressionContext, Expression, ExpressionValidationResult, ActionRef, EventHandler, HostApi, NavigateOptions, TrackEvent as TrackEvent$1, DialogOptions, DialogResult, ToastOptions, ClipboardApi, StorageApi, ShareOptions, ShareResult, ConfirmOptions, ActionSheetOptions, ActionSheetResult, PreviewImageOptions, ScanCodeResult, ComponentContext, ErrorCode, ManifestItem, PageManifest, PageSchema, CapabilityName, PageLifecycle } from '@djvlc/contracts-types';
-export { ActionExecuteRequest, ActionExecuteResponse, ActionPolicy, ActionRef, ActionResult, AnyValueOrExpression, BlockedComponentInfo, BuiltinActionType, CapabilityDeclaration, CompatInfo, ComponentContext, ComponentMeta, ComponentNode, DataBinding, DataLoadStrategy, DataQueryRequest, DataQueryResponse, DialogOptions, DialogResult, ErrorCode, ErrorMessages, EventDeclaration, EventHandler, Expression, ExpressionContext, ExpressionLocal, ExpressionMeta, ExpressionType, ExpressionValidationResult, HostApi as HostAPI, HostApi, JsonValue, LayoutConfig, LayoutValues, LoopConfig, ManifestItem, NavigateOptions, NodeStyleConfig, PageConfig, PageLifecycle, PageManifest, PageMeta, PageSEO, PageSchema, PageState, PropDefinition, PropsSchema, RuntimeSpec, SchemaVersion, SemVer, StateFieldDefinition, ToastOptions, TrackEvent, UniqueId } from '@djvlc/contracts-types';
+import { PageResolveResponse, ActionResult, ExpressionContext, Expression, ExpressionValidationResult, EventBinding, HostApi, NavigateOptions, TrackEvent as TrackEvent$1, DialogOptions, DialogResult, ToastOptions, ClipboardApi, StorageApi, ShareOptions, ShareResult, ConfirmOptions, ActionSheetOptions, ActionSheetResult, PreviewImageOptions, ScanCodeResult, ComponentContext, ErrorCode, ManifestItem, PageManifest, PageSchema, CapabilityName, PageLifecycle } from '@djvlc/contracts-types';
+export { ACTION_STEP_DEFAULTS, ActionExecuteRequest, ActionExecuteResponse, ActionRef, ActionResult, ActionStep, AnyValueOrExpression, BlockedComponentInfo, BuiltinActionRef, BuiltinActionType, CapabilityDeclaration, CompatInfo, ComponentContext, ComponentMeta, ComponentNode, CustomActionRef, DataBinding, DataLoadStrategy, DataQueryRequest, DataQueryResponse, DialogOptions, DialogResult, EVENT_BINDING_DEFAULTS, ErrorCode, ErrorMessages, EventBinding, EventDeclaration, EventErrorStrategy, EventStep, EventStrategy, Expression, ExpressionContext, ExpressionLocal, ExpressionMeta, ExpressionType, ExpressionValidationResult, HostApi as HostAPI, HostApi, JsonValue, LayoutConfig, LayoutValues, LoopConfig, ManifestItem, NavigateOptions, NodeStyleConfig, PageConfig, PageLifecycle, PageManifest, PageMeta, PageSEO, PageSchema, PageState, PropDefinition, PropsSchema, RateLimitConfig, RuntimeSpec, SchemaVersion, SemVer, StateFieldDefinition, StepOutputConfig, StepRunMode, ToastOptions, TrackEvent, UniqueId, VersionedActionRef } from '@djvlc/contracts-types';
 
 /**
  * User API Adapter（端口接口）
@@ -850,28 +850,30 @@ declare class EventBus {
  */
 interface ActionExecutor {
     /** 执行自定义动作（通过 Action Gateway） */
-    executeAction<T = unknown>(actionType: string, params: Record<string, unknown>): Promise<{
+    executeAction<T = unknown>(actionKey: string, params: Record<string, unknown>, meta?: {
+        version?: string;
+        actionDefinitionVersionId?: string;
+    }): Promise<{
         success: boolean;
         data?: T;
         errorCode?: string;
         errorMessage?: string;
     }>;
-    /** 执行数据查询（通过 Data Proxy） */
-    requestData<T = unknown>(queryId: string, params?: Record<string, unknown>): Promise<{
-        success: boolean;
-        data?: T;
-        message?: string;
-    }>;
     /** 导航 */
     navigate(options: _djvlc_contracts_types.NavigateOptions): void;
-    /** 打开对话框 */
-    openDialog(options: {
+    /**
+     * 显示系统级对话框（DOM 浮层，复用 djvlc-dialog 视觉风格）
+     *
+     * @description
+     * 仅用于"系统对话框"模式（无 dialogId 时）。
+     * "组件弹窗"模式由 ActionBridge 内部通过 DOM 直接操作，不走此接口。
+     * 弹窗关闭时 resolve，不返回确认/取消结果。
+     */
+    showSystemDialog(options: {
         type: string;
-        content: string;
         title?: string;
-    }): Promise<unknown>;
-    /** 关闭对话框 */
-    closeDialog(dialogId?: string): void;
+        content: string;
+    }): Promise<void>;
     /** 显示 Toast */
     showToast(options: {
         message: string;
@@ -906,51 +908,41 @@ interface ActionBridgeOptions {
     debug?: boolean;
     /** 日志器 */
     logger?: Logger;
-    /** 动作执行前回调 */
-    onActionStart?: (actionRef: ActionRef, params: Record<string, unknown>) => void;
-    /** 动作执行后回调 */
-    onActionComplete?: (actionRef: ActionRef, result: {
-        success: boolean;
-        data?: unknown;
-        error?: Error;
-    }) => void;
-}
-/**
- * 动作执行上下文
- */
-interface ActionExecutionContext {
-    /** 事件数据 */
-    $event: unknown;
-    /** 上一个动作的结果 */
-    $prevResult: unknown;
-    /** 所有动作的结果 */
-    $results: Record<string, unknown>;
 }
 /**
  * 动作桥接器
- * 将组件事件转换为动作执行，支持动作链、条件执行、重试等
+ *
+ * 统一入口：executeEventBinding
+ * 将 EventBinding 的声明式配置转换为实际执行。
  */
 declare class ActionBridge {
     private options;
     private debounceTimers;
     private throttleTimers;
+    private concurrentCount;
+    /** 记录 rateLimit.once 已触发的 binding */
+    private onceFired;
     constructor(options: ActionBridgeOptions);
     /**
-     * 处理事件处理器
+     * 执行事件绑定
+     *
+     * 统一入口，严格按 contracts EventBinding 语义执行。
      */
-    handleEvent(handler: EventHandler, eventData: unknown, baseContext: ExpressionContext): Promise<void>;
+    executeEventBinding(binding: EventBinding, eventData: unknown, baseContext: ExpressionContext): Promise<void>;
+    private executeSequential;
+    private executeParallel;
     /**
-     * 执行动作链
+     * 准备并执行单个步骤（sequential 模式专用，处理 runMode）
      */
-    executeActionChain(actions: ActionRef[], baseContext: ExpressionContext, executionContext: ActionExecutionContext): Promise<void>;
+    private prepareAndExecuteStep;
     /**
-     * 执行单个动作
+     * 安全执行单个步骤（捕获错误，返回 StepResult）
      */
-    private executeSingleAction;
+    private executeStepSafe;
     /**
-     * 执行动作（带重试）
+     * 根据 ActionRef 分发到具体执行器
      */
-    private executeWithRetry;
+    private dispatchAction;
     /**
      * 执行内置动作
      */
@@ -960,56 +952,41 @@ declare class ActionBridge {
      */
     private executeCustomAction;
     /**
-     * Expression 类型列表（用于判断是否为 Expression 对象）
+     * 设置画布上弹窗组件的可见性
+     *
+     * @param dialogId - 组件 data-component-id
+     * @param visible - true 打开 / false 关闭
+     * @returns 执行结果
+     * @throws ActionError 如果组件不存在
      */
+    private setDialogVisibility;
+    /** Expression.type 列表（用于识别 Expression 对象） */
     private static readonly EXPRESSION_TYPES;
     /**
      * 解析参数中的表达式
-     *
-     * @param params - ActionRef.params，类型为 Record<string, AnyValueOrExpression>
      */
     private resolveParams;
     /**
      * 解析单个值（支持 AnyValueOrExpression）
-     *
-     * AnyValueOrExpression 可以是：
-     * - Expression 对象：{ type: 'state' | 'binding' | 'local' | 'template' | 'computed', value: string, fallback?: any }
-     * - 原始值：string | number | boolean | null
-     * - 嵌套数组：AnyValueOrExpression[]
-     * - 嵌套对象：{ [key: string]: AnyValueOrExpression }
      */
     private resolveValue;
     /**
      * 求值条件表达式
-     * 将事件数据注入到 local 上下文中（对齐 contracts 的 ExpressionContext）
-     *
-     * @param condition - Expression 对象，包含 type、value、fallback
      */
     private evaluateCondition;
     /**
-     * 构建动作执行上下文
-     * 将事件数据和动作结果注入到 local 上下文中
-     */
-    private buildActionContext;
-    /**
-     * 带超时的 Promise
+     * 构建步骤执行上下文
      */
+    private buildStepContext;
+    /** 描述 ActionRef（日志用） */
+    private describeRef;
+    /** 带超时的 Promise */
     private withTimeout;
-    /**
-     * 防抖
-     */
-    private debounce;
-    /**
-     * 节流
-     */
-    private throttle;
-    /**
-     * 延迟
-     */
-    private delay;
-    /**
-     * 销毁
-     */
+    /** 节流检查 */
+    private checkThrottle;
+    /** 防抖 */
+    private applyDebounce;
+    /** 销毁 */
     destroy(): void;
     private log;
 }
@@ -1068,6 +1045,10 @@ declare class HostAPIImpl implements HostApi {
     private storageNamespace;
     private loadingCount;
     private loadingElement;
+    /** 当前活跃的系统弹窗元素（同一时间只显示一个，新弹窗替换旧弹窗） */
+    private systemDialogOverlay;
+    /** 当前系统弹窗的 resolve 回调 */
+    private systemDialogResolve;
     constructor(options: HostAPIOptions);
     navigate(options: NavigateOptions): Promise<void>;
     track(event: TrackEvent$1): void;
@@ -1078,6 +1059,26 @@ declare class HostAPIImpl implements HostApi {
     showToast(options: ToastOptions): void;
     showLoading(message?: string): void;
     hideLoading(): void;
+    /**
+     * 显示系统级对话框（DOM 浮层）
+     *
+     * 与 showToast / showLoading 同级，直接用 DOM 创建弹窗浮层，
+     * 复用 djvlc-dialog 的视觉风格（遮罩 + 居中卡片 + 标题 + 内容 + 确认按钮）。
+     *
+     * - 同一时间只显示一个系统弹窗（新弹窗替换旧弹窗）
+     * - 点击"我知道了"按钮或遮罩 → 关闭弹窗 → resolve
+     * - type 映射按钮颜色：info/confirm/alert=蓝色，warning=橙色，error=红色
+     *
+     * @param options.type - 弹窗类型：info / warning / error / confirm / alert
+     * @param options.title - 标题（可选）
+     * @param options.content - 内容
+     * @returns Promise<void> — 弹窗关闭时 resolve（不返回确认/取消结果）
+     */
+    showSystemDialog(options: {
+        type: string;
+        title?: string;
+        content: string;
+    }): Promise<void>;
     clipboard: ClipboardApi;
     storage: StorageApi;
     share(options: ShareOptions): Promise<ShareResult>;
@@ -1091,6 +1092,7 @@ declare class HostAPIImpl implements HostApi {
     private generateIdempotencyKey;
     private simpleHash;
     private fallbackCopy;
+    private escapeHtml;
     private log;
 }
 
@@ -1935,7 +1937,7 @@ interface BaseRendererOptions {
     /** Host API 注入函数 */
     injectHostApi: (element: HTMLElement, componentId: string) => void;
     /** 事件处理器 */
-    onComponentEvent?: (componentId: string, eventName: string, handlers: EventHandler[], eventData: unknown) => void;
+    onComponentEvent?: (componentId: string, eventName: string, bindings: EventBinding[], eventData: unknown) => void;
     /** 调试模式 */
     debug?: boolean;
     /** 日志器 */
@@ -2014,7 +2016,7 @@ declare class BaseRenderer implements Renderer {
      */
     private createSlotContainer;
     /**
-     * 绑定事件处理器
+     * 绑定事件处理器（新 EventBinding 结构）
      */
     private bindEventHandlers;
     /**
@@ -2080,6 +2082,30 @@ declare class BaseRenderer implements Renderer {
      * 将布局值转换为 CSS
      */
     private layoutToCSS;
+    /**
+     * 应用 SEO 配置
+     *
+     * 按照 PageSEO 定义设置 document.title / <meta> / Open Graph / JSON-LD：
+     * - title  → document.title + <meta property="og:title">
+     * - description → <meta name="description"> + <meta property="og:description">
+     * - keywords → <meta name="keywords">
+     * - canonicalUrl → <link rel="canonical">
+     * - ogImage → <meta property="og:image">
+     * - ogType → <meta property="og:type">
+     * - indexable → <meta name="robots">
+     * - structuredData → <script type="application/ld+json">
+     *
+     * 优先级：seo.title > meta.title（seo 是面向搜索引擎的，meta 是面向编辑器的）
+     */
+    private applySEO;
+    /** 设置或更新 <meta name="..."> 标签 */
+    private _setMeta;
+    /** 设置或更新 <meta property="..."> 标签（Open Graph） */
+    private _setMetaProperty;
+    /** 设置或更新 <link rel="..."> 标签 */
+    private _setLink;
+    /** 注入 JSON-LD 结构化数据 */
+    private _injectJsonLd;
     /**
      * 应用页面配置（PageConfig 结构）
      *
@@ -2463,13 +2489,13 @@ declare class LifecycleManager {
      */
     private setupVisibilityListener;
     /**
-     * 执行生命周期动作
+     * 执行生命周期步骤
      */
-    private executeLifecycleActions;
+    private executeLifecycleSteps;
     /**
-     * 使用指定上下文执行生命周期动作
+     * 使用指定上下文执行生命周期步骤
      */
-    private executeLifecycleActionsWithContext;
+    private executeLifecycleStepsWithContext;
     private log;
 }