@debuffjp/cli 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,64 @@
-# Temporary Holding Version
+# @debuffjp/cli
 
-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.
+The `debuff` command: dev server, production builds with size reports, asset manifests, browser scenarios and project inspection. Built on Vite.
+
+```bash
+npm install -D @debuffjp/cli
+npx debuff --help
+```
+
+| Command | What it does |
+| --- | --- |
+| `debuff create [dir]` | Scaffold a game (same as `npm create debuff`) |
+| `debuff dev [--port] [--host]` | Dev server with hot reload; regenerates the asset manifest on change |
+| `debuff build [--sourcemap]` | Production build, then a raw/gzip/brotli report. Fails if dev-only code leaks |
+| `debuff report` | Size report for an existing `dist/` |
+| `debuff assets` | Run the asset pipeline: list every asset, its importer and size, plus unused and generated files |
+| `debuff scenario [files] [--update] [--strict]` | Run `scenarios/*.json` in headless Chrome/Edge |
+| `debuff inspect` | JSON summary of the project |
+
+Add `--json` for machine-readable output and `--root <dir>` to target another project.
+
+## Scenarios
+
+```json
+{
+  "$schema": "../node_modules/@debuffjp/cli/schema/scenario.schema.json",
+  "steps": [
+    { "press": "ArrowRight" },
+    { "wait": 30 },
+    { "expect": { "state.player.x": { "gt": 200 } } },
+    { "set": { "player.speed": 400 } },
+    { "capture": "after-move" }
+  ]
+}
+```
+
+Time advances only through `wait` steps, so runs are deterministic. Captures are compared against per-platform baselines in `scenarios/__baselines__/`. A missing baseline is recorded unless you pass `--strict`. Set `DEBUFF_BROWSER` to use a specific Chromium build.
+
+## Programmatic use
+
+```ts
+import { buildReport, compileAssets, runScenarios } from "@debuffjp/cli";
+```
+
+## Assets and plugins
+
+Put source assets in `assets/`. The pipeline builds an in-memory manifest (`/assets/manifest.json`). Only files the manifest references are served in dev and emitted in builds, and sources are never modified.
+
+Add tooling plugins in `debuff.config.ts`:
+
+```ts
+import { defineConfig } from "@debuffjp/cli";
+
+export default defineConfig({
+  plugins: [
+    {
+      name: "maps",
+      apiVersion: 1,
+      // Any language: SourceFile JSON on stdin, ImportResult JSON on stdout.
+      assets: [{ name: "maps", extensions: [".map"], command: ["python", "tools/import_map.py"] }],
+    },
+  ],
+});
+```

package/bin/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/client.d.ts

@@ -0,0 +1,3 @@
+// Ambient types for game code built by the debuff CLI (import.meta.env, asset imports).
+// Add to tsconfig: "types": ["@debuffjp/cli/client"]
+/// <reference types="vite/client" />

package/dist/agent-link.d.ts

@@ -0,0 +1,28 @@
+import type { ViteDevServer } from "vite";
+/** Endpoints shared with `@debuffjp/dev` (page side) and `@debuffjp/mcp` (agent side). */
+export declare const AGENT_PATHS: {
+    readonly events: "/__debuff/agent/events";
+    readonly attach: "/__debuff/agent/attach";
+    readonly result: "/__debuff/agent/result";
+    readonly rpc: "/__debuff/agent/rpc";
+    readonly status: "/__debuff/agent/status";
+};
+/** Written while `debuff dev` runs, so tools can find the live game. */
+export declare const DEV_SERVER_FILE = ".debuff/dev-server.json";
+export interface DevServerInfo {
+    url: string;
+    pid: number;
+}
+export interface AgentStatus {
+    /** Open game pages listening for agent commands. */
+    pages: number;
+    /** Agents currently attached (holding an attach connection). */
+    agents: number;
+}
+/**
+ * Agent link (server side): relays dev-hook calls from tools to the game open in the developer's
+ * browser. Pages subscribe over Server-Sent Events; a tool POSTs `{ method, args }` to the RPC endpoint,
+ * the newest page runs it and POSTs the result back. Dev server only, localhost only.
+ */
+export declare function attachAgentLink(server: ViteDevServer, root: string): void;
+//# sourceMappingURL=agent-link.d.ts.map

