termi-kids 0.1.1 → 0.2.0

package/README.md

@@ -10,17 +10,15 @@
 
 # Termi
 
-Termi is a friendly robot that helps you build things on a real computer.
+Termi is a friendly robot that helps you build browser games on a real computer.
 
-You type what you want. Termi writes the code with you. Your game opens in the browser right away.
+You pick a game idea (or invent your own). You write a prompt, or ask Termi to help write one. Termi builds the game with you. Your game opens in the browser and updates after every prompt.
 
-You can make dodge games, platform games, pixel art, dance music, virtual pets, adventure stories, quizzes, your own web page, and talking characters. If you change your mind, type `undo` and the last change is gone. When something works, you earn badges.
+There are 30 ready game ideas plus "Build my own idea". When you finish, Termi can run a short test pass and suggest one last improvement. Games save in your local library on this computer.
 
-Termi is a computer program, an AI tool. It is not a person. A grown-up sets it up first.
-
-Not sure what to say first? Type `/quest` inside any project. Termi walks you through a real build, step by step, with a ready idea at every step. Press Enter to use it, or type your own. Finish a quest and you earn the Quest Hero badge.
+Want to get better at prompting? Open **Learn AI**. Six short lessons teach you how to boss your AI helper. Each one earns a badge, and you can replay them any time.
 
-Want to get good at building with AI? Type `termi learn`. Six short lessons teach you how to be the boss of your AI helper. Each one earns a badge, and you can replay them any time.
+Termi is a computer program, an AI tool. It is not a person. A grown-up sets it up first.
 
 Ready? Ask a grown-up to read the next part.
 
@@ -37,7 +35,7 @@ Please read [SAFETY.md](SAFETY.md) before handing the keyboard to your kid. It e
 - Node.js 20.19 or newer: https://nodejs.org
 - macOS, Windows, or Linux
 - An AI account you own (one of: a ChatGPT account, a Claude API key, an OpenAI API key, or a Grok API key)
-- About 700 MB of free disk space for the on-device safety checker (recommended, on by default)
+- About 700 MB of free disk space for the on-device safety checker (installed during setup)
 
 If Node is too old, Termi prints a plain message with the download link instead of starting.
 
@@ -51,21 +49,21 @@ npm install -g termi-kids
 
 Then run `termi`. If npm reports a permission error, prefix the install with `sudo` on macOS and Linux, or run the terminal as administrator on Windows. To remove it later, run `npm rm -g termi-kids` (full cleanup steps are in SAFETY.md).
 
+To update later, run `termi update` (or `npm install -g termi-kids@latest`). On each new session, Termi checks for a newer version and asks whether to update (y/n). Set `TERMI_SKIP_UPDATE=1` to silence the check.
+
 ### First run: the setup wizard
 
 Run `termi`. The first run starts a setup wizard for a parent or guardian. It takes about five minutes:
 
 1. **Create a grown-up PIN** (at least 4 characters). It guards the grown-up zone. Your kid should not know it.
-2. **Age band and consent.** You pick "Under 13" or "13 or older" and confirm that Termi uses an AI account you own and that you agree to watch how your kid uses it. This consent is recorded in the local safety log.
+2. **Consent.** You confirm that Termi uses an AI account you own and that you agree to watch how your kid uses it. One safety bar applies for every age (no under-13 / over-13 split). Consent is recorded in the local safety log.
 3. **Pick an AI provider.** The default is "ChatGPT sign-in": your browser opens, you sign in to your own ChatGPT account, and no API key is needed. The other options are a Claude API key, an OpenAI API key, or a Grok API key. Grok requires an extra confirmation because the xAI API terms are adults-only (details in SAFETY.md). You can add several providers and choose which one is active.
