@zephyr3d/scene 0.9.27 → 0.10.0

package/dist/physics/node_physics.js

@@ -0,0 +1,234 @@
+import { makeObservable, Disposable } from '@zephyr3d/base';
+
+let nextObjectId = 1;
+/**
+ * The physics data of a scene node: {@link SceneNode.physics}.
+ *
+ * @remarks
+ * Plain data until the node is in a scene with a {@link PhysicsWorld}, which
+ * then simulates it; without one it is kept, saved and loaded as is.
+ *
+ * - {@link NodePhysics.body}: a {@link RigidBody}.
+ * - {@link NodePhysics.character}: a {@link CharacterController}. A node has a
+ *   rigid body or a character, not both: setting one clears the other.
+ * - {@link NodePhysics.colliders}: collision shapes. They belong to the nearest
+ *   rigid body on this node or above it; with none, they are static.
+ * - {@link NodePhysics.joint}: links the nearest rigid body to another one.
+ * - {@link NodePhysics.vehicle}: drives the node's dynamic rigid body as a vehicle.
+ * - {@link NodePhysics.wheel}: a wheel of the vehicle above.
+ *
+ * Collision and trigger events are raised on the physics data of the node that
+ * has the rigid body or character, or of a node with static colliders; see
+ * {@link PhysicsEventMap}.
+ *
+ * @public
+ */ class NodePhysics extends makeObservable(Disposable)() {
+    /** Identifies the object in pair bookkeeping, in creation order. */ _physicsId;
+    _node;
+    _body;
+    _character;
+    _colliders;
+    _joint;
+    _vehicle;
+    _wheel;
+    /**
+   * @param init - Parts to start with, as if assigned one by one:
+   *   `new NodePhysics({ body: new RigidBody(), colliders: [collider] })`.
+   */ constructor(init){
+        super();
+        this._physicsId = nextObjectId++;
+        this._node = null;
+        this._body = null;
+        this._character = null;
+        this._colliders = [];
+        this._joint = null;
+        this._vehicle = null;
+        this._wheel = null;
+        if (init) {
+            this.body = init.body ?? null;
+            if (init.character) {
+                this.character = init.character;
+            }
+            this.colliders = init.colliders ?? [];
+            this.joint = init.joint ?? null;
+            this.vehicle = init.vehicle ?? null;
+            this.wheel = init.wheel ?? null;
+        }
+    }
+    /** The node this data is on. */ get node() {
+        return this._node;
+    }
+    /** The node's rigid body, or null. Setting one removes the node's character. */ get body() {
+        return this._body;
+    }
+    set body(value) {
+        const current = this._body;
+        if (current !== value) {
+            this._check(value);
+            if (value) {
+                this.character = null;
+            }
+            this._body = value ?? null;
+            current?._setOwner(null);
+            value?._setOwner(this);
+        }
+    }
+    /** The node's character controller, or null. Setting one removes the node's rigid body. */ get character() {
+        return this._character;
+    }
+    set character(value) {
+        const current = this._character;
+        if (current !== value) {
+            this._check(value);
+            if (value) {
+                this.body = null;
+            }
+            this._character = value ?? null;
+            current?._setOwner(null);
+            value?._setOwner(this);
+        }
+    }
+    /** The node's collision shapes. */ get colliders() {
+        return this._colliders;
+    }
+    set colliders(value) {
+        const next = [
+            ...new Set(value ?? [])
+        ];
+        next.forEach((c)=>this._check(c));
+        for (const c of this._colliders){
+            if (!next.includes(c)) {
+                c._setOwner(null);
+            }
+        }
+        const added = next.filter((c)=>!this._colliders.includes(c));
+        this._colliders = next;
+        for (const c of added){
+            c._setOwner(this);
+        }
+    }
+    /** Adds a collision shape. */ addCollider(collider) {
+        if (!this._colliders.includes(collider)) {
+            this.colliders = [
+                ...this._colliders,
+                collider
+            ];
+        }
+        return collider;
+    }
+    /** Removes a collision shape; returns false if it was not on this node. */ removeCollider(collider) {
+        if (!this._colliders.includes(collider)) {
+            return false;
+        }
+        this.colliders = this._colliders.filter((c)=>c !== collider);
+        return true;
+    }
+    /** The node's joint, or null. */ get joint() {
+        return this._joint;
+    }
+    set joint(value) {
+        const current = this._joint;
+        if (current !== value) {
+            this._check(value);
+            this._joint = value ?? null;
+            current?._setOwner(null);
+            value?._setOwner(this);
+        }
+    }
+    /** Drives the node's dynamic rigid body as a vehicle, or null. */ get vehicle() {
+        return this._vehicle;
+    }
+    set vehicle(value) {
+        const current = this._vehicle;
+        if (current !== value) {
+            this._check(value);
+            this._vehicle = value ?? null;
+            current?._setOwner(null);
+            value?._setOwner(this);
+        }
+    }
+    /** Makes the node a wheel of the vehicle above it, or null. */ get wheel() {
+        return this._wheel;
+    }
+    set wheel(value) {
+        const current = this._wheel;
+        if (current !== value) {
+            this._check(value);
+            this._wheel = value ?? null;
+            current?._setOwner(null);
+            value?._setOwner(this);
+        }
+    }
+    /** Every part, in a fixed order: body or character, colliders, joint, vehicle, wheel. */ get parts() {
+        const parts = [];
+        if (this._body) {
+            parts.push(this._body);
+        }
+        if (this._character) {
+            parts.push(this._character);
+        }
+        parts.push(...this._colliders);
+        for (const p of [
+            this._joint,
+            this._vehicle,
+            this._wheel
+        ]){
+            if (p) {
+                parts.push(p);
+            }
+        }
+        return parts;
+    }
+    /** Whether anything listens to an event, to skip computing it otherwise. */ _hasListeners(type) {
+        return !!this._listeners?.[type]?.some((l)=>!l.removed);
+    }
+    /** Puts the data on a node, or takes it off with null. Called by {@link SceneNode.physics}. */ _setNode(node) {
+        if (node === this._node) {
+            return;
+        }
+        if (node && this._node) {
+            throw new Error('Physics data already belongs to another node.');
+        }
+        if (!node) {
+            for (const part of this.parts){
+                part._leaveWorld();
+            }
+        }
+        this._node = node;
+        if (node) {
+            for (const part of this.parts){
+                part._enterWorld();
+            }
+        }
+    }
+    /** The node entered a scene. */ _hostAttached() {
+        for (const part of this.parts){
+            part._enterWorld();
+        }
+    }
+    /** The node left its scene. */ _hostDetached() {
+        for (const part of this.parts){
+            part._leaveWorld();
+        }
+    }
+    _check(part) {
+        if (part?.owner && part.owner !== this) {
+            throw new Error('Physics data already belongs to another node.');
+        }
+    }
+    onDispose() {
+        super.onDispose();
+        for (const part of this.parts){
+            part.dispose();
+        }
+        this._colliders = [];
+        this._body = null;
+        this._character = null;
+        this._joint = null;
+        this._vehicle = null;
+        this._wheel = null;
+    }
+}
+
+export { NodePhysics };
+//# sourceMappingURL=node_physics.js.map

