@zylem/game-lib 0.5.1 → 0.6.2

package/dist/entities-DvByhMGU.d.ts

@@ -0,0 +1,306 @@
+import { G as GameEntity, g as GameEntityOptions, b as UpdateContext, c as DestroyContext, B as BaseNode, T as TexturePath, A as CollisionHandlerDelegate, V as Vec3, M as MaterialOptions } from './world-C8tQ7Plj.js';
+import { Vector3, Sprite, Color, Vector2, Object3D } from 'three';
+
+type SpriteImage = {
+    name: string;
+    file: string;
+};
+type SpriteAnimation = {
+    name: string;
+    frames: string[];
+    speed: number | number[];
+    loop: boolean;
+};
+type ZylemSpriteOptions = GameEntityOptions & {
+    images?: SpriteImage[];
+    animations?: SpriteAnimation[];
+    size?: Vector3;
+    collisionSize?: Vector3;
+};
+declare const SPRITE_TYPE: unique symbol;
+declare class ZylemSprite extends GameEntity<ZylemSpriteOptions> {
+    static type: symbol;
+    protected sprites: Sprite[];
+    protected spriteMap: Map<string, number>;
+    protected currentSpriteIndex: number;
+    protected animations: Map<string, any>;
+    protected currentAnimation: any;
+    protected currentAnimationFrame: string;
+    protected currentAnimationIndex: number;
+    protected currentAnimationTime: number;
+    constructor(options?: ZylemSpriteOptions);
+    create(): this;
+    protected createSpritesFromImages(images: SpriteImage[]): void;
+    protected createAnimations(animations: SpriteAnimation[]): void;
+    setSprite(key: string): void;
+    setAnimation(name: string, delta: number): void;
+    spriteUpdate(params: UpdateContext<ZylemSpriteOptions>): void;
+    spriteDestroy(params: DestroyContext<ZylemSpriteOptions>): void;
+    buildInfo(): Record<string, any>;
+}
+type SpriteOptions = BaseNode | Partial<ZylemSpriteOptions>;
+declare function createSprite(...args: Array<SpriteOptions>): ZylemSprite;
+
+type ZylemSphereOptions = GameEntityOptions & {
+    radius?: number;
+};
+declare const SPHERE_TYPE: unique symbol;
+declare class ZylemSphere extends GameEntity<ZylemSphereOptions> {
+    static type: symbol;
+    constructor(options?: ZylemSphereOptions);
+    buildInfo(): Record<string, any>;
+}
+type SphereOptions = BaseNode | Partial<ZylemSphereOptions>;
+declare function createSphere(...args: Array<SphereOptions>): ZylemSphere;
+
+type ZylemRectOptions = GameEntityOptions & {
+    width?: number;
+    height?: number;
+    fillColor?: Color | string | null;
+    strokeColor?: Color | string | null;
+    strokeWidth?: number;
+    radius?: number;
+    padding?: number;
+    stickToViewport?: boolean;
+    screenPosition?: Vector2;
+    zDistance?: number;
+    anchor?: Vector2;
+    bounds?: {
+        screen?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        world?: {
+            left: number;
+            right: number;
+            top: number;
+            bottom: number;
+            z?: number;
+        };
+    };
+};
+declare const RECT_TYPE: unique symbol;
+declare class ZylemRect extends GameEntity<ZylemRectOptions> {
+    static type: symbol;
+    private _sprite;
+    private _mesh;
+    private _texture;
+    private _canvas;
+    private _ctx;
+    private _cameraRef;
+    private _lastCanvasW;
+    private _lastCanvasH;
+    constructor(options?: ZylemRectOptions);
+    private createSprite;
+    private redrawRect;
+    getWidth(): number;
+    getHeight(): number;
+    private roundedRectPath;
+    private toCssColor;
+    private rectSetup;
+    private rectUpdate;
+    private updateStickyTransform;
+    private worldToScreen;
+    private computeScreenBoundsFromOptions;
+    updateRect(options?: Partial<Pick<ZylemRectOptions, 'width' | 'height' | 'fillColor' | 'strokeColor' | 'strokeWidth' | 'radius'>>): void;
+    buildInfo(): Record<string, any>;
+}
+type RectOptions = BaseNode | Partial<ZylemRectOptions>;
+declare function createRect(...args: Array<RectOptions>): ZylemRect;
+
+type ZylemTextOptions = GameEntityOptions & {
+    text?: string;
+    fontFamily?: string;
+    fontSize?: number;
+    fontColor?: Color | string;
+    backgroundColor?: Color | string | null;
+    padding?: number;
+    stickToViewport?: boolean;
+    screenPosition?: Vector2;
+    zDistance?: number;
+};
+declare const TEXT_TYPE: unique symbol;
+declare class ZylemText extends GameEntity<ZylemTextOptions> {
+    static type: symbol;
+    private _sprite;
+    private _texture;
+    private _canvas;
+    private _ctx;
+    private _cameraRef;
+    private _lastCanvasW;
+    private _lastCanvasH;
+    constructor(options?: ZylemTextOptions);
+    create(): this;
+    private createSprite;
+    private measureAndResizeCanvas;
+    private drawCenteredText;
+    private updateTexture;
+    private redrawText;
+    private toCssColor;
+    private textSetup;
+    private textUpdate;
+    private getResolution;
+    private getScreenPixels;
+    private computeWorldExtents;
+    private updateSpriteScale;
+    private updateStickyTransform;
+    updateText(_text: string): void;
+    buildInfo(): Record<string, any>;
+    /**
+     * Dispose of Three.js resources when the entity is destroyed.
+     */
+    private textDestroy;
+}
+type TextOptions = BaseNode | Partial<ZylemTextOptions>;
+declare function createText(...args: Array<TextOptions>): ZylemText;
+
+type ZylemBoxOptions = GameEntityOptions;
+declare const BOX_TYPE: unique symbol;
+declare class ZylemBox extends GameEntity<ZylemBoxOptions> {
+    static type: symbol;
+    constructor(options?: ZylemBoxOptions);
+    buildInfo(): Record<string, any>;
+}
+type BoxOptions = BaseNode | ZylemBoxOptions;
+declare function createBox(...args: Array<BoxOptions>): ZylemBox;
+
+type ZylemPlaneOptions = GameEntityOptions & {
+    tile?: Vector2;
+    repeat?: Vector2;
+    texture?: TexturePath;
+    subdivisions?: number;
+    randomizeHeight?: boolean;
+    heightMap?: number[];
+    heightScale?: number;
+};
+declare const PLANE_TYPE: unique symbol;
+declare class ZylemPlane extends GameEntity<ZylemPlaneOptions> {
+    static type: symbol;
+    constructor(options?: ZylemPlaneOptions);
+}
+type PlaneOptions = BaseNode | Partial<ZylemPlaneOptions>;
+declare function createPlane(...args: Array<PlaneOptions>): ZylemPlane;
+
+type OnHeldParams = {
+    delta: number;
+    self: ZylemZone;
+    visitor: GameEntity<any>;
+    heldTime: number;
+    globals: any;
+};
+type OnEnterParams = Pick<OnHeldParams, 'self' | 'visitor' | 'globals'>;
+type OnExitParams = Pick<OnHeldParams, 'self' | 'visitor' | 'globals'>;
+type ZylemZoneOptions = GameEntityOptions & {
+    size?: Vector3;
+    static?: boolean;
+    onEnter?: (params: OnEnterParams) => void;
+    onHeld?: (params: OnHeldParams) => void;
+    onExit?: (params: OnExitParams) => void;
+};
+declare const ZONE_TYPE: unique symbol;
+declare class ZylemZone extends GameEntity<ZylemZoneOptions> implements CollisionHandlerDelegate {
+    static type: symbol;
+    private _enteredZone;
+    private _exitedZone;
+    private _zoneEntities;
+    constructor(options?: ZylemZoneOptions);
+    handlePostCollision({ delta }: {
+        delta: number;
+    }): boolean;
+    handleIntersectionEvent({ other, delta }: {
+        other: any;
+        delta: number;
+    }): void;
+    onEnter(callback: (params: OnEnterParams) => void): this;
+    onHeld(callback: (params: OnHeldParams) => void): this;
+    onExit(callback: (params: OnExitParams) => void): this;
+    entered(other: any): void;
+    exited(delta: number, key: string): void;
+    held(delta: number, other: any): void;
+}
+type ZoneOptions = BaseNode | Partial<ZylemZoneOptions>;
+declare function createZone(...args: Array<ZoneOptions>): ZylemZone;
+
+interface EntityLoaderDelegate {
+    /** Initiates loading (may be async internally, but call returns immediately) */
+    load(): void;
+    /** Returns data synchronously (may be null if still loading) */
+    data(): any;
+}
+
+type AnimationOptions = {
+    key: string;
+    pauseAtEnd?: boolean;
+    pauseAtPercentage?: number;
+    fadeToKey?: string;
+    fadeDuration?: number;
+};
+
+/**
+ * Interface for entities that provide custom debug information
+ */
+interface DebugInfoProvider {
+    getDebugInfo(): Record<string, any>;
+}
+
+type AnimationObject = {
+    key?: string;
+    path: string;
+};
+type CollisionShapeType = 'capsule' | 'model';
+type ZylemActorOptions = GameEntityOptions & {
+    static?: boolean;
+    animations?: AnimationObject[];
+    models?: string[];
+    scale?: Vec3;
+    material?: MaterialOptions;
+    collisionShape?: CollisionShapeType;
+};
+declare const ACTOR_TYPE: unique symbol;
+declare class ZylemActor extends GameEntity<ZylemActorOptions> implements EntityLoaderDelegate, DebugInfoProvider {
+    static type: symbol;
+    private _object;
+    private _animationDelegate;
+    private _modelFileNames;
+    private _assetLoader;
+    controlledRotation: boolean;
+    constructor(options?: ZylemActorOptions);
+    /**
+     * Initiates model and animation loading in background (deferred).
+     * Call returns immediately; assets will be ready on subsequent updates.
+     */
+    load(): void;
+    /**
+     * Returns current data synchronously.
+     * May return null values if loading is still in progress.
+     */
+    data(): any;
+    actorUpdate(params: UpdateContext<ZylemActorOptions>): void;
+    /**
+     * Clean up actor resources including animations, models, and groups
+     */
+    actorDestroy(): void;
+    /**
+     * Deferred loading - starts async load and updates entity when complete.
+     * Called by synchronous load() method.
+     */
+    private loadModelsDeferred;
+    playAnimation(animationOptions: AnimationOptions): void;
+    /**
+     * Apply material overrides from options to all meshes in the loaded model.
+     * Only applies if material options are explicitly specified (not just defaults).
+     */
+    private applyMaterialOverrides;
+    get object(): Object3D | null;
+    /**
+     * Provide custom debug information for the actor
+     * This will be merged with the default debug information
+     */
+    getDebugInfo(): Record<string, any>;
+}
+type ActorOptions = BaseNode | ZylemActorOptions;
+declare function createActor(...args: Array<ActorOptions>): ZylemActor;
+
+export { ACTOR_TYPE as A, BOX_TYPE as B, PLANE_TYPE as P, RECT_TYPE as R, SPRITE_TYPE as S, TEXT_TYPE as T, ZylemSprite as Z, SPHERE_TYPE as a, ZylemSphere as b, ZylemRect as c, ZylemText as d, ZylemBox as e, ZylemPlane as f, ZONE_TYPE as g, ZylemZone as h, ZylemActor as i, createBox as j, createSphere as k, createSprite as l, createPlane as m, createZone as n, createActor as o, createText as p, createRect as q };

