@esengine/pathfinding 13.3.0 → 13.3.2

package/dist/{FlowController-Dc3nuLq5.d.ts → FlowController-BztOzQsW.d.ts}

@@ -2248,12 +2248,23 @@ interface IGridPathfinderAdapterConfig {
      * @zh 网格单元格大小（像素），用于坐标转换
      * @en Grid cell size (pixels), used for coordinate conversion
      *
-     * @zh 如果设置了此值，输入的像素坐标会自动转换为网格坐标，输出的网格坐标会转换回像素坐标（单元格中心）
-     * @en If set, input pixel coordinates are converted to grid coordinates, output grid coordinates are converted back to pixel coordinates (cell center)
+     * @zh 如果设置了此值，输入的像素坐标会自动转换为网格坐标，输出的网格坐标会转换回像素坐标
+     * @en If set, input pixel coordinates are converted to grid coordinates, output grid coordinates are converted back to pixel coordinates
      *
      * @default 1 (no conversion)
      */
     cellSize?: number;
+    /**
+     * @zh 是否将输出坐标对齐到单元格中心
+     * @en Whether to align output coordinates to cell center
+     *
+     * @zh 为 true 时，输出坐标会偏移 cellSize * 0.5，指向单元格中心
+     * @en When true, output coordinates are offset by cellSize * 0.5, pointing to cell center
+     *
+     * @zh 默认：当 cellSize > 1 时为 true（像素坐标场景），cellSize = 1 时为 false（网格坐标场景）
+     * @en Default: true when cellSize > 1 (pixel coordinate scenario), false when cellSize = 1 (grid coordinate scenario)
+     */
+    alignToCenter?: boolean;
 }
 /**
  * @zh 网格寻路器适配器
@@ -2268,6 +2279,7 @@ declare class GridPathfinderAdapter implements IPathPlanner {
     private readonly options?;
     readonly type: string;
     private readonly cellSize;
+    private readonly alignToCenter;
     constructor(pathfinder: IPathfinder, map: IPathfindingMap, options?: IPathfindingOptions | undefined, type?: string, config?: IGridPathfinderAdapterConfig);
     /**
      * @zh 像素坐标转网格坐标
@@ -2275,8 +2287,11 @@ declare class GridPathfinderAdapter implements IPathPlanner {
      */
     private toGridCoord;
     /**
-     * @zh 网格坐标转像素坐标（单元格中心）
-     * @en Convert grid coordinate to pixel coordinate (cell center)
+     * @zh 网格坐标转像素坐标
+     * @en Convert grid coordinate to pixel coordinate
+     *
+     * @zh 根据 alignToCenter 配置决定是否偏移到单元格中心
+     * @en Offsets to cell center based on alignToCenter configuration
      */
     private toPixelCoord;
     findPath(start: IVector2, end: IVector2): IPathPlanResult;
@@ -2365,6 +2380,17 @@ interface IIncrementalGridPathPlannerConfig extends IIncrementalPathfinderConfig
      * @default 1 (no conversion)
      */
     cellSize?: number;
+    /**
+     * @zh 是否将输出坐标对齐到单元格中心
+     * @en Whether to align output coordinates to cell center
+     *
+     * @zh 为 true 时，输出坐标会偏移 cellSize * 0.5，指向单元格中心
+     * @en When true, output coordinates are offset by cellSize * 0.5, pointing to cell center
+     *
+     * @zh 默认：当 cellSize > 1 时为 true（像素坐标场景），cellSize = 1 时为 false（网格坐标场景）
+     * @en Default: true when cellSize > 1 (pixel coordinate scenario), false when cellSize = 1 (grid coordinate scenario)
+     */
+    alignToCenter?: boolean;
 }
 /**
  * @zh 增量网格寻路器适配器
@@ -2396,6 +2422,7 @@ declare class IncrementalGridPathPlannerAdapter implements IIncrementalPathPlann
     private readonly map;
     private readonly options?;
     private readonly cellSize;
+    private readonly alignToCenter;
     /**
      * @zh 活跃请求 ID 集合（用于跟踪）
      * @en Active request IDs set (for tracking)
@@ -2413,8 +2440,11 @@ declare class IncrementalGridPathPlannerAdapter implements IIncrementalPathPlann
      */
     private toGridCoord;
     /**
-     * @zh 网格坐标转像素坐标（单元格中心）
-     * @en Convert grid coordinate to pixel coordinate (cell center)
+     * @zh 网格坐标转像素坐标
+     * @en Convert grid coordinate to pixel coordinate
+     *
+     * @zh 根据 alignToCenter 配置决定是否偏移到单元格中心
+     * @en Offsets to cell center based on alignToCenter configuration
      */
     private toPixelCoord;
     findPath(start: IVector2, end: IVector2, options?: IPathPlanOptions): IPathPlanResult;

