ecspresso 0.6.0 → 0.7.0

package/dist/bundles/utils/bounds.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Bounds Bundle for ECSpresso
+ *
+ * Provides screen bounds enforcement for entities with transforms.
+ * Reads worldTransform for position checking; modifies localTransform for corrections.
+ * Supports destroy, clamp, and wrap behaviors.
+ */
+import Bundle from '../../bundle';
+import type { TransformComponentTypes } from './transform';
+/**
+ * Component that marks an entity for destruction when outside bounds.
+ */
+export interface DestroyOutOfBounds {
+    /** Extra padding beyond bounds before destruction (default: 0) */
+    padding?: number;
+}
+/**
+ * Component that clamps an entity's position to stay within bounds.
+ */
+export interface ClampToBounds {
+    /** Margin to shrink the valid area (default: 0) */
+    margin?: number;
+}
+/**
+ * Component that wraps an entity's position to the opposite edge.
+ */
+export interface WrapAtBounds {
+    /** Padding beyond bounds before wrapping (default: 0) */
+    padding?: number;
+}
+/**
+ * Component types provided by the bounds bundle.
+ * Extend your component types with this interface.
+ *
+ * @example
+ * ```typescript
+ * interface GameComponents extends TransformComponentTypes, BoundsComponentTypes {
+ *   sprite: Sprite;
+ * }
+ * ```
+ */
+export interface BoundsComponentTypes {
+    destroyOutOfBounds: DestroyOutOfBounds;
+    clampToBounds: ClampToBounds;
+    wrapAtBounds: WrapAtBounds;
+}
+/**
+ * Bounds rectangle definition.
+ */
+export interface BoundsRect {
+    /** Left edge x coordinate (default: 0) */
+    x?: number;
+    /** Top edge y coordinate (default: 0) */
+    y?: number;
+    /** Width of the bounds area */
+    width: number;
+    /** Height of the bounds area */
+    height: number;
+}
+/**
+ * Resource types provided by the bounds bundle.
+ */
+export interface BoundsResourceTypes {
+    bounds: BoundsRect;
+}
+/**
+ * Event fired when an entity exits bounds.
+ */
+export interface EntityOutOfBoundsEvent {
+    /** The entity that exited bounds */
+    entityId: number;
+    /** The edge the entity exited through */
+    exitEdge: 'top' | 'bottom' | 'left' | 'right';
+}
+/**
+ * Event types provided by the bounds bundle.
+ */
+export interface BoundsEventTypes {
+    entityOutOfBounds: EntityOutOfBoundsEvent;
+}
+/**
+ * Configuration options for the bounds bundle.
+ */
+export interface BoundsBundleOptions {
+    /** System group name (default: 'physics') */
+    systemGroup?: string;
+    /** Priority for bounds systems (default: 50) */
+    priority?: number;
+    /** Resource key for bounds rectangle (default: 'bounds') */
+    boundsResourceKey?: string;
+    /** Whether to auto-remove entities when out of bounds (default: true) */
+    autoRemove?: boolean;
+}
+/**
+ * Create a bounds rectangle resource.
+ *
+ * @param width The width of the bounds area
+ * @param height The height of the bounds area
+ * @param x The left edge x coordinate (default: 0)
+ * @param y The top edge y coordinate (default: 0)
+ * @returns Bounds rectangle suitable for use as a resource
+ *
+ * @example
+ * ```typescript
+ * ECSpresso.create()
+ *   .withResource('bounds', createBounds(800, 600))
+ *   .build();
+ * ```
+ */
+export declare function createBounds(width: number, height: number, x?: number, y?: number): BoundsRect;
+/**
+ * Create a destroyOutOfBounds component.
+ *
+ * @param padding Extra padding beyond bounds before destruction
+ * @returns Component object suitable for spreading into spawn()
+ *
+ * @example
+ * ```typescript
+ * ecs.spawn({
+ *   ...createTransform(100, 200),
+ *   ...createDestroyOutOfBounds(20),
+ * });
+ * ```
+ */
+export declare function createDestroyOutOfBounds(padding?: number): Pick<BoundsComponentTypes, 'destroyOutOfBounds'>;
+/**
+ * Create a clampToBounds component.
+ *
+ * @param margin Margin to shrink the valid area
+ * @returns Component object suitable for spreading into spawn()
+ *
+ * @example
+ * ```typescript
+ * ecs.spawn({
+ *   ...createTransform(100, 200),
+ *   ...createClampToBounds(30),
+ * });
+ * ```
+ */
+export declare function createClampToBounds(margin?: number): Pick<BoundsComponentTypes, 'clampToBounds'>;
+/**
+ * Create a wrapAtBounds component.
+ *
+ * @param padding Padding beyond bounds before wrapping
+ * @returns Component object suitable for spreading into spawn()
+ *
+ * @example
+ * ```typescript
+ * ecs.spawn({
+ *   ...createTransform(100, 200),
+ *   ...createWrapAtBounds(10),
+ * });
+ * ```
+ */
+export declare function createWrapAtBounds(padding?: number): Pick<BoundsComponentTypes, 'wrapAtBounds'>;
+type CombinedComponentTypes = BoundsComponentTypes & TransformComponentTypes;
+/**
+ * Create a bounds bundle for ECSpresso.
+ *
+ * This bundle provides:
+ * - Destroy out of bounds system - removes entities that exit bounds
+ * - Clamp to bounds system - constrains entities within bounds
+ * - Wrap at bounds system - wraps entities to opposite edge
+ *
+ * Uses worldTransform for position checking (world-space) and modifies
+ * localTransform for corrections. Works best with entities that don't
+ * have parent transforms (orphan entities).
+ *
+ * @example
+ * ```typescript
+ * const ecs = ECSpresso
+ *   .create<Components, Events, Resources>()
+ *   .withResource('bounds', createBounds(800, 600))
+ *   .withBundle(createTransformBundle())
+ *   .withBundle(createBoundsBundle())
+ *   .build();
+ *
+ * // Entity that gets destroyed when leaving screen
+ * ecs.spawn({
+ *   ...createTransform(100, 200),
+ *   ...createDestroyOutOfBounds(),
+ * });
+ * ```
+ */
+export declare function createBoundsBundle<ResourceTypes extends BoundsResourceTypes = BoundsResourceTypes>(options?: BoundsBundleOptions): Bundle<CombinedComponentTypes, BoundsEventTypes, ResourceTypes>;
+export {};