package/dist/entities.d.ts

@@ -1,269 +1,7 @@
-import { e as BaseNode, l as GameEntityOptions, V as Vec3, M as MaterialOptions, G as GameEntity, U as UpdateContext, T as TexturePath, d as DestroyContext } from './entity-bQElAdpo.js';
-import { Object3D, Vector2, Vector3, Sprite, Color } from 'three';
+export { e as ZylemBox, o as createActor, j as createBox, m as createPlane, q as createRect, k as createSphere, l as createSprite, p as createText, n as createZone } from './entities-DvByhMGU.js';
+import './world-C8tQ7Plj.js';
+import 'three';
 import '@dimforge/rapier3d-compat';
+import './entity-Bq_eNEDI.js';
 import 'bitecs';
-
-interface EntityLoaderDelegate {
-    load(): Promise<void>;
-    data(): any;
-}
-
-type AnimationOptions = {
-    key: string;
-    pauseAtEnd?: boolean;
-    pauseAtPercentage?: number;
-    fadeToKey?: string;
-    fadeDuration?: number;
-};
-
-/**
- * Interface for entities that provide custom debug information
- */
-interface DebugInfoProvider {
-    getDebugInfo(): Record<string, any>;
-}
-
-type AnimationObject = {
-    key?: string;
-    path: string;
-};
-type ZylemActorOptions = GameEntityOptions & {
-    static?: boolean;
-    animations?: AnimationObject[];
-    models?: string[];
-    scale?: Vec3;
-    material?: MaterialOptions;
-};
-declare class ZylemActor extends GameEntity<ZylemActorOptions> implements EntityLoaderDelegate, DebugInfoProvider {
-    static type: symbol;
-    private _object;
-    private _animationDelegate;
-    private _modelFileNames;
-    private _assetLoader;
-    controlledRotation: boolean;
-    constructor(options?: ZylemActorOptions);
-    load(): Promise<void>;
-    data(): Promise<any>;
-    actorUpdate(params: UpdateContext<ZylemActorOptions>): Promise<void>;
-    private loadModels;
-    playAnimation(animationOptions: AnimationOptions): void;
-    get object(): Object3D | null;
-    /**
-     * Provide custom debug information for the actor
-     * This will be merged with the default debug information
-     */
-    getDebugInfo(): Record<string, any>;
-}
-type ActorOptions = BaseNode | ZylemActorOptions;
-declare function actor(...args: Array<ActorOptions>): Promise<ZylemActor>;
-
-type ZylemBoxOptions = GameEntityOptions;
-declare class ZylemBox extends GameEntity<ZylemBoxOptions> {
-    static type: symbol;
-    constructor(options?: ZylemBoxOptions);
-    buildInfo(): Record<string, any>;
-}
-type BoxOptions = BaseNode | ZylemBoxOptions;
-declare function box(...args: Array<BoxOptions>): Promise<ZylemBox>;
-
-type ZylemPlaneOptions = GameEntityOptions & {
-    tile?: Vector2;
-    repeat?: Vector2;
-    texture?: TexturePath;
-    subdivisions?: number;
-};
-declare class ZylemPlane extends GameEntity<ZylemPlaneOptions> {
-    static type: symbol;
-    constructor(options?: ZylemPlaneOptions);
-}
-type PlaneOptions = BaseNode | Partial<ZylemPlaneOptions>;
-declare function plane(...args: Array<PlaneOptions>): Promise<ZylemPlane>;
-
-type ZylemSphereOptions = GameEntityOptions & {
-    radius?: number;
-};
-declare class ZylemSphere extends GameEntity<ZylemSphereOptions> {
-    static type: symbol;
-    constructor(options?: ZylemSphereOptions);
-    buildInfo(): Record<string, any>;
-}
-type SphereOptions = BaseNode | Partial<ZylemSphereOptions>;
-declare function sphere(...args: Array<SphereOptions>): Promise<ZylemSphere>;
-
-type SpriteImage = {
-    name: string;
-    file: string;
-};
-type SpriteAnimation = {
-    name: string;
-    frames: string[];
-    speed: number | number[];
-    loop: boolean;
-};
-type ZylemSpriteOptions = GameEntityOptions & {
-    images?: SpriteImage[];
-    animations?: SpriteAnimation[];
-    size?: Vector3;
-    collisionSize?: Vector3;
-};
-declare class ZylemSprite extends GameEntity<ZylemSpriteOptions> {
-    static type: symbol;
-    protected sprites: Sprite[];
-    protected spriteMap: Map<string, number>;
-    protected currentSpriteIndex: number;
-    protected animations: Map<string, any>;
-    protected currentAnimation: any;
-    protected currentAnimationFrame: string;
-    protected currentAnimationIndex: number;
-    protected currentAnimationTime: number;
-    constructor(options?: ZylemSpriteOptions);
-    protected createSpritesFromImages(images: SpriteImage[]): void;
-    protected createAnimations(animations: SpriteAnimation[]): void;
-    setSprite(key: string): void;
-    setAnimation(name: string, delta: number): void;
-    spriteUpdate(params: UpdateContext<ZylemSpriteOptions>): Promise<void>;
-    spriteDestroy(params: DestroyContext<ZylemSpriteOptions>): Promise<void>;
-    buildInfo(): Record<string, any>;
-}
-type SpriteOptions = BaseNode | Partial<ZylemSpriteOptions>;
-declare function sprite(...args: Array<SpriteOptions>): Promise<ZylemSprite>;
-
-interface CollisionHandlerDelegate {
-    handlePostCollision(params: any): boolean;
-    handleIntersectionEvent(params: any): void;
-}
-
-type OnHeldParams = {
-    delta: number;
-    self: ZylemZone;
-    visitor: GameEntity<any>;
-    heldTime: number;
-    globals: any;
-};
-type OnEnterParams = Pick<OnHeldParams, 'self' | 'visitor' | 'globals'>;
-type OnExitParams = Pick<OnHeldParams, 'self' | 'visitor' | 'globals'>;
-type ZylemZoneOptions = GameEntityOptions & {
-    size?: Vector3;
-    static?: boolean;
-    onEnter?: (params: OnEnterParams) => void;
-    onHeld?: (params: OnHeldParams) => void;
-    onExit?: (params: OnExitParams) => void;
-};
-declare class ZylemZone extends GameEntity<ZylemZoneOptions> implements CollisionHandlerDelegate {
-    static type: symbol;
-    private _enteredZone;
-    private _exitedZone;
-    private _zoneEntities;
-    constructor(options?: ZylemZoneOptions);
-    handlePostCollision({ delta }: {
-        delta: number;
-    }): boolean;
-    handleIntersectionEvent({ other, delta }: {
-        other: any;
-        delta: number;
-    }): void;
-    onEnter(callback: (params: OnEnterParams) => void): this;
-    onHeld(callback: (params: OnHeldParams) => void): this;
-    onExit(callback: (params: OnExitParams) => void): this;
-    entered(other: any): void;
-    exited(delta: number, key: string): void;
-    held(delta: number, other: any): void;
-}
-type ZoneOptions = BaseNode | Partial<ZylemZoneOptions>;
-declare function zone(...args: Array<ZoneOptions>): Promise<ZylemZone>;
-
-type ZylemTextOptions = GameEntityOptions & {
-    text?: string;
-    fontFamily?: string;
-    fontSize?: number;
-    fontColor?: Color | string;
-    backgroundColor?: Color | string | null;
-    padding?: number;
-    stickToViewport?: boolean;
-    screenPosition?: Vector2;
-    zDistance?: number;
-};
-declare class ZylemText extends GameEntity<ZylemTextOptions> {
-    static type: symbol;
-    private _sprite;
-    private _texture;
-    private _canvas;
-    private _ctx;
-    private _cameraRef;
-    private _lastCanvasW;
-    private _lastCanvasH;
-    constructor(options?: ZylemTextOptions);
-    private createSprite;
-    private measureAndResizeCanvas;
-    private drawCenteredText;
-    private updateTexture;
-    private redrawText;
-    private toCssColor;
-    private textSetup;
-    private textUpdate;
-    private getResolution;
-    private getScreenPixels;
-    private computeWorldExtents;
-    private updateSpriteScale;
-    private updateStickyTransform;
-    updateText(_text: string): void;
-    buildInfo(): Record<string, any>;
-}
-type TextOptions = BaseNode | Partial<ZylemTextOptions>;
-declare function text(...args: Array<TextOptions>): Promise<ZylemText>;
-
-type ZylemRectOptions = GameEntityOptions & {
-    width?: number;
-    height?: number;
-    fillColor?: Color | string | null;
-    strokeColor?: Color | string | null;
-    strokeWidth?: number;
-    radius?: number;
-    padding?: number;
-    stickToViewport?: boolean;
-    screenPosition?: Vector2;
-    zDistance?: number;
-    anchor?: Vector2;
-    bounds?: {
-        screen?: {
-            x: number;
-            y: number;
-            width: number;
-            height: number;
-        };
-        world?: {
-            left: number;
-            right: number;
-            top: number;
-            bottom: number;
-            z?: number;
-        };
-    };
-};
-declare class ZylemRect extends GameEntity<ZylemRectOptions> {
-    static type: symbol;
-    private _sprite;
-    private _mesh;
-    private _texture;
-    private _canvas;
-    private _ctx;
-    private _cameraRef;
-    private _lastCanvasW;
-    private _lastCanvasH;
-    constructor(options?: ZylemRectOptions);
-    private createSprite;
-    private redrawRect;
-    private roundedRectPath;
-    private toCssColor;
-    private rectSetup;
-    private rectUpdate;
-    private updateStickyTransform;
-    private worldToScreen;
-    private computeScreenBoundsFromOptions;
-    updateRect(options?: Partial<Pick<ZylemRectOptions, 'width' | 'height' | 'fillColor' | 'strokeColor' | 'strokeWidth' | 'radius'>>): void;
-    buildInfo(): Record<string, any>;
-}
-type RectOptions = BaseNode | Partial<ZylemRectOptions>;
-declare function rect(...args: Array<RectOptions>): Promise<ZylemRect>;
-
-export { ZylemBox, actor, box, plane, rect, sphere, sprite, text, zone };
+import 'mitt';