@esengine/spatial 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,843 @@
+import { IVector2 } from '@esengine/ecs-framework-math';
+import * as _esengine_ecs_framework from '@esengine/ecs-framework';
+import { BlueprintNodeTemplate, INodeExecutor, BlueprintNode, ExecutionResult } from '@esengine/blueprint';
+
+/**
+ * @zh 空间查询接口
+ * @en Spatial Query Interface
+ *
+ * @zh 提供空间查询的核心抽象
+ * @en Provides core abstractions for spatial queries
+ */
+
+/**
+ * @zh 空间边界框
+ * @en Spatial bounding box
+ */
+interface IBounds {
+    /**
+     * @zh 最小 X 坐标
+     * @en Minimum X coordinate
+     */
+    readonly minX: number;
+    /**
+     * @zh 最小 Y 坐标
+     * @en Minimum Y coordinate
+     */
+    readonly minY: number;
+    /**
+     * @zh 最大 X 坐标
+     * @en Maximum X coordinate
+     */
+    readonly maxX: number;
+    /**
+     * @zh 最大 Y 坐标
+     * @en Maximum Y coordinate
+     */
+    readonly maxY: number;
+}
+/**
+ * @zh 可定位对象接口
+ * @en Positionable object interface
+ */
+interface IPositionable {
+    /**
+     * @zh 获取对象位置
+     * @en Get object position
+     */
+    readonly position: IVector2;
+}
+/**
+ * @zh 可定位且有边界的对象接口
+ * @en Positionable object with bounds interface
+ */
+interface IBoundable extends IPositionable {
+    /**
+     * @zh 获取对象边界
+     * @en Get object bounds
+     */
+    readonly bounds: IBounds;
+}
+/**
+ * @zh 射线检测结果
+ * @en Raycast hit result
+ */
+interface IRaycastHit<T> {
+    /**
+     * @zh 命中的对象
+     * @en Hit object
+     */
+    readonly target: T;
+    /**
+     * @zh 命中点
+     * @en Hit point
+     */
+    readonly point: IVector2;
+    /**
+     * @zh 命中点的法线
+     * @en Normal at hit point
+     */
+    readonly normal: IVector2;
+    /**
+     * @zh 距离射线起点的距离
+     * @en Distance from ray origin
+     */
+    readonly distance: number;
+}
+/**
+ * @zh 过滤器函数类型
+ * @en Filter function type
+ */
+type SpatialFilter<T> = (item: T) => boolean;
+/**
+ * @zh 空间查询接口
+ * @en Spatial query interface
+ *
+ * @zh 提供空间查询能力，支持范围查询、最近邻查询和射线检测
+ * @en Provides spatial query capabilities including range queries, nearest neighbor queries, and raycasting
+ */
+interface ISpatialQuery<T> {
+    /**
+     * @zh 查找半径内的所有对象
+     * @en Find all objects within radius
+     *
+     * @param center - @zh 中心点 @en Center point
+     * @param radius - @zh 半径 @en Radius
+     * @param filter - @zh 过滤函数 @en Filter function
+     * @returns @zh 半径内的对象数组 @en Array of objects within radius
+     */
+    findInRadius(center: IVector2, radius: number, filter?: SpatialFilter<T>): T[];
+    /**
+     * @zh 查找矩形区域内的所有对象
+     * @en Find all objects within rectangle
+     *
+     * @param bounds - @zh 边界框 @en Bounding box
+     * @param filter - @zh 过滤函数 @en Filter function
+     * @returns @zh 区域内的对象数组 @en Array of objects within bounds
+     */
+    findInRect(bounds: IBounds, filter?: SpatialFilter<T>): T[];
+    /**
+     * @zh 查找最近的对象
+     * @en Find nearest object
+     *
+     * @param center - @zh 查询中心点 @en Query center point
+     * @param maxDistance - @zh 最大搜索距离 @en Maximum search distance
+     * @param filter - @zh 过滤函数 @en Filter function
+     * @returns @zh 最近的对象，没有则返回 null @en Nearest object or null
+     */
+    findNearest(center: IVector2, maxDistance?: number, filter?: SpatialFilter<T>): T | null;
+    /**
+     * @zh 查找最近的 K 个对象
+     * @en Find K nearest objects
+     *
+     * @param center - @zh 查询中心点 @en Query center point
+     * @param k - @zh 返回的对象数量 @en Number of objects to return
+     * @param maxDistance - @zh 最大搜索距离 @en Maximum search distance
+     * @param filter - @zh 过滤函数 @en Filter function
+     * @returns @zh 最近的 K 个对象数组 @en Array of K nearest objects
+     */
+    findKNearest(center: IVector2, k: number, maxDistance?: number, filter?: SpatialFilter<T>): T[];
+    /**
+     * @zh 射线检测
+     * @en Raycast
+     *
+     * @param origin - @zh 射线起点 @en Ray origin
+     * @param direction - @zh 射线方向（应归一化）@en Ray direction (should be normalized)
+     * @param maxDistance - @zh 最大检测距离 @en Maximum detection distance
+     * @param filter - @zh 过滤函数 @en Filter function
+     * @returns @zh 命中结果数组，按距离排序 @en Array of hit results sorted by distance
+     */
+    raycast(origin: IVector2, direction: IVector2, maxDistance: number, filter?: SpatialFilter<T>): IRaycastHit<T>[];
+    /**
+     * @zh 射线检测（仅返回第一个命中）
+     * @en Raycast (return first hit only)
+     *
+     * @param origin - @zh 射线起点 @en Ray origin
+     * @param direction - @zh 射线方向（应归一化）@en Ray direction (should be normalized)
+     * @param maxDistance - @zh 最大检测距离 @en Maximum detection distance
+     * @param filter - @zh 过滤函数 @en Filter function
+     * @returns @zh 第一个命中结果，没有则返回 null @en First hit result or null
+     */
+    raycastFirst(origin: IVector2, direction: IVector2, maxDistance: number, filter?: SpatialFilter<T>): IRaycastHit<T> | null;
+}
+/**
+ * @zh 空间索引接口
+ * @en Spatial index interface
+ *
+ * @zh 提供空间索引的管理能力
+ * @en Provides spatial index management capabilities
+ */
+interface ISpatialIndex<T> extends ISpatialQuery<T> {
+    /**
+     * @zh 插入对象
+     * @en Insert object
+     *
+     * @param item - @zh 要插入的对象 @en Object to insert
+     * @param position - @zh 对象位置 @en Object position
+     */
+    insert(item: T, position: IVector2): void;
+    /**
+     * @zh 移除对象
+     * @en Remove object
+     *
+     * @param item - @zh 要移除的对象 @en Object to remove
+     * @returns @zh 是否成功移除 @en Whether removal was successful
+     */
+    remove(item: T): boolean;
+    /**
+     * @zh 更新对象位置
+     * @en Update object position
+     *
+     * @param item - @zh 要更新的对象 @en Object to update
+     * @param newPosition - @zh 新位置 @en New position
+     * @returns @zh 是否成功更新 @en Whether update was successful
+     */
+    update(item: T, newPosition: IVector2): boolean;
+    /**
+     * @zh 清空索引
+     * @en Clear index
+     */
+    clear(): void;
+    /**
+     * @zh 获取索引中的对象数量
+     * @en Get number of objects in index
+     */
+    readonly count: number;
+    /**
+     * @zh 获取所有对象
+     * @en Get all objects
+     */
+    getAll(): T[];
+}
+/**
+ * @zh 创建边界框
+ * @en Create bounding box
+ */
+declare function createBounds(minX: number, minY: number, maxX: number, maxY: number): IBounds;
+/**
+ * @zh 从中心点和尺寸创建边界框
+ * @en Create bounding box from center and size
+ */
+declare function createBoundsFromCenter(center: IVector2, width: number, height: number): IBounds;
+/**
+ * @zh 从圆形创建边界框
+ * @en Create bounding box from circle
+ */
+declare function createBoundsFromCircle(center: IVector2, radius: number): IBounds;
+/**
+ * @zh 检查点是否在边界框内
+ * @en Check if point is inside bounds
+ */
+declare function isPointInBounds(point: IVector2, bounds: IBounds): boolean;
+/**
+ * @zh 检查两个边界框是否相交
+ * @en Check if two bounding boxes intersect
+ */
+declare function boundsIntersect(a: IBounds, b: IBounds): boolean;
+/**
+ * @zh 检查边界框是否与圆形相交
+ * @en Check if bounds intersects with circle
+ */
+declare function boundsIntersectsCircle(bounds: IBounds, center: IVector2, radius: number): boolean;
+/**
+ * @zh 计算两点之间的距离平方
+ * @en Calculate squared distance between two points
+ */
+declare function distanceSquared(a: IVector2, b: IVector2): number;
+/**
+ * @zh 计算两点之间的距离
+ * @en Calculate distance between two points
+ */
+declare function distance(a: IVector2, b: IVector2): number;
+
+/**
+ * @zh 网格空间索引
+ * @en Grid Spatial Index
+ *
+ * @zh 基于均匀网格的空间索引实现
+ * @en Uniform grid based spatial index implementation
+ */
+
+/**
+ * @zh 网格空间索引配置
+ * @en Grid spatial index configuration
+ */
+interface GridSpatialIndexConfig {
+    /**
+     * @zh 网格单元格大小
+     * @en Grid cell size
+     */
+    cellSize: number;
+}
+/**
+ * @zh 网格空间索引实现
+ * @en Grid spatial index implementation
+ *
+ * @zh 使用均匀网格进行空间划分，适合对象分布均匀的场景
+ * @en Uses uniform grid for spatial partitioning, suitable for evenly distributed objects
+ */
+declare class GridSpatialIndex<T> implements ISpatialIndex<T> {
+    private readonly _cellSize;
+    private readonly _cells;
+    private readonly _itemMap;
+    constructor(config: GridSpatialIndexConfig);
+    get count(): number;
+    /**
+     * @zh 插入对象
+     * @en Insert object
+     */
+    insert(item: T, position: IVector2): void;
+    /**
+     * @zh 移除对象
+     * @en Remove object
+     */
+    remove(item: T): boolean;
+    /**
+     * @zh 更新对象位置
+     * @en Update object position
+     */
+    update(item: T, newPosition: IVector2): boolean;
+    /**
+     * @zh 清空索引
+     * @en Clear index
+     */
+    clear(): void;
+    /**
+     * @zh 获取所有对象
+     * @en Get all objects
+     */
+    getAll(): T[];
+    /**
+     * @zh 查找半径内的所有对象
+     * @en Find all objects within radius
+     */
+    findInRadius(center: IVector2, radius: number, filter?: SpatialFilter<T>): T[];
+    /**
+     * @zh 查找矩形区域内的所有对象
+     * @en Find all objects within rectangle
+     */
+    findInRect(bounds: IBounds, filter?: SpatialFilter<T>): T[];
+    /**
+     * @zh 查找最近的对象
+     * @en Find nearest object
+     */
+    findNearest(center: IVector2, maxDistance?: number, filter?: SpatialFilter<T>): T | null;
+    /**
+     * @zh 查找最近的 K 个对象
+     * @en Find K nearest objects
+     */
+    findKNearest(center: IVector2, k: number, maxDistance?: number, filter?: SpatialFilter<T>): T[];
+    /**
+     * @zh 射线检测
+     * @en Raycast
+     */
+    raycast(origin: IVector2, direction: IVector2, maxDistance: number, filter?: SpatialFilter<T>): IRaycastHit<T>[];
+    /**
+     * @zh 射线检测（仅返回第一个命中）
+     * @en Raycast (return first hit only)
+     */
+    raycastFirst(origin: IVector2, direction: IVector2, maxDistance: number, filter?: SpatialFilter<T>): IRaycastHit<T> | null;
+    private _getCellKey;
+    private _getCellCoords;
+    private _addToCell;
+    private _removeFromCell;
+    private _forEachInBounds;
+    private _getRayBounds;
+    private _rayIntersectsPoint;
+}
+/**
+ * @zh 创建网格空间索引
+ * @en Create grid spatial index
+ */
+declare function createGridSpatialIndex<T>(cellSize?: number): GridSpatialIndex<T>;
+
+/**
+ * @zh AOI (Area of Interest) 兴趣区域接口
+ * @en AOI (Area of Interest) Interface
+ *
+ * @zh 提供 MMO 游戏中的兴趣区域管理能力
+ * @en Provides area of interest management for MMO games
+ */
+
+/**
+ * @zh AOI 事件类型
+ * @en AOI event type
+ */
+type AOIEventType = 'enter' | 'exit' | 'update';
+/**
+ * @zh AOI 事件
+ * @en AOI event
+ */
+interface IAOIEvent<T> {
+    /**
+     * @zh 事件类型
+     * @en Event type
+     */
+    readonly type: AOIEventType;
+    /**
+     * @zh 观察者（谁看到了变化）
+     * @en Observer (who saw the change)
+     */
+    readonly observer: T;
+    /**
+     * @zh 目标（发生变化的对象）
+     * @en Target (the object that changed)
+     */
+    readonly target: T;
+    /**
+     * @zh 目标位置
+     * @en Target position
+     */
+    readonly position: IVector2;
+}
+/**
+ * @zh AOI 事件监听器
+ * @en AOI event listener
+ */
+type AOIEventListener<T> = (event: IAOIEvent<T>) => void;
+/**
+ * @zh AOI 观察者配置
+ * @en AOI observer configuration
+ */
+interface IAOIObserverConfig {
+    /**
+     * @zh 视野范围
+     * @en View range
+     */
+    viewRange: number;
+    /**
+     * @zh 是否是可被观察的对象（默认 true）
+     * @en Whether this observer can be observed by others (default true)
+     */
+    observable?: boolean;
+}
+/**
+ * @zh AOI 管理器接口
+ * @en AOI manager interface
+ *
+ * @zh 管理兴趣区域，追踪对象的进入/离开事件
+ * @en Manages areas of interest, tracking enter/exit events for objects
+ *
+ * @typeParam T - @zh 被管理对象的类型 @en Type of managed objects
+ */
+interface IAOIManager<T> {
+    /**
+     * @zh 添加观察者
+     * @en Add observer
+     *
+     * @param entity - @zh 实体对象 @en Entity object
+     * @param position - @zh 初始位置 @en Initial position
+     * @param config - @zh 观察者配置 @en Observer configuration
+     */
+    addObserver(entity: T, position: IVector2, config: IAOIObserverConfig): void;
+    /**
+     * @zh 移除观察者
+     * @en Remove observer
+     *
+     * @param entity - @zh 实体对象 @en Entity object
+     * @returns @zh 是否成功移除 @en Whether removal was successful
+     */
+    removeObserver(entity: T): boolean;
+    /**
+     * @zh 更新观察者位置
+     * @en Update observer position
+     *
+     * @param entity - @zh 实体对象 @en Entity object
+     * @param newPosition - @zh 新位置 @en New position
+     * @returns @zh 是否成功更新 @en Whether update was successful
+     */
+    updatePosition(entity: T, newPosition: IVector2): boolean;
+    /**
+     * @zh 更新观察者视野范围
+     * @en Update observer view range
+     *
+     * @param entity - @zh 实体对象 @en Entity object
+     * @param newRange - @zh 新视野范围 @en New view range
+     * @returns @zh 是否成功更新 @en Whether update was successful
+     */
+    updateViewRange(entity: T, newRange: number): boolean;
+    /**
+     * @zh 获取实体视野内的所有对象
+     * @en Get all objects within entity's view
+     *
+     * @param entity - @zh 观察者实体 @en Observer entity
+     * @returns @zh 视野内的对象数组 @en Array of objects within view
+     */
+    getEntitiesInView(entity: T): T[];
+    /**
+     * @zh 获取能看到指定实体的所有观察者
+     * @en Get all observers who can see the specified entity
+     *
+     * @param entity - @zh 目标实体 @en Target entity
+     * @returns @zh 能看到目标的观察者数组 @en Array of observers who can see target
+     */
+    getObserversOf(entity: T): T[];
+    /**
+     * @zh 检查观察者是否能看到目标
+     * @en Check if observer can see target
+     *
+     * @param observer - @zh 观察者 @en Observer
+     * @param target - @zh 目标 @en Target
+     * @returns @zh 是否在视野内 @en Whether target is in view
+     */
+    canSee(observer: T, target: T): boolean;
+    /**
+     * @zh 添加事件监听器
+     * @en Add event listener
+     *
+     * @param listener - @zh 监听器函数 @en Listener function
+     */
+    addListener(listener: AOIEventListener<T>): void;
+    /**
+     * @zh 移除事件监听器
+     * @en Remove event listener
+     *
+     * @param listener - @zh 监听器函数 @en Listener function
+     */
+    removeListener(listener: AOIEventListener<T>): void;
+    /**
+     * @zh 为特定观察者添加事件监听器
+     * @en Add event listener for specific observer
+     *
+     * @param entity - @zh 观察者实体 @en Observer entity
+     * @param listener - @zh 监听器函数 @en Listener function
+     */
+    addEntityListener(entity: T, listener: AOIEventListener<T>): void;
+    /**
+     * @zh 移除特定观察者的事件监听器
+     * @en Remove event listener for specific observer
+     *
+     * @param entity - @zh 观察者实体 @en Observer entity
+     * @param listener - @zh 监听器函数 @en Listener function
+     */
+    removeEntityListener(entity: T, listener: AOIEventListener<T>): void;
+    /**
+     * @zh 清空所有观察者
+     * @en Clear all observers
+     */
+    clear(): void;
+    /**
+     * @zh 获取观察者数量
+     * @en Get observer count
+     */
+    readonly count: number;
+}
+
+/**
+ * @zh 网格 AOI 实现
+ * @en Grid AOI Implementation
+ *
+ * @zh 基于均匀网格的兴趣区域管理实现
+ * @en Uniform grid based area of interest management implementation
+ */
+
+/**
+ * @zh 网格 AOI 配置
+ * @en Grid AOI configuration
+ */
+interface GridAOIConfig {
+    /**
+     * @zh 网格单元格大小（建议设置为平均视野范围的 1-2 倍）
+     * @en Grid cell size (recommended 1-2x average view range)
+     */
+    cellSize: number;
+}
+/**
+ * @zh 网格 AOI 实现
+ * @en Grid AOI implementation
+ *
+ * @zh 使用均匀网格进行空间划分，高效管理大量实体的兴趣区域
+ * @en Uses uniform grid for spatial partitioning, efficiently managing AOI for many entities
+ */
+declare class GridAOI<T> implements IAOIManager<T> {
+    private readonly _cellSize;
+    private readonly _cells;
+    private readonly _observers;
+    private readonly _globalListeners;
+    constructor(config: GridAOIConfig);
+    get count(): number;
+    /**
+     * @zh 添加观察者
+     * @en Add observer
+     */
+    addObserver(entity: T, position: IVector2, config: IAOIObserverConfig): void;
+    /**
+     * @zh 移除观察者
+     * @en Remove observer
+     */
+    removeObserver(entity: T): boolean;
+    /**
+     * @zh 更新观察者位置
+     * @en Update observer position
+     */
+    updatePosition(entity: T, newPosition: IVector2): boolean;
+    /**
+     * @zh 更新观察者视野范围
+     * @en Update observer view range
+     */
+    updateViewRange(entity: T, newRange: number): boolean;
+    /**
+     * @zh 获取实体视野内的所有对象
+     * @en Get all objects within entity's view
+     */
+    getEntitiesInView(entity: T): T[];
+    /**
+     * @zh 获取能看到指定实体的所有观察者
+     * @en Get all observers who can see the specified entity
+     */
+    getObserversOf(entity: T): T[];
+    /**
+     * @zh 检查观察者是否能看到目标
+     * @en Check if observer can see target
+     */
+    canSee(observer: T, target: T): boolean;
+    /**
+     * @zh 添加全局事件监听器
+     * @en Add global event listener
+     */
+    addListener(listener: AOIEventListener<T>): void;
+    /**
+     * @zh 移除全局事件监听器
+     * @en Remove global event listener
+     */
+    removeListener(listener: AOIEventListener<T>): void;
+    /**
+     * @zh 为特定观察者添加事件监听器
+     * @en Add event listener for specific observer
+     */
+    addEntityListener(entity: T, listener: AOIEventListener<T>): void;
+    /**
+     * @zh 移除特定观察者的事件监听器
+     * @en Remove event listener for specific observer
+     */
+    removeEntityListener(entity: T, listener: AOIEventListener<T>): void;
+    /**
+     * @zh 清空所有观察者
+     * @en Clear all observers
+     */
+    clear(): void;
+    private _getCellKey;
+    private _getCellCoords;
+    private _addToCell;
+    private _removeFromCell;
+    /**
+     * @zh 更新观察者的可见实体列表
+     * @en Update observer's visible entities list
+     */
+    private _updateVisibility;
+    /**
+     * @zh 更新其他观察者对于某个实体的可见性
+     * @en Update other observers' visibility of an entity
+     */
+    private _updateObserversOfEntity;
+    /**
+     * @zh 获取最大视野范围（用于优化搜索）
+     * @en Get maximum view range (for search optimization)
+     */
+    private _getMaxViewRange;
+    /**
+     * @zh 发送事件
+     * @en Emit event
+     */
+    private _emitEvent;
+}
+/**
+ * @zh 创建网格 AOI 管理器
+ * @en Create grid AOI manager
+ *
+ * @param cellSize - @zh 网格单元格大小 @en Grid cell size
+ */
+declare function createGridAOI<T>(cellSize?: number): GridAOI<T>;
+
+/**
+ * @zh 空间索引服务令牌
+ * @en Spatial index service token
+ *
+ * @zh 用于注入空间索引服务
+ * @en Used for injecting spatial index service
+ */
+declare const SpatialIndexToken: _esengine_ecs_framework.ServiceToken<ISpatialIndex<unknown>>;
+/**
+ * @zh 空间查询服务令牌
+ * @en Spatial query service token
+ *
+ * @zh 用于注入空间查询服务（只读）
+ * @en Used for injecting spatial query service (read-only)
+ */
+declare const SpatialQueryToken: _esengine_ecs_framework.ServiceToken<ISpatialQuery<unknown>>;
+/**
+ * @zh AOI 管理器服务令牌
+ * @en AOI manager service token
+ *
+ * @zh 用于注入 AOI 兴趣区域管理服务
+ * @en Used for injecting AOI (Area of Interest) manager service
+ */
+declare const AOIManagerToken: _esengine_ecs_framework.ServiceToken<IAOIManager<unknown>>;
+
+/**
+ * @zh 空间查询蓝图节点
+ * @en Spatial Query Blueprint Nodes
+ *
+ * @zh 提供空间查询功能的蓝图节点
+ * @en Provides blueprint nodes for spatial query functionality
+ */
+
+/**
+ * @zh FindInRadius 节点模板
+ * @en FindInRadius node template
+ */
+declare const FindInRadiusTemplate: BlueprintNodeTemplate;
+/**
+ * @zh FindInRadius 节点执行器
+ * @en FindInRadius node executor
+ */
+declare class FindInRadiusExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh FindInRect 节点模板
+ * @en FindInRect node template
+ */
+declare const FindInRectTemplate: BlueprintNodeTemplate;
+/**
+ * @zh FindInRect 节点执行器
+ * @en FindInRect node executor
+ */
+declare class FindInRectExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh FindNearest 节点模板
+ * @en FindNearest node template
+ */
+declare const FindNearestTemplate: BlueprintNodeTemplate;
+/**
+ * @zh FindNearest 节点执行器
+ * @en FindNearest node executor
+ */
+declare class FindNearestExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh FindKNearest 节点模板
+ * @en FindKNearest node template
+ */
+declare const FindKNearestTemplate: BlueprintNodeTemplate;
+/**
+ * @zh FindKNearest 节点执行器
+ * @en FindKNearest node executor
+ */
+declare class FindKNearestExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh Raycast 节点模板
+ * @en Raycast node template
+ */
+declare const RaycastTemplate: BlueprintNodeTemplate;
+/**
+ * @zh Raycast 节点执行器
+ * @en Raycast node executor
+ */
+declare class RaycastExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh RaycastFirst 节点模板
+ * @en RaycastFirst node template
+ */
+declare const RaycastFirstTemplate: BlueprintNodeTemplate;
+/**
+ * @zh RaycastFirst 节点执行器
+ * @en RaycastFirst node executor
+ */
+declare class RaycastFirstExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh 空间查询节点定义
+ * @en Spatial query node definitions
+ */
+declare const SpatialQueryNodeDefinitions: {
+    template: BlueprintNodeTemplate;
+    executor: FindInRadiusExecutor;
+}[];
+
+/**
+ * @zh AOI 蓝图节点
+ * @en AOI Blueprint Nodes
+ *
+ * @zh 提供 AOI 功能的蓝图节点
+ * @en Provides blueprint nodes for AOI functionality
+ */
+
+/**
+ * @zh GetEntitiesInView 节点模板
+ * @en GetEntitiesInView node template
+ */
+declare const GetEntitiesInViewTemplate: BlueprintNodeTemplate;
+/**
+ * @zh GetEntitiesInView 节点执行器
+ * @en GetEntitiesInView node executor
+ */
+declare class GetEntitiesInViewExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh GetObserversOf 节点模板
+ * @en GetObserversOf node template
+ */
+declare const GetObserversOfTemplate: BlueprintNodeTemplate;
+/**
+ * @zh GetObserversOf 节点执行器
+ * @en GetObserversOf node executor
+ */
+declare class GetObserversOfExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh CanSee 节点模板
+ * @en CanSee node template
+ */
+declare const CanSeeTemplate: BlueprintNodeTemplate;
+/**
+ * @zh CanSee 节点执行器
+ * @en CanSee node executor
+ */
+declare class CanSeeExecutor implements INodeExecutor {
+    execute(node: BlueprintNode, context: unknown): ExecutionResult;
+}
+/**
+ * @zh OnEntityEnterView 事件节点模板
+ * @en OnEntityEnterView event node template
+ */
+declare const OnEntityEnterViewTemplate: BlueprintNodeTemplate;
+/**
+ * @zh OnEntityEnterView 事件执行器
+ * @en OnEntityEnterView event executor
+ */
+declare class OnEntityEnterViewExecutor implements INodeExecutor {
+    execute(_node: BlueprintNode, _context: unknown): ExecutionResult;
+}
+/**
+ * @zh OnEntityExitView 事件节点模板
+ * @en OnEntityExitView event node template
+ */
+declare const OnEntityExitViewTemplate: BlueprintNodeTemplate;
+/**
+ * @zh OnEntityExitView 事件执行器
+ * @en OnEntityExitView event executor
+ */
+declare class OnEntityExitViewExecutor implements INodeExecutor {
+    execute(_node: BlueprintNode, _context: unknown): ExecutionResult;
+}
+/**
+ * @zh AOI 节点定义集合
+ * @en AOI node definition collection
+ */
+declare const AOINodeDefinitions: {
+    templates: BlueprintNodeTemplate[];
+    executors: Map<string, INodeExecutor>;
+};
+
+export { type AOIEventListener, type AOIEventType, AOIManagerToken, AOINodeDefinitions, CanSeeExecutor, CanSeeTemplate, FindInRadiusExecutor, FindInRadiusTemplate, FindInRectExecutor, FindInRectTemplate, FindKNearestExecutor, FindKNearestTemplate, FindNearestExecutor, FindNearestTemplate, GetEntitiesInViewExecutor, GetEntitiesInViewTemplate, GetObserversOfExecutor, GetObserversOfTemplate, GridAOI, type GridAOIConfig, GridSpatialIndex, type GridSpatialIndexConfig, type IAOIEvent, type IAOIManager, type IAOIObserverConfig, type IBoundable, type IBounds, type IPositionable, type IRaycastHit, type ISpatialIndex, type ISpatialQuery, OnEntityEnterViewExecutor, OnEntityEnterViewTemplate, OnEntityExitViewExecutor, OnEntityExitViewTemplate, RaycastExecutor, RaycastFirstExecutor, RaycastFirstTemplate, RaycastTemplate, type SpatialFilter, SpatialIndexToken, SpatialQueryNodeDefinitions, SpatialQueryToken, boundsIntersect, boundsIntersectsCircle, createBounds, createBoundsFromCenter, createBoundsFromCircle, createGridAOI, createGridSpatialIndex, distance, distanceSquared, isPointInBounds };