npm - termi-kids - Versions diffs - 0.1.0 - Mend

termi-kids 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (64) hide show

package/LICENSE +34 -0
package/README.md +148 -0
package/SAFETY.md +187 -0
package/bin/termi.js +22 -0
package/dist/agent/context.js +126 -0
package/dist/agent/loop.js +172 -0
package/dist/agent/prompts/system.js +45 -0
package/dist/agent/tools.js +335 -0
package/dist/auth/keychain.js +146 -0
package/dist/auth/oauth.js +375 -0
package/dist/auth/tokens.js +219 -0
package/dist/cli.js +258 -0
package/dist/config/paths.js +92 -0
package/dist/config/pin.js +150 -0
package/dist/config/settings.js +131 -0
package/dist/grownups/panel.js +483 -0
package/dist/learn/lessons.js +490 -0
package/dist/learn/runner.js +193 -0
package/dist/preview/server.js +407 -0
package/dist/projects/create.js +103 -0
package/dist/projects/ideas.js +182 -0
package/dist/projects/quests.js +277 -0
package/dist/projects/scaffolds/art.js +484 -0
package/dist/projects/scaffolds/biggames.js +554 -0
package/dist/projects/scaffolds/characters.js +580 -0
package/dist/projects/scaffolds/games.js +516 -0
package/dist/projects/scaffolds/index.js +24 -0
package/dist/projects/scaffolds/music.js +528 -0
package/dist/projects/scaffolds/pets.js +567 -0
package/dist/projects/scaffolds/quizzes.js +757 -0
package/dist/projects/scaffolds/stories.js +620 -0
package/dist/projects/scaffolds/vendor/KAPLAY-LICENSE.txt +35 -0
package/dist/projects/scaffolds/vendor/kaplay.mjs +57 -0
package/dist/projects/scaffolds/websites.js +474 -0
package/dist/projects/snapshots.js +203 -0
package/dist/projects/store.js +325 -0
package/dist/providers/errors.js +207 -0
package/dist/providers/index.js +316 -0
package/dist/providers/models.js +38 -0
package/dist/safety/audit.js +195 -0
package/dist/safety/blocks.js +29 -0
package/dist/safety/classifier.js +337 -0
package/dist/safety/codescan.js +168 -0
package/dist/safety/guarddownload.js +79 -0
package/dist/safety/guardrunner.js +125 -0
package/dist/safety/localguard.js +227 -0
package/dist/safety/modelstore.js +127 -0
package/dist/safety/prefilter.js +214 -0
package/dist/safety/session.js +118 -0
package/dist/safety/taxonomy.js +246 -0
package/dist/safety/textextract.js +193 -0
package/dist/setup/launcher.js +65 -0
package/dist/setup/wizard.js +469 -0
package/dist/surfaces/chat.js +439 -0
package/dist/surfaces/commands.js +206 -0
package/dist/surfaces/home.js +438 -0
package/dist/types.js +5 -0
package/dist/ui/banner.js +35 -0
package/dist/ui/celebrate.js +141 -0
package/dist/ui/errors.js +97 -0
package/dist/ui/mascot.js +223 -0
package/dist/ui/text.js +156 -0
package/dist/ui/theme.js +92 -0
package/package.json +67 -0

package/dist/preview/server.js ADDED Viewed

