@zylem/behaviors 0.2.0

package/README.md

@@ -0,0 +1,26 @@
+# Zylem Behaviors
+
+Tree-shakable Zylem behavior descriptors, systems, coordinators, and shared behavior helpers.
+
+Use per-behavior entrypoints when you want bundlers to pull only the behavior family you import:
+
+```ts
+import { ScreenWrapBehavior } from '@zylem/behaviors/screen-wrap';
+import { CooldownBehavior } from '@zylem/behaviors/cooldown';
+```
+
+The package is ESM-only and declares `sideEffects: false`.
+
+## Requirements
+
+- Node >= 22.12.0
+- pnpm >= 10.32.1
+
+## Commands
+
+```bash
+pnpm install
+pnpm build
+pnpm typecheck
+pnpm test
+```

package/dist/behavior-system-DYbx-x_-.d.ts

@@ -0,0 +1,307 @@
+/**
+ * BehaviorDescriptor
+ *
+ * Type-safe behavior descriptors that provide options inference.
+ * Used with entity.use() to declaratively attach behaviors to entities.
+ *
+ * Each behavior can define its own handle type via `createHandle`,
+ * providing behavior-specific methods with full type safety.
+ */
+
+/**
+ * Base handle returned by entity.use() for lazy access to behavior runtime.
+ * FSM is null until entity is spawned and components are initialized.
+ */
+interface BaseBehaviorHandle<O extends Record<string, any> = Record<string, any>> {
+    /** Get the FSM instance (null until entity is spawned) */
+    getFSM(): any | null;
+    /** Get the current options */
+    getOptions(): O;
+    /** Access the underlying behavior ref */
+    readonly ref: BehaviorRef<O>;
+}
+/**
+ * Reference to a behavior stored on an entity
+ */
+interface BehaviorRef<O extends Record<string, any> = Record<string, any>> {
+    /** The behavior descriptor */
+    descriptor: BehaviorDescriptor<O, any>;
+    /** Merged options (defaults + overrides) */
+    options: O;
+    /** Optional FSM instance - set lazily when entity is spawned */
+    fsm?: any;
+}
+/**
+ * A typed behavior descriptor that associates a symbol key with:
+ * - Default options (providing type inference)
+ * - A system factory to create the behavior system
+ * - An optional handle factory for behavior-specific methods
+ */
+interface BehaviorDescriptor<O extends Record<string, any> = Record<string, any>, H extends Record<string, any> = Record<string, never>, I = unknown> {
+    /** Unique symbol identifying this behavior */
+    readonly key: symbol;
+    /** Default options (used for type inference) */
+    readonly defaultOptions: O;
+    /** Factory to create the behavior system */
+    readonly systemFactory: any;
+    /**
+     * Optional factory to create behavior-specific handle methods.
+     * These methods are merged into the handle returned by entity.use().
+     */
+    readonly createHandle?: (ref: any) => H;
+}
+/**
+ * The full handle type returned by entity.use().
+ * Combines base handle with behavior-specific methods.
+ */
+type BehaviorHandle<O extends Record<string, any> = Record<string, any>, H extends Record<string, any> = Record<string, never>> = BaseBehaviorHandle<O> & H;
+/**
+ * Configuration for defining a new behavior
+ */
+interface DefineBehaviorConfig<O extends Record<string, any>, H extends Record<string, any> = Record<string, never>, I = unknown> {
+    /** Human-readable name for debugging */
+    name: string;
+    /** Default options - these define the type */
+    defaultOptions: O;
+    /** Factory function to create the system */
+    systemFactory: BehaviorSystemFactory;
+    /**
+     * Optional factory to create behavior-specific handle methods.
+     * The returned object is merged into the handle returned by entity.use().
+     *
+     * @example
+     * ```typescript
+     * createHandle: (ref) => ({
+     *   getLastHits: () => ref.fsm?.getLastHits() ?? null,
+     *   getMovement: (moveX, moveY) => ref.fsm?.getMovement(moveX, moveY) ?? { moveX, moveY },
+     * }),
+     * ```
+     */
+    createHandle?: (ref: BehaviorRef<O>) => H;
+}
+/**
+ * Define a typed behavior descriptor.
+ *
+ * @example
+ * ```typescript
+ * export const WorldBoundary2DBehavior = defineBehavior({
+ *   name: 'world-boundary-2d',
+ *   defaultOptions: { boundaries: { top: 0, bottom: 0, left: 0, right: 0 } },
+ *   systemFactory: (ctx) => new WorldBoundary2DSystem(ctx.world),
+ *   createHandle: (ref) => ({
+ *     getLastHits: () => ref.fsm?.getLastHits() ?? null,
+ *     getMovement: (moveX: number, moveY: number) =>
+ *       ref.fsm?.getMovement(moveX, moveY) ?? { moveX, moveY },
+ *   }),
+ * });
+ *
+ * // Usage - handle has getLastHits and getMovement with full types
+ * const boundary = ship.use(WorldBoundary2DBehavior, { ... });
+ * const hits = boundary.getLastHits(); // Fully typed!
+ * ```
+ */
+declare function defineBehavior<O extends Record<string, any>, H extends Record<string, any> = Record<string, never>, I = unknown>(config: DefineBehaviorConfig<O, H, I>): BehaviorDescriptor<O, H, I>;
+
+/**
+ * Minimal, runtime-agnostic entity options contract.
+ *
+ * The full engine entity (in `@zylem/game-lib`) provides a richer options type,
+ * but behaviors only rely on this loose shape.
+ */
+interface GameEntityOptions {
+    [key: string]: any;
+    name?: string;
+}
+/**
+ * Structural stand-in for the engine `GameEntity`.
+ *
+ * Behaviors annotate against this loose contract so that `@zylem/behaviors`
+ * (and its `@zylem/behaviors/core` surface) never has to depend on the concrete
+ * `@zylem/game-lib` entity implementation. The real engine entity is
+ * structurally assignable to this type.
+ */
+declare class GameEntity<TOptions = unknown> {
+    [key: string]: any;
+    uuid: string;
+    name: string;
+    type: string;
+    options?: TOptions & Record<string, unknown>;
+    group: any;
+    mesh?: any;
+    materials?: any[];
+    body: any;
+    collider: any;
+    colliderDesc?: any;
+    colliderDescs: any[];
+    bodyDesc?: any;
+    physicsAttached: boolean;
+    runtimeHandle?: number;
+    transformStore?: any;
+    nodeDestroy?: any;
+    isInstanced?: boolean;
+    private __behaviorRefs;
+    create(): this;
+    onCleanup(callback: () => void): this;
+    setPosition(_x: number, _y: number, _z: number): void;
+    setRotation(_x: number, _y: number, _z: number): void;
+    setRotationZ(_z: number): void;
+    setScale(_x: number, _y: number, _z: number): void;
+    /**
+     * Attach a behavior to this entity. The real engine entity does substantially
+     * more, but this functional stub stores the merged ref and builds the handle
+     * so descriptor/handle logic (and tests that drive behaviors directly) work
+     * without the full engine.
+     */
+    use<O extends Record<string, any>, H extends Record<string, any> = Record<string, never>>(descriptor: BehaviorDescriptor<O, H>, options?: Partial<O>): BehaviorHandle<O, H>;
+    /** Live behavior refs attached via {@link use}. */
+    getBehaviorRefs(): BehaviorRef<any>[];
+}
+/**
+ * Factory contract injected into behavior systems via
+ * {@link BehaviorSystemContext.createEntity}. The host engine supplies the real
+ * entity factory at stage-construction time.
+ */
+type CreateEntityFn = (options?: Partial<GameEntityOptions>) => GameEntity<GameEntityOptions>;
+
+declare const StageBodyKind: {
+    readonly Dynamic: 0;
+    readonly Static: 1;
+    readonly KinematicPosition: 2;
+    readonly KinematicVelocity: 3;
+};
+declare const StageBoundaryDim: {
+    readonly Two: 2;
+    readonly Three: 3;
+};
+declare const StageRicochetDim: {
+    readonly Two: 2;
+    readonly Three: 3;
+};
+declare const StageRicochetReflection: {
+    readonly Mirror: 0;
+    readonly Angled: 1;
+};
+declare const StageTopDownPlane: {
+    readonly Xy: 0;
+    readonly Xz: 1;
+};
+declare const StageEventType: {
+    readonly CollisionStarted: 1;
+    readonly CollisionStopped: 2;
+    readonly BoundaryHit: 3;
+    readonly Ricochet: 4;
+    readonly RegionEntered: 5;
+    readonly JumpStarted: 6;
+    readonly Landed: 7;
+    readonly Wrapped: 8;
+    readonly CooldownFired: 9;
+};
+interface WasmStageRuntime {
+    getPose(handle: number): any;
+    attachThruster(handle: number, opts: any): boolean;
+    setThrusterInput(handle: number, thrust: number, rotate: number): void;
+    attachTopDown(handle: number, opts: {
+        plane: number;
+        speed: number;
+        faceMovement?: boolean;
+    }): boolean;
+    setTopDownInput(handle: number, moveX: number, moveY: number): void;
+    attachShooter2D(handle: number, opts: any): boolean;
+    attachScreenWrap(handle: number, opts: any): boolean;
+    queryScreenWrap(handle: number): any;
+    attachWorldBoundary(handle: number, dim: number, opts: any): boolean;
+    queryWorldBoundary(handle: number): any;
+    attachRicochet(handle: number, dim: number, opts: any): boolean;
+    attachPlatformer3D(handle: number, opts: any): boolean;
+    setPlatformer3DInputAxes(handle: number, moveX: number, moveZ: number): void;
+    setPlatformer3DInputButtons(handle: number, jump: boolean, run: boolean): void;
+    attachFirstPerson(handle: number, opts: any): boolean;
+    setFirstPersonInput(handle: number, input: any): void;
+    attachJumper2D(handle: number, opts: any): boolean;
+    setJumper2DInput(handle: number, jumpPressed: boolean): void;
+    attachJumper3D(handle: number, opts: any): boolean;
+    setJumper3DInput(handle: number, jumpPressed: boolean): void;
+}
+/** Default options used when constructing a wasm-backed Stage runtime. */
+interface WasmStageRuntimeOptions {
+    initialCapacity?: number;
+    gravity?: readonly [number, number, number];
+    imports?: WebAssembly.Imports;
+}
+
+/**
+ * BehaviorSystem Interface
+ *
+ * Legacy behavior systems reserved the first `update` argument for an ECS world
+ * handle; it is always `undefined` now.
+ */
+/** @deprecated Retained only for the first argument slot of `BehaviorSystem.update`. */
+type BehaviorEcsHandle = unknown;
+/**
+ * A behavior system that processes entities with specific components.
+ *
+ * @example
+ * ```typescript
+ * class ThrusterMovementSystem implements BehaviorSystem {
+ *   update(_ecs: BehaviorEcsHandle | undefined, delta: number): void {
+ *     // Iterate behavior links, push intent into wasm runtime, etc.
+ *   }
+ * }
+ * ```
+ */
+interface BehaviorSystem {
+    /** Optional eager initialization when a behavior link is registered on a live entity */
+    attach?(link: BehaviorEntityLink): void;
+    /** Called once per frame. The first argument is always `undefined` (reserved legacy slot). */
+    update(ecs: BehaviorEcsHandle | undefined, delta: number): void;
+    /** Optional cleanup when a behavior link is detached from a live entity */
+    detach?(link: BehaviorEntityLink): void;
+    /** Optional cleanup when stage is destroyed */
+    destroy?(ecs?: BehaviorEcsHandle): void;
+}
+/**
+ * Runtime link between a spawned entity and one of its behavior refs.
+ * Systems can iterate these links to avoid scanning all world entities.
+ */
+interface BehaviorEntityLink {
+    entity: any;
+    ref: any;
+}
+/**
+ * Context provided to behavior-system factories.
+ *
+ * After the runtime-only stage migration, `wasmStage` is the source of
+ * truth — descriptors should call `wasmStage.attach<X>(handle, opts)` /
+ * `wasmStage.query<X>(handle)` from inside the system instead of touching
+ * `entity.body` directly. The legacy `world` / `scene` fields remain for
+ * unmigrated descriptors.
+ */
+interface BehaviorSystemContext {
+    world: any;
+    scene: any;
+    /** Wasm-driven Stage runtime; omitted when the stage has no wasm module. */
+    wasmStage?: WasmStageRuntime | null;
+    /**
+     * Returns live behavior links for a descriptor key.
+     * O(1) lookup into a pre-built stage index.
+     */
+    getBehaviorLinks?: (key: symbol) => Iterable<BehaviorEntityLink>;
+    /**
+     * Host-injected entity factory. Behaviors that spawn entities at runtime
+     * (e.g. destructible-3d fragments) use this instead of importing the engine
+     * entity factory directly, keeping the behavior layer decoupled.
+     */
+    createEntity?: CreateEntityFn;
+    /**
+     * Host-injected accessor for the global game-state bag, passed to entity
+     * lifecycle hooks (e.g. `nodeDestroy`).
+     */
+    getGlobals?: () => any;
+}
+/**
+ * Factory function that creates a BehaviorSystem.
+ * Receives the stage for access to world, scene, etc.
+ */
+type BehaviorSystemFactory<T extends BehaviorSystem = BehaviorSystem> = (stage: BehaviorSystemContext) => T;
+
+export { type BaseBehaviorHandle as B, type CreateEntityFn as C, type DefineBehaviorConfig as D, GameEntity as G, StageBodyKind as S, type WasmStageRuntime as W, type BehaviorDescriptor as a, type BehaviorEcsHandle as b, type BehaviorEntityLink as c, type BehaviorHandle as d, type BehaviorRef as e, type BehaviorSystem as f, type BehaviorSystemContext as g, type BehaviorSystemFactory as h, type GameEntityOptions as i, StageBoundaryDim as j, StageEventType as k, StageRicochetDim as l, StageRicochetReflection as m, StageTopDownPlane as n, type WasmStageRuntimeOptions as o, defineBehavior as p };