-4. **Safety checker download.** Termi offers a small safety model (623 MB) that screens every message right on your computer, even with no internet. It is on by default and worth keeping. While it downloads, Termi tells you plainly that basic safety (the local filter plus the online checks) is already running, and asks whether you want to start building now or wait and watch the progress bar. Either way, the checker turns itself on the moment the verified file lands and Termi says so, even mid-session. The download is anonymous (no account or token needed) and resumes if interrupted. Details are in [SAFETY.md](SAFETY.md).
+4. **Safety checker install.** Setup always starts the on-device safety model download (about 623 MB). It screens every message on this computer, even offline. You can wait for the progress bar or keep setting up while it finishes in the background. Basic safety is already on during the download. The download is anonymous and resumes if interrupted. Details are in [SAFETY.md](SAFETY.md).
 5. **Hand the keyboard to your kid.** The kid picks a made-up nickname (Termi asks them not to use their real name) and sees a clear disclosure: "Termi is a computer program, an AI. It is a tool a grown-up set up for you. It is not a person."
 6. **Desktop shortcut.** Termi offers to write a double-clickable launcher on the Desktop (`Termi.command` on macOS, `Termi.bat` on Windows, `Termi.desktop` on Linux) so your kid can come back tomorrow without typing commands.
-7. **Optional first game.** Two keypresses later there is a running game in the browser.
-
-If you skip the provider step, Termi runs in offline mode: your kid can still create projects, play them in the preview, undo changes, and browse ideas. The chat shows a kind "ask a grown-up to set up the AI helper" screen.
+7. **Optional first game.** The kid can jump straight into **Build a game** (pick an idea or invent one).
 
-**If your kid does not know where to start:** every project type has a Build Quest (`/quest` in the chat), a five-step guided build with a ready prompt at each step, and a large idea deck (`/ideas`). Quest steps go through the same safety pipeline as any other message.
+If you skip the provider step, Termi runs in offline mode: your kid can still open the library and Learn AI. Building with the AI helper needs a provider.
 
 ### What keeps your kid safe
 
@@ -85,13 +83,13 @@ Parents get a PIN-gated grown-up zone, a tamper-evident log of every block and s
 
 | Command | What it does |
 |---|---|
-| `termi` | First run: setup wizard. After that: the home menu. |
-| `termi new` | Start a new project. |
-| `termi go [name]` | Open a project and build. With no name, pick from a list. |
-| `termi preview [name]` | Open a project in the browser without the chat. |
-| `termi ideas` | Print fun project ideas. |
-| `termi learn` | Six short, replayable lessons on building with AI. Fully offline, no AI calls. |
+| `termi` | First run: setup wizard. After that: home (Build a game, My games, Learn AI). |
+| `termi new` | Build a game (idea list + prompt loop). |
+| `termi go [name]` | Open a game from your library. With no name, pick from a list. |
+| `termi preview [name]` | Open a game in the browser without the chat. |
+| `termi learn` | Learn AI: six short offline lessons on prompting. |
 | `termi grownups` | The grown-up zone. PIN required. |
+| `termi update` | Update Termi to the latest npm version. |
 | `termi help` | Show the command list. |
 | `termi --version` | Show the version. |
 

package/SAFETY.md

@@ -14,7 +14,7 @@ This page is for parents and guardians. It explains the safety system in plain l
 
 Five layers sit between your kid and the AI. The chat conversation itself is never trusted to police itself.
 