package/dist/bundles/utils/collision.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Collision Bundle for ECSpresso
+ *
+ * Provides layer-based collision detection with events.
+ * Uses worldTransform for position (world-space collision).
+ * Supports AABB and circle colliders.
+ */
+import Bundle from '../../bundle';
+import type { TransformComponentTypes } from './transform';
+/**
+ * Axis-Aligned Bounding Box collider.
+ */
+export interface AABBCollider {
+    /** Width of the bounding box */
+    width: number;
+    /** Height of the bounding box */
+    height: number;
+    /** X offset from entity position (default: 0) */
+    offsetX?: number;
+    /** Y offset from entity position (default: 0) */
+    offsetY?: number;
+}
+/**
+ * Circle collider.
+ */
+export interface CircleCollider {
+    /** Radius of the circle */
+    radius: number;
+    /** X offset from entity position (default: 0) */
+    offsetX?: number;
+    /** Y offset from entity position (default: 0) */
+    offsetY?: number;
+}
+/**
+ * Collision layer configuration.
+ */
+export interface CollisionLayer {
+    /** The layer this entity belongs to */
+    layer: string;
+    /** Layers this entity can collide with */
+    collidesWith: readonly string[];
+}
+/**
+ * Component types provided by the collision bundle.
+ * Extend your component types with this interface.
+ *
+ * @example
+ * ```typescript
+ * interface GameComponents extends TransformComponentTypes, CollisionComponentTypes {
+ *   sprite: Sprite;
+ *   enemy: boolean;
+ * }
+ * ```
+ */
+export interface CollisionComponentTypes {
+    aabbCollider: AABBCollider;
+    circleCollider: CircleCollider;
+    collisionLayer: CollisionLayer;
+}
+/**
+ * Event fired when two entities collide.
+ */
+export interface CollisionEvent {
+    /** First entity in the collision */
+    entityA: number;
+    /** Second entity in the collision */
+    entityB: number;
+    /** Layer of the first entity */
+    layerA: string;
+    /** Layer of the second entity */
+    layerB: string;
+}
+/**
+ * Event types provided by the collision bundle.
+ */
+export interface CollisionEventTypes {
+    collision: CollisionEvent;
+}
+/**
+ * Configuration options for the collision bundle.
+ */
+export interface CollisionBundleOptions {
+    /** System group name (default: 'physics') */
+    systemGroup?: string;
+    /** Priority for collision system (default: 0) */
+    priority?: number;
+    /** Name of the collision event (default: 'collision') */
+    collisionEventName?: string;
+}
+/**
+ * Create an AABB collider component.
+ *
+ * @param width Width of the bounding box
+ * @param height Height of the bounding box
+ * @param offsetX X offset from entity position
+ * @param offsetY Y offset from entity position
+ * @returns Component object suitable for spreading into spawn()
+ *
+ * @example
+ * ```typescript
+ * ecs.spawn({
+ *   ...createTransform(100, 200),
+ *   ...createAABBCollider(50, 30),
+ * });
+ * ```
+ */
+export declare function createAABBCollider(width: number, height: number, offsetX?: number, offsetY?: number): Pick<CollisionComponentTypes, 'aabbCollider'>;
+/**
+ * Create a circle collider component.
+ *
+ * @param radius Radius of the circle
+ * @param offsetX X offset from entity position
+ * @param offsetY Y offset from entity position
+ * @returns Component object suitable for spreading into spawn()
+ *
+ * @example
+ * ```typescript
+ * ecs.spawn({
+ *   ...createTransform(100, 200),
+ *   ...createCircleCollider(25),
+ * });
+ * ```
+ */
+export declare function createCircleCollider(radius: number, offsetX?: number, offsetY?: number): Pick<CollisionComponentTypes, 'circleCollider'>;
+/**
+ * Create a collision layer component.
+ *
+ * @param layer The layer this entity belongs to
+ * @param collidesWith Layers this entity can collide with
+ * @returns Component object suitable for spreading into spawn()
+ *
+ * @example
+ * ```typescript
+ * ecs.spawn({
+ *   ...createTransform(100, 200),
+ *   ...createAABBCollider(50, 30),
+ *   ...createCollisionLayer('player', ['enemy', 'obstacle']),
+ * });
+ * ```
+ */
+export declare function createCollisionLayer(layer: string, collidesWith: readonly string[]): Pick<CollisionComponentTypes, 'collisionLayer'>;
+/**
+ * Layer factory result from defineCollisionLayers.
+ */
+export type LayerFactories<T extends Record<string, readonly string[]>> = {
+    [K in keyof T]: () => Pick<CollisionComponentTypes, 'collisionLayer'>;
+};
+/**
+ * Define collision layer relationships and get factory functions.
+ *
+ * @param rules Object mapping layer names to arrays of layers they collide with
+ * @returns Object with factory functions for each layer
+ *
+ * @example
+ * ```typescript
+ * const layers = defineCollisionLayers({
+ *   player: ['enemy', 'enemyProjectile'],
+ *   playerProjectile: ['enemy'],
+ *   enemy: ['playerProjectile'],
+ *   enemyProjectile: ['player'],
+ * });
+ *
+ * // Usage
+ * ecs.spawn({
+ *   ...createTransform(100, 200),
+ *   ...createAABBCollider(50, 30),
+ *   ...layers.player(),
+ * });
+ * ```
+ */
+export declare function defineCollisionLayers<T extends Record<string, readonly string[]>>(rules: T): LayerFactories<T>;
+type CombinedComponentTypes = CollisionComponentTypes & TransformComponentTypes;
+/**
+ * Create a collision bundle for ECSpresso.
+ *
+ * This bundle provides:
+ * - O(n²) collision detection between entities with colliders
+ * - AABB-AABB, circle-circle, and AABB-circle collision
+ * - Layer-based filtering for collision pairs
+ * - Deduplication of A-B / B-A collisions
+ *
+ * Uses worldTransform for position (world-space collision detection).
+ *
+ * @example
+ * ```typescript
+ * const ecs = ECSpresso
+ *   .create<Components, Events, Resources>()
+ *   .withBundle(createTransformBundle())
+ *   .withBundle(createCollisionBundle())
+ *   .build();
+ *
+ * // Entity with collision
+ * ecs.spawn({
+ *   ...createTransform(100, 200),
+ *   ...createAABBCollider(50, 30),
+ *   ...createCollisionLayer('player', ['enemy']),
+ * });
+ * ```
+ */
+export declare function createCollisionBundle(options?: CollisionBundleOptions): Bundle<CombinedComponentTypes, CollisionEventTypes, {}>;
+export {};

