littlejsengine 1.18.1 → 1.18.2

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm test *)"
+    ]
+  }
+}

package/.github/workflows/test.yml

@@ -0,0 +1,17 @@
+name: Test
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: '22'
+      - run: npm install
+      - run: npm run build
+      - run: npm test

package/AI.md

@@ -155,6 +155,16 @@ drawEllipse(pos, size, color)           // filled ellipse
 npm run build
 ```
 
+### Testing
+```bash
+npm test
+```
+
+- Tests target `dist/littlejs.esm.js` — rebuild with `npm run build` after changing source.
+- [test/setup.mjs](test/setup.mjs) stubs minimal DOM and enables headless mode. Tests shouldn't call `engineInit`, `render()`, or assume `time` advances.
+- Zero test dependencies — uses Node's built-in `node --test`. Match the style in [test/](test/) when adding new ones.
+- CI runs build + test on every push/PR ([.github/workflows/test.yml](.github/workflows/test.yml)).
+
 ### Debug features
 - Press `Esc` to toggle debug overlay
 - Number keys toggle visualizations

package/README.md

@@ -1,6 +1,6 @@
 # LittleJS - The Tiny Fast JavaScript Game Engine
 
-<div align='center'>
+<div align='center' markdown='1'>
     
 ![LittleJS Logo](examples/logo.png)
 
@@ -22,7 +22,7 @@ The code is very clean and well documented with many examples to get you started
 
 *The Third Annual LittleJS Game Jam will take place From Oct 2 to Nov 2! Unleash your creativity and develop amazing games using the LittleJS game engine. 🕹️🎮 [Sign up today and get more info about the jam on itch.io!](https://itch.io/jam/littlejs-jam)*
 
-<div align='center'>
+<div align='center' markdown='1'>
 
 ## [Demos](https://killedbyapixel.github.io/LittleJS/examples) | [Docs](https://killedbyapixel.github.io/LittleJS/docs) | [Trailer](https://youtu.be/chuBzGjv7Ms) | [Discord](https://discord.gg/zb7hcGkyZe) | [FAQ](https://github.com/KilledByAPixel/LittleJS/blob/main/FAQ.md)
 

package/dist/littlejs.d.ts

@@ -480,17 +480,21 @@ declare module "littlejsengine" {
     export let inputWASDEmulateDirection: boolean;
     /** True if touch gamepad should appear on mobile devices
      *  - Supports left analog stick, 4 face buttons and start button (button 9)
+     *  - setTouchGamepadButtonCount(1) to use face buttons as right analog stick
+     *  - Analog stick buttons 10 and 11 are also activated when virtual sticks are touched
+    
      *  @type {boolean}
      *  @default
      *  @memberof Settings */
     export let touchGamepadEnable: boolean;
     /** True if touch gamepad should have start button in the center
+     *  - Prevents activating if overlappng with virtual stick or buttons if they are enabled
      *  - When the game is paused, any touch will press the button
-     *  - This can function as a way to pause/unpause the game
-     *  @type {boolean}
+     *  - Set size to enable the center button
+     *  @type {number}
      *  @default
      *  @memberof Settings */
-    export let touchGamepadCenterButton: boolean;
+    export let touchGamepadCenterButtonSize: number;
     /** True if touch gamepad should be analog stick or false to use if 8 way dpad
      *  @type {boolean}
      *  @default
@@ -687,11 +691,12 @@ declare module "littlejsengine" {
      *  @param {boolean} enable
      *  @memberof Settings */
     export function setTouchGamepadEnable(enable: boolean): void;
-    /** True if touch gamepad should have start button in the center
-     *  - This can function as a way to pause/unpause the game
-     *  @param {boolean} enable
+    /** Set if touch gamepad should have start button in the center
+     *  - Set size to enable the center button
+     *  - When the game is paused, any touch will press the button
+     *  @param {number} size
      *  @memberof Settings */
-    export function setTouchGamepadCenterButton(enable: boolean): void;
+    export function setTouchGamepadCenterButtonSize(size: number): void;
     /** Set number of buttons on touch gamepad (0-4), if 1 also acts as right analog stick
      *  @param {number} count
      *  @memberof Settings */
@@ -893,6 +898,16 @@ declare module "littlejsengine" {
      *  @return {number}
      *  @memberof Math */
     export function lerp(valueA: number, valueB: number, percent: number): number;
+    /** Gets percent between percentA and percentB and linearly interpolates between lerpA and lerpB
+     *  A shortcut for lerp(lerpA, lerpB, percent(value, percentA, percentB))
+     *  @param {number} value
+     *  @param {number} percentA
+     *  @param {number} percentB
+     *  @param {number} lerpA
+     *  @param {number} lerpB
+     *  @return {number}
+     *  @memberof Math */
+    export function percentLerp(value: number, percentA: number, percentB: number, lerpA: number, lerpB: number): number;
     /** Applies smoothstep function to the percentage value
      *  @param {number} percent
      *  @return {number}
@@ -920,6 +935,20 @@ declare module "littlejsengine" {
      *  @return {boolean}      - True if intersecting
      *  @memberof Math */
     export function isIntersecting(start: Vector2, end: Vector2, pos: Vector2, size: Vector2): boolean;
+    /**
+     * @callback LineTestFunction - Checks if a position is colliding
+     * @param {Vector2} pos
+     * @memberof Draw
+     */
+    /**
+     * Casts a ray and returns position of the first collision found, or undefined if none are found
+     * @param {Vector2} posStart
+     * @param {Vector2} posEnd
+     * @param {LineTestFunction} testFunction - Check if colliding
+     * @param {Vector2} [normal] - Optional vector to store the normal
+     * @return {Vector2|undefined} - Position of the collision or undefined if none found
+     * @memberof Math */
+    export function lineTest(posStart: Vector2, posEnd: Vector2, testFunction: LineTestFunction, normal?: Vector2): Vector2 | undefined;
     /** Returns an oscillating wave between 0 and amplitude with frequency of 1 Hz by default
      *  @param {number} [frequency] - Frequency of the wave in Hz
      *  @param {number} [amplitude] - Amplitude (max height) of the wave

package/dist/littlejs.esm.js

@@ -35,7 +35,7 @@ const engineName = 'LittleJS';
  *  @type {string}
  *  @default
  *  @memberof Engine */
-const engineVersion = '1.18.1';
+const engineVersion = '1.18.2';
 
 /** Frames per second to update
  *  @type {number}
@@ -3003,18 +3003,22 @@ let touchInputEnable = true;
 
 /** True if touch gamepad should appear on mobile devices
  *  - Supports left analog stick, 4 face buttons and start button (button 9)
+ *  - setTouchGamepadButtonCount(1) to use face buttons as right analog stick
+ *  - Analog stick buttons 10 and 11 are also activated when virtual sticks are touched
+
  *  @type {boolean}
  *  @default
  *  @memberof Settings */
 let touchGamepadEnable = false;
 
 /** True if touch gamepad should have start button in the center
+ *  - Prevents activating if overlappng with virtual stick or buttons if they are enabled
  *  - When the game is paused, any touch will press the button
- *  - This can function as a way to pause/unpause the game
- *  @type {boolean}
+ *  - Set size to enable the center button
+ *  @type {number}
  *  @default
  *  @memberof Settings */
-let touchGamepadCenterButton = true;
+let touchGamepadCenterButtonSize = 300;
 
 /** Number of buttons on touch gamepad (0-4), if 1 also acts as right analog stick
  *  @type {number}
@@ -3032,7 +3036,7 @@ let touchGamepadAnalog = true;
  *  @type {number}
  *  @default
  *  @memberof Settings */
-let touchGamepadSize = 99;
+let touchGamepadSize = 100;
 
 /** Transparency of touch gamepad overlay
  *  @type {number}
@@ -3300,11 +3304,12 @@ function setTouchInputEnable(enable) { touchInputEnable = enable; }
  *  @memberof Settings */
 function setTouchGamepadEnable(enable) { touchGamepadEnable = enable; }
 
-/** True if touch gamepad should have start button in the center
- *  - This can function as a way to pause/unpause the game
- *  @param {boolean} enable
+/** Set if touch gamepad should have start button in the center
+ *  - Set size to enable the center button
+ *  - When the game is paused, any touch will press the button
+ *  @param {number} size
  *  @memberof Settings */
-function setTouchGamepadCenterButton(enable) { touchGamepadCenterButton = enable; }
+function setTouchGamepadCenterButtonSize(size) { touchGamepadCenterButtonSize = size; }
 
 /** Set number of buttons on touch gamepad (0-4), if 1 also acts as right analog stick
  *  @param {number} count
@@ -3842,6 +3847,7 @@ class EngineObject
         child.parent = this;
         child.localPos = localPos.copy();
         child.localAngle = localAngle;
+        child.updateTransforms();
         return child;
     }
 
@@ -5573,7 +5579,7 @@ function inputInit()
             if (touching)
             {
                 touchGamepadTimer.set();
-                if (touchGamepadCenterButton && !wasTouching && paused)
+                if (touchGamepadCenterButtonSize && !wasTouching && paused)
                 {
                     // touch anywhere to press start when paused
                     touchGamepadButtons[9] = 1;
@@ -5598,6 +5604,7 @@ function inputInit()
                     // virtual analog stick
                     const delta = touchPos.subtract(stickCenter);
                     touchGamepadSticks[0] = delta.scale(2/touchGamepadSize).clampLength();
+                    touchGamepadButtons[10] = 1; // also press a button when touching stick
                 }
                 else if (buttonCenter.distance(touchPos) < touchGamepadSize)
                 {
@@ -5606,6 +5613,7 @@ function inputInit()
                         // virtual right analog stick
                         const delta = touchPos.subtract(buttonCenter);
                         touchGamepadSticks[1] = delta.scale(2/touchGamepadSize).clampLength();
+                        touchGamepadButtons[11] = 1; // also press a button when touching right stick
                     }
                     // virtual face buttons
                     let button = buttonCenter.subtract(touchPos).direction();
@@ -5622,8 +5630,7 @@ function inputInit()
                     if (button < touchGamepadButtonCount)
                         touchGamepadButtons[button] = 1;
                 }
-                else if (touchGamepadCenterButton && 
-                    startCenter.distance(touchPos) < touchGamepadSize)
+                else if (startCenter.distance(touchPos) < touchGamepadCenterButtonSize)
                 {
                     // virtual start button in center
                     touchGamepadButtons[9] = 1;
@@ -5672,6 +5679,18 @@ function inputUpdate()
         // update touch gamepad if enabled
         if (touchGamepadEnable && isTouchDevice)
         {
+            if (debugGamepads)
+            {
+                const stickCenter = vec2(touchGamepadSize, mainCanvasSize.y-touchGamepadSize);
+                const buttonCenter = touchGamepadButtonCenter();
+                const startCenter = mainCanvasSize.scale(.5);
+
+                debugCircle(stickCenter, 2*touchGamepadSize, 'cyan', 0, false, true);
+                debugCircle(buttonCenter, 2*touchGamepadSize, 'cyan', 0, false, true);
+                if (touchGamepadCenterButtonSize)
+                    debugCircle(startCenter, 2*touchGamepadCenterButtonSize, 'cyan', 0, false, true);
+            }
+
             if (!touchGamepadTimer.isSet()) return;
 
             // read virtual analog stick
@@ -5699,7 +5718,7 @@ function inputUpdate()
 
             // read virtual gamepad buttons
             const data = inputData[1] ?? (inputData[1] = []);
-            for (let i=10; i--;)
+            for (let i=12; i--;)
             {
                 const wasDown = gamepadIsDown(i,0);
                 data[i] = touchGamepadButtons[i] ? wasDown ? 1 : 3 : wasDown ? 4 : 0;
@@ -13125,7 +13144,7 @@ export
     gamepadDirectionEmulateStick,
     inputWASDEmulateDirection,
     touchGamepadEnable,
-    touchGamepadCenterButton,
+    touchGamepadCenterButtonSize,
     touchGamepadAnalog,
     touchGamepadSize,
     touchGamepadAlpha,
@@ -13173,7 +13192,7 @@ export
     setGamepadDirectionEmulateStick,
     setInputWASDEmulateDirection,
     setTouchGamepadEnable,
-    setTouchGamepadCenterButton,
+    setTouchGamepadCenterButtonSize,
     setTouchGamepadButtonCount,
     setTouchGamepadAnalog,
     setTouchGamepadSize,
@@ -13213,10 +13232,12 @@ export
     distanceAngle,
     lerpAngle,
     lerp,
+    percentLerp,
     smoothStep,
     nearestPowerOfTwo,
     isOverlapping,
     isIntersecting,
+    lineTest,
     oscillate,
 
     // Utilities