pelican-engine 0.3.7 → 0.3.9

package/docs/npm/GAME-AUTHOR.md

@@ -111,6 +111,13 @@ exhaustion returns `TC_NAVIGATION_CAPACITY`, not an unreachable result. Owners
 are explicit strings, not entities. This is a development-stage grid service,
 not continuous-world, flying or underwater navigation.
 
+Use `ctx.navigation.setBlockedBatch(id, updates)` to change multiple cells in
+one grid. Each update has `{ cell: { x, y }, blocked: boolean }`. The service
+validates every entry before changing the grid; a bad entry rejects the whole
+batch, and the last update wins if a cell appears more than once. Entity and
+transform changes are separate from this grid-only batch. This API is new and
+has not been runtime or browser validated under the current project policy.
+
 Keyboard bindings use the browser's `KeyboardEvent.key` values, not physical
 `KeyboardEvent.code` values. For example, use `input: { up: ["w", "W", "ArrowUp"],
 restart: ["r", "R"] }`, not `"KeyW"` or `"KeyR"`. Letter case depends on the

package/engine.manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "pelican-engine",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "milestone": "M3",
   "stage": "advanced-rendering-development",
   "license": "MIT",

package/lib/navigation/index.js

@@ -91,6 +91,28 @@ export const createNavigationPlugin = () => {
             else if (!blocked && exists)
                 grid.blocked.splice(lower, 1);
         },
+        setBlockedBatch(id, updates) {
+            const grid = get(id);
+            if (!Array.isArray(updates))
+                fail("BLOCKED", `Updates for grid '${id}' must be an array of cells and boolean blocked values.`);
+            if (updates.length === 0)
+                return;
+            // Validate every entry before modifying the grid. Repeated cells use the last value.
+            const changes = new Map();
+            for (const update of updates) {
+                if (!update || typeof update !== "object" || typeof update.blocked !== "boolean")
+                    fail("BLOCKED", `Each update for grid '${id}' requires a cell and a boolean blocked value.`);
+                changes.set(cell(grid, update.cell), update.blocked);
+            }
+            const blocked = new Set(grid.blocked);
+            for (const [index, value] of changes) {
+                if (value)
+                    blocked.add(index);
+                else
+                    blocked.delete(index);
+            }
+            grid.blocked = [...blocked].sort((a, b) => a - b);
+        },
         findPath(id, start, end) {
             const grid = get(id), from = cell(grid, start), to = cell(grid, end);
             const blocked = new Set(grid.blocked);

package/lib/sdk/index.d.ts

@@ -1,5 +1,5 @@
 /** Pelican Engine public API. No renderer or GPU implementation types escape this module. */
-export declare const SDK_VERSION = "0.3.7";
+export declare const SDK_VERSION = "0.3.9";
 export type Vec2 = readonly [number, number];
 export type Vec3 = readonly [number, number, number];
 export type Vec4 = readonly [number, number, number, number];
@@ -109,6 +109,11 @@ export interface NavigationCell {
     readonly x: number;
     readonly y: number;
 }
+/** One obstacle change for an orthogonal navigation grid. */
+export interface NavigationObstacleUpdate {
+    readonly cell: NavigationCell;
+    readonly blocked: boolean;
+}
 export interface NavigationGrid {
     readonly id: string;
     readonly owner: string;
@@ -124,6 +129,8 @@ export interface NavigationService {
     getGrid(id: string): NavigationGrid;
     isBlocked(id: string, cell: NavigationCell): boolean;
     setBlocked(id: string, cell: NavigationCell, blocked: boolean): void;
+    /** Validates the entire batch before committing; the last change for a repeated cell wins. */
+    setBlockedBatch(id: string, updates: readonly NavigationObstacleUpdate[]): void;
     findPath(id: string, start: NavigationCell, end: NavigationCell): readonly NavigationCell[];
     destroyGrid(id: string): void;
     destroyOwner(owner: string): void;

package/lib/sdk/index.js

@@ -1,5 +1,5 @@
 /** Pelican Engine public API. No renderer or GPU implementation types escape this module. */
-export const SDK_VERSION = "0.3.7";
+export const SDK_VERSION = "0.3.9";
 export const SYSTEM_PHASES = [
     "input",
     "prePhysics",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pelican-engine",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "Pelican Engine public SDK and offline development CLI",
   "type": "module",
   "license": "MIT",