@debuffjp/cli 0.0.0-stage → 0.2.0

package/dist/vite-plugin.js

@@ -0,0 +1,122 @@
+import { existsSync, readFileSync } from "node:fs";
+import { extname, join, resolve, sep } from "node:path";
+import { attachAgentLink } from "./agent-link.js";
+import { compileAssets } from "./assets/compile.js";
+export const ASSETS_DIR = "assets";
+const URL_PREFIX = `/${ASSETS_DIR}/`;
+const MIME = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".avif": "image/avif",
+    ".gif": "image/gif",
+    ".json": "application/json",
+    ".ogg": "audio/ogg",
+    ".opus": "audio/ogg",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".m4a": "audio/mp4",
+    ".txt": "text/plain; charset=utf-8",
+};
+/**
+ * Serves `<root>/assets/` through the asset pipeline: `/assets/manifest.json` and every file the
+ * manifest references, in dev from memory and in builds as emitted files. Files the manifest doesn't
+ * reference are not served or shipped.
+ */
+export function debuff(options = {}) {
+    let root = process.cwd();
+    let current;
+    const compile = () => {
+        current = compileAssets(root, {
+            plugins: options.plugins ?? [],
+            ...(options.atlas === undefined ? {} : { atlas: options.atlas }),
+        }).then((r) => {
+            for (const w of r.warnings)
+                console.warn(`[debuff] ${w}`);
+            return r;
+        });
+        return current;
+    };
+    const latest = () => current ?? compile();
+    /** Bytes for a URL path under /assets/, or undefined if the manifest doesn't reference it. */
+    const read = (r, rel) => {
+        if (rel === "manifest.json")
+            return Buffer.from(`${JSON.stringify(r.manifest, null, 2)}\n`);
+        const generated = r.outputs.get(rel);
+        if (generated)
+            return generated;
+        const referenced = Object.values(r.manifest.assets).some((a) => a.src === `${ASSETS_DIR}/${rel}`);
+        const file = resolve(root, ASSETS_DIR, rel);
+        const inside = file.startsWith(resolve(root, ASSETS_DIR) + sep);
+        return referenced && inside && existsSync(file) ? readFileSync(file) : undefined;
+    };
+    const core = {
+        name: "debuff",
+        configResolved(config) {
+            root = config.root;
+        },
+        buildStart() {
+            compile();
+        },
+        configureServer(server) {
+            const dir = join(root, ASSETS_DIR);
+            server.watcher.add(dir);
+            const onChange = (file) => {
+                if (!file.startsWith(dir))
+                    return;
+                compile().then(() => server.ws.send({ type: "full-reload" }));
+            };
+            server.watcher.on("add", onChange);
+            server.watcher.on("unlink", onChange);
+            server.watcher.on("change", onChange);
+            if (options.agentLink)
+                attachAgentLink(server, root);
+            server.middlewares.use(async (req, res, next) => {
+                const url = req.url?.split("?")[0];
+                if (!url?.startsWith(URL_PREFIX))
+                    return next();
+                const rel = decodeURIComponent(url.slice(URL_PREFIX.length));
+                const body = read(await latest(), rel);
+                if (!body) {
+                    res.statusCode = 404;
+                    res.end(`[debuff] ${rel} is not in the asset manifest. Run \`debuff assets\` to see what was imported.`);
+                    return;
+                }
+                res.setHeader("Content-Type", MIME[extname(rel).toLowerCase()] ?? "application/octet-stream");
+                res.setHeader("Cache-Control", "no-cache");
+                res.end(body);
+            });
+        },
+        // Preload the manifest and the default group's images so they download alongside the code,
+        // instead of only after the game script has run and asked for them.
+        async transformIndexHtml() {
+            const r = await latest();
+            const images = new Set();
+            for (const a of Object.values(r.manifest.assets))
+                if (a.type === "image" && !a.group)
+                    images.add(a.src);
+            return [
+                {
+                    tag: "link",
+                    attrs: { rel: "preload", href: `${ASSETS_DIR}/manifest.json`, as: "fetch", crossorigin: "anonymous" },
+                    injectTo: "head",
+                },
+                ...[...images].map((href) => ({ tag: "link", attrs: { rel: "preload", href, as: "image" }, injectTo: "head" })),
+            ];
+        },
+        async generateBundle() {
+            const r = await latest();
+            const files = new Set(["manifest.json", ...r.outputs.keys()]);
+            for (const a of Object.values(r.manifest.assets))
+                files.add(a.src.slice(ASSETS_DIR.length + 1));
+            for (const rel of files) {
+                const source = read(r, rel);
+                if (source)
+                    this.emitFile({ type: "asset", fileName: `${ASSETS_DIR}/${rel}`, source });
+            }
+        },
+    };
+    return [core, ...(options.plugins ?? []).map((p) => p.vite ?? null)];
+}
+//# sourceMappingURL=vite-plugin.js.map

