@zylem/game-lib 0.6.2 → 0.6.4

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

@@ -1,5 +1,6 @@
-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 { I as GameEntity, P as GameEntityOptions, L as SetupContext, U as UpdateContext, M as DestroyContext, O as BaseNode, as as TexturePath, V as Vec3, R as MaterialOptions, aq as CleanupContext } from './entity-vj-HTjzU.js';
 import { Vector3, Sprite, Color, Vector2, Object3D } from 'three';
+import { C as CollisionHandlerDelegate } from './world-DfgxoNMt.js';
 
 type SpriteImage = {
     name: string;
@@ -34,6 +35,9 @@ declare class ZylemSprite extends GameEntity<ZylemSpriteOptions> {
     protected createAnimations(animations: SpriteAnimation[]): void;
     setSprite(key: string): void;
     setAnimation(name: string, delta: number): void;
+    private getCurrentRotationQuaternion;
+    private syncSpriteMaterials;
+    spriteSetup(_params: SetupContext<ZylemSpriteOptions>): void;
     spriteUpdate(params: UpdateContext<ZylemSpriteOptions>): void;
     spriteDestroy(params: DestroyContext<ZylemSpriteOptions>): void;
     buildInfo(): Record<string, any>;
@@ -99,6 +103,12 @@ declare class ZylemRect extends GameEntity<ZylemRectOptions> {
     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;
@@ -163,7 +173,7 @@ declare class ZylemBox extends GameEntity<ZylemBoxOptions> {
     constructor(options?: ZylemBoxOptions);
     buildInfo(): Record<string, any>;
 }
-type BoxOptions = BaseNode | ZylemBoxOptions;
+type BoxOptions = BaseNode | Partial<ZylemBoxOptions>;
 declare function createBox(...args: Array<BoxOptions>): ZylemBox;
 
 type ZylemPlaneOptions = GameEntityOptions & {
@@ -249,7 +259,7 @@ type AnimationObject = {
     key?: string;
     path: string;
 };
-type CollisionShapeType = 'capsule' | 'model';
+type CollisionShapeType = 'capsule' | 'bounds' | 'trimesh' | 'model';
 type ZylemActorOptions = GameEntityOptions & {
     static?: boolean;
     animations?: AnimationObject[];
@@ -262,45 +272,139 @@ declare const ACTOR_TYPE: unique symbol;
 declare class ZylemActor extends GameEntity<ZylemActorOptions> implements EntityLoaderDelegate, DebugInfoProvider {
     static type: symbol;
     private _object;
+    private _collisionSource;
     private _animationDelegate;
     private _modelFileNames;
     private _assetLoader;
+    private _loadGeneration;
+    private _loadStatus;
     controlledRotation: boolean;
+    hasWarnedDynamicTrimesh: boolean;
     constructor(options?: ZylemActorOptions);
-    /**
-     * Initiates model and animation loading in background (deferred).
-     * Call returns immediately; assets will be ready on subsequent updates.
-     */
+    create(): this;
     load(): void;
-    /**
-     * Returns current data synchronously.
-     * May return null values if loading is still in progress.
-     */
     data(): any;
+    needsDeferredModelCollision(): boolean;
+    synchronizeRuntimeCollider(): void;
     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;
+    _cleanup(params: CleanupContext<this>): void;
     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
-     */
+    get collisionSource(): Object3D | null;
     getDebugInfo(): Record<string, any>;
+    private getResolvedCollisionShape;
+    private requiresLoadedCollisionSource;
+    private getRuntimeCollisionSource;
+    private getCollisionSourceSelection;
+    private disposeRuntimeState;
+    private loadModelsDeferred;
+    private applyMaterialOverrides;
 }
 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 };
+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, 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,7 +1,9 @@
-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';
+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-ChFirVL9.js';
+import './entity-vj-HTjzU.js';
 import 'three';
 import '@dimforge/rapier3d-compat';
-import './entity-Bq_eNEDI.js';
 import 'bitecs';
 import 'mitt';
+import './behavior-descriptor-BXnVR8Ki.js';
+import './world-DfgxoNMt.js';
+import './entity-Bq_eNEDI.js';