Files
systemic-game-design-course/course/08-push-chains/reference/ts
Lucas WintherandClaude Fable 5.2 429137a6ef fix(reference): Death Events remember a right-hand neighbour, not a board index
A Deathrattle summon used the dying minion's board index from before the
Death Creation Step removed anything. That index is stale when a minion to
its left dies in the same step, so the token landed one place too far right.

Each Death Event now records `before`: the nearest minion to the right that
is not dying in the same step. The position handed to the effect context is
resolved when the trigger resolves: the current index of `before`, or the
right end. Applied to the Rust and TS references of Modules 3-10.

Module 3 gains two tests, documented in scenarios.md:
test_03_summon_position_after_simultaneous_deaths (fails before the fix) and
test_03_simultaneous_summons_keep_board_order.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-11 09:15:48 +01:00
..
2026-10-29 04:05:42 +01:00
2026-10-29 04:05:42 +01:00
2026-10-29 04:05:42 +01:00
2026-10-29 04:05:42 +01:00
2026-10-29 04:05:42 +01:00
2026-10-29 04:05:42 +01:00
2026-10-29 04:05:42 +01:00

Module 8 reference engine (TypeScript)

The course's own engine as of the end of Module 8. Part I's card engine is unchanged, and all of its tests still pass. The Part II engine in src/engine/puzzle/ now moves objects: each YOU object's move is planned in full, push chain and all, and only then committed. Module 7's reference was the starting point, so a diff between the two shows what this module adds.

  • cards/ (at the package root; not in this directory): Part I's card data, a copy of course/cards/ staged by tools/verify-references.mjs. Part II doesn't read it.
  • src/engine/puzzle/: the Part II engine. It names no noun: the engine's own words are the operators IS, AND, NOT, the meta-noun TEXT, the property PUSH of the base rule TEXT IS PUSH, and from Module 8 the property YOU, which picks the objects that move.
    • grid.ts: the level format, object kinds and the board. Module 8 adds Board.find, Board.remove, Board.shift, Board.at and Kind.format (the kind as placed, for kindsAt).
    • movement.ts (new): validate, then commit. Planner (tryMove, stayingAt, destroy, has), Step, Plan, Response and Dir. The planner reads the board and plans one step at a time; for each step it runs content's movement responses in order, and rolls back everything a step added if a response blocks it. The edge of the level blocks every step.
    • level.ts: a level in play. Module 8 adds Level.moveYou: the YOU objects move one at a time, furthest ahead first, each planned and then committed; the rules are reparsed once at the end. hasProperty is false for a destroyed object.
    • word.ts, parse.ts, resolve.ts: unchanged.
    • index.ts: the module's exports.
  • The rest of src/engine/: Part I, unchanged.
  • src/content/movement.ts (new) and src/content/index.ts: the movement responses, in the order the engine runs them: OPEN/SHUT, PUSH, STOP. What a property does when something moves is content, not engine.
  • src/content/words.json: Module 8 adds OPEN and SHUT.
  • src/harness.ts: the adapter the course tests call. Module 8 adds move, posOf and kindsAt on Baba.

Run it with the module's tests: node tools/verify-references.mjs 08 from the course repository.