rn-gamekit 0.1.0 → 0.2.1

package/lib/module/collision2d/sweeps.js

@@ -0,0 +1,255 @@
+"use strict";
+
+/**
+ * Swept collision queries (T11.3, repaired in T11-F2, allocation-disciplined
+ * in T11-FF7).
+ *
+ * `time` is normalized to `[0, 1]` along the displacement. A starting
+ * overlap returns `time: 0` with the static manifold normal; zero
+ * displacement returns `undefined` (never NaN). At equal times the
+ * candidate evaluated FIRST wins — the X face before the Y face, faces
+ * before corners, corners in index order (T11-TF1). Circle-sweep misses
+ * allocate nothing; AABB-AABB sweep misses still allocate the expanded
+ * box, segment endpoints, and axis array (GS-COLLISION-03: the old blanket
+ * claim overstated this path, which stays scalar-simple by design).
+ *
+ * Circle-AABB sweeps raycast against the exact Minkowski geometry: the
+ * target expanded by the radius with ROUNDED corners. Face candidates come
+ * from the four expanded faces (valid only within the face's extent), and
+ * corner candidates come from radius circles around each target corner
+ * (valid only in the corner's exterior quadrant). AABB-AABB sweeps use the
+ * asymmetric expansion for the moving AABB's top-left reference point —
+ * the Minkowski sum of two AABBs is an AABB, so the slab method is exact.
+ *
+ * T11-FF7 allocation discipline: the four corner descriptors are derived
+ * arithmetically from the corner index (no per-call arrays or predicate
+ * closures), the two quadratic roots are evaluated as scalars, and the best
+ * candidate is tracked in scalars; only the final public `SweepHit2D` is
+ * allocated.
+ */
+
+import { assertValidAabb2D, assertValidCircle2D, assertValidVector2D } from "../geometry/validation.js";
+import { collideAabbAabb2D, collideCircleAabb2D } from "./manifolds.js";
+import { intersectsCircleAabb2D } from "./intersections.js";
+import { intersectSegmentAabb2D } from "./segments.js";
+
+/** Earliest impact of a swept circle against an AABB. */
+
+/** Earliest impact of a swept AABB against an AABB. */
+
+/** Earliest impact of a swept shape against a target. */
+
+/**
+ * Corner descriptors for index 0..3, derived arithmetically: bit 0 selects
+ * the max-x face (else min-x) and bit 1 selects the max-y face (else
+ * min-y). The quadrant validity of a hit point is the same bit test.
+ */
+function cornerFaceX(index, minX, maxX) {
+  return index & 1 ? maxX : minX;
+}
+function cornerFaceY(index, minY, maxY) {
+  return index & 2 ? maxY : minY;
+}
+function beyondFaceX(index, pointX, minX, maxX) {
+  return index & 1 ? pointX >= maxX : pointX <= minX;
+}
+function beyondFaceY(index, pointY, minY, maxY) {
+  return index & 2 ? pointY >= maxY : pointY <= minY;
+}
+
+/** Swept circle-AABB against the exact rounded-rectangle Minkowski shape. */
+export function sweepCircleAabb2D(options) {
+  const {
+    circle,
+    displacement,
+    target
+  } = options;
+  assertValidCircle2D(circle);
+  assertValidVector2D(displacement, 'displacement');
+  assertValidAabb2D(target, 'target');
+
+  // The starting-overlap check uses the allocation-free predicate; the
+  // manifold (and its contact object) runs only after contact is confirmed
+  // (T11-SF3).
+  if (intersectsCircleAabb2D(circle, target)) {
+    const overlap = collideCircleAabb2D(circle, target);
+    if (overlap !== undefined) {
+      return hitFromManifold(0, overlap);
+    }
+  }
+  if (displacement.x === 0 && displacement.y === 0) {
+    return undefined;
+  }
+  const radius = circle.radius;
+  const minX = target.x;
+  const maxX = target.x + target.width;
+  const minY = target.y;
+  const maxY = target.y + target.height;
+  const x0 = circle.x;
+  const y0 = circle.y;
+  const dx = displacement.x;
+  const dy = displacement.y;
+
+  // Scalar best-candidate tracking: nothing is allocated until a hit.
+  let hasBest = false;
+  let bestTime = 0;
+  let bestNX = 0;
+  let bestNY = 0;
+  let bestPX = 0;
+  let bestPY = 0;
+
+  // Face candidates: the four expanded faces, valid within the face extent.
+  // The accept logic is inlined as scalar updates (no local closure). A
+  // candidate REPLACES only when strictly earlier; at equal times the
+  // candidate evaluated first retains the result (T11-TF1).
+  if (dx !== 0) {
+    const faceX = dx > 0 ? minX - radius : maxX + radius;
+    const time = (faceX - x0) / dx;
+    const yAt = y0 + dy * time;
+    if (yAt >= minY && yAt <= maxY && time >= 0 && time <= 1 && (!hasBest || bestTime > time)) {
+      // The contact point is the closest point on the ORIGINAL target to
+      // the impact position (both coordinates clamped).
+      hasBest = true;
+      bestTime = time;
+      bestNX = dx > 0 ? -1 : 1;
+      bestNY = 0;
+      bestPX = clamp(faceX, minX, maxX);
+      bestPY = clamp(yAt, minY, maxY);
+    }
+  }
+  if (dy !== 0) {
+    const faceY = dy > 0 ? minY - radius : maxY + radius;
+    const time = (faceY - y0) / dy;
+    const xAt = x0 + dx * time;
+    if (xAt >= minX && xAt <= maxX && time >= 0 && time <= 1 && (!hasBest || bestTime > time)) {
+      hasBest = true;
+      bestTime = time;
+      bestNX = 0;
+      bestNY = dy > 0 ? -1 : 1;
+      bestPX = clamp(xAt, minX, maxX);
+      bestPY = clamp(faceY, minY, maxY);
+    }
+  }
+
+  // Corner candidates: radius circles around each corner, valid in the
+  // corner's exterior quadrant. The four descriptors are derived from the
+  // corner index arithmetically; both quadratic roots are scalars.
+  const a = dx * dx + dy * dy;
+  for (let corner = 0; corner < 4; corner += 1) {
+    const cornerX = cornerFaceX(corner, minX, maxX);
+    const cornerY = cornerFaceY(corner, minY, maxY);
+    const fx = x0 - cornerX;
+    const fy = y0 - cornerY;
+    const b = 2 * (fx * dx + fy * dy);
+    const c = fx * fx + fy * fy - radius * radius;
+    const discriminant = b * b - 4 * a * c;
+    if (discriminant < 0) {
+      continue;
+    }
+    const root = Math.sqrt(discriminant);
+    const firstRoot = (-b - root) / (2 * a);
+    const secondRoot = (-b + root) / (2 * a);
+    for (let pass = 0; pass < 2; pass += 1) {
+      const time = pass === 0 ? firstRoot : secondRoot;
+      if (time < 0 || time > 1 || hasBest && bestTime < time) {
+        continue;
+      }
+      const hitX = x0 + dx * time;
+      const hitY = y0 + dy * time;
+      if (!beyondFaceX(corner, hitX, minX, maxX) || !beyondFaceY(corner, hitY, minY, maxY)) {
+        continue;
+      }
+      const outX = hitX - cornerX;
+      const outY = hitY - cornerY;
+      const outDistance = Math.hypot(outX, outY);
+      const nx = outDistance === 0 ? 0 : outX / outDistance;
+      const ny = outDistance === 0 ? 1 : outY / outDistance;
+      if (!hasBest || time < bestTime) {
+        hasBest = true;
+        bestTime = time;
+        bestNX = nx;
+        bestNY = ny;
+        bestPX = cornerX;
+        bestPY = cornerY;
+      }
+    }
+  }
+  if (!hasBest) {
+    return undefined;
+  }
+  return Object.freeze({
+    time: bestTime,
+    normal: Object.freeze({
+      x: bestNX,
+      y: bestNY
+    }),
+    point: Object.freeze({
+      x: bestPX,
+      y: bestPY
+    })
+  });
+}
+
+/** Swept AABB-AABB with the exact asymmetric reference expansion. */
+export function sweepAabbAabb2D(options) {
+  const {
+    aabb,
+    displacement,
+    target
+  } = options;
+  assertValidAabb2D(aabb, 'aabb');
+  assertValidVector2D(displacement, 'displacement');
+  assertValidAabb2D(target, 'target');
+  const startingOverlap = collideAabbAabb2D(aabb, target);
+  if (startingOverlap !== undefined) {
+    return hitFromManifold(0, startingOverlap);
+  }
+  if (displacement.x === 0 && displacement.y === 0) {
+    return undefined;
+  }
+
+  // Top-left reference: the valid x interval is [target.min - w, target.max]
+  // and the valid y interval is [target.min - h, target.max] (asymmetric).
+  const expanded = {
+    x: target.x - aabb.width,
+    y: target.y - aabb.height,
+    width: target.width + aabb.width,
+    height: target.height + aabb.height
+  };
+  const segmentHit = intersectSegmentAabb2D({
+    start: {
+      x: aabb.x,
+      y: aabb.y
+    },
+    end: {
+      x: aabb.x + displacement.x,
+      y: aabb.y + displacement.y
+    }
+  }, expanded);
+  if (segmentHit === undefined) {
+    return undefined;
+  }
+  const originAtImpact = {
+    x: aabb.x + displacement.x * segmentHit.time,
+    y: aabb.y + displacement.y * segmentHit.time
+  };
+  return Object.freeze({
+    time: segmentHit.time,
+    normal: segmentHit.normal,
+    point: Object.freeze({
+      x: clamp(originAtImpact.x, target.x, target.x + target.width),
+      y: clamp(originAtImpact.y, target.y, target.y + target.height)
+    })
+  });
+}
+function hitFromManifold(time, hit) {
+  return Object.freeze({
+    time,
+    normal: hit.normal,
+    point: hit.point
+  });
+}
+function clamp(value, min, max) {
+  return value < min ? min : value > max ? max : value;
+}
+//# sourceMappingURL=sweeps.js.map

