pelican-engine 0.3.7 → 0.3.8

package/AGENTS.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/distribution.json

@@ -1,12 +1,12 @@
 {
   "format": "pelican.npm-distribution",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "files": {
-    "AGENTS.md": "80067dae6407a09cf62758fae5502f5d0efa4dac3a85698477bf2b09bdacc78e",
+    "AGENTS.md": "b40d2f0c3f04899aaa0fabaeed06c77a6799883f2aec8c1ac1175f23faad8dbe",
     "CONTRIBUTING.md": "0ffad5d841d90f319fc50a75b81d3c0ad6dab8d5d9bec2846c65c7f8358d5a50",
     "docs/AI-WORKFLOW.md": "aa992686df93f791795f6f3fce01713d812eea6a1b9556f07411ac5847278efa",
-    "docs/api/index.json": "0da2f895a23562013731e87618a2a8b2f40d7ce441875ab95701b748ed1bc9c2",
-    "docs/api/REFERENCE.md": "aa6349d052cc7d43b6f17a817b0eac3e89a45844729a90668401dd2e55d36462",
+    "docs/api/index.json": "fdeee098ef1f7373aed8f60274086a1ed8a8b22179c78386ceee1fa15e5522d1",
+    "docs/api/REFERENCE.md": "52b87a6d08dc2e2d2501e6467a8b07692fc795a6330f8c4b813f18bbd2982fe8",
     "docs/ARCHITECTURE.md": "3184b73592d466390e7793b1cf39bbb80d6052b523fba7e7cb377b5207074627",
     "docs/assets/pelican-mark.svg": "407b10cd7e292ea83cf5dba4046fb2f01c7d566a14014c55deda3a2984562b4d",
     "docs/CAPABILITIES.md": "92950817497d8c63db07830db96dc93c877befa8d038320feed1ae1f1a053cb1",
@@ -14,14 +14,14 @@
     "docs/GETTING-STARTED.md": "5519ebe4e513e8ae4517c04948ee9dc70bcb1e3d04a65d468a6537c838502663",
     "docs/GRAPHICS-GUIDE.md": "e3d0f7df6189ca3f88d81af5ffaf393f5d6bf39b9e66167bb2f64b39194b514c",
     "docs/npm/DISTRIBUTION.md": "ff25e039921a85ba253c27608c77ed614a036117d7a04f908a78d1e3ed3f19ef",
-    "docs/npm/GAME-AUTHOR.md": "80067dae6407a09cf62758fae5502f5d0efa4dac3a85698477bf2b09bdacc78e",
+    "docs/npm/GAME-AUTHOR.md": "b40d2f0c3f04899aaa0fabaeed06c77a6799883f2aec8c1ac1175f23faad8dbe",
     "docs/PELICAN-MIGRATION.md": "c5d6ab8e5186f4d36720a0a01d1a7e4157a5d386c5400e2db99571a7d10a1e49",
     "docs/PHYSICS-LIFECYCLE-ISSUE.md": "cc78917462de4e7e9b68e77c742192ce213b4be5b516d2ba943251fff46977ac",
     "docs/RENDER-BACKENDS.md": "d981ea94742a835d028db37d536fb7fba05102e37bc6274a37baf74f5034b954",
     "docs/ROADMAP.md": "29ac1c54f36064e23c17cfe7f549d6860889257a57d1227e322958aa9c281568",
-    "docs/STATUS.md": "d1de3cfe7ac63746086966507806cfb310a2b66c414e416d9020c6f312c0b91f",
+    "docs/STATUS.md": "204d354bb5ef6110c80e33c2c3fd353f3f24790fbacacb4740de95c3d9b1af0b",
     "docs/THIRD-PARTY-NOTICES.md": "58f9b72e2b4dfaaaf2a4c08b9bde9ecef3d2b7e7d65fccd782ed54f39fa76fdc",
-    "engine.manifest.json": "648eca85e7ef0ef664ebaad69a124a6a1cde8a25e6fa78e8227fcfdbb1e76651",
+    "engine.manifest.json": "f2a36ca85e44120016c04825fa838e1a5f239e5796fb67f4700b95f5dda401ea",
     "lib/assets/audio.js": "6facdce4e053afd172af5b9407569b035169844ea17b49f93f8b67f72b78895f",
     "lib/assets/errors.js": "70572678655c6e53179d31920d71f29882d373a0e12d560220bb0fc2cd74f2cc",
     "lib/assets/glb.js": "b808479a36299c154db97f50c16863a3b5a2c61f725e66bf01d01a5f62a288a5",
@@ -50,7 +50,7 @@
     "lib/experiments/world/probe.js": "d7a6b6432ac1c44254ad288c7b02d0be26566996ecd0efc7e1a366ac6a119a10",
     "lib/experiments/world/types.js": "8e609bb71c20b858c77f0e9f90bb1319db8477b13f9f965f1a1e18524bf50881",
     "lib/experiments/world/world.js": "e335a96b1a2b217b69077f8e4b01aed7fd54b87e39bd5ac4138555d27ad9afe1",
-    "lib/navigation/index.js": "72895eb241dff9e18ffe217dd2de3b923f13449df8089b7040b07a39df0efef9",
+    "lib/navigation/index.js": "5ee447333ff2152b1f08b34a68e16dd058448b0a4d2f8b3eae0fb8e76f52a1a9",
     "lib/physics/index.js": "6e9c852177426ef217aaf661d81cf0d2bf349e99d8797ddf2482f820e34e5c26",
     "lib/protocol/index.js": "875c9f7ba4e67adc182aa177bc5017da0907ff9c584ba523021a219b26e38c89",
     "lib/renderer/acceleration.js": "50ccafc9bc5b463470a23cffbdff8dc1a29a77bada44d21caf1eb0c3f9de2c65",
@@ -123,8 +123,8 @@
     "lib/runtime/world.js": "c43621fbaca8bd2b0d6477a96e60e895312f0f7b1eb97614b6e4f9b716129ea1",
     "lib/schema/index.js": "594429eecb4494c4af2f3d04537be3211f2c9297a1fc555bbba5d028d8627965",
     "lib/sdk/graph-values.js": "a58c00f127cb82aba5fd2824981942844e06d9a59a88a05e35d1d3df2fc7ed2f",
-    "lib/sdk/index.d.ts": "f44e2d0b3998e51d2836ea317476677adc56e4cc93a04d5f8098edd88f384a0b",
-    "lib/sdk/index.js": "ffaa1eb70ad6821b980aa00055d8be97054083a732782dad8b9e1cc9a708edb0",
+    "lib/sdk/index.d.ts": "17ad41f8e372dc553b2741c5a69c6a4776185ef2f86f7ad8c8d65841e7a6fa2c",
+    "lib/sdk/index.js": "d5b564c091cf944fd922f27870d0fc903c188aa0ce6de03df831f4f817943ea2",
     "lib/tools/api-index.js": "6aedc153a0ce8eaf18239b0368a76a8ae8e4397bd8e6cdf571889bc39265be5d",
     "lib/tools/browser-session.js": "1fa7f78d4752d8a59a55dc2283b4d42cd1df230f0d5a5dc80c6d78ade45b4cdb",
     "lib/tools/cli.js": "ad5e915f046cc2e6bf612edd1a88cc33758b1d2b0ce2f057be50e0a2c4770062",
@@ -195,7 +195,7 @@
     "licenses/undici-types/LICENSE": "a6db8096b2707bc0102d256917d4d33f298ba36d8c3f25de067a2b5bb379db27",
     "licenses/uniq/LICENSE": "e67aed7df22dc8031e4fcf5338fe91cb33e3817e5c58a99a2a2802eea9069791",
     "licenses/vite/LICENSE.md": "a22152baa1aef74402443008e767e7c689a524c0909d19b0431d97f5ab066a13",
-    "package.json": "13cc4d5ed103fd013b76539f201b5d9aec34fafe3638ca828ffe9b1f3eae09fc",
+    "package.json": "c6ef7bed8932a1bec63c3217e0076be277e7894254530c1b8418e32e2fba840d",
     "README.md": "ff25e039921a85ba253c27608c77ed614a036117d7a04f908a78d1e3ed3f19ef",
     "web/index.html": "d89d6a5b5be3beae3627a8ed506ac308b165d264fb8696be3afd79fcca2f26ee"
   }

package/docs/STATUS.md

@@ -2,7 +2,7 @@
 
 ## 版本与发布
 
-- 当前版本为 `0.3.7`，包、锁文件、引擎、SDK、编译器和示例中的版本保持一致。下一项功能完成后统一递增并推送；相同版本不能重复发布。
+- 当前版本为 `0.3.8`，包、锁文件、引擎、SDK、编译器和示例中的版本保持一致。下一项功能完成后统一递增并推送；相同版本不能重复发布。
 - 推送主线会通过 GitHub Actions 和 npm 可信发布更新 `latest`；GitHub Release 用于记录里程碑。历史版本和旧标签保持原样，不代表当前源码通过。
 - 当前按用户要求仅允许编译和构建，不运行测试、浏览器、GPU、性能或其他验证。普通版本号不意味着运行行为、硬件或完整引擎已验收。
 
@@ -11,6 +11,7 @@
 - TypeScript SDK、编译器、游戏运行时、渲染器、资源管线和命令行已有实现；游戏开发使用 `pelican-engine` 公开接口。
 - 动态光追、路径追踪、受控图形计算和 WebGL2 回退已有研发实现，但当前源码的完整画质、性能、兼容性和资源生命周期未验证，不能称为完整首发。
 - 刚体首步前删除存在已知缺陷；历史候选存在旧快照兼容及危险历史回放风险，不得通过修改夹具或在主进程回放危险历史掩盖。有关背景与原始证据保留在历史任务文档中。
+- 正交网格导航新增批量障碍更新接口；它只处理单个网格的阻挡状态，不等于世界流送、实体变换或物理联动。该增量尚未进行运行行为验证。
 - 布料、绳索、软体、流体、连续世界、导航、动画、音频和其他首发能力仍需按各自依赖完成，不能把独立候选或局部实现写成整项完成。
 
 ## 单线接续