pelican-engine 0.3.27 → 0.3.29

package/distribution.json

@@ -1,12 +1,12 @@
 {
   "format": "pelican.npm-distribution",
-  "version": "0.3.27",
+  "version": "0.3.29",
   "files": {
     "AGENTS.md": "ea6e8d183ab104bfa3569ad56d3d86fce3503f14dcb94782ab7656ecc4f9c0cd",
     "CONTRIBUTING.md": "0ffad5d841d90f319fc50a75b81d3c0ad6dab8d5d9bec2846c65c7f8358d5a50",
     "docs/AI-WORKFLOW.md": "aa992686df93f791795f6f3fce01713d812eea6a1b9556f07411ac5847278efa",
-    "docs/api/index.json": "765c761b22408c49d2c949e66d6e4ff363c73242fac115cc78677cee7414b647",
-    "docs/api/REFERENCE.md": "5f3fb3e68148832e22db8fedd3b56febb1b6f65d28b80a46e4aaa85b1cea2694",
+    "docs/api/index.json": "fc2b8b140acb84ee135c5ff786cef5badde2fe66af0698c52a25f9a8cdfe1c51",
+    "docs/api/REFERENCE.md": "5126f6302d42989ab96ad794c2bbe67e32b470dd32fe97d3ed0ad9190e7a4a59",
     "docs/ARCHITECTURE.md": "3184b73592d466390e7793b1cf39bbb80d6052b523fba7e7cb377b5207074627",
     "docs/assets/pelican-mark.svg": "407b10cd7e292ea83cf5dba4046fb2f01c7d566a14014c55deda3a2984562b4d",
     "docs/CAPABILITIES.md": "92950817497d8c63db07830db96dc93c877befa8d038320feed1ae1f1a053cb1",
@@ -19,9 +19,9 @@
     "docs/PHYSICS-LIFECYCLE-ISSUE.md": "cc78917462de4e7e9b68e77c742192ce213b4be5b516d2ba943251fff46977ac",
     "docs/RENDER-BACKENDS.md": "d981ea94742a835d028db37d536fb7fba05102e37bc6274a37baf74f5034b954",
     "docs/ROADMAP.md": "29ac1c54f36064e23c17cfe7f549d6860889257a57d1227e322958aa9c281568",
-    "docs/STATUS.md": "68cd18f05dd092f7bf754e2298715058b5de4fd4cb563d4cbec6ba7fc48b5cfc",
+    "docs/STATUS.md": "2061c10fdc20baf0dd144c1a1e1bda6de05fcb57b713dd7601a165d077a77f9c",
     "docs/THIRD-PARTY-NOTICES.md": "58f9b72e2b4dfaaaf2a4c08b9bde9ecef3d2b7e7d65fccd782ed54f39fa76fdc",
-    "engine.manifest.json": "0dbddba801aec40154f08b9b458bc573a3546bcb7efea05228f65a096a1b323e",
+    "engine.manifest.json": "4b6f950ec4f76bcdc109d3bbe533d851d6ef8748c66521b102dd60c92d3af2c5",
     "lib/assets/audio.js": "6facdce4e053afd172af5b9407569b035169844ea17b49f93f8b67f72b78895f",
     "lib/assets/errors.js": "70572678655c6e53179d31920d71f29882d373a0e12d560220bb0fc2cd74f2cc",
     "lib/assets/glb.js": "b808479a36299c154db97f50c16863a3b5a2c61f725e66bf01d01a5f62a288a5",
@@ -125,8 +125,8 @@
     "lib/runtime/world.js": "c43621fbaca8bd2b0d6477a96e60e895312f0f7b1eb97614b6e4f9b716129ea1",
     "lib/schema/index.js": "594429eecb4494c4af2f3d04537be3211f2c9297a1fc555bbba5d028d8627965",
     "lib/sdk/graph-values.js": "a58c00f127cb82aba5fd2824981942844e06d9a59a88a05e35d1d3df2fc7ed2f",
-    "lib/sdk/index.d.ts": "0dba735ca063a00b6f0a00abefa645085e0eaa2b12f98bc87d99e8b0a0525267",
-    "lib/sdk/index.js": "6ea78d93aa08f654c7a93a2273a796d52e6df99e19a8544de1a68e93fa493837",
+    "lib/sdk/index.d.ts": "6c84cee10096293f43be950b2de32d21432ed5aa00d5a2634a89d16b707172c5",
+    "lib/sdk/index.js": "c393b624aaf95c01a29ed770e8830abb7075d0af951ae3642dbd9c843968a5f5",
     "lib/simulation/cloth-plugin.js": "f9e29445b40d2b072c9b7bf61570a52e0785a5f05a58f5cc152ceabd5533a10a",
     "lib/simulation/cloth.js": "8914b77ad4af29ca0221edf6a9628f031b560475ee6d183ac915799a0c8347e1",
     "lib/simulation/rope-body-coupling.js": "70694b73d17c79f223803a51fbf4a4dae551b717cd29bbea1fa38386ac98d621",
@@ -203,7 +203,7 @@
     "licenses/undici-types/LICENSE": "a6db8096b2707bc0102d256917d4d33f298ba36d8c3f25de067a2b5bb379db27",
     "licenses/uniq/LICENSE": "e67aed7df22dc8031e4fcf5338fe91cb33e3817e5c58a99a2a2802eea9069791",
     "licenses/vite/LICENSE.md": "a22152baa1aef74402443008e767e7c689a524c0909d19b0431d97f5ab066a13",
-    "package.json": "d555ef517ef262a51246caa3b32f548156f3895e5cd49754d9716ced4ca4ad16",
+    "package.json": "2b95d93b5ff5387e31c50394bd149c646667911debae9c7da62752ba204ce3c1",
     "README.md": "ff25e039921a85ba253c27608c77ed614a036117d7a04f908a78d1e3ed3f19ef",
     "web/index.html": "d89d6a5b5be3beae3627a8ed506ac308b165d264fb8696be3afd79fcca2f26ee"
   }

package/docs/STATUS.md

@@ -1,39 +1,27 @@
-# 当前研发状态
+# Development Status
 
-## 版本与发布
+## Version and Release
 
-- 当前版本为 `0.3.22`，包、锁文件、引擎、SDK、编译器和示例中的版本保持一致。下一项功能完成后统一递增并推送；相同版本不能重复发布。
-- 推送主线会通过 GitHub Actions 和 npm 可信发布更新 `latest`；GitHub Release 用于记录里程碑。历史版本和旧标签保持原样，不代表当前源码通过。
-- 当前按用户要求仅允许编译和构建，不运行测试、浏览器、GPU、性能或其他验证。普通版本号不意味着运行行为、硬件或完整引擎已验收。
+- Current standard version: 0.3.29. Package, lock file, engine manifest, SDK, compiler, and examples use the same version.
+- A push to main attempts an npm latest release through GitHub Actions trusted publishing. GitHub Releases use standard version tags without pre-release suffixes.
+- The active project policy permits compilation and build steps only. Tests, browsers, GPU probes, performance checks, runtime checks, and registry verification are not run unless explicitly authorized.
 
-## 已有基础与缺口
+## Current Scope
 
-- TypeScript SDK、编译器、游戏运行时、渲染器、资源管线和命令行已有实现；游戏开发使用 `pelican-engine` 公开接口。
-- 动态光追、路径追踪、受控图形计算和 WebGL2 回退已有研发实现，但当前源码的完整画质、性能、兼容性和资源生命周期未验证，不能称为完整首发。
-- 刚体首步前删除存在已知缺陷；历史候选存在旧快照兼容及危险历史回放风险，不得通过修改夹具或在主进程回放危险历史掩盖。有关背景与原始证据保留在历史任务文档中。
-- 正交网格导航新增批量障碍更新接口；它只处理单个网格的阻挡状态，不等于世界流送、实体变换或物理联动。该增量尚未进行运行行为验证。
-- CPU 粒子绳索已接入 `ctx.ropes` 和 Host 快照，支持手动或自动固定步进。显式绑定的动态非触发球体可在物理阶段后被采样，并接收绳索投影产生的反冲量；其他采样球体/平面仍为单向。可选分段圆柱实例随粒子位置更新；它不是连续变形绳索网格。新绳索默认对绳段内部与球体的离散重叠求解，旧粒子型快照保留原模式；新增非相邻绳段间离散自接触和扫掠式宽相，可关闭；尚无完整双向求解、跨绳索碰撞、连续碰撞或撕裂。渲染、碰撞、性能、运行行为和快照兼容均未验证。
-- 动态球体绑定的接触响应已纳入刚体接触点速度、有效逆质量和转动惯量；绳索阶段使用虚拟状态、按绳索顺序求解并延迟提交冲量。真实刚体位移在下一物理步更新，仍无全局耦合子步、摩擦、恢复系数或连续碰撞，不代表完整双向物理。稳定性、守恒、运行和快照兼容尚未验证。
-- 三角布料新增 CPU 距离约束、近似弯曲、锚点、受力、采样球体/平面粒子碰撞、非相邻粒子自碰撞、Host 快照及动态网格入口；不包含面/边碰撞、刚体反作用、撕裂或连续碰撞。渲染、运行、稳定性、性能和快照兼容均未验证，不代表完整布料能力。
-- 布料、绳索、软体、流体、连续世界、导航、动画、音频和其他首发能力仍需按各自依赖完成，不能把独立候选或局部实现写成整项完成。
+- The public SDK, compiler, runtime, renderer, asset pipeline, and CLI are available through pelican-engine.
+- WebGPU, path tracing, controlled compute, and WebGL2 fallback have development implementations, but complete quality, performance, compatibility, and resource-lifecycle behavior remain unverified.
+- A known rigid-body first-step removal issue remains open. Historical candidates and risky snapshots are archived evidence, not current acceptance evidence.
+- Navigation supports batch obstacle updates for a finite orthogonal grid; this is not continuous-world streaming or physics integration.
+- Ropes support manual and automatic fixed stepping, sampled sphere bindings, segmented presentation, segment contacts, and non-adjacent self-contact. Full two-way coupling, cross-rope contact, continuous collision, and tearing remain incomplete.
+- Cloth supports triangular distance constraints, approximate bending, anchors, forces, sampled particle and surface contacts, non-adjacent particle self-contact, dynamic sphere bindings, optional approximate reactions, snapshots, and dynamic mesh presentation. Full continuous collision, rigid-body coupling, friction, and tearing remain incomplete.
+- Rope and cloth runtime behavior, stability, performance, rendering, and snapshot compatibility remain unverified. Missing capabilities must not be described as complete first-release support.
 
+## Single-Line Development
 
-- Historical cloth snapshots without `selfCollisions` restore in the legacy particle-only mode; invalid or duplicate self-contact state is rejected atomically. This migration fix is unverified.
+Only the main worktree is active. Git has one registered worktree and no .git/worktrees directory. Historical snapshots, patches, evidence, and recovery refs are retained as archives; unreviewed unique work is not merged or deleted blindly.
 
-- Cloth automatic stepping can bind live dynamic non-trigger spheres and sample their center and radius after physics as one-way moving obstacles; no reaction impulse is applied. This interface is unverified.
+Each change area contains one feature, fix, or next standard version. Changes are committed and pushed promptly; the workflow does not wait for a milestone. Version locks, API indexes, documents, and examples are updated together.
 
-## 单线接续
+## Release Boundary
 
-只在 `main` 的主工作树串行开发。历史独有候选和失败记录在本机 `.pelican/consolidated-worktrees/`、`.pelican/worktree-snapshots/` 或原证据目录中；它们不是活动工作树，未审查前不能删除或声称已合入。其他环境不一定有这些本机目录。
-
-每次工作只积累一个功能、修复或下一版本的相关变更；完成后及时提交并推送，不等待里程碑。推送前同步递增标准版本，以便 npm 使用同一版本发布。历史本机开发报告可由本机 Git 排除配置隐藏，不删除原文件；正式证据和未来新报告不能因此被默认为已提交。
-
-下一步优先分析物理生命周期与旧状态兼容的实现边界，再按依赖逐步集成可用功能。保留真实失败、局限和历史来源；不在禁止验证期间声称修复已通过。
-
-- ?????????????????????????????
-
-- ?????????????????????????????????????????????????
-
-- ???????????? `bodyReactions`??????/????????????????????????????????????
-
-- ??????????????????????????????????????????
+Every main push attempts npm latest publication. Published versions are never overwritten. Unverified behavior is explicitly marked and is not replaced by historical reports.

package/docs/api/REFERENCE.md

@@ -1,4 +1,4 @@
-# pelican 0.3.27 API 索引
+# pelican 0.3.29 API 索引
 
 Installed declarations: `lib/sdk/index.d.ts` (relative to the package root).
 The signatures below come from the same public SDK source as repository games.
@@ -11,7 +11,7 @@ Source-file paths and line numbers are build-time provenance only; TypeScript so
 来源：`packages/sdk/src/index.ts:2`
 
 ```ts
-SDK_VERSION = "0.3.27"
+SDK_VERSION = "0.3.29"
 ```
 
 ## Vec2

package/docs/api/index.json

@@ -1,14 +1,14 @@
 {
   "format": "pelican.api-index",
   "version": 1,
-  "engineVersion": "0.3.27",
+  "engineVersion": "0.3.29",
   "entry": "pelican-engine",
   "source": "packages/sdk/src/index.ts",
   "symbols": [
     {
       "name": "SDK_VERSION",
       "kind": "constant",
-      "signature": "SDK_VERSION = \"0.3.27\"",
+      "signature": "SDK_VERSION = \"0.3.29\"",
       "line": 2
     },
     {

package/engine.manifest.json

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

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.27";
+export declare const SDK_VERSION = "0.3.29";
 export type Vec2 = readonly [number, number];
 export type Vec3 = readonly [number, number, number];
 export type Vec4 = readonly [number, number, number, number];

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.27";
+export const SDK_VERSION = "0.3.29";
 export const SYSTEM_PHASES = [
     "input",
     "prePhysics",

package/package.json

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