create-yaebal 0.0.1 → 0.1.0

package/lib/scaffold.js

@@ -0,0 +1,296 @@
+/**
+ * project generation. `renderFiles` is pure — options in, a `path → contents`
+ * map out — so it is trivially testable. `writeProject` is the thin fs wrapper
+ * that flushes that map to disk.
+ *
+ * a template is more than a bot body: it can pull in plugins, add real imports,
+ * declare consts before the bot, extend the `.install()` chain and even replace
+ * the bootstrap (`bot.start()` → `serve()` / `run()`). everything it generates
+ * type-checks against the real `@yaebal/*` apis.
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { findPlugin } from "./catalog.js";
+const SCRIPTS = {
+    node: {
+        dev: "node --watch --experimental-strip-types src/index.ts",
+        start: "node --experimental-strip-types src/index.ts",
+    },
+    bun: { dev: "bun --watch src/index.ts", start: "bun src/index.ts" },
+    deno: {
+        dev: "deno run --watch --allow-net --allow-env src/index.ts",
+        start: "deno run --allow-net --allow-env src/index.ts",
+    },
+};
+const DEFAULT_BOOTSTRAP = `await bot.start();
+console.log("✓ bot is running — press ctrl-c to stop");`;
+const TEMPLATES = {
+    minimal: {
+        body: `bot.command("start", (ctx) => ctx.reply("hello! i'm a yaebal bot 🤖"));
+bot.on("message:text", (ctx) => ctx.reply(ctx.text));`,
+    },
+    echo: {
+        body: `bot.command("start", (ctx) => ctx.reply("send me anything and i'll echo it back ✨"));
+bot.on("message:text", (ctx) => ctx.reply(ctx.text));
+bot.on("message:photo", (ctx) => ctx.reply("nice photo! 📸"));
+bot.on("message:sticker", (ctx) => ctx.reply("cool sticker 🎨"));`,
+    },
+    commands: {
+        body: `bot.command("start", (ctx) => ctx.reply("hello! i'm a yaebal bot 🤖"));
+bot.command("help", (ctx) => ctx.reply("commands: /start /help /ping"));
+bot.command("ping", (ctx) => ctx.reply("pong 🏓"));
+bot.on("message:text", (ctx) => ctx.reply(\`you said: \${ctx.text}\`));`,
+    },
+    buttons: {
+        plugins: ["keyboard", "callback-data"],
+        imports: [
+            'import { InlineKeyboard } from "@yaebal/keyboard";',
+            'import { callbackData } from "@yaebal/callback-data";',
+        ],
+        pre: 'const vote = callbackData("vote", { choice: String });',
+        body: `bot.command("start", (ctx) =>
+\tctx.reply("tap a button 👇", {
+\t\treply_markup: new InlineKeyboard()
+\t\t\t.text("👍 like", vote.pack({ choice: "up" }))
+\t\t\t.text("👎 dislike", vote.pack({ choice: "down" }))
+\t\t\t.build(),
+\t}),
+);
+
+bot.callbackQuery(vote.pattern, async (ctx) => {
+\tconst choice = vote.unpack(ctx.callbackQuery.data ?? "")?.choice;
+\tawait ctx.answerCallbackQuery({ text: choice === "up" ? "liked 👍" : "disliked 👎" });
+});`,
+    },
+    conversation: {
+        plugins: ["conversation"],
+        imports: ['import { conversation, createConversation } from "@yaebal/conversation";'],
+        pre: `const greet = createConversation("greet", async (cv, ctx) => {
+\tawait ctx.reply("what's your name?");
+\tconst name = await cv.wait();
+\tawait name.reply(\`hi, \${name.text}! how old are you?\`);
+\tconst age = await cv.wait();
+\tawait age.reply(\`\${age.text} — nice to meet you ✨\`);
+});`,
+        install: ["conversation([greet])"],
+        body: `bot.command("start", (ctx) => ctx.reply("type /greet to start a short chat"));
+bot.command("greet", (ctx) => ctx.conversation.enter("greet"));`,
+    },
+    i18n: {
+        plugins: ["i18n"],
+        imports: ['import { i18n } from "@yaebal/i18n";'],
+        pre: `const locales = {
+\ten: { hi: "hi there! 🇬🇧", switched: "language set to english" },
+\tru: { hi: "привет! 🇷🇺", switched: "язык переключён на русский" },
+};`,
+        install: ['i18n({ defaultLocale: "en", locales })'],
+        body: `bot.command("start", (ctx) => ctx.reply(ctx.t("hi")));
+bot.command("lang", async (ctx) => {
+\tawait ctx.changeLanguage(ctx.locale === "ru" ? "en" : "ru");
+\treturn ctx.reply(ctx.t("switched"));
+});`,
+    },
+    "session-counter": {
+        plugins: ["session"],
+        imports: ['import { session } from "@yaebal/session";'],
+        install: ["session({ initial: () => ({ count: 0 }) })"],
+        body: `bot.command("start", (ctx) => ctx.reply("send /count to bump your per-chat counter"));
+bot.command("count", (ctx) => {
+\tctx.session.count++;
+\treturn ctx.reply(\`you've hit /count \${ctx.session.count} time(s)\`);
+});`,
+    },
+    webhook: {
+        plugins: ["web"],
+        imports: ['import { serve } from "@yaebal/web";'],
+        body: `bot.command("start", (ctx) => ctx.reply("hello from a webhook bot 🤖"));
+bot.on("message:text", (ctx) => ctx.reply(ctx.text));`,
+        bootstrap: `const port = Number(process.env.PORT ?? 8080);
+
+// point telegram at your public https url once (run this separately or here):
+// await bot.api.call("setWebhook", { url: "https://your.domain/" });
+
+serve(bot, { port });
+console.log(\`✓ webhook server listening on :\${port}\`);`,
+    },
+    runner: {
+        plugins: ["runner"],
+        imports: ['import { run } from "@yaebal/runner";'],
+        body: `bot.command("start", (ctx) => ctx.reply("hello! your updates run concurrently ⚡"));
+bot.on("message:text", (ctx) => ctx.reply(ctx.text));`,
+        bootstrap: `const handle = run(bot, { concurrency: 50 });
+process.once("SIGINT", () => handle.stop());
+console.log("✓ runner polling (concurrency 50) — press ctrl-c to stop");`,
+    },
+};
+/** default package manager that matches a runtime when the user didn't pick one */
+export function defaultPackageManager(runtime) {
+    if (runtime === "bun")
+        return "bun";
+    if (runtime === "deno")
+        return "deno";
+    return "pnpm";
+}
+const pkgOf = (importLine) => importLine.match(/from "([^"]+)"/)?.[1];
+/** turn options into a `relative path → file content` map. pure. */
+export function renderFiles(opts) {
+    const templateId = opts.template ?? "minimal";
+    const spec = TEMPLATES[templateId];
+    const pm = opts.packageManager ?? defaultPackageManager(opts.runtime);
+    const chosen = opts.plugins.map(findPlugin).filter((p) => !!p);
+    const templatePlugins = (spec.plugins ?? [])
+        .map(findPlugin)
+        .filter((p) => !!p);
+    const templateIds = new Set(templatePlugins.map((p) => p.id));
+    // the template owns the wiring for its own plugins, so the user-selected
+    // ones are partitioned with those removed (no double installs).
+    const wired = chosen.filter((p) => !templateIds.has(p.id));
+    const installs = wired.filter((p) => p.wire === "install");
+    const setups = wired.filter((p) => p.wire === "setup");
+    const depOnly = wired.filter((p) => p.wire === "dep");
+    // ── imports ──────────────────────────────────────────────────────────
+    const imports = [
+        'import { Bot } from "@yaebal/core";',
+        ...installs.map((p) => p.import),
+        ...setups.map((p) => p.import),
+        ...(spec.imports ?? []),
+    ];
+    const importBlock = [...new Set(imports)].join("\n");
+    // dep-only plugins get a commented import — unless the template already
+    // imports that package for real.
+    const importedPackages = new Set([
+        ...installs.map((p) => p.dep),
+        ...setups.map((p) => p.dep),
+        ...(spec.imports ?? []).map(pkgOf).filter((p) => !!p),
+    ]);
+    const depHints = depOnly.filter((p) => !importedPackages.has(p.dep));
+    const depHint = depHints.length > 0
+        ? `\n\n// extra plugins you added — import & wire them as you need:\n${depHints
+            .map((p) => `// ${p.import}`)
+            .join("\n")}`
+        : "";
+    // ── bot construction ───────────────────────────────────────────────────
+    const installExprs = [...installs.map((p) => p.install), ...(spec.install ?? [])];
+    const installChain = installExprs.length > 0 ? `\n${installExprs.map((e) => `\t.install(${e})`).join("\n")}` : "";
+    const setupStatements = [...setups.map((p) => p.setup)];
+    if (spec.setup)
+        setupStatements.push(spec.setup);
+    const setupBlock = setupStatements.length > 0
+        ? `\n\n// transformers applied to the outgoing api\n${setupStatements.join("\n")}`
+        : "";
+    const pre = spec.pre ? `${spec.pre}\n\n` : "";
+    const bootstrap = spec.bootstrap ?? DEFAULT_BOOTSTRAP;
+    const index = `${importBlock}${depHint}
+
+const token = process.env.BOT_TOKEN;
+if (!token) {
+\tconsole.error("✗ set BOT_TOKEN in your environment (copy .env.example → .env)");
+\tprocess.exit(1);
+}
+
+${pre}const bot = new Bot(token)${installChain};
+
+${spec.body}${setupBlock}
+
+${bootstrap}
+`;
+    // ── package.json ──────────────────────────────────────────────────────
+    const dependencies = { "@yaebal/core": "latest" };
+    for (const p of [...chosen, ...templatePlugins])
+        dependencies[p.dep] = "latest";
+    const pkg = {
+        name: opts.name,
+        version: "0.0.0",
+        private: true,
+        type: "module",
+        scripts: SCRIPTS[opts.runtime],
+        dependencies,
+        devDependencies: { "@types/node": "^22.0.0", typescript: "^5.7.0" },
+        engines: opts.runtime === "node" ? { node: ">=22.6" } : undefined,
+    };
+    const tsconfig = {
+        compilerOptions: {
+            target: "ES2022",
+            module: "NodeNext",
+            moduleResolution: "NodeNext",
+            lib: ["ES2023"],
+            strict: true,
+            noUncheckedIndexedAccess: true,
+            verbatimModuleSyntax: true,
+            skipLibCheck: true,
+            allowImportingTsExtensions: true,
+            noEmit: true,
+            types: ["node"],
+        },
+        include: ["src"],
+    };
+    const runCmd = runCommand(pm, "dev");
+    const installCmd = installCommand(pm);
+    const allPlugins = [...new Set([...chosen.map((p) => p.id), ...templateIds])];
+    const readme = `# ${opts.name}
+
+a telegram bot built with [yaebal](https://github.com/neverlane/yaebal) — type-safe, runtime-agnostic.
+
+## quick start
+
+\`\`\`sh
+# 1. install deps
+${installCmd}
+
+# 2. add your token
+cp .env.example .env   # then put your BOT_TOKEN in it
+
+# 3. run (watch mode)
+${runCmd}
+\`\`\`
+
+runtime: **${opts.runtime}** · template: **${templateId}**${allPlugins.length ? ` · plugins: ${allPlugins.join(", ")}` : ""}
+`;
+    return {
+        "package.json": `${JSON.stringify(pkg, null, "\t")}\n`,
+        "tsconfig.json": `${JSON.stringify(tsconfig, null, "\t")}\n`,
+        "src/index.ts": index,
+        ".env.example": "BOT_TOKEN=\n",
+        ".gitignore": "node_modules\nlib\n.env\n*.log\n",
+        "README.md": readme,
+    };
+}
+/** the install command for a package manager (deno has none) */
+export function installCommand(pm) {
+    switch (pm) {
+        case "npm":
+            return "npm install";
+        case "yarn":
+            return "yarn";
+        case "bun":
+            return "bun install";
+        case "deno":
+            return "deno cache src/index.ts";
+        default:
+            return "pnpm install";
+    }
+}
+/** the `<pm> run <script>` invocation (npm/yarn/bun) or runtime command (deno) */
+export function runCommand(pm, script) {
+    switch (pm) {
+        case "npm":
+            return `npm run ${script}`;
+        case "yarn":
+            return `yarn ${script}`;
+        case "bun":
+            return `bun run ${script}`;
+        case "deno":
+            return script === "dev" ? SCRIPTS.deno.dev : SCRIPTS.deno.start;
+        default:
+            return `pnpm ${script}`;
+    }
+}
+/** flush a rendered file map to `targetDir`, creating parent dirs as needed. */
+export async function writeProject(targetDir, files) {
+    for (const [rel, content] of Object.entries(files)) {
+        const full = join(targetDir, rel);
+        await mkdir(dirname(full), { recursive: true });
+        await writeFile(full, content);
+    }
+}
+//# sourceMappingURL=scaffold.js.map