package/dist/physics/node_physics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node_physics.js","sources":["../../src/physics/node_physics.ts"],"sourcesContent":["import { Disposable, makeObservable } from '@zephyr3d/base';\r\nimport type { Nullable } from '@zephyr3d/base';\r\nimport type { SceneNode } from '../scene/scene_node';\r\nimport type { PhysicsPart } from './part';\r\nimport type { PhysicsEventMap } from './types';\r\nimport type { RigidBody } from './rigid_body';\r\nimport type { Collider } from './collider';\r\nimport type { Joint } from './joint';\r\nimport type { CharacterController } from './character';\r\nimport type { Vehicle, Wheel } from './vehicle';\r\n\r\nlet nextObjectId = 1;\r\n\r\n/**\r\n * Parts to create a {@link NodePhysics} with.\r\n *\r\n * @public\r\n */\r\nexport interface NodePhysicsInit {\r\n  body?: Nullable<RigidBody>;\r\n  character?: Nullable<CharacterController>;\r\n  colliders?: readonly Collider[];\r\n  joint?: Nullable<Joint>;\r\n  vehicle?: Nullable<Vehicle>;\r\n  wheel?: Nullable<Wheel>;\r\n}\r\n\r\n/**\r\n * The physics data of a scene node: {@link SceneNode.physics}.\r\n *\r\n * @remarks\r\n * Plain data until the node is in a scene with a {@link PhysicsWorld}, which\r\n * then simulates it; without one it is kept, saved and loaded as is.\r\n *\r\n * - {@link NodePhysics.body}: a {@link RigidBody}.\r\n * - {@link NodePhysics.character}: a {@link CharacterController}. A node has a\r\n *   rigid body or a character, not both: setting one clears the other.\r\n * - {@link NodePhysics.colliders}: collision shapes. They belong to the nearest\r\n *   rigid body on this node or above it; with none, they are static.\r\n * - {@link NodePhysics.joint}: links the nearest rigid body to another one.\r\n * - {@link NodePhysics.vehicle}: drives the node's dynamic rigid body as a vehicle.\r\n * - {@link NodePhysics.wheel}: a wheel of the vehicle above.\r\n *\r\n * Collision and trigger events are raised on the physics data of the node that\r\n * has the rigid body or character, or of a node with static colliders; see\r\n * {@link PhysicsEventMap}.\r\n *\r\n * @public\r\n */\r\nexport class NodePhysics extends makeObservable(Disposable)<PhysicsEventMap>() {\r\n  /** Identifies the object in pair bookkeeping, in creation order. */\r\n  readonly _physicsId: number;\r\n  private _node: Nullable<SceneNode>;\r\n  private _body: Nullable<RigidBody>;\r\n  private _character: Nullable<CharacterController>;\r\n  private _colliders: Collider[];\r\n  private _joint: Nullable<Joint>;\r\n  private _vehicle: Nullable<Vehicle>;\r\n  private _wheel: Nullable<Wheel>;\r\n  /**\r\n   * @param init - Parts to start with, as if assigned one by one:\r\n   *   `new NodePhysics({ body: new RigidBody(), colliders: [collider] })`.\r\n   */\r\n  constructor(init?: NodePhysicsInit) {\r\n    super();\r\n    this._physicsId = nextObjectId++;\r\n    this._node = null;\r\n    this._body = null;\r\n    this._character = null;\r\n    this._colliders = [];\r\n    this._joint = null;\r\n    this._vehicle = null;\r\n    this._wheel = null;\r\n    if (init) {\r\n      this.body = init.body ?? null;\r\n      if (init.character) {\r\n        this.character = init.character;\r\n      }\r\n      this.colliders = init.colliders ?? [];\r\n      this.joint = init.joint ?? null;\r\n      this.vehicle = init.vehicle ?? null;\r\n      this.wheel = init.wheel ?? null;\r\n    }\r\n  }\r\n  /** The node this data is on. */\r\n  get node(): Nullable<SceneNode> {\r\n    return this._node;\r\n  }\r\n  /** The node's rigid body, or null. Setting one removes the node's character. */\r\n  get body(): Nullable<RigidBody> {\r\n    return this._body;\r\n  }\r\n  set body(value: Nullable<RigidBody>) {\r\n    const current = this._body;\r\n    if (current !== value) {\r\n      this._check(value);\r\n      if (value) {\r\n        this.character = null;\r\n      }\r\n      this._body = value ?? null;\r\n      current?._setOwner(null);\r\n      value?._setOwner(this);\r\n    }\r\n  }\r\n  /** The node's character controller, or null. Setting one removes the node's rigid body. */\r\n  get character(): Nullable<CharacterController> {\r\n    return this._character;\r\n  }\r\n  set character(value: Nullable<CharacterController>) {\r\n    const current = this._character;\r\n    if (current !== value) {\r\n      this._check(value);\r\n      if (value) {\r\n        this.body = null;\r\n      }\r\n      this._character = value ?? null;\r\n      current?._setOwner(null);\r\n      value?._setOwner(this);\r\n    }\r\n  }\r\n  /** The node's collision shapes. */\r\n  get colliders(): readonly Collider[] {\r\n    return this._colliders;\r\n  }\r\n  set colliders(value: readonly Collider[]) {\r\n    const next = [...new Set(value ?? [])];\r\n    next.forEach((c) => this._check(c));\r\n    for (const c of this._colliders) {\r\n      if (!next.includes(c)) {\r\n        c._setOwner(null);\r\n      }\r\n    }\r\n    const added = next.filter((c) => !this._colliders.includes(c));\r\n    this._colliders = next;\r\n    for (const c of added) {\r\n      c._setOwner(this);\r\n    }\r\n  }\r\n  /** Adds a collision shape. */\r\n  addCollider(collider: Collider) {\r\n    if (!this._colliders.includes(collider)) {\r\n      this.colliders = [...this._colliders, collider];\r\n    }\r\n    return collider;\r\n  }\r\n  /** Removes a collision shape; returns false if it was not on this node. */\r\n  removeCollider(collider: Collider) {\r\n    if (!this._colliders.includes(collider)) {\r\n      return false;\r\n    }\r\n    this.colliders = this._colliders.filter((c) => c !== collider);\r\n    return true;\r\n  }\r\n  /** The node's joint, or null. */\r\n  get joint(): Nullable<Joint> {\r\n    return this._joint;\r\n  }\r\n  set joint(value: Nullable<Joint>) {\r\n    const current = this._joint;\r\n    if (current !== value) {\r\n      this._check(value);\r\n      this._joint = value ?? null;\r\n      current?._setOwner(null);\r\n      value?._setOwner(this);\r\n    }\r\n  }\r\n  /** Drives the node's dynamic rigid body as a vehicle, or null. */\r\n  get vehicle(): Nullable<Vehicle> {\r\n    return this._vehicle;\r\n  }\r\n  set vehicle(value: Nullable<Vehicle>) {\r\n    const current = this._vehicle;\r\n    if (current !== value) {\r\n      this._check(value);\r\n      this._vehicle = value ?? null;\r\n      current?._setOwner(null);\r\n      value?._setOwner(this);\r\n    }\r\n  }\r\n  /** Makes the node a wheel of the vehicle above it, or null. */\r\n  get wheel(): Nullable<Wheel> {\r\n    return this._wheel;\r\n  }\r\n  set wheel(value: Nullable<Wheel>) {\r\n    const current = this._wheel;\r\n    if (current !== value) {\r\n      this._check(value);\r\n      this._wheel = value ?? null;\r\n      current?._setOwner(null);\r\n      value?._setOwner(this);\r\n    }\r\n  }\r\n  /** Every part, in a fixed order: body or character, colliders, joint, vehicle, wheel. */\r\n  get parts(): PhysicsPart[] {\r\n    const parts: PhysicsPart[] = [];\r\n    if (this._body) {\r\n      parts.push(this._body);\r\n    }\r\n    if (this._character) {\r\n      parts.push(this._character);\r\n    }\r\n    parts.push(...this._colliders);\r\n    for (const p of [this._joint, this._vehicle, this._wheel]) {\r\n      if (p) {\r\n        parts.push(p);\r\n      }\r\n    }\r\n    return parts;\r\n  }\r\n  /** Whether anything listens to an event, to skip computing it otherwise. */\r\n  _hasListeners(type: keyof PhysicsEventMap) {\r\n    return !!this._listeners?.[type]?.some((l) => !l.removed);\r\n  }\r\n  /** Puts the data on a node, or takes it off with null. Called by {@link SceneNode.physics}. */\r\n  _setNode(node: Nullable<SceneNode>) {\r\n    if (node === this._node) {\r\n      return;\r\n    }\r\n    if (node && this._node) {\r\n      throw new Error('Physics data already belongs to another node.');\r\n    }\r\n    if (!node) {\r\n      for (const part of this.parts) {\r\n        part._leaveWorld();\r\n      }\r\n    }\r\n    this._node = node;\r\n    if (node) {\r\n      for (const part of this.parts) {\r\n        part._enterWorld();\r\n      }\r\n    }\r\n  }\r\n  /** The node entered a scene. */\r\n  _hostAttached() {\r\n    for (const part of this.parts) {\r\n      part._enterWorld();\r\n    }\r\n  }\r\n  /** The node left its scene. */\r\n  _hostDetached() {\r\n    for (const part of this.parts) {\r\n      part._leaveWorld();\r\n    }\r\n  }\r\n  private _check(part: Nullable<PhysicsPart>) {\r\n    if (part?.owner && part.owner !== this) {\r\n      throw new Error('Physics data already belongs to another node.');\r\n    }\r\n  }\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    for (const part of this.parts) {\r\n      part.dispose();\r\n    }\r\n    this._colliders = [];\r\n    this._body = null;\r\n    this._character = null;\r\n    this._joint = null;\r\n    this._vehicle = null;\r\n    this._wheel = null;\r\n  }\r\n}\r\n"],"names":["nextObjectId","NodePhysics","makeObservable","Disposable","_node","_body","_character","_colliders","_joint","_vehicle","_wheel","init","_physicsId","body","character","colliders","joint","vehicle","wheel","node","value","current","_check","_setOwner","next","Set","forEach","c","includes","added","filter","addCollider","collider","removeCollider","parts","push","p","_hasListeners","type","_listeners","some","l","removed","_setNode","Error","part","_leaveWorld","_enterWorld","_hostAttached","_hostDetached","owner","onDispose","dispose"],"mappings":"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"}

