npm - @zylem/game-lib - Versions diffs - 0.3.14 - Mend

@zylem/game-lib 0.3.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (123) hide show

package/LICENSE +21 -0
package/README.md +65 -0
package/dist/.vite/manifest.json +8 -0
package/dist/assets/bounce.wav +0 -0
package/dist/assets/coin-sound.mp3 +0 -0
package/dist/assets/zylem-logo.png +0 -0
package/dist/lib/actions/behaviors/actions.d.ts +10 -0
package/dist/lib/actions/behaviors/behavior.d.ts +5 -0
package/dist/lib/actions/behaviors/boundaries/boundary.d.ts +36 -0
package/dist/lib/actions/behaviors/character-controller.d.ts +5 -0
package/dist/lib/actions/behaviors/debug/debug-collision.d.ts +5 -0
package/dist/lib/actions/behaviors/debug/debug-update.d.ts +4 -0
package/dist/lib/actions/behaviors/debug/debug.d.ts +9 -0
package/dist/lib/actions/behaviors/index.d.ts +1 -0
package/dist/lib/actions/behaviors/movement/movement-sequence-2d.d.ts +23 -0
package/dist/lib/actions/behaviors/ricochet/ricochet-2d-collision.d.ts +10 -0
package/dist/lib/actions/behaviors/ricochet/ricochet-2d-in-bounds.d.ts +11 -0
package/dist/lib/actions/behaviors/ricochet/ricochet.d.ts +41 -0
package/dist/lib/actions/behaviors/zylem-behavior.d.ts +1 -0
package/dist/lib/actions/capabilities/moveable.d.ts +124 -0
package/dist/lib/actions/capabilities/rotatable.d.ts +110 -0
package/dist/lib/actions/capabilities/transformable.d.ts +6 -0
package/dist/lib/actions/global-change.d.ts +12 -0
package/dist/lib/camera/camera.d.ts +15 -0
package/dist/lib/camera/fixed-2d.d.ts +31 -0
package/dist/lib/camera/perspective.d.ts +8 -0
package/dist/lib/camera/third-person.d.ts +39 -0
package/dist/lib/camera/zylem-camera.d.ts +68 -0
package/dist/lib/collision/collision-builder.d.ts +23 -0
package/dist/lib/collision/collision-delegate.d.ts +11 -0
package/dist/lib/collision/collision-group.d.ts +27 -0
package/dist/lib/collision/collision-mask.d.ts +17 -0
package/dist/lib/collision/collision.d.ts +27 -0
package/dist/lib/collision/physics.d.ts +4 -0
package/dist/lib/collision/utils.d.ts +14 -0
package/dist/lib/collision/world.d.ts +22 -0
package/dist/lib/core/asset-manager.d.ts +1 -0
package/dist/lib/core/base-node-life-cycle.d.ts +53 -0
package/dist/lib/core/base-node.d.ts +32 -0
package/dist/lib/core/entity-asset-loader.d.ts +29 -0
package/dist/lib/core/errors.d.ts +4 -0
package/dist/lib/core/flags.d.ts +2 -0
package/dist/lib/core/game-canvas.d.ts +4 -0
package/dist/lib/core/index.d.ts +4 -0
package/dist/lib/core/lazy-loader.d.ts +81 -0
package/dist/lib/core/lifecycle-base.d.ts +16 -0
package/dist/lib/core/preset-shader.d.ts +10 -0
package/dist/lib/core/three-addons/Timer.d.ts +106 -0
package/dist/lib/core/utility.d.ts +15 -0
package/dist/lib/core/vector.d.ts +3 -0
package/dist/lib/core/vessel.d.ts +11 -0
package/dist/lib/debug/console/console-state.d.ts +19 -0
package/dist/lib/debug/console/console-store.d.ts +5 -0
package/dist/lib/debug/debug-state.d.ts +43 -0
package/dist/lib/debug/debug-store.d.ts +14 -0
package/dist/lib/debug/state-based-debug-loader.d.ts +7 -0
package/dist/lib/device/desktop.d.ts +1 -0
package/dist/lib/device/mobile.d.ts +1 -0
package/dist/lib/device/tablet.d.ts +1 -0
package/dist/lib/entities/actor.d.ts +57 -0
package/dist/lib/entities/box.d.ts +26 -0
package/dist/lib/entities/builder.d.ts +27 -0
package/dist/lib/entities/create.d.ts +14 -0
package/dist/lib/entities/delegates/animation.d.ts +32 -0
package/dist/lib/entities/delegates/debug.d.ts +37 -0
package/dist/lib/entities/delegates/loader.d.ts +11 -0
package/dist/lib/entities/destroy.d.ts +3 -0
package/dist/lib/entities/entity.d.ts +100 -0
package/dist/lib/entities/index.d.ts +11 -0
package/dist/lib/entities/object.d.ts +1 -0
package/dist/lib/entities/plane.d.ts +35 -0
package/dist/lib/entities/rect.d.ts +62 -0
package/dist/lib/entities/sphere.d.ts +28 -0
package/dist/lib/entities/sprite.d.ts +52 -0
package/dist/lib/entities/text.d.ts +41 -0
package/dist/lib/entities/zone.d.ts +53 -0
package/dist/lib/game/game-interfaces.d.ts +28 -0
package/dist/lib/game/game-state.d.ts +10 -0
package/dist/lib/game/game.d.ts +41 -0
package/dist/lib/game/zylem-game.d.ts +44 -0
package/dist/lib/graphics/geometries/XZPlaneGeometry.d.ts +7 -0
package/dist/lib/graphics/material.d.ts +28 -0
package/dist/lib/graphics/mesh.d.ts +18 -0
package/dist/lib/graphics/render-pass.d.ts +16 -0
package/dist/lib/graphics/zylem-scene.d.ts +49 -0
package/dist/lib/input/gamepad-provider.d.ts +13 -0
package/dist/lib/input/input-manager.d.ts +14 -0
package/dist/lib/input/input-provider.d.ts +6 -0
package/dist/lib/input/input.d.ts +51 -0
package/dist/lib/input/keyboard-provider.d.ts +20 -0
package/dist/lib/interfaces/entity.d.ts +31 -0
package/dist/lib/interfaces/game.d.ts +19 -0
package/dist/lib/sounds/index.d.ts +2 -0
package/dist/lib/sounds/ping-pong-sound.d.ts +4 -0
package/dist/lib/sounds/ricochet-sound.d.ts +4 -0
package/dist/lib/stage/debug-entity-cursor.d.ts +23 -0
package/dist/lib/stage/entity-spawner.d.ts +8 -0
package/dist/lib/stage/stage-debug-delegate.d.ts +25 -0
package/dist/lib/stage/stage-state.d.ts +12 -0
package/dist/lib/stage/stage.d.ts +33 -0
package/dist/lib/stage/zylem-stage.d.ts +127 -0
package/dist/lib/systems/test-system.d.ts +1 -0
package/dist/lib/systems/transformable.system.d.ts +24 -0
package/dist/lib/types/entity-types.d.ts +38 -0
package/dist/lib/types/index.d.ts +2 -0
package/dist/lib/types/stage-types.d.ts +34 -0
package/dist/lib/ui/Debug.d.ts +1 -0
package/dist/lib/ui/console/Console.d.ts +6 -0
package/dist/lib/ui/debug-panel/AccordionMenu.d.ts +6 -0
package/dist/lib/ui/debug-panel/Menu.d.ts +5 -0
package/dist/lib/ui/debug-panel/sections/EntitiesSection.d.ts +11 -0
package/dist/lib/ui/debug-panel/sections/GameSection.d.ts +2 -0
package/dist/lib/ui/debug-panel/sections/StagesSection.d.ts +2 -0
package/dist/lib/ui/debug-panel/sections/all.d.ts +3 -0
package/dist/lib/ui/toolbar/Toolbar.d.ts +5 -0
package/dist/main.cjs +3980 -0
package/dist/main.d.ts +40 -0
package/dist/main.js +35583 -0
package/dist/tests/collision/collision.spec.d.ts +1 -0
package/dist/tests/core/game.spec.d.ts +1 -0
package/dist/tests/core/stage.spec.d.ts +1 -0
package/dist/tests/core/vessel.spec.d.ts +1 -0
package/package.json +127 -0

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2023 Timothy Cool
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,65 @@
+# Zylem
+A powerful and easy-to-use framework for creating simple 3D digital interactive applications using TypeScript.
+>Note: This project is still in alpha. There are unfinished features and some APIs that may change.
+## Installation
+```bash
+pnpm install
+```
+```bash
+npm run dev
+```
+## Examples
+>Note: The examples are not up to date with the latest version of Zylem.
+[Check out the examples repo here](https://github.com/tcool86/zylem-examples/tree/master)
+## Basic Usage
+[Basic usage repo here](https://github.com/tcool86/zylem-basic)
+```html
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Zylem - Basic Usage</title>
+  <link rel="stylesheet" href="./index.css" />
+ </head>
+ <body>
+  <script src="./src/index.ts" type="module"></script>
+ </body>
+</html>
+```
+```typescript
+import { game, sphere, makeMoveable } from '@tcool86/zylem';
+const ball = await sphere();
+makeMoveable(ball).onUpdate(({ entity, inputs }) => {
+  const { Horizontal, Vertical } = inputs.p1.axes;
+  entity.moveXY(Horizontal.value * 5, -Vertical.value * 5);
+});
+game(ball).start();
+```
+## Repository Governance
+### Conventional commits
+- `feat`: A new feature
+- `fix`: A bug fix
+- `docs`: Documentation only changes
+- `style`: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
+- `refactor`: A code change that neither fixes a bug nor adds a feature
+- `cleanup`: Removal of dead code, unused functionality, or code changes involving renaming
+- `perf`: A code change that improves performance
+- `test`: Adding missing or correcting existing tests
+- `build`: Changes that affect the build system or external dependencies (example scopes: vite, npm, typescript, etc)

package/dist/.vite/manifest.json ADDED Viewed

@@ -0,0 +1,8 @@
+{
+  "src/main.ts": {
+    "file": "main.cjs",
+    "name": "main",
+    "src": "src/main.ts",
+    "isEntry": true
+  }
+}

package/dist/assets/bounce.wav ADDED Viewed

Binary file

package/dist/assets/coin-sound.mp3 ADDED Viewed

Binary file

package/dist/assets/zylem-logo.png ADDED Viewed

Binary file

package/dist/lib/actions/behaviors/actions.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+export declare function wait(delay: number, callback: Function): void;
+export declare const actionOnPress: (isPressed: boolean, callback: Function) => void;
+export declare const actionOnRelease: (isPressed: boolean, callback: Function) => void;
+type CooldownOptions = {
+    timer: number;
+    immediate?: boolean;
+};
+export declare const actionWithCooldown: ({ timer, immediate }: CooldownOptions, callback: Function, update: Function) => void;
+export declare const actionWithThrottle: (timer: number, callback: Function) => void;
+export {};

package/dist/lib/actions/behaviors/behavior.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import { IComponent } from 'bitecs';
+export interface Behavior {
+    component: IComponent;
+    values: any;
+}

package/dist/lib/actions/behaviors/boundaries/boundary.d.ts ADDED Viewed

@@ -0,0 +1,36 @@
+import { UpdateContext } from "../../../core/base-node-life-cycle";
+import { MoveableEntity } from "../../capabilities/moveable";
+import { Vector } from "@dimforge/rapier3d-compat";
+import { BehaviorCallbackType } from "../../../entities/entity";
+export interface BoundaryEvent {
+    me: MoveableEntity;
+    boundary: BoundaryHits;
+    position: Vector;
+    updateContext: UpdateContext<MoveableEntity>;
+}
+export interface BoundaryOptions {
+    boundaries: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    };
+    onBoundary?: (event: BoundaryEvent) => void;
+    stopMovement?: boolean;
+}
+/**
+ * Checks if the entity has hit a boundary and stops its movement if it has
+ *
+ * @param options Configuration options for the boundary behavior
+ * @param options.boundaries The boundaries of the stage
+ * @param options.onBoundary A callback function that is called when the entity hits a boundary
+ * @param options.stopMovement Whether to stop the entity's movement when it hits a boundary
+ * @returns A behavior callback with type 'update' and a handler function
+ */
+export declare function boundary(options?: Partial<BoundaryOptions>): {
+    type: BehaviorCallbackType;
+    handler: (ctx: UpdateContext<MoveableEntity>) => void;
+};
+type BoundaryHit = 'top' | 'bottom' | 'left' | 'right';
+type BoundaryHits = Record<BoundaryHit, boolean>;
+export {};

package/dist/lib/actions/behaviors/character-controller.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export declare class ZylemCharacterController {
+    inputs: any;
+    constructor(inputs: any);
+}
+export declare function CharacterController(inputs: any): ZylemCharacterController;

package/dist/lib/actions/behaviors/debug/debug-collision.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import { DebugBehaviorOptions } from "~/lib/actions/behaviors/debug/debug";
+import { BaseNode } from "~/lib/core/base-node";
+import { CollisionContext } from "~/lib/entities/entity";
+export type DebugBehaviorCollisionCallback = (ctx: CollisionContext<BaseNode, BaseNode<any>>) => void;
+export declare function debugBehaviorCollision(options?: Partial<DebugBehaviorOptions>, ...callbacks: DebugBehaviorCollisionCallback[]): (collisionContext: CollisionContext<any, any>) => void;

package/dist/lib/actions/behaviors/debug/debug-update.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import { BaseNode } from "~/lib/core/base-node";
+import { UpdateContext } from "~/lib/core/base-node-life-cycle";
+import { DebugBehaviorOptions } from "~/lib/actions/behaviors/debug/debug";
+export declare function debugUpdateBehavior(options?: Partial<DebugBehaviorOptions>): (updateContext: UpdateContext<BaseNode>) => void;

package/dist/lib/actions/behaviors/debug/debug.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import { BaseNode } from "../../../core/base-node";
+import { BehaviorCallback } from "../../../entities/entity";
+export interface DebugBehaviorOptions {
+    message: string;
+}
+export declare function debugBehavior(options?: Partial<DebugBehaviorOptions>): {
+    type: 'update';
+    handler: BehaviorCallback<BaseNode, any>;
+};

package/dist/lib/actions/behaviors/index.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from './ricochet/ricochet';

package/dist/lib/actions/behaviors/movement/movement-sequence-2d.d.ts ADDED Viewed

@@ -0,0 +1,23 @@
+import { UpdateContext } from "../../../core/base-node-life-cycle";
+import { MoveableEntity } from "../../capabilities/moveable";
+import { BehaviorCallbackType } from "../../../entities/entity";
+export interface MovementSequence2DStep {
+    name: string;
+    moveX?: number;
+    moveY?: number;
+    timeInSeconds: number;
+}
+export interface MovementSequence2DOptions {
+    sequence: MovementSequence2DStep[];
+    loop?: boolean;
+}
+export type MovementSequence2DCallback = (current: MovementSequence2DStep, index: number, ctx: UpdateContext<MoveableEntity>) => void;
+/**
+ * Behavior that sequences 2D movements over time.
+ * Each step sets linear velocity via `moveXY` for a duration, then advances.
+ * Defaults to looping when the end is reached.
+ */
+export declare function movementSequence2D(opts: MovementSequence2DOptions, onStep?: MovementSequence2DCallback): {
+    type: BehaviorCallbackType;
+    handler: (ctx: UpdateContext<MoveableEntity>) => void;
+};

package/dist/lib/actions/behaviors/ricochet/ricochet-2d-collision.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+import { CollisionContext, GameEntity } from '../../../entities/entity';
+import { MoveableEntity } from '../../capabilities/moveable';
+import { Ricochet2DCollisionOptions, Ricochet2DCollisionCallback } from './ricochet';
+/**
+ * Behavior for ricocheting an entity off other objects in 2D
+ */
+export declare function ricochet2DCollision(options?: Partial<Ricochet2DCollisionOptions>, callback?: Ricochet2DCollisionCallback): {
+    type: 'collision';
+    handler: (ctx: CollisionContext<MoveableEntity, GameEntity<any>>) => void;
+};

package/dist/lib/actions/behaviors/ricochet/ricochet-2d-in-bounds.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import { UpdateContext } from '../../../core/base-node-life-cycle';
+import { MoveableEntity } from '../../capabilities/moveable';
+import { Ricochet2DInBoundsOptions, Ricochet2DCallback } from './ricochet';
+import { BehaviorCallbackType } from '../../../entities/entity';
+/**
+ * Behavior for ricocheting an entity within fixed 2D boundaries
+ */
+export declare function ricochet2DInBounds(options?: Partial<Ricochet2DInBoundsOptions>, callback?: Ricochet2DCallback): {
+    type: BehaviorCallbackType;
+    handler: (ctx: UpdateContext<MoveableEntity>) => void;
+};

package/dist/lib/actions/behaviors/ricochet/ricochet.d.ts ADDED Viewed

@@ -0,0 +1,41 @@
+import { Vector } from '@dimforge/rapier3d-compat';
+import { MoveableEntity } from '../../capabilities/moveable';
+import { CollisionContext, GameEntity } from '../../../entities/entity';
+import { UpdateContext } from '../../../core/base-node-life-cycle';
+import { CollisionSelector } from '../../../collision/utils';
+export interface RicochetEvent extends Partial<UpdateContext<MoveableEntity>> {
+    boundary?: 'top' | 'bottom' | 'left' | 'right';
+    position: Vector;
+    velocityBefore: Vector;
+    velocityAfter: Vector;
+}
+export interface RicochetCollisionEvent extends CollisionContext<MoveableEntity, GameEntity<any>> {
+    position: Vector;
+}
+export interface Ricochet2DInBoundsOptions {
+    restitution?: number;
+    minSpeed?: number;
+    maxSpeed?: number;
+    boundaries: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    };
+    separation?: number;
+}
+export interface Ricochet2DCollisionOptions {
+    restitution?: number;
+    minSpeed?: number;
+    maxSpeed?: number;
+    separation?: number;
+    collisionWith?: CollisionSelector;
+    /**
+     * Choose between simple axis inversion or angled (paddle-style) reflection.
+     * Defaults to 'angled'.
+     */
+    reflectionMode?: 'simple' | 'angled';
+}
+export type Ricochet2DCallback = (event: RicochetEvent) => void;
+export type Ricochet2DCollisionCallback = (event: RicochetCollisionEvent) => void;
+export declare function clamp(value: number, min: number, max: number): number;