@@ -0,0 +1,407 @@
+/**
+ * Termi preview server.
+ *
+ * Serves a kid's project folder over plain HTTP on 127.0.0.1 only.
+ * Adds live reload through a small server-sent-events channel.
+ * Security posture:
+ *   - bound strictly to the loopback address
+ *   - strict Content-Security-Policy on every response (primary egress control)
+ *   - path traversal guard with win32 case folding
+ *   - dotfiles and TERMI.md are never served
+ *   - no directory listings, no caching, no sniffing
+ */
+import http from 'node:http';
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import open from 'open';
+import { previewBasePort } from '../config/paths.js';
+const PORT_SCAN_RANGE = 50;
+const SSE_PATH = '/__termi/reload';
+const SSE_SCRIPT_PATH = '/__termi/reload.js';
+const HEARTBEAT_MS = 25_000;
+const DEBOUNCE_MS = 100;
+/** Exact policy from the safety plan. CSP is the sound egress control. */
+const CSP = "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; " +
+    "img-src 'self' data:; media-src 'self' data:; connect-src 'self'; " +
+    "frame-src 'none'; object-src 'none'; base-uri 'none'; form-action 'self'";
+const MIME = {
+    html: 'text/html; charset=utf-8',
+    css: 'text/css; charset=utf-8',
+    js: 'text/javascript; charset=utf-8',
+    mjs: 'text/javascript; charset=utf-8',
+    json: 'application/json; charset=utf-8',
+    png: 'image/png',
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    gif: 'image/gif',
+    svg: 'image/svg+xml',
+    ico: 'image/x-icon',
+    txt: 'text/plain; charset=utf-8',
+    wav: 'audio/wav',
+    mp3: 'audio/mpeg',
+};
+const DEFAULT_MIME = 'application/octet-stream';
+/**
+ * Loaded by the tag injected into every HTML page.
+ * Kept as a same-origin file so the CSP (script-src 'self') allows it.
+ */
+const RELOAD_CLIENT_JS = [
+    '(function () {',
+    "  var source = new EventSource('" + SSE_PATH + "');",
+    '  source.onmessage = function () { location.reload(); };',
+    '})();',
+].join('\n');
+const RELOAD_SCRIPT_TAG = '<script src="' + SSE_SCRIPT_PATH + '"></script>';
+/**
+ * Served when a project has no favicon of its own. Browsers request
+ * /favicon.ico on every load; without this the console shows a 404
+ * error on every project. A tiny robot face keeps it friendly.
+ */
+const FALLBACK_FAVICON_SVG = [
+    '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16">',
+    '<rect x="2" y="3" width="12" height="10" rx="2" fill="#7fd4ff"/>',
+    '<rect x="4.5" y="6" width="2.5" height="2.5" rx="0.5" fill="#101326"/>',
+    '<rect x="9" y="6" width="2.5" height="2.5" rx="0.5" fill="#101326"/>',
+    '<rect x="5" y="10" width="6" height="1.5" rx="0.75" fill="#101326"/>',
+    '<rect x="7.25" y="1" width="1.5" height="2" fill="#7fd4ff"/>',
+    '</svg>',
+].join('');
+/** Friendly 404 page. No outside files. A tiny text robot keeps it warm. */
+const NOT_FOUND_HTML = `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Page not found</title>
+<style>
+  body { background: #101326; color: #e8e9f5; font-family: system-ui, sans-serif;
+         display: flex; align-items: center; justify-content: center;
+         min-height: 100vh; margin: 0; text-align: center; }
+  .card { padding: 2rem 2.5rem; }
+  pre { color: #7fd4ff; font-size: 1.1rem; line-height: 1.25; margin: 0 0 1rem; }
+  h1 { font-size: 1.5rem; margin: 0 0 0.5rem; }
+  p { margin: 0.3rem 0; color: #b9bdd8; }
+  a { color: #7fd4ff; }
+</style>
+</head>
+<body>
+<div class="card">
+<pre>
+   ___
+  [o_o]
+ /|===|\\
+  |___|
+  d   b
+</pre>
+<h1>Termi looked everywhere.</h1>
+<p>This page is not in your project.</p>
+<p>Check the file name. Then try again.</p>
+<p><a href="/">Go back to your project</a></p>
+</div>
+</body>
+</html>
+`;
+/** Case folds a path on Windows so jail checks ignore letter case. */
+function foldCase(p) {
+    return process.platform === 'win32' ? p.toLowerCase() : p;
+}
+/** True when target is projectRoot itself or lives inside it. */
+function isInsideRoot(projectRoot, target) {
+    const rootCmp = foldCase(projectRoot);
+    const targetCmp = foldCase(target);
+    if (targetCmp === rootCmp)
+        return true;
+    const rootWithSep = rootCmp.endsWith(path.sep) ? rootCmp : rootCmp + path.sep;
+    return targetCmp.startsWith(rootWithSep);
+}
+/**
+ * Resolves a decoded URL path against the project root.
+ * Returns null when the result escapes the root, names a dotfile,
+ * or names TERMI.md.
+ */
+function resolveSafe(projectRoot, decodedPath) {
+    if (decodedPath.includes('\0'))
+        return null;
+    // Treat backslashes as separators too, then drop leading separators
+    // so absolute-looking requests stay relative to the root.
+    const rel = decodedPath.replace(/\\/g, '/').replace(/^\/+/, '');
+    const target = path.resolve(projectRoot, rel);
+    if (!isInsideRoot(projectRoot, target))
+        return null;
+    const relFromRoot = path.relative(projectRoot, target);
+    if (relFromRoot.length > 0) {
+        for (const segment of relFromRoot.split(path.sep)) {
+            if (segment.startsWith('.'))
+                return null;
+            if (segment.toLowerCase() === 'termi.md')
+                return null;
+        }
+    }
+    return target;
+}
+function baseHeaders(contentType) {
+    return {
+        'Content-Type': contentType,
+        'Cache-Control': 'no-store',
+        'Content-Security-Policy': CSP,
+        'X-Content-Type-Options': 'nosniff',
+    };
+}
+function sendText(res, status, contentType, body, headOnly) {
+    const buf = Buffer.from(body, 'utf-8');
+    res.writeHead(status, {
+        ...baseHeaders(contentType),
+        'Content-Length': String(buf.byteLength),
+    });
+    res.end(headOnly ? undefined : buf);
+}
+function sendNotFound(res, headOnly) {
+    sendText(res, 404, MIME['html'] ?? DEFAULT_MIME, NOT_FOUND_HTML, headOnly);
+}
+/** Injects the reload script tag right before the closing body tag. */
+export function injectReloadScript(html) {
+    const match = /<\/body>/i.exec(html);
+    if (!match)
+        return html + '\n' + RELOAD_SCRIPT_TAG + '\n';
+    const at = match.index;
+    return html.slice(0, at) + RELOAD_SCRIPT_TAG + '\n' + html.slice(at);
+}
+function listenOnce(server, port) {
+    return new Promise((resolve, reject) => {
+        const onError = (err) => {
+            server.removeListener('listening', onListening);
+            if (err.code === 'EADDRINUSE' || err.code === 'EACCES') {
+                resolve(false);
+            }
+            else {
+                reject(err);
+            }
+        };
+        const onListening = () => {
+            server.removeListener('error', onError);
+            resolve(true);
+        };
+        server.once('error', onError);
+        server.once('listening', onListening);
+        server.listen({ host: '127.0.0.1', port, exclusive: true });
+    });
+}
+export async function startPreview(projectDir, opts) {
+    const projectRoot = path.resolve(projectDir);
+    const sseClients = new Set();
+    let stopped = false;
+    let debounceTimer = null;
+    const broadcast = () => {
+        for (const client of sseClients) {
+            try {
+                client.write('data: reload\n\n');
+            }
+            catch {
+                sseClients.delete(client);
+            }
+        }
+    };
+    const notifyChange = () => {
+        if (stopped)
+            return;
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(() => {
+            debounceTimer = null;
+            broadcast();
+        }, DEBOUNCE_MS);
+    };
+    const handleSse = (req, res) => {
+        res.writeHead(200, {
+            ...baseHeaders('text/event-stream'),
+            Connection: 'keep-alive',
+        });
+        res.write(': connected\n\n');
+        sseClients.add(res);
+        req.on('close', () => {
+            sseClients.delete(res);
+        });
+    };
+    const serveFile = async (res, filePath, headOnly) => {
+        let target = filePath;
+        let stats;
+        try {
+            stats = await fsp.stat(target);
+        }
+        catch {
+            sendNotFound(res, headOnly);
+            return;
+        }
+        if (stats.isDirectory()) {
+            // Directories serve their index.html only. Never a listing.
+            target = path.join(target, 'index.html');
+            try {
+                stats = await fsp.stat(target);
+            }
+            catch {
+                sendNotFound(res, headOnly);
+                return;
+            }
+            if (stats.isDirectory()) {
+                sendNotFound(res, headOnly);
+                return;
+            }
+        }
+        const ext = path.extname(target).slice(1).toLowerCase();
+        const mime = MIME[ext] ?? DEFAULT_MIME;
+        if (ext === 'html') {
+            const html = await fsp.readFile(target, 'utf-8');
+            sendText(res, 200, mime, injectReloadScript(html), headOnly);
+            return;
+        }
+        const data = await fsp.readFile(target);
+        res.writeHead(200, {
+            ...baseHeaders(mime),
+            'Content-Length': String(data.byteLength),
+        });
+        res.end(headOnly ? undefined : data);
+    };
+    const server = http.createServer((req, res) => {
+        void (async () => {
+            const method = req.method ?? 'GET';
+            const headOnly = method === 'HEAD';
+            if (method !== 'GET' && method !== 'HEAD') {
+                sendText(res, 405, MIME['txt'] ?? DEFAULT_MIME, 'Only GET works here.\n', false);
+                return;
+            }
+            let pathname;
+            try {
+                pathname = new URL(req.url ?? '/', 'http://127.0.0.1').pathname;
+            }
+            catch {
+                sendNotFound(res, headOnly);
+                return;
+            }
+            if (pathname === SSE_PATH) {
+                handleSse(req, res);
+                return;
+            }
+            if (pathname === SSE_SCRIPT_PATH) {
+                sendText(res, 200, MIME['js'] ?? DEFAULT_MIME, RELOAD_CLIENT_JS, headOnly);
+                return;
+            }
+            let decoded;
+            try {
+                decoded = decodeURIComponent(pathname);
+            }
+            catch {
+                sendNotFound(res, headOnly);
+                return;
+            }
+            const target = resolveSafe(projectRoot, decoded);
+            if (target === null) {
+                sendNotFound(res, headOnly);
+                return;
+            }
+            // Built-in favicon fallback so every project load stays error free.
+            if (decoded === '/favicon.ico' && !fs.existsSync(target)) {
+                sendText(res, 200, 'image/svg+xml', FALLBACK_FAVICON_SVG, headOnly);
+                return;
+            }
+            await serveFile(res, target, headOnly);
+        })().catch(() => {
+            try {
+                if (!res.headersSent) {
+                    sendText(res, 500, MIME['txt'] ?? DEFAULT_MIME, 'Something went wrong. Try again.\n', false);
+                }
+                else {
+                    res.end();
+                }
+            }
+            catch {
+                // Socket already gone. Nothing left to do.
+            }
+        });
+    });
+    // Find a port: explicit port from opts, or base port plus an upward scan.
+    let boundPort = null;
+    const candidates = [];
+    if (opts?.port !== undefined) {
+        candidates.push(opts.port);
+    }
+    else {
+        for (let i = 0; i <= PORT_SCAN_RANGE; i += 1) {
+            candidates.push(previewBasePort + i);
+        }
+    }
+    for (const candidate of candidates) {
+        // eslint-disable-next-line no-await-in-loop
+        if (await listenOnce(server, candidate)) {
+            boundPort = candidate;
+            break;
+        }
+    }
+    if (boundPort === null) {
+        throw new Error('No free port for the preview. Close other previews and try again.');
+    }
+    // Heartbeat comments keep proxies from dropping quiet SSE connections.
+    const heartbeat = setInterval(() => {
+        for (const client of sseClients) {
+            try {
+                client.write(': heartbeat\n\n');
+            }
+            catch {
+                sseClients.delete(client);
+            }
+        }
+    }, HEARTBEAT_MS);
+    heartbeat.unref();
+    // Backup watcher only. Tool code calls notifyChange() directly after writes.
+    let watcher = null;
+    try {
+        watcher = fs.watch(projectRoot, { recursive: true }, () => notifyChange());
+        watcher.on('error', () => {
+            // Recursive watch can fail on some platforms. The direct trigger covers us.
+        });
+    }
+    catch {
+        watcher = null;
+    }
+    const url = `http://127.0.0.1:${boundPort}/`;
+    const stop = async () => {
+        if (stopped)
+            return;
+        stopped = true;
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+            debounceTimer = null;
+        }
+        clearInterval(heartbeat);
+        for (const client of sseClients) {
+            try {
+                client.end();
+            }
+            catch {
+                // Already closed.
+            }
+        }
+        sseClients.clear();
+        if (watcher) {
+            try {
+                watcher.close();
+            }
+            catch {
+                // Already closed.
+            }
+        }
+        await new Promise((resolve) => {
+            server.close(() => resolve());
+            server.closeAllConnections();
+        });
+    };
+    if (opts?.openBrowser) {
+        try {
+            await open(url);
+        }
+        catch {
+            // The preview still works. The kid can open the link by hand.
+        }
+    }
+    return { url, port: boundPort, notifyChange, stop };
+}

