@zylem/game-lib 0.6.0 → 0.6.3

package/dist/entity-COvRtFNG.d.ts

@@ -1,395 +0,0 @@
-import { Vector3, Vector2, Color, Material, BufferGeometry, Mesh, Group, ShaderMaterial } from 'three';
-import { Vector3 as Vector3$1, RigidBodyDesc, ColliderDesc, RigidBody, Collider } from '@dimforge/rapier3d-compat';
-import { IComponent } from 'bitecs';
-
-/** Input
- *
- * Maximum number of local players is 8.
- * All input can be mapped to a gamepad or keyboard but shares the common
- * interface represented as a gamepad.
- */
-type InputPlayerNumber = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
-type InputPlayer = `p${InputPlayerNumber}`;
-interface ButtonState {
-    pressed: boolean;
-    released: boolean;
-    held: number;
-}
-interface AnalogState {
-    value: number;
-    held: number;
-}
-interface InputGamepad {
-    playerNumber: InputPlayerNumber;
-    buttons: {
-        A: ButtonState;
-        B: ButtonState;
-        X: ButtonState;
-        Y: ButtonState;
-        Start: ButtonState;
-        Select: ButtonState;
-        L: ButtonState;
-        R: ButtonState;
-    };
-    directions: {
-        Up: ButtonState;
-        Down: ButtonState;
-        Left: ButtonState;
-        Right: ButtonState;
-    };
-    shoulders: {
-        LTrigger: ButtonState;
-        RTrigger: ButtonState;
-    };
-    axes: {
-        Horizontal: AnalogState;
-        Vertical: AnalogState;
-    };
-}
-type Inputs = Record<InputPlayer, InputGamepad>;
-
-type LoadingEvent = {
-    type: 'start' | 'progress' | 'complete';
-    message?: string;
-    progress?: number;
-    total?: number;
-    current?: number;
-};
-interface IGame<TGlobals extends Record<string, unknown> = any> {
-    start: () => Promise<this>;
-    nextStage: () => void;
-    previousStage: () => void;
-    reset: () => Promise<void>;
-    pause: () => Promise<void>;
-    resume: () => Promise<void>;
-    onLoading: (callback: (event: LoadingEvent) => void) => void;
-    loadStageFromId: (stageId: string) => Promise<void>;
-    end: () => Promise<void>;
-    goToStage: () => void;
-}
-interface IStage {
-    onUpdate: (callback: UpdateFunction<IStage>) => void;
-    onSetup: (callback: SetupFunction<IStage>) => void;
-    onDestroy: (callback: DestroyFunction<IStage>) => void;
-}
-interface ICamera {
-    move: (position: Vector3) => void;
-    rotate: (pitch: number, yaw: number, roll: number) => void;
-}
-
-type GlobalRecord = Record<string, unknown>;
-/** Setup */
-interface SetupContext<T, TGlobals extends GlobalRecord = any> {
-    me: T;
-    globals: TGlobals;
-    inputs?: Inputs;
-    camera?: ICamera;
-    stage?: IStage;
-    game?: IGame<TGlobals>;
-}
-interface SetupFunction<T, TGlobals extends GlobalRecord = any> {
-    (context: SetupContext<T, TGlobals>): void;
-}
-/** Loaded */
-interface LoadedContext<T, TGlobals extends GlobalRecord = any> {
-    me: T;
-    globals: TGlobals;
-}
-interface LoadedFunction<T, TGlobals extends GlobalRecord = any> {
-    (context: LoadedContext<T, TGlobals>): void;
-}
-/** Update */
-type UpdateContext<T, TGlobals extends GlobalRecord = any> = {
-    me: T;
-    delta: number;
-    inputs: Inputs;
-    globals: TGlobals;
-    camera: ICamera;
-    stage?: IStage;
-    game?: IGame<TGlobals>;
-};
-interface UpdateFunction<T, TGlobals extends GlobalRecord = any> {
-    (context: UpdateContext<T, TGlobals>): void;
-}
-/** Destroy */
-interface DestroyContext<T, TGlobals extends GlobalRecord = any> {
-    me: T;
-    globals: TGlobals;
-}
-interface DestroyFunction<T, TGlobals extends GlobalRecord = any> {
-    (context: DestroyContext<T, TGlobals>): void;
-}
-/** Cleanup */
-interface CleanupContext<T, TGlobals extends GlobalRecord = any> {
-    me: T;
-    globals: TGlobals;
-}
-interface CleanupFunction<T, TGlobals extends GlobalRecord = any> {
-    (context: CleanupContext<T, TGlobals>): void;
-}
-
-interface NodeInterface {
-    uuid: string;
-    name: string;
-    markedForRemoval: boolean;
-    nodeSetup(params: SetupContext<any>): void;
-    nodeUpdate(params: UpdateContext<any>): void;
-    nodeDestroy(params: DestroyContext<any>): void;
-    setParent(parent: NodeInterface | null): void;
-    getParent(): NodeInterface | null;
-}
-
-type BaseNodeOptions<T = any> = BaseNode | Partial<T>;
-/**
- * Lifecycle callback arrays - each lifecycle event can have multiple callbacks
- * that execute in order.
- */
-interface LifecycleCallbacks<T> {
-    setup: Array<SetupFunction<T>>;
-    loaded: Array<LoadedFunction<T>>;
-    update: Array<UpdateFunction<T>>;
-    destroy: Array<DestroyFunction<T>>;
-    cleanup: Array<CleanupFunction<T>>;
-}
-declare abstract class BaseNode<Options = any, T = any> implements NodeInterface {
-    protected parent: NodeInterface | null;
-    protected children: NodeInterface[];
-    options: Options;
-    eid: number;
-    uuid: string;
-    name: string;
-    markedForRemoval: boolean;
-    /**
-     * Lifecycle callback arrays - use onSetup(), onUpdate(), etc. to add callbacks
-     */
-    protected lifecycleCallbacks: LifecycleCallbacks<this>;
-    constructor(args?: BaseNodeOptions[]);
-    /**
-     * Add setup callbacks to be executed in order during nodeSetup
-     */
-    onSetup(...callbacks: Array<SetupFunction<this>>): this;
-    /**
-     * Add loaded callbacks to be executed in order during nodeLoaded
-     */
-    onLoaded(...callbacks: Array<LoadedFunction<this>>): this;
-    /**
-     * Add update callbacks to be executed in order during nodeUpdate
-     */
-    onUpdate(...callbacks: Array<UpdateFunction<this>>): this;
-    /**
-     * Add destroy callbacks to be executed in order during nodeDestroy
-     */
-    onDestroy(...callbacks: Array<DestroyFunction<this>>): this;
-    /**
-     * Add cleanup callbacks to be executed in order during nodeCleanup
-     */
-    onCleanup(...callbacks: Array<CleanupFunction<this>>): this;
-    /**
-     * Prepend setup callbacks (run before existing ones)
-     */
-    prependSetup(...callbacks: Array<SetupFunction<this>>): this;
-    /**
-     * Prepend update callbacks (run before existing ones)
-     */
-    prependUpdate(...callbacks: Array<UpdateFunction<this>>): this;
-    setParent(parent: NodeInterface | null): void;
-    getParent(): NodeInterface | null;
-    add(baseNode: NodeInterface): void;
-    remove(baseNode: NodeInterface): void;
-    getChildren(): NodeInterface[];
-    isComposite(): boolean;
-    abstract create(): T;
-    protected abstract _setup(params: SetupContext<this>): void;
-    protected abstract _loaded(params: LoadedContext<this>): Promise<void>;
-    protected abstract _update(params: UpdateContext<this>): void;
-    protected abstract _destroy(params: DestroyContext<this>): void;
-    protected abstract _cleanup(params: CleanupContext<this>): Promise<void>;
-    nodeSetup(params: SetupContext<this>): void;
-    nodeUpdate(params: UpdateContext<this>): void;
-    nodeDestroy(params: DestroyContext<this>): void;
-    nodeLoaded(params: LoadedContext<this>): Promise<void>;
-    nodeCleanup(params: CleanupContext<this>): Promise<void>;
-    getOptions(): Options;
-    setOptions(options: Partial<Options>): void;
-}
-
-type Vec3 = Vector3 | Vector3$1;
-
-declare function shortHash(objString: string): string;
-
-type ZylemShaderType = 'standard' | 'fire' | 'star' | 'debug';
-
-interface MaterialOptions {
-    path?: string;
-    repeat?: Vector2;
-    shader?: ZylemShaderType;
-    color?: Color;
-}
-type BatchGeometryMap = Map<symbol, number>;
-interface BatchMaterialMapObject {
-    geometryMap: BatchGeometryMap;
-    material: Material;
-}
-type BatchKey = ReturnType<typeof shortHash>;
-type TexturePath = string | null;
-declare class MaterialBuilder {
-    static batchMaterialMap: Map<BatchKey, BatchMaterialMapObject>;
-    materials: Material[];
-    batchMaterial(options: Partial<MaterialOptions>, entityType: symbol): void;
-    build(options: Partial<MaterialOptions>, entityType: symbol): Promise<void>;
-    withColor(color: Color): this;
-    withShader(shaderType: ZylemShaderType): this;
-    setTexture(texturePath?: TexturePath, repeat?: Vector2): Promise<void>;
-    setColor(color: Color): void;
-    setShader(customShader: ZylemShaderType): void;
-}
-
-/**
- * Options for configuring entity collision behavior.
- */
-interface CollisionOptions {
-    static?: boolean;
-    sensor?: boolean;
-    size?: Vector3$1;
-    position?: Vector3$1;
-    collisionType?: string;
-    collisionFilter?: string[];
-}
-declare class CollisionBuilder {
-    static: boolean;
-    sensor: boolean;
-    gravity: Vec3;
-    build(options: Partial<CollisionOptions>): [RigidBodyDesc, ColliderDesc];
-    withCollision(collisionOptions: Partial<CollisionOptions>): this;
-    collider(options: CollisionOptions): ColliderDesc;
-    bodyDesc({ isDynamicBody }: {
-        isDynamicBody?: boolean | undefined;
-    }): RigidBodyDesc;
-}
-
-/**
- * TODO: allow for multiple materials requires geometry groups
- * TODO: allow for instanced uniforms
- * TODO: allow for geometry groups
- * TODO: allow for batched meshes
- * import { InstancedUniformsMesh } from 'three-instanced-uniforms-mesh';
- * may not need geometry groups for shaders though
- * setGeometry<T extends BufferGeometry>(geometry: T) {
- *   MeshBuilder.bachedMesh = new BatchedMesh(10, 5000, 10000, material);
- * }
- */
-type MeshBuilderOptions = Partial<Pick<GameEntityOptions, 'batched' | 'material'>>;
-declare class MeshBuilder {
-    _build(meshOptions: MeshBuilderOptions, geometry: BufferGeometry, materials: Material[]): Mesh;
-    _postBuild(): void;
-}
-
-declare abstract class EntityCollisionBuilder extends CollisionBuilder {
-    abstract collider(options: GameEntityOptions): ColliderDesc;
-}
-declare abstract class EntityMeshBuilder extends MeshBuilder {
-    build(options: GameEntityOptions): BufferGeometry;
-    postBuild(): void;
-}
-
-interface Behavior {
-    component: IComponent;
-    values: any;
-}
-
-interface CollisionContext<T, O extends GameEntityOptions, TGlobals extends Record<string, unknown> = any> {
-    entity: T;
-    other: GameEntity<O>;
-    globals: TGlobals;
-}
-type BehaviorContext<T, O extends GameEntityOptions> = SetupContext<T, O> | UpdateContext<T, O> | CollisionContext<T, O> | DestroyContext<T, O>;
-type BehaviorCallback<T, O extends GameEntityOptions> = (params: BehaviorContext<T, O>) => void;
-interface CollisionDelegate<T, O extends GameEntityOptions> {
-    collision?: ((params: CollisionContext<T, O>) => void)[];
-}
-type IBuilder<BuilderOptions = any> = {
-    preBuild: (options: BuilderOptions) => BuilderOptions;
-    build: (options: BuilderOptions) => BuilderOptions;
-    postBuild: (options: BuilderOptions) => BuilderOptions;
-};
-type GameEntityOptions = {
-    name?: string;
-    color?: Color;
-    size?: Vec3;
-    position?: Vec3;
-    batched?: boolean;
-    collision?: Partial<CollisionOptions>;
-    material?: Partial<MaterialOptions>;
-    custom?: {
-        [key: string]: any;
-    };
-    collisionType?: string;
-    collisionGroup?: string;
-    collisionFilter?: string[];
-    _builders?: {
-        meshBuilder?: IBuilder | EntityMeshBuilder | null;
-        collisionBuilder?: IBuilder | EntityCollisionBuilder | null;
-        materialBuilder?: MaterialBuilder | null;
-    };
-};
-declare abstract class GameEntityLifeCycle {
-    abstract _setup(params: SetupContext<this>): void;
-    abstract _update(params: UpdateContext<this>): void;
-    abstract _destroy(params: DestroyContext<this>): void;
-}
-interface EntityDebugInfo {
-    buildInfo: () => Record<string, string>;
-}
-type BehaviorCallbackType = 'setup' | 'update' | 'destroy' | 'collision';
-declare class GameEntity<O extends GameEntityOptions> extends BaseNode<O> implements GameEntityLifeCycle, EntityDebugInfo {
-    behaviors: Behavior[];
-    group: Group | undefined;
-    mesh: Mesh | undefined;
-    materials: Material[] | undefined;
-    bodyDesc: RigidBodyDesc | null;
-    body: RigidBody | null;
-    colliderDesc: ColliderDesc | undefined;
-    collider: Collider | undefined;
-    custom: Record<string, any>;
-    debugInfo: Record<string, any>;
-    debugMaterial: ShaderMaterial | undefined;
-    collisionDelegate: CollisionDelegate<this, O>;
-    collisionType?: string;
-    behaviorCallbackMap: Record<BehaviorCallbackType, BehaviorCallback<this, O>[]>;
-    constructor();
-    create(): this;
-    /**
-     * Add collision callbacks
-     */
-    onCollision(...callbacks: ((params: CollisionContext<this, O>) => void)[]): this;
-    /**
-     * Entity-specific setup - runs behavior callbacks
-     * (User callbacks are handled by BaseNode's lifecycleCallbacks.setup)
-     */
-    _setup(params: SetupContext<this>): void;
-    protected _loaded(_params: LoadedContext<this>): Promise<void>;
-    /**
-     * Entity-specific update - updates materials and runs behavior callbacks
-     * (User callbacks are handled by BaseNode's lifecycleCallbacks.update)
-     */
-    _update(params: UpdateContext<this>): void;
-    /**
-     * Entity-specific destroy - runs behavior callbacks
-     * (User callbacks are handled by BaseNode's lifecycleCallbacks.destroy)
-     */
-    _destroy(params: DestroyContext<this>): void;
-    protected _cleanup(_params: CleanupContext<this>): Promise<void>;
-    _collision(other: GameEntity<O>, globals?: any): void;
-    addBehavior(behaviorCallback: ({
-        type: BehaviorCallbackType;
-        handler: any;
-    })): this;
-    addBehaviors(behaviorCallbacks: ({
-        type: BehaviorCallbackType;
-        handler: any;
-    })[]): this;
-    protected updateMaterials(params: any): void;
-    buildInfo(): Record<string, string>;
-}
-
-export { type AnalogState as A, type BehaviorCallbackType as B, type CleanupContext as C, type DestroyFunction as D, GameEntity as G, type InputGamepad as I, type LoadingEvent as L, type MaterialOptions as M, type SetupContext as S, type TexturePath as T, type UpdateContext as U, type Vec3 as V, type Behavior as a, type SetupFunction as b, type UpdateFunction as c, type DestroyContext as d, BaseNode as e, type InputPlayerNumber as f, type Inputs as g, type ButtonState as h, GameEntityLifeCycle as i, type IGame as j, type LoadedContext as k, type GameEntityOptions as l, type CollisionContext as m };

