pelican-engine 0.3.9 → 0.3.11

package/AGENTS.md

@@ -118,6 +118,32 @@ 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.
 
+### Development-stage rope particles
+
+`ctx.ropes.create({ id, points, mass, autoStep: true })` creates a CPU particle
+rope that advances once after each physics phase, before `postPhysics` systems.
+Set anchors, forces and sampled colliders in `prePhysics`; read positions in
+`postPhysics`. Without `autoStep`, the rope remains manually stepped with
+`ctx.ropes.step(id)`; calling `step` for an automatic rope returns
+`TC_ROPE_AUTO_STEP` instead of advancing twice. An automatic rope created during
+`prePhysics` advances in that tick. The first particle is pinned by default;
+`anchors: []` creates a free rope. `setAnchor`, `releaseAnchor`, `applyForce`
+(next tick only), `applyImpulse`, `inspect`, and `destroy` manage it.
+
+`setColliders` accepts sampled planes and spheres; contacts affect only rope
+particles, not rigid bodies. Host snapshots include the rope definition, mode
+and state. If advancing an automatic rope fails, the engine attempts to restore
+all earlier automatic ropes from that phase; the host tick may still have other
+partial changes and must be recovered from a known-good checkpoint. The source
+checkout includes `examples/rope-particles`.
+
+This is an unverified development-stage increment, not complete rope physics:
+there is no built-in rope mesh, rigid-body reaction, segment or self collision,
+or tearing. Moving entities to particle positions is not a rope renderer or
+coupled physics. Plane normals must be unit length; `offset` is the signed
+normal distance from the origin. Host intervals must be between 1/1000 and
+1/30 seconds inclusive.
+
 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.9",