package/dist/lib/actions/behaviors/zylem-behavior.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/dist/lib/actions/capabilities/moveable.d.ts ADDED Viewed

@@ -0,0 +1,124 @@
+import { Vector3 } from 'three';
+import { RigidBody, Vector } from '@dimforge/rapier3d-compat';
+export interface EntityWithBody {
+    body: RigidBody | null;
+}
+/**
+ * Move an entity along the X axis, preserving other velocities
+ */
+export declare function moveX(entity: EntityWithBody, delta: number): void;
+/**
+ * Move an entity along the Y axis, preserving other velocities
+ */
+export declare function moveY(entity: EntityWithBody, delta: number): void;
+/**
+ * Move an entity along the Z axis, preserving other velocities
+ */
+export declare function moveZ(entity: EntityWithBody, delta: number): void;
+/**
+ * Move an entity along the X and Y axis, preserving Z velocity
+ */
+export declare function moveXY(entity: EntityWithBody, deltaX: number, deltaY: number): void;
+/**
+ * Move an entity along the X and Z axis, preserving Y velocity
+ */
+export declare function moveXZ(entity: EntityWithBody, deltaX: number, deltaZ: number): void;
+/**
+ * Move entity based on a vector, adding to existing velocities
+ */
+export declare function move(entity: EntityWithBody, vector: Vector3): void;
+/**
+ * Reset entity velocity
+ */
+export declare function resetVelocity(entity: EntityWithBody): void;
+/**
+ * Move entity forward in 2D space, preserving Z velocity
+ */
+export declare function moveForwardXY(entity: EntityWithBody, delta: number, rotation2DAngle: number): void;
+/**
+ * Get entity position
+ */
+export declare function getPosition(entity: EntityWithBody): Vector | null;
+/**
+ * Get entity velocity
+ */
+export declare function getVelocity(entity: EntityWithBody): Vector | null;
+/**
+ * Set entity position
+ */
+export declare function setPosition(entity: EntityWithBody, x: number, y: number, z: number): void;
+/**
+ * Set entity X position
+ */
+export declare function setPositionX(entity: EntityWithBody, x: number): void;
+/**
+ * Set entity Y position
+ */
+export declare function setPositionY(entity: EntityWithBody, y: number): void;
+/**
+ * Set entity Z position
+ */
+export declare function setPositionZ(entity: EntityWithBody, z: number): void;
+/**
+ * Wrap entity around 2D bounds
+ */
+export declare function wrapAroundXY(entity: EntityWithBody, boundsX: number, boundsY: number): void;
+/**
+ * Wrap entity around 3D bounds
+ */
+export declare function wrapAround3D(entity: EntityWithBody, boundsX: number, boundsY: number, boundsZ: number): void;
+/**
+ * Enhanced moveable entity with bound methods
+ */
+export interface MoveableEntity extends EntityWithBody {
+    moveX(delta: number): void;
+    moveY(delta: number): void;
+    moveZ(delta: number): void;
+    moveXY(deltaX: number, deltaY: number): void;
+    moveXZ(deltaX: number, deltaZ: number): void;
+    move(vector: Vector3): void;
+    resetVelocity(): void;
+    moveForwardXY(delta: number, rotation2DAngle: number): void;
+    getPosition(): Vector | null;
+    getVelocity(): Vector | null;
+    setPosition(x: number, y: number, z: number): void;
+    setPositionX(x: number): void;
+    setPositionY(y: number): void;
+    setPositionZ(z: number): void;
+    wrapAroundXY(boundsX: number, boundsY: number): void;
+    wrapAround3D(boundsX: number, boundsY: number, boundsZ: number): void;
+}
+/**
+ * Class decorator to enhance an entity with additive movement methods
+ */
+export declare function moveable<T extends {
+    new (...args: any[]): EntityWithBody;
+}>(constructor: T): {
+    new (...args: any[]): {
+        moveX(delta: number): void;
+        moveY(delta: number): void;
+        moveZ(delta: number): void;
+        moveXY(deltaX: number, deltaY: number): void;
+        moveXZ(deltaX: number, deltaZ: number): void;
+        move(vector: Vector3): void;
+        resetVelocity(): void;
+        moveForwardXY(delta: number, rotation2DAngle: number): void;
+        getPosition(): Vector | null;
+        getVelocity(): Vector | null;
+        setPosition(x: number, y: number, z: number): void;
+        setPositionX(x: number): void;
+        setPositionY(y: number): void;
+        setPositionZ(z: number): void;
+        wrapAroundXY(boundsX: number, boundsY: number): void;
+        wrapAround3D(boundsX: number, boundsY: number, boundsZ: number): void;
+        body: RigidBody | null;
+    };
+} & T;
+/**
+ * Enhance an entity with additive movement methods (retained for compatibility)
+ */
+export declare function makeMoveable<T extends EntityWithBody>(entity: T): T & MoveableEntity;
+/**
+ * Wrap a standalone function with movement capabilities
+ */
+export declare function withMovement<T extends (...args: any[]) => any>(fn: T, entity: EntityWithBody): (...args: Parameters<T>) => ReturnType<T> & MoveableEntity;