package/dist/projects/create.js ADDED Viewed

@@ -0,0 +1,103 @@
+/**
+ * Project creation: turn a scaffold, a theme, and a name into a real
+ * project on disk, ready for the preview server before any model call.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { projectsDir } from '../config/paths.js';
+import { scaffoldById } from './scaffolds/index.js';
+import { notesFileName, openProject, renderTermiMd, saveProjectMeta, } from './store.js';
+/** Slugs may never be a Windows reserved device name. */
+const windowsReserved = new Set(['con', 'prn', 'aux', 'nul']);
+for (let i = 1; i <= 9; i += 1) {
+    windowsReserved.add(`com${i}`);
+    windowsReserved.add(`lpt${i}`);
+}
+const maxSlugLength = 40;
+/**
+ * Turns a pretty name into a safe folder slug.
+ * Lowercase a-z, 0-9 and dashes only. Emoji and accents are dropped.
+ * Empty results become "my-project". Windows reserved names get "-app".
+ * If the slug's folder already exists, a free "-2", "-3"... slug is
+ * returned and collision is true.
+ */
+export function slugifyName(input) {
+    let s = input
+        .normalize('NFKD')
+        .replace(/\p{M}+/gu, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-+/, '')
+        .replace(/-+$/, '');
+    if (s.length > maxSlugLength) {
+        s = s.slice(0, maxSlugLength).replace(/-+$/, '');
+    }
+    if (s.length === 0)
+        s = 'my-project';
+    if (windowsReserved.has(s))
+        s = `${s}-app`;
+    const taken = (slug) => fs.existsSync(path.join(projectsDir(), slug));
+    if (!taken(s)) {
+        return { slug: s, collision: false };
+    }
+    let n = 2;
+    while (taken(`${s}-${n}`))
+        n += 1;
+    return { slug: `${s}-${n}`, collision: true };
+}
+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 a new project from a scaffold and theme.
+ * Writes the kid files, any vendored engine files, TERMI.md, and
+ * .termi.json, then opens the project. Throws kid-readable errors.
+ */
+export function createProject(scaffoldId, themeId, prettyNameInput) {
+    const scaffold = scaffoldById(scaffoldId);
+    if (!scaffold) {
+        throw new Error('I do not know that project type. Pick one from the menu.');
+    }
+    const theme = scaffold.themes.find((t) => t.id === themeId);
+    if (!theme) {
+        throw new Error('I do not know that style. Pick one from the list.');
+    }
+    const trimmed = prettyNameInput.trim();
+    const prettyName = trimmed.length > 0 ? trimmed : 'My Project';
+    const { slug } = slugifyName(prettyName);
+    const dir = path.join(projectsDir(), slug);
+    fs.mkdirSync(dir, { recursive: true });
+    const files = scaffold.files(theme, prettyName);
+    for (const [relPath, content] of Object.entries(files)) {
+        writeRel(dir, relPath, content);
+    }
+    for (const [relPath, content] of Object.entries(scaffold.vendorFiles ?? {})) {
+        writeRel(dir, relPath, content);
+    }
+    if (!(notesFileName in files)) {
+        const kidFiles = Object.keys(files).filter((f) => f !== notesFileName);
+        writeRel(dir, notesFileName, renderTermiMd(prettyName, {
+            whatThisIs: `A ${scaffold.label} starter. ${theme.narrativeIntro}`,
+            files: kidFiles,
+            builtSoFar: [`Started from the ${scaffold.label} starter`],
+            recapLine: `We just made ${prettyName}!`,
+        }));
+    }
+    const now = new Date().toISOString();
+    saveProjectMeta({
+        slug,
+        prettyName,
+        scaffoldId,
+        themeId,
+        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, starterPrompts: scaffold.starterPrompts(theme) };
+}

package/dist/projects/ideas.js ADDED Viewed

@@ -0,0 +1,182 @@
+/**
+ * Curated prompt ideas for `termi ideas` and /ideas.
+ * Each list starts tiny and grows bolder so kids can pick their level.
+ * Theme-agnostic on purpose: every idea works for any theme.
+ */
+const ideasByScaffold = {
+    games: [
+        'Make the player move a little faster.',
+        'Give the player three lives.',
+        'Make the obstacles spin as they fall.',
+        'Play a sound when you grab a bonus.',
+        'Add a power up that makes you tiny.',
+        'Make the game speed up every 20 points.',
+        'Add a high score that saves on this computer.',
+        'Add a shield that blocks one hit.',
+        'Add a boss level with a health bar.',
+        'Add a friendly robot that follows you around.',
+        'Make the background change color as you score.',
+        'Add a slow motion power up.',
+        'Give the obstacles funny faces.',
+        'Add a two player mode with a second set of keys.',
+        'Make a rainbow trail follow the player.',
+    ],
+    biggames: [
+        'Make the player jump a little higher.',
+        'Add more things to collect in level one.',
+        'Make a platform that moves up and down.',
+        'Give the player a double jump.',
+        'Add a secret room with a big bonus.',
+        'Add a new enemy that walks back and forth.',
+        'Add a timer that shows how fast you finish.',
+        'Build a whole new level three.',
+        'Add a boss level with a health bar.',
+        'Add bouncy mushrooms that fling you up high.',
+        'Hide three stars in hard to reach spots.',
+        'Add a checkpoint flag in the middle of the level.',
+        'Give the player a cape that slows falling.',
+        'Add rain or snow to one level.',
+        'Make a bonus level that is all about jumping.',
+    ],
+    art: [
+        'Add a new bright color to the paint set.',
+        'Make the brush bigger when you press B.',
+        'Add an eraser button.',
+        'Add a rainbow brush that changes color as you draw.',
+        'Add a stamp tool with fun shapes.',
+        'Add an undo button for the last stroke.',
+        'Let me save my picture to the computer.',
+        'Add a mirror mode that paints both sides at once.',
+        'Add a gallery page that shows all my saved art.',
+        'Add a spray paint brush with dots.',
+        'Make the canvas shake when you draw fast.',
+        'Add glow in the dark colors on a black canvas.',
+        'Add a button that draws a random doodle to finish.',
+        'Let me pick the canvas color before I start.',
+        'Add a symmetry mode that makes snowflakes.',
+    ],
+    music: [
+        'Add one new drum sound.',
+        'Make the beat a little faster.',
+        'Add a button that plays a funny sound.',
+        'Make the lights flash with the beat.',
+        'Add a slider that changes the speed.',
+        'Let me record a short loop and play it back.',
+        'Add a new dance move for the dancer.',
+        'Make a song that builds up and then drops.',
+        'Add a whole second song with its own lights.',
+        'Add an animal band that plays your song.',
+        'Make a keyboard I can play with my keys.',
+        'Add a clap sound on every fourth beat.',
+        'Let me name and save my favorite beat.',
+        'Add a robot voice that counts the beat.',
+        'Make fireworks pop on the big drops.',
+    ],
+    pets: [
+        'Give my pet a new snack to eat.',
+        'Make my pet blink now and then.',
+        'Add a happiness meter with hearts.',
+        'Add a play button with a tiny game inside.',
+        'Make my pet get sleepy at night.',
+        'Add a closet with hats for my pet.',
+        'Let my pet learn a trick after ten treats.',
+        'Add a friend pet that visits sometimes.',
+        'Add levels so my pet grows up over time.',
+        'Give my pet a tiny house it can go inside.',
+        'Add weather that changes my pet\'s mood.',
+        'Let my pet send me a note when it misses me.',
+        'Add a bath time with bubbles.',
+        'Give my pet a birthday with a cake.',
+        'Add a photo button that saves cute pet pictures.',
+    ],
+    stories: [
+        'Add one more choice to the first scene.',
+        'Give a character a funny catchphrase.',
+        'Add a new scene with a surprise twist.',
+        'Add an item you can pick up and use later.',
+        'Make a new ending where everyone celebrates.',
+        'Add a riddle the reader must answer.',
+        'Add a sneaky shortcut that skips a scene.',
+        'Add a map screen that shows where you are.',
+        'Write a whole second chapter with new places.',
+        'Add a talking animal who gives hints.',
+        'Let the reader name the hero at the start.',
+        'Add a scene that is different every time.',
+        'Add a brave choice and a sneaky choice everywhere.',
+        'Give the story chapter titles with emoji.',
+        'Add a wrong turn that loops back with a joke.',
+    ],
+    quizzes: [
+        'Add one new question to the quiz.',
+        'Add a silly wrong answer to a question.',
+        'Show a happy message for a perfect score.',
+        'Add a timer for each question.',
+        'Shuffle the questions every time.',
+        'Add emoji to the questions.',
+        'Count how many right answers in a row you get.',
+        'Add easy, medium, and hard levels.',
+        'Add a final boss question worth double points.',
+        'Add a picture question with emoji clues.',
+        'Let players pick a team name first.',
+        'Add a bonus round with rapid fire questions.',
+        'Play a drum roll before showing the score.',
+        'Add a trick question with a wink.',
+        'Show a medal for first, second, and third try.',
+    ],
+    websites: [
+        'Add a new favorite to my list.',
+        'Change the page colors to my favorites.',
+        'Add a box for my favorite joke.',
+        'Add a big welcome banner at the top.',
+        'Make the buttons wiggle when you point at them.',
+        'Add a day and night switch.',
+        'Add a guest book that saves on this computer.',
+        'Add a second page about my hobby.',
+        'Hide a tiny game somewhere on the page.',
+        'Add a pet corner with drawings of animals.',
+        'Make confetti fall when the page opens.',
+        'Add a favorite songs list with star ratings.',
+        'Add a big red button that does something silly.',
+        'Make a fan page for your favorite animal.',
+        'Add a quiz about you for your friends.',
+    ],
+    characters: [
+        'Give your character a new greeting.',
+        'Add a joke your character can tell.',
+        'Add a new question players can ask.',
+        'Give your character a happy mood and a grumpy mood.',
+        'Make the character remember your favorite color.',
+        'Add sound effects when the character talks.',
+        'Add a second character who butts in sometimes.',
+        'Add a quiz round your character hosts.',
+        'Give your character a secret story to unlock.',
+        'Give your character a theme song.',
+        'Let your character play rock paper scissors.',
+        'Add a sleepy mode after ten questions.',
+        'Give your character a best friend it talks about.',
+        'Let your character give out silly awards.',
+        'Add a story mode where it tells one long tale.',
+    ],
+};
+/** Fallback ideas that fit any project. */
+const genericIdeas = [
+    'Change the colors to your favorites.',
+    'Add a sound effect.',
+    'Add a fun title at the top.',
+    'Make something move on its own.',
+    'Add a surprise that shows up after a while.',
+    'Add a score or a counter.',
+    'Save something so it is still there tomorrow.',
+    'Add a whole new screen or level.',
+    'Add a silly secret that only you know about.',
+    'Give it a happy start screen with your project name.',
+    'Add a night mode with dark colors.',
+];
+/**
+ * Returns prompt ideas for a project type.
+ * Unknown ids get the generic list. Always returns a fresh copy.
+ */
+export function getIdeas(scaffoldId) {
+    const list = ideasByScaffold[scaffoldId];
+    return list !== undefined ? [...list] : [...genericIdeas];
+}