package/dist/{chunk-NIKT3PQC.js → chunk-ZYGBA7VK.js}

@@ -2896,11 +2896,17 @@ var _GridPathfinderAdapter = class _GridPathfinderAdapter {
     __publicField(this, "options");
     __publicField(this, "type");
     __publicField(this, "cellSize");
+    __publicField(this, "alignToCenter");
     this.pathfinder = pathfinder;
     this.map = map;
     this.options = options;
     this.type = type;
-    this.cellSize = config?.cellSize ?? 1;
+    const cellSize = config?.cellSize ?? 1;
+    if (cellSize <= 0 || !Number.isFinite(cellSize)) {
+      throw new Error(`cellSize must be a positive finite number, got: ${cellSize}`);
+    }
+    this.cellSize = cellSize;
+    this.alignToCenter = config?.alignToCenter ?? cellSize > 1;
   }
   /**
    * @zh 像素坐标转网格坐标
@@ -2910,11 +2916,15 @@ var _GridPathfinderAdapter = class _GridPathfinderAdapter {
     return Math.floor(pixel / this.cellSize);
   }
   /**
-   * @zh 网格坐标转像素坐标（单元格中心）
-   * @en Convert grid coordinate to pixel coordinate (cell center)
+   * @zh 网格坐标转像素坐标
+   * @en Convert grid coordinate to pixel coordinate
+   *
+   * @zh 根据 alignToCenter 配置决定是否偏移到单元格中心
+   * @en Offsets to cell center based on alignToCenter configuration
    */
   toPixelCoord(grid) {
-    return grid * this.cellSize + this.cellSize * 0.5;
+    const base = grid * this.cellSize;
+    return this.alignToCenter ? base + this.cellSize * 0.5 : base;
   }
   findPath(start, end) {
     const startGridX = this.toGridCoord(start.x);
@@ -3011,6 +3021,7 @@ var _IncrementalGridPathPlannerAdapter = class _IncrementalGridPathPlannerAdapte
     __publicField(this, "map");
     __publicField(this, "options");
     __publicField(this, "cellSize");
+    __publicField(this, "alignToCenter");
     /**
      * @zh 活跃请求 ID 集合（用于跟踪）
      * @en Active request IDs set (for tracking)
@@ -3023,7 +3034,12 @@ var _IncrementalGridPathPlannerAdapter = class _IncrementalGridPathPlannerAdapte
     __publicField(this, "requestTotalNodes", /* @__PURE__ */ new Map());
     this.map = map;
     this.options = options;
-    this.cellSize = config?.cellSize ?? 1;
+    const cellSize = config?.cellSize ?? 1;
+    if (cellSize <= 0 || !Number.isFinite(cellSize)) {
+      throw new Error(`cellSize must be a positive finite number, got: ${cellSize}`);
+    }
+    this.cellSize = cellSize;
+    this.alignToCenter = config?.alignToCenter ?? cellSize > 1;
     this.pathfinder = new IncrementalAStarPathfinder(map, config);
   }
   /**
@@ -3034,11 +3050,15 @@ var _IncrementalGridPathPlannerAdapter = class _IncrementalGridPathPlannerAdapte
     return Math.floor(pixel / this.cellSize);
   }
   /**
-   * @zh 网格坐标转像素坐标（单元格中心）
-   * @en Convert grid coordinate to pixel coordinate (cell center)
+   * @zh 网格坐标转像素坐标
+   * @en Convert grid coordinate to pixel coordinate
+   *
+   * @zh 根据 alignToCenter 配置决定是否偏移到单元格中心
+   * @en Offsets to cell center based on alignToCenter configuration
    */
   toPixelCoord(grid) {
-    return grid * this.cellSize + this.cellSize * 0.5;
+    const base = grid * this.cellSize;
+    return this.alignToCenter ? base + this.cellSize * 0.5 : base;
   }
   // =========================================================================
   // IPathPlanner 基础接口 | IPathPlanner Base Interface
@@ -3808,4 +3828,4 @@ export {
   FlowController,
   createFlowController
 };
-//# sourceMappingURL=chunk-NIKT3PQC.js.map
+//# sourceMappingURL=chunk-ZYGBA7VK.js.map