package/dist/lib/actions/capabilities/rotatable.d.ts ADDED Viewed

@@ -0,0 +1,110 @@
+import { Vector3 } from 'three';
+import { RigidBody } from '@dimforge/rapier3d-compat';
+export interface RotatableEntity {
+    body: RigidBody | null;
+    group: any;
+}
+/**
+ * Rotate an entity in the direction of a movement vector
+ */
+export declare function rotateInDirection(entity: RotatableEntity, moveVector: Vector3): void;
+/**
+ * Rotate an entity around the Y axis using Euler angles
+ */
+export declare function rotateYEuler(entity: RotatableEntity, amount: number): void;
+/**
+ * Rotate an entity using Euler angles
+ */
+export declare function rotateEuler(entity: RotatableEntity, rotation: Vector3): void;
+/**
+ * Rotate an entity around the Y axis
+ */
+export declare function rotateY(entity: RotatableEntity, delta: number): void;
+/**
+ * Rotate an entity around the Z axis
+ */
+export declare function rotateZ(entity: RotatableEntity, delta: number): void;
+/**
+ * Set rotation around Y axis
+ */
+export declare function setRotationY(entity: RotatableEntity, y: number): void;
+/**
+ * Set rotation around Y axis
+ */
+export declare function setRotationDegreesY(entity: RotatableEntity, y: number): void;
+/**
+ * Set rotation around X axis
+ */
+export declare function setRotationX(entity: RotatableEntity, x: number): void;
+/**
+ * Set rotation around X axis
+ */
+export declare function setRotationDegreesX(entity: RotatableEntity, x: number): void;
+/**
+ * Set rotation around Z axis
+ */
+export declare function setRotationZ(entity: RotatableEntity, z: number): void;
+/**
+ * Set rotation around Z axis
+ */
+export declare function setRotationDegreesZ(entity: RotatableEntity, z: number): void;
+/**
+ * Set rotation for all axes
+ */
+export declare function setRotation(entity: RotatableEntity, x: number, y: number, z: number): void;
+/**
+ * Set rotation for all axes
+ */
+export declare function setRotationDegrees(entity: RotatableEntity, x: number, y: number, z: number): void;
+/**
+ * Get current rotation
+ */
+export declare function getRotation(entity: RotatableEntity): any;
+/**
+ * Rotatable entity API with bound methods
+ */
+export interface RotatableEntityAPI extends RotatableEntity {
+    rotateInDirection(moveVector: Vector3): void;
+    rotateYEuler(amount: number): void;
+    rotateEuler(rotation: Vector3): void;
+    rotateY(delta: number): void;
+    rotateZ(delta: number): void;
+    setRotationY(y: number): void;
+    setRotationX(x: number): void;
+    setRotationZ(z: number): void;
+    setRotationDegrees(x: number, y: number, z: number): void;
+    setRotationDegreesY(y: number): void;
+    setRotationDegreesX(x: number): void;
+    setRotationDegreesZ(z: number): void;
+    setRotation(x: number, y: number, z: number): void;
+    getRotation(): any;
+}
+/**
+ * Class decorator to enhance an entity with rotatable methods
+ */
+export declare function rotatable<T extends {
+    new (...args: any[]): RotatableEntity;
+}>(constructor: T): {
+    new (...args: any[]): {
+        rotateInDirection(moveVector: Vector3): void;
+        rotateYEuler(amount: number): void;
+        rotateEuler(rotation: Vector3): void;
+        rotateY(delta: number): void;
+        rotateZ(delta: number): void;
+        setRotationY(y: number): void;
+        setRotationX(x: number): void;
+        setRotationZ(z: number): void;
+        setRotationDegrees(x: number, y: number, z: number): void;
+        setRotationDegreesY(y: number): void;
+        setRotationDegreesX(x: number): void;
+        setRotationDegreesZ(z: number): void;
+        setRotation(x: number, y: number, z: number): void;
+        getRotation(): any;
+        body: RigidBody | null;
+        group: any;
+    };
+} & T;
+/**
+ * Enhance an entity instance with rotatable methods
+ */
+export declare function makeRotatable<T extends RotatableEntity>(entity: T): T & RotatableEntityAPI;

