@esengine/blueprint 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2298 @@
+import { Entity, IScene } from '@esengine/ecs-framework';
+import { IRuntimePlugin } from '@esengine/engine-core';
+
+/**
+ * Blueprint Pin Types
+ * 蓝图引脚类型
+ */
+/**
+ * Pin data type for blueprint nodes
+ * 蓝图节点的引脚数据类型
+ */
+type BlueprintPinType = 'exec' | 'bool' | 'int' | 'float' | 'string' | 'vector2' | 'vector3' | 'color' | 'entity' | 'component' | 'object' | 'array' | 'any';
+/**
+ * Pin direction
+ * 引脚方向
+ */
+type BlueprintPinDirection = 'input' | 'output';
+/**
+ * Pin definition for node templates
+ * 节点模板的引脚定义
+ *
+ * Note: direction is determined by whether the pin is in inputs[] or outputs[] array
+ * 注意：方向由引脚在 inputs[] 还是 outputs[] 数组中决定
+ */
+interface BlueprintPinDefinition {
+    /** Unique name within node (节点内唯一名称) */
+    name: string;
+    /** Pin data type (引脚数据类型) */
+    type: BlueprintPinType;
+    /** Display name shown in the editor (编辑器中显示的名称) */
+    displayName?: string;
+    /** Default value when not connected (未连接时的默认值) */
+    defaultValue?: unknown;
+    /** Allow multiple connections (允许多个连接) */
+    allowMultiple?: boolean;
+    /** Array element type if type is 'array' (数组元素类型) */
+    arrayType?: BlueprintPinType;
+    /** Whether this pin is optional (是否可选) */
+    optional?: boolean;
+    /** Tooltip description (提示描述) */
+    tooltip?: string;
+}
+/**
+ * Runtime pin with direction - used when processing pins
+ * 带方向的运行时引脚 - 处理引脚时使用
+ */
+interface BlueprintRuntimePin extends BlueprintPinDefinition {
+    /** Pin direction (引脚方向) */
+    direction: BlueprintPinDirection;
+}
+/**
+ * Pin instance in a node
+ * 节点中的引脚实例
+ */
+interface BlueprintPin {
+    id: string;
+    nodeId: string;
+    definition: BlueprintPinDefinition;
+    value?: unknown;
+}
+/**
+ * Gets the color for a pin type
+ * 获取引脚类型的颜色
+ */
+declare function getPinTypeColor(type: BlueprintPinType): string;
+/**
+ * Checks if two pin types are compatible for connection
+ * 检查两个引脚类型是否兼容连接
+ */
+declare function arePinTypesCompatible(from: BlueprintPinType, to: BlueprintPinType): boolean;
+
+/**
+ * Blueprint Node Types
+ * 蓝图节点类型
+ */
+
+/**
+ * Node category for visual styling and organization
+ * 节点类别，用于视觉样式和组织
+ */
+type BlueprintNodeCategory = 'event' | 'flow' | 'entity' | 'component' | 'math' | 'logic' | 'variable' | 'input' | 'physics' | 'audio' | 'time' | 'debug' | 'custom';
+/**
+ * Node template definition - describes a type of node
+ * 节点模板定义 - 描述一种节点类型
+ */
+interface BlueprintNodeTemplate {
+    /** Unique type identifier (唯一类型标识符) */
+    type: string;
+    /** Display title (显示标题) */
+    title: string;
+    /** Node category (节点类别) */
+    category: BlueprintNodeCategory;
+    /** Optional subtitle (可选副标题) */
+    subtitle?: string;
+    /** Icon name (图标名称) */
+    icon?: string;
+    /** Description for documentation (文档描述) */
+    description?: string;
+    /** Search keywords (搜索关键词) */
+    keywords?: string[];
+    /** Menu path for node palette (节点面板的菜单路径) */
+    menuPath?: string[];
+    /** Input pin definitions (输入引脚定义) */
+    inputs: BlueprintPinDefinition[];
+    /** Output pin definitions (输出引脚定义) */
+    outputs: BlueprintPinDefinition[];
+    /** Whether this node is pure (no exec pins) (是否是纯节点，无执行引脚) */
+    isPure?: boolean;
+    /** Whether this node can be collapsed (是否可折叠) */
+    collapsible?: boolean;
+    /** Custom header color override (自定义头部颜色) */
+    headerColor?: string;
+    /** Node color for visual distinction (节点颜色用于视觉区分) */
+    color?: string;
+}
+/**
+ * Node instance in a blueprint graph
+ * 蓝图图中的节点实例
+ */
+interface BlueprintNode {
+    /** Unique instance ID (唯一实例ID) */
+    id: string;
+    /** Template type reference (模板类型引用) */
+    type: string;
+    /** Position in graph (图中位置) */
+    position: {
+        x: number;
+        y: number;
+    };
+    /** Custom data for this instance (此实例的自定义数据) */
+    data: Record<string, unknown>;
+    /** Comment/note for this node (此节点的注释) */
+    comment?: string;
+}
+/**
+ * Connection between two pins
+ * 两个引脚之间的连接
+ */
+interface BlueprintConnection {
+    /** Unique connection ID (唯一连接ID) */
+    id: string;
+    /** Source node ID (源节点ID) */
+    fromNodeId: string;
+    /** Source pin name (源引脚名称) */
+    fromPin: string;
+    /** Target node ID (目标节点ID) */
+    toNodeId: string;
+    /** Target pin name (目标引脚名称) */
+    toPin: string;
+}
+/**
+ * Gets the header color for a node category
+ * 获取节点类别的头部颜色
+ */
+declare function getNodeCategoryColor(category: BlueprintNodeCategory): string;
+
+/**
+ * Blueprint Asset Types
+ * 蓝图资产类型
+ */
+
+/**
+ * Variable scope determines lifetime and accessibility
+ * 变量作用域决定生命周期和可访问性
+ */
+type VariableScope = 'local' | 'instance' | 'global';
+/**
+ * Blueprint variable definition
+ * 蓝图变量定义
+ */
+interface BlueprintVariable {
+    /** Variable name (变量名) */
+    name: string;
+    /** Variable type (变量类型) */
+    type: string;
+    /** Default value (默认值) */
+    defaultValue: unknown;
+    /** Variable scope (变量作用域) */
+    scope: VariableScope;
+    /** Category for organization (分类) */
+    category?: string;
+    /** Description tooltip (描述提示) */
+    tooltip?: string;
+}
+/**
+ * Blueprint asset metadata
+ * 蓝图资产元数据
+ */
+interface BlueprintMetadata {
+    /** Blueprint name (蓝图名称) */
+    name: string;
+    /** Description (描述) */
+    description?: string;
+    /** Category for organization (分类) */
+    category?: string;
+    /** Author (作者) */
+    author?: string;
+    /** Creation timestamp (创建时间戳) */
+    createdAt?: number;
+    /** Last modified timestamp (最后修改时间戳) */
+    modifiedAt?: number;
+}
+/**
+ * Blueprint asset format - saved to .bp files
+ * 蓝图资产格式 - 保存为 .bp 文件
+ */
+interface BlueprintAsset {
+    /** Format version (格式版本) */
+    version: number;
+    /** Asset type identifier (资产类型标识符) */
+    type: 'blueprint';
+    /** Metadata (元数据) */
+    metadata: BlueprintMetadata;
+    /** Variable definitions (变量定义) */
+    variables: BlueprintVariable[];
+    /** Node instances (节点实例) */
+    nodes: BlueprintNode[];
+    /** Connections between nodes (节点之间的连接) */
+    connections: BlueprintConnection[];
+}
+/**
+ * Creates an empty blueprint asset
+ * 创建空的蓝图资产
+ */
+declare function createEmptyBlueprint(name: string): BlueprintAsset;
+/**
+ * Validates a blueprint asset structure
+ * 验证蓝图资产结构
+ */
+declare function validateBlueprintAsset(asset: unknown): asset is BlueprintAsset;
+
+/**
+ * Execution Context - Runtime context for blueprint execution
+ * 执行上下文 - 蓝图执行的运行时上下文
+ */
+
+/**
+ * Result of node execution
+ * 节点执行的结果
+ */
+interface ExecutionResult {
+    /**
+     * Next exec pin to follow (null to stop, undefined to continue default)
+     * 下一个要执行的引脚（null 停止，undefined 继续默认）
+     */
+    nextExec?: string | null;
+    /**
+     * Output values by pin name
+     * 按引脚名称的输出值
+     */
+    outputs?: Record<string, unknown>;
+    /**
+     * Whether to yield execution (for async operations)
+     * 是否暂停执行（用于异步操作）
+     */
+    yield?: boolean;
+    /**
+     * Delay before continuing (in seconds)
+     * 继续前的延迟（秒）
+     */
+    delay?: number;
+    /**
+     * Error message if execution failed
+     * 执行失败时的错误消息
+     */
+    error?: string;
+}
+/**
+ * Execution context provides access to runtime services
+ * 执行上下文提供对运行时服务的访问
+ */
+declare class ExecutionContext {
+    /** Current blueprint asset (当前蓝图资产) */
+    readonly blueprint: BlueprintAsset;
+    /** Owner entity (所有者实体) */
+    readonly entity: Entity;
+    /** Current scene (当前场景) */
+    readonly scene: IScene;
+    /** Frame delta time (帧增量时间) */
+    deltaTime: number;
+    /** Total time since start (开始以来的总时间) */
+    time: number;
+    /** Instance variables (实例变量) */
+    private _instanceVariables;
+    /** Local variables (per-execution) (局部变量，每次执行) */
+    private _localVariables;
+    /** Global variables (shared) (全局变量，共享) */
+    private static _globalVariables;
+    /** Node output cache for current execution (当前执行的节点输出缓存) */
+    private _outputCache;
+    /** Connection lookup by target (按目标的连接查找) */
+    private _connectionsByTarget;
+    /** Connection lookup by source (按源的连接查找) */
+    private _connectionsBySource;
+    constructor(blueprint: BlueprintAsset, entity: Entity, scene: IScene);
+    private _buildConnectionMaps;
+    /**
+     * Get a node by ID
+     * 通过ID获取节点
+     */
+    getNode(nodeId: string): BlueprintNode | undefined;
+    /**
+     * Get connections to a target pin
+     * 获取到目标引脚的连接
+     */
+    getConnectionsToPin(nodeId: string, pinName: string): BlueprintConnection[];
+    /**
+     * Get connections from a source pin
+     * 获取从源引脚的连接
+     */
+    getConnectionsFromPin(nodeId: string, pinName: string): BlueprintConnection[];
+    /**
+     * Evaluate an input pin value (follows connections or uses default)
+     * 计算输入引脚值（跟随连接或使用默认值）
+     */
+    evaluateInput(nodeId: string, pinName: string, defaultValue?: unknown): unknown;
+    /**
+     * Set output values for a node (cached for current execution)
+     * 设置节点的输出值（为当前执行缓存）
+     */
+    setOutputs(nodeId: string, outputs: Record<string, unknown>): void;
+    /**
+     * Get cached outputs for a node
+     * 获取节点的缓存输出
+     */
+    getOutputs(nodeId: string): Record<string, unknown> | undefined;
+    /**
+     * Clear output cache (call at start of new execution)
+     * 清除输出缓存（在新执行开始时调用）
+     */
+    clearOutputCache(): void;
+    /**
+     * Get a variable value
+     * 获取变量值
+     */
+    getVariable(name: string): unknown;
+    /**
+     * Set a variable value
+     * 设置变量值
+     */
+    setVariable(name: string, value: unknown): void;
+    /**
+     * Get all instance variables (for serialization)
+     * 获取所有实例变量（用于序列化）
+     */
+    getInstanceVariables(): Map<string, unknown>;
+    /**
+     * Set instance variables (for deserialization)
+     * 设置实例变量（用于反序列化）
+     */
+    setInstanceVariables(variables: Map<string, unknown>): void;
+    /**
+     * Clear global variables (for scene reset)
+     * 清除全局变量（用于场景重置）
+     */
+    static clearGlobalVariables(): void;
+}
+
+/**
+ * Node Registry - Manages node templates and executors
+ * 节点注册表 - 管理节点模板和执行器
+ */
+
+/**
+ * Node executor interface - implements the logic for a node type
+ * 节点执行器接口 - 实现节点类型的逻辑
+ */
+interface INodeExecutor {
+    /**
+     * Execute the node
+     * 执行节点
+     *
+     * @param node - Node instance (节点实例)
+     * @param context - Execution context (执行上下文)
+     * @returns Execution result (执行结果)
+     */
+    execute(node: BlueprintNode, context: ExecutionContext): ExecutionResult;
+}
+/**
+ * Node definition combines template with executor
+ * 节点定义组合模板和执行器
+ */
+interface NodeDefinition {
+    template: BlueprintNodeTemplate;
+    executor: INodeExecutor;
+}
+/**
+ * Node Registry - singleton that holds all registered node types
+ * 节点注册表 - 持有所有注册节点类型的单例
+ */
+declare class NodeRegistry {
+    private static _instance;
+    private _nodes;
+    private constructor();
+    static get instance(): NodeRegistry;
+    /**
+     * Register a node type
+     * 注册节点类型
+     */
+    register(template: BlueprintNodeTemplate, executor: INodeExecutor): void;
+    /**
+     * Get a node definition by type
+     * 通过类型获取节点定义
+     */
+    get(type: string): NodeDefinition | undefined;
+    /**
+     * Get node template by type
+     * 通过类型获取节点模板
+     */
+    getTemplate(type: string): BlueprintNodeTemplate | undefined;
+    /**
+     * Get node executor by type
+     * 通过类型获取节点执行器
+     */
+    getExecutor(type: string): INodeExecutor | undefined;
+    /**
+     * Check if a node type is registered
+     * 检查节点类型是否已注册
+     */
+    has(type: string): boolean;
+    /**
+     * Get all registered templates
+     * 获取所有注册的模板
+     */
+    getAllTemplates(): BlueprintNodeTemplate[];
+    /**
+     * Get templates by category
+     * 按类别获取模板
+     */
+    getTemplatesByCategory(category: string): BlueprintNodeTemplate[];
+    /**
+     * Search templates by keyword
+     * 按关键词搜索模板
+     */
+    searchTemplates(keyword: string): BlueprintNodeTemplate[];
+    /**
+     * Clear all registrations (for testing)
+     * 清除所有注册（用于测试）
+     */
+    clear(): void;
+}
+/**
+ * Decorator for registering node executors
+ * 用于注册节点执行器的装饰器
+ *
+ * @example
+ * ```typescript
+ * @RegisterNode(EventTickTemplate)
+ * class EventTickExecutor implements INodeExecutor {
+ *     execute(node, context) { ... }
+ * }
+ * ```
+ */
+declare function RegisterNode(template: BlueprintNodeTemplate): <T extends new () => INodeExecutor>(constructor: T) => T;
+
+/**
+ * Blueprint Virtual Machine - Executes blueprint graphs
+ * 蓝图虚拟机 - 执行蓝图图
+ */
+
+/**
+ * Event trigger types
+ * 事件触发类型
+ */
+type EventType = 'BeginPlay' | 'Tick' | 'EndPlay' | 'Collision' | 'TriggerEnter' | 'TriggerExit' | 'Custom';
+/**
+ * Blueprint Virtual Machine
+ * 蓝图虚拟机
+ */
+declare class BlueprintVM {
+    /** Execution context (执行上下文) */
+    private _context;
+    /** Pending executions (delayed nodes) (待处理的执行) */
+    private _pendingExecutions;
+    /** Event node cache by type (按类型缓存的事件节点) */
+    private _eventNodes;
+    /** Whether the VM is running (VM 是否运行中) */
+    private _isRunning;
+    /** Current execution time (当前执行时间) */
+    private _currentTime;
+    /** Maximum execution steps per frame (每帧最大执行步骤) */
+    private _maxStepsPerFrame;
+    /** Debug mode (调试模式) */
+    debug: boolean;
+    constructor(blueprint: BlueprintAsset, entity: Entity, scene: IScene);
+    get context(): ExecutionContext;
+    get isRunning(): boolean;
+    /**
+     * Cache event nodes by type for quick lookup
+     * 按类型缓存事件节点以便快速查找
+     */
+    private _cacheEventNodes;
+    /**
+     * Start the VM
+     * 启动 VM
+     */
+    start(): void;
+    /**
+     * Stop the VM
+     * 停止 VM
+     */
+    stop(): void;
+    /**
+     * Pause the VM
+     * 暂停 VM
+     */
+    pause(): void;
+    /**
+     * Resume the VM
+     * 恢复 VM
+     */
+    resume(): void;
+    /**
+     * Update the VM (called every frame)
+     * 更新 VM（每帧调用）
+     */
+    tick(deltaTime: number): void;
+    /**
+     * Trigger an event by type
+     * 按类型触发事件
+     */
+    triggerEvent(eventType: string, data?: Record<string, unknown>): void;
+    /**
+     * Trigger a custom event by name
+     * 按名称触发自定义事件
+     */
+    triggerCustomEvent(eventName: string, data?: Record<string, unknown>): void;
+    /**
+     * Execute from a starting node
+     * 从起始节点执行
+     */
+    private _executeFromNode;
+    /**
+     * Execute a single node
+     * 执行单个节点
+     */
+    private _executeNode;
+    /**
+     * Process pending delayed executions
+     * 处理待处理的延迟执行
+     */
+    private _processPendingExecutions;
+    /**
+     * Get instance variables for serialization
+     * 获取实例变量用于序列化
+     */
+    getInstanceVariables(): Map<string, unknown>;
+    /**
+     * Set instance variables from serialization
+     * 从序列化设置实例变量
+     */
+    setInstanceVariables(variables: Map<string, unknown>): void;
+}
+
+/**
+ * Blueprint Component - Attaches a blueprint to an entity
+ * 蓝图组件 - 将蓝图附加到实体
+ */
+
+/**
+ * Component interface for ECS integration
+ * 用于 ECS 集成的组件接口
+ */
+interface IBlueprintComponent {
+    /** Entity ID this component belongs to (此组件所属的实体ID) */
+    entityId: number | null;
+    /** Blueprint asset reference (蓝图资产引用) */
+    blueprintAsset: BlueprintAsset | null;
+    /** Blueprint asset path for serialization (用于序列化的蓝图资产路径) */
+    blueprintPath: string;
+    /** Auto-start execution when entity is created (实体创建时自动开始执行) */
+    autoStart: boolean;
+    /** Enable debug mode for VM (启用 VM 调试模式) */
+    debug: boolean;
+    /** Runtime VM instance (运行时 VM 实例) */
+    vm: BlueprintVM | null;
+    /** Whether the blueprint has started (蓝图是否已启动) */
+    isStarted: boolean;
+}
+/**
+ * Creates a blueprint component data object
+ * 创建蓝图组件数据对象
+ */
+declare function createBlueprintComponentData(): IBlueprintComponent;
+/**
+ * Initialize the VM for a blueprint component
+ * 为蓝图组件初始化 VM
+ */
+declare function initializeBlueprintVM(component: IBlueprintComponent, entity: Entity, scene: IScene): void;
+/**
+ * Start blueprint execution
+ * 开始蓝图执行
+ */
+declare function startBlueprint(component: IBlueprintComponent): void;
+/**
+ * Stop blueprint execution
+ * 停止蓝图执行
+ */
+declare function stopBlueprint(component: IBlueprintComponent): void;
+/**
+ * Update blueprint execution
+ * 更新蓝图执行
+ */
+declare function tickBlueprint(component: IBlueprintComponent, deltaTime: number): void;
+/**
+ * Clean up blueprint resources
+ * 清理蓝图资源
+ */
+declare function cleanupBlueprint(component: IBlueprintComponent): void;
+
+/**
+ * Blueprint Execution System - Manages blueprint lifecycle and execution
+ * 蓝图执行系统 - 管理蓝图生命周期和执行
+ */
+
+/**
+ * Blueprint system interface for engine integration
+ * 用于引擎集成的蓝图系统接口
+ */
+interface IBlueprintSystem {
+    /** Process entities with blueprint components (处理带有蓝图组件的实体) */
+    process(entities: IBlueprintEntity[], deltaTime: number): void;
+    /** Called when entity is added to system (实体添加到系统时调用) */
+    onEntityAdded(entity: IBlueprintEntity): void;
+    /** Called when entity is removed from system (实体从系统移除时调用) */
+    onEntityRemoved(entity: IBlueprintEntity): void;
+}
+/**
+ * Entity with blueprint component
+ * 带有蓝图组件的实体
+ */
+interface IBlueprintEntity extends Entity {
+    /** Blueprint component data (蓝图组件数据) */
+    blueprintComponent: IBlueprintComponent;
+}
+/**
+ * Creates a blueprint execution system
+ * 创建蓝图执行系统
+ */
+declare function createBlueprintSystem(scene: IScene): IBlueprintSystem;
+/**
+ * Utility to manually trigger blueprint events
+ * 手动触发蓝图事件的工具
+ */
+declare function triggerBlueprintEvent(entity: IBlueprintEntity, eventType: string, data?: Record<string, unknown>): void;
+/**
+ * Utility to trigger custom events by name
+ * 按名称触发自定义事件的工具
+ */
+declare function triggerCustomBlueprintEvent(entity: IBlueprintEntity, eventName: string, data?: Record<string, unknown>): void;
+
+/**
+ * @zh 蓝图触发器类型定义
+ * @en Blueprint Trigger Type Definitions
+ *
+ * @zh 定义触发器的核心类型和接口
+ * @en Defines core types and interfaces for triggers
+ */
+/**
+ * @zh 触发器类型枚举
+ * @en Trigger type enumeration
+ */
+type TriggerType = 'tick' | 'input' | 'collision' | 'message' | 'timer' | 'stateEnter' | 'stateExit' | 'custom';
+/**
+ * @zh 触发器类型常量
+ * @en Trigger type constants
+ */
+declare const TriggerTypes: {
+    readonly TICK: "tick";
+    readonly INPUT: "input";
+    readonly COLLISION: "collision";
+    readonly MESSAGE: "message";
+    readonly TIMER: "timer";
+    readonly STATE_ENTER: "stateEnter";
+    readonly STATE_EXIT: "stateExit";
+    readonly CUSTOM: "custom";
+};
+/**
+ * @zh 触发器上下文基础接口
+ * @en Trigger context base interface
+ */
+interface ITriggerContext {
+    /**
+     * @zh 触发器类型
+     * @en Trigger type
+     */
+    readonly type: TriggerType;
+    /**
+     * @zh 触发时间戳
+     * @en Trigger timestamp
+     */
+    readonly timestamp: number;
+    /**
+     * @zh 触发源实体 ID
+     * @en Source entity ID
+     */
+    readonly sourceEntityId?: string;
+    /**
+     * @zh 附加数据
+     * @en Additional data
+     */
+    readonly data?: Record<string, unknown>;
+}
+/**
+ * @zh Tick 触发器上下文
+ * @en Tick trigger context
+ */
+interface ITickTriggerContext extends ITriggerContext {
+    readonly type: 'tick';
+    /**
+     * @zh 增量时间（秒）
+     * @en Delta time (seconds)
+     */
+    readonly deltaTime: number;
+    /**
+     * @zh 帧计数
+     * @en Frame count
+     */
+    readonly frameCount: number;
+}
+/**
+ * @zh 输入触发器上下文
+ * @en Input trigger context
+ */
+interface IInputTriggerContext extends ITriggerContext {
+    readonly type: 'input';
+    /**
+     * @zh 输入动作名称
+     * @en Input action name
+     */
+    readonly action: string;
+    /**
+     * @zh 输入值
+     * @en Input value
+     */
+    readonly value: number | boolean;
+    /**
+     * @zh 是否刚按下
+     * @en Is just pressed
+     */
+    readonly pressed?: boolean;
+    /**
+     * @zh 是否刚释放
+     * @en Is just released
+     */
+    readonly released?: boolean;
+}
+/**
+ * @zh 碰撞触发器上下文
+ * @en Collision trigger context
+ */
+interface ICollisionTriggerContext extends ITriggerContext {
+    readonly type: 'collision';
+    /**
+     * @zh 碰撞的另一个实体 ID
+     * @en Other entity ID in collision
+     */
+    readonly otherEntityId: string;
+    /**
+     * @zh 碰撞点
+     * @en Collision point
+     */
+    readonly point?: {
+        x: number;
+        y: number;
+    };
+    /**
+     * @zh 碰撞法线
+     * @en Collision normal
+     */
+    readonly normal?: {
+        x: number;
+        y: number;
+    };
+    /**
+     * @zh 是否开始碰撞
+     * @en Is collision start
+     */
+    readonly isEnter: boolean;
+    /**
+     * @zh 是否结束碰撞
+     * @en Is collision end
+     */
+    readonly isExit: boolean;
+}
+/**
+ * @zh 消息触发器上下文
+ * @en Message trigger context
+ */
+interface IMessageTriggerContext extends ITriggerContext {
+    readonly type: 'message';
+    /**
+     * @zh 消息名称
+     * @en Message name
+     */
+    readonly messageName: string;
+    /**
+     * @zh 发送者 ID
+     * @en Sender ID
+     */
+    readonly senderId?: string;
+    /**
+     * @zh 消息负载
+     * @en Message payload
+     */
+    readonly payload?: unknown;
+}
+/**
+ * @zh 定时器触发器上下文
+ * @en Timer trigger context
+ */
+interface ITimerTriggerContext extends ITriggerContext {
+    readonly type: 'timer';
+    /**
+     * @zh 定时器 ID
+     * @en Timer ID
+     */
+    readonly timerId: string;
+    /**
+     * @zh 是否循环触发
+     * @en Is repeating
+     */
+    readonly isRepeating: boolean;
+    /**
+     * @zh 已触发次数
+     * @en Times fired
+     */
+    readonly timesFired: number;
+}
+/**
+ * @zh 状态触发器上下文
+ * @en State trigger context
+ */
+interface IStateTriggerContext extends ITriggerContext {
+    readonly type: 'stateEnter' | 'stateExit';
+    /**
+     * @zh 状态机 ID
+     * @en State machine ID
+     */
+    readonly stateMachineId: string;
+    /**
+     * @zh 当前状态
+     * @en Current state
+     */
+    readonly currentState: string;
+    /**
+     * @zh 之前状态
+     * @en Previous state
+     */
+    readonly previousState?: string;
+}
+/**
+ * @zh 自定义触发器上下文
+ * @en Custom trigger context
+ */
+interface ICustomTriggerContext extends ITriggerContext {
+    readonly type: 'custom';
+    /**
+     * @zh 事件名称
+     * @en Event name
+     */
+    readonly eventName: string;
+}
+/**
+ * @zh 所有触发器上下文的联合类型
+ * @en Union type of all trigger contexts
+ */
+type TriggerContext = ITickTriggerContext | IInputTriggerContext | ICollisionTriggerContext | IMessageTriggerContext | ITimerTriggerContext | IStateTriggerContext | ICustomTriggerContext;
+/**
+ * @zh 创建 Tick 触发器上下文
+ * @en Create tick trigger context
+ */
+declare function createTickContext(deltaTime: number, frameCount: number, sourceEntityId?: string): ITickTriggerContext;
+/**
+ * @zh 创建输入触发器上下文
+ * @en Create input trigger context
+ */
+declare function createInputContext(action: string, value: number | boolean, options?: {
+    pressed?: boolean;
+    released?: boolean;
+    sourceEntityId?: string;
+}): IInputTriggerContext;
+/**
+ * @zh 创建碰撞触发器上下文
+ * @en Create collision trigger context
+ */
+declare function createCollisionContext(otherEntityId: string, isEnter: boolean, options?: {
+    point?: {
+        x: number;
+        y: number;
+    };
+    normal?: {
+        x: number;
+        y: number;
+    };
+    sourceEntityId?: string;
+}): ICollisionTriggerContext;
+/**
+ * @zh 创建消息触发器上下文
+ * @en Create message trigger context
+ */
+declare function createMessageContext(messageName: string, payload?: unknown, options?: {
+    senderId?: string;
+    sourceEntityId?: string;
+}): IMessageTriggerContext;
+/**
+ * @zh 创建定时器触发器上下文
+ * @en Create timer trigger context
+ */
+declare function createTimerContext(timerId: string, isRepeating: boolean, timesFired: number, sourceEntityId?: string): ITimerTriggerContext;
+/**
+ * @zh 创建状态触发器上下文
+ * @en Create state trigger context
+ */
+declare function createStateContext(type: 'stateEnter' | 'stateExit', stateMachineId: string, currentState: string, previousState?: string, sourceEntityId?: string): IStateTriggerContext;
+/**
+ * @zh 创建自定义触发器上下文
+ * @en Create custom trigger context
+ */
+declare function createCustomContext(eventName: string, data?: Record<string, unknown>, sourceEntityId?: string): ICustomTriggerContext;
+
+/**
+ * @zh 触发器条件系统
+ * @en Trigger Condition System
+ *
+ * @zh 提供触发器触发前的条件检查能力
+ * @en Provides condition checking before trigger fires
+ */
+
+/**
+ * @zh 触发器条件接口
+ * @en Trigger condition interface
+ */
+interface ITriggerCondition {
+    /**
+     * @zh 条件类型标识
+     * @en Condition type identifier
+     */
+    readonly type: string;
+    /**
+     * @zh 评估条件是否满足
+     * @en Evaluate if condition is met
+     *
+     * @param context - @zh 触发器上下文 @en Trigger context
+     * @returns @zh 条件是否满足 @en Whether condition is met
+     */
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 条件组合逻辑
+ * @en Condition combination logic
+ */
+type ConditionLogic = 'and' | 'or';
+/**
+ * @zh 复合条件 - 组合多个条件
+ * @en Composite condition - combines multiple conditions
+ */
+declare class CompositeCondition implements ITriggerCondition {
+    private readonly _conditions;
+    private readonly _logic;
+    readonly type = "composite";
+    constructor(_conditions: ITriggerCondition[], _logic?: ConditionLogic);
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 非条件 - 取反
+ * @en Not condition - negates
+ */
+declare class NotCondition implements ITriggerCondition {
+    private readonly _condition;
+    readonly type = "not";
+    constructor(_condition: ITriggerCondition);
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 始终为真的条件
+ * @en Always true condition
+ */
+declare class AlwaysTrueCondition implements ITriggerCondition {
+    readonly type = "alwaysTrue";
+    evaluate(_context: ITriggerContext): boolean;
+}
+/**
+ * @zh 始终为假的条件
+ * @en Always false condition
+ */
+declare class AlwaysFalseCondition implements ITriggerCondition {
+    readonly type = "alwaysFalse";
+    evaluate(_context: ITriggerContext): boolean;
+}
+/**
+ * @zh 触发器类型条件
+ * @en Trigger type condition
+ */
+declare class TriggerTypeCondition implements ITriggerCondition {
+    private readonly _allowedTypes;
+    readonly type = "triggerType";
+    constructor(_allowedTypes: TriggerType[]);
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 实体 ID 条件
+ * @en Entity ID condition
+ */
+declare class EntityIdCondition implements ITriggerCondition {
+    private readonly _entityId;
+    private readonly _checkSource;
+    readonly type = "entityId";
+    constructor(_entityId: string, _checkSource?: boolean);
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 自定义函数条件
+ * @en Custom function condition
+ */
+declare class FunctionCondition implements ITriggerCondition {
+    private readonly _predicate;
+    readonly type = "function";
+    constructor(_predicate: (context: ITriggerContext) => boolean);
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 输入动作条件
+ * @en Input action condition
+ */
+declare class InputActionCondition implements ITriggerCondition {
+    private readonly _action;
+    private readonly _checkPressed?;
+    private readonly _checkReleased?;
+    readonly type = "inputAction";
+    constructor(_action: string, _checkPressed?: boolean | undefined, _checkReleased?: boolean | undefined);
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 消息名称条件
+ * @en Message name condition
+ */
+declare class MessageNameCondition implements ITriggerCondition {
+    private readonly _messageName;
+    readonly type = "messageName";
+    constructor(_messageName: string);
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 状态名称条件
+ * @en State name condition
+ */
+declare class StateNameCondition implements ITriggerCondition {
+    private readonly _stateName;
+    private readonly _checkCurrent;
+    readonly type = "stateName";
+    constructor(_stateName: string, _checkCurrent?: boolean);
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 定时器 ID 条件
+ * @en Timer ID condition
+ */
+declare class TimerIdCondition implements ITriggerCondition {
+    private readonly _timerId;
+    readonly type = "timerId";
+    constructor(_timerId: string);
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 碰撞实体条件
+ * @en Collision entity condition
+ */
+declare class CollisionEntityCondition implements ITriggerCondition {
+    private readonly _otherEntityId?;
+    private readonly _checkEnter?;
+    private readonly _checkExit?;
+    readonly type = "collisionEntity";
+    constructor(_otherEntityId?: string | undefined, _checkEnter?: boolean | undefined, _checkExit?: boolean | undefined);
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 自定义事件名称条件
+ * @en Custom event name condition
+ */
+declare class CustomEventCondition implements ITriggerCondition {
+    private readonly _eventName;
+    readonly type = "customEvent";
+    constructor(_eventName: string);
+    evaluate(context: ITriggerContext): boolean;
+}
+/**
+ * @zh 条件构建器 - 链式 API
+ * @en Condition builder - fluent API
+ */
+declare class ConditionBuilder {
+    private _conditions;
+    private _logic;
+    /**
+     * @zh 设置组合逻辑为 AND
+     * @en Set combination logic to AND
+     */
+    and(): this;
+    /**
+     * @zh 设置组合逻辑为 OR
+     * @en Set combination logic to OR
+     */
+    or(): this;
+    /**
+     * @zh 添加触发器类型条件
+     * @en Add trigger type condition
+     */
+    ofType(...types: TriggerType[]): this;
+    /**
+     * @zh 添加实体 ID 条件
+     * @en Add entity ID condition
+     */
+    fromEntity(entityId: string): this;
+    /**
+     * @zh 添加输入动作条件
+     * @en Add input action condition
+     */
+    onInput(action: string, options?: {
+        pressed?: boolean;
+        released?: boolean;
+    }): this;
+    /**
+     * @zh 添加消息条件
+     * @en Add message condition
+     */
+    onMessage(messageName: string): this;
+    /**
+     * @zh 添加状态条件
+     * @en Add state condition
+     */
+    onState(stateName: string, checkCurrent?: boolean): this;
+    /**
+     * @zh 添加定时器条件
+     * @en Add timer condition
+     */
+    onTimer(timerId: string): this;
+    /**
+     * @zh 添加碰撞条件
+     * @en Add collision condition
+     */
+    onCollision(options?: {
+        entityId?: string;
+        isEnter?: boolean;
+        isExit?: boolean;
+    }): this;
+    /**
+     * @zh 添加自定义事件条件
+     * @en Add custom event condition
+     */
+    onCustomEvent(eventName: string): this;
+    /**
+     * @zh 添加自定义函数条件
+     * @en Add custom function condition
+     */
+    where(predicate: (context: ITriggerContext) => boolean): this;
+    /**
+     * @zh 添加取反条件
+     * @en Add negated condition
+     */
+    not(condition: ITriggerCondition): this;
+    /**
+     * @zh 构建条件
+     * @en Build condition
+     */
+    build(): ITriggerCondition;
+}
+/**
+ * @zh 创建条件构建器
+ * @en Create condition builder
+ */
+declare function condition(): ConditionBuilder;
+
+/**
+ * @zh 蓝图触发器
+ * @en Blueprint Trigger
+ *
+ * @zh 定义触发器的核心实现
+ * @en Defines core trigger implementation
+ */
+
+/**
+ * @zh 触发器回调函数类型
+ * @en Trigger callback function type
+ */
+type TriggerCallback = (context: ITriggerContext) => void;
+/**
+ * @zh 蓝图触发器接口
+ * @en Blueprint trigger interface
+ */
+interface IBlueprintTrigger {
+    /**
+     * @zh 触发器唯一标识
+     * @en Trigger unique identifier
+     */
+    readonly id: string;
+    /**
+     * @zh 触发器类型
+     * @en Trigger type
+     */
+    readonly type: TriggerType;
+    /**
+     * @zh 触发器条件
+     * @en Trigger conditions
+     */
+    readonly condition: ITriggerCondition;
+    /**
+     * @zh 是否启用
+     * @en Is enabled
+     */
+    enabled: boolean;
+    /**
+     * @zh 优先级（越高越先执行）
+     * @en Priority (higher executes first)
+     */
+    readonly priority: number;
+    /**
+     * @zh 检查是否应该触发
+     * @en Check if should fire
+     */
+    shouldFire(context: ITriggerContext): boolean;
+    /**
+     * @zh 执行触发器
+     * @en Execute trigger
+     */
+    fire(context: ITriggerContext): void;
+}
+/**
+ * @zh 触发器配置
+ * @en Trigger configuration
+ */
+interface TriggerConfig {
+    /**
+     * @zh 触发器 ID
+     * @en Trigger ID
+     */
+    id?: string;
+    /**
+     * @zh 触发器类型
+     * @en Trigger type
+     */
+    type: TriggerType;
+    /**
+     * @zh 触发条件
+     * @en Trigger condition
+     */
+    condition?: ITriggerCondition;
+    /**
+     * @zh 是否启用
+     * @en Is enabled
+     */
+    enabled?: boolean;
+    /**
+     * @zh 优先级
+     * @en Priority
+     */
+    priority?: number;
+    /**
+     * @zh 回调函数
+     * @en Callback function
+     */
+    callback?: TriggerCallback;
+}
+/**
+ * @zh 蓝图触发器实现
+ * @en Blueprint trigger implementation
+ */
+declare class BlueprintTrigger implements IBlueprintTrigger {
+    readonly id: string;
+    readonly type: TriggerType;
+    readonly condition: ITriggerCondition;
+    readonly priority: number;
+    enabled: boolean;
+    private readonly _callback?;
+    private readonly _callbacks;
+    constructor(config: TriggerConfig);
+    /**
+     * @zh 检查是否应该触发
+     * @en Check if should fire
+     */
+    shouldFire(context: ITriggerContext): boolean;
+    /**
+     * @zh 执行触发器
+     * @en Execute trigger
+     */
+    fire(context: ITriggerContext): void;
+    /**
+     * @zh 添加回调
+     * @en Add callback
+     */
+    addCallback(callback: TriggerCallback): void;
+    /**
+     * @zh 移除回调
+     * @en Remove callback
+     */
+    removeCallback(callback: TriggerCallback): void;
+    /**
+     * @zh 清除所有回调
+     * @en Clear all callbacks
+     */
+    clearCallbacks(): void;
+}
+/**
+ * @zh 触发器注册表接口
+ * @en Trigger registry interface
+ */
+interface ITriggerRegistry {
+    /**
+     * @zh 注册触发器
+     * @en Register trigger
+     */
+    register(trigger: IBlueprintTrigger): void;
+    /**
+     * @zh 注销触发器
+     * @en Unregister trigger
+     */
+    unregister(triggerId: string): boolean;
+    /**
+     * @zh 获取触发器
+     * @en Get trigger
+     */
+    get(triggerId: string): IBlueprintTrigger | undefined;
+    /**
+     * @zh 获取所有触发器
+     * @en Get all triggers
+     */
+    getAll(): IBlueprintTrigger[];
+    /**
+     * @zh 按类型获取触发器
+     * @en Get triggers by type
+     */
+    getByType(type: TriggerType): IBlueprintTrigger[];
+    /**
+     * @zh 清除所有触发器
+     * @en Clear all triggers
+     */
+    clear(): void;
+}
+/**
+ * @zh 触发器注册表实现
+ * @en Trigger registry implementation
+ */
+declare class TriggerRegistry implements ITriggerRegistry {
+    private readonly _triggers;
+    private readonly _triggersByType;
+    /**
+     * @zh 注册触发器
+     * @en Register trigger
+     */
+    register(trigger: IBlueprintTrigger): void;
+    /**
+     * @zh 注销触发器
+     * @en Unregister trigger
+     */
+    unregister(triggerId: string): boolean;
+    /**
+     * @zh 获取触发器
+     * @en Get trigger
+     */
+    get(triggerId: string): IBlueprintTrigger | undefined;
+    /**
+     * @zh 获取所有触发器
+     * @en Get all triggers
+     */
+    getAll(): IBlueprintTrigger[];
+    /**
+     * @zh 按类型获取触发器
+     * @en Get triggers by type
+     */
+    getByType(type: TriggerType): IBlueprintTrigger[];
+    /**
+     * @zh 清除所有触发器
+     * @en Clear all triggers
+     */
+    clear(): void;
+    /**
+     * @zh 获取触发器数量
+     * @en Get trigger count
+     */
+    get count(): number;
+}
+/**
+ * @zh 创建触发器
+ * @en Create trigger
+ */
+declare function createTrigger(config: TriggerConfig): BlueprintTrigger;
+/**
+ * @zh 创建 Tick 触发器
+ * @en Create tick trigger
+ */
+declare function createTickTrigger(callback?: TriggerCallback, options?: {
+    id?: string;
+    condition?: ITriggerCondition;
+    priority?: number;
+}): BlueprintTrigger;
+/**
+ * @zh 创建输入触发器
+ * @en Create input trigger
+ */
+declare function createInputTrigger(callback?: TriggerCallback, options?: {
+    id?: string;
+    condition?: ITriggerCondition;
+    priority?: number;
+}): BlueprintTrigger;
+/**
+ * @zh 创建碰撞触发器
+ * @en Create collision trigger
+ */
+declare function createCollisionTrigger(callback?: TriggerCallback, options?: {
+    id?: string;
+    condition?: ITriggerCondition;
+    priority?: number;
+}): BlueprintTrigger;
+/**
+ * @zh 创建消息触发器
+ * @en Create message trigger
+ */
+declare function createMessageTrigger(callback?: TriggerCallback, options?: {
+    id?: string;
+    condition?: ITriggerCondition;
+    priority?: number;
+}): BlueprintTrigger;
+/**
+ * @zh 创建定时器触发器
+ * @en Create timer trigger
+ */
+declare function createTimerTrigger(callback?: TriggerCallback, options?: {
+    id?: string;
+    condition?: ITriggerCondition;
+    priority?: number;
+}): BlueprintTrigger;
+/**
+ * @zh 创建状态进入触发器
+ * @en Create state enter trigger
+ */
+declare function createStateEnterTrigger(callback?: TriggerCallback, options?: {
+    id?: string;
+    condition?: ITriggerCondition;
+    priority?: number;
+}): BlueprintTrigger;
+/**
+ * @zh 创建状态退出触发器
+ * @en Create state exit trigger
+ */
+declare function createStateExitTrigger(callback?: TriggerCallback, options?: {
+    id?: string;
+    condition?: ITriggerCondition;
+    priority?: number;
+}): BlueprintTrigger;
+/**
+ * @zh 创建自定义触发器
+ * @en Create custom trigger
+ */
+declare function createCustomTrigger(callback?: TriggerCallback, options?: {
+    id?: string;
+    condition?: ITriggerCondition;
+    priority?: number;
+}): BlueprintTrigger;
+
+/**
+ * @zh 触发器调度器
+ * @en Trigger Dispatcher
+ *
+ * @zh 负责分发触发器事件到订阅者
+ * @en Responsible for dispatching trigger events to subscribers
+ */
+
+/**
+ * @zh 触发结果
+ * @en Trigger result
+ */
+interface TriggerResult {
+    /**
+     * @zh 触发器 ID
+     * @en Trigger ID
+     */
+    triggerId: string;
+    /**
+     * @zh 是否成功
+     * @en Is successful
+     */
+    success: boolean;
+    /**
+     * @zh 错误信息
+     * @en Error message
+     */
+    error?: string;
+}
+/**
+ * @zh 调度结果
+ * @en Dispatch result
+ */
+interface DispatchResult {
+    /**
+     * @zh 上下文
+     * @en Context
+     */
+    context: ITriggerContext;
+    /**
+     * @zh 触发的触发器数量
+     * @en Number of triggers fired
+     */
+    triggeredCount: number;
+    /**
+     * @zh 各触发器结果
+     * @en Results of each trigger
+     */
+    results: TriggerResult[];
+}
+/**
+ * @zh 触发器调度器接口
+ * @en Trigger dispatcher interface
+ */
+interface ITriggerDispatcher {
+    /**
+     * @zh 调度触发器
+     * @en Dispatch trigger
+     */
+    dispatch(context: ITriggerContext): DispatchResult;
+    /**
+     * @zh 异步调度触发器
+     * @en Async dispatch trigger
+     */
+    dispatchAsync(context: ITriggerContext): Promise<DispatchResult>;
+    /**
+     * @zh 订阅触发器类型
+     * @en Subscribe to trigger type
+     */
+    subscribe(type: TriggerType, callback: TriggerCallback): () => void;
+    /**
+     * @zh 取消订阅
+     * @en Unsubscribe
+     */
+    unsubscribe(type: TriggerType, callback: TriggerCallback): void;
+    /**
+     * @zh 获取注册表
+     * @en Get registry
+     */
+    readonly registry: ITriggerRegistry;
+}
+/**
+ * @zh 触发器调度器实现
+ * @en Trigger dispatcher implementation
+ */
+declare class TriggerDispatcher implements ITriggerDispatcher {
+    private readonly _registry;
+    private readonly _typeSubscribers;
+    private readonly _globalSubscribers;
+    private _isDispatching;
+    private _pendingContexts;
+    constructor(registry?: ITriggerRegistry);
+    get registry(): ITriggerRegistry;
+    /**
+     * @zh 调度触发器
+     * @en Dispatch trigger
+     */
+    dispatch(context: ITriggerContext): DispatchResult;
+    /**
+     * @zh 执行调度
+     * @en Do dispatch
+     */
+    private _doDispatch;
+    /**
+     * @zh 通知订阅者
+     * @en Notify subscribers
+     */
+    private _notifySubscribers;
+    /**
+     * @zh 异步调度触发器
+     * @en Async dispatch trigger
+     */
+    dispatchAsync(context: ITriggerContext): Promise<DispatchResult>;
+    /**
+     * @zh 订阅触发器类型
+     * @en Subscribe to trigger type
+     */
+    subscribe(type: TriggerType, callback: TriggerCallback): () => void;
+    /**
+     * @zh 取消订阅
+     * @en Unsubscribe
+     */
+    unsubscribe(type: TriggerType, callback: TriggerCallback): void;
+    /**
+     * @zh 订阅所有触发器
+     * @en Subscribe to all triggers
+     */
+    subscribeAll(callback: TriggerCallback): () => void;
+    /**
+     * @zh 取消订阅所有
+     * @en Unsubscribe from all
+     */
+    unsubscribeAll(callback: TriggerCallback): void;
+    /**
+     * @zh 清除所有订阅
+     * @en Clear all subscriptions
+     */
+    clearSubscriptions(): void;
+}
+/**
+ * @zh 实体触发器管理器接口
+ * @en Entity trigger manager interface
+ */
+interface IEntityTriggerManager {
+    /**
+     * @zh 为实体注册触发器
+     * @en Register trigger for entity
+     */
+    registerForEntity(entityId: string, trigger: IBlueprintTrigger): void;
+    /**
+     * @zh 注销实体的触发器
+     * @en Unregister trigger from entity
+     */
+    unregisterFromEntity(entityId: string, triggerId: string): boolean;
+    /**
+     * @zh 获取实体的所有触发器
+     * @en Get all triggers for entity
+     */
+    getEntityTriggers(entityId: string): IBlueprintTrigger[];
+    /**
+     * @zh 清除实体的所有触发器
+     * @en Clear all triggers for entity
+     */
+    clearEntityTriggers(entityId: string): void;
+    /**
+     * @zh 调度器
+     * @en Dispatcher
+     */
+    readonly dispatcher: ITriggerDispatcher;
+}
+/**
+ * @zh 实体触发器管理器实现
+ * @en Entity trigger manager implementation
+ */
+declare class EntityTriggerManager implements IEntityTriggerManager {
+    private readonly _dispatcher;
+    private readonly _entityTriggers;
+    constructor(dispatcher?: ITriggerDispatcher);
+    get dispatcher(): ITriggerDispatcher;
+    /**
+     * @zh 为实体注册触发器
+     * @en Register trigger for entity
+     */
+    registerForEntity(entityId: string, trigger: IBlueprintTrigger): void;
+    /**
+     * @zh 注销实体的触发器
+     * @en Unregister trigger from entity
+     */
+    unregisterFromEntity(entityId: string, triggerId: string): boolean;
+    /**
+     * @zh 获取实体的所有触发器
+     * @en Get all triggers for entity
+     */
+    getEntityTriggers(entityId: string): IBlueprintTrigger[];
+    /**
+     * @zh 清除实体的所有触发器
+     * @en Clear all triggers for entity
+     */
+    clearEntityTriggers(entityId: string): void;
+    /**
+     * @zh 调度触发器到实体
+     * @en Dispatch trigger to entity
+     */
+    dispatchToEntity(entityId: string, context: ITriggerContext): DispatchResult;
+}
+/**
+ * @zh 创建触发器调度器
+ * @en Create trigger dispatcher
+ */
+declare function createTriggerDispatcher(registry?: ITriggerRegistry): TriggerDispatcher;
+/**
+ * @zh 创建实体触发器管理器
+ * @en Create entity trigger manager
+ */
+declare function createEntityTriggerManager(dispatcher?: ITriggerDispatcher): EntityTriggerManager;
+
+/**
+ * @zh 蓝图片段接口和实现
+ * @en Blueprint Fragment Interface and Implementation
+ *
+ * @zh 定义可重用的蓝图片段，用于组合系统
+ * @en Defines reusable blueprint fragments for the composition system
+ */
+
+/**
+ * @zh 暴露引脚定义
+ * @en Exposed pin definition
+ *
+ * @zh 片段对外暴露的引脚，可与其他片段连接
+ * @en Pins exposed by the fragment that can be connected to other fragments
+ */
+interface ExposedPin {
+    /**
+     * @zh 引脚名称
+     * @en Pin name
+     */
+    readonly name: string;
+    /**
+     * @zh 显示名称
+     * @en Display name
+     */
+    readonly displayName: string;
+    /**
+     * @zh 引脚类型
+     * @en Pin type
+     */
+    readonly type: BlueprintPinType;
+    /**
+     * @zh 引脚方向
+     * @en Pin direction
+     */
+    readonly direction: 'input' | 'output';
+    /**
+     * @zh 描述
+     * @en Description
+     */
+    readonly description?: string;
+    /**
+     * @zh 默认值（仅输入引脚）
+     * @en Default value (input pins only)
+     */
+    readonly defaultValue?: unknown;
+    /**
+     * @zh 关联的内部节点 ID
+     * @en Associated internal node ID
+     */
+    readonly internalNodeId: string;
+    /**
+     * @zh 关联的内部引脚名称
+     * @en Associated internal pin name
+     */
+    readonly internalPinName: string;
+}
+/**
+ * @zh 蓝图片段接口
+ * @en Blueprint fragment interface
+ *
+ * @zh 代表一个可重用的蓝图逻辑单元，如技能、卡牌效果等
+ * @en Represents a reusable unit of blueprint logic, such as skills, card effects, etc.
+ */
+interface IBlueprintFragment {
+    /**
+     * @zh 片段唯一标识
+     * @en Fragment unique identifier
+     */
+    readonly id: string;
+    /**
+     * @zh 片段名称
+     * @en Fragment name
+     */
+    readonly name: string;
+    /**
+     * @zh 片段描述
+     * @en Fragment description
+     */
+    readonly description?: string;
+    /**
+     * @zh 片段分类
+     * @en Fragment category
+     */
+    readonly category?: string;
+    /**
+     * @zh 片段标签
+     * @en Fragment tags
+     */
+    readonly tags?: string[];
+    /**
+     * @zh 暴露的输入引脚
+     * @en Exposed input pins
+     */
+    readonly inputs: ExposedPin[];
+    /**
+     * @zh 暴露的输出引脚
+     * @en Exposed output pins
+     */
+    readonly outputs: ExposedPin[];
+    /**
+     * @zh 内部蓝图图
+     * @en Internal blueprint graph
+     */
+    readonly graph: BlueprintAsset;
+    /**
+     * @zh 片段版本
+     * @en Fragment version
+     */
+    readonly version?: string;
+    /**
+     * @zh 图标名称
+     * @en Icon name
+     */
+    readonly icon?: string;
+    /**
+     * @zh 颜色（用于可视化）
+     * @en Color (for visualization)
+     */
+    readonly color?: string;
+}
+/**
+ * @zh 蓝图片段配置
+ * @en Blueprint fragment configuration
+ */
+interface BlueprintFragmentConfig {
+    id: string;
+    name: string;
+    description?: string;
+    category?: string;
+    tags?: string[];
+    inputs?: ExposedPin[];
+    outputs?: ExposedPin[];
+    graph: BlueprintAsset;
+    version?: string;
+    icon?: string;
+    color?: string;
+}
+/**
+ * @zh 蓝图片段实现
+ * @en Blueprint fragment implementation
+ */
+declare class BlueprintFragment implements IBlueprintFragment {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly category?: string;
+    readonly tags?: string[];
+    readonly inputs: ExposedPin[];
+    readonly outputs: ExposedPin[];
+    readonly graph: BlueprintAsset;
+    readonly version?: string;
+    readonly icon?: string;
+    readonly color?: string;
+    constructor(config: BlueprintFragmentConfig);
+    /**
+     * @zh 获取所有暴露引脚
+     * @en Get all exposed pins
+     */
+    getAllExposedPins(): ExposedPin[];
+    /**
+     * @zh 通过名称查找输入引脚
+     * @en Find input pin by name
+     */
+    findInput(name: string): ExposedPin | undefined;
+    /**
+     * @zh 通过名称查找输出引脚
+     * @en Find output pin by name
+     */
+    findOutput(name: string): ExposedPin | undefined;
+}
+/**
+ * @zh 创建暴露引脚
+ * @en Create exposed pin
+ */
+declare function createExposedPin(name: string, type: BlueprintPinType, direction: 'input' | 'output', internalNodeId: string, internalPinName: string, options?: {
+    displayName?: string;
+    description?: string;
+    defaultValue?: unknown;
+}): ExposedPin;
+/**
+ * @zh 创建蓝图片段
+ * @en Create blueprint fragment
+ */
+declare function createFragment(config: BlueprintFragmentConfig): IBlueprintFragment;
+/**
+ * @zh 蓝图片段资产格式
+ * @en Blueprint fragment asset format
+ *
+ * @zh 用于序列化和反序列化片段
+ * @en Used for serializing and deserializing fragments
+ */
+interface BlueprintFragmentAsset {
+    /**
+     * @zh 格式版本
+     * @en Format version
+     */
+    version: number;
+    /**
+     * @zh 资产类型标识
+     * @en Asset type identifier
+     */
+    type: 'blueprint-fragment';
+    /**
+     * @zh 片段数据
+     * @en Fragment data
+     */
+    fragment: {
+        id: string;
+        name: string;
+        description?: string;
+        category?: string;
+        tags?: string[];
+        inputs: ExposedPin[];
+        outputs: ExposedPin[];
+        version?: string;
+        icon?: string;
+        color?: string;
+    };
+    /**
+     * @zh 内部蓝图图
+     * @en Internal blueprint graph
+     */
+    graph: BlueprintAsset;
+}
+/**
+ * @zh 从资产创建片段
+ * @en Create fragment from asset
+ */
+declare function fragmentFromAsset(asset: BlueprintFragmentAsset): IBlueprintFragment;
+/**
+ * @zh 将片段转为资产
+ * @en Convert fragment to asset
+ */
+declare function fragmentToAsset(fragment: IBlueprintFragment): BlueprintFragmentAsset;
+
+/**
+ * @zh 蓝图组合器接口和实现
+ * @en Blueprint Composer Interface and Implementation
+ *
+ * @zh 将多个蓝图片段组合成一个完整的蓝图
+ * @en Composes multiple blueprint fragments into a complete blueprint
+ */
+
+/**
+ * @zh 片段槽位
+ * @en Fragment slot
+ *
+ * @zh 组合器中放置片段的位置
+ * @en A position in the composer where a fragment is placed
+ */
+interface FragmentSlot {
+    /**
+     * @zh 槽位 ID
+     * @en Slot ID
+     */
+    readonly id: string;
+    /**
+     * @zh 槽位名称
+     * @en Slot name
+     */
+    readonly name: string;
+    /**
+     * @zh 放置的片段
+     * @en Placed fragment
+     */
+    readonly fragment: IBlueprintFragment;
+    /**
+     * @zh 在组合图中的位置偏移
+     * @en Position offset in the composed graph
+     */
+    readonly position: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * @zh 槽位间连接
+ * @en Connection between slots
+ */
+interface SlotConnection {
+    /**
+     * @zh 连接 ID
+     * @en Connection ID
+     */
+    readonly id: string;
+    /**
+     * @zh 源槽位 ID
+     * @en Source slot ID
+     */
+    readonly fromSlotId: string;
+    /**
+     * @zh 源引脚名称
+     * @en Source pin name
+     */
+    readonly fromPin: string;
+    /**
+     * @zh 目标槽位 ID
+     * @en Target slot ID
+     */
+    readonly toSlotId: string;
+    /**
+     * @zh 目标引脚名称
+     * @en Target pin name
+     */
+    readonly toPin: string;
+}
+/**
+ * @zh 蓝图组合器接口
+ * @en Blueprint composer interface
+ *
+ * @zh 用于将多个蓝图片段组合成一个完整蓝图
+ * @en Used to compose multiple blueprint fragments into a complete blueprint
+ */
+interface IBlueprintComposer {
+    /**
+     * @zh 组合器名称
+     * @en Composer name
+     */
+    readonly name: string;
+    /**
+     * @zh 获取所有槽位
+     * @en Get all slots
+     */
+    getSlots(): FragmentSlot[];
+    /**
+     * @zh 获取所有连接
+     * @en Get all connections
+     */
+    getConnections(): SlotConnection[];
+    /**
+     * @zh 添加片段到槽位
+     * @en Add fragment to slot
+     *
+     * @param fragment - @zh 蓝图片段 @en Blueprint fragment
+     * @param slotId - @zh 槽位 ID @en Slot ID
+     * @param options - @zh 选项 @en Options
+     */
+    addFragment(fragment: IBlueprintFragment, slotId: string, options?: {
+        name?: string;
+        position?: {
+            x: number;
+            y: number;
+        };
+    }): void;
+    /**
+     * @zh 移除槽位
+     * @en Remove slot
+     *
+     * @param slotId - @zh 槽位 ID @en Slot ID
+     */
+    removeSlot(slotId: string): void;
+    /**
+     * @zh 连接两个槽位的引脚
+     * @en Connect pins between two slots
+     *
+     * @param fromSlotId - @zh 源槽位 ID @en Source slot ID
+     * @param fromPin - @zh 源引脚名称 @en Source pin name
+     * @param toSlotId - @zh 目标槽位 ID @en Target slot ID
+     * @param toPin - @zh 目标引脚名称 @en Target pin name
+     */
+    connect(fromSlotId: string, fromPin: string, toSlotId: string, toPin: string): void;
+    /**
+     * @zh 断开连接
+     * @en Disconnect
+     *
+     * @param connectionId - @zh 连接 ID @en Connection ID
+     */
+    disconnect(connectionId: string): void;
+    /**
+     * @zh 验证组合是否有效
+     * @en Validate if the composition is valid
+     */
+    validate(): CompositionValidationResult;
+    /**
+     * @zh 编译成蓝图资产
+     * @en Compile into blueprint asset
+     */
+    compile(): BlueprintAsset;
+    /**
+     * @zh 清空组合器
+     * @en Clear the composer
+     */
+    clear(): void;
+}
+/**
+ * @zh 组合验证结果
+ * @en Composition validation result
+ */
+interface CompositionValidationResult {
+    /**
+     * @zh 是否有效
+     * @en Whether valid
+     */
+    readonly isValid: boolean;
+    /**
+     * @zh 错误列表
+     * @en Error list
+     */
+    readonly errors: CompositionError[];
+    /**
+     * @zh 警告列表
+     * @en Warning list
+     */
+    readonly warnings: CompositionWarning[];
+}
+/**
+ * @zh 组合错误
+ * @en Composition error
+ */
+interface CompositionError {
+    readonly type: 'missing-connection' | 'type-mismatch' | 'cycle-detected' | 'invalid-slot';
+    readonly message: string;
+    readonly slotId?: string;
+    readonly pinName?: string;
+}
+/**
+ * @zh 组合警告
+ * @en Composition warning
+ */
+interface CompositionWarning {
+    readonly type: 'unused-output' | 'unconnected-input';
+    readonly message: string;
+    readonly slotId?: string;
+    readonly pinName?: string;
+}
+/**
+ * @zh 蓝图组合器实现
+ * @en Blueprint composer implementation
+ */
+declare class BlueprintComposer implements IBlueprintComposer {
+    readonly name: string;
+    private slots;
+    private connections;
+    private connectionIdCounter;
+    constructor(name: string);
+    getSlots(): FragmentSlot[];
+    getConnections(): SlotConnection[];
+    addFragment(fragment: IBlueprintFragment, slotId: string, options?: {
+        name?: string;
+        position?: {
+            x: number;
+            y: number;
+        };
+    }): void;
+    removeSlot(slotId: string): void;
+    connect(fromSlotId: string, fromPin: string, toSlotId: string, toPin: string): void;
+    disconnect(connectionId: string): void;
+    validate(): CompositionValidationResult;
+    compile(): BlueprintAsset;
+    clear(): void;
+}
+/**
+ * @zh 创建蓝图组合器
+ * @en Create blueprint composer
+ */
+declare function createComposer(name: string): IBlueprintComposer;
+/**
+ * @zh 蓝图组合资产格式
+ * @en Blueprint composition asset format
+ */
+interface BlueprintCompositionAsset {
+    /**
+     * @zh 格式版本
+     * @en Format version
+     */
+    version: number;
+    /**
+     * @zh 资产类型标识
+     * @en Asset type identifier
+     */
+    type: 'blueprint-composition';
+    /**
+     * @zh 组合名称
+     * @en Composition name
+     */
+    name: string;
+    /**
+     * @zh 槽位数据
+     * @en Slot data
+     */
+    slots: Array<{
+        id: string;
+        name: string;
+        fragmentId: string;
+        position: {
+            x: number;
+            y: number;
+        };
+    }>;
+    /**
+     * @zh 连接数据
+     * @en Connection data
+     */
+    connections: SlotConnection[];
+}
+
+/**
+ * @zh 片段注册表
+ * @en Fragment Registry
+ *
+ * @zh 管理和查询蓝图片段
+ * @en Manages and queries blueprint fragments
+ */
+
+/**
+ * @zh 片段过滤器
+ * @en Fragment filter
+ */
+interface FragmentFilter {
+    /**
+     * @zh 按分类过滤
+     * @en Filter by category
+     */
+    category?: string;
+    /**
+     * @zh 按标签过滤（任意匹配）
+     * @en Filter by tags (any match)
+     */
+    tags?: string[];
+    /**
+     * @zh 按名称搜索
+     * @en Search by name
+     */
+    search?: string;
+}
+/**
+ * @zh 片段注册表接口
+ * @en Fragment registry interface
+ */
+interface IFragmentRegistry {
+    /**
+     * @zh 注册片段
+     * @en Register fragment
+     */
+    register(fragment: IBlueprintFragment): void;
+    /**
+     * @zh 注销片段
+     * @en Unregister fragment
+     */
+    unregister(id: string): void;
+    /**
+     * @zh 获取片段
+     * @en Get fragment
+     */
+    get(id: string): IBlueprintFragment | undefined;
+    /**
+     * @zh 检查片段是否存在
+     * @en Check if fragment exists
+     */
+    has(id: string): boolean;
+    /**
+     * @zh 获取所有片段
+     * @en Get all fragments
+     */
+    getAll(): IBlueprintFragment[];
+    /**
+     * @zh 按条件过滤片段
+     * @en Filter fragments by criteria
+     */
+    filter(filter: FragmentFilter): IBlueprintFragment[];
+    /**
+     * @zh 获取所有分类
+     * @en Get all categories
+     */
+    getCategories(): string[];
+    /**
+     * @zh 获取所有标签
+     * @en Get all tags
+     */
+    getTags(): string[];
+    /**
+     * @zh 清空注册表
+     * @en Clear registry
+     */
+    clear(): void;
+}
+/**
+ * @zh 片段注册表实现
+ * @en Fragment registry implementation
+ */
+declare class FragmentRegistry implements IFragmentRegistry {
+    private fragments;
+    register(fragment: IBlueprintFragment): void;
+    unregister(id: string): void;
+    get(id: string): IBlueprintFragment | undefined;
+    has(id: string): boolean;
+    getAll(): IBlueprintFragment[];
+    filter(filter: FragmentFilter): IBlueprintFragment[];
+    getCategories(): string[];
+    getTags(): string[];
+    clear(): void;
+    /**
+     * @zh 获取片段数量
+     * @en Get fragment count
+     */
+    get size(): number;
+}
+/**
+ * @zh 默认片段注册表实例
+ * @en Default fragment registry instance
+ */
+declare const defaultFragmentRegistry: FragmentRegistry;
+/**
+ * @zh 创建片段注册表
+ * @en Create fragment registry
+ */
+declare function createFragmentRegistry(): IFragmentRegistry;
+
+/**
+ * Blueprint Plugin for ES Engine.
+ * ES引擎的蓝图插件。
+ *
+ * Provides visual scripting runtime support.
+ * 提供可视化脚本运行时支持。
+ */
+
+/**
+ * Blueprint Plugin.
+ * 蓝图插件。
+ */
+declare const BlueprintPlugin: IRuntimePlugin;
+
+export { AlwaysFalseCondition, AlwaysTrueCondition, type BlueprintAsset, BlueprintComposer, type BlueprintCompositionAsset, type BlueprintConnection, BlueprintFragment, type BlueprintFragmentAsset, type BlueprintFragmentConfig, type BlueprintMetadata, type BlueprintNode, type BlueprintNodeCategory, type BlueprintNodeTemplate, type BlueprintPin, type BlueprintPinDefinition, type BlueprintPinDirection, type BlueprintPinType, BlueprintPlugin, type BlueprintRuntimePin, BlueprintTrigger, BlueprintVM, type BlueprintVariable, CollisionEntityCondition, CompositeCondition, type CompositionError, type CompositionValidationResult, type CompositionWarning, ConditionBuilder, type ConditionLogic, CustomEventCondition, type DispatchResult, EntityIdCondition, EntityTriggerManager, type EventType, ExecutionContext, type ExecutionResult, type ExposedPin, type FragmentFilter, FragmentRegistry, type FragmentSlot, FunctionCondition, type IBlueprintComponent, type IBlueprintComposer, type IBlueprintEntity, type IBlueprintFragment, type IBlueprintSystem, type IBlueprintTrigger, type ICollisionTriggerContext, type ICustomTriggerContext, type IEntityTriggerManager, type IFragmentRegistry, type IInputTriggerContext, type IMessageTriggerContext, type INodeExecutor, type IStateTriggerContext, type ITickTriggerContext, type ITimerTriggerContext, type ITriggerCondition, type ITriggerContext, type ITriggerDispatcher, type ITriggerRegistry, InputActionCondition, MessageNameCondition, type NodeDefinition, NodeRegistry, NotCondition, RegisterNode, type SlotConnection, StateNameCondition, TimerIdCondition, type TriggerCallback, type TriggerConfig, type TriggerContext, TriggerDispatcher, TriggerRegistry, type TriggerResult, type TriggerType, TriggerTypeCondition, TriggerTypes, type VariableScope, arePinTypesCompatible, cleanupBlueprint, condition, createBlueprintComponentData, createBlueprintSystem, createCollisionContext, createCollisionTrigger, createComposer, createCustomContext, createCustomTrigger, createEmptyBlueprint, createEntityTriggerManager, createExposedPin, createFragment, createFragmentRegistry, createInputContext, createInputTrigger, createMessageContext, createMessageTrigger, createStateContext, createStateEnterTrigger, createStateExitTrigger, createTickContext, createTickTrigger, createTimerContext, createTimerTrigger, createTrigger, createTriggerDispatcher, defaultFragmentRegistry, fragmentFromAsset, fragmentToAsset, getNodeCategoryColor, getPinTypeColor, initializeBlueprintVM, startBlueprint, stopBlueprint, tickBlueprint, triggerBlueprintEvent, triggerCustomBlueprintEvent, validateBlueprintAsset };