systemic-game-design-course/course/05-assemble/reference/ts

Module 5 reference engine (TypeScript)

The course's own engine as of the end of Module 5. Every card is now data: a JSON file in the course's card format (course/schema/card.schema.json), and the functions that were card effects in Modules 2–4 are gone. One interpreter turns effects into actions. Assemble builds a new card by replacing half of one card's text with the same half of another's. Module 4'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): the card data. It is a copy of course/cards/, the single source: tools/verify-references.mjs stages it next to the package, and tools/start-module.mjs copies it into a learner's workspace.
• src/engine/: generic machinery. Names no cards.
  • card.ts: the card format as TypeScript types (CardDef, Clause, Effect, Target, Aura), and the library. Registering a definition compiles its clauses into triggers, auras and a spell's effects, and marks whether Assemble may offer it (minions with text that were not themselves assembled). TriggerOn gains endOfTurn, which card data may name (Drakkari Enchanter's aura does); the course has no turns, so nothing fires it.
  • effect.ts: the interpreter: one effect plus its context in, actions out. The only code that knows what dealDamage, draw, summon, assemble, buffHand, ... mean.
  • assemble.ts: assemble(base, donor, half) (list surgery on text at split; throws AssembleError if the text is unchanged), and the assemble effect, which asks the chooser for a base from the filtered pool, a donor and a half.
  • queue.ts: as in Module 4, plus two actions (assemble, buff). An ability's effects are interpreted and performed one at a time, in printed order.
  • world.ts: as in Module 4, plus card registration, cost, the chooser, and buff.
  • aura.ts, death.ts, event.ts: unchanged from Module 4.
• src/content/index.ts: imports every .json file in cards/ with Vite's import.meta.glob. No card is named in TypeScript any more.
• src/harness.ts: the adapter the course tests call. Module 5 adds registerCards, assemble, cost and setChooser.

Run it with the module's tests: node tools/verify-references.mjs 05 from the course repository. npm test in this directory alone fails: there is no cards/ here.