package/dist/lib/actions/capabilities/transformable.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+import { EntityWithBody, MoveableEntity } from './moveable';
+import { RotatableEntity, RotatableEntityAPI } from './rotatable';
+/**
+ * Enhance an entity with both movement and rotation capabilities.
+ */
+export declare function makeTransformable<T extends RotatableEntity & EntityWithBody>(entity: T): T & MoveableEntity & RotatableEntityAPI;

package/dist/lib/actions/global-change.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import { UpdateContext } from "../core/base-node-life-cycle";
+/**
+ * Listen for a single global key change inside an onUpdate pipeline.
+ * Usage: onUpdate(globalChange('p1Score', (value) => { ... }))
+ */
+export declare function globalChange<T = any>(key: string, callback: (value: T, ctx: UpdateContext<any>) => void): (ctx: UpdateContext<any>) => void;
+/**
+ * Listen for multiple global key changes inside an onUpdate pipeline.
+ * Calls back when any of the provided keys changes.
+ * Usage: onUpdate(globalChanges(['p1Score','p2Score'], ([p1,p2]) => { ... }))
+ */
+export declare function globalChanges<T = any>(keys: string[], callback: (values: T[], ctx: UpdateContext<any>) => void): (ctx: UpdateContext<any>) => void;

package/dist/lib/camera/camera.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import { Vector2, Vector3 } from "three";
+import { PerspectiveType } from "./perspective";
+import { ZylemCamera } from "./zylem-camera";
+export interface CameraOptions {
+    perspective?: PerspectiveType;
+    position?: Vector3;
+    target?: Vector3;
+    zoom?: number;
+    screenResolution?: Vector2;
+}
+export declare class CameraWrapper {
+    cameraRef: ZylemCamera;
+    constructor(camera: ZylemCamera);
+}
+export declare function camera(options: CameraOptions): CameraWrapper;

