@zylem/behaviors 0.2.0

package/dist/cooldown.d.ts

@@ -0,0 +1,116 @@
+import { a as BehaviorDescriptor } from './behavior-system-DYbx-x_-.js';
+
+/**
+ * CooldownBehavior
+ *
+ * A stage-scoped behavior that manages named cooldowns via the global CooldownStore.
+ * Entities use this to register, check, and fire cooldowns.
+ * UI components (CooldownIcon) can read from the same store.
+ */
+interface CooldownConfig {
+    /** Duration in seconds */
+    duration: number;
+    /** Whether the cooldown starts ready (default: true) */
+    immediate?: boolean;
+}
+interface CooldownOptions {
+    /**
+     * Named cooldowns to register.
+     * Keys are the cooldown names, values are their config.
+     */
+    cooldowns: Record<string, CooldownConfig>;
+}
+/**
+ * Handle methods returned by entity.use(CooldownBehavior, ...).
+ */
+interface CooldownHandle {
+    /** Check if a named cooldown is ready */
+    isReady(name: string): boolean;
+    /** Fire (trigger) a named cooldown, resetting its timer */
+    fire(name: string): void;
+    /** Force a cooldown to ready immediately */
+    reset(name: string): void;
+    /** Get cooldown progress 0..1 (0 = just fired, 1 = ready) */
+    getProgress(name: string): number;
+}
+/**
+ * CooldownBehavior
+ *
+ * @example
+ * ```ts
+ * import { CooldownBehavior } from '@zylem/game-lib/behavior';
+ * import { moveBy } from '@zylem/game-lib/actions';
+ *
+ * const hero = createBox({ ... });
+ * const cd = hero.use(CooldownBehavior, {
+ *   cooldowns: {
+ *     attack: { duration: 5 },
+ *     dash: { duration: 2, immediate: false },
+ *   },
+ * });
+ *
+ * hero.onUpdate(({ me, inputs }) => {
+ *   if (cd.isReady('attack') && inputs.p1.buttons.A.pressed) {
+ *     cd.fire('attack');
+ *     // perform attack
+ *   }
+ *   if (cd.isReady('dash') && inputs.p1.buttons.B.pressed) {
+ *     cd.fire('dash');
+ *     me.runAction(moveBy({ x: 10, duration: 0.3 }));
+ *   }
+ * });
+ * ```
+ */
+declare const CooldownBehavior: BehaviorDescriptor<CooldownOptions, CooldownHandle, unknown>;
+
+/**
+ * A single cooldown entry in the global store.
+ */
+interface CooldownEntry {
+    /** Identifier for this cooldown */
+    name: string;
+    /** Total cooldown time in seconds */
+    duration: number;
+    /** Time accumulated since last fire */
+    elapsed: number;
+    /** Whether the cooldown is ready (elapsed >= duration) */
+    ready: boolean;
+    /** Normalized progress 0..1 (0 = just fired, 1 = ready) */
+    progress: number;
+    /** Whether this cooldown is currently counting down */
+    active: boolean;
+}
+/**
+ * Register a named cooldown in the global store.
+ * If a cooldown with the same name already exists, it is overwritten.
+ *
+ * @param name Unique cooldown identifier
+ * @param duration Cooldown duration in seconds
+ * @param immediate If true, the cooldown starts ready (default: true)
+ */
+declare function registerCooldown(name: string, duration: number, immediate?: boolean): void;
+/**
+ * Get a cooldown entry by name.
+ * Returns undefined if the cooldown has not been registered.
+ */
+declare function getCooldown(name: string): CooldownEntry | undefined;
+/**
+ * Fire (trigger) a cooldown, resetting its timer.
+ * Sets the cooldown to not-ready and starts the countdown.
+ */
+declare function fireCooldown(name: string): void;
+/**
+ * Force a cooldown to ready immediately.
+ */
+declare function resetCooldown(name: string): void;
+/**
+ * Advance all active cooldowns by delta seconds.
+ * Called once per frame by the CooldownBehavior system.
+ */
+declare function tickCooldowns(delta: number): void;
+/**
+ * Get the raw cooldown store (for advanced/debugging use).
+ */
+declare function getCooldownStore(): Record<string, CooldownEntry>;
+
+export { CooldownBehavior, type CooldownConfig, type CooldownEntry, type CooldownHandle, type CooldownOptions, fireCooldown, getCooldown, getCooldownStore, registerCooldown, resetCooldown, tickCooldowns };