package/dist/agent-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-link.d.ts","sourceRoot":"","sources":["../src/agent-link.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAE1C,0FAA0F;AAC1F,eAAO,MAAM,WAAW;aACtB,MAAM,EAAE,wBAAwB;aAChC,MAAM,EAAE,wBAAwB;aAChC,MAAM,EAAE,wBAAwB;aAChC,GAAG,EAAE,qBAAqB;aAC1B,MAAM,EAAE,wBAAwB;CACxB,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,eAAe,4BAA4B,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;CAChB;AAOD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAqFzE"}

package/dist/agent-link.js

@@ -0,0 +1,122 @@
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+/** Endpoints shared with `@debuffjp/dev` (page side) and `@debuffjp/mcp` (agent side). */
+export const AGENT_PATHS = {
+    events: "/__debuff/agent/events",
+    attach: "/__debuff/agent/attach",
+    result: "/__debuff/agent/result",
+    rpc: "/__debuff/agent/rpc",
+    status: "/__debuff/agent/status",
+};
+/** Written while `debuff dev` runs, so tools can find the live game. */
+export const DEV_SERVER_FILE = ".debuff/dev-server.json";
+/**
+ * Agent link (server side): relays dev-hook calls from tools to the game open in the developer's
+ * browser. Pages subscribe over Server-Sent Events; a tool POSTs `{ method, args }` to the RPC endpoint,
+ * the newest page runs it and POSTs the result back. Dev server only, localhost only.
+ */
+export function attachAgentLink(server, root) {
+    const pages = [];
+    const pending = new Map();
+    let agents = 0;
+    const announce = () => {
+        for (const page of pages)
+            send(page, "presence", { agents });
+    };
+    let nextId = 1;
+    const send = (res, event, data) => res.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+    server.middlewares.use(async (req, res, next) => {
+        const url = req.url?.split("?")[0];
+        if (!url?.startsWith("/__debuff/agent/"))
+            return next();
+        try {
+            if (url === AGENT_PATHS.events && req.method === "GET") {
+                res.writeHead(200, { "Content-Type": "text/event-stream", "Cache-Control": "no-cache", Connection: "keep-alive" });
+                res.write(": debuff agent link\n\n");
+                pages.push(res);
+                send(res, "presence", { agents });
+                const keepAlive = setInterval(() => res.write(": ping\n\n"), 15_000);
+                req.on("close", () => {
+                    clearInterval(keepAlive);
+                    pages.splice(pages.indexOf(res), 1);
+                });
+                return;
+            }
+            if (url === AGENT_PATHS.status && req.method === "GET")
+                return reply(res, 200, { pages: pages.length, agents });
+            if (url === AGENT_PATHS.attach && req.method === "GET") {
+                // Held open by an agent for as long as it is attached; closing it (or the agent dying) detaches.
+                res.writeHead(200, { "Content-Type": "text/event-stream", "Cache-Control": "no-cache", Connection: "keep-alive" });
+                res.write(": attached\n\n");
+                agents++;
+                announce();
+                const keepAlive = setInterval(() => res.write(": ping\n\n"), 15_000);
+                req.on("close", () => {
+                    clearInterval(keepAlive);
+                    agents--;
+                    announce();
+                });
+                return;
+            }
+            if (url === AGENT_PATHS.result && req.method === "POST") {
+                const body = (await readJson(req));
+                const p = pending.get(body.id);
+                if (p) {
+                    clearTimeout(p.timer);
+                    pending.delete(body.id);
+                    p.resolve(body);
+                }
+                return reply(res, 204);
+            }
+            if (url === AGENT_PATHS.rpc && req.method === "POST") {
+                const { method, args = [] } = (await readJson(req));
+                const page = pages.at(-1);
+                if (!page)
+                    return reply(res, 503, { ok: false, error: "No game page is open. Open the dev server URL in a browser." });
+                const id = String(nextId++);
+                const result = await new Promise((resolve) => {
+                    const timer = setTimeout(() => {
+                        pending.delete(id);
+                        resolve({ id, ok: false, error: `The game page did not answer "${method}" within 10 s (is the tab in the background?)` });
+                    }, 10_000);
+                    pending.set(id, { resolve, timer });
+                    send(page, "command", { id, method, args });
+                });
+                return reply(res, 200, result);
+            }
+            reply(res, 404, { ok: false, error: `Unknown agent endpoint ${url}` });
+        }
+        catch (err) {
+            reply(res, 400, { ok: false, error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    const file = join(root, DEV_SERVER_FILE);
+    server.httpServer?.once("listening", () => {
+        const url = server.resolvedUrls?.local[0];
+        if (!url)
+            return;
+        mkdirSync(join(root, ".debuff"), { recursive: true });
+        writeFileSync(file, `${JSON.stringify({ url, pid: process.pid }, null, 2)}\n`);
+    });
+    server.httpServer?.once("close", () => {
+        for (const p of pending.values())
+            clearTimeout(p.timer);
+        for (const page of pages)
+            page.end();
+        rmSync(file, { force: true });
+    });
+}
+function reply(res, status, body) {
+    res.statusCode = status;
+    if (body === undefined)
+        return void res.end();
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(body));
+}
+async function readJson(req) {
+    let raw = "";
+    for await (const chunk of req)
+        raw += chunk;
+    return JSON.parse(raw || "{}");
+}
+//# sourceMappingURL=agent-link.js.map

package/dist/agent-link.js.map

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

package/dist/assets/atlas.d.ts

@@ -0,0 +1,58 @@
+export interface AtlasOptions {
+    /** Largest atlas side in pixels. Default 2048 (safe on every WebGL2 device). */
+    maxSize?: number;
+    /** Transparent gap between sprites, in pixels. Default 2. */
+    padding?: number;
+    /** Edge pixels copied outward into the padding so filtering never samples a neighbour. Default 1. */
+    extrude?: number;
+    /** Asset ids (or id prefixes ending in "/") to leave out of atlases. */
+    exclude?: string[];
+}
+export interface Placement {
+    x: number;
+    y: number;
+}
+export interface PackedBin {
+    width: number;
+    height: number;
+    /** Placement per input index, in this bin. */
+    items: Map<number, Placement>;
+}
+/**
+ * MaxRects bin packing (best-short-side-fit). Inputs are sorted largest-first; anything that doesn't
+ * fit opens a new bin. Bins are cropped to their used area (rounded up to a multiple of 4).
+ * Throws if a single item can't fit in an empty bin.
+ */
+export declare function packRects(sizes: readonly {
+    w: number;
+    h: number;
+}[], maxSize: number, gap: number): PackedBin[];
+export interface Rgba {
+    width: number;
+    height: number;
+    /** RGBA, 8 bits per channel. */
+    data: Uint8Array;
+}
+/** Decode any PNG (palette, grey, RGB, 16-bit…) to 8-bit RGBA. */
+export declare function decodePng(bytes: Uint8Array): Rgba;
+/** Copy `img` into `atlas` at (x, y), extruding its edge pixels `extrude` px outward. */
+export declare function blit(atlas: Rgba, img: Rgba, x: number, y: number, extrude: number): void;
+export interface AtlasInput {
+    id: string;
+    png: Uint8Array;
+}
+export interface BuiltAtlas {
+    png: Uint8Array;
+    width: number;
+    height: number;
+    /** Source rectangle per input id. */
+    rects: Map<string, {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+}
+/** Pack PNGs into as few atlases as fit `maxSize`. */
+export declare function buildAtlases(inputs: readonly AtlasInput[], options?: AtlasOptions): BuiltAtlas[];
+//# sourceMappingURL=atlas.d.ts.map

package/dist/assets/atlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas.d.ts","sourceRoot":"","sources":["../../src/assets/atlas.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAC/B;AASD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CA6B/G;AAgDD,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CA4BjD;AAED,yFAAyF;AACzF,wBAAgB,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAkBxF;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,UAAU,EAAE,CA8BpG"}

package/dist/assets/atlas.js

@@ -0,0 +1,164 @@
+import { convertIndexedToRgb, decode, encode } from "fast-png";
+/**
+ * MaxRects bin packing (best-short-side-fit). Inputs are sorted largest-first; anything that doesn't
+ * fit opens a new bin. Bins are cropped to their used area (rounded up to a multiple of 4).
+ * Throws if a single item can't fit in an empty bin.
+ */
+export function packRects(sizes, maxSize, gap) {
+    const order = sizes
+        .map((_, i) => i)
+        .sort((a, b) => Math.max(sizes[b]?.w ?? 0, sizes[b]?.h ?? 0) - Math.max(sizes[a]?.w ?? 0, sizes[a]?.h ?? 0));
+    const bins = [];
+    for (const index of order) {
+        const size = sizes[index];
+        if (!size)
+            continue;
+        const w = size.w + gap;
+        const h = size.h + gap;
+        if (w > maxSize || h > maxSize)
+            throw new Error(`An image of ${size.w}×${size.h} can't fit a ${maxSize}px atlas`);
+        let placed = false;
+        for (const bin of bins) {
+            const spot = findSpot(bin.free, w, h);
+            if (!spot)
+                continue;
+            place(bin, index, spot, w, h);
+            placed = true;
+            break;
+        }
+        if (!placed) {
+            const bin = { free: [{ x: 0, y: 0, w: maxSize, h: maxSize }], items: new Map(), usedW: 0, usedH: 0 };
+            const spot = findSpot(bin.free, w, h);
+            if (!spot)
+                throw new Error("unreachable: empty bin rejected an item that fits");
+            place(bin, index, spot, w, h);
+            bins.push(bin);
+        }
+    }
+    const up4 = (n) => Math.ceil(n / 4) * 4;
+    return bins.map((b) => ({ width: Math.min(maxSize, up4(b.usedW)), height: Math.min(maxSize, up4(b.usedH)), items: b.items }));
+}
+function findSpot(free, w, h) {
+    let best;
+    let bestShort = Number.POSITIVE_INFINITY;
+    let bestLong = Number.POSITIVE_INFINITY;
+    for (const f of free) {
+        if (w > f.w || h > f.h)
+            continue;
+        const short = Math.min(f.w - w, f.h - h);
+        const long = Math.max(f.w - w, f.h - h);
+        if (short < bestShort || (short === bestShort && long < bestLong)) {
+            best = f;
+            bestShort = short;
+            bestLong = long;
+        }
+    }
+    return best;
+}
+function place(bin, index, spot, w, h) {
+    const used = { x: spot.x, y: spot.y, w, h };
+    bin.items.set(index, { x: spot.x, y: spot.y });
+    bin.usedW = Math.max(bin.usedW, spot.x + w);
+    bin.usedH = Math.max(bin.usedH, spot.y + h);
+    // Split every free rect the placement overlaps, then drop rects contained in others.
+    const next = [];
+    for (const f of bin.free) {
+        if (used.x >= f.x + f.w || used.x + used.w <= f.x || used.y >= f.y + f.h || used.y + used.h <= f.y) {
+            next.push(f);
+            continue;
+        }
+        if (used.x > f.x)
+            next.push({ x: f.x, y: f.y, w: used.x - f.x, h: f.h });
+        if (used.x + used.w < f.x + f.w)
+            next.push({ x: used.x + used.w, y: f.y, w: f.x + f.w - used.x - used.w, h: f.h });
+        if (used.y > f.y)
+            next.push({ x: f.x, y: f.y, w: f.w, h: used.y - f.y });
+        if (used.y + used.h < f.y + f.h)
+            next.push({ x: f.x, y: used.y + used.h, w: f.w, h: f.y + f.h - used.y - used.h });
+    }
+    bin.free = next.filter((a, i) => !next.some((b, j) => i !== j && contains(b, a) && (!contains(a, b) || j < i)));
+}
+const contains = (outer, inner) => inner.x >= outer.x && inner.y >= outer.y && inner.x + inner.w <= outer.x + outer.w && inner.y + inner.h <= outer.y + outer.h;
+/** Decode any PNG (palette, grey, RGB, 16-bit…) to 8-bit RGBA. */
+export function decodePng(bytes) {
+    const png = decode(bytes);
+    const { width, height } = png;
+    const out = new Uint8Array(width * height * 4);
+    if (png.palette) {
+        const rgb = convertIndexedToRgb(png);
+        const ch = png.palette[0]?.length ?? 3;
+        for (let i = 0; i < width * height; i++) {
+            out[i * 4] = rgb[i * ch] ?? 0;
+            out[i * 4 + 1] = rgb[i * ch + 1] ?? 0;
+            out[i * 4 + 2] = rgb[i * ch + 2] ?? 0;
+            out[i * 4 + 3] = ch === 4 ? (rgb[i * ch + 3] ?? 255) : 255;
+        }
+        return { width, height, data: out };
+    }
+    const ch = png.channels;
+    const shift = png.depth === 16 ? 8 : 0;
+    const src = png.data;
+    for (let i = 0; i < width * height; i++) {
+        const v = (k) => (src[i * ch + k] ?? 0) >> shift;
+        if (ch === 1 || ch === 2) {
+            const g = v(0);
+            out.set([g, g, g, ch === 2 ? v(1) : 255], i * 4);
+        }
+        else {
+            out.set([v(0), v(1), v(2), ch === 4 ? v(3) : 255], i * 4);
+        }
+    }
+    return { width, height, data: out };
+}
+/** Copy `img` into `atlas` at (x, y), extruding its edge pixels `extrude` px outward. */
+export function blit(atlas, img, x, y, extrude) {
+    const aw = atlas.width;
+    for (let dy = -extrude; dy < img.height + extrude; dy++) {
+        const ty = y + dy;
+        if (ty < 0 || ty >= atlas.height)
+            continue;
+        const sy = Math.min(img.height - 1, Math.max(0, dy));
+        for (let dx = -extrude; dx < img.width + extrude; dx++) {
+            const tx = x + dx;
+            if (tx < 0 || tx >= aw)
+                continue;
+            const sx = Math.min(img.width - 1, Math.max(0, dx));
+            const s = (sy * img.width + sx) * 4;
+            const t = (ty * aw + tx) * 4;
+            atlas.data[t] = img.data[s] ?? 0;
+            atlas.data[t + 1] = img.data[s + 1] ?? 0;
+            atlas.data[t + 2] = img.data[s + 2] ?? 0;
+            atlas.data[t + 3] = img.data[s + 3] ?? 0;
+        }
+    }
+}
+/** Pack PNGs into as few atlases as fit `maxSize`. */
+export function buildAtlases(inputs, options = {}) {
+    const maxSize = options.maxSize ?? 2048;
+    const padding = options.padding ?? 2;
+    const extrude = Math.min(options.extrude ?? 1, Math.floor(padding / 2));
+    const images = inputs.map((i) => decodePng(i.png));
+    // Reserve padding on every side: items are offset by `padding` so extrusion has room at the edges.
+    const bins = packRects(images.map((img) => ({ w: img.width + padding, h: img.height + padding })), maxSize, 0);
+    return bins.map((bin) => {
+        const atlas = { width: bin.width, height: bin.height, data: new Uint8Array(bin.width * bin.height * 4) };
+        const rects = new Map();
+        for (const [index, at] of bin.items) {
+            const img = images[index];
+            const input = inputs[index];
+            if (!img || !input)
+                continue;
+            const x = at.x + Math.ceil(padding / 2);
+            const y = at.y + Math.ceil(padding / 2);
+            blit(atlas, img, x, y, extrude);
+            rects.set(input.id, { x, y, w: img.width, h: img.height });
+        }
+        return {
+            png: encode({ width: atlas.width, height: atlas.height, data: atlas.data, channels: 4, depth: 8 }),
+            width: atlas.width,
+            height: atlas.height,
+            rects,
+        };
+    });
+}
+//# sourceMappingURL=atlas.js.map

package/dist/assets/atlas.js.map

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

package/dist/assets/builtin.d.ts

@@ -0,0 +1,5 @@
+import type { FunctionImporter } from "../plugin.js";
+export declare const BUILTIN_EXTENSIONS: string[];
+/** Images, JSON, audio and text, served as-is. */
+export declare const builtinImporter: FunctionImporter;
+//# sourceMappingURL=builtin.d.ts.map

package/dist/assets/builtin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin.d.ts","sourceRoot":"","sources":["../../src/assets/builtin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,gBAAgB,EAA4B,MAAM,cAAc,CAAC;AAyB1F,eAAO,MAAM,kBAAkB,UAAqB,CAAC;AAErD,kDAAkD;AAClD,eAAO,MAAM,eAAe,EAAE,gBAoB7B,CAAC"}

package/dist/assets/builtin.js

@@ -0,0 +1,47 @@
+const TYPES = {
+    ".png": "image",
+    ".jpg": "image",
+    ".jpeg": "image",
+    ".webp": "image",
+    ".avif": "image",
+    ".gif": "image",
+    ".json": "json",
+    // Tiled maps/tilesets and LDtk projects are JSON (load with @debuffjp/tilemap).
+    ".tmj": "json",
+    ".tsj": "json",
+    ".ldtk": "json",
+    ".ogg": "audio",
+    ".opus": "audio",
+    ".mp3": "audio",
+    ".wav": "audio",
+    ".m4a": "audio",
+    ".txt": "text",
+};
+/** `hero@16x24.png` declares a 16×24 grid and the id "hero". Explicit by design: we never guess frame sizes. */
+const GRID = /@(\d+)x(\d+)$/;
+export const BUILTIN_EXTENSIONS = Object.keys(TYPES);
+/** Images, JSON, audio and text, served as-is. */
+export const builtinImporter = {
+    name: "debuff:builtin",
+    extensions: BUILTIN_EXTENSIONS,
+    import(file) {
+        const type = TYPES[file.ext];
+        if (!type)
+            return { assets: {}, warnings: [`Skipped ${file.rel}: unsupported extension "${file.ext}"`] };
+        let id = file.id;
+        const grid = GRID.exec(id);
+        if (grid)
+            id = id.slice(0, grid.index);
+        return {
+            assets: {
+                [id]: {
+                    type,
+                    src: `assets/${file.rel}`,
+                    ...(file.group ? { group: file.group } : {}),
+                    ...(grid ? { grid: { frameWidth: Number(grid[1]), frameHeight: Number(grid[2]) } } : {}),
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=builtin.js.map

package/dist/assets/builtin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin.js","sourceRoot":"","sources":["../../src/assets/builtin.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAA8B;IACvC,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,MAAM;IACf,gFAAgF;IAChF,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,MAAM;CACf,CAAC;AAEF,gHAAgH;AAChH,MAAM,IAAI,GAAG,eAAe,CAAC;AAE7B,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAErD,kDAAkD;AAClD,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,IAAI,EAAE,gBAAgB;IACtB,UAAU,EAAE,kBAAkB;IAC9B,MAAM,CAAC,IAAgB;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,WAAW,IAAI,CAAC,GAAG,4BAA4B,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;QACzG,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,IAAI;YAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO;YACL,MAAM,EAAE;gBACN,CAAC,EAAE,CAAC,EAAE;oBACJ,IAAI;oBACJ,GAAG,EAAE,UAAU,IAAI,CAAC,GAAG,EAAE;oBACzB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACzF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/assets/command.d.ts

@@ -0,0 +1,4 @@
+import type { CommandImporter, ImportResult, SourceFile } from "../plugin.js";
+/** Run a command importer: SourceFile JSON on stdin, ImportResult JSON on stdout. */
+export declare function runCommandImporter(importer: CommandImporter, file: SourceFile, cwd: string): Promise<ImportResult>;
+//# sourceMappingURL=command.d.ts.map

package/dist/assets/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/assets/command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI9E,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA4BlH"}

package/dist/assets/command.js

@@ -0,0 +1,35 @@
+import { spawn } from "node:child_process";
+const TIMEOUT_MS = 60_000;
+/** Run a command importer: SourceFile JSON on stdin, ImportResult JSON on stdout. */
+export function runCommandImporter(importer, file, cwd) {
+    const [cmd, ...args] = importer.command;
+    return new Promise((resolve, reject) => {
+        const child = spawn(cmd, args, { cwd, stdio: ["pipe", "pipe", "pipe"], shell: process.platform === "win32" });
+        const out = [];
+        const err = [];
+        const timer = setTimeout(() => {
+            child.kill();
+            reject(new Error(`importer "${importer.name}" timed out after ${TIMEOUT_MS / 1000}s on ${file.rel}`));
+        }, TIMEOUT_MS);
+        child.stdout.on("data", (d) => out.push(d));
+        child.stderr.on("data", (d) => err.push(d));
+        child.on("error", (e) => {
+            clearTimeout(timer);
+            reject(new Error(`importer "${importer.name}" could not start \`${cmd}\`: ${e.message}`));
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            const stderr = Buffer.concat(err).toString("utf8").trim();
+            if (code !== 0)
+                return reject(new Error(`importer "${importer.name}" exited ${code} on ${file.rel}${stderr ? `: ${stderr}` : ""}`));
+            try {
+                resolve(JSON.parse(Buffer.concat(out).toString("utf8")));
+            }
+            catch {
+                reject(new Error(`importer "${importer.name}" printed invalid JSON for ${file.rel}`));
+            }
+        });
+        child.stdin.end(JSON.stringify(file));
+    });
+}
+//# sourceMappingURL=command.js.map

package/dist/assets/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/assets/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,QAAyB,EAAE,IAAgB,EAAE,GAAW;IACzF,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;IACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;QAC9G,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,IAAI,qBAAqB,UAAU,GAAG,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACxG,CAAC,EAAE,UAAU,CAAC,CAAC;QACf,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACtB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,IAAI,uBAAuB,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC5F,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1D,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,IAAI,YAAY,IAAI,OAAO,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACpI,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAiB,CAAC,CAAC;YAC3E,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,IAAI,8BAA8B,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACxF,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/assets/compile.d.ts

@@ -0,0 +1,29 @@
+import type { CompiledEntry, ToolingPlugin } from "../plugin.js";
+import { type AtlasOptions } from "./atlas.js";
+export interface CompiledManifest {
+    version: 1;
+    assets: Record<string, CompiledEntry>;
+}
+export interface CompileResult {
+    manifest: CompiledManifest;
+    /** Generated files keyed by path relative to `assets/`. */
+    outputs: Map<string, Buffer>;
+    warnings: string[];
+    /** Which importer produced each asset id. */
+    importedBy: Record<string, string>;
+}
+export interface CompileOptions {
+    plugins?: ToolingPlugin[];
+    /** Cache import results by content hash under `.debuff/cache/assets`. Default true. */
+    cache?: boolean;
+    /** Pack PNG images into atlases per preload group. Default on; `false` disables. */
+    atlas?: AtlasOptions | false;
+}
+/**
+ * Turn `assets/` into a manifest plus generated files, entirely in memory.
+ * Source files are never modified; nothing is written into the source tree.
+ */
+export declare function compileAssets(root: string, options?: CompileOptions): Promise<CompileResult>;
+/** Asset ids never referenced as a string literal in `src/`. Heuristic: reports, never deletes. */
+export declare function findUnused(root: string, manifest: CompiledManifest): string[];
+//# sourceMappingURL=compile.d.ts.map

package/dist/assets/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/assets/compile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,aAAa,EAA2C,aAAa,EAAE,MAAM,cAAc,CAAC;AACzH,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,YAAY,CAAC;AAI7D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,2DAA2D;IAC3D,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AA2BD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,uFAAuF;IACvF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oFAAoF;IACpF,KAAK,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2EtG;AA+BD,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAW7E"}