package/dist/bundles/utils/movement.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Movement Bundle for ECSpresso
+ *
+ * Provides velocity → localTransform integration for entities.
+ * Works with the transform bundle's localTransform/worldTransform system.
+ */
+import Bundle from '../../bundle';
+import type { TransformComponentTypes } from './transform';
+/**
+ * Velocity component data structure.
+ */
+export interface Velocity {
+    x: number;
+    y: number;
+}
+/**
+ * Component types provided by the movement bundle.
+ * Extend your component types with this interface.
+ *
+ * @example
+ * ```typescript
+ * interface GameComponents extends TransformComponentTypes, MovementComponentTypes {
+ *   sprite: Sprite;
+ *   player: boolean;
+ * }
+ * ```
+ */
+export interface MovementComponentTypes extends TransformComponentTypes {
+    velocity: Velocity;
+}
+/**
+ * Configuration options for the movement bundle.
+ */
+export interface MovementBundleOptions {
+    /** System group name (default: 'physics') */
+    systemGroup?: string;
+    /** Priority for movement update system (default: 1000, runs early before transform propagation) */
+    priority?: number;
+}
+/**
+ * Create a velocity component.
+ *
+ * @param x The x velocity
+ * @param y The y velocity
+ * @returns Component object suitable for spreading into spawn()
+ *
+ * @example
+ * ```typescript
+ * ecs.spawn({
+ *   ...createTransform(100, 200),
+ *   ...createVelocity(50, -25),
+ *   projectile: true,
+ * });
+ * ```
+ */
+export declare function createVelocity(x: number, y: number): Pick<MovementComponentTypes, 'velocity'>;
+/**
+ * Create a movement bundle for ECSpresso.
+ *
+ * This bundle provides:
+ * - Movement update system that integrates velocity into localTransform
+ * - Processes all entities with both localTransform and velocity components
+ *
+ * Note: This bundle modifies localTransform. The transform bundle's propagation
+ * system will then compute worldTransform for use by other systems.
+ *
+ * @example
+ * ```typescript
+ * const ecs = ECSpresso
+ *   .create<Components, Events, Resources>()
+ *   .withBundle(createTransformBundle())
+ *   .withBundle(createMovementBundle())
+ *   .build();
+ *
+ * // Spawn entity with movement
+ * ecs.spawn({
+ *   ...createTransform(100, 200),
+ *   ...createVelocity(50, -25),
+ *   sprite,
+ * });
+ * ```
+ */
+export declare function createMovementBundle(options?: MovementBundleOptions): Bundle<MovementComponentTypes, {}, {}>;