package/dist/cooldown.js

@@ -0,0 +1,20 @@
+import {
+  CooldownBehavior,
+  fireCooldown,
+  getCooldown,
+  getCooldownStore,
+  registerCooldown,
+  resetCooldown,
+  tickCooldowns
+} from "./chunk-K3UNLQ7W.js";
+import "./chunk-EZNCCO4L.js";
+export {
+  CooldownBehavior,
+  fireCooldown,
+  getCooldown,
+  getCooldownStore,
+  registerCooldown,
+  resetCooldown,
+  tickCooldowns
+};
+//# sourceMappingURL=cooldown.js.map

package/dist/cooldown.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/coordinators/boundary-ricochet-3d.d.ts

@@ -0,0 +1,19 @@
+import { G as GameEntity } from '../behavior-system-DYbx-x_-.js';
+import { M as MoveableEntity } from '../moveable-BCRpjAQb.js';
+import { Ricochet3DHandle } from '../ricochet-3d.js';
+import { WorldBoundary3DHandle } from '../world-boundary-3d.js';
+import 'three';
+import '@dimforge/rapier3d-compat';
+import '../sync-state-machine-CZyspBpj.js';
+import 'typescript-fsm';
+import '../entity-types-CmtQ-IBp.js';
+
+declare class BoundaryRicochet3DCoordinator {
+    private entity;
+    private boundary;
+    private ricochet;
+    constructor(entity: GameEntity<any> & MoveableEntity, boundary: WorldBoundary3DHandle, ricochet: Ricochet3DHandle);
+    update(): boolean;
+}
+
+export { BoundaryRicochet3DCoordinator };

package/dist/coordinators/boundary-ricochet-3d.js

@@ -0,0 +1,8 @@
+import {
+  BoundaryRicochet3DCoordinator
+} from "../chunk-3PYGRHAL.js";
+import "../chunk-OHCPV2NT.js";
+export {
+  BoundaryRicochet3DCoordinator
+};
+//# sourceMappingURL=boundary-ricochet-3d.js.map

package/dist/coordinators/boundary-ricochet-3d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/coordinators/boundary-ricochet.d.ts

@@ -0,0 +1,34 @@
+import { G as GameEntity } from '../behavior-system-DYbx-x_-.js';
+import { Ricochet2DHandle } from '../ricochet-2d.js';
+import { WorldBoundary2DHandle } from '../world-boundary-2d.js';
+import { M as MoveableEntity } from '../moveable-BCRpjAQb.js';
+import '../entity-types-CmtQ-IBp.js';
+import 'three';
+import '@dimforge/rapier3d-compat';
+import '../sync-state-machine-CZyspBpj.js';
+import 'typescript-fsm';
+
+/**
+ * Coordinator that bridges WorldBoundary2DBehavior and Ricochet2DBehavior.
+ *
+ * Automatically handles:
+ * 1. Checking boundary hits
+ * 2. Computing collision normals
+ * 3. Requesting ricochet result
+ * 4. Applying movement
+ */
+declare class BoundaryRicochetCoordinator {
+    private entity;
+    private boundary;
+    private ricochet;
+    constructor(entity: GameEntity<any> & MoveableEntity, boundary: WorldBoundary2DHandle, ricochet: Ricochet2DHandle);
+    /**
+     * Update loop - call this every frame.
+     * Applies ricochet via transformStore and notifies listeners.
+     *
+     * @returns true if ricochet was applied, false otherwise
+     */
+    update(): boolean;
+}
+
+export { BoundaryRicochetCoordinator };

package/dist/coordinators/boundary-ricochet.js

@@ -0,0 +1,8 @@
+import {
+  BoundaryRicochetCoordinator
+} from "../chunk-GCNRXAKH.js";
+import "../chunk-KDY5N6J4.js";
+export {
+  BoundaryRicochetCoordinator
+};
+//# sourceMappingURL=boundary-ricochet.js.map

package/dist/coordinators/boundary-ricochet.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/coordinators/first-person-shooter.d.ts

