zx-kit 0.22.0 → 0.24.0

package/README.md

@@ -31,6 +31,7 @@ The goal is simple: **it should look and sound like a Spectrum, but run like a m
 - **Keyboard input** — configurable key-repeat, single-consume action flags, instant state reset on phase transitions
 - **ZX-style UI widgets** — progress bars with managed lifetime, boxes, frames, panel titles
 - **Typed save / load** — persistent saves via `localStorage` with schema versioning, migrations, slot enumeration, in-memory throttling, and discriminated Result types for every failure mode
+- **Runtime locale switching** — type-safe string-pack selection via `pickLocale()`, so a game can switch language while running — unimaginable on the original Spectrum, natural in the browser
 - **Zero dependencies** — only Web platform APIs: `Canvas`, `Web Audio`, `KeyboardEvent`
 - **Tree-shakeable** — `sideEffects: false`, so unused modules are dropped from your production bundle
 - **TypeScript-first** — strict mode, full `.d.ts` declarations, no `any`
@@ -545,8 +546,12 @@ requestAnimationFrame(loop)
 | [`scene.ts`](#scenets--scene-manager) | Stack-based scene manager with onEnter/onExit/onPause/onResume hooks |
 | [`save.ts`](#savets--typed-save--load) | Typed save/load via callbacks, versioning + migrations, slot enumeration, throttling, Result types |
 | [`tilemap.ts`](#tilemapts--tile-map-engine) | Scrollable maps, solid tiles, O(1) id-index, background swap |
+| [`tilescroll.ts`](#tilescrollts--pixel-smooth-scrolling) | Pixel-smooth tile-map rendering at any camera position (sub-tile scroll) |
+| [`particles.ts`](#particlests--particle-pool) | Allocation-free particle pool for pixel effects: sparks, dust, puffs |
+| [`rng.ts`](#rngts--seeded-rng) | Seeded deterministic PRNG (mulberry32): int/range/float/chance/pick/shuffle/fork |
 | [`palette.ts`](#palettets--color-constants) | 15 Spectrum colors, `SpectrumColor` type, `CELL`, `SCALE` |
 | [`font.ts`](#fontts--rom-bitmap-font) | 96-character ROM font, raw bitmap access |
+| [`i18n.ts`](#i18nts--runtime-locale-selection) | Type-safe runtime locale selection for translated string packs |
 
 ---
 
@@ -902,6 +907,36 @@ curveDisplay(ctx)               // default strength
 curveDisplay(ctx, 256, 208, 6)  // stronger warp
 ```
 
+### `createBitmapFromRows(rows): Bitmap`
+
+Builds an arbitrary-size `Bitmap` from readable pixel-art rows instead of
+hand-packed bytes. This is useful for sprites larger than 8x8 where hex arrays
+become hard to review.
+
+- `X` or `#` = solid pixel
+- `.` or space = transparent pixel
+- every row must have the same width
+- width must be a positive multiple of 8
+
+```ts
+const TRUCK = createBitmapFromRows([
+  '....XXXXXXXX....',
+  '..XXXXXXXXXXXX..',
+  '.XXXX......XXXX.',
+  'XXXXXXXXXXXXXXXX',
+  'XX..XXXXXXXX..XX',
+  'XX............XX',
+  '..XXX......XXX..',
+  '................',
+])
+
+drawBitmap(ctx, TRUCK, x, y, C.B_WHITE)
+```
+
+The returned object is the same `Bitmap` shape produced by `createBitmap()`, so
+it works with `drawBitmap`, `drawBitmapAttrs`, `mirrorBitmap`, and collision
+helpers such as `bitmapPixelMask`.
+
 ---
 
 ## `audio.ts` — Beeper Audio
@@ -1637,6 +1672,8 @@ When `groundContact` is 0, a circle-shaped hero hanging over a tile edge won't t
 | Bullet vs. irregular boss sprite | `masksOverlap` — pixel-precise, returns overlap count for damage |
 | Off-road detection for a truck with a bumpy silhouette | `pixelSolidCount` / custom mask loop — checks each opaque pixel against road boundary |
 
+For a step-by-step walkthrough of both tiers — including how to combine AABB and pixel-precise in one loop and how to handle non-tile boundaries — see **[docs/collision.md](docs/collision.md)**.
+
 ---
 
 ## `animation.ts` — Frame Timer & Tween
@@ -2192,6 +2229,201 @@ for (let row = 0; row < 8; row++) {
 
 ---
 
+## `i18n.ts` — Runtime Locale Selection
+
+A tiny helper for choosing a translated string pack at runtime. The original ZX Spectrum could not realistically swap whole languages while a game was running; zx-kit keeps the Spectrum presentation, but lets browser games offer modern language switching without a framework or dependency.
+
+### `pickLocale(defaultLocale, locales, code): T`
+
+Selects a locale object by language code and falls back to the default locale when the code is missing, empty, or unknown. Matching is case-insensitive.
+
+```ts
+import { pickLocale } from 'zx-kit'
+import * as en from './strings'
+import * as sk from './strings.sk'
+import * as ru from './strings.ru'
+
+let languageCode = localStorage.getItem('language')  // e.g. 'sk'
+let L = pickLocale(en, { sk, ru }, languageCode)
+
+drawText(ctx, L.STR_PRESS_START, 32, 88, C.B_WHITE, C.BLACK)
+
+function setLanguage(code: string): void {
+  languageCode = code
+  localStorage.setItem('language', code)
+  L = pickLocale(en, { sk, ru }, languageCode)
+}
+```
+
+Every locale must have the same shape as the default locale. Because `pickLocale` is generic over that shape, missing keys and wrong function signatures are caught by TypeScript:
+
+```ts
+// strings.ts
+export const STR_PRESS_START = 'PRESS START'
+export const STR_DEPTH = (m: number) => `D:${m}M`
+
+// strings.sk.ts
+export const STR_PRESS_START = 'STLAC START'
+export const STR_DEPTH = (m: number) => `H:${m}M`
+```
+
+Selection rules:
+
+| Code | Result |
+|------|--------|
+| `null`, `undefined`, `''` | `defaultLocale` |
+| `'sk'`, `'SK'`, `'Sk'` | `locales.sk` |
+| unknown code | `defaultLocale` |
+| `'en'` when `en` is not in `locales` | `defaultLocale` |
+
+The default language does not need its own `strings.en.ts` file. Keep the source language at `strings.ts`, put only additional translations in the locale map, and call `pickLocale` again whenever the player changes language.
+
+---
+
+## `tilescroll.ts` — Pixel-Smooth Scrolling
+
+[`tilemap.ts`](#tilemapts--tile-map-engine)'s `render(viewport)` takes a viewport in **whole tiles**, so a camera can only move in 8-pixel steps. That is perfect for grid games, but visibly steppy in a platformer where the player moves sub-pixel-smooth while jumping. `tilescroll.ts` renders the map at an **arbitrary pixel camera position** by drawing one overscan row/column and offsetting every tile by the camera remainder.
+
+Pair it with [`camera.ts`](#camerats--scrolling-camera): use `tileMapWorldSize` for the camera's `worldW` / `worldH`, then feed `cam.x` / `cam.y` straight into `drawTileMapAt`.
+
+### `tileMapWorldSize(map): { width, height }`
+
+Returns the map's full size in pixels (`cols × CELL`, `rows × CELL`) — handy for the camera's world bounds.
+
+```ts
+import { createCamera } from 'zx-kit'
+const cam = createCamera({ viewW: 256, viewH: 192, ...tileMapWorldSize(map) })
+```
+
+### `drawTileMapAt(ctx, map, camX, camY, viewW?, viewH?): void`
+
+Renders `map` with the viewport's top-left at world pixel `(camX, camY)`. The camera position is rounded to whole pixels for crisp output; off-screen and empty cells are skipped. `viewW` (default `256`) and `viewH` (default `192`) must be positive — throws otherwise. The leading/trailing partial tiles are drawn and naturally clipped by the canvas bounds, so keep the play area at the canvas origin (or render the map first) to avoid spilling under a status bar.
+
+```ts
+// game loop
+setCameraTarget(cam, player.x, player.y)
+tickCamera(cam, dt)
+drawTileMapAt(ctx, map, cam.x, cam.y)          // smooth background
+renderSprite(ctx, /* player drawn at (x - cam.x, y - cam.y) */)
+```
+
+---
+
+## `particles.ts` — Particle Pool
+
+An **allocation-free** particle pool for ZX-style pixel effects: carrot-shot sparks, landing dust, an enemy curling into a puff, glowing motes around a crystal. The pool is created once at startup with a fixed capacity; emitting and ticking never allocate, so it is safe to run every frame. Particles are plain coloured squares drawn in the Spectrum palette. Pass an `rng` for deterministic effects (replays, seeded worlds); otherwise it uses `Math.random`.
+
+### `Particle` / `ParticleSystem` interfaces
+
+```ts
+interface Particle {
+  x: number; y: number          // world pixels
+  vx: number; vy: number        // px per ms
+  life: number; maxLife: number // ms (fade with life / maxLife)
+  color: SpectrumColor
+  size: number                  // square side in px
+  active: boolean               // false slots are free for reuse
+}
+
+interface ParticleSystem {
+  readonly particles: Particle[]   // length === capacity
+  readonly capacity: number
+  activeCount: number
+}
+```
+
+### `createParticleSystem(capacity): ParticleSystem`
+
+Creates a pool of `capacity` particles, all inactive. Throws when `capacity` is not a positive integer.
+
+### `emitParticles(ps, opts): number`
+
+Emits up to `opts.count` particles and returns the number actually emitted (fewer when the pool is full). Throws when `count` is negative or non-integer.
+
+| Option | Type | Default | Meaning |
+|--------|------|---------|---------|
+| `x`, `y` | `number` | — | spawn position (world px) |
+| `count` | `number` | — | how many to emit |
+| `color` | `SpectrumColor \| SpectrumColor[]` | — | single colour, or palette to pick per particle |
+| `speed` | `number \| [min, max]` | `0.03` | px/ms |
+| `angle` | `number` | `0` | base direction in radians (`-π/2` = up) |
+| `spread` | `number` | `0` | angular jitter centred on `angle` |
+| `life` | `number \| [min, max]` | `300` | lifetime in ms |
+| `size` | `number` | `1` | square side in px |
+| `rng` | `() => number` | `Math.random` | deterministic source |
+
+```ts
+const sparks = createParticleSystem(128)
+
+// on carrot impact — a fan of yellow/white sparks shooting upward
+emitParticles(sparks, {
+  x: hit.x, y: hit.y, count: 12,
+  color: [C.B_YELLOW, C.B_WHITE],
+  speed: [0.02, 0.06], angle: -Math.PI / 2, spread: Math.PI,
+  life: [200, 400],
+})
+```
+
+### `tickParticles(ps, dtMs, gravity?): void`
+
+Advances every active particle by `dtMs`, applying optional `gravity` (px/ms², default `0`) to vertical velocity. Expired particles are deactivated and returned to the pool.
+
+### `renderParticles(ctx, ps, offsetX?, offsetY?): void`
+
+Draws every active particle as a filled square, rounding world coordinates to whole pixels. Subtract the camera world position via `offsetX` / `offsetY` to convert world → screen.
+
+### `clearParticles(ps): void`
+
+Deactivates all particles immediately (e.g. on room change).
+
+```ts
+// game loop
+tickParticles(sparks, dt, 0.0004)            // gentle gravity
+renderParticles(ctx, sparks, cam.x, cam.y)   // scrolled world
+```
+
+---
+
+## `rng.ts` — Seeded RNG
+
+A **seeded deterministic** pseudo-random generator: the same seed produces the same sequence on every machine and every run — exactly what procedural worlds need. Built on **mulberry32** (fast, allocation-free, good statistical quality for games). It is **not** cryptographically secure.
+
+The call order is part of the determinism contract: call the methods in the same order to reproduce a world.
+
+### `createRng(seed): Rng`
+
+Creates a generator from a `string` (hashed via `hashSeed`) or a finite `number` (coerced to uint32). Throws on a non-finite numeric seed.
+
+### `Rng` methods
+
+| Method | Returns | Throws when |
+|--------|---------|-------------|
+| `next()` | float `[0, 1)` | — |
+| `int(maxExclusive)` | int `[0, max)` | `max` not a positive integer |
+| `range(min, max)` | int `[min, max)` | bounds non-integer, or `max <= min` |
+| `float(min, max)` | float `[min, max)` | `max < min` |
+| `chance(p)` | boolean (`true` ~`p`) | `p` outside `[0, 1]` |
+| `pick(items)` | random element | `items` empty |
+| `shuffle(items)` | same array, shuffled in place | — |
+| `fork()` | independent `Rng` (advances parent one step) | — |
+
+```ts
+const rng = createRng('cave-level-7')
+const roomCount = rng.range(3, 7)
+const theme     = rng.pick(['spider', 'centipede', 'crystal'])
+if (rng.chance(0.15)) placeSecret()
+
+// independent sub-streams so adding enemies doesn't shift terrain layout
+const terrainRng = rng.fork()
+const enemyRng   = rng.fork()
+```
+
+### `hashSeed(seed): number`
+
+Hashes a string to an unsigned 32-bit integer (FNV-1a). Deterministic; exported for keying sub-streams by name.
+
+---
+
 ## Architecture
 
 ### Module structure
@@ -2205,9 +2437,8 @@ zx-kit/
 │   ├── index.ts           # barrel — re-exports everything
 │   ├── palette.ts         # SCALE, CELL, C, SpectrumColor
 │   ├── font.ts            # FONT, getCharRow
-│   ├── renderer.ts        # setupCanvas, mirrorSprite, drawSprite, drawChar,
-│   │                      # drawText, drawTextCentered, flashBorder,
-│   │                      # drawScanlines, curveDisplay
+│   ├── renderer.ts        # canvas setup, 8×8 sprites, arbitrary-size Bitmap,
+│   │                      # AttrMap colour attributes, text, scanlines, border flash
 │   ├── audio.ts           # initAudio, resumeAudio, beep, playPattern,
 │   │                      # getAudioContext, getMasterGain,
 │   │                      # getMasterVolume, setMasterVolume,
@@ -2218,15 +2449,20 @@ zx-kit/
 │   │                      # consumePause, consumeDebug, consumeAnyKey,
 │   │                      # isHeld, resetInput, Direction
 │   ├── ui.ts              # drawBox, drawFrame, drawPanelTitle,
-│   │                      # drawProgressBar, tickUI, renderUI, resetUI,
-│   │                      # BorderOptions, DrawProgressBarOptions
+│   │                      # instrumentation widgets, progress bars
 │   ├── tilemap.ts         # createTileMap, Tile, Viewport, TileMap
+│   ├── tilescroll.ts      # drawTileMapAt, tileMapWorldSize (sub-pixel scroll)
 │   ├── sprite.ts          # createSprite, moveSprite, applyGravity,
 │   │                      # renderSprite, Sprite
-│   └── collision.ts       # spriteRect, bitmapRect, rectsOverlap, spritesOverlap,
-│                          # isSolidAt, resolveRectX, resolveRectY, resolveX, resolveY,
-│                          # bitmapPixelMask, masksOverlap, pixelSolidCount,
-│                          # Rect, PixelMask
+│   ├── collision.ts       # AABB, rect-vs-tile, pixel-precise masks
+│   ├── particles.ts       # createParticleSystem, emitParticles,
+│   │                      # tickParticles, renderParticles, clearParticles
+│   ├── rng.ts             # createRng, hashSeed (seeded mulberry32)
+│   ├── animation.ts       # frame timers, tweens, blinkers
+│   ├── camera.ts          # scrolling viewport, lerp, deadzone, bounds
+│   ├── scene.ts           # stack-based scene manager
+│   ├── save.ts            # typed localStorage save/load with migrations
+│   └── i18n.ts            # pickLocale runtime locale selection
 └── dist/                  # compiled output (npm run build)
     ├── index.js
     ├── index.d.ts

package/dist/__tests__/collision.test.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pixel-perfect collision — visual ground truth test.
+ *
+ * Two bitmaps: 8×8 px each, but only a 2×2 px region is lit
+ * (rows 0–1, cols 0–1). The effective sprite shape is 2×2 — a size that
+ * is intentionally NOT a multiple of the ZX tile size (8 px).
+ *
+ *   col: 01234567
+ *   row 0: ██......   (0xC0)
+ *   row 1: ██......   (0xC0)
+ *   rows 2–7: empty
+ *
+ * Ground truth: a brute-force Set-of-pixel-coords intersection.
+ * Both sprites are projected to absolute (x,y) coordinates, all lit pixels
+ * are collected into a flat Set, and any shared coordinate counts as overlap.
+ * No formulas, no assumptions — just "which pixels are painted and do any
+ * coordinates match?"
+ *
+ * Every assertion compares masksOverlap against this ground truth, sweeping
+ * sprite B toward sprite A one pixel at a time in all four directions and
+ * diagonally. A separate block shows that AABB (8×8 bounding-box) fires
+ * 6 pixels earlier than pixel-perfect — the gap the ground truth exposes.
+ */
+export {};
+//# sourceMappingURL=collision.test.d.ts.map

package/dist/__tests__/collision.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collision.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/collision.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/dist/__tests__/collision.test.js

@@ -0,0 +1,198 @@
+/**
+ * Pixel-perfect collision — visual ground truth test.
+ *
+ * Two bitmaps: 8×8 px each, but only a 2×2 px region is lit
+ * (rows 0–1, cols 0–1). The effective sprite shape is 2×2 — a size that
+ * is intentionally NOT a multiple of the ZX tile size (8 px).
+ *
+ *   col: 01234567
+ *   row 0: ██......   (0xC0)
+ *   row 1: ██......   (0xC0)
+ *   rows 2–7: empty
+ *
+ * Ground truth: a brute-force Set-of-pixel-coords intersection.
+ * Both sprites are projected to absolute (x,y) coordinates, all lit pixels
+ * are collected into a flat Set, and any shared coordinate counts as overlap.
+ * No formulas, no assumptions — just "which pixels are painted and do any
+ * coordinates match?"
+ *
+ * Every assertion compares masksOverlap against this ground truth, sweeping
+ * sprite B toward sprite A one pixel at a time in all four directions and
+ * diagonally. A separate block shows that AABB (8×8 bounding-box) fires
+ * 6 pixels earlier than pixel-perfect — the gap the ground truth exposes.
+ */
+import { describe, it, expect } from 'vitest';
+import { bitmapPixelMask, masksOverlap, rectsOverlap } from '../collision.js';
+import { createBitmap } from '../renderer.js';
+// ── Fixture ───────────────────────────────────────────────────────────────────
+// width=8 (minimum for Bitmap: 1 byte per row). height=8.
+// Lit region: rows 0–1, cols 0–1. All other bytes 0x00.
+const BMP = createBitmap(new Uint8Array([
+    0xC0, // row 0: bits 7,6 set → cols 0,1
+    0xC0, // row 1: bits 7,6 set → cols 0,1
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, // rows 2–7: empty
+]), 8, 8);
+const MASK = bitmapPixelMask(BMP);
+// ── Brute-force ground truth ──────────────────────────────────────────────────
+// Project every lit pixel of a mask to world (x,y). Put them in a Set.
+// Check if any pixel of B appears in the Set of A. Completely explicit —
+// no clever algorithm, just coordinate comparison.
+function litPixels(mask, ox, oy) {
+    const s = new Set();
+    for (let row = 0; row < mask.height; row++) {
+        for (const col of mask.rows[row]) {
+            s.add(`${ox + col},${oy + row}`);
+        }
+    }
+    return s;
+}
+function bruteForce(maskA, ax, ay, maskB, bx, by) {
+    const setA = litPixels(maskA, ax, ay);
+    for (let row = 0; row < maskB.height; row++) {
+        for (const col of maskB.rows[row]) {
+            if (setA.has(`${bx + col},${by + row}`))
+                return true;
+        }
+    }
+    return false;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+describe('masksOverlap — 2×2 lit region, visual ground truth', () => {
+    // ── Sanity-check the mask ─────────────────────────────────────────────────
+    describe('mask shape', () => {
+        it('has exactly 4 lit pixels (the 2×2 region)', () => {
+            expect(MASK.totalPixels).toBe(4);
+        });
+        it('rows 0–1 contain columns [0, 1]; rows 2–7 are empty', () => {
+            expect(MASK.rows[0]).toEqual([0, 1]);
+            expect(MASK.rows[1]).toEqual([0, 1]);
+            for (let r = 2; r < MASK.height; r++) {
+                expect(MASK.rows[r]).toEqual([]);
+            }
+        });
+    });
+    // ── Horizontal sweep ──────────────────────────────────────────────────────
+    // A is fixed at (20,20). B sweeps from right (x=30) to left (x=17), same y.
+    // A's lit pixels: x∈[20,21], y∈[20,21].
+    // First contact: bx=21 — B column 0 (x=21) meets A column 1 (x=21).
+    // AABB first contact: bx=27 — 8×8 boxes share one column.  Gap = 6 px.
+    describe('horizontal sweep: B approaches A from the right', () => {
+        const AX = 20, AY = 20;
+        it('masksOverlap matches brute-force at every pixel step', () => {
+            for (let bx = AX + 10; bx >= AX - 3; bx--) {
+                const expected = bruteForce(MASK, AX, AY, MASK, bx, AY);
+                const actual = masksOverlap(MASK, AX, AY, MASK, bx, AY) > 0;
+                if (actual !== expected) {
+                    throw new Error(`bx=${bx}: masksOverlap=${actual} but brute-force says ${expected}`);
+                }
+            }
+        });
+        it('no collision at bx = AX+2 — 1-pixel gap between lit edges', () => {
+            // A's rightmost lit column is AX+1=21. B's leftmost at bx=AX+2=22. Gap 1 px.
+            expect(masksOverlap(MASK, AX, AY, MASK, AX + 2, AY)).toBe(0);
+            expect(bruteForce(MASK, AX, AY, MASK, AX + 2, AY)).toBe(false);
+        });
+        it('collision fires at bx = AX+1 — lit edges share column AX+1', () => {
+            expect(masksOverlap(MASK, AX, AY, MASK, AX + 1, AY)).toBeGreaterThan(0);
+            expect(bruteForce(MASK, AX, AY, MASK, AX + 1, AY)).toBe(true);
+        });
+        it('AABB (8×8 box) fires 6 pixels before pixel-perfect', () => {
+            const boxA = { x: AX, y: AY, w: 8, h: 8 };
+            // AABB says: first overlap at bx=AX+7 (right edge of A box = left edge of B box)
+            expect(rectsOverlap(boxA, { x: AX + 8, y: AY, w: 8, h: 8 })).toBe(false);
+            expect(rectsOverlap(boxA, { x: AX + 7, y: AY, w: 8, h: 8 })).toBe(true);
+            // Pixel-perfect: no lit pixels near each other at bx=AX+7 — false positive
+            expect(masksOverlap(MASK, AX, AY, MASK, AX + 7, AY)).toBe(0);
+            expect(bruteForce(MASK, AX, AY, MASK, AX + 7, AY)).toBe(false);
+        });
+    });
+    // ── Vertical sweep ────────────────────────────────────────────────────────
+    // A fixed at (20,20). B sweeps from below (y=30) upward (y=17), same x.
+    // First contact: by=21 — B row 0 (y=21) meets A row 1 (y=21).
+    // AABB first contact: by=27.  Gap = 6 px.
+    describe('vertical sweep: B approaches A from below', () => {
+        const AX = 20, AY = 20;
+        it('masksOverlap matches brute-force at every pixel step', () => {
+            for (let by = AY + 10; by >= AY - 3; by--) {
+                const expected = bruteForce(MASK, AX, AY, MASK, AX, by);
+                const actual = masksOverlap(MASK, AX, AY, MASK, AX, by) > 0;
+                if (actual !== expected) {
+                    throw new Error(`by=${by}: masksOverlap=${actual} but brute-force says ${expected}`);
+                }
+            }
+        });
+        it('no collision at by = AY+2 — 1-pixel gap between lit rows', () => {
+            expect(masksOverlap(MASK, AX, AY, MASK, AX, AY + 2)).toBe(0);
+            expect(bruteForce(MASK, AX, AY, MASK, AX, AY + 2)).toBe(false);
+        });
+        it('collision fires at by = AY+1 — lit rows share row AY+1', () => {
+            expect(masksOverlap(MASK, AX, AY, MASK, AX, AY + 1)).toBeGreaterThan(0);
+            expect(bruteForce(MASK, AX, AY, MASK, AX, AY + 1)).toBe(true);
+        });
+        it('AABB fires 6 pixels before pixel-perfect', () => {
+            const boxA = { x: AX, y: AY, w: 8, h: 8 };
+            expect(rectsOverlap(boxA, { x: AX, y: AY + 8, w: 8, h: 8 })).toBe(false);
+            expect(rectsOverlap(boxA, { x: AX, y: AY + 7, w: 8, h: 8 })).toBe(true);
+            expect(masksOverlap(MASK, AX, AY, MASK, AX, AY + 7)).toBe(0);
+            expect(bruteForce(MASK, AX, AY, MASK, AX, AY + 7)).toBe(false);
+        });
+    });
+    // ── Diagonal sweep ────────────────────────────────────────────────────────
+    // A fixed at (20,20). B sweeps along the main diagonal: bx=by=AX+d, d=10→-3.
+    // First contact: d=1 — corner pixel (AX+1, AY+1) is shared by both sprites.
+    // At d=2: B's nearest pixel is (AX+2, AY+2) — corner of A is (AX+1, AY+1). Gap.
+    describe('diagonal sweep: B approaches A from bottom-right', () => {
+        const AX = 20, AY = 20;
+        it('masksOverlap matches brute-force at every diagonal step', () => {
+            for (let d = 10; d >= -3; d--) {
+                const bx = AX + d, by = AY + d;
+                const expected = bruteForce(MASK, AX, AY, MASK, bx, by);
+                const actual = masksOverlap(MASK, AX, AY, MASK, bx, by) > 0;
+                if (actual !== expected) {
+                    throw new Error(`d=${d} (bx=${bx}, by=${by}): masksOverlap=${actual} but brute-force says ${expected}`);
+                }
+            }
+        });
+        it('no collision at d=2 — corner pixels are 1 diagonal step apart', () => {
+            expect(masksOverlap(MASK, AX, AY, MASK, AX + 2, AY + 2)).toBe(0);
+            expect(bruteForce(MASK, AX, AY, MASK, AX + 2, AY + 2)).toBe(false);
+        });
+        it('collision fires at d=1 — single corner pixel (AX+1, AY+1) coincides', () => {
+            expect(masksOverlap(MASK, AX, AY, MASK, AX + 1, AY + 1)).toBeGreaterThan(0);
+            expect(bruteForce(MASK, AX, AY, MASK, AX + 1, AY + 1)).toBe(true);
+        });
+    });
+    // ── Overlap count ─────────────────────────────────────────────────────────
+    // masksOverlap returns a count, not just a boolean. Verify it grows as the
+    // sprites move deeper into each other.
+    describe('overlap pixel count increases with penetration depth', () => {
+        const AX = 20, AY = 20;
+        it('1 overlapping pixel at first horizontal contact (bx = AX+1)', () => {
+            // Only column AX+1 is shared (both rows): 2 pixels
+            expect(masksOverlap(MASK, AX, AY, MASK, AX + 1, AY)).toBe(2);
+        });
+        it('4 overlapping pixels when fully aligned (bx = AX)', () => {
+            // Complete overlap of the 2×2 regions
+            expect(masksOverlap(MASK, AX, AY, MASK, AX, AY)).toBe(4);
+        });
+        it('single corner pixel at diagonal first contact (d=1)', () => {
+            // Only (AX+1, AY+1) is shared
+            expect(masksOverlap(MASK, AX, AY, MASK, AX + 1, AY + 1)).toBe(1);
+        });
+    });
+    // ── Symmetry ──────────────────────────────────────────────────────────────
+    // masksOverlap(A, B) must equal masksOverlap(B, A) — no directional bias.
+    describe('symmetry: collision count is order-independent', () => {
+        it('A→B count equals B→A count for all horizontal positions', () => {
+            const AX = 20, AY = 20;
+            for (let bx = AX + 5; bx >= AX - 3; bx--) {
+                const ab = masksOverlap(MASK, AX, AY, MASK, bx, AY);
+                const ba = masksOverlap(MASK, bx, AY, MASK, AX, AY);
+                if (ab !== ba) {
+                    throw new Error(`Asymmetry at bx=${bx}: A→B=${ab}, B→A=${ba}`);
+                }
+            }
+        });
+    });
+});
+//# sourceMappingURL=collision.test.js.map

package/dist/__tests__/collision.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collision.test.js","sourceRoot":"","sources":["../../src/__tests__/collision.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,8 +6,11 @@ export * from './audio.js';
 export * from './input.js';
 export * from './ui.js';
 export * from './tilemap.js';
+export * from './tilescroll.js';
 export * from './sprite.js';
 export * from './collision.js';
+export * from './particles.js';
+export * from './rng.js';
 export * from './animation.js';
 export * from './camera.js';
 export * from './scene.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA"}

package/dist/index.js

@@ -6,8 +6,11 @@ export * from './audio.js';
 export * from './input.js';
 export * from './ui.js';
 export * from './tilemap.js';
+export * from './tilescroll.js';
 export * from './sprite.js';
 export * from './collision.js';
+export * from './particles.js';
+export * from './rng.js';
 export * from './animation.js';
 export * from './camera.js';
 export * from './scene.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA"}