+  "version": "0.3.11",
   "files": {
-    "AGENTS.md": "b40d2f0c3f04899aaa0fabaeed06c77a6799883f2aec8c1ac1175f23faad8dbe",
+    "AGENTS.md": "fddb7363380ae3c3358c4253e2e26604402ae0ccd4c8bb1fed050053d8497ac9",
     "CONTRIBUTING.md": "0ffad5d841d90f319fc50a75b81d3c0ad6dab8d5d9bec2846c65c7f8358d5a50",
     "docs/AI-WORKFLOW.md": "aa992686df93f791795f6f3fce01713d812eea6a1b9556f07411ac5847278efa",
-    "docs/api/index.json": "f9f46bf383d44df43a3f4af1b80305e590ff61af7fb058a7e0489b125bccf10f",
-    "docs/api/REFERENCE.md": "67e98232d890ff0b24646dac384409126550bbe97b664bcb6cdabacf9513ce15",
+    "docs/api/index.json": "59a2f8e53b6c7dab288669a4ecf871a69215b6c321daf032dee2bd0b9a90f55b",
+    "docs/api/REFERENCE.md": "dacc993cdeaae28d8109fff996f73e13a0353c5738ffc1f395d2e539b4b3146c",
     "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": "b40d2f0c3f04899aaa0fabaeed06c77a6799883f2aec8c1ac1175f23faad8dbe",
+    "docs/npm/GAME-AUTHOR.md": "fddb7363380ae3c3358c4253e2e26604402ae0ccd4c8bb1fed050053d8497ac9",
     "docs/PELICAN-MIGRATION.md": "c5d6ab8e5186f4d36720a0a01d1a7e4157a5d386c5400e2db99571a7d10a1e49",
     "docs/PHYSICS-LIFECYCLE-ISSUE.md": "cc78917462de4e7e9b68e77c742192ce213b4be5b516d2ba943251fff46977ac",
     "docs/RENDER-BACKENDS.md": "d981ea94742a835d028db37d536fb7fba05102e37bc6274a37baf74f5034b954",
     "docs/ROADMAP.md": "29ac1c54f36064e23c17cfe7f549d6860889257a57d1227e322958aa9c281568",
-    "docs/STATUS.md": "284cff4be2edbea4d8e9e3bd02fefb387145c5923fa932861da8a8697adf4c7a",
+    "docs/STATUS.md": "916856579e74a9c4dfd753e26f7f002c1c818a9095d8711d41b0338e74a385a8",
     "docs/THIRD-PARTY-NOTICES.md": "58f9b72e2b4dfaaaf2a4c08b9bde9ecef3d2b7e7d65fccd782ed54f39fa76fdc",
-    "engine.manifest.json": "ba071616a8cd45c113649dbec24da8d2dcd477eb744f519b509ed8f1d9740381",
+    "engine.manifest.json": "8e06cd1352089820f04224d422c8d685e88159dc0bf8afaf22ba3f17001918da",
     "lib/assets/audio.js": "6facdce4e053afd172af5b9407569b035169844ea17b49f93f8b67f72b78895f",
     "lib/assets/errors.js": "70572678655c6e53179d31920d71f29882d373a0e12d560220bb0fc2cd74f2cc",
     "lib/assets/glb.js": "b808479a36299c154db97f50c16863a3b5a2c61f725e66bf01d01a5f62a288a5",
@@ -66,7 +66,7 @@
     "lib/renderer/emissive-lights.js": "93ee4442cb1eb9a075c5a7a02560bb0e9af2b99d4e55d9f46d73e477e725a599",
     "lib/renderer/environment-importance.js": "b192af1173eb8235ab3f8cbe34fe7de92fe35bf970c214d7d3a122a5c77006d9",
     "lib/renderer/environment.js": "e7eff454f49e969f188d58e936cb41c217413902af5de4d9fefa3212c3394692",
-    "lib/renderer/gameplay.js": "1deeace958eea45781bf08f80c1c9122c10753eaecb6074176adcf112190c919",
+    "lib/renderer/gameplay.js": "e77b116413339af97d1e24f59b77035eeea8297ddc29963bbe21173c10077673",
     "lib/renderer/geometry.js": "262674d0b8c45f71a937ef5f8fde023287e14f985bd80ffcf11aa778523ba4bc",
     "lib/renderer/graph-expressions.js": "3cc20d472f3894976b6c8e503b915c3eaf12de9c6d93bae45edb12b0f7e0dc4e",
     "lib/renderer/graph-tsl.js": "d698d22fd2977aabd3f7331e8f3d46d8cbf80695ea503b9326cff470859e84b4",
@@ -104,7 +104,7 @@
     "lib/runtime/error.js": "544d52d5426c53266c902e7b5afda1ea76a84ac12b6027879aed647423acbbad",
     "lib/runtime/events.js": "e1d8fd5005be19d7a26d51023b97245318bce4b777748562d5e453b10f0faefe",
     "lib/runtime/game-services.js": "a026966789aca4c45a5303950f7bc757cc6c12f223cbeaba13f6d514cac8575b",
-    "lib/runtime/host.js": "46a5c3b49914005decfc6fefbce5eb4a20876c28b20aff2a8e6873c932ba5f6f",
+    "lib/runtime/host.js": "e9b4e0028d80549114d9b2f92cd01500403a1c381d6fc295175ee1e33cd7bed7",
     "lib/runtime/material-parameters.js": "c535afa5ff3d92f399da142a45f22541598e374b6a8e4051a65f8f20dd8fb970",
     "lib/runtime/plugins.js": "8e609bb71c20b858c77f0e9f90bb1319db8477b13f9f965f1a1e18524bf50881",
     "lib/runtime/postprocess-contract.js": "8e609bb71c20b858c77f0e9f90bb1319db8477b13f9f965f1a1e18524bf50881",
@@ -118,13 +118,15 @@
     "lib/runtime/render-texture-contract.js": "8e609bb71c20b858c77f0e9f90bb1319db8477b13f9f965f1a1e18524bf50881",
     "lib/runtime/render-textures.js": "9fc1232b3b35a62c53e62d90e2493042865cd0394e198363160d277adaeb1462",
     "lib/runtime/resources.js": "a9cb6075602cedf47795238dd89711ea6028be79cb9d609f7791c6d697a663c4",
-    "lib/runtime/scheduler.js": "579ae61c47b943a23fb00e21e8e03b1838c55a4691982c1f472662fa3bb26ae9",
+    "lib/runtime/scheduler.js": "87966d7686cb33933d0dabe26687f82e6c32ef552d3747dbf6a2a11473cdbbd5",
     "lib/runtime/storage.js": "efa15f18d90939824e70cd50bc77dca1075fb8e68f965158a722e6ea10dbe85d",
     "lib/runtime/world.js": "c43621fbaca8bd2b0d6477a96e60e895312f0f7b1eb97614b6e4f9b716129ea1",
     "lib/schema/index.js": "594429eecb4494c4af2f3d04537be3211f2c9297a1fc555bbba5d028d8627965",
     "lib/sdk/graph-values.js": "a58c00f127cb82aba5fd2824981942844e06d9a59a88a05e35d1d3df2fc7ed2f",
-    "lib/sdk/index.d.ts": "84537a12ca1a1dbae5f5d8df4a33d337d09553aee86a5981678df88f5c7441f9",
-    "lib/sdk/index.js": "886b565805ab14a5b0b75f1d0e60e0d94d07a2e5a5fd7ff155d1a1e5ba6d7a23",
+    "lib/sdk/index.d.ts": "f08d8c8e97719ac8963417f22296840bf2e72ff2d38c10a24d4239c40397880e",
+    "lib/sdk/index.js": "d6b0fd91442a9ccc2e56363d93e00baf850375ab15cbbd2c3dbde3bc0135e301",
+    "lib/simulation/rope-plugin.js": "6c1eef7109d8838c1a41400698998ff511c24a22c30cacb4c2c5ec0d02e1034b",
+    "lib/simulation/rope.js": "9a2653d948062d9681ec7ebe3a4e594ece902a9e64628e57a831a20bc3374344",
     "lib/tools/api-index.js": "6aedc153a0ce8eaf18239b0368a76a8ae8e4397bd8e6cdf571889bc39265be5d",
     "lib/tools/browser-session.js": "1fa7f78d4752d8a59a55dc2283b4d42cd1df230f0d5a5dc80c6d78ade45b4cdb",
     "lib/tools/cli.js": "ad5e915f046cc2e6bf612edd1a88cc33758b1d2b0ce2f057be50e0a2c4770062",
@@ -195,7 +197,7 @@
     "licenses/undici-types/LICENSE": "a6db8096b2707bc0102d256917d4d33f298ba36d8c3f25de067a2b5bb379db27",
     "licenses/uniq/LICENSE": "e67aed7df22dc8031e4fcf5338fe91cb33e3817e5c58a99a2a2802eea9069791",
     "licenses/vite/LICENSE.md": "a22152baa1aef74402443008e767e7c689a524c0909d19b0431d97f5ab066a13",
-    "package.json": "9a60ca40e15df3eb08181ca19c7e0937dba27887de5b30df357c19326282af5e",
+    "package.json": "50b4c19ea587085444043681064c8acdc6500b2329bd54cacf273f92f0479499",
     "README.md": "ff25e039921a85ba253c27608c77ed614a036117d7a04f908a78d1e3ed3f19ef",
     "web/index.html": "d89d6a5b5be3beae3627a8ed506ac308b165d264fb8696be3afd79fcca2f26ee"
   }

package/docs/STATUS.md

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