Worksheets registry
Per-game audit log · which PlayMemorize games print as worksheets, which don't, and the documented reasoning for each.
WORKSHEET_DECISIONS in
src/lib/worksheets/registry.ts. The verify category W
fails the build if any game in GAME_MODULES is missing a decision,
has an empty reason, or has wiring that disagrees with its decision. This
page can never silently drift from the source.
Supports worksheets
These games can be printed as paper worksheets. Tier 1 = the worksheet IS the game (pure text-based). Tier 2 = the worksheet is a lossy text fallback that still teaches the underlying skill.
analogies Tier 1 "A is to B as C is to ?" reasoning prompts. Pure text. Worksheet renders the analogy stem with multiple-choice completions. Standard SAT/aptitude-test format teachers already know.
backwards Tier 1 Word-spelled-backwards recognition. Worksheet shows the reversed word and asks student to write the forward spelling. Pure text.
define Tier 1 Vocabulary definitions. Pure text: "Define WORD" + 3 multiple-choice definitions. Localised word lists already exist for all 25 locales. Classic homework/SAT-prep format.
didyouknow Tier 1 Merged cloze-fact hub (useful facts, fun facts, how-it-works). All three topic slices produce a sentence with one word blanked and N multiple-choice options. Pure text; the stencil delegates to each sub-topic's buildClozeRound() so the printed answer key matches the live game exactly. Localised in all 25 locales.
example Tier 1 The canonical copy-target game. Each round is "pick the largest of N numbers" · pure numerals with one correct choice, so it prints to paper with a clean answer key and no loss.
facts Tier 1 True/false statements about facts. Most compact worksheet shape (80+ problems per page). Pure text statements.
emotions Tier 1 Plutchik Wheel emotion-combination questions are pure text: "Which two primary emotions combine to form Love?" with four multiple-choice answers. Worksheet format mirrors common emotional-intelligence exercises used in school counseling and psychology curricula.
history Tier 1 All three modes (year / actor / deed) are multiple-choice text trivia that print cleanly. The stencil reuses the live round builder (same same-era distractors), so the printed question and answer key match what the game shows on screen.
math Tier 1 Arithmetic problems are pure text. Difficulty 1-3 = +/- max 10, 4-6 adds multiplication, 7-10 adds division. Worksheet renders "a OP b = ?" with multiple-choice answers. Core teacher demand (Swedish elementary curriculum).
name-rarity Tier 1 Pick the rarer of two US first names · the live game is already a two-name duel, so the worksheet is a faithful two-choice question (only two answers) with the rarer name as the key. Prints cleanly as pure text.
polyglot Tier 1 Foreign-language word translation. Pure text: source word + multiple-choice translations. Word lists localised across 25 locales via the shared emoji data set.
proverbs Tier 1 Complete-the-saying cloze · the saying prints with one word blanked and the student picks the missing word from multiple choice. The stencil pins word mode so every printed proverb is fill-in-the-blank regardless of difficulty.
riddles Tier 1 Lateral-thinking riddles with multiple-choice answers. Each riddle is self-contained text; worksheet preserves the full puzzle without loss. Localised in all 25 locales via riddles-data.
sequences Tier 1 "What comes next?" sequences (arithmetic, geometric, Fibonacci). Pure text; worksheet renders the visible terms followed by ? and multiple-choice answers. Excellent for pattern-recognition drills.
whichphilosophy Tier 1 Statement + multiple-choice philosophy label · pure text shape, prints cleanly with answer key.
chessmate Tier 2 Prints the mate-in-one position as a board diagram (letter-discs, B/W-print safe) and asks WHERE the marked piece moves to deliver checkmate. Answer choices are board squares (e.g. "D4"), not abstract A/B/C/D values · the student reads the diagram and names the square.
estimation Tier 2 Merged estimation hub. The comparisons topic (which is heavier?) is pure text and prints cleanly with multiple-choice options. The products topic uses a numeric free-input UI that cannot be reduced to multiple-choice without losing the estimation skill. The volumes topic is visual-only. Stencil renders the comparisons sub-topic only.
finnfemfel Tier 2 Prints two small (4 by 4) coordinate-labelled emoji grids with one cell changed; the student finds the differing square and names it (e.g. "C2") from multiple choice. A smaller mini-game version of the screen game, which runs up to 500 cells.
geo Tier 2 Country/capital trivia. Worksheet renders text-only quiz form: "What is the capital of X?" + multiple choice. Loses the map visual but keeps the recall-of-facts drill. Strong curriculum tie-in.
ordering Tier 2 Mini-game version · the items print numbered in a scrambled order and the student picks the numbered SEQUENCE that lists them in the correct order (oldest-to-newest / smallest-to-largest / by rank). Keeps the full-ordering skill, not just "which is first", on paper.
sudokuforce Tier 2 Prints a real 9×9 grid with one target cell marked, student picks the forced digit. Starts from the solved board but hides the target plus a spread of its peers · one clue per other digit across the row, column and box · so the answer is forced yet not a give-away: the solver must combine all three units, not read one near-complete row. Tier 2 because the timed solver is the richer experience, but the grid stands alone.
wheresmempi Tier 2 Prints a smaller (~30-cell) coordinate-labelled grid with MemPi hidden among emoji decoys; the student finds him and names his square (e.g. "C2") from multiple choice. The visual search survives on paper once the grid shrinks from the screen game's hundreds of cells.
Not suitable for worksheets
These games stay in-browser by design. The visual, audio, hidden-state, or meta nature of the game cannot survive printing without losing the entire learning outcome. Each carries the developer's documented reasoning.
music audio Merged music trainer · tones (random sequence playback) and songs (melody learning). Audio-only · cannot be represented on paper.
polymath-knowledge Polymath gauntlet host that dispatches into Geo + Facts + Define. Worksheets are generated per-game.
polymath-math Polymath gauntlet host that dispatches into Math + Sequences + Convert. Worksheets are generated per-game; the gauntlet has no standalone worksheet form (use the constituent games instead).
polymath-memory Polymath gauntlet host that dispatches into Memory + Ghost + Pi. Worksheets are generated per-game.
all "All games" hub page; not a single-round mini-game.
polymath-reasoning Polymath gauntlet host that dispatches into Sequences + Analogies + Riddles. Worksheets are generated per-game.
minesweeperflag reasoning Minesweeper-style deduction on a hidden grid. Hidden-state mechanic cannot survive printing (every cell would be revealed at print time).
hash reasoning Logic black-box deduction · the probe-and-deduce loop is the experience, no paper analogue.
logic-puzzles reasoning Grid constraint puzzle hub (Akari, Shikaku, Nurikabe, Slitherlink, Bridges, Infinity Loop). Individual pencil-and-paper puzzles could in principle print, but the hub mixes visual-only (Infinity Loop) with pen-and-paper classics. Hold pending a per-puzzle stencil split.
masterminddeduce reasoning Mastermind code-deduction. Hidden code + interactive guess feedback IS the game; cannot be linearised onto paper without revealing the answer.
rubiks reasoning Rubik's Cube notation quiz. The quiz is text-based but the interactive 3D cube is the primary learning tool; a paper version loses the hands-on rotation feedback that makes it educational.
schedule-conflict reasoning Constraint tables can be printable later; excluded until the worksheet engine has table layouts.
hanoi reasoning Excluded from worksheets · the printed form collapsed to repetitive "minimum moves = 2^n - 1" multiple-choice questions with near-identical numeric decoys, drilling the formula by rote rather than the disk-moving skill the game teaches.
card-count text Tempo and hiding previous values are the skill; paper would become ordinary arithmetic.
fractions-faster text Good worksheet candidate, but excluded until the fraction-comparison stencil prints cross-multiplication explanations.
country text Three-fact incremental reveal · the reveal pacing is core to scoring.
hangman text Hangman needs turn-by-turn wrong-letter state and a live strike counter. On paper it becomes a word-list answer reveal rather than the game, so worksheets exclude it intentionally per user request 2026-05.
headsofstate text Heads-of-state quiz · supportable, design pass pending.
multi-tasker text The core challenge is simultaneous timing and reaction; static paper removes the second task.
periodic text Periodic table drill · the colour palette is part of recall, hold for now.
prime-time text Good worksheet candidate, but excluded until the prime/composite stencil is added with factor answer explanations.
redday text Holiday matching · supportable but pending design pass on the filter chip on paper.
trig text Trig drill with exact symbolic values; a stencil would work but needs design pass.
wordsquare text Anagram-pool puzzle · the entry interface is the game, not portable to paper.
wordle text Mini-game variant is "fill in the missing letter" - printable in principle, but the stencil renderer for the dashed-tile layout is still pending design.
bubblewrap visual Pure speed/tapping toy · the whole game is the timed pop-the-sheet interaction, which has no paper analogue.
catchthecat visual Interactive containment puzzle · the cat reacts to each cell you block, so a printed board is either a single fixed position (trivial) or cannot represent the turn-by-turn play.
circlepuzzle visual Rotate-the-rings alignment toy · the whole game is the tap-to-turn interaction and its move budget, which has no paper analogue (a static diagram would just give the answer away).
eras visual Era classification of paintings · the paintings are essential, paper version pending.
color visual Colour-sequence memorisation (Simon-style). Cannot represent colour sequences and timed playback on paper without losing the entire mechanic.
crocodile visual Pure-suspense toy · the trap tooth is randomised and only revealed by tapping; a printed sheet would either spoil the trap or be unsolvable.
cups visual Follow-the-ball shell game · the answer depends on a live shuffle animation you must track; a printed sheet either shows the final position (no challenge) or cannot convey the motion (unsolvable).
finance visual Merged finance trainer · candlestick chart recognition, options Greeks scenarios, stock valuation, compound interest, and probability. Mixed visual + text shape; hold pending a design pass on the rendered worksheet layout.
chain-logic visual Merged cause-effect hub (gear trains, logic circuits). Both sub-topics require diagrams (gear meshes, truth tables) that the worksheet renderer cannot yet draw. Hold pending print renderer support.
ghost visual "Which emoji disappeared?" depends on timed visual disappearance animation, which paper cannot reproduce. Static printed grid would simply mark the missing item and remove the memorisation challenge entirely. Excluded per user request 2026-05.
laser-bounce visual Requires grid ray-tracing diagrams; excluded until print renderer can draw beams and mirrors.
memory visual Card-matching memory game. The face-down card → reveal → match mechanic IS the game. Static text descriptions defeat the purpose (no surprise reveal, no working-memory load). Players already see the answers in the worksheet preview.
mirror-symmetry visual Possible later, but current worksheet renderer does not preserve precise mirrored pixel/emoji grids.
mosaic visual Pixel-art completion. Requires precise grid-cell rendering and the "see what it becomes" reveal moment.
nuance visual Distinguish very-close shades of colour. Printer reproduction and B/W photocopying lose the colour distance the puzzle hinges on; the browser version is sub-pixel-precise and has no faithful paper analogue.
pathfinder visual The skill is remembering a path before a rotation; paper output would show both states at once and remove the memory step.
patterns visual Merged pattern-recognition hub (matrix, odd-one-out, rule-induction). Matrix and rule-induction are visual-grid tasks that cannot be textified; odd-one-out could in principle be text-only but the merged surface cannot cleanly separate sub-topics for the worksheet renderer. Hold pending design pass.
pi visual Memorise digits of Pi. The single-correct-answer-string format and the in-game numpad + audio feedback are the entire learning loop; a paper "next digit?" sheet is just a digit lookup table.
scratchcard visual Pure-luck reveal toy · the cards are hidden under foil and only uncovered by tapping; a printed sheet would either spoil every cell or be unsolvable.
silhouette visual The whole puzzle is recognising a colour emoji flattened to a black silhouette via filter:brightness(0). Print/PDF engines (notably iOS) do not apply that CSS filter to colour-emoji glyphs, so the printed sheet leaks the full-colour emoji and gives the answer away. Skipped until a print-safe silhouette renderer exists.
spatial-reasoning visual Merged spatial hub (mental rotation, net folding, shadow projection). All three sub-topics are visual spatial reasoning tasks; none can be reduced to printable text without losing the trained skill entirely.
stroop visual Stroop interference (colour word vs. ink colour). The interference effect requires the word and its ink colour to differ - printing in colour is unreliable, B/W loses the test entirely.
whackamole visual Pure timed-reaction toy · the moles appear and vanish on a real-time schedule, so there is nothing a printed sheet could ask a student to do.
whomade visual Merged creator-recognition hub (art/literature/music). Art renders the actual painting on a canvas, music plays the melody on a piano · both are irreducible to paper. The literature topic is text-compatible but cannot ship separately as a worksheet sub-topic without a dedicated design pass.
Adding a new game?
Every new game in GAME_MODULES must be added here too · the
verify rule W-01 blocks the build otherwise. See the full
workflow in ADDING_A_GAME.md §5f.