package/lib/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}

package/lib/scaffold.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scaffold.test.d.ts.map

package/lib/scaffold.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.test.d.ts","sourceRoot":"","sources":["../src/scaffold.test.ts"],"names":[],"mappings":""}

package/lib/scaffold.test.js

@@ -0,0 +1,96 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { PLUGIN_IDS } from "./catalog.js";
+import { defaultPackageManager, installCommand, renderFiles, runCommand } from "./scaffold.js";
+test("renderFiles: bare project has core only", () => {
+    const f = renderFiles({ name: "bot", runtime: "node", plugins: [] });
+    const pkg = JSON.parse(f["package.json"] ?? "{}");
+    assert.equal(pkg.name, "bot");
+    assert.deepEqual(Object.keys(pkg.dependencies), ["@yaebal/core"]);
+    assert.match(f["src/index.ts"] ?? "", /new Bot\(token\)/);
+    assert.doesNotMatch(f["src/index.ts"] ?? "", /\.install\(/);
+});
+test("renderFiles: install/setup plugins are wired, dep plugins commented", () => {
+    const f = renderFiles({
+        name: "bot",
+        runtime: "node",
+        plugins: ["session", "again", "fmt", "bogus"],
+    });
+    const pkg = JSON.parse(f["package.json"] ?? "{}");
+    assert.ok(pkg.dependencies["@yaebal/session"]);
+    assert.ok(pkg.dependencies["@yaebal/again"]);
+    assert.ok(pkg.dependencies["@yaebal/fmt"]);
+    assert.equal(pkg.dependencies.bogus, undefined); // unknown plugin ignored
+    const src = f["src/index.ts"] ?? "";
+    assert.match(src, /import \{ session \} from "@yaebal\/session";/);
+    assert.match(src, /\.install\(session\(/);
+    assert.match(src, /autoRetry\(bot\.api\);/); // `again` is a setup-style plugin
+    assert.match(src, /\/\/ import \{ html, md \} from "@yaebal\/fmt";/); // fmt is dep-only
+});
+test("renderFiles: every catalog plugin generates valid, importable code", () => {
+    const f = renderFiles({ name: "bot", runtime: "node", plugins: [...PLUGIN_IDS] });
+    const src = f["src/index.ts"] ?? "";
+    const pkg = JSON.parse(f["package.json"] ?? "{}");
+    // all plugin deps present
+    for (const id of PLUGIN_IDS) {
+        assert.ok(Object.values(pkg.dependencies).length > 0);
+        assert.ok(src.includes(id) || JSON.stringify(pkg.dependencies).includes(id), `missing ${id}`);
+    }
+    // no duplicate import lines for @yaebal/core
+    assert.equal((src.match(/from "@yaebal\/core"/g) ?? []).length, 1);
+});
+test("renderFiles: template changes the bot body", () => {
+    const cmd = renderFiles({ name: "b", runtime: "node", plugins: [], template: "commands" })["src/index.ts"] ?? "";
+    assert.match(cmd, /bot\.command\("ping"/);
+    const echo = renderFiles({ name: "b", runtime: "node", plugins: [], template: "echo" })["src/index.ts"] ??
+        "";
+    assert.match(echo, /message:photo/);
+});
+test("renderFiles: rich templates pull in plugins, imports and wiring", () => {
+    const buttons = renderFiles({ name: "b", runtime: "node", plugins: [], template: "buttons" });
+    const bsrc = buttons["src/index.ts"] ?? "";
+    const bpkg = JSON.parse(buttons["package.json"] ?? "{}");
+    assert.ok(bpkg.dependencies["@yaebal/keyboard"]);
+    assert.ok(bpkg.dependencies["@yaebal/callback-data"]);
+    assert.match(bsrc, /import \{ InlineKeyboard \} from "@yaebal\/keyboard";/);
+    assert.match(bsrc, /bot\.callbackQuery\(vote\.pattern/);
+    // webhook & runner replace the default bootstrap
+    const wh = renderFiles({ name: "b", runtime: "bun", plugins: [], template: "webhook" })["src/index.ts"] ??
+        "";
+    assert.match(wh, /serve\(bot, \{ port \}\)/);
+    assert.doesNotMatch(wh, /bot\.start\(\)/);
+    const rn = renderFiles({ name: "b", runtime: "node", plugins: [], template: "runner" })["src/index.ts"] ??
+        "";
+    assert.match(rn, /run\(bot, \{ concurrency: 50 \}\)/);
+    assert.doesNotMatch(rn, /bot\.start\(\)/);
+    // install-style templates add to the chain via a pre-defined const
+    const conv = renderFiles({ name: "b", runtime: "node", plugins: [], template: "conversation" })["src/index.ts"] ?? "";
+    assert.match(conv, /const greet = createConversation\(/);
+    assert.match(conv, /\.install\(conversation\(\[greet\]\)\)/);
+});
+test("renderFiles: a template plugin is never wired twice", () => {
+    // user explicitly picks session AND the session-counter template
+    const f = renderFiles({
+        name: "b",
+        runtime: "node",
+        plugins: ["session"],
+        template: "session-counter",
+    });
+    const src = f["src/index.ts"] ?? "";
+    assert.equal((src.match(/\.install\(session\(/g) ?? []).length, 1);
+    assert.equal((src.match(/from "@yaebal\/session"/g) ?? []).length, 1);
+});
+test("renderFiles: runtime picks the right scripts", () => {
+    const bun = JSON.parse(renderFiles({ name: "b", runtime: "bun", plugins: [] })["package.json"] ?? "{}");
+    assert.match(bun.scripts.start, /^bun /);
+    const deno = JSON.parse(renderFiles({ name: "d", runtime: "deno", plugins: [] })["package.json"] ?? "{}");
+    assert.match(deno.scripts.start, /^deno run /);
+});
+test("commands map to package managers", () => {
+    assert.equal(installCommand("pnpm"), "pnpm install");
+    assert.equal(installCommand("deno"), "deno cache src/index.ts");
+    assert.equal(runCommand("npm", "dev"), "npm run dev");
+    assert.equal(defaultPackageManager("bun"), "bun");
+    assert.equal(defaultPackageManager("node"), "pnpm");
+});
+//# sourceMappingURL=scaffold.test.js.map

package/lib/scaffold.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.test.js","sourceRoot":"","sources":["../src/scaffold.test.ts"],"names":[],"mappings":"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"}

package/lib/tui/ansi.d.ts

@@ -0,0 +1,39 @@
+/**
+ * tiny ansi toolkit for the wizard — truecolor styling, a rounded card, screen
+ * control and a keypress reader built on `node:readline`. no native deps, so it
+ * runs on node, bun and deno out of the box.
+ */
+export declare const screen: {
+    enter: string;
+    leave: string;
+    clear: string;
+    hideCursor: string;
+    showCursor: string;
+};
+export declare function moveTo(row: number, col: number): string;
+export interface StyleOpts {
+    fg?: string;
+    bg?: string;
+    bold?: boolean;
+    dim?: boolean;
+}
+/** build a styling function that wraps text in a single sgr sequence + reset. */
+export declare function style(opts: StyleOpts): (s: string) => string;
+export declare const fg: (hex: string) => (s: string) => string;
+export declare const stripAnsi: (s: string) => string;
+/** visible width (ansi-insensitive). our content is single-width throughout. */
+export declare const vlen: (s: string) => number;
+/** pad a (possibly styled) string to `width` visible columns. */
+export declare function padTo(s: string, width: number): string;
+export interface KeyEvent {
+    name: string;
+    ctrl: boolean;
+    shift: boolean;
+    sequence: string;
+}
+/**
+ * subscribe to keypresses on a stream. returns a cleanup fn that detaches the
+ * listener and restores the terminal's raw-mode state.
+ */
+export declare function onKeypress(input: NodeJS.ReadStream, handler: (key: KeyEvent) => void): () => void;
+//# sourceMappingURL=ansi.d.ts.map

package/lib/tui/ansi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../../src/tui/ansi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,MAAM;;;;;;CAMlB,CAAC;AAEF,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAWD,MAAM,WAAW,SAAS;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAED,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAe5D;AAED,eAAO,MAAM,EAAE,GAAI,KAAK,MAAM,SAjBc,MAAM,KAAK,MAiBF,CAAC;AAItD,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,KAAG,MAAgC,CAAC;AACvE,gFAAgF;AAChF,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,MAA6B,CAAC;AAE/D,iEAAiE;AACjE,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI,CAsBjG"}

package/lib/tui/ansi.js

@@ -0,0 +1,84 @@
+/**
+ * tiny ansi toolkit for the wizard — truecolor styling, a rounded card, screen
+ * control and a keypress reader built on `node:readline`. no native deps, so it
+ * runs on node, bun and deno out of the box.
+ */
+import readline from "node:readline";
+const ESC = "\x1b[";
+export const screen = {
+    enter: `${ESC}?1049h`, // alternate buffer — leaves the scrollback untouched
+    leave: `${ESC}?1049l`,
+    clear: `${ESC}2J${ESC}H`,
+    hideCursor: `${ESC}?25l`,
+    showCursor: `${ESC}?25h`,
+};
+export function moveTo(row, col) {
+    return `${ESC}${row};${col}H`;
+}
+function rgb(hex) {
+    const h = hex.replace("#", "");
+    return [
+        Number.parseInt(h.slice(0, 2), 16),
+        Number.parseInt(h.slice(2, 4), 16),
+        Number.parseInt(h.slice(4, 6), 16),
+    ];
+}
+/** build a styling function that wraps text in a single sgr sequence + reset. */
+export function style(opts) {
+    const codes = [];
+    if (opts.fg) {
+        const [r, g, b] = rgb(opts.fg);
+        codes.push(`38;2;${r};${g};${b}`);
+    }
+    if (opts.bg) {
+        const [r, g, b] = rgb(opts.bg);
+        codes.push(`48;2;${r};${g};${b}`);
+    }
+    if (opts.bold)
+        codes.push("1");
+    if (opts.dim)
+        codes.push("2");
+    if (codes.length === 0)
+        return (s) => s;
+    const prefix = `${ESC}${codes.join(";")}m`;
+    return (s) => `${prefix}${s}${ESC}0m`;
+}
+export const fg = (hex) => style({ fg: hex });
+// biome-ignore lint/suspicious/noControlCharactersInRegex: matching the esc (\x1b) byte is the point
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+export const stripAnsi = (s) => s.replace(ANSI_RE, "");
+/** visible width (ansi-insensitive). our content is single-width throughout. */
+export const vlen = (s) => stripAnsi(s).length;
+/** pad a (possibly styled) string to `width` visible columns. */
+export function padTo(s, width) {
+    const gap = width - vlen(s);
+    return gap > 0 ? s + " ".repeat(gap) : s;
+}
+/**
+ * subscribe to keypresses on a stream. returns a cleanup fn that detaches the
+ * listener and restores the terminal's raw-mode state.
+ */
+export function onKeypress(input, handler) {
+    readline.emitKeypressEvents(input);
+    const isTty = Boolean(input.isTTY);
+    if (isTty && input.setRawMode)
+        input.setRawMode(true);
+    input.resume?.();
+    const listener = (str, key) => {
+        handler({
+            name: key?.name ?? (str === " " ? "space" : (str ?? "")),
+            ctrl: Boolean(key?.ctrl),
+            shift: Boolean(key?.shift),
+            sequence: str ?? key?.sequence ?? "",
+        });
+    };
+    input.on("keypress", listener);
+    return () => {
+        input.off("keypress", listener);
+        if (isTty && input.setRawMode)
+            input.setRawMode(false);
+        // release stdin so the event loop can drain and the process exits.
+        input.pause?.();
+    };
+}
+//# sourceMappingURL=ansi.js.map

package/lib/tui/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../../src/tui/ansi.ts"],"names":[],"mappings":"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"}

package/lib/tui/app.d.ts

@@ -0,0 +1,20 @@
+/**
+ * the wizard — a centred, keyboard-driven card rendered with pure ansi (see
+ * `./ansi.ts`). no native deps: it runs on node, bun and deno wherever there's
+ * a tty. a tiny step state-machine drives a full repaint on every keystroke,
+ * which at this size is instant and flicker-free on the alternate screen.
+ *
+ * the renderer is injectable (input/output/size) so tests can drive it with a
+ * fake stdin and read frames back from a fake stdout.
+ */
+import type { ParsedArgs } from "../args.js";
+import { type Selections } from "../config.js";
+export interface TuiIO {
+    input?: NodeJS.ReadStream;
+    output?: NodeJS.WriteStream;
+    rows?: number;
+    cols?: number;
+}
+/** run the wizard. resolves with selections, or `undefined` if cancelled. */
+export declare function runTui(args: ParsedArgs, io?: TuiIO): Promise<Selections | undefined>;
+//# sourceMappingURL=app.d.ts.map

package/lib/tui/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/tui/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAY,KAAK,UAAU,EAAmB,MAAM,cAAc,CAAC;AA8B1E,MAAM,WAAW,KAAK;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAOD,6EAA6E;AAC7E,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,GAAE,KAAU,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CA0V9F"}