pelican-engine 0.3.18 → 0.3.20

package/AGENTS.md

@@ -157,8 +157,8 @@ reports the active mode. Set `selfCollisions: false` to disable it. Adjacent
 segments and collisions between separate ropes are not handled. Immovable anchored
 endpoints stay fixed, and contacts introduced by corrections can wait until the
 next iteration. Dense overlap can approach quadratic work. Snapshots from before
-this feature retain the disabled mode when migrated; Host engine-version rules
-still apply. This is unverified discrete contact, not a guarantee against
+this feature retain the disabled mode when migrated; invalid or duplicate self
+contacts are rejected atomically; Host engine-version rules still apply. This is unverified discrete contact, not a guarantee against
 penetration, continuous collision, friction or full rope physics. The source
 checkout includes `examples/rope-self`.
 
@@ -233,6 +233,14 @@ manual cloth uses `ctx.cloth.step`. Use `setAnchor`, `releaseAnchor`, `applyForc
 (next tick), `applyImpulse`, `setColliders`, `inspect`, and `destroy` to manage it.
 The source checkout includes `examples/cloth-sheet`.
 
+New cloth also resolves discrete self-contact between non-adjacent particles by
+projecting movable particles apart; shared triangle edges are excluded.
+`selfCollisions` defaults to true for new cloth and is reported by
+`ctx.cloth.inspect(id)`. Set it to false for particle-only cloth. Self-contact
+state is included in snapshots. This is particle self-contact, not triangle
+interior/edge collision, continuous collision, friction or a guarantee against
+penetration. It has not been runtime or stability validated.
+
 The CPU solver uses edge distance constraints and an optional distance-based
 bending approximation (`bending: true` by default). Sampled planes and spheres
 only move cloth particles; they do not receive reactions. Contacts do not cover

package/distribution.json

@@ -1,12 +1,12 @@
 {
   "format": "pelican.npm-distribution",
-  "version": "0.3.18",
+  "version": "0.3.20",
   "files": {
-    "AGENTS.md": "bd599d76513789d143cc4a4ed41968806f6e2e07d8aeb85f15be89da684bad6b",
+    "AGENTS.md": "3efeb184ac3c53692804ec50927b642053dbcf5c51ad25ea135aed15e4dbf7ff",
     "CONTRIBUTING.md": "0ffad5d841d90f319fc50a75b81d3c0ad6dab8d5d9bec2846c65c7f8358d5a50",
     "docs/AI-WORKFLOW.md": "aa992686df93f791795f6f3fce01713d812eea6a1b9556f07411ac5847278efa",
-    "docs/api/index.json": "d266290335d4f291374dffdd2507896ae56cc06cdb9c325a0412cae6b40b993c",
-    "docs/api/REFERENCE.md": "9d13e6f3637a016056bbaea2b8204052a79100e4873cde9b60abe7920e0571a2",
+    "docs/api/index.json": "8123bf23e260ffe7268ccd6507c1ea3c36bc1358a7148a77ca6ddab758348117",
+    "docs/api/REFERENCE.md": "d1c151baf7c148202e73f9eb0cd3854ba001daa32e32e6af6dd0b161c46e7781",
     "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": "bd599d76513789d143cc4a4ed41968806f6e2e07d8aeb85f15be89da684bad6b",
+    "docs/npm/GAME-AUTHOR.md": "3efeb184ac3c53692804ec50927b642053dbcf5c51ad25ea135aed15e4dbf7ff",
     "docs/PELICAN-MIGRATION.md": "c5d6ab8e5186f4d36720a0a01d1a7e4157a5d386c5400e2db99571a7d10a1e49",
     "docs/PHYSICS-LIFECYCLE-ISSUE.md": "cc78917462de4e7e9b68e77c742192ce213b4be5b516d2ba943251fff46977ac",
     "docs/RENDER-BACKENDS.md": "d981ea94742a835d028db37d536fb7fba05102e37bc6274a37baf74f5034b954",
     "docs/ROADMAP.md": "29ac1c54f36064e23c17cfe7f549d6860889257a57d1227e322958aa9c281568",
-    "docs/STATUS.md": "d995a70ac23f68145864f80cb7e16a84a724d386f233cad90cdff79ddff9b25a",
+    "docs/STATUS.md": "d16f1505f821fc497bfb57a82a3ff8ea9e9143fcb0dcd512614a84bda7740ec3",
     "docs/THIRD-PARTY-NOTICES.md": "58f9b72e2b4dfaaaf2a4c08b9bde9ecef3d2b7e7d65fccd782ed54f39fa76fdc",
-    "engine.manifest.json": "9467245c8647bc3a027f3da914e2ffc8405f5040e2fc0382c348d812916df514",
+    "engine.manifest.json": "c90b9ff8ef45bc83111d149fffde0dd441ffeef5501bd79a4bdcc35fa2571912",
     "lib/assets/audio.js": "6facdce4e053afd172af5b9407569b035169844ea17b49f93f8b67f72b78895f",
     "lib/assets/errors.js": "70572678655c6e53179d31920d71f29882d373a0e12d560220bb0fc2cd74f2cc",
     "lib/assets/glb.js": "b808479a36299c154db97f50c16863a3b5a2c61f725e66bf01d01a5f62a288a5",
@@ -125,10 +125,10 @@
     "lib/runtime/world.js": "c43621fbaca8bd2b0d6477a96e60e895312f0f7b1eb97614b6e4f9b716129ea1",
     "lib/schema/index.js": "594429eecb4494c4af2f3d04537be3211f2c9297a1fc555bbba5d028d8627965",
     "lib/sdk/graph-values.js": "a58c00f127cb82aba5fd2824981942844e06d9a59a88a05e35d1d3df2fc7ed2f",
-    "lib/sdk/index.d.ts": "c6c208dfa782bc388c3d946bbd3bf4149556e11a6b0f961a90918387aa0939bb",
-    "lib/sdk/index.js": "5332f2ab581aaf01e1fdb1e91c97c3a7106ab610f28e67bb7388ed548f387c6f",
-    "lib/simulation/cloth-plugin.js": "bef005219aef6aab6d91d599d9b8c94f1523d4d7141edf54bc5ec0514a452ef8",
-    "lib/simulation/cloth.js": "595dc52d6b8c1ce55cd1b2863282b7c6b22e021767ad831ed5b9e572a5bf5bcd",
+    "lib/sdk/index.d.ts": "a0f81926953f6f40a24cdf91241dd4205b44a24f49f92c0b4dd43deffffa991f",
+    "lib/sdk/index.js": "dd88241bb5f213c7dd3c6e1c8fe5e2b888d7ecc62d02e0930803fa44b20cabd9",
+    "lib/simulation/cloth-plugin.js": "edee02bb0ce7cf94d364699e47bc4891f8a53259bb70af547241759faad0b773",
+    "lib/simulation/cloth.js": "f45a1c7684904b70315c8c1a0a28153eb34a8aee150d518af379f6d2fff2e740",
     "lib/simulation/rope-body-coupling.js": "70694b73d17c79f223803a51fbf4a4dae551b717cd29bbea1fa38386ac98d621",
     "lib/simulation/rope-plugin.js": "08c7c4800053b3e8f255b6dd5be2b532b8e259300666c31de5494d15704717d4",
     "lib/simulation/rope-self-collision.js": "4d8dc5d5a88f0ae0ad5463f553f49b2ad3c8c126b98344a0966f619635bdb17f",
@@ -203,7 +203,7 @@
     "licenses/undici-types/LICENSE": "a6db8096b2707bc0102d256917d4d33f298ba36d8c3f25de067a2b5bb379db27",
     "licenses/uniq/LICENSE": "e67aed7df22dc8031e4fcf5338fe91cb33e3817e5c58a99a2a2802eea9069791",
     "licenses/vite/LICENSE.md": "a22152baa1aef74402443008e767e7c689a524c0909d19b0431d97f5ab066a13",
-    "package.json": "06a0e516918cab7a2a8856d74593ee5c746d1105f33a591d9d15385e6aa37662",
+    "package.json": "d2c9fa59ddfe28141abe4d08f2518c8dd07fc71e0caee076cf01c84c2c6a4107",
     "README.md": "ff25e039921a85ba253c27608c77ed614a036117d7a04f908a78d1e3ed3f19ef",
     "web/index.html": "d89d6a5b5be3beae3627a8ed506ac308b165d264fb8696be3afd79fcca2f26ee"
   }

package/docs/STATUS.md

@@ -2,7 +2,7 @@
 
 ## 版本与发布
 
-- 当前版本为 `0.3.18`，包、锁文件、引擎、SDK、编译器和示例中的版本保持一致。下一项功能完成后统一递增并推送；相同版本不能重复发布。
+- 当前版本为 `0.3.20`，包、锁文件、引擎、SDK、编译器和示例中的版本保持一致。下一项功能完成后统一递增并推送；相同版本不能重复发布。
 - 推送主线会通过 GitHub Actions 和 npm 可信发布更新 `latest`；GitHub Release 用于记录里程碑。历史版本和旧标签保持原样，不代表当前源码通过。
 - 当前按用户要求仅允许编译和构建，不运行测试、浏览器、GPU、性能或其他验证。普通版本号不意味着运行行为、硬件或完整引擎已验收。
 
@@ -14,7 +14,7 @@
 - 正交网格导航新增批量障碍更新接口；它只处理单个网格的阻挡状态，不等于世界流送、实体变换或物理联动。该增量尚未进行运行行为验证。
 - CPU 粒子绳索已接入 `ctx.ropes` 和 Host 快照，支持手动或自动固定步进。显式绑定的动态非触发球体可在物理阶段后被采样，并接收绳索投影产生的反冲量；其他采样球体/平面仍为单向。可选分段圆柱实例随粒子位置更新；它不是连续变形绳索网格。新绳索默认对绳段内部与球体的离散重叠求解，旧粒子型快照保留原模式；新增非相邻绳段间离散自接触和扫掠式宽相，可关闭；尚无完整双向求解、跨绳索碰撞、连续碰撞或撕裂。渲染、碰撞、性能、运行行为和快照兼容均未验证。
 - 动态球体绑定的接触响应已纳入刚体接触点速度、有效逆质量和转动惯量；绳索阶段使用虚拟状态、按绳索顺序求解并延迟提交冲量。真实刚体位移在下一物理步更新，仍无全局耦合子步、摩擦、恢复系数或连续碰撞，不代表完整双向物理。稳定性、守恒、运行和快照兼容尚未验证。
-- 三角布料新增 CPU 距离约束、近似弯曲、锚点、受力、采样球体/平面粒子碰撞、Host 快照及动态网格入口；不包含面/边碰撞、自碰撞、刚体反作用、撕裂或连续碰撞。渲染、运行、稳定性、性能和快照兼容均未验证，不代表完整布料能力。
+- 三角布料新增 CPU 距离约束、近似弯曲、锚点、受力、采样球体/平面粒子碰撞、非相邻粒子自碰撞、Host 快照及动态网格入口；不包含面/边碰撞、刚体反作用、撕裂或连续碰撞。渲染、运行、稳定性、性能和快照兼容均未验证，不代表完整布料能力。
 - 布料、绳索、软体、流体、连续世界、导航、动画、音频和其他首发能力仍需按各自依赖完成，不能把独立候选或局部实现写成整项完成。
 
 ## 单线接续