@esengine/behavior-tree 4.0.0 → 4.1.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _esengine_ecs_framework from '@esengine/ecs-framework';
-import { Component, IService, Entity, EntitySystem, ServiceContainer } from '@esengine/ecs-framework';
+import { Component, IService, Entity, EntitySystem, ServiceContainer, IPlugin, Core, IScene } from '@esengine/ecs-framework';
 
 /**
  * Behavior Tree Constants
@@ -2009,4 +2009,86 @@ declare const BlackboardTypes: Record<BlackboardValueType, BlackboardTypeDefinit
  */
 declare const BehaviorTreeSystemToken: _esengine_ecs_framework.ServiceToken<BehaviorTreeExecutionSystem>;
 
-export { AbortType, AlwaysFailExecutor, AlwaysSucceedExecutor, type AssetMetadata, type AssetValidationResult, type BehaviorNodeConfigData, type BehaviorNodeData, type BehaviorTreeAsset, BehaviorTreeAssetManager, BehaviorTreeAssetSerializer, BehaviorTreeAssetType, BehaviorTreeAssetValidator, BehaviorTreeBuilder, type BehaviorTreeData, BehaviorTreeExecutionSystem, type BehaviorTreeNodeData, BehaviorTreeRuntimeComponent, type BehaviorTreeSerializationFormat, BehaviorTreeStarter, BehaviorTreeSystemToken, BindingHelper, BlackboardCompare, BlackboardExists, type BlackboardTypeDefinition, BlackboardTypes, BlackboardValueType$1 as BlackboardValueType, type BlackboardVariable, type BlackboardVariableDefinition, CompositeType, ConditionalExecutor, type ConfigFieldDefinition, CooldownExecutor, DecoratorType, type DeserializationOptions, type EditorConnection$1 as EditorConnection, type EditorFormat, EditorFormatConverter, type EditorNode$1 as EditorNode, type EditorNodeData, type EditorNodeTemplate, EditorToBehaviorTreeDataConverter, ExecuteAction, ExecuteCondition, type GlobalBlackboardConfig, GlobalBlackboardService, type IBTAssetManager, type IBehaviorTreeAssetContent, type INodeExecutor, type IServiceExecutor, InverterExecutor, LogAction, ModifyBlackboardValue, type NodeDataJSON, type NodeExecutionContext, NodeExecutorMetadata, NodeExecutorRegistry, type NodeMetadata, NodeMetadataRegistry, NodePropertyType, type NodeRuntimeState, type NodeTemplate, NodeTemplates, NodeType, ParallelExecutor, ParallelSelectorExecutor, type PropertyBinding, type PropertyDefinition, RandomProbability, RandomSelectorExecutor, RandomSequenceExecutor, RepeaterExecutor, RootExecutor, SelectorExecutor, SequenceExecutor, type SerializationOptions, ServiceDecorator, ServiceRegistry, SetBlackboardValue, SubTreeExecutor, TaskStatus, TimeoutExecutor, UntilFailExecutor, UntilSuccessExecutor, WaitAction, createDefaultRuntimeState };
+/**
+ * @zh 行为树插件
+ * @en Behavior Tree Plugin
+ *
+ * @zh 为 ECS 框架提供行为树支持的插件。
+ * 可与任何基于 @esengine/ecs-framework 的引擎集成（Cocos、Laya、Node.js 等）。
+ *
+ * @en Plugin that provides behavior tree support for ECS framework.
+ * Can be integrated with any engine based on @esengine/ecs-framework (Cocos, Laya, Node.js, etc.).
+ *
+ * @example
+ * ```typescript
+ * import { Core, Scene } from '@esengine/ecs-framework';
+ * import { BehaviorTreePlugin, BehaviorTreeBuilder, BehaviorTreeStarter } from '@esengine/behavior-tree';
+ *
+ * // Initialize
+ * Core.create();
+ * const plugin = new BehaviorTreePlugin();
+ * await Core.installPlugin(plugin);
+ *
+ * // Setup scene
+ * const scene = new Scene();
+ * plugin.setupScene(scene);
+ * Core.setScene(scene);
+ *
+ * // Create and start behavior tree
+ * const tree = BehaviorTreeBuilder.create('MyAI')
+ *     .selector('Root')
+ *         .log('Hello from behavior tree!')
+ *     .end()
+ *     .build();
+ *
+ * const entity = scene.createEntity('AIEntity');
+ * BehaviorTreeStarter.start(entity, tree);
+ * ```
+ */
+declare class BehaviorTreePlugin implements IPlugin {
+    /**
+     * @zh 插件名称
+     * @en Plugin name
+     */
+    readonly name = "@esengine/behavior-tree";
+    /**
+     * @zh 插件版本
+     * @en Plugin version
+     */
+    readonly version = "1.0.0";
+    /**
+     * @zh 插件依赖
+     * @en Plugin dependencies
+     */
+    readonly dependencies: readonly string[];
+    private _services;
+    /**
+     * @zh 安装插件
+     * @en Install plugin
+     *
+     * @param _core - Core 实例
+     * @param services - 服务容器
+     */
+    install(_core: Core, services: ServiceContainer): void;
+    /**
+     * @zh 卸载插件
+     * @en Uninstall plugin
+     */
+    uninstall(): void;
+    /**
+     * @zh 设置场景，添加行为树执行系统
+     * @en Setup scene, add behavior tree execution system
+     *
+     * @param scene - 要设置的场景
+     *
+     * @example
+     * ```typescript
+     * const scene = new Scene();
+     * plugin.setupScene(scene);
+     * Core.setScene(scene);
+     * ```
+     */
+    setupScene(scene: IScene): void;
+}
+
+export { AbortType, AlwaysFailExecutor, AlwaysSucceedExecutor, type AssetMetadata, type AssetValidationResult, type BehaviorNodeConfigData, type BehaviorNodeData, type BehaviorTreeAsset, BehaviorTreeAssetManager, BehaviorTreeAssetSerializer, BehaviorTreeAssetType, BehaviorTreeAssetValidator, BehaviorTreeBuilder, type BehaviorTreeData, BehaviorTreeExecutionSystem, type BehaviorTreeNodeData, BehaviorTreePlugin, BehaviorTreeRuntimeComponent, type BehaviorTreeSerializationFormat, BehaviorTreeStarter, BehaviorTreeSystemToken, BindingHelper, BlackboardCompare, BlackboardExists, type BlackboardTypeDefinition, BlackboardTypes, BlackboardValueType$1 as BlackboardValueType, type BlackboardVariable, type BlackboardVariableDefinition, CompositeType, ConditionalExecutor, type ConfigFieldDefinition, CooldownExecutor, DecoratorType, type DeserializationOptions, type EditorConnection$1 as EditorConnection, type EditorFormat, EditorFormatConverter, type EditorNode$1 as EditorNode, type EditorNodeData, type EditorNodeTemplate, EditorToBehaviorTreeDataConverter, ExecuteAction, ExecuteCondition, type GlobalBlackboardConfig, GlobalBlackboardService, type IBTAssetManager, type IBehaviorTreeAssetContent, type INodeExecutor, type IServiceExecutor, InverterExecutor, LogAction, ModifyBlackboardValue, type NodeDataJSON, type NodeExecutionContext, NodeExecutorMetadata, NodeExecutorRegistry, type NodeMetadata, NodeMetadataRegistry, NodePropertyType, type NodeRuntimeState, type NodeTemplate, NodeTemplates, NodeType, ParallelExecutor, ParallelSelectorExecutor, type PropertyBinding, type PropertyDefinition, RandomProbability, RandomSelectorExecutor, RandomSequenceExecutor, RepeaterExecutor, RootExecutor, SelectorExecutor, SequenceExecutor, type SerializationOptions, ServiceDecorator, ServiceRegistry, SetBlackboardValue, SubTreeExecutor, TaskStatus, TimeoutExecutor, UntilFailExecutor, UntilSuccessExecutor, WaitAction, createDefaultRuntimeState };