package/dist/moveable-B_vyA6cw.d.ts

@@ -1,67 +0,0 @@
-import { Vector3 } from 'three';
-import { RigidBody, Vector } from '@dimforge/rapier3d-compat';
-
-interface EntityWithBody {
-    body: RigidBody | null;
-}
-/**
- * Move entity based on a vector, adding to existing velocities
- */
-declare function move(entity: EntityWithBody, vector: Vector3): void;
-/**
- * Reset entity velocity
- */
-declare function resetVelocity(entity: EntityWithBody): void;
-/**
- * Enhanced moveable entity with bound methods
- */
-interface MoveableEntity extends EntityWithBody {
-    moveX(delta: number): void;
-    moveY(delta: number): void;
-    moveZ(delta: number): void;
-    moveXY(deltaX: number, deltaY: number): void;
-    moveXZ(deltaX: number, deltaZ: number): void;
-    move(vector: Vector3): void;
-    resetVelocity(): void;
-    moveForwardXY(delta: number, rotation2DAngle: number): void;
-    getPosition(): Vector | null;
-    getVelocity(): Vector | null;
-    setPosition(x: number, y: number, z: number): void;
-    setPositionX(x: number): void;
-    setPositionY(y: number): void;
-    setPositionZ(z: number): void;
-    wrapAroundXY(boundsX: number, boundsY: number): void;
-    wrapAround3D(boundsX: number, boundsY: number, boundsZ: number): void;
-}
-/**
- * Class decorator to enhance an entity with additive movement methods
- */
-declare function moveable<T extends {
-    new (...args: any[]): EntityWithBody;
-}>(constructor: T): {
-    new (...args: any[]): {
-        moveX(delta: number): void;
-        moveY(delta: number): void;
-        moveZ(delta: number): void;
-        moveXY(deltaX: number, deltaY: number): void;
-        moveXZ(deltaX: number, deltaZ: number): void;
-        move(vector: Vector3): void;
-        resetVelocity(): void;
-        moveForwardXY(delta: number, rotation2DAngle: number): void;
-        getPosition(): Vector | null;
-        getVelocity(): Vector | null;
-        setPosition(x: number, y: number, z: number): void;
-        setPositionX(x: number): void;
-        setPositionY(y: number): void;
-        setPositionZ(z: number): void;
-        wrapAroundXY(boundsX: number, boundsY: number): void;
-        wrapAround3D(boundsX: number, boundsY: number, boundsZ: number): void;
-        body: RigidBody | null;
-    };
-} & T;
-/**
- * Enhance an entity with additive movement methods (retained for compatibility)
- */
-declare function makeMoveable<T extends EntityWithBody>(entity: T): T & MoveableEntity;
-
-export { type EntityWithBody as E, type MoveableEntity as M, moveable as a, move as b, makeMoveable as m, resetVelocity as r };