package/dist/physics/part.js

@@ -0,0 +1,91 @@
+import { makeObservable, Disposable } from '@zephyr3d/base';
+
+let nextPhysicsId = 1;
+/**
+ * Common lifecycle of the physics data on a node - {@link RigidBody},
+ * {@link Collider}, {@link Joint}, {@link CharacterController}, {@link Vehicle}
+ * and {@link Wheel}: part of the scene's {@link PhysicsWorld} while its node is
+ * in a scene that has one.
+ *
+ * @remarks
+ * A part belongs to at most one {@link NodePhysics}.
+ *
+ * @public
+ */ class PhysicsPart extends makeObservable(Disposable)() {
+    /** Identifies the part in pair bookkeeping, in creation order. */ _physicsId;
+    _owner;
+    /** The node, for parts that belong to another part rather than to a NodePhysics. */ _ownerNode;
+    _world;
+    constructor(){
+        super();
+        this._physicsId = nextPhysicsId++;
+        this._owner = null;
+        this._ownerNode = null;
+        this._world = null;
+    }
+    /** The physics data of the node this part is on. */ get owner() {
+        return this._owner;
+    }
+    /** The node this part is on. */ get node() {
+        return this._owner?.node ?? this._ownerNode;
+    }
+    /** The world this part is in, while its node is in a scene that has one. */ get world() {
+        return this._world;
+    }
+    /** Puts the part on a NodePhysics, or takes it off with null. */ _setOwner(owner) {
+        if (owner === this._owner) {
+            return;
+        }
+        if (owner && this._owner) {
+            throw new Error('Physics data already belongs to another node.');
+        }
+        if (!owner) {
+            this._leaveWorld();
+        }
+        this._owner = owner;
+        if (owner) {
+            this._enterWorld();
+        }
+    }
+    /** Puts a part owned by another part on a node, or takes it off with null. */ _setOwnerNode(node) {
+        if (node === this._ownerNode) {
+            return;
+        }
+        if (!node) {
+            this._leaveWorld();
+        }
+        this._ownerNode = node;
+        if (node) {
+            this._enterWorld();
+        }
+    }
+    /** Joins the world of the node's scene, if the node is in one. */ _enterWorld() {
+        const node = this.node;
+        if (this._world || !node?.attached || !node.scene) {
+            return;
+        }
+        const world = node.scene.physicsWorld;
+        if (world && !world.disposed) {
+            this._world = world;
+            this._join(world);
+        }
+    }
+    /** Leaves its world. */ _leaveWorld() {
+        if (this._world) {
+            if (!this._world.disposed) {
+                this._leave(this._world);
+            }
+            this._world = null;
+        }
+    }
+    /** Whether anything listens to an event, to skip computing it otherwise. */ _hasListeners(type) {
+        return !!this._listeners?.[type]?.some((l)=>!l.removed);
+    }
+    onDispose() {
+        super.onDispose();
+        this._leaveWorld();
+    }
+}
+
+export { PhysicsPart };
+//# sourceMappingURL=part.js.map