package/dist/index.js

@@ -4634,6 +4634,80 @@ var BlackboardTypes = {
 // src/tokens.ts
 import { createServiceToken } from "@esengine/ecs-framework";
 var BehaviorTreeSystemToken = createServiceToken("behaviorTreeSystem");
+
+// src/BehaviorTreePlugin.ts
+var _BehaviorTreePlugin = class _BehaviorTreePlugin {
+  constructor() {
+    /**
+     * @zh 插件名称
+     * @en Plugin name
+     */
+    __publicField(this, "name", "@esengine/behavior-tree");
+    /**
+     * @zh 插件版本
+     * @en Plugin version
+     */
+    __publicField(this, "version", "1.0.0");
+    /**
+     * @zh 插件依赖
+     * @en Plugin dependencies
+     */
+    __publicField(this, "dependencies", []);
+    __publicField(this, "_services", null);
+  }
+  /**
+   * @zh 安装插件
+   * @en Install plugin
+   *
+   * @param _core - Core 实例
+   * @param services - 服务容器
+   */
+  install(_core, services) {
+    this._services = services;
+    if (!services.isRegistered(GlobalBlackboardService)) {
+      services.registerSingleton(GlobalBlackboardService);
+    }
+    if (!services.isRegistered(BehaviorTreeAssetManager)) {
+      services.registerSingleton(BehaviorTreeAssetManager);
+    }
+  }
+  /**
+   * @zh 卸载插件
+   * @en Uninstall plugin
+   */
+  uninstall() {
+    if (this._services) {
+      const assetManager = this._services.tryResolve(BehaviorTreeAssetManager);
+      if (assetManager) {
+        assetManager.dispose();
+      }
+      const blackboardService = this._services.tryResolve(GlobalBlackboardService);
+      if (blackboardService) {
+        blackboardService.dispose();
+      }
+    }
+    this._services = null;
+  }
+  /**
+   * @zh 设置场景，添加行为树执行系统
+   * @en Setup scene, add behavior tree execution system
+   *
+   * @param scene - 要设置的场景
+   *
+   * @example
+   * ```typescript
+   * const scene = new Scene();
+   * plugin.setupScene(scene);
+   * Core.setScene(scene);
+   * ```
+   */
+  setupScene(scene) {
+    const system = new BehaviorTreeExecutionSystem(this._services ?? void 0);
+    scene.addSystem(system);
+  }
+};
+__name(_BehaviorTreePlugin, "BehaviorTreePlugin");
+var BehaviorTreePlugin = _BehaviorTreePlugin;
 export {
   AbortType,
   AlwaysFailExecutor,
@@ -4644,6 +4718,7 @@ export {
   BehaviorTreeAssetValidator,
   BehaviorTreeBuilder,
   BehaviorTreeExecutionSystem,
+  BehaviorTreePlugin,
   BehaviorTreeRuntimeComponent,
   BehaviorTreeStarter,
   BehaviorTreeSystemToken,