@zylem/game-lib 0.6.0 → 0.6.3

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

@@ -1,32 +1,6 @@
-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 { I as GameEntity, P as GameEntityOptions, U as UpdateContext, M as DestroyContext, N as BaseNode, as as TexturePath, V as Vec3, R as MaterialOptions } from './entity-BpbZqg19.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;
-}
+import { C as CollisionHandlerDelegate } from './world-Be5m1XC1.js';
 
 type SpriteImage = {
     name: string;
@@ -61,12 +35,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 +52,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,8 +96,16 @@ declare class ZylemRect extends GameEntity<ZylemRectOptions> {
     constructor(options?: ZylemRectOptions);
     private createSprite;
     private redrawRect;
+    getWidth(): number;
+    getHeight(): number;
     private roundedRectPath;
     private toCssColor;
+    /**
+     * Get the viewport resolution from the renderer DOM element,
+     * falling back to the camera's screenResolution if the renderer
+     * is not available (e.g. when using the new RendererManager path).
+     */
+    private getResolution;
     private rectSetup;
     private rectUpdate;
     private updateStickyTransform;
@@ -133,7 +115,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 +161,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;
@@ -188,14 +170,17 @@ declare class ZylemBox extends GameEntity<ZylemBoxOptions> {
     constructor(options?: ZylemBoxOptions);
     buildInfo(): Record<string, any>;
 }
-type BoxOptions = BaseNode | ZylemBoxOptions;
-declare function box(...args: Array<BoxOptions>): Promise<ZylemBox>;
+type BoxOptions = BaseNode | Partial<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> {
@@ -203,7 +188,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 +228,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 +256,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 +274,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 +308,109 @@ 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;
+
+type ZylemConeOptions = GameEntityOptions & {
+    /** Base radius of the cone */
+    radius?: number;
+    /** Height of the cone */
+    height?: number;
+    /** Number of radial segments (higher = smoother) */
+    radialSegments?: number;
+};
+declare const CONE_TYPE: unique symbol;
+/**
+ * A cone entity with configurable radius, height, and radial segments.
+ * Uses a Rapier cone collider for physics.
+ */
+declare class ZylemCone extends GameEntity<ZylemConeOptions> {
+    static type: symbol;
+    constructor(options?: ZylemConeOptions);
+    buildInfo(): Record<string, any>;
+}
+type ConeOptions = BaseNode | Partial<ZylemConeOptions>;
+/**
+ * Create a cone entity.
+ * @param args Options or child nodes
+ */
+declare function createCone(...args: Array<ConeOptions>): ZylemCone;
+
+type ZylemPyramidOptions = GameEntityOptions & {
+    /** Base radius of the pyramid */
+    radius?: number;
+    /** Height of the pyramid */
+    height?: number;
+};
+declare const PYRAMID_TYPE: unique symbol;
+/**
+ * A pyramid entity (4-sided cone).
+ * Uses ConeGeometry with 4 radial segments for the visual mesh
+ * and a Rapier cone collider for physics.
+ */
+declare class ZylemPyramid extends GameEntity<ZylemPyramidOptions> {
+    static type: symbol;
+    constructor(options?: ZylemPyramidOptions);
+    buildInfo(): Record<string, any>;
+}
+type PyramidOptions = BaseNode | Partial<ZylemPyramidOptions>;
+/**
+ * Create a pyramid entity.
+ * @param args Options or child nodes
+ */
+declare function createPyramid(...args: Array<PyramidOptions>): ZylemPyramid;
+
+type ZylemCylinderOptions = GameEntityOptions & {
+    /** Top radius of the cylinder */
+    radiusTop?: number;
+    /** Bottom radius of the cylinder */
+    radiusBottom?: number;
+    /** Height of the cylinder */
+    height?: number;
+    /** Number of radial segments (higher = smoother) */
+    radialSegments?: number;
+};
+declare const CYLINDER_TYPE: unique symbol;
+/**
+ * A cylinder entity with configurable top/bottom radii, height, and segments.
+ * Uses a Rapier cylinder collider for physics.
+ */
+declare class ZylemCylinder extends GameEntity<ZylemCylinderOptions> {
+    static type: symbol;
+    constructor(options?: ZylemCylinderOptions);
+    buildInfo(): Record<string, any>;
+}
+type CylinderOptions = BaseNode | Partial<ZylemCylinderOptions>;
+/**
+ * Create a cylinder entity.
+ * @param args Options or child nodes
+ */
+declare function createCylinder(...args: Array<CylinderOptions>): ZylemCylinder;
+
+type ZylemPillOptions = GameEntityOptions & {
+    /** Radius of the capsule hemispheres */
+    radius?: number;
+    /** Length of the cylindrical middle section */
+    length?: number;
+    /** Number of cap segments (higher = smoother) */
+    capSegments?: number;
+    /** Number of radial segments (higher = smoother) */
+    radialSegments?: number;
+};
+declare const PILL_TYPE: unique symbol;
+/**
+ * A pill/capsule entity with configurable radius and cylindrical length.
+ * Uses Three.js CapsuleGeometry for rendering and Rapier capsule collider for physics.
+ */
+declare class ZylemPill extends GameEntity<ZylemPillOptions> {
+    static type: symbol;
+    constructor(options?: ZylemPillOptions);
+    buildInfo(): Record<string, any>;
+}
+type PillOptions = BaseNode | Partial<ZylemPillOptions>;
+/**
+ * Create a pill (capsule) entity.
+ * @param args Options or child nodes
+ */
+declare function createPill(...args: Array<PillOptions>): ZylemPill;
 
-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, CONE_TYPE as C, createCylinder as D, createPill as E, 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, ZylemCone as j, PYRAMID_TYPE as k, ZylemPyramid as l, CYLINDER_TYPE as m, ZylemCylinder as n, PILL_TYPE as o, ZylemPill as p, createBox as q, createSphere as r, createSprite as s, createPlane as t, createZone as u, createActor as v, createText as w, createRect as x, createCone as y, createPyramid as z };

package/dist/entities.d.ts

@@ -1,6 +1,9 @@
-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, v as createActor, q as createBox, y as createCone, D as createCylinder, E as createPill, t as createPlane, z as createPyramid, x as createRect, r as createSphere, s as createSprite, w as createText, u as createZone } from './entities-DC9ce_vx.js';
+import './entity-BpbZqg19.js';
 import 'three';
 import '@dimforge/rapier3d-compat';
 import 'bitecs';
+import 'mitt';
+import './behavior-descriptor-BWNWmIjv.js';
+import './world-Be5m1XC1.js';
 import './entity-Bq_eNEDI.js';