package/dist/vite-plugin.js.map

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

package/dist/vite.d.ts

@@ -0,0 +1,13 @@
+import type { InlineConfig, ViteDevServer } from "vite";
+import { type ResolvedConfig } from "./config.js";
+/** Vite config for a debuff project: loads `debuff.config.ts` and respects a project's own vite.config. */
+export declare function viteConfig(root: string, extra?: InlineConfig, config?: ResolvedConfig, link?: {
+    agentLink?: boolean;
+}): Promise<InlineConfig>;
+export declare function createDevServer(root: string, options?: {
+    port?: number;
+    host?: boolean;
+    logLevel?: InlineConfig["logLevel"];
+    agentLink?: boolean;
+}): Promise<ViteDevServer>;
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAK9D,2GAA2G;AAC3G,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,YAAiB,EACxB,MAAM,CAAC,EAAE,cAAc,EACvB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,YAAY,CAAC,CAUvB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACxG,OAAO,CAAC,aAAa,CAAC,CAaxB"}

package/dist/vite.js

@@ -0,0 +1,25 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { loadConfig } from "./config.js";
+import { debuff } from "./vite-plugin.js";
+const VITE_CONFIG_FILES = ["vite.config.ts", "vite.config.mts", "vite.config.js", "vite.config.mjs"];
+/** Vite config for a debuff project: loads `debuff.config.ts` and respects a project's own vite.config. */
+export async function viteConfig(root, extra = {}, config, link = {}) {
+    const resolved = config ?? (await loadConfig(root));
+    const hasViteConfig = VITE_CONFIG_FILES.some((f) => existsSync(join(root, f)));
+    return {
+        root,
+        // Relative asset URLs, so a build works from any folder (itch.io, GitHub Pages, a /play/ subpath).
+        ...(hasViteConfig ? {} : { configFile: false, base: "./" }),
+        plugins: debuff({ plugins: resolved.plugins, atlas: resolved.atlas, agentLink: link.agentLink ?? false }),
+        ...extra,
+    };
+}
+export async function createDevServer(root, options = {}) {
+    const { createServer } = await import("vite");
+    return createServer(await viteConfig(root, {
+        ...(options.logLevel ? { logLevel: options.logLevel } : {}),
+        server: { port: options.port ?? 5173, strictPort: false, host: options.host ?? false },
+    }, undefined, { agentLink: options.agentLink ?? false }));
+}
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAuB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,iBAAiB,GAAG,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AAErG,2GAA2G;AAC3G,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,KAAK,GAAiB,EAAE,EACxB,MAAuB,EACvB,IAAI,GAA4B,EAAE;IAElC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,OAAO;QACL,IAAI;QACJ,mGAAmG;QACnG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC3D,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC;QACzG,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,OAAO,GAAgG,EAAE;IAEzG,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,YAAY,CACjB,MAAM,UAAU,CACd,IAAI,EACJ;QACE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,EAAE;KACvF,EACD,SAAS,EACT,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE,CAC1C,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,73 @@
 {
   "name": "@debuffjp/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "The debuff CLI: dev server, builds with size reports, assets, scenarios",
+  "keywords": [
+    "game",
+    "gamedev",
+    "game-engine",
+    "2d",
+    "html5-game",
+    "browser-game",
+    "debuff",
+    "cli",
+    "vite",
+    "build",
+    "testing",
+    "fuzzing"
+  ],
+  "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/cli"
+  },
+  "type": "module",
+  "bin": {
+    "debuff": "bin/debuff.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./schema/scenario.schema.json": "./schema/scenario.schema.json",
+    "./client": {
+      "types": "./client.d.ts"
+    }
+  },
+  "files": [
+    "bin",
+    "aseprite",
+    "dist",
+    "schema",
+    "README.md",
+    "client.d.ts"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.8.1",
+    "cac": "^7.1.0",
+    "create-debuff": "0.2.0",
+    "fast-png": "^8.0.0",
+    "picocolors": "^1.1.1",
+    "playwright-core": "^1.64.1",
+    "vite": "^8.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  }
+}