package/dist/lib/camera/fixed-2d.d.ts ADDED Viewed

@@ -0,0 +1,31 @@
+import { Scene, Vector2, WebGLRenderer } from 'three';
+import { PerspectiveController, ZylemCamera } from './zylem-camera';
+/**
+ * Fixed 2D Camera Controller
+ * Maintains a static 2D camera view with no automatic following or movement
+ */
+export declare class Fixed2DCamera implements PerspectiveController {
+    screenResolution: Vector2 | null;
+    renderer: WebGLRenderer | null;
+    scene: Scene | null;
+    cameraRef: ZylemCamera | null;
+    constructor();
+    /**
+     * Setup the fixed 2D camera controller
+     */
+    setup(params: {
+        screenResolution: Vector2;
+        renderer: WebGLRenderer;
+        scene: Scene;
+        camera: ZylemCamera;
+    }): void;
+    /**
+     * Update the fixed 2D camera
+     * Fixed cameras don't need to update position/rotation automatically
+     */
+    update(delta: number): void;
+    /**
+     * Handle resize events for 2D camera
+     */
+    resize(width: number, height: number): void;
+}

package/dist/lib/camera/perspective.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+export declare const Perspectives: {
+    readonly FirstPerson: "first-person";
+    readonly ThirdPerson: "third-person";
+    readonly Isometric: "isometric";
+    readonly Flat2D: "flat-2d";
+    readonly Fixed2D: "fixed-2d";
+};
+export type PerspectiveType = (typeof Perspectives)[keyof typeof Perspectives];