package/dist/chunk-2C3Z5GE7.js

@@ -0,0 +1,176 @@
+import {
+  defineBehavior
+} from "./chunk-EZNCCO4L.js";
+
+// src/lib/behaviors/runtime-pong/runtime-pong.descriptors.ts
+var runtimeNoopSystemFactory = () => ({
+  update(_ecs, _delta) {
+  }
+});
+var RUNTIME_PONG_BALL_BEHAVIOR_KEY = /* @__PURE__ */ Symbol.for("zylem:behavior:runtime-pong-ball");
+var RUNTIME_PADDLE_INPUT_2D_BEHAVIOR_KEY = /* @__PURE__ */ Symbol.for("zylem:behavior:runtime-paddle-input-2d");
+var RUNTIME_WORLD_BOUNDARY_2D_BEHAVIOR_KEY = /* @__PURE__ */ Symbol.for("zylem:behavior:runtime-world-boundary-2d");
+var RUNTIME_RICOCHET_2D_BEHAVIOR_KEY = /* @__PURE__ */ Symbol.for("zylem:behavior:runtime-ricochet-2d");
+var RUNTIME_TRIGGER_REGION_2D_BEHAVIOR_KEY = /* @__PURE__ */ Symbol.for("zylem:behavior:runtime-trigger-region-2d");
+var RUNTIME_GOAL_ZONE_2D_BEHAVIOR_KEY = /* @__PURE__ */ Symbol.for("zylem:behavior:runtime-goal-zone-2d");
+var RICOCHET_LISTENERS = /* @__PURE__ */ Symbol("runtime-ricochet-listeners");
+var TRIGGER_REGION_LISTENERS = /* @__PURE__ */ Symbol("runtime-trigger-region-listeners");
+var GOAL_LISTENERS = /* @__PURE__ */ Symbol("runtime-goal-listeners");
+var RUNTIME_BALL_SET_POSITION = /* @__PURE__ */ Symbol("runtime-ball-set-position");
+var RUNTIME_BALL_SET_VELOCITY = /* @__PURE__ */ Symbol("runtime-ball-set-velocity");
+var RUNTIME_BALL_GET_POSITION = /* @__PURE__ */ Symbol("runtime-ball-get-position");
+var RuntimePongBallBehavior = defineBehavior({
+  name: "runtime-pong-ball",
+  defaultOptions: {
+    initialVelocity: [0, 0]
+  },
+  systemFactory: runtimeNoopSystemFactory,
+  createHandle: (ref) => ({
+    setRuntimePosition(x, y, z = 0) {
+      const callback = ref[RUNTIME_BALL_SET_POSITION];
+      callback?.(x, y, z);
+    },
+    setRuntimeVelocity(x, y) {
+      const callback = ref[RUNTIME_BALL_SET_VELOCITY];
+      callback?.(x, y);
+    },
+    getRuntimePosition() {
+      const callback = ref[RUNTIME_BALL_GET_POSITION];
+      return callback?.() ?? null;
+    }
+  })
+});
+var RuntimePaddleInput2DBehavior = defineBehavior({
+  name: "runtime-paddle-input-2d",
+  defaultOptions: {
+    player: "p1",
+    speed: 5
+  },
+  systemFactory: runtimeNoopSystemFactory
+});
+var RuntimeWorldBoundary2DBehavior = defineBehavior({
+  name: "runtime-world-boundary-2d",
+  defaultOptions: {
+    boundaries: {
+      left: 0,
+      right: 0,
+      bottom: 0,
+      top: 0
+    }
+  },
+  systemFactory: runtimeNoopSystemFactory
+});
+var RuntimeRicochet2DBehavior = defineBehavior({
+  name: "runtime-ricochet-2d",
+  defaultOptions: {
+    minSpeed: 2,
+    maxSpeed: 20,
+    speedMultiplier: 1.05,
+    reflectionMode: "angled",
+    maxAngleDeg: 60
+  },
+  systemFactory: runtimeNoopSystemFactory,
+  createHandle: (ref) => ({
+    onRicochet(callback) {
+      const listeners = ref[RICOCHET_LISTENERS] ?? [];
+      if (!ref[RICOCHET_LISTENERS]) {
+        ref[RICOCHET_LISTENERS] = listeners;
+      }
+      listeners.push(callback);
+      return () => {
+        const index = listeners.indexOf(callback);
+        if (index >= 0) {
+          listeners.splice(index, 1);
+        }
+      };
+    }
+  })
+});
+var RuntimeTriggerRegion2DBehavior = defineBehavior({
+  name: "runtime-trigger-region-2d",
+  defaultOptions: {
+    triggerId: 0,
+    halfExtents: [0.5, 2.5]
+  },
+  systemFactory: runtimeNoopSystemFactory,
+  createHandle: (ref) => ({
+    onRegionEnter(callback) {
+      const listeners = ref[TRIGGER_REGION_LISTENERS] ?? [];
+      if (!ref[TRIGGER_REGION_LISTENERS]) {
+        ref[TRIGGER_REGION_LISTENERS] = listeners;
+      }
+      listeners.push(callback);
+      return () => {
+        const index = listeners.indexOf(callback);
+        if (index >= 0) {
+          listeners.splice(index, 1);
+        }
+      };
+    }
+  })
+});
+var RuntimeGoalZone2DBehavior = defineBehavior({
+  name: "runtime-goal-zone-2d",
+  defaultOptions: {
+    scorer: "p1"
+  },
+  systemFactory: runtimeNoopSystemFactory,
+  createHandle: (ref) => ({
+    onGoal(callback) {
+      const listeners = ref[GOAL_LISTENERS] ?? [];
+      if (!ref[GOAL_LISTENERS]) {
+        ref[GOAL_LISTENERS] = listeners;
+      }
+      listeners.push(callback);
+      return () => {
+        const index = listeners.indexOf(callback);
+        if (index >= 0) {
+          listeners.splice(index, 1);
+        }
+      };
+    }
+  })
+});
+function emitRuntimeRicochet(ref, event) {
+  const listeners = ref[RICOCHET_LISTENERS];
+  for (const listener of listeners ?? []) {
+    listener(event);
+  }
+}
+function emitRuntimeTriggerRegionEnter(ref, event) {
+  const listeners = ref[TRIGGER_REGION_LISTENERS];
+  for (const listener of listeners ?? []) {
+    listener(event);
+  }
+}
+function emitRuntimeGoal(ref, event) {
+  const listeners = ref[GOAL_LISTENERS];
+  for (const listener of listeners ?? []) {
+    listener(event);
+  }
+}
+function bindRuntimePongBallHandle(ref, controls) {
+  ref[RUNTIME_BALL_SET_POSITION] = controls.setPosition;
+  ref[RUNTIME_BALL_SET_VELOCITY] = controls.setVelocity;
+  ref[RUNTIME_BALL_GET_POSITION] = controls.getPosition;
+}
+
+export {
+  RUNTIME_PONG_BALL_BEHAVIOR_KEY,
+  RUNTIME_PADDLE_INPUT_2D_BEHAVIOR_KEY,
+  RUNTIME_WORLD_BOUNDARY_2D_BEHAVIOR_KEY,
+  RUNTIME_RICOCHET_2D_BEHAVIOR_KEY,
+  RUNTIME_TRIGGER_REGION_2D_BEHAVIOR_KEY,
+  RUNTIME_GOAL_ZONE_2D_BEHAVIOR_KEY,
+  RuntimePongBallBehavior,
+  RuntimePaddleInput2DBehavior,
+  RuntimeWorldBoundary2DBehavior,
+  RuntimeRicochet2DBehavior,
+  RuntimeTriggerRegion2DBehavior,
+  RuntimeGoalZone2DBehavior,
+  emitRuntimeRicochet,
+  emitRuntimeTriggerRegionEnter,
+  emitRuntimeGoal,
+  bindRuntimePongBallHandle
+};
+//# sourceMappingURL=chunk-2C3Z5GE7.js.map