package/dist/bundles/utils/timers.d.ts

@@ -5,11 +5,40 @@
  * Timers are components processed each frame, automatically cleaned up when entities are removed.
  */
 import Bundle from '../../bundle';
+/**
+ * Data structure published when a timer completes.
+ * Use this type when defining timer completion events in your EventTypes interface.
+ *
+ * @example
+ * ```typescript
+ * interface Events {
+ *   hideMessage: TimerEventData;
+ *   spawnWave: TimerEventData;
+ * }
+ * ```
+ */
+export interface TimerEventData {
+    /** The entity ID that the timer belongs to */
+    entityId: number;
+    /** The timer's configured duration in seconds */
+    duration: number;
+    /** The actual elapsed time (may exceed duration slightly) */
+    elapsed: number;
+}
+/**
+ * Extracts event names from EventTypes that have TimerEventData as their payload.
+ * This ensures only compatible events can be used with timer.onComplete.
+ */
+export type TimerEventName<EventTypes extends Record<string, any>> = {
+    [K in keyof EventTypes]: EventTypes[K] extends TimerEventData ? K : never;
+}[keyof EventTypes];
 /**
  * Timer component data structure.
  * Use `justFinished` to detect timer completion in your systems.
+ *
+ * @template EventTypes The event types from your ECS
  */
