@zylem/game-lib 0.6.2 → 0.6.3

package/LICENSE

@@ -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

@@ -39,10 +39,15 @@ npm install @zylem/game-lib
  * the ball can be controlled with the arrow keys or gamepad
  * the ball cannot go outside the boundaries
  */
-import { boundary2d, createGame, makeMoveable, sphere } from '@zylem/game-lib';
+import { createGame, createSphere, WorldBoundary2DBehavior } from '@zylem/game-lib';
 
-// Creates a moveable sphere
-const ball = makeMoveable(await sphere());
+// Creates a sphere (movement capabilities are built-in)
+const ball = createSphere();
+
+// attach boundary behavior
+ball.use(WorldBoundary2DBehavior, {
+  boundaries: { top: 3, bottom: -3, left: -6, right: 6 },
+});
 
 // when the ball is updated, move it based on the inputs
 ball.onUpdate(({ me, inputs, delta }) => {
@@ -54,20 +59,8 @@ ball.onUpdate(({ me, inputs, delta }) => {
   me.moveXY(Horizontal.value * speed, -Vertical.value * speed);
 });
 
-// add a boundary behavior to the ball
-ball.addBehavior(
-  boundary2d({
-    boundaries: {
-      top: 3,
-      bottom: -3,
-      left: -6,
-      right: 6,
-    },
-  }),
-);
-
 // start the game with the ball
-createGame(ball).start();
+createGame(ball);
 ```
 
 ## Development

package/dist/actions.d.ts

@@ -1,25 +1,34 @@
-export { m as makeMoveable } from './moveable-B_vyA6cw.js';
-export { m as makeRotatable, a as makeTransformable } from './transformable-CUhvyuYO.js';
+import { T as TransformState } from './entity-BpbZqg19.js';
+export { A as Action, c as createTransformStore, i as getPosition, H as getRotation, j as getVelocity, m as move, h as moveForwardXY, a as moveX, e as moveXY, f as moveXZ, b as moveY, d as moveZ, r as resetTransformStore, g as resetVelocity, t as rotateEuler, p as rotateInDirection, u as rotateX, v as rotateY, q as rotateYEuler, x as rotateZ, s as setPosition, k as setPositionX, l as setPositionY, n as setPositionZ, G as setRotation, C as setRotationDegrees, E as setRotationDegreesX, D as setRotationDegreesY, F as setRotationDegreesZ, z as setRotationX, y as setRotationY, B as setRotationZ, o as wrapAround3D, w as wrapAroundXY } from './entity-BpbZqg19.js';
+export { c as callFunc, d as delay, m as moveBy, a as moveTo, o as onPress, b as onRelease, p as parallel, e as repeat, f as repeatForever, r as rotateBy, s as sequence, t as throttle } from './composition-DrzFrbqI.js';
+import { RigidBody } from '@dimforge/rapier3d-compat';
+export { g as globalChange, a as globalChanges, v as variableChange, b as variableChanges } from './global-change-Dc8uCKi2.js';
 import 'three';
-import '@dimforge/rapier3d-compat';
+import 'bitecs';
+import 'mitt';
+import './behavior-descriptor-BWNWmIjv.js';
 
-declare function wait(delay: number, callback: Function): void;
-declare const actionOnPress: (isPressed: boolean, callback: Function) => void;
-declare const actionOnRelease: (isPressed: boolean, callback: Function) => void;
-type CooldownOptions = {
-    timer: number;
-    immediate?: boolean;
-};
-declare const actionWithCooldown: ({ timer, immediate }: CooldownOptions, callback: Function, update: Function) => void;
-declare const actionWithThrottle: (timer: number, callback: Function) => void;
-
-declare const actions_actionOnPress: typeof actionOnPress;
-declare const actions_actionOnRelease: typeof actionOnRelease;
-declare const actions_actionWithCooldown: typeof actionWithCooldown;
-declare const actions_actionWithThrottle: typeof actionWithThrottle;
-declare const actions_wait: typeof wait;
-declare namespace actions {
-  export { actions_actionOnPress as actionOnPress, actions_actionOnRelease as actionOnRelease, actions_actionWithCooldown as actionWithCooldown, actions_actionWithThrottle as actionWithThrottle, actions_wait as wait };
+/**
+ * Entity that can have transformations applied from a store
+ */
+interface TransformableEntity {
+    body: RigidBody | null;
+    transformStore?: TransformState;
 }
+/**
+ * Apply accumulated transformations from the store to the physics body.
+ *
+ * This is called automatically after onUpdate() callbacks complete,
+ * flushing all pending transformations to the physics engine in a single batch.
+ *
+ * Flow:
+ * 1. Check dirty flags to see what changed
+ * 2. Apply changes to RigidBody
+ * 3. Reset store for next frame
+ *
+ * @param entity Entity with physics body and transform store
+ * @param store Transform store containing pending changes
+ */
+declare function applyTransformChanges(entity: TransformableEntity, store: TransformState): void;
 
-export { actions };
+export { TransformState, applyTransformChanges };