package/lib/module/collision2d/sweeps.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["assertValidAabb2D","assertValidCircle2D","assertValidVector2D","collideAabbAabb2D","collideCircleAabb2D","intersectsCircleAabb2D","intersectSegmentAabb2D","cornerFaceX","index","minX","maxX","cornerFaceY","minY","maxY","beyondFaceX","pointX","beyondFaceY","pointY","sweepCircleAabb2D","options","circle","displacement","target","overlap","undefined","hitFromManifold","x","y","radius","width","height","x0","y0","dx","dy","hasBest","bestTime","bestNX","bestNY","bestPX","bestPY","faceX","time","yAt","clamp","faceY","xAt","a","corner","cornerX","cornerY","fx","fy","b","c","discriminant","root","Math","sqrt","firstRoot","secondRoot","pass","hitX","hitY","outX","outY","outDistance","hypot","nx","ny","Object","freeze","normal","point","sweepAabbAabb2D","aabb","startingOverlap","expanded","segmentHit","start","end","originAtImpact","hit","value","min","max"],"sourceRoot":"../../../src","sources":["collision2d/sweeps.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/collision2d.js

@@ -0,0 +1,9 @@
+"use strict";
+
+/**
+ * Subpath entry for `rn-gamekit/collision2d`.
+ *
+ * Headless collision predicates — no React, Skia, or physics backends.
+ */
+export * from "./collision2d/index.js";
+//# sourceMappingURL=collision2d.js.map

package/lib/module/collision2d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["collision2d.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA,cAAc,wBAAqB","ignoreList":[]}

package/lib/module/core/input/buttonPad.js

@@ -0,0 +1,214 @@
+"use strict";
+
+/**
+ * Multitouch button-pad controller (headless).
+ *
+ * Maps every active pointer to the button zone it covers and turns touch
+ * transitions into press/release diffs for a session input buffer. Pure and
+ * React-free: the React surface (`GameButtonPad`) only registers zone rects,
+ * feeds touch lists in, and applies the returned diffs to
+ * `session.input`.
+ *
+ * Semantics:
+ * - A zone is a rectangle; an optional global hit slop expands it.
+ * - Each pointer maps to AT MOST one action (first registered zone wins).
+ * - An action is pressed while ANY pointer covers its zone (refcounted);
+ *   it releases when the last pointer leaves or lifts. Edges fire only on
+ *   0-to-1 (press) and 1-to-0 (release) owner transitions — a second owner
+ *   never re-presses and an unbalanced release never emits.
+ * - Sliding between zones reassigns the pointer: release + press diff.
+ * - Moves acquire: a pointer that begins in empty space and slides into a
+ *   zone presses it; leaving a zone releases. Every touch in a move list
+ *   is hit-tested, mapped or not.
+ * - Zone rects are cloned at registration: later caller mutation of the
+ *   passed object cannot alter hit areas invisibly.
+ */
+
+/** A rectangular hit area, in the pad's local coordinate space. */
+
+/** One active pointer sample. */
+
+/** Press/release transitions derived from one touch event. */
+
+const EMPTY_DIFF = {
+  pressed: [],
+  released: []
+};
+function contains(rect, hitSlop, x, y) {
+  return x >= rect.x - hitSlop && x <= rect.x + rect.width + hitSlop && y >= rect.y - hitSlop && y <= rect.y + rect.height + hitSlop;
+}
+
+/** Create a controller bound to no particular session (diffs are applied by the caller). */
+export function createButtonPadController(options) {
+  const hitSlop = options?.hitSlop ?? 0;
+  const zones = new Map();
+  const pointerAction = new Map();
+  const holdCounts = new Map();
+  // GS-INPUT-04: pointers that were active across an invalidation (pause,
+  // session replacement) must produce a fresh down before their moves can
+  // acquire again. A fresh down rehabilitates; lift clears the mark.
+  const stalePointerIds = new Set();
+  const apply = (action, direction) => {
+    // GS-INPUT-02: edges fire only on ownership transitions. A second owner
+    // (0 stays > 0) never re-presses; an unbalanced release from zero
+    // count never emits.
+    const previous = holdCounts.get(action) ?? 0;
+    const next = previous + direction;
+    if (next <= 0) {
+      holdCounts.delete(action);
+      return previous > 0 && direction === -1 ? 'released' : undefined;
+    }
+    holdCounts.set(action, next);
+    return previous === 0 && direction === 1 ? 'pressed' : undefined;
+  };
+  const hitTest = (x, y) => {
+    for (const [action, rect] of zones) {
+      if (contains(rect, hitSlop, x, y)) {
+        return action;
+      }
+    }
+    return undefined;
+  };
+  const retarget = (touchId, action) => {
+    const previous = pointerAction.get(touchId);
+    if (previous === action) {
+      return EMPTY_DIFF;
+    }
+    const pressed = [];
+    const released = [];
+    if (previous !== undefined) {
+      pointerAction.delete(touchId);
+      const result = apply(previous, -1);
+      if (result === 'released') {
+        released.push(previous);
+      }
+    }
+    if (action !== undefined) {
+      pointerAction.set(touchId, action);
+      const result = apply(action, 1);
+      if (result === 'pressed') {
+        pressed.push(action);
+      }
+    }
+    return {
+      pressed,
+      released
+    };
+  };
+  const dropPointers = changed => {
+    const released = [];
+    for (const touch of changed) {
+      stalePointerIds.delete(touch.id);
+      const previous = pointerAction.get(touch.id);
+      if (previous === undefined) {
+        continue;
+      }
+      pointerAction.delete(touch.id);
+      if (apply(previous, -1) === 'released') {
+        released.push(previous);
+      }
+    }
+    return {
+      pressed: [],
+      released
+    };
+  };
+  return {
+    setZone(action, rect) {
+      // GS-INPUT-02: clone the rect so later caller mutation of the passed
+      // object cannot alter hit areas invisibly.
+      zones.set(action, {
+        x: rect.x,
+        y: rect.y,
+        width: rect.width,
+        height: rect.height
+      });
+    },
+    removeZone(action) {
+      zones.delete(action);
+      // GS-INPUT-02: drop every pointer mapped to the removed zone, then
+      // release and delete the ENTIRE action count — a single decrement
+      // would strand a phantom hold. Pointers stay physically tracked only
+      // through future touch events, which re-acquire via hit test.
+      for (const [pointerId, mapped] of [...pointerAction]) {
+        if (mapped === action) {
+          pointerAction.delete(pointerId);
+        }
+      }
+      if ((holdCounts.get(action) ?? 0) > 0) {
+        holdCounts.delete(action);
+        return [action];
+      }
+      return [];
+    },
+    touchesDown(touches) {
+      const merged = {
+        pressed: [],
+        released: []
+      };
+      for (const touch of touches) {
+        stalePointerIds.delete(touch.id);
+        const diff = retarget(touch.id, hitTest(touch.x, touch.y));
+        merged.pressed.push(...diff.pressed);
+        merged.released.push(...diff.released);
+      }
+      return merged;
+    },
+    touchesMove(touches) {
+      // GS-INPUT-02: every touch in the move list is hit-tested, mapped or
+      // not — a pointer that left its zone releases, and one that entered
+      // a zone (including from empty space) presses it.
+      // GS-INPUT-04: pointers marked stale by an invalidation wait for a
+      // fresh down first.
+      const merged = {
+        pressed: [],
+        released: []
+      };
+      for (const touch of touches) {
+        if (stalePointerIds.has(touch.id)) {
+          continue;
+        }
+        const diff = retarget(touch.id, hitTest(touch.x, touch.y));
+        merged.pressed.push(...diff.pressed);
+        merged.released.push(...diff.released);
+      }
+      return merged;
+    },
+    touchesUp(changed) {
+      return dropPointers(changed);
+    },
+    touchesCancel(changed) {
+      return dropPointers(changed);
+    },
+    releaseAll() {
+      const released = new Set();
+      for (const action of pointerAction.values()) {
+        released.add(action);
+      }
+      pointerAction.clear();
+      for (const action of holdCounts.keys()) {
+        released.add(action);
+      }
+      holdCounts.clear();
+      stalePointerIds.clear();
+      return [...released];
+    },
+    /**
+     * GS-INPUT-04: invalidate ownership without touching zones — pause,
+     * session replacement, or layout teardown snapshot the active pointers
+     * as stale and drop all holds. Stale pointers must produce a fresh down
+     * before their moves can acquire again; a fresh down rehabilitates.
+     */
+    invalidateOwnership() {
+      for (const pointerId of pointerAction.keys()) {
+        stalePointerIds.add(pointerId);
+      }
+      pointerAction.clear();
+      holdCounts.clear();
+    },
+    held() {
+      return [...holdCounts.keys()];
+    }
+  };
+}
+//# sourceMappingURL=buttonPad.js.map

package/lib/module/core/input/buttonPad.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EMPTY_DIFF","pressed","released","contains","rect","hitSlop","x","y","width","height","createButtonPadController","options","zones","Map","pointerAction","holdCounts","stalePointerIds","Set","apply","action","direction","previous","get","next","delete","undefined","set","hitTest","retarget","touchId","result","push","dropPointers","changed","touch","id","setZone","removeZone","pointerId","mapped","touchesDown","touches","merged","diff","touchesMove","has","touchesUp","touchesCancel","releaseAll","values","add","clear","keys","invalidateOwnership","held"],"sourceRoot":"../../../../src","sources":["core/input/buttonPad.ts"],"mappings":"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","ignoreList":[]}