@zylem/game-lib 0.6.4 → 0.8.0

package/dist/runtime.d.ts

@@ -0,0 +1,59 @@
+import { StageBodyKindValue, StageBodyConfig, StageColliderConfig } from '@zylem/behaviors/core';
+export { BehaviorRuntime, EntityDefinition, EntityHandle, Simulation, SimulationBodyDefinition, SimulationColliderDefinition, SimulationEvent, SimulationFrame, SimulationOptions, StageBodyConfig, StageBodyInfo, StageBodyKind, StageBodyKindValue, StageBoundaryDim, StageColliderConfig, StageColliderShape, StageDebugRender, StageEvent, StageEventType, StagePose, StageRaycastHit, StageRenderSlot, StageRicochetDim, StageRicochetReflection, StageTopDownPlane, createSimulation } from '@zylem/behaviors/core';
+import { e as Vec3Input } from './vector-CiSHbivc.js';
+export { l as SimulationBody, S as SimulationStepClock } from './vector-CiSHbivc.js';
+export { p as packCollisionGroups } from './collision-builder-jF-toPIl.js';
+import 'three';
+
+/**
+ * Runtime-side collision builder. Emits plain `BodyConfig` + `ColliderConfig`
+ * shapes ready to be uploaded to the wasm `StageSimulation` via
+ * {@link WasmStageRuntime}. **No** Rapier types appear in this module — that's
+ * the entire point: `@zylem/game-lib` should not depend on
+ * `@dimforge/rapier3d-compat` once the migration is complete.
+ *
+ * The TS-side `CollisionBuilder` (in `collision-builder.ts`) is being phased
+ * out in favor of these helpers; mirror its public surface (cuboid /
+ * sphere / capsule / cylinder / convex hull / trimesh) so existing entity
+ * factories can swap their implementation 1:1.
+ */
+
+/** Body-level options the host can override per entity. */
+interface RuntimeBodyOptions {
+    kind?: StageBodyKindValue;
+    position?: Vec3Input;
+    rotation?: readonly [number, number, number, number];
+    linearDamping?: number;
+    angularDamping?: number;
+    gravityScale?: number;
+    canSleep?: boolean;
+    ccdEnabled?: boolean;
+    lockRotation?: readonly [boolean, boolean, boolean];
+    lockTranslation?: readonly [boolean, boolean, boolean];
+}
+/** Collider-level options forwarded as-is from the legacy `CollisionOptions`. */
+interface RuntimeColliderOptions {
+    offset?: Vec3Input;
+    friction?: number;
+    restitution?: number;
+    sensor?: boolean;
+    collisionType?: string;
+    collisionFilter?: string[];
+}
+declare function buildRuntimeBody(options?: RuntimeBodyOptions): StageBodyConfig;
+/** Cuboid collider sized as `size.xyz` (full extents — half-extents are computed). */
+declare function buildBoxCollider(size: Vec3Input, options?: RuntimeColliderOptions): StageColliderConfig;
+declare function buildSphereCollider(radius: number, options?: RuntimeColliderOptions): StageColliderConfig;
+declare function buildCapsuleCollider(halfHeight: number, radius: number, options?: RuntimeColliderOptions): StageColliderConfig;
+declare function buildCylinderCollider(halfHeight: number, radius: number, options?: RuntimeColliderOptions): StageColliderConfig;
+declare function buildConvexHullCollider(vertices: Float32Array, options?: RuntimeColliderOptions): StageColliderConfig;
+declare function buildTrimeshCollider(vertices: Float32Array, indices: Uint32Array, options?: RuntimeColliderOptions): StageColliderConfig;
+declare function buildHeightfieldCollider(rows: number, cols: number, heights: Float32Array, scale: readonly [number, number, number], options?: RuntimeColliderOptions): StageColliderConfig;
+/** Convenience: bundle a body + a list of colliders, the shape entity factories want. */
+interface RuntimeCollisionBundle {
+    body: StageBodyConfig;
+    colliders: StageColliderConfig[];
+}
+declare function bundleRuntimeCollision(body: StageBodyConfig, colliders: StageColliderConfig[]): RuntimeCollisionBundle;
+
+export { type RuntimeBodyOptions, type RuntimeColliderOptions, type RuntimeCollisionBundle, buildBoxCollider, buildCapsuleCollider, buildConvexHullCollider, buildCylinderCollider, buildHeightfieldCollider, buildRuntimeBody, buildSphereCollider, buildTrimeshCollider, bundleRuntimeCollision };