-export interface Timer {
+export interface Timer<EventTypes extends Record<string, any>> {
     /** Time accumulated so far (seconds) */
     elapsed: number;
     /** Target duration (seconds) */
@@ -20,21 +49,25 @@ export interface Timer {
     active: boolean;
     /** True for one frame after timer completes */
     justFinished: boolean;
+    /** Optional event name to publish when timer completes. Must be an event with TimerEventData payload. */
+    onComplete?: TimerEventName<EventTypes>;
 }
 /**
  * Component types provided by the timer bundle.
  * Extend your component types with this interface.
  *
+ * @template EventTypes The event types from your ECS
+ *
  * @example
  * ```typescript
- * interface GameComponents extends TimerComponentTypes {
+ * interface GameComponents extends TimerComponentTypes<GameEvents> {
  *   velocity: { x: number; y: number };
  *   player: true;
  * }
  * ```
  */
-export interface TimerComponentTypes {
-    timer: Timer;
+export interface TimerComponentTypes<EventTypes extends Record<string, any>> {
+    timer: Timer<EventTypes>;
 }
 /**
  * Configuration options for the timer bundle.
@@ -45,38 +78,61 @@ export interface TimerBundleOptions {
     /** Priority for timer update system (default: 0) */
     priority?: number;
 }
+/**
+ * Options for timer creation
+ *
+ * @template EventTypes The event types from your ECS
+ */
+export interface TimerOptions<EventTypes extends Record<string, any>> {
+    /** Event name to publish when timer completes. Must be an event with TimerEventData payload. */
+    onComplete?: TimerEventName<EventTypes>;
+}
 /**
  * Create a one-shot timer that fires once after the specified duration.
  *
+ * @template EventTypes The event types from your ECS (must be explicitly provided)
  * @param duration Duration in seconds until the timer completes
+ * @param options Optional configuration including event name
  * @returns Component object suitable for spreading into spawn()
  *
  * @example
  * ```typescript
- * // Timer that triggers after 2 seconds
+ * // Timer without event
  * ecs.spawn({
- *   ...createTimer(2),
+ *   ...createTimer<GameEvents>(2),
  *   explosion: true,
  * });
+ *
+ * // Timer that publishes an event on completion
+ * ecs.spawn({
+ *   ...createTimer<GameEvents>(1.5, { onComplete: 'hideMessage' }),
+ * });
  * ```
  */
-export declare function createTimer(duration: number): Pick<TimerComponentTypes, 'timer'>;
+export declare function createTimer<EventTypes extends Record<string, any>>(duration: number, options?: TimerOptions<EventTypes>): Pick<TimerComponentTypes<EventTypes>, 'timer'>;
 /**
  * Create a repeating timer that fires every `duration` seconds.
  *
+ * @template EventTypes The event types from your ECS (must be explicitly provided)
  * @param duration Duration in seconds between each timer completion
+ * @param options Optional configuration including event name
  * @returns Component object suitable for spreading into spawn()
  *
  * @example
  * ```typescript
- * // Timer that triggers every 5 seconds
+ * // Timer without event
  * ecs.spawn({
- *   ...createRepeatingTimer(5),
+ *   ...createRepeatingTimer<GameEvents>(5),
  *   spawner: true,
  * });
+ *
+ * // Repeating timer that publishes an event each cycle
+ * ecs.spawn({
+ *   ...createRepeatingTimer<GameEvents>(3, { onComplete: 'spawnWave' }),
+ * });
  * ```
  */
-export declare function createRepeatingTimer(duration: number): Pick<TimerComponentTypes, 'timer'>;
+export declare function createRepeatingTimer<EventTypes extends Record<string, any>>(duration: number, options?: TimerOptions<EventTypes>): Pick<TimerComponentTypes<EventTypes>, 'timer'>;
 /**
  * Create a timer bundle for ECSpresso.
  *
@@ -110,4 +166,4 @@ export declare function createRepeatingTimer(duration: number): Pick<TimerCompon
  *   });
  * ```
  */
-export declare function createTimerBundle(options?: TimerBundleOptions): Bundle<TimerComponentTypes, {}, {}>;
+export declare function createTimerBundle<EventTypes extends Record<string, any>>(options?: TimerBundleOptions): Bundle<TimerComponentTypes<EventTypes>, EventTypes, {}>;

package/dist/bundles/utils/timers.js

@@ -1,4 +1,4 @@
-var Z=Object.create;var{getPrototypeOf:_,defineProperty:V,getOwnPropertyNames:$}=Object;var C=Object.prototype.hasOwnProperty;var q=(j,x,F)=>{F=j!=null?Z(_(j)):{};let J=x||!j||!j.__esModule?V(F,"default",{value:j,enumerable:!0}):F;for(let H of $(j))if(!C.call(J,H))V(J,H,{get:()=>j[H],enumerable:!0});return J};var z=((j)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(j,{get:(x,F)=>(typeof require<"u"?require:x)[F]}):j)(function(j){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+j+'" is not supported')});class U{_label;_ecspresso;_bundle;queries={};processFunction;detachFunction;initializeFunction;eventHandlers;_priority=0;_isRegistered=!1;_groups=[];_inScreens;_excludeScreens;_requiredAssets;constructor(j,x=null,F=null){this._label=j;this._ecspresso=x;this._bundle=F}get label(){return this._label}get bundle(){return this._bundle}get ecspresso(){return this._ecspresso}_autoRegister(){if(this._isRegistered||!this._ecspresso)return;let j=this._buildSystemObject();R(j,this._ecspresso),this._isRegistered=!0}_buildSystemObject(){return this._createSystemObject()}_createSystemObject(){let j={label:this._label,entityQueries:this.queries,priority:this._priority};if(this.processFunction)j.process=this.processFunction;if(this.detachFunction)j.onDetach=this.detachFunction;if(this.initializeFunction)j.onInitialize=this.initializeFunction;if(this.eventHandlers)j.eventHandlers=this.eventHandlers;if(this._groups.length>0)j.groups=[...this._groups];if(this._inScreens)j.inScreens=this._inScreens;if(this._excludeScreens)j.excludeScreens=this._excludeScreens;if(this._requiredAssets)j.requiredAssets=this._requiredAssets;return j}setPriority(j){return this._priority=j,this}inGroup(j){if(!this._groups.includes(j))this._groups.push(j);return this}inScreens(j){return this._inScreens=[...j],this}excludeScreens(j){return this._excludeScreens=[...j],this}requiresAssets(j){return this._requiredAssets=[...j],this}addQuery(j,x){let F=this;return F.queries={...this.queries,[j]:x},F}setProcess(j){return this.processFunction=j,this}registerAndContinue(){if(!this._ecspresso)throw Error(`Cannot register system '${this._label}': SystemBuilder is not attached to an ECSpresso instance. Use Bundle.addSystem() or ECSpresso.addSystem() instead.`);return this._autoRegister(),this._ecspresso}and(){if(this._ecspresso)return this._autoRegister(),this._ecspresso;if(this._bundle)return this._bundle;throw Error(`Cannot use and() on system '${this._label}': not attached to ECSpresso or Bundle.`)}setOnDetach(j){return this.detachFunction=j,this}setOnInitialize(j){return this.initializeFunction=j,this}setEventHandlers(j){return this.eventHandlers=j,this}build(j){let x=this._createSystemObject();if(this._ecspresso)R(x,this._ecspresso);if(j)R(x,j);return this}}function R(j,x){x._registerSystem(j)}function P(j,x){return new U(j,x)}function X(j,x){return new U(j,null,x)}function G(){return`bundle_${Date.now().toString(36)}_${Math.random().toString(36).substring(2,9)}`}class Q{_systems=[];_resources=new Map;_assets=new Map;_assetGroups=new Map;_screens=new Map;_id;constructor(j){this._id=j||G()}get id(){return this._id}set id(j){this._id=j}addSystem(j){if(typeof j==="string"){let x=X(j,this);return this._systems.push(x),x}else return this._systems.push(j),j}addResource(j,x){return this._resources.set(j,x),this}addAsset(j,x,F){return this._assets.set(j,{loader:x,eager:F?.eager??!0,group:F?.group}),this}addAssetGroup(j,x){let F=new Map;for(let[J,H]of Object.entries(x))F.set(J,H),this._assets.set(J,{loader:H,eager:!1,group:j});return this._assetGroups.set(j,F),this}addScreen(j,x){return this._screens.set(j,x),this}getAssets(){return new Map(this._assets)}getScreens(){return new Map(this._screens)}_setResource(j,x){this._resources.set(j,x)}_setAsset(j,x){this._assets.set(j,x)}_setScreen(j,x){this._screens.set(j,x)}getSystems(){return this._systems.map((j)=>j.build())}registerSystemsWithEcspresso(j){for(let x of this._systems)x.build(j)}getResources(){return new Map(this._resources)}getResource(j){return this._resources.get(j)}getSystemBuilders(){return[...this._systems]}hasResource(j){return this._resources.has(j)}}function E(j,...x){if(x.length===0)return new Q(j);let F=new Q(j);for(let J of x){for(let H of J.getSystemBuilders())F.addSystem(H);for(let[H,M]of J.getResources().entries())F._setResource(H,M);for(let[H,M]of J.getAssets().entries())F._setAsset(H,M);for(let[H,M]of J.getScreens().entries())F._setScreen(H,M)}return F}function A(j){return{timer:{elapsed:0,duration:j,repeat:!1,active:!0,justFinished:!1}}}function L(j){return{timer:{elapsed:0,duration:j,repeat:!0,active:!0,justFinished:!1}}}function N(j){let{systemGroup:x="timers",priority:F=0}=j??{},J=new Q("timers");return J.addSystem("timer-update").setPriority(F).inGroup(x).addQuery("timers",{with:["timer"]}).setProcess((H,M)=>{for(let Y of H.timers){let{timer:K}=Y.components;if(K.justFinished=!1,!K.active)continue;if(K.elapsed+=M,K.elapsed>=K.duration)if(K.justFinished=!0,K.repeat)K.elapsed-=K.duration;else K.active=!1}}).and(),J}export{N as createTimerBundle,A as createTimer,L as createRepeatingTimer};
+var $=Object.create;var{getPrototypeOf:G,defineProperty:Z,getOwnPropertyNames:q}=Object;var z=Object.prototype.hasOwnProperty;var P=(j,x,F)=>{F=j!=null?$(G(j)):{};let K=x||!j||!j.__esModule?Z(F,"default",{value:j,enumerable:!0}):F;for(let H of q(j))if(!z.call(K,H))Z(K,H,{get:()=>j[H],enumerable:!0});return K};var W=((j)=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(j,{get:(x,F)=>(typeof require<"u"?require:x)[F]}):j)(function(j){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+j+'" is not supported')});class Y{_label;_ecspresso;_bundle;queries={};processFunction;detachFunction;initializeFunction;eventHandlers;_priority=0;_isRegistered=!1;_groups=[];_inScreens;_excludeScreens;_requiredAssets;constructor(j,x=null,F=null){this._label=j;this._ecspresso=x;this._bundle=F}get label(){return this._label}get bundle(){return this._bundle}get ecspresso(){return this._ecspresso}_autoRegister(){if(this._isRegistered||!this._ecspresso)return;let j=this._buildSystemObject();X(j,this._ecspresso),this._isRegistered=!0}_buildSystemObject(){return this._createSystemObject()}_createSystemObject(){let j={label:this._label,entityQueries:this.queries,priority:this._priority};if(this.processFunction)j.process=this.processFunction;if(this.detachFunction)j.onDetach=this.detachFunction;if(this.initializeFunction)j.onInitialize=this.initializeFunction;if(this.eventHandlers)j.eventHandlers=this.eventHandlers;if(this._groups.length>0)j.groups=[...this._groups];if(this._inScreens)j.inScreens=this._inScreens;if(this._excludeScreens)j.excludeScreens=this._excludeScreens;if(this._requiredAssets)j.requiredAssets=this._requiredAssets;return j}setPriority(j){return this._priority=j,this}inGroup(j){if(!this._groups.includes(j))this._groups.push(j);return this}inScreens(j){return this._inScreens=[...j],this}excludeScreens(j){return this._excludeScreens=[...j],this}requiresAssets(j){return this._requiredAssets=[...j],this}addQuery(j,x){let F=this;return F.queries={...this.queries,[j]:x},F}setProcess(j){return this.processFunction=j,this}registerAndContinue(){if(!this._ecspresso)throw Error(`Cannot register system '${this._label}': SystemBuilder is not attached to an ECSpresso instance. Use Bundle.addSystem() or ECSpresso.addSystem() instead.`);return this._autoRegister(),this._ecspresso}and(){if(this._ecspresso)return this._autoRegister(),this._ecspresso;if(this._bundle)return this._bundle;throw Error(`Cannot use and() on system '${this._label}': not attached to ECSpresso or Bundle.`)}setOnDetach(j){return this.detachFunction=j,this}setOnInitialize(j){return this.initializeFunction=j,this}setEventHandlers(j){return this.eventHandlers=j,this}build(j){let x=this._createSystemObject();if(this._ecspresso)X(x,this._ecspresso);if(j)X(x,j);return this}}function X(j,x){x._registerSystem(j)}function D(j,x){return new Y(j,x)}function _(j,x){return new Y(j,null,x)}function C(){return`bundle_${Date.now().toString(36)}_${Math.random().toString(36).substring(2,9)}`}class U{_systems=[];_resources=new Map;_assets=new Map;_assetGroups=new Map;_screens=new Map;_id;constructor(j){this._id=j||C()}get id(){return this._id}set id(j){this._id=j}addSystem(j){if(typeof j==="string"){let x=_(j,this);return this._systems.push(x),x}else return this._systems.push(j),j}addResource(j,x){return this._resources.set(j,x),this}addAsset(j,x,F){return this._assets.set(j,{loader:x,eager:F?.eager??!0,group:F?.group}),this}addAssetGroup(j,x){let F=new Map;for(let[K,H]of Object.entries(x))F.set(K,H),this._assets.set(K,{loader:H,eager:!1,group:j});return this._assetGroups.set(j,F),this}addScreen(j,x){return this._screens.set(j,x),this}getAssets(){return new Map(this._assets)}getScreens(){return new Map(this._screens)}_setResource(j,x){this._resources.set(j,x)}_setAsset(j,x){this._assets.set(j,x)}_setScreen(j,x){this._screens.set(j,x)}getSystems(){return this._systems.map((j)=>j.build())}registerSystemsWithEcspresso(j){for(let x of this._systems)x.build(j)}getResources(){return new Map(this._resources)}getResource(j){return this._resources.get(j)}getSystemBuilders(){return[...this._systems]}hasResource(j){return this._resources.has(j)}}function O(j,...x){if(x.length===0)return new U(j);let F=new U(j);for(let K of x){for(let H of K.getSystemBuilders())F.addSystem(H);for(let[H,M]of K.getResources().entries())F._setResource(H,M);for(let[H,M]of K.getAssets().entries())F._setAsset(H,M);for(let[H,M]of K.getScreens().entries())F._setScreen(H,M)}return F}function T(j,x){return{timer:{elapsed:0,duration:j,repeat:!1,active:!0,justFinished:!1,onComplete:x?.onComplete}}}function S(j,x){return{timer:{elapsed:0,duration:j,repeat:!0,active:!0,justFinished:!1,onComplete:x?.onComplete}}}function k(j){let{systemGroup:x="timers",priority:F=0}=j??{},K=new U("timers");K.addSystem("timer-update").setPriority(F).inGroup(x).addQuery("timers",{with:["timer"]}).setProcess((M,V,Q)=>{for(let R of M.timers){let{timer:J}=R.components;if(J.justFinished=!1,!J.active)continue;if(J.elapsed+=V,J.elapsed<J.duration)continue;if(J.repeat)while(J.elapsed>=J.duration)J.justFinished=!0,H(Q,R.id,J),J.elapsed-=J.duration;else J.justFinished=!0,H(Q,R.id,J),J.active=!1,Q.commands.removeEntity(R.id)}}).and();function H(M,V,Q){if(!Q.onComplete)return;let R={entityId:V,duration:Q.duration,elapsed:Q.elapsed};M.eventBus.publish(Q.onComplete,R)}return K}export{k as createTimerBundle,T as createTimer,S as createRepeatingTimer};
 
-//# debugId=13DBE68984ED14A764756E2164756E21
+//# debugId=8A5D1E808447563C64756E2164756E21
 //# sourceMappingURL=timers.js.map