@needle-tools/engine 3.28.6-beta → 3.28.7-beta.1

package/lib/engine/engine_types.d.ts

@@ -1,358 +1,358 @@
-/// <reference types="webxr" />
-import { RenderTexture } from "./engine_texture.js";
-import type { Camera, Color, Material, Object3D, Quaternion, Ray, Scene, WebGLRenderer, Mesh } from "three";
-import { Vector3 } from "three";
-import { RGBAColor } from "../engine-components/js-extensions/RGBAColor.js";
-import { CollisionDetectionMode, type PhysicsMaterial, RigidbodyConstraints } from "./engine_physics.types.js";
-import { type GLTF as GLTF3 } from "three/examples/jsm/loaders/GLTFLoader.js";
-export type GLTF = GLTF3 & {};
-export type LoadedGLTF = {
-    src: string;
-    file: GLTF;
-};
-/** used to find data registered via gltf files e.g. find lightmaps for a Renderer component that were shipped inside a gltf */
-export declare type SourceIdentifier = string;
-export type Constructor<T> = abstract new (...args: any[]) => T;
-export type ConstructorConcrete<T> = new (...args: any[]) => T;
-export type GuidsMap = {
-    [key: string]: string;
-};
-export interface UIDProvider {
-    seed: number;
-    generateUUID(): string;
-}
-export declare type CoroutineData = {
-    comp: IComponent;
-    main: Generator;
-    chained?: Array<Generator>;
-};
-export interface ITime {
-    get time(): number;
-}
-export interface IInput {
-    convertScreenspaceToRaycastSpace(vec: Vec2): void;
-    getPointerPosition(i: number): Vec2 | null;
-}
-export interface IPhysics {
-    engine?: IPhysicsEngine;
-}
-export interface IContext {
-    alias?: string | null;
-    hash?: string;
-    scene: Scene;
-    renderer: WebGLRenderer;
-    mainCamera: Camera | null;
-    mainCameraComponent: ICamera | undefined;
-    domElement: HTMLElement;
-    time: ITime;
-    input: IInput;
-    physics: IPhysics;
-    scripts: IComponent[];
-    scripts_pausedChanged: IComponent[];
-    scripts_earlyUpdate: IComponent[];
-    scripts_update: IComponent[];
-    scripts_lateUpdate: IComponent[];
-    scripts_onBeforeRender: IComponent[];
-    scripts_onAfterRender: IComponent[];
-    scripts_WithCorroutines: IComponent[];
-    coroutines: {
-        [FrameEvent: number]: Array<CoroutineData>;
-    };
-    post_setup_callbacks: Function[];
-    pre_update_callbacks: Function[];
-    pre_render_callbacks: Function[];
-    post_render_callbacks: Function[];
-    new_scripts: IComponent[];
-    new_script_start: IComponent[];
-    new_scripts_pre_setup_callbacks: Function[];
-    new_scripts_post_setup_callbacks: Function[];
-    stopAllCoroutinesFrom(script: IComponent): any;
-}
-export declare interface INeedleEngineComponent extends HTMLElement {
-    getAROverlayContainer(): HTMLElement;
-    onEnterAR(session: XRSession, overlayContainer: HTMLElement): any;
-    onExitAR(session: XRSession): any;
-}
-export declare interface IGameObject extends Object3D {
-    /** the object's unique identifier */
-    guid: string | undefined;
-    /** if the object is enabled in the hierarchy (usually equivalent to `visible`) */
-    activeSelf: boolean;
-    /** call to destroy this object including all components that are attached to it. Will destroy all children recursively */
-    destroy(): void;
-    /** NOTE: this is just a wrapper for devs coming from Unity. Please use this.gameObject instead. In Needle Engine this.gameObject is the same as this.gameObject.transform. See the tutorial link below for more information
-     * @augments Object3D
-     * @tutorial https://fwd.needle.tools/needle-engine/docs/transform
-     * */
-    get transform(): IGameObject;
-    /** Add a new component to this object. Expects a component type (e.g. `addNewComponent(Animator)`) */
-    addNewComponent<T>(type: Constructor<T>): T | null;
-    /** Remove a component from this object. Expected a component instance
-     * @returns the removed component (equal to the passed in component)
-     */
-    removeComponent(comp: IComponent): IComponent;
-    /** Searches for a component type on this object. If no component of the searched type exists yet a new instance will be created and returned */
-    getOrAddComponent<T>(typeName: Constructor<T> | null): T;
-    /** Tries to find a component of a type on this object.
-     * @returns the first instance of a component on this object that matches the passed in type or null if no component of this type (or a subtype) exists */
-    getComponent<T>(type: Constructor<T>): T | null;
-    /** @returns all components of a certain type on this object */
-    getComponents<T>(type: Constructor<T>, arr?: T[]): Array<T>;
-    /** Finds a component of a certain type on this object OR a child object if any exists */
-    getComponentInChildren<T>(type: Constructor<T>): T | null;
-    /** Finds all components of a certain type on this object AND all children (recursively) */
-    getComponentsInChildren<T>(type: Constructor<T>, arr?: T[]): Array<T>;
-    /** Finds a component of a certain type on this object OR a parent object if any exists */
-    getComponentInParent<T>(type: Constructor<T>): T | null;
-    /** Finds all components of a certain type on this object AND all parents (recursively) */
-    getComponentsInParent<T>(type: Constructor<T>, arr?: T[]): Array<T>;
-    get worldPosition(): Vector3;
-    set worldPosition(val: Vector3);
-    get worldQuaternion(): Quaternion;
-    set worldQuaternion(val: Quaternion);
-    get worldRotation(): Vector3;
-    set worldRotation(val: Vector3);
-    get worldScale(): Vector3;
-    set worldScale(val: Vector3);
-    get worldForward(): Vector3;
-    get worldRight(): Vector3;
-    get worldUp(): Vector3;
-}
-export interface IHasGuid {
-    guid: string;
-}
-export interface IComponent extends IHasGuid {
-    get isComponent(): boolean;
-    /** the object this component is attached to */
-    gameObject: IGameObject;
-    enabled: boolean;
-    sourceId?: SourceIdentifier;
-    get name(): string;
-    get layer(): number;
-    get destroyed(): boolean;
-    get tag(): string;
-    context: any;
-    get activeAndEnabled(): boolean;
-    /** @internal */
-    __internalNewInstanceCreated(): any;
-    /** @internal */
-    __internalAwake(): any;
-    /** @internal */
-    __internalStart(): any;
-    /** @internal */
-    __internalEnable(isAddingOrRemovingFromScene?: boolean): any;
-    /** @internal */
-    __internalDisable(isAddingOrRemovingFromScene?: boolean): any;
-    /** @internal */
-    __internalDestroy(): any;
-    /** @internal */
-    resolveGuids?(guidsMap: GuidsMap): void;
-    /** experimental, called when the script is registered for the first time, this is called even if the component is not enabled. */
-    registering?(): any;
-    awake(): any;
-    onEnable(): any;
-    onDisable(): any;
-    onDestroy(): any;
-    destroy(): any;
-    /** called for properties decorated with the @validate decorator */
-    onValidate?(property?: string): any;
-    /** called when this.context.isPaused changes or when rendering loop changes due to changing DOM element visibility
-     * e.g. when the DOM element becomes hidden or out ot view
-     */
-    onPausedChanged?(isPaused: boolean, wasPaused: boolean): any;
-    start?(): void;
-    earlyUpdate?(): void;
-    update?(): void;
-    lateUpdate?(): void;
-    onBeforeRender?(frame: XRFrame | null): void;
-    onAfterRender?(): void;
-    onCollisionEnter?(col: Collision): any;
-    onCollisionExit?(col: Collision): any;
-    onCollisionStay?(col: Collision): any;
-    onTriggerEnter?(col: ICollider): any;
-    onTriggerStay?(col: ICollider): any;
-    onTriggerExit?(col: ICollider): any;
-    get forward(): Vector3;
-    get worldPosition(): Vector3;
-    get worldQuaternion(): Quaternion;
-}
-export declare interface ICamera extends IComponent {
-    get isCamera(): boolean;
-    applyClearFlagsIfIsActiveCamera(): unknown;
-    applyClearFlags(): any;
-    buildCamera(): any;
-    get cam(): Camera;
-    nearClipPlane: number;
-    farClipPlane: number;
-    backgroundColor: RGBAColor | null;
-    backgroundBlurriness: number | undefined;
-    environmentIntensity: number | undefined;
-    clearFlags: number;
-    cullingMask: number;
-    aspect: number;
-    fieldOfView?: number;
-    /** x and y are in pixel on the canvas / dom element */
-    screenPointToRay(x: number, y: number, ray?: Ray): Ray;
-    targetTexture: RenderTexture | null;
-}
-export declare interface ICameraController {
-    get isCameraController(): boolean;
-}
-export declare interface ILight extends IComponent {
-    intensity: number;
-    color: Color;
-}
-export declare interface ISharedMaterials {
-    [num: number]: Material;
-    get length(): number;
-}
-export declare interface IRenderer extends IComponent {
-    sharedMaterial: Material;
-    get sharedMaterials(): ISharedMaterials;
-}
-export declare interface ICollider extends IComponent {
-    get isCollider(): any;
-    attachedRigidbody: IRigidbody | null;
-    isTrigger: boolean;
-    sharedMaterial?: PhysicsMaterial;
-    center?: Vec3 & {
-        multiply(vec: Vec3): any;
-    };
-    updateProperties(): void;
-    updatePhysicsMaterial(): void;
-}
-export declare interface ISphereCollider extends ICollider {
-    radius: number;
-}
-export declare interface IBoxCollider extends ICollider {
-    size: Vec3;
-}
-export declare interface IRigidbody extends IComponent {
-    constraints: RigidbodyConstraints;
-    isKinematic: boolean;
-    /** When true the mass will automatically calculated by attached colliders */
-    autoMass: boolean;
-    mass: number;
-    drag: number;
-    angularDrag: number;
-    useGravity: boolean;
-    gravityScale: number;
-    dominanceGroup: number;
-    collisionDetectionMode: CollisionDetectionMode;
-    lockPositionX: boolean;
-    lockPositionY: boolean;
-    lockPositionZ: boolean;
-    lockRotationX: boolean;
-    lockRotationY: boolean;
-    lockRotationZ: boolean;
-}
-export declare const $physicsKey: unique symbol;
-export declare type ICollisionContext = {
-    getCollider(obj: Object3D): ICollider;
-};
-export type Vec2 = {
-    x: number;
-    y: number;
-};
-export type Vec3 = {
-    x: number;
-    y: number;
-    z: number;
-};
-export type Vec4 = {
-    x: number;
-    y: number;
-    z: number;
-    w: number;
-};
-export declare class ContactPoint {
-    private readonly _point;
-    private readonly _normal;
-    private readonly _tangentVelocity;
-    /** the distance of the collision point */
-    readonly distance: number;
-    /** the impulse velocity */
-    readonly impulse: number;
-    readonly friction: number;
-    /** worldspace point */
-    get point(): Vector3;
-    /** worldspace normal */
-    get normal(): Vector3;
-    /** worldspace tangent */
-    get tangentVelocity(): Vector3;
-    constructor(point: Vec3, dist: number, normal: Vec3, impulse: number, friction: number, tangentVelocity: Vec3);
-}
-export declare class Collision {
-    /** The contact points of this collision. Contains information about positions, normals, distance, friction, impulse... */
-    readonly contacts: ContactPoint[];
-    constructor(obj: IGameObject, otherCollider: ICollider, contacts: ContactPoint[]);
-    /** the gameobject this collision event belongs to (e.g. if onCollisionEnter is called then `me` is the same as `this.gameObject`) */
-    readonly me: IGameObject;
-    private _collider;
-    /** the other collider the collision happened with */
-    get collider(): ICollider;
-    private _gameObject;
-    /** the other object the collision happened with */
-    get gameObject(): IGameObject;
-    /** the other rigidbody we hit, null if none attached */
-    get rigidBody(): IRigidbody | null;
-}
-export type RaycastResult = null | {
-    point: Vector3;
-    collider: ICollider;
-    normal?: Vector3;
-};
-export declare class SphereOverlapResult {
-    object: Object3D;
-    collider: ICollider;
-    constructor(object: Object3D, collider: ICollider);
-}
-export interface IPhysicsEngine {
-    initialize(ctx: IContext): Promise<boolean>;
-    step(dt: number): void;
-    postStep(): any;
-    get isUpdating(): boolean;
-    /** clear all possibly cached data (e.g. mesh data when creating scaled mesh colliders) */
-    clearCaches(): any;
-    enabled: boolean;
-    get world(): any;
-    set gravity(vec3: Vec3);
-    get gravity(): Vec3;
-    /** Get the rapier body for a Needle component */
-    getBody(obj: ICollider | IRigidbody): null | any;
-    /** Get the Needle Engine component for a rapier object */
-    getComponent(rapierObject: object): IComponent | null;
-    /** Fast raycast against physics colliders
-     * @param origin ray origin in screen or worldspace
-     * @param direction ray direction in worldspace
-     * @param maxDistance max distance to raycast
-     * @param solid if true it will also hit the collider if origin is already inside it
-     */
-    raycast(origin?: Vec2 | Vec3, direction?: Vec3, maxDistance?: number, solid?: boolean): RaycastResult;
-    /** raycast that also gets the normal vector. If you don't need it use raycast() */
-    raycastAndGetNormal(origin?: Vec2 | Vec3, direction?: Vec3, maxDistance?: number, solid?: boolean): RaycastResult;
-    sphereOverlap(point: Vector3, radius: number): Array<SphereOverlapResult>;
-    addSphereCollider(collider: ICollider): any;
-    addBoxCollider(collider: ICollider, size: Vector3): any;
-    addCapsuleCollider(collider: ICollider, radius: number, height: number): any;
-    addMeshCollider(collider: ICollider, mesh: Mesh, convex: boolean, scale: Vector3): any;
-    updatePhysicsMaterial(collider: ICollider): any;
-    wakeup(rb: IRigidbody): any;
-    updateProperties(rb: IRigidbody | ICollider): any;
-    resetForces(rb: IRigidbody, wakeup: boolean): any;
-    resetTorques(rb: IRigidbody, wakeup: boolean): any;
-    addForce(rb: IRigidbody, vec: Vec3, wakeup: boolean): any;
-    applyImpulse(rb: IRigidbody, vec: Vec3, wakeup: boolean): any;
-    /** Returns the linear velocity of a rigidbody or the rigidbody of a collider */
-    getLinearVelocity(rb: IRigidbody | ICollider): Vec3 | null;
-    getAngularVelocity(rb: IRigidbody): Vec3 | null;
-    setAngularVelocity(rb: IRigidbody, vec: Vec3, wakeup: boolean): any;
-    setLinearVelocity(rb: IRigidbody, vec: Vec3, wakeup: boolean): any;
-    updateBody(comp: ICollider | IRigidbody, translation: boolean, rotation: boolean): any;
-    removeBody(body: IComponent): any;
-    getBody(obj: ICollider | IRigidbody): null | any;
-    addFixedJoint(body1: IRigidbody, body2: IRigidbody): any;
-    addHingeJoint(body1: IRigidbody, body2: IRigidbody, anchor: Vec3, axis: Vec3): any;
-    /** Enable to render collider shapes */
-    debugRenderColliders: boolean;
-}
+/// <reference types="webxr" />
+import { RenderTexture } from "./engine_texture.js";
+import type { Camera, Color, Material, Object3D, Quaternion, Ray, Scene, WebGLRenderer, Mesh } from "three";
+import { Vector3 } from "three";
+import { RGBAColor } from "../engine-components/js-extensions/RGBAColor.js";
+import { CollisionDetectionMode, type PhysicsMaterial, RigidbodyConstraints } from "./engine_physics.types.js";
+import { type GLTF as GLTF3 } from "three/examples/jsm/loaders/GLTFLoader.js";
+export type GLTF = GLTF3 & {};
+export type LoadedGLTF = {
+    src: string;
+    file: GLTF;
+};
+/** used to find data registered via gltf files e.g. find lightmaps for a Renderer component that were shipped inside a gltf */
+export declare type SourceIdentifier = string;
+export type Constructor<T> = abstract new (...args: any[]) => T;
+export type ConstructorConcrete<T> = new (...args: any[]) => T;
+export type GuidsMap = {
+    [key: string]: string;
+};
+export interface UIDProvider {
+    seed: number;
+    generateUUID(): string;
+}
+export declare type CoroutineData = {
+    comp: IComponent;
+    main: Generator;
+    chained?: Array<Generator>;
+};
+export interface ITime {
+    get time(): number;
+}
+export interface IInput {
+    convertScreenspaceToRaycastSpace(vec: Vec2): void;
+    getPointerPosition(i: number): Vec2 | null;
+}
+export interface IPhysics {
+    engine?: IPhysicsEngine;
+}
+export interface IContext {
+    alias?: string | null;
+    hash?: string;
+    scene: Scene;
+    renderer: WebGLRenderer;
+    mainCamera: Camera | null;
+    mainCameraComponent: ICamera | undefined;
+    domElement: HTMLElement;
+    time: ITime;
+    input: IInput;
+    physics: IPhysics;
+    scripts: IComponent[];
+    scripts_pausedChanged: IComponent[];
+    scripts_earlyUpdate: IComponent[];
+    scripts_update: IComponent[];
+    scripts_lateUpdate: IComponent[];
+    scripts_onBeforeRender: IComponent[];
+    scripts_onAfterRender: IComponent[];
+    scripts_WithCorroutines: IComponent[];
+    coroutines: {
+        [FrameEvent: number]: Array<CoroutineData>;
+    };
+    post_setup_callbacks: Function[];
+    pre_update_callbacks: Function[];
+    pre_render_callbacks: Function[];
+    post_render_callbacks: Function[];
+    new_scripts: IComponent[];
+    new_script_start: IComponent[];
+    new_scripts_pre_setup_callbacks: Function[];
+    new_scripts_post_setup_callbacks: Function[];
+    stopAllCoroutinesFrom(script: IComponent): any;
+}
+export declare interface INeedleEngineComponent extends HTMLElement {
+    getAROverlayContainer(): HTMLElement;
+    onEnterAR(session: XRSession, overlayContainer: HTMLElement): any;
+    onExitAR(session: XRSession): any;
+}
+export declare interface IGameObject extends Object3D {
+    /** the object's unique identifier */
+    guid: string | undefined;
+    /** if the object is enabled in the hierarchy (usually equivalent to `visible`) */
+    activeSelf: boolean;
+    /** call to destroy this object including all components that are attached to it. Will destroy all children recursively */
+    destroy(): void;
+    /** NOTE: this is just a wrapper for devs coming from Unity. Please use this.gameObject instead. In Needle Engine this.gameObject is the same as this.gameObject.transform. See the tutorial link below for more information
+     * @augments Object3D
+     * @tutorial https://fwd.needle.tools/needle-engine/docs/transform
+     * */
+    get transform(): IGameObject;
+    /** Add a new component to this object. Expects a component type (e.g. `addNewComponent(Animator)`) */
+    addNewComponent<T>(type: Constructor<T>): T | null;
+    /** Remove a component from this object. Expected a component instance
+     * @returns the removed component (equal to the passed in component)
+     */
+    removeComponent(comp: IComponent): IComponent;
+    /** Searches for a component type on this object. If no component of the searched type exists yet a new instance will be created and returned */
+    getOrAddComponent<T>(typeName: Constructor<T> | null): T;
+    /** Tries to find a component of a type on this object.
+     * @returns the first instance of a component on this object that matches the passed in type or null if no component of this type (or a subtype) exists */
+    getComponent<T>(type: Constructor<T>): T | null;
+    /** @returns all components of a certain type on this object */
+    getComponents<T>(type: Constructor<T>, arr?: T[]): Array<T>;
+    /** Finds a component of a certain type on this object OR a child object if any exists */
+    getComponentInChildren<T>(type: Constructor<T>): T | null;
+    /** Finds all components of a certain type on this object AND all children (recursively) */
+    getComponentsInChildren<T>(type: Constructor<T>, arr?: T[]): Array<T>;
+    /** Finds a component of a certain type on this object OR a parent object if any exists */
+    getComponentInParent<T>(type: Constructor<T>): T | null;
+    /** Finds all components of a certain type on this object AND all parents (recursively) */
+    getComponentsInParent<T>(type: Constructor<T>, arr?: T[]): Array<T>;
+    get worldPosition(): Vector3;
+    set worldPosition(val: Vector3);
+    get worldQuaternion(): Quaternion;
+    set worldQuaternion(val: Quaternion);
+    get worldRotation(): Vector3;
+    set worldRotation(val: Vector3);
+    get worldScale(): Vector3;
+    set worldScale(val: Vector3);
+    get worldForward(): Vector3;
+    get worldRight(): Vector3;
+    get worldUp(): Vector3;
+}
+export interface IHasGuid {
+    guid: string;
+}
+export interface IComponent extends IHasGuid {
+    get isComponent(): boolean;
+    /** the object this component is attached to */
+    gameObject: IGameObject;
+    enabled: boolean;
+    sourceId?: SourceIdentifier;
+    get name(): string;
+    get layer(): number;
+    get destroyed(): boolean;
+    get tag(): string;
+    context: any;
+    get activeAndEnabled(): boolean;
+    /** @internal */
+    __internalNewInstanceCreated(): any;
+    /** @internal */
+    __internalAwake(): any;
+    /** @internal */
+    __internalStart(): any;
+    /** @internal */
+    __internalEnable(isAddingOrRemovingFromScene?: boolean): any;
+    /** @internal */
+    __internalDisable(isAddingOrRemovingFromScene?: boolean): any;
+    /** @internal */
+    __internalDestroy(): any;
+    /** @internal */
+    resolveGuids?(guidsMap: GuidsMap): void;
+    /** experimental, called when the script is registered for the first time, this is called even if the component is not enabled. */
+    registering?(): any;
+    awake(): any;
+    onEnable(): any;
+    onDisable(): any;
+    onDestroy(): any;
+    destroy(): any;
+    /** called for properties decorated with the @validate decorator */
+    onValidate?(property?: string): any;
+    /** called when this.context.isPaused changes or when rendering loop changes due to changing DOM element visibility
+     * e.g. when the DOM element becomes hidden or out ot view
+     */
+    onPausedChanged?(isPaused: boolean, wasPaused: boolean): any;
+    start?(): void;
+    earlyUpdate?(): void;
+    update?(): void;
+    lateUpdate?(): void;
+    onBeforeRender?(frame: XRFrame | null): void;
+    onAfterRender?(): void;
+    onCollisionEnter?(col: Collision): any;
+    onCollisionExit?(col: Collision): any;
+    onCollisionStay?(col: Collision): any;
+    onTriggerEnter?(col: ICollider): any;
+    onTriggerStay?(col: ICollider): any;
+    onTriggerExit?(col: ICollider): any;
+    get forward(): Vector3;
+    get worldPosition(): Vector3;
+    get worldQuaternion(): Quaternion;
+}
+export declare interface ICamera extends IComponent {
+    get isCamera(): boolean;
+    applyClearFlagsIfIsActiveCamera(): unknown;
+    applyClearFlags(): any;
+    buildCamera(): any;
+    get cam(): Camera;
+    nearClipPlane: number;
+    farClipPlane: number;
+    backgroundColor: RGBAColor | null;
+    backgroundBlurriness: number | undefined;
+    environmentIntensity: number | undefined;
+    clearFlags: number;
+    cullingMask: number;
+    aspect: number;
+    fieldOfView?: number;
+    /** x and y are in pixel on the canvas / dom element */
+    screenPointToRay(x: number, y: number, ray?: Ray): Ray;
+    targetTexture: RenderTexture | null;
+}
+export declare interface ICameraController {
+    get isCameraController(): boolean;
+}
+export declare interface ILight extends IComponent {
+    intensity: number;
+    color: Color;
+}
+export declare interface ISharedMaterials {
+    [num: number]: Material;
+    get length(): number;
+}
+export declare interface IRenderer extends IComponent {
+    sharedMaterial: Material;
+    get sharedMaterials(): ISharedMaterials;
+}
+export declare interface ICollider extends IComponent {
+    get isCollider(): any;
+    attachedRigidbody: IRigidbody | null;
+    isTrigger: boolean;
+    sharedMaterial?: PhysicsMaterial;
+    center?: Vec3 & {
+        multiply(vec: Vec3): any;
+    };
+    updateProperties(): void;
+    updatePhysicsMaterial(): void;
+}
+export declare interface ISphereCollider extends ICollider {
+    radius: number;
+}
+export declare interface IBoxCollider extends ICollider {
+    size: Vec3;
+}
+export declare interface IRigidbody extends IComponent {
+    constraints: RigidbodyConstraints;
+    isKinematic: boolean;
+    /** When true the mass will automatically calculated by attached colliders */
+    autoMass: boolean;
+    mass: number;
+    drag: number;
+    angularDrag: number;
+    useGravity: boolean;
+    gravityScale: number;
+    dominanceGroup: number;
+    collisionDetectionMode: CollisionDetectionMode;
+    lockPositionX: boolean;
+    lockPositionY: boolean;
+    lockPositionZ: boolean;
+    lockRotationX: boolean;
+    lockRotationY: boolean;
+    lockRotationZ: boolean;
+}
+export declare const $physicsKey: unique symbol;
+export declare type ICollisionContext = {
+    getCollider(obj: Object3D): ICollider;
+};
+export type Vec2 = {
+    x: number;
+    y: number;
+};
+export type Vec3 = {
+    x: number;
+    y: number;
+    z: number;
+};
+export type Vec4 = {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+};
+export declare class ContactPoint {
+    private readonly _point;
+    private readonly _normal;
+    private readonly _tangentVelocity;
+    /** the distance of the collision point */
+    readonly distance: number;
+    /** the impulse velocity */
+    readonly impulse: number;
+    readonly friction: number;
+    /** worldspace point */
+    get point(): Vector3;
+    /** worldspace normal */
+    get normal(): Vector3;
+    /** worldspace tangent */
+    get tangentVelocity(): Vector3;
+    constructor(point: Vec3, dist: number, normal: Vec3, impulse: number, friction: number, tangentVelocity: Vec3);
+}
+export declare class Collision {
+    /** The contact points of this collision. Contains information about positions, normals, distance, friction, impulse... */
+    readonly contacts: ContactPoint[];
+    constructor(obj: IGameObject, otherCollider: ICollider, contacts: ContactPoint[]);
+    /** the gameobject this collision event belongs to (e.g. if onCollisionEnter is called then `me` is the same as `this.gameObject`) */
+    readonly me: IGameObject;
+    private _collider;
+    /** the other collider the collision happened with */
+    get collider(): ICollider;
+    private _gameObject;
+    /** the other object the collision happened with */
+    get gameObject(): IGameObject;
+    /** the other rigidbody we hit, null if none attached */
+    get rigidBody(): IRigidbody | null;
+}
+export type RaycastResult = null | {
+    point: Vector3;
+    collider: ICollider;
+    normal?: Vector3;
+};
+export declare class SphereOverlapResult {
+    object: Object3D;
+    collider: ICollider;
+    constructor(object: Object3D, collider: ICollider);
+}
+export interface IPhysicsEngine {
+    initialize(ctx: IContext): Promise<boolean>;
+    step(dt: number): void;
+    postStep(): any;
+    get isUpdating(): boolean;
+    /** clear all possibly cached data (e.g. mesh data when creating scaled mesh colliders) */
+    clearCaches(): any;
+    enabled: boolean;
+    get world(): any;
+    set gravity(vec3: Vec3);
+    get gravity(): Vec3;
+    /** Get the rapier body for a Needle component */
+    getBody(obj: ICollider | IRigidbody): null | any;
+    /** Get the Needle Engine component for a rapier object */
+    getComponent(rapierObject: object): IComponent | null;
+    /** Fast raycast against physics colliders
+     * @param origin ray origin in screen or worldspace
+     * @param direction ray direction in worldspace
+     * @param maxDistance max distance to raycast
+     * @param solid if true it will also hit the collider if origin is already inside it
+     */
+    raycast(origin?: Vec2 | Vec3, direction?: Vec3, maxDistance?: number, solid?: boolean): RaycastResult;
+    /** raycast that also gets the normal vector. If you don't need it use raycast() */
+    raycastAndGetNormal(origin?: Vec2 | Vec3, direction?: Vec3, maxDistance?: number, solid?: boolean): RaycastResult;
+    sphereOverlap(point: Vector3, radius: number): Array<SphereOverlapResult>;
+    addSphereCollider(collider: ICollider): any;
+    addBoxCollider(collider: ICollider, size: Vector3): any;
+    addCapsuleCollider(collider: ICollider, radius: number, height: number): any;
+    addMeshCollider(collider: ICollider, mesh: Mesh, convex: boolean, scale: Vector3): any;
+    updatePhysicsMaterial(collider: ICollider): any;
+    wakeup(rb: IRigidbody): any;
+    updateProperties(rb: IRigidbody | ICollider): any;
+    resetForces(rb: IRigidbody, wakeup: boolean): any;
+    resetTorques(rb: IRigidbody, wakeup: boolean): any;
+    addForce(rb: IRigidbody, vec: Vec3, wakeup: boolean): any;
+    applyImpulse(rb: IRigidbody, vec: Vec3, wakeup: boolean): any;
+    /** Returns the linear velocity of a rigidbody or the rigidbody of a collider */
+    getLinearVelocity(rb: IRigidbody | ICollider): Vec3 | null;
+    getAngularVelocity(rb: IRigidbody): Vec3 | null;
+    setAngularVelocity(rb: IRigidbody, vec: Vec3, wakeup: boolean): any;
+    setLinearVelocity(rb: IRigidbody, vec: Vec3, wakeup: boolean): any;
+    updateBody(comp: ICollider | IRigidbody, translation: boolean, rotation: boolean): any;
+    removeBody(body: IComponent): any;
+    getBody(obj: ICollider | IRigidbody): null | any;
+    addFixedJoint(body1: IRigidbody, body2: IRigidbody): any;
+    addHingeJoint(body1: IRigidbody, body2: IRigidbody, anchor: Vec3, axis: Vec3): any;
+    /** Enable to render collider shapes */
+    debugRenderColliders: boolean;
+}