package/dist/lib/camera/third-person.d.ts ADDED Viewed

@@ -0,0 +1,39 @@
+import { Scene, Vector2, Vector3, WebGLRenderer } from 'three';
+import { PerspectiveController, ZylemCamera } from './zylem-camera';
+import { StageEntity } from '../interfaces/entity';
+export interface ThirdPersonCameraOptions {
+    target: StageEntity;
+    distance: Vector3;
+    screenResolution: Vector2;
+    renderer: WebGLRenderer;
+    scene: Scene;
+}
+export declare class ThirdPersonCamera implements PerspectiveController {
+    distance: Vector3;
+    screenResolution: Vector2 | null;
+    renderer: WebGLRenderer | null;
+    scene: Scene | null;
+    cameraRef: ZylemCamera | null;
+    constructor();
+    /**
+     * Setup the third person camera controller
+     */
+    setup(params: {
+        screenResolution: Vector2;
+        renderer: WebGLRenderer;
+        scene: Scene;
+        camera: ZylemCamera;
+    }): void;
+    /**
+     * Update the third person camera
+     */
+    update(delta: number): void;
+    /**
+     * Handle resize events
+     */
+    resize(width: number, height: number): void;
+    /**
+     * Set the distance from the target
+     */
+    setDistance(distance: Vector3): void;
+}