pelican-engine 0.3.24 → 0.3.25

package/distribution.json

@@ -1,12 +1,12 @@
 {
   "format": "pelican.npm-distribution",
-  "version": "0.3.24",
+  "version": "0.3.25",
   "files": {
     "AGENTS.md": "817bf14a6fe341bf515625cd84a0df4e6512a74b4a426ae3232ae3ad50e09d73",
     "CONTRIBUTING.md": "0ffad5d841d90f319fc50a75b81d3c0ad6dab8d5d9bec2846c65c7f8358d5a50",
     "docs/AI-WORKFLOW.md": "aa992686df93f791795f6f3fce01713d812eea6a1b9556f07411ac5847278efa",
-    "docs/api/index.json": "a31013de30a0a6dafecd69e001f578fe4c88957ad30b36a2c88f65209c7244cd",
-    "docs/api/REFERENCE.md": "9baff20b467502ac06d627401f466b58b98552aa9ba73e4140da8e1debe57aef",
+    "docs/api/index.json": "2957e732dd52aa0aab9127beaf7051a0ebb6a6d7005a2660b1ed532551d82fe7",
+    "docs/api/REFERENCE.md": "f74d7569fac4e922245f36ef52ccb387ca792c6b00b3664334a0423ddbac9355",
     "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": "13f620083a9484a6b7d217dcc631f31247a0bb45c260c45b1b29e32eaf024a0e",
+    "docs/STATUS.md": "78a7236755ffd52fd4e4b7a8347452b4f806cf167b56e6464d3a1fb3e48ade56",
     "docs/THIRD-PARTY-NOTICES.md": "58f9b72e2b4dfaaaf2a4c08b9bde9ecef3d2b7e7d65fccd782ed54f39fa76fdc",
-    "engine.manifest.json": "98e4effdf9c295555e90a07e1be415cccb6411b6c0d9e4606748899175934bdb",
+    "engine.manifest.json": "4c5718b7bbf53ef6a76f0530a494594682cf2902d78516b30a71a74ab4592a0b",
     "lib/assets/audio.js": "6facdce4e053afd172af5b9407569b035169844ea17b49f93f8b67f72b78895f",
     "lib/assets/errors.js": "70572678655c6e53179d31920d71f29882d373a0e12d560220bb0fc2cd74f2cc",
     "lib/assets/glb.js": "b808479a36299c154db97f50c16863a3b5a2c61f725e66bf01d01a5f62a288a5",
@@ -125,9 +125,9 @@
     "lib/runtime/world.js": "c43621fbaca8bd2b0d6477a96e60e895312f0f7b1eb97614b6e4f9b716129ea1",
     "lib/schema/index.js": "594429eecb4494c4af2f3d04537be3211f2c9297a1fc555bbba5d028d8627965",
     "lib/sdk/graph-values.js": "a58c00f127cb82aba5fd2824981942844e06d9a59a88a05e35d1d3df2fc7ed2f",
-    "lib/sdk/index.d.ts": "0a7919d574d71fdfac73cfbe2e858257df867484aa24f2b75ef2aafba9d0e7aa",
-    "lib/sdk/index.js": "2647b8b168f6c2df72e14fd05b3bcba63f590e4980601236886d26b69db0c5e5",
-    "lib/simulation/cloth-plugin.js": "6443122597038279f5c60aba3851dc18512fdadb19461337cb3b6487238be190",
+    "lib/sdk/index.d.ts": "efd79c42d516414b1957241dae460111ea46a83c0de83811152b70e7084e7119",
+    "lib/sdk/index.js": "2c57acadcd82609fc269cc5c53b36ceba94aa7cc1d3bc449e1eeed371c3e734b",
+    "lib/simulation/cloth-plugin.js": "b3f9869cdc145c3e3faff034cca7de0a9e0e39bb04a6956a626541678f730da8",
     "lib/simulation/cloth.js": "449be6f517af4eddbf047db68495e8f7666416d18b048b9f113064e0b07cc154",
     "lib/simulation/rope-body-coupling.js": "70694b73d17c79f223803a51fbf4a4dae551b717cd29bbea1fa38386ac98d621",
     "lib/simulation/rope-plugin.js": "08c7c4800053b3e8f255b6dd5be2b532b8e259300666c31de5494d15704717d4",
@@ -203,7 +203,7 @@
     "licenses/undici-types/LICENSE": "a6db8096b2707bc0102d256917d4d33f298ba36d8c3f25de067a2b5bb379db27",
     "licenses/uniq/LICENSE": "e67aed7df22dc8031e4fcf5338fe91cb33e3817e5c58a99a2a2802eea9069791",
     "licenses/vite/LICENSE.md": "a22152baa1aef74402443008e767e7c689a524c0909d19b0431d97f5ab066a13",
-    "package.json": "593542a21fcb96269b114789fc02d82d0ccfd7ead9b04848fa4d2016bbc51834",
+    "package.json": "c120b153fae8f8e52430f8e1a4d481611ccfd933bbf6d9f622c9af3baf92ea6a",
     "README.md": "ff25e039921a85ba253c27608c77ed614a036117d7a04f908a78d1e3ed3f19ef",
     "web/index.html": "d89d6a5b5be3beae3627a8ed506ac308b165d264fb8696be3afd79fcca2f26ee"
   }

package/docs/STATUS.md

@@ -31,3 +31,5 @@
 下一步优先分析物理生命周期与旧状态兼容的实现边界，再按依赖逐步集成可用功能。保留真实失败、局限和历史来源；不在禁止验证期间声称修复已通过。
 
 - ?????????????????????????????
+
+- ?????????????????????????????????????????????????

package/docs/api/REFERENCE.md

@@ -1,4 +1,4 @@
-# pelican 0.3.24 API 索引
+# pelican 0.3.25 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.24"
+SDK_VERSION = "0.3.25"
 ```
 
 ## Vec2

package/docs/api/index.json

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

package/engine.manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "pelican-engine",
-  "version": "0.3.24",
+  "version": "0.3.25",
   "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.24";
+export declare const SDK_VERSION = "0.3.25";
 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.24";
+export const SDK_VERSION = "0.3.25";
 export const SYSTEM_PHASES = [
     "input",
     "prePhysics",

package/lib/simulation/cloth-plugin.js

@@ -1,3 +1,4 @@
+import { resolveEntityDefinition } from "../runtime/prefabs.js";
 import { cloneSerializable } from "../runtime/random.js";
 import { createCloth } from "./cloth.js";
 const fail = (code, detail) => { throw new Error(`TC_CLOTH_${code}: ${detail}`); };
@@ -68,6 +69,22 @@ function createEntry(input, fixedDt, materials, restoredSelfMode, restoredSurfac
 }
 function disposeEntries(entries) { for (const entry of entries.values())
     entry.solver.dispose(); entries.clear(); }
+function validateBodyBindings(entries, context, world) {
+    const records = world ? new Map(world.entities.map(record => [record.id, record])) : undefined;
+    const bridge = [...entries].some(entry => (entry.definition.bodyColliders?.length ?? 0) > 0)
+        ? context.getRopePhysicsBridge?.() : undefined;
+    for (const entry of entries)
+        for (const binding of entry.definition.bodyColliders ?? []) {
+            const record = records?.get(binding.entity);
+            if (records && (!record || !resolveEntityDefinition(context.scene, record)?.rigidBody))
+                fail("SNAPSHOT", `Bound body '${binding.entity}' is missing from the restored world.`);
+            if (!context.world.isAlive(binding.entity))
+                fail("BODY_COLLIDER", `Body '${binding.entity}' is not a live entity.`);
+            if (!bridge)
+                fail("BODY_COLLIDER", "Body bindings require the physics plugin.");
+            bridge.sampleSphere(binding.entity);
+        }
+}
 function parseSnapshot(value, fixedDt, materials) {
     if (!value || typeof value !== "object" || value.version !== 1 || !Array.isArray(value.cloths) || value.cloths.length > 256)
         return fail("SNAPSHOT", "Expected a version 1 snapshot containing at most 256 cloths.");
@@ -118,12 +135,7 @@ export const createClothPlugin = context => {
                 return fail("CAPACITY", "At most 256 cloths per host.");
             const entry = createEntry(definition, hostDt, materials);
             try {
-                const bridge = entry.definition.bodyColliders?.length ? context.getRopePhysicsBridge?.() : undefined;
-                for (const binding of entry.definition.bodyColliders ?? []) {
-                    if (!context.world.isAlive(binding.entity))
-                        return fail("BODY_COLLIDER", `Body '${binding.entity}' is not a live entity.`);
-                    bridge?.sampleSphere(binding.entity);
-                }
+                validateBodyBindings([entry], context);
                 entries.set(entry.definition.id, entry);
             }
             catch (error) {
@@ -200,7 +212,28 @@ export const createClothPlugin = context => {
         snapshot: () => ({ version: 1, cloths: [...entries.values()].sort((a, b) => a.definition.id < b.definition.id ? -1 : a.definition.id > b.definition.id ? 1 : 0)
                 .map(({ definition, solver }) => ({ definition: cloneSerializable(definition), state: solver.snapshot() })) }),
         validateSnapshot(value) { const staged = parseSnapshot(value, hostDt, materials); disposeEntries(staged); },
-        restore(value) { alive(); const staged = parseSnapshot(value, hostDt, materials); disposeEntries(entries); entries = staged; },
+        validateWorld(value, world) {
+            const staged = parseSnapshot(value, hostDt, materials);
+            try {
+                validateBodyBindings(staged.values(), context, world);
+            }
+            finally {
+                disposeEntries(staged);
+            }
+        },
+        restore(value) {
+            alive();
+            const staged = parseSnapshot(value, hostDt, materials);
+            try {
+                validateBodyBindings(staged.values(), context);
+            }
+            catch (error) {
+                disposeEntries(staged);
+                throw error;
+            }
+            disposeEntries(entries);
+            entries = staged;
+        },
         dispose() { if (disposed)
             return; disposed = true; disposeEntries(entries); },
     };

package/package.json

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