package/dist/physics/part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"part.js","sources":["../../src/physics/part.ts"],"sourcesContent":["import { Disposable, makeObservable } from '@zephyr3d/base';\r\nimport type { Nullable } from '@zephyr3d/base';\r\nimport type { SceneNode } from '../scene/scene_node';\r\nimport type { NodePhysics } from './node_physics';\r\nimport type { PhysicsWorld } from './world';\r\n\r\nlet nextPhysicsId = 1;\r\n\r\n/**\r\n * Events of physics parts: `ready` is raised by a {@link Collider} when it comes\r\n * into the simulation.\r\n *\r\n * @public\r\n */\r\nexport type PhysicsPartEventMap = {\r\n  ready: [];\r\n};\r\n\r\n/**\r\n * Common lifecycle of the physics data on a node - {@link RigidBody},\r\n * {@link Collider}, {@link Joint}, {@link CharacterController}, {@link Vehicle}\r\n * and {@link Wheel}: part of the scene's {@link PhysicsWorld} while its node is\r\n * in a scene that has one.\r\n *\r\n * @remarks\r\n * A part belongs to at most one {@link NodePhysics}.\r\n *\r\n * @public\r\n */\r\nexport abstract class PhysicsPart extends makeObservable(Disposable)<PhysicsPartEventMap>() {\r\n  /** Identifies the part in pair bookkeeping, in creation order. */\r\n  readonly _physicsId: number;\r\n  private _owner: Nullable<NodePhysics>;\r\n  /** The node, for parts that belong to another part rather than to a NodePhysics. */\r\n  private _ownerNode: Nullable<SceneNode>;\r\n  private _world: Nullable<PhysicsWorld>;\r\n  constructor() {\r\n    super();\r\n    this._physicsId = nextPhysicsId++;\r\n    this._owner = null;\r\n    this._ownerNode = null;\r\n    this._world = null;\r\n  }\r\n  /** The physics data of the node this part is on. */\r\n  get owner(): Nullable<NodePhysics> {\r\n    return this._owner;\r\n  }\r\n  /** The node this part is on. */\r\n  get node(): Nullable<SceneNode> {\r\n    return this._owner?.node ?? this._ownerNode;\r\n  }\r\n  /** The world this part is in, while its node is in a scene that has one. */\r\n  get world(): Nullable<PhysicsWorld> {\r\n    return this._world;\r\n  }\r\n  /** Puts the part on a NodePhysics, or takes it off with null. */\r\n  _setOwner(owner: Nullable<NodePhysics>) {\r\n    if (owner === this._owner) {\r\n      return;\r\n    }\r\n    if (owner && this._owner) {\r\n      throw new Error('Physics data already belongs to another node.');\r\n    }\r\n    if (!owner) {\r\n      this._leaveWorld();\r\n    }\r\n    this._owner = owner;\r\n    if (owner) {\r\n      this._enterWorld();\r\n    }\r\n  }\r\n  /** Puts a part owned by another part on a node, or takes it off with null. */\r\n  _setOwnerNode(node: Nullable<SceneNode>) {\r\n    if (node === this._ownerNode) {\r\n      return;\r\n    }\r\n    if (!node) {\r\n      this._leaveWorld();\r\n    }\r\n    this._ownerNode = node;\r\n    if (node) {\r\n      this._enterWorld();\r\n    }\r\n  }\r\n  /** Joins the world of the node's scene, if the node is in one. */\r\n  _enterWorld() {\r\n    const node = this.node;\r\n    if (this._world || !node?.attached || !node.scene) {\r\n      return;\r\n    }\r\n    const world = node.scene.physicsWorld;\r\n    if (world && !world.disposed) {\r\n      this._world = world;\r\n      this._join(world);\r\n    }\r\n  }\r\n  /** Leaves its world. */\r\n  _leaveWorld() {\r\n    if (this._world) {\r\n      if (!this._world.disposed) {\r\n        this._leave(this._world);\r\n      }\r\n      this._world = null;\r\n    }\r\n  }\r\n  /** Whether anything listens to an event, to skip computing it otherwise. */\r\n  _hasListeners(type: keyof PhysicsPartEventMap) {\r\n    return !!this._listeners?.[type]?.some((l) => !l.removed);\r\n  }\r\n  protected abstract _join(world: PhysicsWorld): void;\r\n  protected abstract _leave(world: PhysicsWorld): void;\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    this._leaveWorld();\r\n  }\r\n}\r\n"],"names":["nextPhysicsId","PhysicsPart","makeObservable","Disposable","_owner","_world","_physicsId","_ownerNode","owner","node","world","_setOwner","Error","_leaveWorld","_enterWorld","_setOwnerNode","attached","scene","physicsWorld","disposed","_join","_leave","_hasListeners","type","_listeners","some","l","removed","onDispose"],"mappings":";;AAMA,IAAIA,aAAgB,GAAA,CAAA;AAYpB;;;;;;;;;;IAWO,MAAeC,WAAAA,SAAoBC,cAAeC,CAAAA,UAAAA,CAAAA,EAAAA,CAAAA;uEAEvD,UAA4B;IACpBC,MAA8B;yFAEtC,UAAwC;IAChCC,MAA+B;IACvC,WAAc,EAAA;QACZ,KAAK,EAAA;QACL,IAAI,CAACC,UAAU,GAAGN,aAAAA,EAAAA;QAClB,IAAI,CAACI,MAAM,GAAG,IAAA;QACd,IAAI,CAACG,UAAU,GAAG,IAAA;QAClB,IAAI,CAACF,MAAM,GAAG,IAAA;AAChB;yDAEA,IAAIG,KAA+B,GAAA;QACjC,OAAO,IAAI,CAACJ,MAAM;AACpB;qCAEA,IAAIK,IAA4B,GAAA;AAC9B,QAAA,OAAO,IAAI,CAACL,MAAM,EAAEK,IAAQ,IAAA,IAAI,CAACF,UAAU;AAC7C;iFAEA,IAAIG,KAAgC,GAAA;QAClC,OAAO,IAAI,CAACL,MAAM;AACpB;sEAEAM,SAAUH,CAAAA,KAA4B,EAAE;AACtC,QAAA,IAAIA,KAAU,KAAA,IAAI,CAACJ,MAAM,EAAE;AACzB,YAAA;AACF;AACA,QAAA,IAAII,KAAS,IAAA,IAAI,CAACJ,MAAM,EAAE;AACxB,YAAA,MAAM,IAAIQ,KAAM,CAAA,+CAAA,CAAA;AAClB;AACA,QAAA,IAAI,CAACJ,KAAO,EAAA;AACV,YAAA,IAAI,CAACK,WAAW,EAAA;AAClB;QACA,IAAI,CAACT,MAAM,GAAGI,KAAAA;AACd,QAAA,IAAIA,KAAO,EAAA;AACT,YAAA,IAAI,CAACM,WAAW,EAAA;AAClB;AACF;mFAEAC,aAAcN,CAAAA,IAAyB,EAAE;AACvC,QAAA,IAAIA,IAAS,KAAA,IAAI,CAACF,UAAU,EAAE;AAC5B,YAAA;AACF;AACA,QAAA,IAAI,CAACE,IAAM,EAAA;AACT,YAAA,IAAI,CAACI,WAAW,EAAA;AAClB;QACA,IAAI,CAACN,UAAU,GAAGE,IAAAA;AAClB,QAAA,IAAIA,IAAM,EAAA;AACR,YAAA,IAAI,CAACK,WAAW,EAAA;AAClB;AACF;AACA,uEACAA,WAAc,GAAA;QACZ,MAAML,IAAAA,GAAO,IAAI,CAACA,IAAI;QACtB,IAAI,IAAI,CAACJ,MAAM,IAAI,CAACI,MAAMO,QAAY,IAAA,CAACP,IAAKQ,CAAAA,KAAK,EAAE;AACjD,YAAA;AACF;AACA,QAAA,MAAMP,KAAQD,GAAAA,IAAAA,CAAKQ,KAAK,CAACC,YAAY;AACrC,QAAA,IAAIR,KAAS,IAAA,CAACA,KAAMS,CAAAA,QAAQ,EAAE;YAC5B,IAAI,CAACd,MAAM,GAAGK,KAAAA;YACd,IAAI,CAACU,KAAK,CAACV,KAAAA,CAAAA;AACb;AACF;AACA,6BACAG,WAAc,GAAA;QACZ,IAAI,IAAI,CAACR,MAAM,EAAE;AACf,YAAA,IAAI,CAAC,IAAI,CAACA,MAAM,CAACc,QAAQ,EAAE;AACzB,gBAAA,IAAI,CAACE,MAAM,CAAC,IAAI,CAAChB,MAAM,CAAA;AACzB;YACA,IAAI,CAACA,MAAM,GAAG,IAAA;AAChB;AACF;iFAEAiB,aAAcC,CAAAA,IAA+B,EAAE;AAC7C,QAAA,OAAO,CAAC,CAAC,IAAI,CAACC,UAAU,GAAGD,IAAK,CAAA,EAAEE,IAAK,CAAA,CAACC,CAAM,GAAA,CAACA,EAAEC,OAAO,CAAA;AAC1D;IAGUC,SAAY,GAAA;AACpB,QAAA,KAAK,CAACA,SAAAA,EAAAA;AACN,QAAA,IAAI,CAACf,WAAW,EAAA;AAClB;AACF;;;;"}