package/dist/transformable-CUhvyuYO.d.ts

@@ -1,67 +0,0 @@
-import { E as EntityWithBody, M as MoveableEntity } from './moveable-B_vyA6cw.js';
-import { Vector3 } from 'three';
-import { RigidBody } from '@dimforge/rapier3d-compat';
-
-interface RotatableEntity {
-    body: RigidBody | null;
-    group: any;
-}
-/**
- * Rotate an entity in the direction of a movement vector
- */
-declare function rotateInDirection(entity: RotatableEntity, moveVector: Vector3): void;
-/**
- * Rotatable entity API with bound methods
- */
-interface RotatableEntityAPI extends RotatableEntity {
-    rotateInDirection(moveVector: Vector3): void;
-    rotateYEuler(amount: number): void;
-    rotateEuler(rotation: Vector3): void;
-    rotateY(delta: number): void;
-    rotateZ(delta: number): void;
-    setRotationY(y: number): void;
-    setRotationX(x: number): void;
-    setRotationZ(z: number): void;
-    setRotationDegrees(x: number, y: number, z: number): void;
-    setRotationDegreesY(y: number): void;
-    setRotationDegreesX(x: number): void;
-    setRotationDegreesZ(z: number): void;
-    setRotation(x: number, y: number, z: number): void;
-    getRotation(): any;
-}
-/**
- * Class decorator to enhance an entity with rotatable methods
- */
-declare function rotatable<T extends {
-    new (...args: any[]): RotatableEntity;
-}>(constructor: T): {
-    new (...args: any[]): {
-        rotateInDirection(moveVector: Vector3): void;
-        rotateYEuler(amount: number): void;
-        rotateEuler(rotation: Vector3): void;
-        rotateY(delta: number): void;
-        rotateZ(delta: number): void;
-        setRotationY(y: number): void;
-        setRotationX(x: number): void;
-        setRotationZ(z: number): void;
-        setRotationDegrees(x: number, y: number, z: number): void;
-        setRotationDegreesY(y: number): void;
-        setRotationDegreesX(x: number): void;
-        setRotationDegreesZ(z: number): void;
-        setRotation(x: number, y: number, z: number): void;
-        getRotation(): any;
-        body: RigidBody | null;
-        group: any;
-    };
-} & T;
-/**
- * Enhance an entity instance with rotatable methods
- */
-declare function makeRotatable<T extends RotatableEntity>(entity: T): T & RotatableEntityAPI;
-
-/**
- * Enhance an entity with both movement and rotation capabilities.
- */
-declare function makeTransformable<T extends RotatableEntity & EntityWithBody>(entity: T): T & MoveableEntity & RotatableEntityAPI;
-
-export { makeTransformable as a, rotateInDirection as b, makeRotatable as m, rotatable as r };