@@ -0,0 +1,35 @@
+import { G as GameEntity } from '../behavior-system-DYbx-x_-.js';
+import { F as FirstPersonInputComponent } from '../components-qWwOsvwh.js';
+import { b as JumpInput3D } from '../components--hjBMTnz.js';
+
+interface FirstPersonShooterInput {
+    moveX: number;
+    moveZ: number;
+    lookX: number;
+    lookY: number;
+    sprint: boolean;
+    jumpPressed: boolean;
+    jumpHeld: boolean;
+    jumpReleased: boolean;
+    fastFall?: boolean;
+}
+interface FirstPersonShooterControllerHandle {
+    getYaw(): number;
+}
+interface FirstPersonShooterJumperHandle {
+    getState(): unknown;
+}
+type FirstPersonShooterEntity = GameEntity<any> & {
+    $fps?: FirstPersonInputComponent;
+    $jumper?: JumpInput3D;
+};
+declare class FirstPersonShooterCoordinator {
+    private entity;
+    private fpsController;
+    private jumper;
+    constructor(entity: FirstPersonShooterEntity, fpsController: FirstPersonShooterControllerHandle, jumper: FirstPersonShooterJumperHandle);
+    update(input: FirstPersonShooterInput): void;
+    private getMoveDirWorld;
+}
+
+export { FirstPersonShooterCoordinator, type FirstPersonShooterInput };

package/dist/coordinators/first-person-shooter.js

@@ -0,0 +1,9 @@
+import {
+  FirstPersonShooterCoordinator
+} from "../chunk-VAN4WW3F.js";
+import "../chunk-LD5SMIB3.js";
+import "../chunk-DYLH6K7B.js";
+export {
+  FirstPersonShooterCoordinator
+};
+//# sourceMappingURL=first-person-shooter.js.map

package/dist/coordinators/first-person-shooter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/coordinators/multidirectional-space-shooter.d.ts

@@ -0,0 +1,27 @@
+import { G as GameEntity } from '../behavior-system-DYbx-x_-.js';
+import { T as ThrusterInputComponent } from '../components-B29WHGQN.js';
+import { Shooter2DSourceEntity, Shooter2DHandle, Shooter2DStageLike } from '../shooter-2d.js';
+import '../vector-Bm65-FOG.js';
+import 'three';
+import '@dimforge/rapier3d-compat';
+
+interface MultidirectionalSpaceShooterInput {
+    moveX: number;
+    moveY: number;
+    aimX: number;
+    aimY: number;
+    shootPressed: boolean;
+    shootHeld: boolean;
+}
+type MultidirectionalSpaceShooterEntity = GameEntity<any> & Shooter2DSourceEntity & {
+    $thruster?: ThrusterInputComponent;
+};
+declare class MultidirectionalSpaceShooterCoordinator {
+    private entity;
+    private shooter;
+    private stage;
+    constructor(entity: MultidirectionalSpaceShooterEntity, shooter: Shooter2DHandle, stage: Shooter2DStageLike);
+    update(input: MultidirectionalSpaceShooterInput): void;
+}
+
+export { MultidirectionalSpaceShooterCoordinator, type MultidirectionalSpaceShooterInput };

package/dist/coordinators/multidirectional-space-shooter.js

@@ -0,0 +1,10 @@
+import {
+  MultidirectionalSpaceShooterCoordinator
+} from "../chunk-RTRVBEIB.js";
+import "../chunk-6C6NXNEW.js";
+import "../chunk-KS72RZHX.js";
+import "../chunk-ID5QJYF5.js";
+export {
+  MultidirectionalSpaceShooterCoordinator
+};
+//# sourceMappingURL=multidirectional-space-shooter.js.map

package/dist/coordinators/multidirectional-space-shooter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/coordinators/top-down-shooter.d.ts

