Function defineBehaviorTree

defineBehaviorTree<BB extends object>(
id: string,
config: { blackboard: BB; root: BehaviorTreeNode<BB> },
): BehaviorTreeDefinition<BB>
Define a behavior tree with a typed blackboard.

The blackboard value serves as both the type source and the default initial state shallow-copied for each entity via createBehaviorTree. Nested objects and arrays remain shared unless an entity-specific override replaces them; provide fresh mutable nested values when entities need independent state.
Type Parameters
- BB extends object
Parameters
- id: string
  Unique identifier for this tree definition
- config: { blackboard: BB; root: BehaviorTreeNode<BB> }
  { blackboard, root } — default blackboard + root node
Returns BehaviorTreeDefinition<BB>
Frozen BehaviorTreeDefinition
Example
```
const tree = defineBehaviorTree('patrol', {
  blackboard: { targetId: null as number | null, timer: 0 },
  root: selector([
    guard(ctx => ctx.blackboard.targetId !== null, action('chase', ...)),
    action('wander', ...),
  ]),
});
```
- Defined in plugins/ai/behavior-tree.ts:318