minimojs 1.0.0-alpha.26 → 1.0.0-alpha.28

package/dist/internal/InputSystem.js

@@ -85,6 +85,8 @@ export class InputSystem {
                     y: p.y,
                     pressed: true,
                 });
+                // A finger that touches while none is followed becomes the pointer,
+                // even when other fingers are still down.
                 if (this._primaryTouchId === null) {
                     this._primaryTouchId = touch.identifier;
                 }
@@ -277,18 +279,9 @@ export class InputSystem {
             }
             this._primaryTouchId = null;
         }
-        if (this._touchPointers.size > 0) {
-            const firstTouchEntry = this._touchPointers.entries().next().value;
-            if (firstTouchEntry) {
-                const [touchId, touch] = firstTouchEntry;
-                this._primaryTouchId = touchId;
-                this._pointerX = touch.x;
-                this._pointerY = touch.y;
-                this._pointerDown = true;
-                this._pointerPressed = touch.pressed;
-                return;
-            }
-        }
+        // No finger is followed. Fingers still down are not adopted: the pointer
+        // reports the followed finger's release, and the next finger to touch
+        // is followed instead.
         this._primaryTouchId = null;
         const released = this._releasedTouch;
         this._pointerX = released ? released.x : this._mouseX;

package/dist/minimo-cards.d.ts

@@ -242,6 +242,10 @@ export declare class CardPile {
  *
  * Call {@link update} once per frame.
  *
+ * Piles and cards live in world space and scroll with the game. The table
+ * reads the pointer itself and adds `game.scrollX` and `game.scrollY`, so a
+ * scrolled board needs no conversion from the game.
+ *
  * @example
  * ```ts
  * const table = new CardTable(game, {

package/dist/minimo-cards.js

@@ -187,6 +187,10 @@ let nextTableId = 1;
  *
  * Call {@link update} once per frame.
  *
+ * Piles and cards live in world space and scroll with the game. The table
+ * reads the pointer itself and adds `game.scrollX` and `game.scrollY`, so a
+ * scrolled board needs no conversion from the game.
+ *
  * @example
  * ```ts
  * const table = new CardTable(game, {
@@ -638,12 +642,15 @@ export class CardTable {
             this.cancelDrag();
             return;
         }
+        // The pointer is in screen space and the piles and cards are in world space.
         const x = game.pointerX;
         const y = game.pointerY;
+        const worldX = x + game.scrollX;
+        const worldY = y + game.scrollY;
         if (game.isPointerPressed()) {
             this.cancelDrag();
-            const hit = this.hitTest(x, y);
-            this._press = hit ? { x, y, card: hit.card, pile: hit.pile, dragTried: false } : null;
+            const hit = this.hitTest(worldX, worldY);
+            this._press = hit ? { x, y, worldX, worldY, card: hit.card, pile: hit.pile, dragTried: false } : null;
             return;
         }
         const press = this._press;
@@ -654,7 +661,7 @@ export class CardTable {
                 this.startDrag(press);
             }
             if (this._drag)
-                this.followPointer(x, y);
+                this.followPointer(worldX, worldY);
             return;
         }
         this._press = null;
@@ -718,8 +725,8 @@ export class CardTable {
             view.moving = false;
             view.waitMs = 0;
             view.dragging = true;
-            view.grabX = press.x - view.sprite.x;
-            view.grabY = press.y - view.sprite.y;
+            view.grabX = press.worldX - view.sprite.x;
+            view.grabY = press.worldY - view.sprite.y;
             view.sprite.layer = this.layer + 1000 + i * 0.01;
             this.applyScale(view);
         });

package/dist/minimo.d.ts

@@ -1316,6 +1316,11 @@ export declare class Game {
      * in pixels. Updated every `mousemove` / `touchmove` event.
      * `(0, 0)` is the top-left corner of the canvas.
      * To convert to world space: `worldX = game.pointerX + game.scrollX`.
+     *
+     * On a touch screen the pointer is one finger: the first to touch while no
+     * finger is followed. Other fingers never move it, and when the followed
+     * finger lifts, the pointer stays where it left the screen even if others
+     * are still down. Use {@link Game.getPointers} to follow several fingers.
      */
     get pointerX(): number;
     /**
@@ -1616,6 +1621,8 @@ export declare class Game {
      * Use this for continuous pointer actions.
      *
      * **Hold behavior:** returns `true` every frame from press until release.
+     * On a touch screen it follows one finger, as {@link Game.pointerX} does,
+     * so it turns `false` when that finger lifts, even if another is down.
      *
      * @returns `true` if the pointer is currently pressed.
      *

package/dist/minimo.js

@@ -1429,6 +1429,11 @@ export class Game {
      * in pixels. Updated every `mousemove` / `touchmove` event.
      * `(0, 0)` is the top-left corner of the canvas.
      * To convert to world space: `worldX = game.pointerX + game.scrollX`.
+     *
+     * On a touch screen the pointer is one finger: the first to touch while no
+     * finger is followed. Other fingers never move it, and when the followed
+     * finger lifts, the pointer stays where it left the screen even if others
+     * are still down. Use {@link Game.getPointers} to follow several fingers.
      */
     get pointerX() {
         return this._inputSystem.pointerX;
@@ -1788,6 +1793,8 @@ export class Game {
      * Use this for continuous pointer actions.
      *
      * **Hold behavior:** returns `true` every frame from press until release.
+     * On a touch screen it follows one finger, as {@link Game.pointerX} does,
+     * so it turns `false` when that finger lifts, even if another is down.
      *
      * @returns `true` if the pointer is currently pressed.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimojs",
-  "version": "1.0.0-alpha.26",
+  "version": "1.0.0-alpha.28",
   "description": "MinimoJS v1 — ultra-minimal, flat, deterministic 2D web game engine. Image-first sprites with emoji as a zero-asset alternative, rAF loop, TypeScript-first, LLM-friendly.",
   "type": "module",
   "main": "dist/minimo.js",
@@ -21,7 +21,8 @@
     "clean": "rm -rf dist",
     "rebuild": "npm run clean && npm run build",
     "prepack": "npm run build",
-    "pack:check": "npm pack --dry-run"
+    "pack:check": "npm pack --dry-run",
+    "test": "npm run build && node --test \"test/*.test.mjs\""
   },
   "keywords": [
     "game",