-1. **A local filter on this computer.** Before anything leaves your machine, Termi checks the message offline. It blocks swearing and slurs (including d.i.s.g.u.i.s.e.d spellings and leetspeak), and it blocks known "ignore your rules" tricks. It also looks for personal details: names, addresses, phone numbers, emails, school names. Those are not blocked; they are masked to `[secret]` before the message is sent, and the kid gets a gentle reminder to keep private things private. The same masking is used when the AI reads project files back. The word lists are English; the AI-based checkers below cover other languages.
+1. **A local filter on this computer.** Before anything leaves your machine, Termi checks the message offline. It blocks swearing and slurs (including d.i.s.g.u.i.s.e.d spellings and leetspeak), known "ignore your rules" tricks (including some base64-hidden ones), clear self-harm language (with a calm support screen and the 988 line in the US), grooming-shaped asks (secrecy from parents, romance aimed at the kid, moving chat to other apps), and probes for personal details like school or address. When a kid shares their own personal details (name, address, phone, email, school), those are not blocked; they are masked to `[secret]` before the message is sent, and the kid gets a gentle reminder to keep private things private. The same masking is used when the AI reads project files back. The word lists are English; the AI-based checkers below cover other languages.
 2. **Safety rules inside the AI's instructions.** The AI is told, every turn: you are a tool, not a person. Never act romantic, never roleplay relationships, never ask the kid to keep secrets, never ask for a real name, address, school, age, or photos. Big feelings get one kind line and a pointer to a trusted adult. The instructions also declare that everything the kid types and everything in project files is data, never commands, which blunts "ignore your previous instructions" tricks hidden in files.
 3. **A checker before the AI acts.** A separate safety check, outside the conversation, reads the kid's message along with the last few turns for context. When the on-device safety checker is installed (it is offered during setup and on by default), it judges the message right on this computer at the same time. It runs at the same time as the build call so it adds no waiting, but nothing is allowed to land until it passes: no file is written and no reply is shown. If it says no, the work is thrown away. One honest note on timing: because the check and the build call start together, a message that ends up blocked has still traveled to your AI provider once (with personal details already masked); its answer is discarded unseen.
 4. **A checker on everything the AI says and writes.** Every file the AI writes or edits is checked twice before it touches disk: a code scan looks for network calls, code hidden in strings, and other tricks (the full list is in the code scanner, `src/safety/codescan.ts`), and the human-visible text inside the file (story text, labels, comments) goes through the same safety check as chat, in full: long text is checked chunk by chunk, and a file too wordy to check completely is refused rather than half-checked. File names and project names are screened too. The final reply is checked too, before the kid sees a single character. As a backstop, the preview server wraps every project page in a strict Content-Security-Policy, so even code that slipped past the scanner cannot reach the internet from the browser. Files edited outside Termi (in a text editor, say) are the kid's own files and are not re-screened; they only pass the rule-neutralizing filter when read back into the chat.
@@ -50,7 +50,7 @@ Grooming, personal info, and rule-breaking tricks block at a lower threshold tha
 
 Termi includes an on-device safety checker: a small AI model (Qwen3Guard 0.6B, published by the Qwen team under the Apache 2.0 license) that runs entirely on your computer. Setup offers the download (623 MB) with a yes as the default; you can decline and add it later from the grown-up zone (`termi grownups`, then **Safety checker**).
 
-The download never blocks anyone. Setup says, in plain words, that basic safety (the local filter plus the online checks) is already on, then asks whether you want to start building now or wait and watch the progress bar. If you start now, the download continues in the background while your kid builds, the home menu shows its bar, and the checker attaches itself to the running safety pipeline the moment the verified file is in place; Termi announces it on screen ("Your safety helper is on."), even in the middle of a build session. If the download is interrupted (a closed laptop, a dropped connection), it resumes from where it stopped the next time Termi starts. Until the file lands, the online checks carry the load exactly as they would with the checker turned off.
+Setup always starts the download (it is part of install, not an easy skip). Setup says, in plain words, that basic safety (the local filter plus the online checks) is already on, then asks whether you want to wait and watch the progress bar or keep setting up while it finishes. Either way the download continues, the home menu can show its bar, and the checker attaches itself to the running safety pipeline the moment the verified file is in place; Termi announces it on screen ("Your safety helper is on."), even in the middle of a build session. If the download is interrupted (a closed laptop, a dropped connection), it resumes from where it stopped the next time Termi starts. Until the file lands, the online checks carry the load.
 
 The download itself is anonymous. The model file comes over HTTPS from a public model repository, with no account, sign-in, or token of any kind; nothing about you or your kid is sent with the request, and the file is checked against a pinned cryptographic fingerprint before it is used.
 

package/dist/cli.js

@@ -19,7 +19,6 @@ import { installGlobalHandlers, renderCrash } from './ui/errors.js';
 import { mascot } from './ui/mascot.js';
 import { style } from './ui/theme.js';
 import { T } from './ui/text.js';