@@ -0,0 +1,27 @@
+import { a as TopDownMovementInputComponent } from '../components-XCpL6IYt.js';
+import { Shooter2DSourceEntity, Shooter2DHandle, Shooter2DStageLike } from '../shooter-2d.js';
+import '../behavior-system-DYbx-x_-.js';
+import '../vector-Bm65-FOG.js';
+import 'three';
+import '@dimforge/rapier3d-compat';
+
+interface TopDownShooterInput {
+    moveX: number;
+    moveY: number;
+    aimX: number;
+    aimY: number;
+    shootPressed: boolean;
+    shootHeld: boolean;
+}
+type TopDownShooterEntity = Shooter2DSourceEntity & {
+    $topDownMovement?: TopDownMovementInputComponent;
+};
+declare class TopDownShooterCoordinator {
+    private entity;
+    private shooter;
+    private stage;
+    constructor(entity: TopDownShooterEntity, shooter: Shooter2DHandle, stage: Shooter2DStageLike);
+    update(input: TopDownShooterInput): void;
+}
+
+export { TopDownShooterCoordinator, type TopDownShooterInput };

package/dist/coordinators/top-down-shooter.js

@@ -0,0 +1,10 @@
+import {
+  TopDownShooterCoordinator
+} from "../chunk-FPTWVCPN.js";
+import "../chunk-6C6NXNEW.js";
+import "../chunk-EIWQM6U3.js";
+import "../chunk-ID5QJYF5.js";
+export {
+  TopDownShooterCoordinator
+};
+//# sourceMappingURL=top-down-shooter.js.map

package/dist/coordinators/top-down-shooter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/core.d.ts

@@ -0,0 +1,25 @@
+export { B as BaseBehaviorHandle, a as BehaviorDescriptor, b as BehaviorEcsHandle, c as BehaviorEntityLink, d as BehaviorHandle, e as BehaviorRef, f as BehaviorSystem, g as BehaviorSystemContext, h as BehaviorSystemFactory, C as CreateEntityFn, D as DefineBehaviorConfig, G as GameEntity, i as GameEntityOptions, S as StageBodyKind, j as StageBoundaryDim, k as StageEventType, l as StageRicochetDim, m as StageRicochetReflection, n as StageTopDownPlane, W as WasmStageRuntime, o as WasmStageRuntimeOptions, p as defineBehavior } from './behavior-system-DYbx-x_-.js';
+export { u as useBehavior } from './use-behavior-D_82jAL3.js';
+export { P as PhysicsBodyComponent, T as TransformComponent, c as createPhysicsBodyComponent, a as createTransformComponent } from './components-BWG1GkZA.js';
+import { a as VelocityIntentMode, T as TransformState } from './moveable-BCRpjAQb.js';
+export { E as EntityWithBody, M as MoveableEntity, V as VelocityIntent, c as createTransformStore, g as getPosition, b as getVelocity, m as makeMoveable, d as move, e as moveForwardXY, f as moveX, h as moveXY, i as moveXZ, j as moveY, k as moveZ, r as resetTransformStore, l as resetVelocity, s as setPosition, n as setPositionX, o as setPositionY, p as setPositionZ, w as wrapAround3D, q as wrapAroundXY } from './moveable-BCRpjAQb.js';
+export { V as VEC2_ONE, a as VEC2_ZERO, b as VEC3_ONE, c as VEC3_ZERO, d as Vec2, e as Vec2Components, f as Vec2Input, g as Vec3, h as Vec3Components, i as Vec3Input, j as isVec2Input, k as isVec3Input, n as normalizeVec2, l as normalizeVec3, t as toRapierVector3, m as toThreeVector2, o as toThreeVector3 } from './vector-Bm65-FOG.js';
+export { S as SyncStateMachine } from './sync-state-machine-CZyspBpj.js';
+export { F as FirstPersonPerspective } from './first-person-perspective-C9Mptl0-.js';
+export { ILogger, ITransition, SyncCallback, t } from 'typescript-fsm';
+import '@dimforge/rapier3d-compat';
+import 'three';
+
+interface VelocityIntentOptions {
+    mode?: VelocityIntentMode;
+    priority?: number;
+}
+interface VelocityIntentVector {
+    x?: number;
+    y?: number;
+    z?: number;
+}
+declare function setVelocityIntent(store: TransformState, sourceId: string, vector: VelocityIntentVector, options?: VelocityIntentOptions): void;
+declare function clearVelocityIntent(store: TransformState, sourceId: string): void;
+
+export { TransformState, VelocityIntentMode, type VelocityIntentOptions, type VelocityIntentVector, clearVelocityIntent, setVelocityIntent };