@zylem/game-lib 0.6.0 → 0.6.2

package/dist/{entities-BAxfJOkk.d.ts → entities-DvByhMGU.d.ts}

@@ -1,32 +1,5 @@
-import { G as GameEntity, U as UpdateContext, l as GameEntityOptions, d as DestroyContext, e as BaseNode, T as TexturePath, V as Vec3, M as MaterialOptions } from './entity-COvRtFNG.js';
+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';
-import RAPIER__default, { World } from '@dimforge/rapier3d-compat';
-import { E as Entity } from './entity-Bq_eNEDI.js';
-
-/**
- * Interface for entities that handle collision events.
- */
-interface CollisionHandlerDelegate {
-    handlePostCollision(params: any): boolean;
-    handleIntersectionEvent(params: any): void;
-}
-declare class ZylemWorld implements Entity<ZylemWorld> {
-    type: string;
-    world: World;
-    collisionMap: Map<string, GameEntity<any>>;
-    collisionBehaviorMap: Map<string, GameEntity<any>>;
-    _removalMap: Map<string, GameEntity<any>>;
-    static loadPhysics(gravity: Vector3): Promise<RAPIER__default.World>;
-    constructor(world: World);
-    addEntity(entity: any): void;
-    setForRemoval(entity: any): void;
-    destroyEntity(entity: GameEntity<any>): void;
-    setup(): void;
-    update(params: UpdateContext<any>): void;
-    updatePostCollisionBehaviors(delta: number): void;
-    updateColliders(delta: number): void;
-    destroy(): void;
-}
 
 type SpriteImage = {
     name: string;
@@ -61,12 +34,12 @@ declare class ZylemSprite extends GameEntity<ZylemSpriteOptions> {
     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>;
+    spriteUpdate(params: UpdateContext<ZylemSpriteOptions>): void;
+    spriteDestroy(params: DestroyContext<ZylemSpriteOptions>): void;
     buildInfo(): Record<string, any>;
 }
 type SpriteOptions = BaseNode | Partial<ZylemSpriteOptions>;
-declare function sprite(...args: Array<SpriteOptions>): Promise<ZylemSprite>;
+declare function createSprite(...args: Array<SpriteOptions>): ZylemSprite;
 
 type ZylemSphereOptions = GameEntityOptions & {
     radius?: number;
@@ -78,7 +51,7 @@ declare class ZylemSphere extends GameEntity<ZylemSphereOptions> {
     buildInfo(): Record<string, any>;
 }
 type SphereOptions = BaseNode | Partial<ZylemSphereOptions>;
-declare function sphere(...args: Array<SphereOptions>): Promise<ZylemSphere>;
+declare function createSphere(...args: Array<SphereOptions>): ZylemSphere;
 
 type ZylemRectOptions = GameEntityOptions & {
     width?: number;
@@ -122,6 +95,8 @@ declare class ZylemRect extends GameEntity<ZylemRectOptions> {
     constructor(options?: ZylemRectOptions);
     private createSprite;
     private redrawRect;
+    getWidth(): number;
+    getHeight(): number;
     private roundedRectPath;
     private toCssColor;
     private rectSetup;
@@ -133,7 +108,7 @@ declare class ZylemRect extends GameEntity<ZylemRectOptions> {
     buildInfo(): Record<string, any>;
 }
 type RectOptions = BaseNode | Partial<ZylemRectOptions>;
-declare function rect(...args: Array<RectOptions>): Promise<ZylemRect>;
+declare function createRect(...args: Array<RectOptions>): ZylemRect;
 
 type ZylemTextOptions = GameEntityOptions & {
     text?: string;
@@ -179,7 +154,7 @@ declare class ZylemText extends GameEntity<ZylemTextOptions> {
     private textDestroy;
 }
 type TextOptions = BaseNode | Partial<ZylemTextOptions>;
-declare function text(...args: Array<TextOptions>): Promise<ZylemText>;
+declare function createText(...args: Array<TextOptions>): ZylemText;
 
 type ZylemBoxOptions = GameEntityOptions;
 declare const BOX_TYPE: unique symbol;
@@ -189,13 +164,16 @@ declare class ZylemBox extends GameEntity<ZylemBoxOptions> {
     buildInfo(): Record<string, any>;
 }
 type BoxOptions = BaseNode | ZylemBoxOptions;
-declare function box(...args: Array<BoxOptions>): Promise<ZylemBox>;
+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> {
@@ -203,7 +181,7 @@ declare class ZylemPlane extends GameEntity<ZylemPlaneOptions> {
     constructor(options?: ZylemPlaneOptions);
 }
 type PlaneOptions = BaseNode | Partial<ZylemPlaneOptions>;
-declare function plane(...args: Array<PlaneOptions>): Promise<ZylemPlane>;
+declare function createPlane(...args: Array<PlaneOptions>): ZylemPlane;
 
 type OnHeldParams = {
     delta: number;
@@ -243,10 +221,12 @@ declare class ZylemZone extends GameEntity<ZylemZoneOptions> implements Collisio
     held(delta: number, other: any): void;
 }
 type ZoneOptions = BaseNode | Partial<ZylemZoneOptions>;
-declare function zone(...args: Array<ZoneOptions>): Promise<ZylemZone>;
+declare function createZone(...args: Array<ZoneOptions>): ZylemZone;
 
 interface EntityLoaderDelegate {
-    load(): Promise<void>;
+    /** Initiates loading (may be async internally, but call returns immediately) */
+    load(): void;
+    /** Returns data synchronously (may be null if still loading) */
     data(): any;
 }
 
@@ -269,12 +249,14 @@ 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 {
@@ -285,15 +267,32 @@ declare class ZylemActor extends GameEntity<ZylemActorOptions> implements Entity
     private _assetLoader;
     controlledRotation: boolean;
     constructor(options?: ZylemActorOptions);
-    load(): Promise<void>;
-    data(): Promise<any>;
-    actorUpdate(params: UpdateContext<ZylemActorOptions>): Promise<void>;
+    /**
+     * 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;
-    private loadModels;
+    /**
+     * 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
@@ -302,6 +301,6 @@ declare class ZylemActor extends GameEntity<ZylemActorOptions> implements Entity
     getDebugInfo(): Record<string, any>;
 }
 type ActorOptions = BaseNode | ZylemActorOptions;
-declare function actor(...args: Array<ActorOptions>): Promise<ZylemActor>;
+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, ZylemBox as Z, sprite as a, box as b, actor as c, SPHERE_TYPE as d, ZONE_TYPE as e, ZylemWorld as f, ZylemSprite as g, ZylemSphere as h, ZylemRect as i, ZylemText as j, ZylemPlane as k, ZylemZone as l, ZylemActor as m, plane as p, rect as r, sphere as s, text as t, zone as z };
+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,6 +1,7 @@
-export { Z as ZylemBox, c as actor, b as box, p as plane, r as rect, s as sphere, a as sprite, t as text, z as zone } from './entities-BAxfJOkk.js';
-import './entity-COvRtFNG.js';
+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 'bitecs';
 import './entity-Bq_eNEDI.js';
+import 'bitecs';
+import 'mitt';