@ignifx/physics 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ignifx/physics",
3
- "version": "0.8.0",
3
+ "version": "0.9.0",
4
4
  "description": "ignifx 3D physics on Havok through Babylon Lite: rigidbodies, colliders, triggers, character controller, queries.",
5
5
  "keywords": [
6
6
  "ignifx",
@@ -34,7 +34,7 @@
34
34
  "devDependencies": {
35
35
  "@arethetypeswrong/cli": "^0.18.5",
36
36
  "@babylonjs/havok": "^1.3.14",
37
- "@babylonjs/lite": "1.27.0",
37
+ "@babylonjs/lite": "1.34.0",
38
38
  "@microsoft/api-extractor": "^7.59.0",
39
39
  "@types/node": "^24.13.3",
40
40
  "@types/webxr": "^0.5.0",
@@ -45,13 +45,13 @@
45
45
  "typedoc-plugin-markdown": "^4.13.0",
46
46
  "typescript-native": "npm:typescript@7.0.2",
47
47
  "vitest": "^5.0.0",
48
- "@ignifx/core": "0.8.0",
49
- "@ignifx/terrain": "0.8.0"
48
+ "@ignifx/core": "0.9.0",
49
+ "@ignifx/terrain": "0.9.0"
50
50
  },
51
51
  "peerDependencies": {
52
52
  "@babylonjs/havok": "^1.3.14",
53
- "@babylonjs/lite": "1.27.0",
54
- "@ignifx/core": "0.8.0"
53
+ "@babylonjs/lite": "1.34.0",
54
+ "@ignifx/core": "0.9.0"
55
55
  },
56
56
  "ignifx": {
57
57
  "extension": true,
@@ -3,7 +3,7 @@ name: physics
3
3
  description: Adds 3D physics to an ignifx game with @ignifx/physics: Havok simulation on a separate headless scene, Rigidbody, box/sphere/capsule/mesh colliders, physics materials, triggers, CharacterController, raycasts and shape queries, the collision layer matrix, and render interpolation. Use when adding or editing 3D physics bodies, colliders, triggers, character movement, or physics queries in an ignifx project, or when the user mentions @ignifx/physics, Rigidbody, Havok, or collision layers.
4
4
  license: Apache-2.0
5
5
  metadata:
6
- ignifx-version: "0.8.0"
6
+ ignifx-version: "0.9.0"
7
7
  ---
8
8
 
9
9
  # @ignifx/physics
@@ -21,8 +21,8 @@ through, or has to be asked "what is under the crosshair".
21
21
 
22
22
  ## Environment
23
23
 
24
- - Engine: ignifx `0.8.0`; this package targets `@ignifx/core` `>=0.0.0 <1.0.0`.
25
- - Peer dependencies: `@babylonjs/lite` (exactly `1.27.0`) and `@babylonjs/havok` (`^1.3.0`).
24
+ - Engine: ignifx `0.9.0`; this package targets `@ignifx/core` `>=0.0.0 <1.0.0`.
25
+ - Peer dependencies: `@babylonjs/lite` (exactly `1.34.0`) and `@babylonjs/havok` (`^1.3.0`).
26
26
  - Browsers, Electron, and Node. The Vite plugin copies `HavokPhysics.wasm` into the public asset
27
27
  path, so the browser loads it from `assets/HavokPhysics.wasm`; under Node the extension reads the
28
28
  binary out of the installed `@babylonjs/havok` package, so a headless test needs no setup.
@@ -234,10 +234,9 @@ collides with everything. Havok tests a pair in both directions, so one side ref
234
234
  - **`MeshCollider` needs a GPU app.** Babylon Lite cannot build mesh or convex-hull shapes on the
235
235
  null engine and a headless `MeshAsset` uploads no geometry, so a headless mesh collider reports
236
236
  `IGX-0906`. Use a primitive collider in headless tests.
237
- - **`collision.other` is `null` by default.** `@babylonjs/lite@1.27.0` reports collisions without
238
- body identities. Trigger events _do_ carry both entities, so they are the documented mechanism for
239
- gameplay reactions; `physics({ collisionIdentities: "internal" })` opts into the ADR-0013 waiver
240
- that recovers the identities.
237
+ - **A collision reaches only the two entities in the contact**, and each gets the other as
238
+ `collision.other`. `other` is `null` only when the other body is not an entity's, such as a
239
+ `CharacterController`'s capsule; use `CharacterController.onCollided` for what a character pushes.
241
240
  - **Event objects are pooled.** `TriggerEvent` and `Collision` (and its `contacts`) are reused for
242
241
  every event of a step: copy anything you keep past the callback.
243
242
  - **Type the callback parameter, do not cast it.** Core declares `onTriggerEnter?(trigger: unknown)`
@@ -263,5 +262,4 @@ None (pre-1.0: no deprecation window; breaking changes are listed in the changel
263
262
  ## Where to look next
264
263
 
265
264
  `skills/ignifx/SKILL.md` for the engine entry skill · `skills/ignifx/references/api/physics.md` for
266
- the generated API · `docs/architecture/09-physics.md` and ADR-0003 / ADR-0013 for the design
267
- rationale.
265
+ the generated API · `docs/architecture/09-physics.md` and ADR-0003 for the design rationale.