package/dist/runtime.js

@@ -0,0 +1 @@
+import{a as c,b as d,c as e,d as f,e as g,f as h,g as i,h as j,i as k,j as l,k as m,l as n,m as o,n as p,o as q,p as r}from"./chunk-IKWE2W6L.js";import{b}from"./chunk-G4HONLWC.js";import{a}from"./chunk-E3UBSUPX.js";import"./chunk-7WRQ2UAN.js";export{b as SimulationBody,l as StageBodyKind,m as StageBoundaryDim,n as StageEventType,o as StageRicochetDim,p as StageRicochetReflection,q as StageTopDownPlane,d as buildBoxCollider,f as buildCapsuleCollider,h as buildConvexHullCollider,g as buildCylinderCollider,j as buildHeightfieldCollider,c as buildRuntimeBody,e as buildSphereCollider,i as buildTrimeshCollider,k as bundleRuntimeCollision,r as createSimulation,a as packCollisionGroups};

package/dist/schema/entity.schema.json

@@ -0,0 +1,244 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "EntityJson",
+  "title": "EntityJson",
+  "anyOf": [
+    {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "const": "text",
+          "type": "string"
+        },
+        "position": {
+          "title": "Vector2",
+          "description": "A 2D position as [x, y].",
+          "type": "array",
+          "items": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "number"
+            }
+          ],
+          "additionalItems": false,
+          "minItems": 2,
+          "maxItems": 2
+        },
+        "data": {
+          "title": "TextEntityData",
+          "additionalProperties": true,
+          "type": "object",
+          "properties": {
+            "value": {
+              "type": "string"
+            },
+            "color": {
+              "type": "string"
+            },
+            "fontSize": {
+              "type": "number"
+            },
+            "fontFamily": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "required": [
+        "id",
+        "type"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "const": "sprite",
+          "type": "string"
+        },
+        "position": {
+          "title": "Vector2",
+          "description": "A 2D position as [x, y].",
+          "type": "array",
+          "items": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "number"
+            }
+          ],
+          "additionalItems": false,
+          "minItems": 2,
+          "maxItems": 2
+        },
+        "data": {
+          "title": "SpriteEntityData",
+          "additionalProperties": true,
+          "type": "object",
+          "properties": {
+            "imagePath": {
+              "type": "string"
+            },
+            "width": {
+              "type": "number"
+            },
+            "height": {
+              "type": "number"
+            }
+          }
+        }
+      },
+      "required": [
+        "id",
+        "type"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "const": "line",
+          "type": "string"
+        },
+        "position": {
+          "title": "Vector2",
+          "description": "A 2D position as [x, y].",
+          "type": "array",
+          "items": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "number"
+            }
+          ],
+          "additionalItems": false,
+          "minItems": 2,
+          "maxItems": 2
+        },
+        "data": {
+          "title": "LineEntityData",
+          "additionalProperties": true,
+          "type": "object",
+          "properties": {
+            "points": {
+              "minItems": 2,
+              "type": "array",
+              "items": {
+                "title": "Vector3Tuple",
+                "type": "array",
+                "items": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "number"
+                  }
+                ],
+                "additionalItems": false,
+                "minItems": 3,
+                "maxItems": 3
+              }
+            },
+            "color": {
+              "type": "string"
+            },
+            "colors": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "linewidth": {
+              "type": "number"
+            },
+            "worldUnits": {
+              "type": "boolean"
+            },
+            "alphaToCoverage": {
+              "type": "boolean"
+            },
+            "opacity": {
+              "type": "number"
+            },
+            "transparent": {
+              "type": "boolean"
+            },
+            "dashed": {
+              "type": "boolean"
+            },
+            "dashSize": {
+              "type": "number"
+            },
+            "gapSize": {
+              "type": "number"
+            },
+            "pickThreshold": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "points"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "type"
+      ]
+    },
+    {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "position": {
+          "title": "Vector2",
+          "description": "A 2D position as [x, y].",
+          "type": "array",
+          "items": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "number"
+            }
+          ],
+          "additionalItems": false,
+          "minItems": 2,
+          "maxItems": 2
+        },
+        "data": {
+          "type": "object",
+          "patternProperties": {
+            "^(.*)$": {}
+          }
+        }
+      },
+      "required": [
+        "id",
+        "type"
+      ]
+    }
+  ]
+}