@iwsdk/core 0.1.0

package/dist/physics/physics-system.d.ts

@@ -0,0 +1,314 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Types } from '.././index.js';
+declare const PhysicsSystem_base: import("elics").SystemConstructor<{
+    gravity: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+}, {
+    physicsEntities: {
+        required: (import("elics").Component<{
+            state: {
+                type: Types.Enum;
+                enum: {
+                    readonly Static: "STATIC";
+                    readonly Dynamic: "DYNAMIC";
+                    readonly Kinematic: "KINEMATIC";
+                };
+                default: "DYNAMIC";
+            };
+            linearDamping: {
+                type: Types.Float32;
+                default: number;
+            };
+            gravityFactor: {
+                type: Types.Float32;
+                default: number;
+            };
+            _linearVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            _angularVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            _engineBody: {
+                type: Types.Float64;
+                default: number;
+            };
+            _engineOffset: {
+                type: Types.Float64;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            shape: {
+                type: Types.Enum;
+                enum: {
+                    readonly Sphere: "Sphere";
+                    readonly Box: "Box";
+                    readonly Cylinder: "Cylinder";
+                    readonly Capsules: "Capsules";
+                    readonly ConvexHull: "ConvexHull";
+                    readonly TriMesh: "TriMesh";
+                    readonly Auto: "Auto";
+                };
+                default: "Auto";
+            };
+            dimensions: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            density: {
+                type: Types.Float32;
+                default: number;
+            };
+            restitution: {
+                type: Types.Float32;
+                default: number;
+            };
+            friction: {
+                type: Types.Float32;
+                default: number;
+            };
+            _engineShape: {
+                type: Types.Float64;
+                default: number;
+            };
+        }>)[];
+    };
+    manipluatedEntities: {
+        required: (import("elics").Component<{
+            state: {
+                type: Types.Enum;
+                enum: {
+                    readonly Static: "STATIC";
+                    readonly Dynamic: "DYNAMIC";
+                    readonly Kinematic: "KINEMATIC";
+                };
+                default: "DYNAMIC";
+            };
+            linearDamping: {
+                type: Types.Float32;
+                default: number;
+            };
+            gravityFactor: {
+                type: Types.Float32;
+                default: number;
+            };
+            _linearVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            _angularVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            _engineBody: {
+                type: Types.Float64;
+                default: number;
+            };
+            _engineOffset: {
+                type: Types.Float64;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            force: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            linearVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            angularVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+        }>)[];
+        where: import("elics").ValuePredicate[];
+    };
+}, import("../ecs/world").World, import("../ecs/system").System<{
+    gravity: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+}, {
+    physicsEntities: {
+        required: (import("elics").Component<{
+            state: {
+                type: Types.Enum;
+                enum: {
+                    readonly Static: "STATIC";
+                    readonly Dynamic: "DYNAMIC";
+                    readonly Kinematic: "KINEMATIC";
+                };
+                default: "DYNAMIC";
+            };
+            linearDamping: {
+                type: Types.Float32;
+                default: number;
+            };
+            gravityFactor: {
+                type: Types.Float32;
+                default: number;
+            };
+            _linearVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            _angularVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            _engineBody: {
+                type: Types.Float64;
+                default: number;
+            };
+            _engineOffset: {
+                type: Types.Float64;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            shape: {
+                type: Types.Enum;
+                enum: {
+                    readonly Sphere: "Sphere";
+                    readonly Box: "Box";
+                    readonly Cylinder: "Cylinder";
+                    readonly Capsules: "Capsules";
+                    readonly ConvexHull: "ConvexHull";
+                    readonly TriMesh: "TriMesh";
+                    readonly Auto: "Auto";
+                };
+                default: "Auto";
+            };
+            dimensions: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            density: {
+                type: Types.Float32;
+                default: number;
+            };
+            restitution: {
+                type: Types.Float32;
+                default: number;
+            };
+            friction: {
+                type: Types.Float32;
+                default: number;
+            };
+            _engineShape: {
+                type: Types.Float64;
+                default: number;
+            };
+        }>)[];
+    };
+    manipluatedEntities: {
+        required: (import("elics").Component<{
+            state: {
+                type: Types.Enum;
+                enum: {
+                    readonly Static: "STATIC";
+                    readonly Dynamic: "DYNAMIC";
+                    readonly Kinematic: "KINEMATIC";
+                };
+                default: "DYNAMIC";
+            };
+            linearDamping: {
+                type: Types.Float32;
+                default: number;
+            };
+            gravityFactor: {
+                type: Types.Float32;
+                default: number;
+            };
+            _linearVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            _angularVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            _engineBody: {
+                type: Types.Float64;
+                default: number;
+            };
+            _engineOffset: {
+                type: Types.Float64;
+                default: number;
+            };
+        }> | import("elics").Component<{
+            force: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            linearVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+            angularVelocity: {
+                type: Types.Vec3;
+                default: [number, number, number];
+            };
+        }>)[];
+        where: import("elics").ValuePredicate[];
+    };
+}>>;
+/**
+ * Manages physics simulation using the Havok physics engine.
+ *
+ * @remarks
+ * - Initializes Havok physics engine and creates a physics world with gravity.
+ * - Supports automatic physics shapes creation based on entity geometry when {@link PhysicsShapeType.Auto} is used.
+ * - Supports multiple collision shapes: Sphere, Box, Cylinder, ConvexHull, and TriMesh.
+ * - Synchronizes physics body transforms with Three.js Object3D positions and rotations using {@link PhysicsBody}.
+ * - Handles physics manipulations like applying forces and setting velocities in {@link PhysicsManipulation}.
+ * - Automatically cleans up physics resources when entities are removed.
+ *
+ * @example Basic physics setup
+ * ```ts
+ * // Add to your world to enable physics
+ * world.addSystem(PhysicsSystem)
+ *
+ * // Create a dynamic box that falls due to gravity
+ * const box = world.createTransformEntity(boxMesh)
+ * box.addComponent(PhysicsShape, {
+ *   shape: PhysicsShapeType.Box,
+ *   dimensions: [1, 1, 1]
+ * })
+ * box.addComponent(PhysicsBody, { state: PhysicsState.Dynamic })
+ * ```
+ *
+ * @category Physics
+ * @see {@link PhysicsBody}
+ * @see {@link PhysicsShape}
+ * @see {@link PhysicsManipulation}
+ */
+export declare class PhysicsSystem extends PhysicsSystem_base {
+    private havok?;
+    private havokWorld?;
+    private bodyBuffer?;
+    private scaleBuffer;
+    private matrixBuffer;
+    init(): Promise<void>;
+    update(delta: number): void;
+    private createBody;
+    private createHavokShapes;
+    private createBallShape;
+    private createBoxShape;
+    private createCylinderShape;
+    private createConvexHullShape;
+    private createTriMeshShape;
+    private getVertices;
+    private getIndices;
+}
+export {};
+//# sourceMappingURL=physics-system.d.ts.map

package/dist/physics/physics-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physics-system.d.ts","sourceRoot":"","sources":["../../src/physics/physics-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAqC,KAAK,EAAE,MAAM,eAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,aAAc,SAAQ,kBAalC;IACC,OAAO,CAAC,KAAK,CAAC,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,UAAU,CAAC,CAAS;IAE5B,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,YAAY,CAAiB;IAE/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IA0J3B,OAAO,CAAC,UAAU;IA0ClB,OAAO,CAAC,iBAAiB;IAmHzB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,mBAAmB;IA8B3B,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,kBAAkB;IA8D1B,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,UAAU;CAenB"}