package/schema/scenario.schema.json

@@ -0,0 +1,120 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/debuffjp/debuff/main/tooling/cli/schema/scenario.schema.json",
+  "title": "debuff scenario",
+  "description": "Deterministic gameplay scenario run by `debuff scenario`. Time only advances through `wait` steps.",
+  "type": "object",
+  "required": ["steps"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "type": "string" },
+    "name": { "type": "string", "description": "Defaults to the file name." },
+    "page": { "type": "string", "description": "Path to open on the dev server.", "default": "/" },
+    "steps": { "type": "array", "items": { "$ref": "#/$defs/step" } }
+  },
+  "$defs": {
+    "point": { "type": "array", "prefixItems": [{ "type": "number" }, { "type": "number" }], "minItems": 2, "maxItems": 2 },
+    "comparison": {
+      "type": "object",
+      "description": "All given conditions must hold.",
+      "additionalProperties": false,
+      "properties": {
+        "eq": { "description": "Deep equality." },
+        "gt": { "type": "number" },
+        "gte": { "type": "number" },
+        "lt": { "type": "number" },
+        "lte": { "type": "number" },
+        "approx": { "$ref": "#/$defs/point", "description": "[target, tolerance]" }
+      }
+    },
+    "step": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["wait"],
+          "additionalProperties": false,
+          "properties": { "wait": { "type": "integer", "minimum": 0, "description": "Advance N fixed simulation steps." } }
+        },
+        {
+          "type": "object",
+          "required": ["press"],
+          "additionalProperties": false,
+          "properties": { "press": { "type": "string", "description": "KeyboardEvent.code to hold, e.g. \"Space\"." } }
+        },
+        { "type": "object", "required": ["release"], "additionalProperties": false, "properties": { "release": { "type": "string" } } },
+        {
+          "type": "object",
+          "required": ["tap"],
+          "additionalProperties": false,
+          "properties": { "tap": { "$ref": "#/$defs/point", "description": "Logical [x, y]." } }
+        },
+        {
+          "type": "object",
+          "required": ["pointerDown"],
+          "additionalProperties": false,
+          "properties": { "pointerDown": { "$ref": "#/$defs/point" } }
+        },
+        {
+          "type": "object",
+          "required": ["pointerMove"],
+          "additionalProperties": false,
+          "properties": { "pointerMove": { "$ref": "#/$defs/point" } }
+        },
+        { "type": "object", "required": ["pointerUp"], "additionalProperties": false, "properties": { "pointerUp": { "const": true } } },
+        {
+          "type": "object",
+          "required": ["set"],
+          "additionalProperties": false,
+          "properties": {
+            "set": {
+              "type": "object",
+              "description": "Params to set, keyed \"group.key\".",
+              "propertyNames": { "pattern": "^[^.]+\\..+$" },
+              "additionalProperties": { "type": ["number", "boolean"] }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["command"],
+          "additionalProperties": false,
+          "properties": {
+            "command": { "type": "string", "description": "A command the game registered with devTools({ commands })." },
+            "args": { "type": "array", "description": "Arguments passed to the command." }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["expect"],
+          "additionalProperties": false,
+          "properties": {
+            "expect": {
+              "type": "object",
+              "description": "Dotted paths into dev state (scene, tick, time, frozen, stats.*, state.*).",
+              "additionalProperties": { "$ref": "#/$defs/comparison" }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["capture"],
+          "additionalProperties": false,
+          "properties": {
+            "capture": {
+              "type": "string",
+              "pattern": "^[\\w-]+$",
+              "description": "Screenshot name, compared to the per-platform baseline."
+            },
+            "tolerance": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1,
+              "default": 0.002,
+              "description": "Max fraction of differing pixels."
+            }
+          }
+        }
+      ]
+    }
+  }
+}