-import { executeIdeas } from './surfaces/commands.js';
 /** Pure boot branch logic: settings state in, actions out. */
 export function decideBoot(state) {
     return {
@@ -32,12 +31,12 @@ export function cliHelp() {
     return [
         'How to use Termi:',
         '  termi            open the home menu',
-        '  termi new        start a new project',
-        '  termi go [name]  open a project and build',
-        '  termi preview    watch a project run',
-        '  termi ideas      get fun ideas',
-        '  termi learn      play six short lessons about AI',
+        '  termi new        build a game',
+        '  termi go [name]  open a game from your library',
+        '  termi preview    watch a game run',
+        '  termi learn      Learn AI (prompting lessons)',
         '  termi grownups   grown-up zone (PIN needed)',
+        '  termi update     update Termi to the latest version',
         '  termi help       show this help',
         '  termi --version  show the version',
     ].join('\n');
@@ -123,24 +122,6 @@ async function routePreview(nameArg, settings) {
         // Held open on purpose; Ctrl+C ends it through the global handler.
     });
 }
-async function routeIdeas(settings) {
-    let scaffoldId = 'games';
-    if (settings.lastProjectSlug !== null) {
-        try {
-            const store = await import('./projects/store.js');
-            const last = store.openProject(settings.lastProjectSlug);
-            if (last !== null) {
-                scaffoldId = last.meta.scaffoldId;
-            }
-        }
-        catch {
-            // Fall back to game ideas.
-        }
-    }
-    await executeIdeas(scaffoldId, (text) => {
-        console.log(text);
-    });
-}
 async function route(command, rest, settings) {
     const home = await import('./surfaces/home.js');
     switch (command) {
@@ -149,10 +130,8 @@ async function route(command, rest, settings) {
             return;
         }
         case 'new': {
-            const project = await home.runNewProject(settings);
-            if (project !== null) {
-                await home.openChatLoop(project, settings);
-            }
+            const build = await import('./surfaces/buildGame.js');
+            await build.runBuildGame(settings);
             return;
         }
         case 'go': {
@@ -167,7 +146,9 @@ async function route(command, rest, settings) {
             return;
         }
         case 'ideas': {
-            await routeIdeas(settings);
+            // Ideas live inside Build a game now.
+            const build = await import('./surfaces/buildGame.js');
+            await build.runBuildGame(settings);
             return;
         }
         case 'learn': {
@@ -180,6 +161,11 @@ async function route(command, rest, settings) {
             await panel.runPanel();
             return;
         }
+        case 'update': {
+            const update = await import('./update/prompt.js');
+            await update.runUpdateCommand();
+            return;
+        }
         default: {
             console.log(`Hmm, "${command}" is not a Termi command.`);
             console.log(cliHelp());
@@ -198,6 +184,13 @@ export async function main(argv = process.argv.slice(2)) {
         console.log(cliHelp());
         return;
     }
+    // Update works without the wizard so a parent can refresh a broken install.
+    if (command === 'update') {
+        ensureDirs();
+        const update = await import('./update/prompt.js');
+        await update.runUpdateCommand();
+        return;
+    }
     ensureDirs();
     const loaded = loadSettings();
     let settings = loaded.settings;
@@ -243,6 +236,17 @@ export async function main(argv = process.argv.slice(2)) {
         const { ensureGuardFetch } = await import('./safety/guarddownload.js');
         void ensureGuardFetch();
     }
+    // Returning sessions: offer an update when npm has a newer version.
+    // Skipped during setup, tests, and TERMI_SKIP_UPDATE=1.
+    if (!decision.runWizard) {
+        try {
+            const update = await import('./update/prompt.js');
+            await update.maybePromptForUpdate();
+        }
+        catch {
+            // Never block boot on the update check.
+        }
+    }
     await route(command, argv.slice(1), settings);
 }
 const underTest = process.env.VITEST !== undefined || process.env.NODE_ENV === 'test';

package/dist/learn/runner.js

@@ -164,7 +164,7 @@ export async function runLesson(lesson, say = defaultSay) {
  */
 export async function runLearnMenu() {
     console.log(mascot('happy'));
-    console.log('Welcome to Termi school! Six tiny lessons, zero homework.');
+    console.log('Learn AI: six tiny lessons on how to prompt. Zero homework.');
     for (;;) {
         const done = new Set(loadProgress().completed);
         const options = [

package/dist/projects/blankGame.js

@@ -0,0 +1,100 @@
+/**
+ * Minimal blank game project: no stock playable game, just a local HTML
+ * shell the model fills in. Used by the Build a game flow.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { projectsDir } from '../config/paths.js';
+import { slugifyName } from './create.js';
+import { notesFileName, openProject, renderTermiMd, saveProjectMeta, } from './store.js';
+const BLANK_HTML = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>__TITLE__</title>
+  <link rel="stylesheet" href="style.css" />
+</head>
+<body>
+  <main>
+    <h1 id="title">__TITLE__</h1>
+    <p id="hint">Your game will show up here after you build with Termi.</p>
+    <canvas id="game" width="480" height="320" aria-label="game"></canvas>
+  </main>
+  <script src="game.js"></script>
+</body>
+</html>
+`;
+const BLANK_CSS = `* { box-sizing: border-box; }
+body {
+  margin: 0;
+  font-family: system-ui, sans-serif;
+  background: #0f172a;
+  color: #e2e8f0;
+  min-height: 100vh;
+  display: grid;
+  place-items: center;
+}
+main { text-align: center; padding: 1rem; }
+h1 { font-size: 1.4rem; margin: 0 0 0.5rem; }
+#hint { opacity: 0.8; margin-bottom: 1rem; }
+canvas {
+  background: #1e293b;
+  border: 2px solid #38bdf8;
+  border-radius: 12px;
+  max-width: 100%;
+}
+`;
+const BLANK_JS = `// Blank starter. Termi and the kid fill this in.
+const canvas = document.getElementById('game');
+const ctx = canvas.getContext('2d');
+function frame() {
+  ctx.fillStyle = '#1e293b';
+  ctx.fillRect(0, 0, canvas.width, canvas.height);
+  ctx.fillStyle = '#94a3b8';
+  ctx.font = '16px system-ui, sans-serif';
+  ctx.textAlign = 'center';
+  ctx.fillText('Ready to build!', canvas.width / 2, canvas.height / 2);
+}
+frame();
+`;
+function writeRel(dir, relPath, content) {
+    const target = path.join(dir, ...relPath.split('/'));
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, content, 'utf8');
+}
+/**
+ * Creates an empty local-browser game shell under the projects library.
+ * scaffoldId stays "games" so existing badges and quests still recognize it.
+ */
+export function createBlankGameProject(prettyNameInput, ideaLabel = 'My game') {
+    const trimmed = prettyNameInput.trim();
+    const prettyName = trimmed.length > 0 ? trimmed : 'My Game';
+    const { slug } = slugifyName(prettyName);
+    const dir = path.join(projectsDir(), slug);
+    fs.mkdirSync(dir, { recursive: true });
+    const html = BLANK_HTML.replaceAll('__TITLE__', prettyName);
+    writeRel(dir, 'index.html', html);
+    writeRel(dir, 'style.css', BLANK_CSS);
+    writeRel(dir, 'game.js', BLANK_JS);
+    writeRel(dir, notesFileName, renderTermiMd(prettyName, {
+        whatThisIs: `A browser game: ${ideaLabel}. Built with Termi.`,
+        files: ['index.html', 'style.css', 'game.js'],
+        builtSoFar: ['Blank game shell ready for the first prompt'],
+        recapLine: `We started ${prettyName}.`,
+    }));
+    const now = new Date().toISOString();
+    saveProjectMeta({
+        slug,
+        prettyName,
+        scaffoldId: 'games',
+        themeId: 'blank',
+        createdAt: now,
+        lastOpenedAt: now,
+    });
+    const project = openProject(slug);
+    if (project === null) {
+        throw new Error('Something went wrong while making the project. Try again.');
+    }
+    return project;
+}

package/dist/projects/gameIdeas.js

@@ -0,0 +1,216 @@
+/**
+ * Kid-facing Build-a-game idea bank.
+ *
+ * Exactly 31 entries: "Build my own idea" first, then 30 browser HTML games.
+ * Every idea is local-preview only (HTML/CSS/JS), no image generation, no
+ * native installs. Pure data for tests and the Build a game menu.
+ */
+/** True for the custom entry that asks the kid for their own concept. */
+export function isOwnIdea(idea) {
+    return idea.id === 'own';
+}
+/**
+ * Menu order is fixed. First entry is always Build my own idea.
+ * The remaining 30 are distinct local-browser game concepts.
+ */
+export const GAME_IDEAS = [
+    {
+        id: 'own',
+        label: 'Build my own idea',
+        blurb: 'You invent the game. Termi helps you build it.',
+        seedPrompt: '',
+    },
+    {
+        id: 'dodge-rain',
+        label: 'Dodge the rain',
+        blurb: 'Move left and right. Catch drops or dodge them.',
+        seedPrompt: 'Make a simple canvas game where I move left and right to dodge falling rain drops. Add a score and a restart key.',
+    },
+    {
+        id: 'catch-stars',
+        label: 'Catch the stars',
+        blurb: 'Catch falling stars before they hit the ground.',
+        seedPrompt: 'Make a canvas catch game. Stars fall from the top. I move a basket to catch them. Show the score and lives.',
+    },
+    {
+        id: 'memory-cards',
+        label: 'Memory cards',
+        blurb: 'Flip cards and match pairs.',
+        seedPrompt: 'Make a memory match card game with 12 cards (6 pairs) using emoji. Click to flip. Count moves. Show a win message.',
+    },
+    {
+        id: 'click-targets',
+        label: 'Click the targets',
+        blurb: 'Click circles before they vanish.',
+        seedPrompt: 'Make a click target game. Circles appear for a short time. Click them for points. Add a 30 second timer and a final score.',
+    },
+    {
+        id: 'maze-escape',
+        label: 'Maze escape',
+        blurb: 'Find the exit in a simple maze.',
+        seedPrompt: 'Make a keyboard maze game on a canvas grid. Arrow keys move a square. Reach the green exit. Keep walls solid.',
+    },
+    {
+        id: 'snake-lite',
+        label: 'Snake lite',
+        blurb: 'Grow a snake by eating dots.',
+        seedPrompt: 'Make a simple snake game on a grid. Arrow keys move. Eat food to grow. Hitting a wall or yourself restarts.',
+    },
+    {
+        id: 'pong-solo',
+        label: 'Pong solo',
+        blurb: 'Bounce a ball with one paddle.',
+        seedPrompt: 'Make a one player pong game. Move the paddle with the mouse or arrows. Ball bounces. Score points. Restart on miss.',
+    },
+    {
+        id: 'whack-moles',
+        label: 'Whack a mole',
+        blurb: 'Tap moles as they pop up.',
+        seedPrompt: 'Make a whack a mole game with a 3 by 3 grid of holes. Moles pop up briefly. Click them for points. Add a timer.',
+    },
+    {
+        id: 'color-match',
+        label: 'Color match',
+        blurb: 'Match the word color to the right button.',
+        seedPrompt: 'Make a color word game. Show a color name in a random ink color. Kid clicks the button that matches the WORD meaning. Score streaks.',
+    },
+    {
+        id: 'typing-race',
+        label: 'Typing race',
+        blurb: 'Type the word before time runs out.',
+        seedPrompt: 'Make a typing race. Show a simple word. Kid types it and presses Enter. Track speed and accuracy for 10 words.',
+    },
+    {
+        id: 'platform-jump',
+        label: 'Platform jumper',
+        blurb: 'Jump across platforms to the flag.',
+        seedPrompt: 'Make a side view platformer on canvas. Arrow keys move and jump. Reach a flag on the right. Simple gravity and platforms.',
+    },
+    {
+        id: 'balloon-pop',
+        label: 'Balloon pop',
+        blurb: 'Pop balloons before they float away.',
+        seedPrompt: 'Make a balloon pop game. Balloons float up. Click to pop them. Missed balloons cost a life. Show score.',
+    },
+    {
+        id: 'quiz-sprint',
+        label: 'Quiz sprint',
+        blurb: 'Answer fun multiple choice questions.',
+        seedPrompt: 'Make a 5 question multiple choice quiz about animals. Show score at the end. Use big clear buttons.',
+    },
+    {
+        id: 'simon-says',
+        label: 'Simon says lights',
+        blurb: 'Repeat the light pattern.',
+        seedPrompt: 'Make a Simon style memory game with 4 colored buttons. Play a growing pattern. Kid repeats it. Score the longest streak.',
+    },
+    {
+        id: 'rock-paper',
+        label: 'Rock paper scissors',
+        blurb: 'Play against the computer. Pick rock, paper, or scissors.',
+        seedPrompt: 'Make rock paper scissors with three big buttons. Computer picks at random. Track wins, losses, and ties.',
+    },
+    {
+        id: 'number-guess',
+        label: 'Number guess',
+        blurb: 'Guess the secret number.',
+        seedPrompt: 'Make a number guess game from 1 to 50. Kid types a guess. Say higher or lower. Count tries until they win.',
+    },
+    {
+        id: 'breakout-lite',
+        label: 'Breakout lite',
+        blurb: 'Bounce a ball to break bricks.',
+        seedPrompt: 'Make a simple breakout game. Paddle at the bottom, ball, and one row of bricks. Clear the bricks to win.',
+    },
+    {
+        id: 'flappy-lite',
+        label: 'Flappy lite',
+        blurb: 'Tap to flap between gaps.',
+        seedPrompt: 'Make a flappy style game. Space or click flaps up. Gravity pulls down. Fly through gaps in pipes. Score each pipe.',
+    },
+    {
+        id: 'tic-tac-toe',
+        label: 'Tic tac toe',
+        blurb: 'Play X and O on a 3 by 3 board.',
+        seedPrompt: 'Make tic tac toe for two players on one keyboard. Click cells. Detect win and draw. Add a new game button.',
+    },
+    {
+        id: 'collect-coins',
+        label: 'Collect coins',
+        blurb: 'Run around and grab all the coins.',
+        seedPrompt: 'Make a top down collect game. Arrow keys move a player. Coins sit on a small map. Collect all coins to win.',
+    },
+    {
+        id: 'avoid-cars',
+        label: 'Avoid the cars',
+        blurb: 'Cross the road safely.',
+        seedPrompt: 'Make a cross the road game. Player moves up. Cars move left and right. Reach the top without hitting a car.',
+    },
+    {
+        id: 'reaction-test',
+        label: 'Reaction test',
+        blurb: 'Click when the screen turns green.',
+        seedPrompt: 'Make a reaction time test. Screen starts red, then turns green after a random wait. Click as fast as you can. Show ms time.',
+    },
+    {
+        id: 'word-scramble',
+        label: 'Word scramble',
+        blurb: 'Unscramble the letters.',
+        seedPrompt: 'Make a word scramble game with 8 easy words. Show mixed letters. Kid types the word. Track score out of 8.',
+    },
+    {
+        id: 'tower-stack',
+        label: 'Tower stack',
+        blurb: 'Stack blocks as high as you can.',
+        seedPrompt: 'Make a stack game. A block slides left and right. Click or press space to drop it. Stack as high as you can without missing.',
+    },
+    {
+        id: 'balloon-math',
+        label: 'Balloon math',
+        blurb: 'Pop the balloon with the right answer.',
+        seedPrompt: 'Make a math balloon game. Show a simple add or subtract problem. Three balloons show answers. Click the correct one.',
+    },
+    {
+        id: 'day-night',
+        label: 'Day and night runner',
+        blurb: 'Run while the world switches day and night.',
+        seedPrompt: 'Make a runner where the player auto runs right. Jump over rocks. Every 10 seconds switch day and night colors. Track distance.',
+    },
+    {
+        id: 'fruit-slice',
+        label: 'Fruit slice',
+        blurb: 'Swipe or click fruit, avoid bombs.',
+        seedPrompt: 'Make a fruit slice style game. Fruit flies up. Click fruit for points. Clicking a bomb ends the round. Show score.',
+    },
+    {
+        id: 'hide-seek',
+        label: 'Hide and seek dots',
+        blurb: 'Find the odd color in the crowd.',
+        seedPrompt: 'Make a find the odd one out game. Show many colored dots. One is a slightly different color. Click it. Levels get harder.',
+    },
+    {
+        id: 'space-lander',
+        label: 'Soft lander',
+        blurb: 'Land the ship gently on the pad.',
+        seedPrompt: 'Make a lander game. Ship falls with gravity. Arrow keys thrust and steer. Land softly on a pad. Crash if too fast.',
+    },
+    {
+        id: 'story-choice',
+        label: 'Choice adventure',
+        blurb: 'A short story with choices you click.',
+        seedPrompt: 'Make a short click adventure with 4 scenes. Each scene has text and 2 choice buttons. End with a happy finish screen.',
+    },
+];
+/** Exactly one own-idea entry plus 30 game ideas. */
+export const GAME_IDEA_COUNT = GAME_IDEAS.length;
+/** Menu options for selects: value is idea id. */
+export function gameIdeaMenuOptions() {
+    return GAME_IDEAS.map((idea) => ({
+        value: idea.id,
+        label: idea.label,
+        hint: idea.blurb,
+    }));
+}
+export function gameIdeaById(id) {
+    return GAME_IDEAS.find((idea) => idea.id === id);
+}