package/dist/chunk-2C3Z5GE7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/behaviors/runtime-pong/runtime-pong.descriptors.ts"],"sourcesContent":["import {\n\tdefineBehavior,\n\ttype BehaviorRef,\n} from '../behavior-descriptor';\nimport type { BehaviorSystem } from '../behavior-system';\n\nexport interface RuntimePongBallOptions {\n\tinitialVelocity: readonly [number, number];\n}\n\nexport interface RuntimePongBallHandle {\n\tsetRuntimePosition(x: number, y: number, z?: number): void;\n\tsetRuntimeVelocity(x: number, y: number): void;\n\tgetRuntimePosition(): { x: number; y: number; z: number } | null;\n}\n\nexport interface RuntimePaddleInput2DOptions {\n\tplayer: 'p1' | 'p2';\n\tspeed: number;\n}\n\nexport interface RuntimeWorldBoundary2DOptions {\n\tboundaries: {\n\t\tleft: number;\n\t\tright: number;\n\t\tbottom: number;\n\t\ttop: number;\n\t};\n}\n\nexport interface RuntimeRicochet2DOptions {\n\tminSpeed: number;\n\tmaxSpeed: number;\n\tspeedMultiplier: number;\n\treflectionMode: 'simple' | 'angled';\n\tmaxAngleDeg: number;\n}\n\nexport interface RuntimeRicochet2DEvent {\n\tkind: 'wall' | 'paddle';\n}\n\nexport interface RuntimeRicochet2DHandle {\n\tonRicochet(callback: (event: RuntimeRicochet2DEvent) => void): () => void;\n}\n\n/** Registers a gameplay2d trigger AABB (sensor); wasm reports overlap via {@link emitRuntimeTriggerRegionEnter}. */\nexport interface RuntimeTriggerRegion2DOptions {\n\ttriggerId: number;\n\thalfExtents: readonly [number, number];\n}\n\nexport interface RuntimeTriggerRegion2DEvent {\n\ttriggerId: number;\n}\n\nexport interface RuntimeTriggerRegion2DHandle {\n\tonRegionEnter(callback: (event: RuntimeTriggerRegion2DEvent) => void): () => void;\n}\n\nexport interface RuntimeGoalZone2DOptions {\n\tscorer: 'p1' | 'p2';\n}\n\nexport interface RuntimeGoalZone2DEvent {\n\tscorer: 'p1' | 'p2';\n}\n\nexport interface RuntimeGoalZone2DHandle {\n\tonGoal(callback: (event: RuntimeGoalZone2DEvent) => void): () => void;\n}\n\nconst runtimeNoopSystemFactory = (): BehaviorSystem => ({\n\tupdate(_ecs: unknown, _delta: number) {},\n});\n\nexport const RUNTIME_PONG_BALL_BEHAVIOR_KEY = Symbol.for('zylem:behavior:runtime-pong-ball');\nexport const RUNTIME_PADDLE_INPUT_2D_BEHAVIOR_KEY = Symbol.for('zylem:behavior:runtime-paddle-input-2d');\nexport const RUNTIME_WORLD_BOUNDARY_2D_BEHAVIOR_KEY = Symbol.for('zylem:behavior:runtime-world-boundary-2d');\nexport const RUNTIME_RICOCHET_2D_BEHAVIOR_KEY = Symbol.for('zylem:behavior:runtime-ricochet-2d');\nexport const RUNTIME_TRIGGER_REGION_2D_BEHAVIOR_KEY = Symbol.for('zylem:behavior:runtime-trigger-region-2d');\nexport const RUNTIME_GOAL_ZONE_2D_BEHAVIOR_KEY = Symbol.for('zylem:behavior:runtime-goal-zone-2d');\n\nconst RICOCHET_LISTENERS = Symbol('runtime-ricochet-listeners');\nconst TRIGGER_REGION_LISTENERS = Symbol('runtime-trigger-region-listeners');\nconst GOAL_LISTENERS = Symbol('runtime-goal-listeners');\nconst RUNTIME_BALL_SET_POSITION = Symbol('runtime-ball-set-position');\nconst RUNTIME_BALL_SET_VELOCITY = Symbol('runtime-ball-set-velocity');\nconst RUNTIME_BALL_GET_POSITION = Symbol('runtime-ball-get-position');\n\nexport const RuntimePongBallBehavior = defineBehavior<\n\tRuntimePongBallOptions,\n\tRuntimePongBallHandle\n>({\n\tname: 'runtime-pong-ball',\n\tdefaultOptions: {\n\t\tinitialVelocity: [0, 0] as [number, number],\n\t},\n\tsystemFactory: runtimeNoopSystemFactory,\n\tcreateHandle: (ref: BehaviorRef<RuntimePongBallOptions>) => ({\n\t\tsetRuntimePosition(x: number, y: number, z: number = 0): void {\n\t\t\tconst callback = (ref as any)[RUNTIME_BALL_SET_POSITION] as\n\t\t\t\t| ((x: number, y: number, z: number) => void)\n\t\t\t\t| undefined;\n\t\t\tcallback?.(x, y, z);\n\t\t},\n\t\tsetRuntimeVelocity(x: number, y: number): void {\n\t\t\tconst callback = (ref as any)[RUNTIME_BALL_SET_VELOCITY] as\n\t\t\t\t| ((x: number, y: number) => void)\n\t\t\t\t| undefined;\n\t\t\tcallback?.(x, y);\n\t\t},\n\t\tgetRuntimePosition(): { x: number; y: number; z: number } | null {\n\t\t\tconst callback = (ref as any)[RUNTIME_BALL_GET_POSITION] as\n\t\t\t\t| (() => { x: number; y: number; z: number } | null)\n\t\t\t\t| undefined;\n\t\t\treturn callback?.() ?? null;\n\t\t},\n\t}),\n});\n\nexport const RuntimePaddleInput2DBehavior = defineBehavior<RuntimePaddleInput2DOptions>({\n\tname: 'runtime-paddle-input-2d',\n\tdefaultOptions: {\n\t\tplayer: 'p1',\n\t\tspeed: 5,\n\t} as RuntimePaddleInput2DOptions,\n\tsystemFactory: runtimeNoopSystemFactory,\n});\n\nexport const RuntimeWorldBoundary2DBehavior = defineBehavior({\n\tname: 'runtime-world-boundary-2d',\n\tdefaultOptions: {\n\t\tboundaries: {\n\t\t\tleft: 0,\n\t\t\tright: 0,\n\t\t\tbottom: 0,\n\t\t\ttop: 0,\n\t\t},\n\t},\n\tsystemFactory: runtimeNoopSystemFactory,\n});\n\nexport const RuntimeRicochet2DBehavior = defineBehavior<\n\tRuntimeRicochet2DOptions,\n\tRuntimeRicochet2DHandle\n>({\n\tname: 'runtime-ricochet-2d',\n\tdefaultOptions: {\n\t\tminSpeed: 2,\n\t\tmaxSpeed: 20,\n\t\tspeedMultiplier: 1.05,\n\t\treflectionMode: 'angled' as const,\n\t\tmaxAngleDeg: 60,\n\t},\n\tsystemFactory: runtimeNoopSystemFactory,\n\tcreateHandle: (ref: BehaviorRef<RuntimeRicochet2DOptions>) => ({\n\t\tonRicochet(callback: (event: RuntimeRicochet2DEvent) => void): () => void {\n\t\t\tconst listeners =\n\t\t\t\t((ref as any)[RICOCHET_LISTENERS] as Array<(event: RuntimeRicochet2DEvent) => void> | undefined)\n\t\t\t\t?? [];\n\t\t\tif (!(ref as any)[RICOCHET_LISTENERS]) {\n\t\t\t\t(ref as any)[RICOCHET_LISTENERS] = listeners;\n\t\t\t}\n\t\t\tlisteners.push(callback);\n\t\t\treturn () => {\n\t\t\t\tconst index = listeners.indexOf(callback);\n\t\t\t\tif (index >= 0) {\n\t\t\t\t\tlisteners.splice(index, 1);\n\t\t\t\t}\n\t\t\t};\n\t\t},\n\t}),\n});\n\nexport const RuntimeTriggerRegion2DBehavior = defineBehavior<\n\tRuntimeTriggerRegion2DOptions,\n\tRuntimeTriggerRegion2DHandle\n>({\n\tname: 'runtime-trigger-region-2d',\n\tdefaultOptions: {\n\t\ttriggerId: 0,\n\t\thalfExtents: [0.5, 2.5] as [number, number],\n\t},\n\tsystemFactory: runtimeNoopSystemFactory,\n\tcreateHandle: (ref: BehaviorRef<RuntimeTriggerRegion2DOptions>) => ({\n\t\tonRegionEnter(callback: (event: RuntimeTriggerRegion2DEvent) => void): () => void {\n\t\t\tconst listeners =\n\t\t\t\t((ref as any)[TRIGGER_REGION_LISTENERS] as\n\t\t\t\t\t| Array<(event: RuntimeTriggerRegion2DEvent) => void>\n\t\t\t\t\t| undefined) ?? [];\n\t\t\tif (!(ref as any)[TRIGGER_REGION_LISTENERS]) {\n\t\t\t\t(ref as any)[TRIGGER_REGION_LISTENERS] = listeners;\n\t\t\t}\n\t\t\tlisteners.push(callback);\n\t\t\treturn () => {\n\t\t\t\tconst index = listeners.indexOf(callback);\n\t\t\t\tif (index >= 0) {\n\t\t\t\t\tlisteners.splice(index, 1);\n\t\t\t\t}\n\t\t\t};\n\t\t},\n\t}),\n});\n\nexport const RuntimeGoalZone2DBehavior = defineBehavior<\n\tRuntimeGoalZone2DOptions,\n\tRuntimeGoalZone2DHandle\n>({\n\tname: 'runtime-goal-zone-2d',\n\tdefaultOptions: {\n\t\tscorer: 'p1',\n\t} as RuntimeGoalZone2DOptions,\n\tsystemFactory: runtimeNoopSystemFactory,\n\tcreateHandle: (ref: BehaviorRef<RuntimeGoalZone2DOptions>) => ({\n\t\tonGoal(callback: (event: RuntimeGoalZone2DEvent) => void): () => void {\n\t\t\tconst listeners =\n\t\t\t\t((ref as any)[GOAL_LISTENERS] as Array<(event: RuntimeGoalZone2DEvent) => void> | undefined)\n\t\t\t\t?? [];\n\t\t\tif (!(ref as any)[GOAL_LISTENERS]) {\n\t\t\t\t(ref as any)[GOAL_LISTENERS] = listeners;\n\t\t\t}\n\t\t\tlisteners.push(callback);\n\t\t\treturn () => {\n\t\t\t\tconst index = listeners.indexOf(callback);\n\t\t\t\tif (index >= 0) {\n\t\t\t\t\tlisteners.splice(index, 1);\n\t\t\t\t}\n\t\t\t};\n\t\t},\n\t}),\n});\n\nexport function emitRuntimeRicochet(\n\tref: BehaviorRef<RuntimeRicochet2DOptions>,\n\tevent: RuntimeRicochet2DEvent,\n): void {\n\tconst listeners = (ref as any)[RICOCHET_LISTENERS] as\n\t\t| Array<(event: RuntimeRicochet2DEvent) => void>\n\t\t| undefined;\n\tfor (const listener of listeners ?? []) {\n\t\tlistener(event);\n\t}\n}\n\nexport function emitRuntimeTriggerRegionEnter(\n\tref: BehaviorRef<RuntimeTriggerRegion2DOptions>,\n\tevent: RuntimeTriggerRegion2DEvent,\n): void {\n\tconst listeners = (ref as any)[TRIGGER_REGION_LISTENERS] as\n\t\t| Array<(event: RuntimeTriggerRegion2DEvent) => void>\n\t\t| undefined;\n\tfor (const listener of listeners ?? []) {\n\t\tlistener(event);\n\t}\n}\n\nexport function emitRuntimeGoal(\n\tref: BehaviorRef<RuntimeGoalZone2DOptions>,\n\tevent: RuntimeGoalZone2DEvent,\n): void {\n\tconst listeners = (ref as any)[GOAL_LISTENERS] as\n\t\t| Array<(event: RuntimeGoalZone2DEvent) => void>\n\t\t| undefined;\n\tfor (const listener of listeners ?? []) {\n\t\tlistener(event);\n\t}\n}\n\nexport function bindRuntimePongBallHandle(\n\tref: BehaviorRef<RuntimePongBallOptions>,\n\tcontrols: {\n\t\tsetPosition: (x: number, y: number, z: number) => void;\n\t\tsetVelocity: (x: number, y: number) => void;\n\t\tgetPosition: () => { x: number; y: number; z: number } | null;\n\t},\n): void {\n\t(ref as any)[RUNTIME_BALL_SET_POSITION] = controls.setPosition;\n\t(ref as any)[RUNTIME_BALL_SET_VELOCITY] = controls.setVelocity;\n\t(ref as any)[RUNTIME_BALL_GET_POSITION] = controls.getPosition;\n}\n"],"mappings":"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","names":[]}