create-debuff 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# create-debuff
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Scaffold a new [debuff](https://github.com/debuffjp/debuff) game.
+
+```bash
+npm create debuff@latest my-game
+# or: pnpm create debuff · yarn create debuff · bun create debuff
+```
+
+Options:
+
+- `--template <id>`: `basic` (default, bundled) or `platformer` (downloaded on demand), or any git source such as `github:user/repo`
+- `--yes`: accept defaults without prompting (CI, agents)
+
+Runs without prompts when stdin isn't a TTY.

package/bin/create-debuff.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+// Committed shim so npm can link the bin before dist/ is built.
+import "../dist/cli.js";

package/dist/brand.d.ts

@@ -0,0 +1,38 @@
+/** debuff palette. Lime is the brand; the accents are for splashes of colour in tooling. */
+export declare const PALETTE: {
+    readonly lime: "#cffb2d";
+    readonly limeSoft: "#e7fd96";
+    readonly ink: "#11140d";
+    readonly sky: "#38bdf8";
+    readonly pink: "#f472b6";
+    readonly amber: "#fbbf24";
+    readonly violet: "#a78bfa";
+    readonly red: "#f87171";
+};
+export type PaletteColor = keyof typeof PALETTE;
+/** @deprecated Use PALETTE.lime. Kept for existing imports. */
+export declare const LIME: {
+    hex: "#cffb2d";
+    rgb: [number, number, number];
+};
+/** Paint text in a palette colour. */
+export declare function paint(name: PaletteColor, text: string): string;
+export declare const lime: (text: string) => string;
+export declare const sky: (text: string) => string;
+export declare const pink: (text: string) => string;
+export declare const amber: (text: string) => string;
+export declare const violet: (text: string) => string;
+/** The ` debuff ` badge used in CLI headers. */
+export declare function badge(text?: string): string;
+export type Mood = "idle" | "happy" | "oops";
+/**
+ * buff rendered with half-block characters: two pixel rows per text line (3 lines tall).
+ * Returns no lines when the terminal can't show 24-bit colour, so callers can just skip it.
+ */
+export declare function buff(mood?: Mood): string[];
+/**
+ * buff beside up to three lines of text, for command headers and results.
+ * Falls back to the badge and text when buff can't be drawn.
+ */
+export declare function banner(mood: Mood, lines: string[]): string;
+//# sourceMappingURL=brand.d.ts.map

package/dist/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAEA,4FAA4F;AAC5F,eAAO,MAAM,OAAO;aAClB,IAAI,EAAE,SAAS;aACf,QAAQ,EAAE,SAAS;aACnB,GAAG,EAAE,SAAS;aACd,GAAG,EAAE,SAAS;aACd,IAAI,EAAE,SAAS;aACf,KAAK,EAAE,SAAS;aAChB,MAAM,EAAE,SAAS;aACjB,GAAG,EAAE,SAAS;CACN,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,OAAO,CAAC;AAEhD,+DAA+D;AAC/D,eAAO,MAAM,IAAI;IAAK,GAAG;IAAgB,GAAG;CAAqB,CAAC;AAkBlE,sCAAsC;AACtC,wBAAgB,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,eAAO,MAAM,IAAI,SAAU,MAAM,WAAwB,CAAC;AAC1D,eAAO,MAAM,GAAG,SAAU,MAAM,WAAuB,CAAC;AACxD,eAAO,MAAM,IAAI,SAAU,MAAM,WAAwB,CAAC;AAC1D,eAAO,MAAM,KAAK,SAAU,MAAM,WAAyB,CAAC;AAC5D,eAAO,MAAM,MAAM,SAAU,MAAM,WAA0B,CAAC;AAE9D,gDAAgD;AAChD,wBAAgB,KAAK,CAAC,IAAI,SAAa,GAAG,MAAM,CAK/C;AAED,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAc7C;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,GAAE,IAAa,GAAG,MAAM,EAAE,CAmBlD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAI1D"}

package/dist/brand.js

@@ -0,0 +1,112 @@
+import pc from "picocolors";
+/** debuff palette. Lime is the brand; the accents are for splashes of colour in tooling. */
+export const PALETTE = {
+    lime: "#cffb2d",
+    limeSoft: "#e7fd96",
+    ink: "#11140d",
+    sky: "#38bdf8",
+    pink: "#f472b6",
+    amber: "#fbbf24",
+    violet: "#a78bfa",
+    red: "#f87171",
+};
+/** @deprecated Use PALETTE.lime. Kept for existing imports. */
+export const LIME = { hex: PALETTE.lime, rgb: rgb(PALETTE.lime) };
+const color = pc.isColorSupported;
+const truecolor = color && (/truecolor|24bit/i.test(process.env.COLORTERM ?? "") || process.platform === "win32" || process.env.TERM_PROGRAM === "vscode");
+/** Fallbacks for terminals without 24-bit colour. */
+const BASIC = {
+    lime: pc.green,
+    limeSoft: pc.greenBright,
+    ink: pc.black,
+    sky: pc.cyan,
+    pink: pc.magenta,
+    amber: pc.yellow,
+    violet: pc.blue,
+    red: pc.red,
+};
+/** Paint text in a palette colour. */
+export function paint(name, text) {
+    if (!color)
+        return text;
+    if (!truecolor)
+        return BASIC[name](text);
+    const [r, g, b] = rgb(PALETTE[name]);
+    return `\x1b[38;2;${r};${g};${b}m${text}\x1b[39m`;
+}
+export const lime = (text) => paint("lime", text);
+export const sky = (text) => paint("sky", text);
+export const pink = (text) => paint("pink", text);
+export const amber = (text) => paint("amber", text);
+export const violet = (text) => paint("violet", text);
+/** The ` debuff ` badge used in CLI headers. */
+export function badge(text = " debuff ") {
+    if (!color)
+        return `[${text.trim()}]`;
+    if (!truecolor)
+        return pc.bgGreen(pc.black(text));
+    const [r, g, b] = rgb(PALETTE.lime);
+    return `\x1b[48;2;${r};${g};${b}m${pc.black(pc.bold(text))}\x1b[49m`;
+}
+/**
+ * buff, the debuff mascot, as pixel art. Each string is a pixel row:
+ * L lime, H highlight, K ink, R red (oops), . transparent.
+ */
+const BUFF = {
+    idle: [".LLLLLL.", "LHHHHHHL", "LLKLLKLL", "LLKLLKLL", "LLLLLLLL", ".LLLLLL."],
+    happy: [".LLLLLL.", "LHHHHHHL", "LKLKKLKL", "LLLLLLLL", "LLKKKKLL", ".LLLLLL."],
+    oops: [".LLLLLL.", "LHHHHHHL", "LRLLLLRL", "LLRLLRLL", "LLLKKLLL", ".LLLLLL."],
+};
+const PIXEL = { L: PALETTE.lime, H: PALETTE.limeSoft, K: PALETTE.ink, R: PALETTE.red };
+/**
+ * buff rendered with half-block characters: two pixel rows per text line (3 lines tall).
+ * Returns no lines when the terminal can't show 24-bit colour, so callers can just skip it.
+ */
+export function buff(mood = "idle") {
+    if (!truecolor)
+        return [];
+    const rows = BUFF[mood];
+    const lines = [];
+    for (let y = 0; y < rows.length; y += 2) {
+        const top = rows[y] ?? "";
+        const bottom = rows[y + 1] ?? "";
+        let line = "";
+        for (let x = 0; x < top.length; x++) {
+            const t = PIXEL[top[x] ?? "."];
+            const b = PIXEL[bottom[x] ?? "."];
+            if (!t && !b)
+                line += " ";
+            else if (t && b)
+                line += `${fg(t)}${bg(b)}▀\x1b[0m`;
+            else if (t)
+                line += `${fg(t)}▀\x1b[0m`;
+            else if (b)
+                line += `${fg(b)}▄\x1b[0m`;
+        }
+        lines.push(line);
+    }
+    return lines;
+}
+/**
+ * buff beside up to three lines of text, for command headers and results.
+ * Falls back to the badge and text when buff can't be drawn.
+ */
+export function banner(mood, lines) {
+    const art = buff(mood);
+    if (!art.length)
+        return [`${badge()} ${lines[0] ?? ""}`, ...lines.slice(1).map((l) => `         ${l}`)].join("\n");
+    return art.map((row, i) => `  ${row}  ${lines[i] ?? ""}`).join("\n");
+}
+function rgb(hex) {
+    const n = Number.parseInt(hex.slice(1), 16);
+    return [(n >> 16) & 255, (n >> 8) & 255, n & 255];
+}
+const fg = (hex) => {
+    const [r, g, b] = rgb(hex);
+    return `\x1b[38;2;${r};${g};${b}m`;
+};
+const bg = (hex) => {
+    const [r, g, b] = rgb(hex);
+    return `\x1b[48;2;${r};${g};${b}m`;
+};
+//# sourceMappingURL=brand.js.map

package/dist/brand.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { runCreate } from "./interactive.js";
+const args = process.argv.slice(2);
+const flag = (n) => {
+    const i = args.indexOf(`--${n}`);
+    return i >= 0 ? args[i + 1] : undefined;
+};
+const dir = args.find((a, i) => !a.startsWith("-") && !args[i - 1]?.startsWith("--"));
+runCreate({ dir, template: flag("template"), yes: args.includes("--yes") || args.includes("-y") }).then((code) => process.exit(code), (err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE;IACzB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC,CAAC;AACF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAEtF,SAAS,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CACrG,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5B,CAAC,GAAY,EAAE,EAAE;IACf,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { amber, badge, banner, buff, LIME, lime, type Mood, PALETTE, type PaletteColor, paint, pink, sky, violet } from "./brand.js";
+export { type CreateOptions, runCreate } from "./interactive.js";
+export { OFFICIAL_TEMPLATES, type OfficialTemplate } from "./official.js";
+export { create, detectPackageManager, isEmptyDir, isRemoteTemplate, listTemplates, ownVersion, packageName, pinnedSource, resolveTemplate, type ScaffoldOptions, scaffold, scaffoldRemote, type TemplateInfo, templatesDir, } from "./scaffold.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACrI,OAAO,EAAE,KAAK,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACL,MAAM,EACN,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,KAAK,eAAe,EACpB,QAAQ,EACR,cAAc,EACd,KAAK,YAAY,EACjB,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { amber, badge, banner, buff, LIME, lime, PALETTE, paint, pink, sky, violet } from "./brand.js";
+export { runCreate } from "./interactive.js";
+export { OFFICIAL_TEMPLATES } from "./official.js";
+export { create, detectPackageManager, isEmptyDir, isRemoteTemplate, listTemplates, ownVersion, packageName, pinnedSource, resolveTemplate, scaffold, scaffoldRemote, templatesDir, } from "./scaffold.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAa,OAAO,EAAqB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACrI,OAAO,EAAsB,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAyB,MAAM,eAAe,CAAC;AAC1E,OAAO,EACL,MAAM,EACN,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EAEf,QAAQ,EACR,cAAc,EAEd,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/interactive.d.ts

@@ -0,0 +1,10 @@
+export interface CreateOptions {
+    dir?: string | undefined;
+    template?: string | undefined;
+    /** Accept defaults without prompting (CI, agents). */
+    yes?: boolean;
+}
+/** Interactive scaffold flow. Falls back to defaults when stdin is not a TTY so agents
+ *  and CI can call it non-interactively. */
+export declare function runCreate(options: CreateOptions): Promise<number>;
+//# sourceMappingURL=interactive.d.ts.map

package/dist/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../src/interactive.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,sDAAsD;IACtD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;4CAC4C;AAC5C,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAgDvE"}

package/dist/interactive.js

@@ -0,0 +1,57 @@
+import { relative } from "node:path";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { banner, lime, pink, sky } from "./brand.js";
+import { create, detectPackageManager, isEmptyDir, listTemplates, ownVersion, resolveTemplate } from "./scaffold.js";
+/** Interactive scaffold flow. Falls back to defaults when stdin is not a TTY so agents
+ *  and CI can call it non-interactively. */
+export async function runCreate(options) {
+    const interactive = process.stdin.isTTY && !options.yes;
+    console.log(`\n${banner("idle", [`${lime(pc.bold("debuff"))} ${pc.dim(`v${ownVersion()}`)}`, pc.bold("let's make a game"), pc.dim(pc.italic("more room for play"))])}\n`);
+    let dir = options.dir;
+    if (!dir) {
+        if (!interactive) {
+            p.cancel("Pass a directory: create-debuff <dir>");
+            return 1;
+        }
+        const answer = await p.text({
+            message: "Where should we create your game?",
+            placeholder: "./my-game",
+            defaultValue: "my-game",
+            validate: (v) => (v && !isEmptyDir(v) ? "That directory is not empty" : undefined),
+        });
+        if (p.isCancel(answer))
+            return cancelled();
+        dir = answer;
+    }
+    if (!isEmptyDir(dir)) {
+        p.cancel(`${dir} is not empty`);
+        return 1;
+    }
+    const templates = listTemplates();
+    let template = options.template;
+    if (!template && interactive && templates.length > 1) {
+        const answer = await p.select({
+            message: "Pick a template",
+            options: templates.map((t) => ({ value: t.id, label: t.title, hint: t.description })),
+        });
+        if (p.isCancel(answer))
+            return cancelled();
+        template = answer;
+    }
+    const s = p.spinner();
+    const resolved = resolveTemplate(template ?? "basic");
+    s.start(resolved.kind === "remote" ? `Downloading ${resolved.source}` : "Scaffolding");
+    const dest = await create({ dir, ...(template ? { template } : {}) });
+    s.stop(`Created ${lime(relative(process.cwd(), dest) || ".")}`);
+    const pm = detectPackageManager();
+    const run = pm === "npm" ? "npm run" : pm;
+    p.note([`cd ${relative(process.cwd(), dest) || "."}`, `${pm} install`, `${run} dev`].map((c) => sky(c)).join("\n"), "Next steps");
+    console.log(`\n${banner("happy", [lime(pc.bold("happy jamming!")), `${pc.dim("buff is waiting in")} ${pink("src/main.ts")}`, ""])}\n`);
+    return 0;
+}
+function cancelled() {
+    p.cancel("Cancelled");
+    return 1;
+}
+//# sourceMappingURL=interactive.js.map

package/dist/interactive.js.map

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

package/dist/official.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Official templates that are not bundled into the create-debuff package. They're downloaded on
+ * demand from the debuff repo, so adding templates never grows the npm download.
+ */
+export interface OfficialTemplate {
+    id: string;
+    title: string;
+    description: string;
+    /** giget source: where the template lives in the debuff repo. `create()` pins it to this release's tag. */
+    source: string;
+}
+export declare const OFFICIAL_TEMPLATES: readonly OfficialTemplate[];
+//# sourceMappingURL=official.d.ts.map

package/dist/official.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"official.d.ts","sourceRoot":"","sources":["../src/official.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,2GAA2G;IAC3G,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAczD,CAAC"}

package/dist/official.js

@@ -0,0 +1,15 @@
+export const OFFICIAL_TEMPLATES = [
+    {
+        id: "platformer",
+        title: "Platformer",
+        description: "buff runs and jumps through a Tiled level: tilemap, collision, atlas, tunable movement, coins",
+        source: "github:debuffjp/debuff/templates/platformer",
+    },
+    {
+        id: "mossfell",
+        title: "Mossfell",
+        description: "Top-down action-adventure: screen-by-screen scrolling, sword combat, hearts, enemies, a key and locked door, a small dungeon",
+        source: "github:debuffjp/debuff/templates/mossfell",
+    },
+];
+//# sourceMappingURL=official.js.map

package/dist/official.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"official.js","sourceRoot":"","sources":["../src/official.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,+FAA+F;QAC5G,MAAM,EAAE,6CAA6C;KACtD;IACD;QACE,EAAE,EAAE,UAAU;QACd,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,8HAA8H;QAChI,MAAM,EAAE,2CAA2C;KACpD;CACF,CAAC"}

package/dist/scaffold.d.ts

@@ -0,0 +1,45 @@
+/** Templates ship inside the published package (copied at build) and live at the repo
+ *  root during development. */
+export declare function templatesDir(): string;
+export interface TemplateInfo {
+    id: string;
+    title: string;
+    description: string;
+}
+/** Every template: local ones plus official templates that download on demand. */
+export declare function listTemplates(): TemplateInfo[];
+/**
+ * Where a template comes from: a local folder (bundled, or the repo checkout during development),
+ * an official template's git source, or a git source given directly.
+ */
+export declare function resolveTemplate(template: string): {
+    kind: "local";
+    dir: string;
+} | {
+    kind: "remote";
+    source: string;
+};
+export interface ScaffoldOptions {
+    dir: string;
+    template?: string;
+    /** Package name; defaults to the directory name. */
+    name?: string;
+}
+export declare function packageName(dir: string): string;
+export declare function isEmptyDir(dir: string): boolean;
+/** Copy a template into `dir`. Throws if `dir` is non-empty. Returns the resolved path. */
+/** Git-hosted templates: `github:user/repo`, `gitlab:user/repo/subdir#ref`, also `bitbucket:` and `sourcehut:`. */
+export declare function isRemoteTemplate(template: string): boolean;
+/** Download a git-hosted template (via giget, no git binary needed) and scaffold from it. */
+export declare function scaffoldRemote(options: ScaffoldOptions & {
+    template: string;
+}): Promise<string>;
+/** Scaffold from a local template. Use `create()` to also handle official and git-hosted templates. */
+export declare function scaffold(options: ScaffoldOptions): string;
+/** Scaffold from any template: local, official (downloaded on demand) or a git source. */
+export declare function create(options: ScaffoldOptions): Promise<string>;
+/** Pin an official template to the git tag of this create-debuff release, so it matches the published CLI. */
+export declare function pinnedSource(source: string, version: string): string;
+export declare function ownVersion(): string;
+export declare function detectPackageManager(): "npm" | "pnpm" | "yarn" | "bun";
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAQA;+BAC+B;AAC/B,wBAAgB,YAAY,IAAI,MAAM,CAUrC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAcD,kFAAkF;AAClF,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAQ9C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWrH;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,2FAA2F;AAC3F,mHAAmH;AACnH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,6FAA6F;AAC7F,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAYrG;AAED,uGAAuG;AACvG,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAOzD;AAED,0FAA0F;AAC1F,wBAAsB,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAItE;AAuBD,8GAA8G;AAC9G,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,oBAAoB,IAAI,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAMtE"}

package/dist/scaffold.js

@@ -0,0 +1,147 @@
+import { cpSync, existsSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, join, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { OFFICIAL_TEMPLATES } from "./official.js";
+const here = dirname(fileURLToPath(import.meta.url));
+/** Templates ship inside the published package (copied at build) and live at the repo
+ *  root during development. */
+export function templatesDir() {
+    // Installed from npm: the bundled copy. In a repo checkout: the repo's templates/, so a stale
+    // bundled copy left by `npm pack` can never shadow the real templates during development.
+    const bundled = join(here, "..", "templates");
+    const repo = join(here, "..", "..", "..", "templates");
+    const installed = here.split(sep).includes("node_modules");
+    for (const dir of installed ? [bundled] : [repo, bundled]) {
+        if (existsSync(dir))
+            return dir;
+    }
+    throw new Error("create-debuff: templates directory not found");
+}
+/** Templates available locally (bundled in the package, or every template in a repo checkout). */
+function localTemplates() {
+    const dir = templatesDir();
+    return readdirSync(dir)
+        .filter((id) => existsSync(join(dir, id, "package.json")))
+        .map((id) => {
+        const meta = join(dir, id, "template.json");
+        const info = existsSync(meta) ? JSON.parse(readFileSync(meta, "utf8")) : {};
+        return { id, title: info.title ?? id, description: info.description ?? "" };
+    });
+}
+/** Every template: local ones plus official templates that download on demand. */
+export function listTemplates() {
+    const local = localTemplates();
+    const remote = OFFICIAL_TEMPLATES.filter((t) => !local.some((l) => l.id === t.id)).map(({ id, title, description }) => ({
+        id,
+        title,
+        description,
+    }));
+    return [...local, ...remote];
+}
+/**
+ * Where a template comes from: a local folder (bundled, or the repo checkout during development),
+ * an official template's git source, or a git source given directly.
+ */
+export function resolveTemplate(template) {
+    if (isRemoteTemplate(template))
+        return { kind: "remote", source: template };
+    const dir = join(templatesDir(), template);
+    if (existsSync(join(dir, "package.json")))
+        return { kind: "local", dir };
+    const official = OFFICIAL_TEMPLATES.find((t) => t.id === template);
+    if (official)
+        return { kind: "remote", source: pinnedSource(official.source, ownVersion()) };
+    throw new Error(`Unknown template "${template}". Available: ${listTemplates()
+        .map((t) => t.id)
+        .join(", ")}, or a git source like github:user/repo`);
+}
+export function packageName(dir) {
+    return (basename(resolve(dir))
+        .toLowerCase()
+        .replace(/[^a-z0-9-~._]/g, "-")
+        .replace(/^[._-]+/, "") || "debuff-game");
+}
+export function isEmptyDir(dir) {
+    return !existsSync(dir) || readdirSync(dir).length === 0;
+}
+/** Copy a template into `dir`. Throws if `dir` is non-empty. Returns the resolved path. */
+/** Git-hosted templates: `github:user/repo`, `gitlab:user/repo/subdir#ref`, also `bitbucket:` and `sourcehut:`. */
+export function isRemoteTemplate(template) {
+    return /^(github|gitlab|bitbucket|sourcehut):/.test(template);
+}
+/** Download a git-hosted template (via giget, no git binary needed) and scaffold from it. */
+export async function scaffoldRemote(options) {
+    const dest = resolve(options.dir);
+    if (!isEmptyDir(dest))
+        throw new Error(`${dest} is not empty`);
+    const { downloadTemplate } = await import("giget");
+    const staging = mkdtempSync(join(tmpdir(), "create-debuff-"));
+    try {
+        const { dir } = await downloadTemplate(options.template, { dir: join(staging, "template"), force: true });
+        if (!existsSync(join(dir, "package.json")))
+            throw new Error(`Template "${options.template}" has no package.json at its root`);
+        return copyTemplate(dir, dest, options.name);
+    }
+    finally {
+        rmSync(staging, { recursive: true, force: true });
+    }
+}
+/** Scaffold from a local template. Use `create()` to also handle official and git-hosted templates. */
+export function scaffold(options) {
+    const dest = resolve(options.dir);
+    if (!isEmptyDir(dest))
+        throw new Error(`${dest} is not empty`);
+    const resolved = resolveTemplate(options.template ?? "basic");
+    if (resolved.kind === "remote")
+        throw new Error(`"${options.template}" downloads from ${resolved.source}; use create() or scaffoldRemote()`);
+    return copyTemplate(resolved.dir, dest, options.name);
+}
+/** Scaffold from any template: local, official (downloaded on demand) or a git source. */
+export async function create(options) {
+    const resolved = resolveTemplate(options.template ?? "basic");
+    if (resolved.kind === "local")
+        return scaffold(options);
+    return scaffoldRemote({ ...options, template: resolved.source });
+}
+function copyTemplate(src, dest, name) {
+    const skip = new Set(["template.json", "node_modules", "dist", ".debuff", ".git"]);
+    cpSync(src, dest, { recursive: true, filter: (p) => !skip.has(basename(p)) });
+    // npm strips .gitignore from published packages, so templates ship it without the dot.
+    if (existsSync(join(dest, "gitignore")))
+        renameSync(join(dest, "gitignore"), join(dest, ".gitignore"));
+    const pkgPath = join(dest, "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    pkg.name = name ?? packageName(dest);
+    const version = ownVersion();
+    // Pin @debuffjp/* to this release; the 0.0.0 placeholders are only meaningful inside the monorepo.
+    if (version !== "0.0.0") {
+        for (const field of ["dependencies", "devDependencies"]) {
+            const deps = pkg[field];
+            if (typeof deps === "object")
+                for (const dep of Object.keys(deps))
+                    if (dep.startsWith("@debuffjp/"))
+                        deps[dep] = `^${version}`;
+        }
+    }
+    writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+    return dest;
+}
+/** Pin an official template to the git tag of this create-debuff release, so it matches the published CLI. */
+export function pinnedSource(source, version) {
+    return version === "0.0.0" || source.includes("#") ? source : `${source}#create-debuff@${version}`;
+}
+export function ownVersion() {
+    return JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8")).version;
+}
+export function detectPackageManager() {
+    const ua = process.env.npm_config_user_agent ?? "";
+    if (ua.startsWith("pnpm"))
+        return "pnpm";
+    if (ua.startsWith("yarn"))
+        return "yarn";
+    if (ua.startsWith("bun"))
+        return "bun";
+    return "npm";
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "create-debuff",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Scaffold a new debuff game: npm create debuff",
+  "keywords": [
+    "game",
+    "gamedev",
+    "game-engine",
+    "2d",
+    "html5-game",
+    "browser-game",
+    "debuff",
+    "create",
+    "scaffold",
+    "template",
+    "starter",
+    "game-jam"
+  ],
+  "license": "MIT",
+  "homepage": "https://debuff.jp",
+  "bugs": "https://github.com/debuffjp/debuff/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/debuffjp/debuff.git",
+    "directory": "tooling/create-debuff"
+  },
+  "type": "module",
+  "bin": {
+    "create-debuff": "bin/create-debuff.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "bin",
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "prepack": "node scripts/copy-templates.mjs"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.8.1",
+    "giget": "^3.3.1",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  }
+}

package/templates/basic/.mcp.json

@@ -0,0 +1,5 @@
+{
+  "mcpServers": {
+    "debuff": { "command": "npx", "args": ["-y", "@debuffjp/mcp"] }
+  }
+}

package/templates/basic/AGENTS.md

@@ -0,0 +1,38 @@
+# Agent guide
+
+This is a 2D browser game made with **debuff** (https://debuff.jp). These notes are for AI coding agents working on it. The human you're working with makes the creative calls; you do the implementation, testing and chores.
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `npm run dev` | Dev server with hot reload. Press <kbd>`</kbd> in the game for the dev panel |
+| `npm test` | Runs `scenarios/*.json` in a headless browser and compares screenshots |
+| `npx debuff fuzz` | Plays the game with random input for a few minutes. Each crash, stuck state or back-and-forth loop is saved as a scenario in `.debuff/fuzz/` that replays it exactly |
+| `npm run build` | Type-checks, builds to `dist/` and prints a size report. Fails if dev-only code leaks |
+| `npm run assets` | Regenerates the asset manifest and lists unused assets |
+| `npx debuff inspect` | Project summary as JSON: packages, plugins, assets, last build size |
+| `npx debuff scenario --update` | Accept new screenshot baselines. **Only after the human has approved the visual change** |
+
+## Layout
+
+- `src/main.ts`: the game, which creates `new Game(...)`, scenes (`update`, `render`, `inspect`) and params.
+- `assets/`: source art, audio and data. The manifest and atlases are generated from it, and only files the game references ship. Don't edit generated files.
+- `scenarios/`: JSON test scripts (steps, inputs, expectations, captures). Add one for each mechanic you build.
+- `.mcp.json`: connects the debuff MCP server, so you can play and inspect the running game.
+
+## Work loop
+
+1. **Look before you change.** With the MCP server, call `game_start`. If the human has the game open under `npm run dev`, you attach to it live, so read `game_notes` first: they're moments the human flagged, and `game_replay` with a note's tick saves a scenario that reproduces it. Then use `game_state`, `game_capture` and `game_errors`.
+2. **Tune before you rewrite.** Feel values (speed, gravity, timings) live in `game.params.define(...)`. Change them with `game_set_param` and show the human before editing code. The human can undo your changes in the dev panel.
+3. **Make the smallest change that works.** Keep dev-only code inside `if (import.meta.env.DEV)`.
+4. **Verify.** Run `npm test` and `npm run build`, and check `game_errors` is empty. Before calling a feature done, run `npx debuff fuzz`: to fix a finding, replay its file with `npx debuff scenario <file>`, fix, and replay again until it passes. Errors come back explained: `kind` says whose bug it is (`your-code`, `debuff-usage`, `debuff-bug`, `outside`) and `where` gives the source line.
+5. **Report** what changed, what you verified, and anything you couldn't check.
+
+## Rules
+
+- **Creative direction belongs to the human:** art, feel, difficulty, story and names. Propose two or three options; don't decide.
+- Don't update screenshot baselines (`--update`) without the human's say-so.
+- If `game_errors` reports `debuff-bug`, it's a bug in debuff, not this game. Tell the human and share its `reportUrl`; don't work around debuff internals.
+- Prefer debuff's APIs (`draw`, `input`, `assets`, `params`, `juice`) over adding new runtime dependencies. The game should stay small.
+- API reference: https://debuff.jp/api/ · Guides: https://debuff.jp/docs/getting-started

package/templates/basic/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/templates/basic/gitignore

@@ -0,0 +1,3 @@
+node_modules/
+dist/
+.debuff/

package/templates/basic/index.html

@@ -0,0 +1,18 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>My debuff game</title>
+    <style>
+      html, body { margin: 0; height: 100%; background: #0a0c08; overflow: hidden; }
+      /* The game scales the canvas to fit this container (see GameOptions.scale). */
+      #app { position: fixed; inset: 0; display: grid; place-items: center; }
+      canvas { display: block; outline: none; }
+    </style>
+  </head>
+  <body>
+    <main id="app"><canvas id="game" tabindex="0"></canvas></main>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/basic/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@debuffjp/template-basic",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "debuff dev",
+    "build": "tsc --noEmit && debuff build",
+    "assets": "debuff assets",
+    "test": "debuff scenario"
+  },
+  "dependencies": {
+    "@debuffjp/audio": "0.2.0",
+    "@debuffjp/core": "0.2.0",
+    "@debuffjp/input": "0.2.0",
+    "@debuffjp/juice": "0.2.0"
+  },
+  "devDependencies": {
+    "@debuffjp/cli": "0.2.0",
+    "typescript": "^7.0.2",
+    "@debuffjp/dev": "0.2.0"
+  }
+}

package/templates/basic/scenarios/move-and-pop.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "../node_modules/@debuffjp/cli/schema/scenario.schema.json",
+  "steps": [
+    {
+      "wait": 10
+    },
+    {
+      "expect": {
+        "scene": {
+          "eq": "play"
+        },
+        "renderer": {
+          "eq": "webgl2"
+        },
+        "state.player.x": {
+          "eq": 160
+        }
+      }
+    },
+    {
+      "press": "ArrowRight"
+    },
+    {
+      "wait": 30
+    },
+    {
+      "release": "ArrowRight"
+    },
+    {
+      "expect": {
+        "state.player.x": {
+          "gt": 200
+        }
+      }
+    },
+    {
+      "set": {
+        "player.speed": 400
+      }
+    },
+    {
+      "press": "Space"
+    },
+    {
+      "wait": 1
+    },
+    {
+      "release": "Space"
+    },
+    {
+      "wait": 4
+    },
+    {
+      "expect": {
+        "state.pops": {
+          "eq": 1
+        },
+        "state.particles": {
+          "gt": 0
+        }
+      }
+    },
+    {
+      "capture": "popped"
+    },
+    {
+      "wait": 60
+    },
+    {
+      "capture": "settled"
+    }
+  ]
+}

package/templates/basic/src/main.ts

@@ -0,0 +1,79 @@
+import { Audio } from "@debuffjp/audio";
+import { approach, clamp, Game, lerp, type Scene, Storage } from "@debuffjp/core";
+import { devOverlay, devTools } from "@debuffjp/dev";
+import { Input } from "@debuffjp/input";
+import { Particles, squash, Tweens } from "@debuffjp/juice";
+
+const canvas = document.querySelector<HTMLCanvasElement>("#game");
+if (!canvas) throw new Error('Missing <canvas id="game">');
+
+const game = new Game({ canvas, width: 320, height: 180, background: "#11140d" });
+const input = new Input(game, {
+  bindings: {
+    left: ["ArrowLeft", "KeyA", "PadLeft", "PadStickLeft"],
+    right: ["ArrowRight", "KeyD", "PadRight", "PadStickRight"],
+    pop: ["Space", "PadA", "Pointer"],
+  },
+});
+const audio = new Audio();
+const tweens = new Tweens();
+const particles = new Particles(() => game.random.next());
+const save = new Storage("my-game", { pops: 0 });
+
+// Creative parameters: typed, ranged and live-tunable.
+// Try in the console: __DEBUFF_DEV__.setParam("player", "speed", 300)
+const tuning = game.params.define("player", {
+  speed: { type: "number", default: 140, min: 0, max: 600, units: "px/s" },
+  accel: { type: "number", default: 1200, min: 0, max: 5000, units: "px/s²" },
+});
+
+// prevX is where buff was a step ago: render blends toward x so motion stays smooth on fast displays.
+const player = { x: 160, prevX: 160, y: 120, vx: 0, scaleX: 1, scaleY: 1 };
+
+const play: Scene = {
+  id: "play",
+
+  update(dt) {
+    player.prevX = player.x;
+    let dir = input.axis("left", "right");
+    if (input.pointer.down) dir = Math.sign(input.pointer.x - player.x);
+    player.vx = approach(player.vx, dir * tuning.values.speed, tuning.values.accel * dt);
+    player.x = clamp(player.x + player.vx * dt, 8, game.width - 8);
+
+    if (input.pressed("pop")) {
+      save.set("pops", save.get("pops") + 1);
+      squash(tweens, player, 0.35);
+      particles.emit({ x: player.x, y: player.y - 8, count: 16, colors: ["#cffb2d", "#f3fecb"], gravity: 200 });
+      game.camera.shake(0.3);
+      audio.synth({ freq: 660, freqEnd: 220, decay: 0.15 });
+    }
+    tweens.update(dt);
+    particles.update(dt);
+  },
+
+  render(draw, alpha) {
+    draw.withCamera(game.camera, () => {
+      // buff, the debuff mascot: a lime block with eyes, squashing from its feet.
+      draw.push();
+      draw.translate(lerp(player.prevX, player.x, alpha), player.y);
+      draw.scale(player.scaleX, player.scaleY);
+      draw.rect(-8, -16, 16, 16, "#cffb2d");
+      draw.rect(-5, -12, 3, 4, "#11140d");
+      draw.rect(2, -12, 3, 4, "#11140d");
+      draw.pop();
+      particles.draw(draw);
+    });
+  },
+
+  // Snapshot for scenarios and agents (dev only).
+  inspect() {
+    return { player: { x: Math.round(player.x), vx: Math.round(player.vx) }, pops: save.get("pops"), particles: particles.count };
+  },
+};
+
+game.add(play).go("play");
+game.start();
+
+// Dev-only plugins: window.__DEBUFF_DEV__ for scenarios and agents, and an overlay (toggle with `) with
+// a frame-time graph and live sliders for every param. Both are stripped from production builds.
+if (import.meta.env.DEV) game.use(devTools({ input })).use(devOverlay());

package/templates/basic/template.json

@@ -0,0 +1,5 @@
+{
+  "title": "Basic",
+  "bundled": true,
+  "description": "Minimal starter: buff on a WebGL2 canvas with input, juice, audio, dev tools and a scenario"
+}

package/templates/basic/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "types": ["@debuffjp/cli/client"],
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}