blockyard 0.0.1 → 0.0.9

package/public/js/arkanoid.js

@@ -0,0 +1,806 @@
+// BLOCKANOID, the rules (operator, 2026-09-12: "Take blockout, and make rip off of Arkanoid using
+// our engine, and make it a new Diversion called 'Blockanoid'").
+//
+// Like breakout.js and tetris.js, this file is the RULES and nothing else: no DOM, no canvas, no
+// clock, and NO Math.random. Arkanoid lives or dies on its capsules, and a capsule that fell at
+// random could not be tested at all -- so which brick carries one is a pure hash of that brick's
+// id and the level. The same wall always drops the same capsules, and a test can say which.
+//
+// Coordinates follow the engine's board: x runs left to right, y runs UP from row 0 on the floor.
+// Vaus sits near the floor, the wall is at the top, so the ball travels toward +y to break
+// something -- the renderer's language, as in breakout.js.
+//
+// What this takes from Arkanoid that Breakout has not got:
+//   - a different WALL every level, not the same six rows again
+//   - SILVER bricks that take two hits (and more as the levels climb) and GOLD that never breaks
+//   - CAPSULES that fall out of broken bricks: laser, enlarge, catch, slow, disrupt, player, break
+//   - three balls at once, a bat that shoots, and a bat that catches
+//   - the DOH minions drifting down the court to spoil your aim
+
+export const COLS = 13;
+export const ROWS = 26;
+
+export const PADDLE_Y = 1;
+export const PADDLE_D = 1;          // the bat's DEPTH across the board (see breakout.js: not its height)
+export const PADDLE_H = 0.55;       // how tall the bat's stones STAND
+export const PADDLE_W = 3;          // Vaus is narrower than a Breakout bat
+export const PADDLE_W_WIDE = 5;     // ... until the E capsule
+export const BALL_S = 0.8;
+export const BALL_R = BALL_S / 2;
+export const LIVES = 3;
+
+export const BRICK_TOP = ROWS - 4;
+
+// ------------------------------------------------------------------ the bricks
+// A colour is worth what it is worth, as in the arcade: the dearer the colour the higher it sits.
+export const BRICK = Object.freeze({
+  w: Object.freeze({ color: '#e8eefc', points: 50 }),
+  o: Object.freeze({ color: '#f7931a', points: 60 }),
+  c: Object.freeze({ color: '#3ec9ff', points: 70 }),
+  g: Object.freeze({ color: '#2ecc8f', points: 80 }),
+  r: Object.freeze({ color: '#ef5a5a', points: 90 }),
+  b: Object.freeze({ color: '#4d7cff', points: 100 }),
+  p: Object.freeze({ color: '#b07cff', points: 110 }),
+  y: Object.freeze({ color: '#f5d142', points: 120 }),
+});
+export const SILVER = Object.freeze({ color: '#b9c4d4', points: 50 });
+export const GOLD = Object.freeze({ color: '#d9a441', points: 0 });
+
+// Six walls. '.' is empty, a letter is that colour, S is silver, G is gold. Written TOP ROW FIRST,
+// the way you look at it; layout() flips them onto the engine's y-up board.
+export const LEVELS = Object.freeze([
+  Object.freeze(['wwwwwwwwwwwww', 'ooooooooooooo', 'ccccccccccccc', 'ggggggggggggg', 'rrrrrrrrrrrrr', 'bbbbbbbbbbbbb']),
+  Object.freeze(['.SSSSSSSSSSS.', '.G.........G.', '.rrrrrrrrrrr.', '.ooooooooooo.', '.yyyyyyyyyyy.', '.ccccccccccc.']),
+  Object.freeze(['r.r.r.r.r.r.r', '.o.o.o.o.o.o.', 'y.y.y.y.y.y.y', '.g.g.g.g.g.g.', 'S.S.S.S.S.S.S', '.b.b.b.b.b.b.']),
+  Object.freeze(['......G......', '.....yyy.....', '....ooooo....', '...rrrrrrr...', '..bbbbbbbbb..', '.SSSSSSSSSSS.']),
+  Object.freeze(['GGGGGGGGGGGGG', 'G...........G', 'G.SSSSSSSSS.G', 'G.S.ppppp.S.G', 'G.S.pyyyp.S.G', 'G.SSSSSSSSS.G']),
+  Object.freeze(['S.G.S.G.S.G.S', '.wwwwwwwwwww.', '.w.c.c.c.c.w.', '.w.ccccccc.w.', '.wwwwwwwwwww.', 'S.G.S.G.S.G.S']),
+]);
+
+// A BRICK THAT SURVIVES A HIT SHOWS IT (operator, 2026-09-12: "The blocks that take more than 1
+// hit to break, need to start darker in color. Every successive hit ... makes it lighter colored,
+// signalling it's closer to breaking. When it's the lightest color it can be, it will signal the
+// next impact will break that block").
+//
+// The ramp is anchored at both ends so the LAST step is unmistakable: fresh is DAMAGE_DARK, and
+// one-hit-from-breaking is DAMAGE_LIGHT, whatever the durability happens to be. A brick with three
+// lives and a brick with five both end on the same bright colour, so "next one does it" is a
+// colour you learn once rather than a shade you have to compare against its neighbours.
+export const DAMAGE_DARK = '#4a5361';
+export const DAMAGE_LIGHT = '#f2f7ff';
+
+const hex2 = (h, i) => parseInt(h.slice(i, i + 2), 16);
+/** Mix two six-digit hexes, t = 0 gives `a`, t = 1 gives `b`. Pure, so the ramp is assertable. */
+export function mixHex(a, b, t) {
+  const k = Math.max(0, Math.min(1, t));
+  const ch = (i) => Math.round(hex2(a.replace('#', ''), i) + (hex2(b.replace('#', ''), i) - hex2(a.replace('#', ''), i)) * k);
+  return `#${[ch(0), ch(2), ch(4)].map((v) => v.toString(16).padStart(2, '0')).join('')}`;
+}
+
+/**
+ * The colour of a brick with `left` hits remaining out of `max`. Dark when fresh, lightest when one
+ * hit remains. A single-hit brick keeps its own colour -- there is no wear to show.
+ */
+export function damageShade(left, max, base) {
+  if (!Number.isFinite(max) || max <= 1) return base;
+  const p = (max - Math.max(1, left)) / (max - 1);   // 0 fresh .. 1 about to break
+  return mixHex(DAMAGE_DARK, DAMAGE_LIGHT, p);
+}
+
+/** How many hits a silver brick takes at this level: two, and one more every four levels. */
+export function silverHits(level) { return 2 + Math.floor(Math.max(0, level - 1) / 4); }
+
+// ------------------------------------------------------------------ the capsules
+// One capsule at a time is the arcade's rule and it matters: it is what makes "do I take it?" a
+// decision rather than a reflex.
+// `break` (skip the wall) was removed on the operator's word, 2026-09-12. It was the one capsule
+// that took the game away from you: clearing a wall you had not cleared is a reward for catching a
+// pill rather than for playing, and it made the level you were in the middle of pointless.
+export const CAPSULES = Object.freeze(['laser', 'enlarge', 'catch', 'slow', 'disrupt', 'player']);
+export const CAPSULE_COLOR = Object.freeze({
+  laser: '#ef5a5a', enlarge: '#4d7cff', catch: '#2ecc8f', slow: '#f7931a',
+  disrupt: '#3ec9ff', player: '#b07cff',
+});
+// EACH CAPSULE HAS ITS OWN SILHOUETTE, not just its own colour (operator, 2026-09-12: "Blockanoid
+// needs unique block graphics and styling for each of the different powerups that drop down").
+// Colour alone is a poor signal here: the capsule is small, it is moving, and roughly one player in
+// twelve cannot separate the red from the green at all. So SHAPE carries the meaning and colour
+// only reinforces it -- the seven differ in part count, height and profile, and stay readable in
+// monochrome. `trim` is the glyph sitting on the body.
+export const CAPSULE_TRIM = Object.freeze({
+  laser: '#ffd0c4', enlarge: '#cfe0ff', catch: '#d8ffe9', slow: '#ffe0b0',
+  disrupt: '#d6f4ff', player: '#ecdcff',
+});
+export const CAPSULE_LETTER = Object.freeze({
+  laser: 'L', enlarge: 'E', catch: 'C', slow: 'S', disrupt: 'D', player: 'P',
+});
+export const CAPSULE_POINTS = 1000;
+const CAPSULE_FALL = 5;             // grid units a second
+// DRAWN SIZE AND HIT BOX ARE TWO DIFFERENT MEASUREMENTS (operator, 2026-09-12: "the blockanoid
+// minions and pills need to be AT LEAST 4 times larger ... shrink the bounding box if necessary to
+// compensate for visual"). They used to be one number, which is why they could not both be right: a
+// capsule big enough to read across a room is a capsule you cannot miss, and a minion that size
+// could never thread a gap in the wall. So the sprite is large and the box it collides with is not.
+export const CAPSULE_S = 2.16;      // DRAWN: 2.4x the old 0.9 (4x was a bit large -- operator)
+export const CAPSULE_BOX = 1.9;     // CAUGHT: generous, but you can still miss it
+const CAPSULE_ODDS = 0.28;          // of a broken brick
+
+const BASE_SPEED = 12;
+const LEVEL_SPEEDUP = 1.06;
+const SLOW_FACTOR = 0.68;
+const MAX_BOUNCE = 1.05;
+const MAX_STEP = 0.3;
+const LASER_SPEED = 26;
+const LASER_COOLDOWN = 260;         // ms between shots
+// CATCH RUNS OUT (operator, 2026-09-12: "The catch shouldnt last forever. Just 30 seconds max").
+// Held for ever it stops being a power-up and becomes a different game -- you can park the ball and
+// aim every single shot, which removes the rally. Thirty seconds is long enough to set up the shots
+// you caught it for. Counted in ms off `step`'s own dtMs, like the laser cooldown and the minion
+// timer: the rules still have no clock of their own, so a run stays reproducible.
+// NOTHING LASTS FOR EVER (operator, 2026-09-12: "All the powerups need 30 second timers max for
+// each. they are not infinite"). Four of the six are STATES and so can expire; disrupt and the
+// extra life are one-shot and have nothing to run down. One table and one expiry loop, because
+// four hand-written countdowns are four chances to drift apart -- the same reason loseLife() exists.
+const POWER_MS = 30_000;
+export const TIMED_POWERS = Object.freeze(['laser', 'catch', 'slow', 'wide']);
+// Slower than before: a minion is now looking for a way through rather than falling past you.
+const ENEMY_SPEED = 1.25;           // descent, grid units a second
+const ENEMY_SIDE = 2.4;             // sideways, while feeling along the wall for a gap
+const ENEMY_EVERY = 9000;           // ms between arrivals while a level runs
+const ENEMY_POINTS = 200;
+export const ENEMY_S = 2.06;        // DRAWN: 2.4x the old 0.86 (4x was a bit large -- operator, 2026-09-12)
+// The hit box must fit the gaps it has to navigate. Measured on the shipped walls: levels 3 and 6
+// leave one-unit gaps, so anything wider than a unit could never pass and would sit at the top
+// for ever. This is also the box the ball and the laser must hit, and the box that costs a life.
+export const ENEMY_BOX = 0.92;
+
+// ---------------------------------------------------------------- the minions
+// Arkanoid's minions were solids that tumbled down the court -- a cone, a cube, a sphere, a
+// molecule -- so these are shapes first and behaviours second. Each is an outline in UNIT SPACE
+// (-0.5..0.5, scaled by the tile), a colour, a pair of eye positions, and a DRIFT: how it moves
+// sideways as it falls. They differ in silhouette as well as colour, for the same reason the
+// capsules do -- a small moving object is read by its shape.
+export const MINIONS = Object.freeze({
+  // a squat cone, swinging widely: the one that gets in the way
+  cone: Object.freeze({
+    color: '#7de3c8', spin: 1.7, drift: 'swing',
+    poly: Object.freeze([[0, -0.46], [0.40, 0.34], [0.22, 0.46], [-0.22, 0.46], [-0.40, 0.34]]),
+    eyes: Object.freeze([[-0.13, 0.02, 0.075], [0.13, 0.02, 0.075]]),
+  }),
+  // a tumbling cube, turning fast and falling nearly straight
+  cube: Object.freeze({
+    color: '#ffb066', spin: 3.1, drift: 'straight',
+    poly: Object.freeze([[-0.40, -0.40], [0.40, -0.40], [0.40, 0.40], [-0.40, 0.40]]),
+    eyes: Object.freeze([[-0.14, -0.04, 0.07], [0.14, -0.04, 0.07]]),
+  }),
+  // a many-sided ball that wobbles as it sinks
+  orb: Object.freeze({
+    color: '#c79bff', spin: 0.9, drift: 'wobble',
+    poly: Object.freeze([[-0.20, -0.44], [0.20, -0.44], [0.44, -0.20], [0.44, 0.20],
+      [0.20, 0.44], [-0.20, 0.44], [-0.44, 0.20], [-0.44, -0.20]]),
+    eyes: Object.freeze([[-0.15, -0.05, 0.08], [0.15, -0.05, 0.08]]),
+  }),
+  // a four-armed molecule, drifting to one side and back
+  molecule: Object.freeze({
+    color: '#ff8fa3', spin: 2.2, drift: 'zigzag',
+    poly: Object.freeze([[0, -0.48], [0.17, -0.17], [0.48, 0], [0.17, 0.17],
+      [0, 0.48], [-0.17, 0.17], [-0.48, 0], [-0.17, -0.17]]),
+    eyes: Object.freeze([[-0.11, 0, 0.065], [0.11, 0, 0.065]]),
+  }),
+});
+export const MINION_KINDS = Object.freeze(Object.keys(MINIONS));
+
+/** How far sideways a minion of this kind has drifted, in grid units a second. Pure. */
+export function minionDrift(kind, phase, t) {
+  switch (MINIONS[kind]?.drift) {
+    case 'swing': return Math.sin(phase + t * 2.2) * 3.0;
+    case 'zigzag': return (((phase + t * 0.9) % 1) < 0.5 ? 1 : -1) * 1.8;
+    case 'wobble': return Math.sin(phase + t * 5.0) * 1.1;
+    default: return Math.sin(phase + t * 0.7) * 0.35;
+  }
+}
+
+export const PADDLE_COLOR = '#3ec9ff';
+export const PADDLE_LASER_COLOR = '#ef5a5a';
+export const BALL_COLOR = '#f2f7ff';
+// A LASER EMITS; IT DOES NOT REFLECT (operator, 2026-09-12: "The lasers need to be much brighter.
+// They are too dark to be visible"). A bolt used to be an ordinary cube, so the engine lit it like
+// masonry: measured, its darkest side came out at luminance 70 and its unlit walls at 84, from a
+// declared colour of 167. And a bolt is a sliver -- under the oblique camera it is almost entirely
+// SIDE face, which is the darkest surface a cube has. It was being shaded into the background.
+//
+// Drawn the way the neon finish draws a lit tube instead: a wide translucent halo and a hot thin
+// core, both `always: true` so they survive the edges switch, with the colour lifted toward white
+// rather than shaded away from it.
+export const BOLT_COLOR = '#fff0a8';        // the beam: hot, near-white yellow
+export const BOLT_GLOW = '#ff5a3c';         // the halo around it
+
+/**
+ * A stable 0..1 from a string. The same brick on the same level always yields the same number, so
+ * "which bricks carry capsules" is a property of the wall rather than of the day you played it.
+ * (The mix is the same shape as blockscene3d's fxHash: cheap, and well spread for short keys.)
+ */
+export function hash01(key) {
+  let h = 2166136261;
+  const s = String(key);
+  for (let i = 0; i < s.length; i++) { h ^= s.charCodeAt(i); h = Math.imul(h, 16777619); }
+  h ^= h >>> 13; h = Math.imul(h, 1274126177); h ^= h >>> 16;
+  return (h >>> 0) / 4294967296;
+}
+
+/** The capsule this brick carries, or null. Pure: the wall decides, not the moment. */
+export function capsuleFor(brick, level) {
+  const roll = hash01(`cap:${level}:${brick.id}:${brick.x},${brick.y}`);
+  if (roll >= CAPSULE_ODDS) return null;
+  const pick = hash01(`kind:${level}:${brick.id}`);
+  return CAPSULES[Math.min(CAPSULES.length - 1, Math.floor(pick * CAPSULES.length))];
+}
+
+export function speed(level) { return BASE_SPEED * Math.pow(LEVEL_SPEEDUP, Math.max(0, level - 1)); }
+
+/** The wall for a level; levels past the last one cycle round, harder silver each time. */
+export function layoutFor(level) { return LEVELS[(Math.max(1, level) - 1) % LEVELS.length]; }
+
+function layout(g) {
+  g.bricks = [];
+  const rows = layoutFor(g.level);
+  const hits = silverHits(g.level);
+  for (let r = 0; r < rows.length; r++) {
+    const line = rows[r];
+    const y = BRICK_TOP - r;                       // row 0 of the layout is the TOP row on screen
+    for (let x = 0; x < Math.min(COLS, line.length); x++) {
+      const ch = line[x];
+      if (ch === '.') continue;
+      if (ch === 'G') g.bricks.push({ id: g.nextId++, x, y, kind: 'gold', color: GOLD.color, points: 0, hits: Infinity, maxHits: Infinity });
+      else if (ch === 'S') g.bricks.push({ id: g.nextId++, x, y, kind: 'silver', color: SILVER.color, points: SILVER.points * g.level, hits, maxHits: hits });
+      else {
+        const spec = BRICK[ch];
+        if (!spec) continue;
+        g.bricks.push({ id: g.nextId++, x, y, kind: 'plain', color: spec.color, points: spec.points, hits: 1, maxHits: 1 });
+      }
+    }
+  }
+  g.breakableAtStart = breakable(g).length;
+}
+
+/** The bricks that can actually be destroyed -- gold is scenery, and never blocks a level. */
+export function breakable(g) { return g.bricks.filter((b) => b.kind !== 'gold'); }
+
+export function resetBall(g) {
+  // `hold` is the grip: how far along the bat the ball sits. A stuck ball is placed FROM it.
+  g.balls = [{ x: g.paddle.x + g.paddle.w / 2, y: PADDLE_Y + PADDLE_D + BALL_R, vx: 0, vy: 0, r: BALL_R, stuck: true, hold: g.paddle.w / 2 }];
+  return g.balls[0];
+}
+
+/** Vaus back to stock: normal width, no laser, no catch, no slow. */
+export function resetVaus(g) {
+  g.paddle.w = PADDLE_W;
+  g.laser = false;
+  g.catch = false;
+  g.slow = false;
+  g.cooldown = 0;
+  // a stale countdown must not survive into the next ball
+  g.timers = { laser: 0, catch: 0, slow: 0, wide: 0 };
+  g.paddle.x = Math.max(0, Math.min(COLS - g.paddle.w, g.paddle.x));
+}
+
+/**
+ * The two switches that change the RULES rather than the look, so they live on the game and not in
+ * the renderer's options. A setting nothing reads is a dead control; these are read in capsuleFor's
+ * caller and in the minions' arrival, which is the only place they can bite.
+ */
+export function setOptions(g, opts = {}) {
+  g.opts = { capsules: opts.capsules !== false, enemies: opts.enemies !== false };
+  if (!g.opts.capsules) g.capsules = [];
+  if (!g.opts.enemies) g.enemies = [];
+  return g.opts;
+}
+
+export function newGame(level = 1, opts = {}) {
+  const g = {
+    cols: COLS, rows: ROWS,
+    level, score: 0, lives: LIVES, over: false, cleared: false,
+    paddle: { x: (COLS - PADDLE_W) / 2, w: PADDLE_W },
+    balls: [], bricks: [], capsules: [], bolts: [], enemies: [],
+    laser: false, catch: false, slow: false, cooldown: 0,
+    timers: { laser: 0, catch: 0, slow: 0, wide: 0 },
+    sinceEnemy: 0, nextId: 1, breakableAtStart: 0,
+    opts: { capsules: true, enemies: true },
+  };
+  setOptions(g, opts);
+  layout(g);
+  resetBall(g);
+  return g;
+}
+
+/** The next wall: a new layout, a faster ball, Vaus back to stock, the score and lives carried. */
+export function advance(g) {
+  g.level++;
+  g.cleared = false;
+  g.capsules = []; g.bolts = []; g.enemies = []; g.sinceEnemy = 0;
+  layout(g);
+  resetVaus(g);
+  resetBall(g);
+  return g;
+}
+
+export function movePaddle(g, centreX) {
+  if (g.over) return g.paddle.x;
+  const half = g.paddle.w / 2;
+  g.paddle.x = Math.max(0, Math.min(COLS - g.paddle.w, centreX - half));
+  // LOCKED TO THE BAT, not merely kept inside it (operator, 2026-09-12: "the ball needs to stick to
+  // the paddle location when it lands ... It should not shift around while the paddle moves beneath
+  // it"). This used to CLAMP a stuck ball into the bat's span, so the ball held its absolute place
+  // while the bat slid underneath and only moved when an edge caught up with it -- which is exactly
+  // the drift that was reported. It is placed from its grip instead.
+  for (const b of g.balls) {
+    if (!b.stuck) continue;
+    if (b.hold == null) b.hold = b.x - g.paddle.x;
+    b.hold = Math.max(0, Math.min(g.paddle.w, b.hold));
+    b.x = g.paddle.x + b.hold;
+  }
+  return g.paddle.x;
+}
+export function nudge(g, dx) { return movePaddle(g, g.paddle.x + g.paddle.w / 2 + dx); }
+
+/** Send every waiting ball on its way. The angle is the caller's, never a roll. */
+export function launch(g, angle = 0.3) {
+  if (g.over) return false;
+  const waiting = g.balls.filter((b) => b.stuck);
+  if (!waiting.length) return false;
+  const s = speed(g.level) * (g.slow ? SLOW_FACTOR : 1);
+  const a = Math.max(-MAX_BOUNCE, Math.min(MAX_BOUNCE, angle));
+  for (const b of waiting) { b.vx = Math.sin(a) * s; b.vy = Math.cos(a) * s; b.stuck = false; }
+  return true;
+}
+
+/** Fire, if the laser is up and it has cooled. Returns the bolts created. */
+export function fire(g) {
+  if (g.over || !g.laser || g.cooldown > 0) return [];
+  const p = g.paddle;
+  const made = [
+    { id: g.nextId++, x: p.x + 0.3, y: PADDLE_Y + PADDLE_D },
+    { id: g.nextId++, x: p.x + p.w - 0.3, y: PADDLE_Y + PADDLE_D },
+  ];
+  g.bolts.push(...made);
+  g.cooldown = LASER_COOLDOWN;
+  return made;
+}
+
+function offPaddle(g, b) {
+  const p = g.paddle;
+  const off = Math.max(-1, Math.min(1, (b.x - (p.x + p.w / 2)) / (p.w / 2)));
+  const s = Math.hypot(b.vx, b.vy) || speed(g.level);
+  const a = off * MAX_BOUNCE;
+  b.vx = Math.sin(a) * s;
+  b.vy = Math.abs(Math.cos(a) * s);
+  b.y = PADDLE_Y + PADDLE_D + b.r;
+  // caught: remember WHERE on the bat, so it rides along rather than being shoved by an edge
+  if (g.catch) { b.stuck = true; b.vx = 0; b.vy = 0; b.hold = Math.max(0, Math.min(p.w, b.x - p.x)); }
+}
+
+/** Take a capsule. Each one is a different promise, so each is written out rather than table-driven. */
+export function applyCapsule(g, kind) {
+  g.score += CAPSULE_POINTS;
+  switch (kind) {
+    case 'laser': g.laser = true; g.timers.laser = POWER_MS; g.catch = false; g.timers.catch = 0; break;
+    case 'enlarge': {
+      const mid = g.paddle.x + g.paddle.w / 2;
+      g.paddle.w = PADDLE_W_WIDE;
+      g.paddle.x = Math.max(0, Math.min(COLS - g.paddle.w, mid - g.paddle.w / 2));
+      g.timers.wide = POWER_MS;
+      break;
+    }
+    case 'catch': g.catch = true; g.timers.catch = POWER_MS; g.laser = false; g.timers.laser = 0; break;
+    case 'slow': {
+      // only slow what is not already slowed, or two capsules would compound into a crawl
+      if (!g.slow) for (const b of g.balls) if (!b.stuck) { b.vx *= SLOW_FACTOR; b.vy *= SLOW_FACTOR; }
+      g.slow = true;
+      g.timers.slow = POWER_MS;
+      break;
+    }
+    case 'disrupt': {
+      // three on the court. The extra two leave at a fixed spread off the first, so a disrupted
+      // rally is still a rally a test can follow.
+      const live = g.balls.filter((b) => !b.stuck);
+      const from = live[0] ?? g.balls[0];
+      if (from && !from.stuck) {
+        for (const turn of [0.45, -0.45]) {
+          const c = Math.cos(turn), s = Math.sin(turn);
+          g.balls.push({ x: from.x, y: from.y, vx: from.vx * c - from.vy * s, vy: from.vx * s + from.vy * c, r: BALL_R, stuck: false });
+        }
+      }
+      break;
+    }
+    case 'player': g.lives += 1; break;
+    default: break;
+  }
+  return g;
+}
+
+function hitBrick(g, b, hits) {
+  for (let i = 0; i < g.bricks.length; i++) {
+    const k = g.bricks[i];
+    const ox = Math.min(b.x + b.r, k.x + 1) - Math.max(b.x - b.r, k.x);
+    const oy = Math.min(b.y + b.r, k.y + 1) - Math.max(b.y - b.r, k.y);
+    if (ox <= 0 || oy <= 0) continue;
+    if (ox < oy) { b.vx = b.x < k.x + 0.5 ? -Math.abs(b.vx) : Math.abs(b.vx); b.x += b.vx > 0 ? ox : -ox; }
+    else { b.vy = b.y < k.y + 0.5 ? -Math.abs(b.vy) : Math.abs(b.vy); b.y += b.vy > 0 ? oy : -oy; }
+    damage(g, k, i, hits);
+    return true;
+  }
+  return false;
+}
+
+/** One hit on a brick. Gold rings and stands; silver counts down; anything else goes. */
+function damage(g, k, i, hits) {
+  if (k.kind === 'gold') { hits.push({ kind: 'gold', x: k.x, y: k.y, color: k.color }); return false; }
+  k.hits -= 1;
+  if (k.hits > 0) { hits.push({ kind: 'silver', x: k.x, y: k.y, color: k.color }); return false; }
+  g.bricks.splice(i, 1);
+  g.score += k.points;
+  hits.push({ kind: 'brick', x: k.x, y: k.y, color: k.color, points: k.points, brickKind: k.kind });
+  // one capsule on the court at a time, exactly as the arcade does it
+  const cap = g.opts?.capsules === false ? null : capsuleFor(k, g.level);
+  if (cap && !g.capsules.length) {
+    g.capsules.push({ id: g.nextId++, kind: cap, x: k.x, y: k.y });
+    hits.push({ kind: 'capsuleout', capsule: cap, x: k.x, y: k.y });
+  }
+  return true;
+}
+
+function moveCapsules(g, dt, hits) {
+  const p = g.paddle;
+  for (let i = g.capsules.length - 1; i >= 0; i--) {
+    const c = g.capsules[i];
+    c.y -= CAPSULE_FALL * dt;
+    const caught = c.y <= PADDLE_Y + PADDLE_D && c.y + CAPSULE_BOX >= PADDLE_Y
+      && c.x + CAPSULE_BOX >= p.x && c.x <= p.x + p.w;
+    if (caught) {
+      g.capsules.splice(i, 1);
+      applyCapsule(g, c.kind);
+      hits.push({ kind: 'capsule', capsule: c.kind });
+    } else if (c.y + CAPSULE_BOX < 0) g.capsules.splice(i, 1);
+  }
+}
+
+function moveBolts(g, dt, hits) {
+  for (let i = g.bolts.length - 1; i >= 0; i--) {
+    const z = g.bolts[i];
+    z.y += LASER_SPEED * dt;
+    if (z.y > ROWS) { g.bolts.splice(i, 1); continue; }
+    let spent = false;
+    for (let e = g.enemies.length - 1; e >= 0 && !spent; e--) {
+      const m = g.enemies[e];
+      if (z.x >= m.x && z.x <= m.x + ENEMY_BOX && z.y >= m.y && z.y <= m.y + ENEMY_BOX) {
+        g.enemies.splice(e, 1); g.score += ENEMY_POINTS;
+        hits.push({ kind: 'enemy', x: m.x, y: m.y });
+        spent = true;
+      }
+    }
+    for (let bi = 0; bi < g.bricks.length && !spent; bi++) {
+      const k = g.bricks[bi];
+      if (z.x >= k.x && z.x <= k.x + 1 && z.y >= k.y && z.y <= k.y + 1) {
+        damage(g, k, bi, hits);
+        spent = true;
+      }
+    }
+    if (spent) g.bolts.splice(i, 1);
+  }
+}
+
+/** Does a box of side `s` at (x,y) overlap any brick? A brick is exactly one grid cell. */
+export function boxHitsBrick(g, x, y, s) {
+  for (const k of g.bricks) {
+    if (x + s > k.x && x < k.x + 1 && y + s > k.y && y < k.y + 1) return k;
+  }
+  return null;
+}
+
+/**
+ * A life goes. TWO things cost one now -- the last ball through the floor, and a minion reaching
+ * Vaus -- so the consequences live in one place rather than being written twice and drifting apart.
+ */
+export function loseLife(g, hits, kind) {
+  g.lives -= 1;
+  hits.push({ kind });
+  resetVaus(g);
+  g.capsules = []; g.bolts = []; g.enemies = []; g.sinceEnemy = 0;
+  if (g.lives <= 0) { g.over = true; resetBall(g); g.balls[0].stuck = true; g.balls[0].vx = 0; g.balls[0].vy = 0; }
+  else resetBall(g);
+}
+
+function moveEnemies(g, dt, dtMs, hits) {
+  if (g.opts?.enemies === false) { g.sinceEnemy = 0; return; }
+  g.sinceEnemy += dtMs;
+  if (g.sinceEnemy >= ENEMY_EVERY && g.enemies.length < 3 && breakable(g).length) {
+    g.sinceEnemy = 0;
+    const n = g.nextId++;
+    // deterministic arrival: where it enters is a property of the level and the count, not a roll
+    const lane = Math.floor(hash01(`enemy:${g.level}:${n}`) * (COLS - 1));
+    // which minion turns up is a property of the level and the arrival, not a roll
+    const kind = MINION_KINDS[Math.floor(hash01(`mk:${g.level}:${n}`) * MINION_KINDS.length)];
+    g.enemies.push({ id: n, kind, x: lane, y: ROWS - 1, phase: hash01(`ph:${n}`) * Math.PI * 2, t: 0 });
+    hits.push({ kind: 'enemyin', x: lane, minion: kind });
+  }
+  const p = g.paddle;
+  const lim = COLS - ENEMY_BOX;
+  for (let i = g.enemies.length - 1; i >= 0; i--) {
+    const m = g.enemies[i];
+    m.t += dt;
+
+    // IT LOOKS FOR A WAY THROUGH (operator: "the minions should slowly try to find a path out").
+    // A wall-follower, not a pathfinder: descend when the space below is clear; when it is not,
+    // feel sideways in one direction for a gap; at a dead end, turn round. On a solid wall that
+    // reads as a minion pacing the top until the player opens a hole -- the arcade behaviour, and
+    // what makes breaking the wall feel like relief rather than bookkeeping.
+    const down = ENEMY_SPEED * dt;
+    if (!boxHitsBrick(g, m.x, m.y - down, ENEMY_BOX)) {
+      m.y -= down;
+      const nx = Math.max(0, Math.min(lim, m.x + minionDrift(m.kind, m.phase, m.t) * dt));
+      if (!boxHitsBrick(g, nx, m.y, ENEMY_BOX)) m.x = nx;
+    } else {
+      if (m.dir == null) m.dir = hash01(`dir:${m.id}`) < 0.5 ? -1 : 1;
+      const nx = m.x + m.dir * ENEMY_SIDE * dt;
+      if (nx >= 0 && nx <= lim && !boxHitsBrick(g, nx, m.y, ENEMY_BOX)) m.x = nx;
+      else m.dir = -m.dir;
+    }
+
+    // AND IT IS FATAL (operator: "kill the player if the player hits it"). It used to PAY 200 for
+    // touching Vaus, which had it backwards: the ball and the laser destroy a minion for points,
+    // but a minion that reaches the bat destroys the bat.
+    const onBat = m.y <= PADDLE_Y + PADDLE_D && m.y + ENEMY_BOX >= PADDLE_Y
+      && m.x + ENEMY_BOX >= p.x && m.x <= p.x + p.w;
+    if (onBat) { hits.push({ kind: 'vaus', x: m.x, y: m.y }); loseLife(g, hits, 'life'); return; }
+    if (m.y + ENEMY_BOX < 0) g.enemies.splice(i, 1);
+  }
+}
+
+function ballEnemy(g, b, hits) {
+  for (let i = g.enemies.length - 1; i >= 0; i--) {
+    const m = g.enemies[i];
+    const ox = Math.min(b.x + b.r, m.x + ENEMY_BOX) - Math.max(b.x - b.r, m.x);
+    const oy = Math.min(b.y + b.r, m.y + ENEMY_BOX) - Math.max(b.y - b.r, m.y);
+    if (ox <= 0 || oy <= 0) continue;
+    g.enemies.splice(i, 1);
+    g.score += ENEMY_POINTS;
+    // BOUNCE OFF IT (operator: "If a ball hits a minion from above, it should bounce off it when it
+    // dies instead of passing through"). This forced the ball DOWNWARD whatever direction it had
+    // arrived from, so a ball descending onto a minion was pushed further down and read as passing
+    // straight through. Reflected on the axis it is least buried in, exactly as a brick does it --
+    // which gives the side bounces for free too.
+    if (ox < oy) b.vx = b.x < m.x + ENEMY_BOX / 2 ? -Math.abs(b.vx) : Math.abs(b.vx);
+    else b.vy = b.y < m.y + ENEMY_BOX / 2 ? -Math.abs(b.vy) : Math.abs(b.vy);
+    hits.push({ kind: 'enemy', x: m.x, y: m.y });
+    return true;
+  }
+  return false;
+}
+
+function substepBall(g, b, h, hits) {
+  b.x += b.vx * h;
+  b.y += b.vy * h;
+  if (b.x - b.r < 0) { b.x = b.r; b.vx = Math.abs(b.vx); hits.push({ kind: 'wall' }); }
+  else if (b.x + b.r > COLS) { b.x = COLS - b.r; b.vx = -Math.abs(b.vx); hits.push({ kind: 'wall' }); }
+  if (b.y + b.r > ROWS) { b.y = ROWS - b.r; b.vy = -Math.abs(b.vy); hits.push({ kind: 'wall' }); }
+
+  const p = g.paddle;
+  if (b.vy < 0 && b.y - b.r <= PADDLE_Y + PADDLE_D && b.y + b.r >= PADDLE_Y
+      && b.x + b.r >= p.x && b.x - b.r <= p.x + p.w) {
+    offPaddle(g, b);
+    hits.push({ kind: 'paddle' });
+  }
+  ballEnemy(g, b, hits);
+  hitBrick(g, b, hits);
+  return b.y + b.r < 0;                       // through the floor
+}
+
+/**
+ * Advance the court by dtMs. Substepped for the same reason breakout.js is: a ball at twelve units
+ * a second crosses a one-unit brick in 83 ms and would tunnel through the wall on a slow frame.
+ */
+export function step(g, dtMs) {
+  const hits = [];
+  if (g.over) return { hits, lost: false, cleared: g.cleared };
+  const standing = breakable(g).length > 0;
+  const dt = Math.min(60, Math.max(0, dtMs)) / 1000;
+  const ms = Math.min(60, Math.max(0, dtMs));
+  g.cooldown = Math.max(0, g.cooldown - ms);
+  for (const power of TIMED_POWERS) {
+    if (!(g.timers?.[power] > 0)) continue;
+    g.timers[power] = Math.max(0, g.timers[power] - ms);
+    if (g.timers[power] > 0) continue;
+    hits.push({ kind: 'powerover', power });
+    if (power === 'laser') g.laser = false;
+    if (power === 'wide') {
+      // back to stock about its OWN centre, and a held ball re-gripped into the narrower bat
+      const mid = g.paddle.x + g.paddle.w / 2;
+      g.paddle.w = PADDLE_W;
+      g.paddle.x = Math.max(0, Math.min(COLS - g.paddle.w, mid - g.paddle.w / 2));
+      for (const b of g.balls) if (b.stuck) { b.hold = Math.max(0, Math.min(g.paddle.w, b.hold ?? g.paddle.w / 2)); b.x = g.paddle.x + b.hold; }
+    }
+    if (power === 'slow') {
+      // put the pace BACK, or "slow" is permanent by omission
+      g.slow = false;
+      for (const b of g.balls) if (!b.stuck) { b.vx /= SLOW_FACTOR; b.vy /= SLOW_FACTOR; }
+    }
+    if (power === 'catch') {
+      g.catch = false;
+      hits.push({ kind: 'catchover' });
+      // A ball still held has to GO, or it sits on the bat with nothing left to explain why.
+      // Released at the angle its own position on the bat implies -- the same rule a bounce uses,
+      // so this is deterministic and the run stays reproducible.
+      for (const b of g.balls) {
+        if (!b.stuck) continue;
+        b.stuck = false;
+        const off = Math.max(-1, Math.min(1, (b.x - (g.paddle.x + g.paddle.w / 2)) / (g.paddle.w / 2)));
+        const sp = speed(g.level) * (g.slow ? SLOW_FACTOR : 1);
+        b.vx = Math.sin(off * MAX_BOUNCE) * sp;
+        b.vy = Math.abs(Math.cos(off * MAX_BOUNCE) * sp);
+      }
+    }
+  }
+
+  moveCapsules(g, dt, hits);
+  moveBolts(g, dt, hits);
+  moveEnemies(g, dt, Math.min(60, Math.max(0, dtMs)), hits);
+
+  const moving = g.balls.filter((b) => !b.stuck);
+  for (const b of moving) {
+    const sp = Math.hypot(b.vx, b.vy) || 1;
+    const n = Math.max(1, Math.ceil((sp * dt) / MAX_STEP));
+    const h = dt / n;
+    let gone = false;
+    for (let i = 0; i < n && !gone; i++) gone = substepBall(g, b, h, hits);
+    if (gone) b.dead = true;
+  }
+  if (g.balls.some((b) => b.dead)) g.balls = g.balls.filter((b) => !b.dead);
+
+  let lost = false;
+  if (!g.balls.length) {                      // every ball gone: a life, and Vaus back to stock
+    lost = true;
+    // ONE implementation, not two. This was a line-for-line copy of loseLife() until a minion
+    // reaching Vaus became the second way to lose one -- and two copies of a rule drift.
+    loseLife(g, hits, 'life');
+  }
+
+  if (standing && !breakable(g).length) g.cleared = true;
+  if (g.cleared) for (const b of g.balls) { b.stuck = true; b.vx = 0; b.vy = 0; }
+  return { hits, lost, cleared: g.cleared };
+}
+
+/**
+ * ONE CAPSULE, AS SEVERAL TILES -- its own little machine rather than a coloured slab.
+ *
+ * Pure, and separate from tiles(), so the seven silhouettes can be asserted without a canvas. Each
+ * is built from parts offset inside the capsule's own footprint (CAPSULE_S wide), with `floor`
+ * lifting a glyph to stand ON the body. Deliberately different part counts and heights:
+ *
+ *   laser   two cannons standing tall        slow     the only HOLLOW one (a wire box)
+ *   enlarge the flattest, with end caps      disrupt  three small spheres in a row
+ *   catch   a ball cradled between posts     player   the tallest: a tower with a bead on top
+ *   break   a doorway: two posts and a lintel, and the only one with no full-width base
+ */
+export function capsuleTiles(c, now = 0) {
+  const k = c.kind;
+  const body = CAPSULE_COLOR[k] ?? '#e8eefc';
+  const trim = CAPSULE_TRIM[k] ?? '#ffffff';
+  const spec = CAPSULE_SHAPE[k] ?? CAPSULE_SHAPE.laser;
+  const id = (n) => `cap${c.id}${n}`;
+  // IT TUMBLES AS IT FALLS. The angle comes from the capsule's own height, not from a clock, so
+  // two capsules at the same height look the same and a test can say what a frame contains --
+  // the rules stay free of time, exactly as the launch angle is an argument rather than a roll.
+  const rot = (c.y * 1.5 + (c.id % 7) * 0.9) % (Math.PI * 2);
+  // drawn large, CENTRED on the catch box, so what you aim at is under what you see
+  const off = (CAPSULE_S - CAPSULE_BOX) / 2;
+  const x = c.x - off, y = c.y - off;
+  return [
+    // the pill: an elongated stadium, wider than it is tall, turning end over end
+    { txid: id('p'), x, y, s: CAPSULE_S, tall: 0.44, color: body, capsule: true, poly: PILL, rot },
+    // the band across it, in the capsule's trim colour, so the letter-colour still reads
+    { txid: id('b'), x, y, s: CAPSULE_S, tall: 0.46, color: trim, capsule: true, poly: spec.band, rot },
+  ];
+}
+
+// A STADIUM, drawn once. Unit space (-0.5..0.5), so it scales with the tile: a flat-ended
+// rectangle with a fan of points rounding each cap. Long axis across, which is what makes it read
+// as a pill rather than a lozenge.
+const PILL = Object.freeze((() => {
+  const pts = [];
+  const hw = 0.46, hh = 0.2, r = hh;
+  for (let i = 0; i <= 6; i++) { const a = -Math.PI / 2 + (i / 6) * Math.PI; pts.push([hw - r + Math.cos(a) * r, Math.sin(a) * r]); }
+  for (let i = 0; i <= 6; i++) { const a = Math.PI / 2 + (i / 6) * Math.PI; pts.push([-hw + r + Math.cos(a) * r, Math.sin(a) * r]); }
+  return pts.map(([x, y]) => Object.freeze([Math.round(x * 1000) / 1000, Math.round(y * 1000) / 1000]));
+})());
+
+// EACH PILL STILL CARRIES ITS OWN MARK. The band is a different figure per capsule, so the seven
+// remain distinguishable in monochrome -- the property the capsule test asserts -- even though
+// they now share one silhouette. Colour is the third cue, not the only one.
+const CAPSULE_SHAPE = Object.freeze({
+  laser:   { band: Object.freeze([[-0.30, -0.12], [-0.18, -0.12], [-0.18, 0.12], [-0.30, 0.12]]) },      // one bar, left
+  enlarge: { band: Object.freeze([[-0.34, -0.10], [0.34, -0.10], [0.34, 0.10], [-0.34, 0.10]]) },        // a long bar
+  catch:   { band: Object.freeze([[-0.10, -0.16], [0.14, -0.16], [0.14, 0.16], [-0.10, 0.16]]) },        // a block, right of centre
+  slow:    { band: Object.freeze([[-0.05, -0.17], [0.05, -0.17], [0.05, 0.17], [-0.05, 0.17]]) },        // a thin upright
+  disrupt: { band: Object.freeze([[-0.28, -0.07], [-0.10, -0.07], [-0.10, 0.07], [-0.28, 0.07]]) },      // small, far left
+  player:  { band: Object.freeze([[-0.07, -0.20], [0.07, -0.20], [0.07, 0.20], [-0.07, 0.20]]) },        // a tall bar
+});
+
+/**
+ * The board as tiles for the engine. A brick is exactly one grid cell, so a brick IS a tile -- the
+ * same reason Blockout needed no translation layer. Vaus turns red while the laser is up, so the
+ * bat itself says what it can do rather than only the HUD saying it.
+ */
+export function tiles(g) {
+  const out = [];
+  for (const k of g.bricks) {
+    // Wear is shown TWICE, on purpose: the brick lightens toward white as it nears breaking, and
+    // it also sinks. Colour is the signal the operator asked for; height carries it for anyone who
+    // cannot separate these shades, and survives a monochrome screenshot.
+    const max = k.maxHits ?? (k.kind === 'silver' ? silverHits(g.level) : 1);
+    const multi = Number.isFinite(max) && max > 1;
+    const wear = multi ? (max - Math.max(1, k.hits)) / (max - 1) : 0;   // 0 fresh .. 1 about to break
+    out.push({ txid: `b${k.id}`, x: k.x, y: k.y, s: 1,
+      tall: multi ? 1 - 0.28 * wear : 1,
+      color: damageShade(k.hits, max, k.color) });
+  }
+  // VAUS MORPHS WHEN IT IS ARMED. Stock it is a row of flat stones. With the laser it grows a
+  // cannon at each end and a raised housing between them -- the bat itself says what it can do,
+  // rather than only its colour changing.
+  const p = g.paddle;
+  const padColor = g.laser ? PADDLE_LASER_COLOR : PADDLE_COLOR;
+  const wide = Math.round(p.w);
+  for (let i = 0; i < wide; i++) {
+    const end = g.laser && (i === 0 || i === wide - 1);
+    out.push({ txid: `pad${i}`, x: p.x + i, y: PADDLE_Y, s: 1,
+      tall: g.laser ? (end ? 0.34 : 0.62) : PADDLE_H, color: padColor, paddle: true });
+  }
+  if (g.laser) {
+    for (const [n, dx] of [['l', 0.12], ['r', wide - 0.52]]) {
+      // NOT `paddle: true`. The cannons sit ON the bat; they are not segments OF it, and the flag
+      // means "this tile is a unit of Vaus's width" -- which the collision box and the tests both
+      // rely on. Flagging them made a 3-wide bat report 5 tiles wide.
+      out.push({ txid: `cannon${n}`, x: p.x + dx, y: PADDLE_Y + 0.05, s: 0.4, tall: 0.5,
+        color: '#ffd9cf', cannon: true,
+        poly: [[-0.16, -0.5], [0.16, -0.5], [0.22, 0.2], [0, 0.5], [-0.22, 0.2]], rot: 0 });
+    }
+  }
+  for (const c of g.capsules) out.push(...capsuleTiles(c));
+  for (const z of g.bolts) {
+    // the halo: a wider, softer tube around the beam, drawn as a glowing outline
+    out.push({ txid: `bolt${z.id}h`, x: z.x - 0.17, y: z.y - 0.05, s: 0.34, tall: 0.9,
+      color: BOLT_GLOW, wire: BOLT_GLOW, bolt: true });
+    // the beam itself: a hot core, also an outline so the engine never shades it down
+    out.push({ txid: `bolt${z.id}`, x: z.x - 0.07, y: z.y, s: 0.14, tall: 0.8,
+      color: BOLT_COLOR, wire: BOLT_COLOR, bolt: true });
+  }
+  for (const m of g.enemies) {
+    const spec = MINIONS[m.kind] ?? MINIONS.cone;
+    // drawn large, CENTRED on the small box it actually collides with
+    const off = (ENEMY_S - ENEMY_BOX) / 2;
+    out.push({ txid: `foe${m.id}`, x: m.x - off, y: m.y - off, s: ENEMY_S, tall: ENEMY_S,
+      color: spec.color, enemy: true, minion: m.kind,
+      poly: spec.poly, eyes: spec.eyes, rot: (m.phase + m.t * spec.spin) % (Math.PI * 2) });
+  }
+  for (let i = 0; i < g.balls.length; i++) {
+    const b = g.balls[i];
+    out.push({ txid: `ball${i}`, x: b.x - b.r, y: b.y - b.r, s: BALL_S, tall: BALL_S, color: BALL_COLOR, ball: true, sphere: true });
+  }
+  return out;
+}
+
+/** How much of the breakable wall is left, 0..1. */
+export function remaining(g) {
+  return g.breakableAtStart ? breakable(g).length / g.breakableAtStart : 0;
+}
+
+/** What Vaus is carrying, for the HUD. */
+export function powers(g) {
+  const on = [];
+  const left = (k) => Math.ceil((g.timers?.[k] ?? 0) / 1000);
+  if (g.laser) on.push(`laser ${left('laser')}s`);
+  if (g.catch) on.push(`catch ${left('catch')}s`);
+  if (g.slow) on.push(`slow ${left('slow')}s`);
+  if (g.paddle.w > PADDLE_W) on.push(`wide ${left('wide')}s`);
+  if (g.balls.length > 1) on.push(`${g.balls.length} balls`);
+  return on;
+}