picopilot 0.1.3 → 0.1.5

package/dist/commands/cart-includes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A `#include` resolver for the drive-transform, bound to the SOURCE cart's dir:
+ * picopilot's standard scaffold is `main.p8` = `#include main.lua`, and the
+ * driven cart runs from a throwaway temp dir where `main.lua` is absent, so the
+ * transform inlines includes to be self-contained. Reads the included file
+ * relative to the cart (absolute paths honoured); returns `undefined` if it
+ * cannot be read (the directive is then left verbatim). Shared by `playtest` and
+ * the `--label-frame` capture.
+ */
+export declare function makeReadInclude(cartPath: string): (p: string) => string | undefined;
+//# sourceMappingURL=cart-includes.d.ts.map

package/dist/commands/cart-includes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-includes.d.ts","sourceRoot":"","sources":["../../src/commands/cart-includes.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,MAAM,GACd,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAYnC"}

package/dist/commands/cart-includes.js

@@ -0,0 +1,26 @@
+import { readFileSync } from 'node:fs';
+import { dirname, isAbsolute, join } from 'node:path';
+/**
+ * A `#include` resolver for the drive-transform, bound to the SOURCE cart's dir:
+ * picopilot's standard scaffold is `main.p8` = `#include main.lua`, and the
+ * driven cart runs from a throwaway temp dir where `main.lua` is absent, so the
+ * transform inlines includes to be self-contained. Reads the included file
+ * relative to the cart (absolute paths honoured); returns `undefined` if it
+ * cannot be read (the directive is then left verbatim). Shared by `playtest` and
+ * the `--label-frame` capture.
+ */
+export function makeReadInclude(cartPath) {
+    const base = dirname(cartPath);
+    return (includePath) => {
+        const full = isAbsolute(includePath)
+            ? includePath
+            : join(base, includePath);
+        try {
+            return readFileSync(full, 'utf8');
+        }
+        catch {
+            return undefined;
+        }
+    };
+}
+//# sourceMappingURL=cart-includes.js.map

package/dist/commands/cart-includes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-includes.js","sourceRoot":"","sources":["../../src/commands/cart-includes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AACrC,OAAO,EAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAC,MAAM,WAAW,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC9B,QAAgB;IAEhB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,WAAW,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC;YACnC,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC3B,IAAI,CAAC;YACJ,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC,CAAC;AACH,CAAC"}

package/dist/commands/export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAWA,OAAO,EAAC,KAAK,GAAG,EAAI,MAAM,OAAO,CAAC;AAGlC,OAAO,EAEN,KAAK,YAAY,EAEjB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC;AAQ3E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,mBAA2C,GACzD,IAAI,CAqPN"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,KAAK,GAAG,EAAI,MAAM,OAAO,CAAC;AAClC,OAAO,EAEN,KAAK,YAAY,EAGjB,MAAM,0BAA0B,CAAC;AAGlC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC;AAQ3E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,mBAA2C,GACzD,IAAI,CA+ON"}

package/dist/commands/export.js

@@ -1,10 +1,9 @@
-import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, rmSync } from 'node:fs';
 import { tmpdir } from 'node:os';
-import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { isAbsolute, join, resolve } from 'node:path';
 import { z } from 'incur';
-import { Cart, CartParseError } from '../engine/cart/index.js';
-import { labelHexFromPng, LabelError } from '../engine/gfx/index.js';
 import { EXPORT_HTML_NAME, ShellPico8Adapter, } from '../engine/pico8/index.js';
+import { prepareLabeledCart } from './label-cart.js';
 const defaultAdapterFactory = (env) => new ShellPico8Adapter({ env });
 /** The default backstop: kill an export that never completes/exits after this many ms. */
 const DEFAULT_BACKSTOP_MS = 30_000;
@@ -50,7 +49,13 @@ export function registerExport(cli, adapterFactory = defaultAdapterFactory) {
             label: z
                 .string()
                 .optional()
-                .describe('Path to a 128x128 PNG to bake in as the cart __label__ (the export splash), for a cart that has none. Ignored if the cart already has a label.'),
+                .describe('PNG to bake in as the cart __label__ (the export splash), for a cart that has none: a `run`/`playtest` screenshot as-is (any 128*k square, e.g. 384x384, is scaled down for you) or any 128x128 PNG. Ignored if the cart already has a label.'),
+            labelFrame: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe('Capture the label from the game itself: run the cart headlessly with NO input and use frame N (0-based: 0 = the first drawn frame, usually the title screen) as the __label__. Needs PICO-8; the cart need not cooperate. Exclusive with --label; ignored if the cart already has a label.'),
             payloadOnly: z
                 .boolean()
                 .default(false)
@@ -60,7 +65,7 @@ export function registerExport(cli, adapterFactory = defaultAdapterFactory) {
                 .int()
                 .positive()
                 .default(DEFAULT_BACKSTOP_MS)
-                .describe('Safety backstop: kill PICO-8 after this many ms if the export never completes.'),
+                .describe('Safety backstop: kill PICO-8 after this many ms if the export (or the --label-frame capture run) never completes.'),
         }),
         // incur resolves these from the (test-overridable) env source and hands
         // them to the child, so PICO8_PATH/PATH locate the binary in isolation.
@@ -83,6 +88,9 @@ export function registerExport(cli, adapterFactory = defaultAdapterFactory) {
             files: z
                 .array(z.string())
                 .describe('Absolute paths of every file the bundle contains.'),
+            labelSource: z
+                .enum(['cart', 'image', 'frame', 'none'])
+                .describe("Where the bundle's label came from: the cart's own __label__, --label, --label-frame, or none."),
             labelWarning: z
                 .boolean()
                 .describe('True when the cart has no __label__: it exports with a blank/ugly splash.'),
@@ -94,9 +102,14 @@ export function registerExport(cli, adapterFactory = defaultAdapterFactory) {
                 args: { cart: 'game.p8', dest: './website/static/games/my-game' },
             },
             {
-                description: 'Bake a PNG as the label splash for a labelless cart',
+                description: 'Bake a `run` screenshot in as the label splash for a labelless cart',
                 args: { cart: 'game.p8', dest: './website/static/games/my-game' },
-                options: { label: './label.png' },
+                options: { label: './shots/<name>.png' },
+            },
+            {
+                description: 'Capture the title screen (frame 0) as the label splash, no image needed',
+                args: { cart: 'game.p8', dest: './website/static/games/my-game' },
+                options: { labelFrame: 0 },
             },
             {
                 description: 'Export only the runtime payload for a site player component',
@@ -116,54 +129,23 @@ export function registerExport(cli, adapterFactory = defaultAdapterFactory) {
                     exitCode: 1,
                 });
             }
-            // --label <png>: bake a 128x128 PNG in as the cart's __label__ so a
-            // labelless cart gets a splash without an interactive F7 capture. We do
-            // NOT mutate the user's cart: we write a labeled copy NEXT TO it (same dir,
-            // so `#include main.lua` still resolves) and export that, then clean it up.
-            // A cart that ALREADY has a label wins (the flag is a fallback, not an
-            // override), matching the export precedence PICO-8 itself uses.
-            let exportCartPath = cartPath;
-            let labeledCopy;
-            if (options.label !== undefined) {
-                const labelPath = isAbsolute(options.label)
-                    ? options.label
-                    : resolve(process.cwd(), options.label);
-                if (!existsSync(labelPath)) {
-                    return error({
-                        code: 'label-not-found',
-                        message: `no label image at ${labelPath}`,
-                        exitCode: 1,
-                    });
-                }
-                try {
-                    const cart = Cart.parse(readFileSync(cartPath, 'utf8'));
-                    const existingLabel = cart.getSection('label');
-                    if (existingLabel === undefined || existingLabel.trim() === '') {
-                        const hex = labelHexFromPng(readFileSync(labelPath));
-                        cart.setSection('label', hex);
-                        labeledCopy = join(dirname(cartPath), `.picopilot-export-${process.pid}-${Date.now()}.p8`);
-                        writeFileSync(labeledCopy, cart.serialize());
-                        exportCartPath = labeledCopy;
-                    }
-                    // else: cart already has a label; keep it, ignore --label.
-                }
-                catch (e) {
-                    if (e instanceof LabelError) {
-                        return error({
-                            code: `label-${e.code}`,
-                            message: e.message,
-                            exitCode: 1,
-                        });
-                    }
-                    if (e instanceof CartParseError) {
-                        return error({
-                            code: `cart-${e.code}`,
-                            message: `could not parse the cart to inject a label: ${e.message}`,
-                            exitCode: 1,
-                        });
-                    }
-                    throw e;
-                }
+            // --label <png> / --label-frame <n>: bake an image, or a captured frame of
+            // the running cart, in as the __label__ of a throwaway copy (the user's
+            // cart is never mutated; an existing label wins). Shared with `serve`,
+            // see label-cart.ts.
+            const adapter = adapterFactory(env);
+            const labeled = await prepareLabeledCart(cartPath, {
+                label: options.label,
+                labelFrame: options.labelFrame,
+                backstopMs: options.backstopMs,
+            }, (o) => adapter.drive(o));
+            if (!labeled.ok) {
+                return error({
+                    code: labeled.code,
+                    message: labeled.message,
+                    exitCode: 1,
+                    ...(labeled.cta ? { cta: labeled.cta } : {}),
+                });
             }
             // Output dir: a user-given dest (point it at the showcase), else an
             // isolated temp dir. Create it so PICO-8 has somewhere to write.
@@ -172,24 +154,22 @@ export function registerExport(cli, adapterFactory = defaultAdapterFactory) {
                     ? args.dest
                     : resolve(process.cwd(), args.dest)
                 : mkdtempSync(join(tmpdir(), 'picopilot-export-'));
-            if (!existsSync(outDir))
-                mkdirSync(outDir, { recursive: true });
-            const adapter = adapterFactory(env);
-            const result = await adapter.export({
-                cartPath: exportCartPath,
-                outDir,
-                htmlName: EXPORT_HTML_NAME,
-                backstopMs: options.backstopMs,
-            });
-            // Remove the temporary labeled copy now that PICO-8 has read it (on every
-            // path below); best-effort, a leftover dotfile is not fatal.
-            if (labeledCopy !== undefined) {
-                try {
-                    rmSync(labeledCopy);
-                }
-                catch {
-                    // ignore
-                }
+            // The labeled copy lives in the user's cart dir, so remove it on EVERY
+            // path once PICO-8 has read it, including a throw from the dir setup or
+            // the adapter.
+            let result;
+            try {
+                if (!existsSync(outDir))
+                    mkdirSync(outDir, { recursive: true });
+                result = await adapter.export({
+                    cartPath: labeled.cartPath,
+                    outDir,
+                    htmlName: EXPORT_HTML_NAME,
+                    backstopMs: options.backstopMs,
+                });
+            }
+            finally {
+                labeled.cleanup();
             }
             if (!result.ok) {
                 // The two-tier structured failure: PICO-8 absent. The message carries
@@ -207,7 +187,7 @@ export function registerExport(cli, adapterFactory = defaultAdapterFactory) {
                 return error({
                     code: 'export-failed',
                     message: labelWarning
-                        ? 'PICO-8 produced no bundle (the cart has no __label__ to embed). Give it one with --label <128x128.png>, or capture a label in PICO-8 (F7), then re-export.'
+                        ? 'PICO-8 produced no bundle (the cart has no __label__ to embed). Give it one with --label-frame 0 (captures the title screen for you), or --label <screenshot.png> (a `picopilot run`/`playtest` screenshot works as-is), then re-export.'
                         : 'PICO-8 produced no export bundle. Check the cart runs without a boot error.',
                     exitCode: 1,
                 });
@@ -230,8 +210,12 @@ export function registerExport(cli, adapterFactory = defaultAdapterFactory) {
                     description: 'The cart has no __label__, so the export splash is blank. Add one for a nicer bundle:',
                     commands: [
                         {
-                            command: 'export --label <128x128.png>',
-                            description: 'Bake a PNG in as the label splash, or capture one in PICO-8 (F7) before exporting.',
+                            command: 'export <cart> <dest> --label-frame 0',
+                            description: 'Capture the title screen (frame 0) of the running cart as the label, no image needed.',
+                        },
+                        {
+                            command: 'export --label <screenshot.png>',
+                            description: 'Bake a `run`/`playtest` screenshot in as the label splash (passed as-is, it is scaled for you), or capture one in PICO-8 (F7) before exporting.',
                         },
                     ],
                 }
@@ -241,6 +225,7 @@ export function registerExport(cli, adapterFactory = defaultAdapterFactory) {
                 html: htmlPath,
                 js: jsPath,
                 files: [...files],
+                labelSource: labeled.labelSource,
                 labelWarning,
             }, cta === undefined ? undefined : { cta });
         },

package/dist/commands/export.js.map

@@ -1 +1 @@
-{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,EACZ,MAAM,EACN,aAAa,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAC,MAAM,EAAC,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAC,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAW,CAAC,EAAC,MAAM,OAAO,CAAC;AAClC,OAAO,EAAC,IAAI,EAAE,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAC,eAAe,EAAE,UAAU,EAAC,MAAM,wBAAwB,CAAC;AACnE,OAAO,EACN,gBAAgB,EAEhB,iBAAiB,GACjB,MAAM,0BAA0B,CAAC;AAUlC,MAAM,qBAAqB,GAAwB,CAAC,GAAG,EAAE,EAAE,CAC1D,IAAI,iBAAiB,CAAC,EAAC,GAAG,EAAC,CAAC,CAAC;AAE9B,0FAA0F;AAC1F,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,cAAc,CAC7B,GAAY,EACZ,iBAAsC,qBAAqB;IAE3D,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE;QACrB,WAAW,EACV,yGAAyG;QAC1G,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,IAAI,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,OAAO,CAAC,SAAS,CAAC;iBAClB,QAAQ,CACR,oEAAoE,CACpE;YACF,IAAI,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACR,yIAAyI,CACzI;SACF,CAAC;QACF,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YACjB,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACR,gJAAgJ,CAChJ;YACF,WAAW,EAAE,CAAC;iBACZ,OAAO,EAAE;iBACT,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CACR,8GAA8G,CAC9G;YACF,UAAU,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,OAAO,CAAC,mBAAmB,CAAC;iBAC5B,QAAQ,CACR,gFAAgF,CAChF;SACF,CAAC;QACF,wEAAwE;QACxE,wEAAwE;QACxE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;YACb,UAAU,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4DAA4D,CAAC;YACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;SAC/D,CAAC;QACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,MAAM,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,CAAC,wDAAwD,CAAC;YACpE,IAAI,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACR,sEAAsE,CACtE;YACF,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YACzE,KAAK,EAAE,CAAC;iBACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,CAAC,mDAAmD,CAAC;YAC/D,YAAY,EAAE,CAAC;iBACb,OAAO,EAAE;iBACT,QAAQ,CACR,2EAA2E,CAC3E;SACF,CAAC;QACF,QAAQ,EAAE;YACT,EAAC,WAAW,EAAE,8BAA8B,EAAC;YAC7C;gBACC,WAAW,EAAE,sCAAsC;gBACnD,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gCAAgC,EAAC;aAC/D;YACD;gBACC,WAAW,EAAE,qDAAqD;gBAClE,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gCAAgC,EAAC;gBAC/D,OAAO,EAAE,EAAC,KAAK,EAAE,aAAa,EAAC;aAC/B;YACD;gBACC,WAAW,EACV,6DAA6D;gBAC9D,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gCAAgC,EAAC;gBAC/D,OAAO,EAAE,EAAC,WAAW,EAAE,IAAI,EAAC;aAC5B;SACD;QACD,KAAK,CAAC,GAAG,CAAC,EAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAC;YACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;gBACrC,CAAC,CAAC,IAAI,CAAC,IAAI;gBACX,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAErC,0EAA0E;YAC1E,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,cAAc,QAAQ,EAAE;oBACjC,QAAQ,EAAE,CAAC;iBACX,CAAC,CAAC;YACJ,CAAC;YAED,oEAAoE;YACpE,wEAAwE;YACxE,4EAA4E;YAC5E,4EAA4E;YAC5E,uEAAuE;YACvE,gEAAgE;YAChE,IAAI,cAAc,GAAG,QAAQ,CAAC;YAC9B,IAAI,WAA+B,CAAC;YACpC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;oBAC1C,CAAC,CAAC,OAAO,CAAC,KAAK;oBACf,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBACzC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC5B,OAAO,KAAK,CAAC;wBACZ,IAAI,EAAE,iBAAiB;wBACvB,OAAO,EAAE,qBAAqB,SAAS,EAAE;wBACzC,QAAQ,EAAE,CAAC;qBACX,CAAC,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC;oBACJ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;oBACxD,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;oBAC/C,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;wBAChE,MAAM,GAAG,GAAG,eAAe,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;wBACrD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;wBAC9B,WAAW,GAAG,IAAI,CACjB,OAAO,CAAC,QAAQ,CAAC,EACjB,qBAAqB,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,KAAK,CACnD,CAAC;wBACF,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;wBAC7C,cAAc,GAAG,WAAW,CAAC;oBAC9B,CAAC;oBACD,2DAA2D;gBAC5D,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACZ,IAAI,CAAC,YAAY,UAAU,EAAE,CAAC;wBAC7B,OAAO,KAAK,CAAC;4BACZ,IAAI,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE;4BACvB,OAAO,EAAE,CAAC,CAAC,OAAO;4BAClB,QAAQ,EAAE,CAAC;yBACX,CAAC,CAAC;oBACJ,CAAC;oBACD,IAAI,CAAC,YAAY,cAAc,EAAE,CAAC;wBACjC,OAAO,KAAK,CAAC;4BACZ,IAAI,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE;4BACtB,OAAO,EAAE,+CAA+C,CAAC,CAAC,OAAO,EAAE;4BACnE,QAAQ,EAAE,CAAC;yBACX,CAAC,CAAC;oBACJ,CAAC;oBACD,MAAM,CAAC,CAAC;gBACT,CAAC;YACF,CAAC;YAED,oEAAoE;YACpE,iEAAiE;YACjE,MAAM,MAAM,GACX,IAAI,CAAC,IAAI,KAAK,SAAS;gBACtB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;oBACtB,CAAC,CAAC,IAAI,CAAC,IAAI;oBACX,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC;gBACpC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;YACrD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,SAAS,CAAC,MAAM,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;YAE9D,MAAM,OAAO,GAAG,cAAc,CAAC,GAAwB,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gBACnC,QAAQ,EAAE,cAAc;gBACxB,MAAM;gBACN,QAAQ,EAAE,gBAAgB;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;aAC9B,CAAC,CAAC;YAEH,0EAA0E;YAC1E,6DAA6D;YAC7D,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACJ,MAAM,CAAC,WAAW,CAAC,CAAC;gBACrB,CAAC;gBAAC,MAAM,CAAC;oBACR,SAAS;gBACV,CAAC;YACF,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAChB,sEAAsE;gBACtE,oDAAoD;gBACpD,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,MAAM,CAAC,MAAM;oBACnB,OAAO,EAAE,4BAA4B,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBACxF,QAAQ,EAAE,CAAC;iBACX,CAAC,CAAC;YACJ,CAAC;YAED,IAAI,EAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAC,GAAG,MAAM,CAAC,KAAK,CAAC;YAE3D,2EAA2E;YAC3E,yDAAyD;YACzD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1B,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,YAAY;wBACpB,CAAC,CAAC,4JAA4J;wBAC9J,CAAC,CAAC,6EAA6E;oBAChF,QAAQ,EAAE,CAAC;iBACX,CAAC,CAAC;YACJ,CAAC;YAED,0EAA0E;YAC1E,2EAA2E;YAC3E,oBAAoB;YACpB,IAAI,OAAO,CAAC,WAAW,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACnD,IAAI,CAAC;oBACJ,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAClB,CAAC;gBAAC,MAAM,CAAC;oBACR,6DAA6D;gBAC9D,CAAC;gBACD,QAAQ,GAAG,SAAS,CAAC;gBACrB,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAC3B,CAAC;YAED,MAAM,GAAG,GACR,YAAY,IAAI,CAAC,OAAO,CAAC,WAAW;gBACnC,CAAC,CAAC;oBACA,WAAW,EACV,uFAAuF;oBACxF,QAAQ,EAAE;wBACT;4BACC,OAAO,EAAE,8BAA8B;4BACvC,WAAW,EACV,oFAAoF;yBACrF;qBACD;iBACD;gBACF,CAAC,CAAC,SAAS,CAAC;YAEd,OAAO,EAAE,CACR;gBACC,MAAM;gBACN,IAAI,EAAE,QAAQ;gBACd,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC;gBACjB,YAAY;aACZ,EACD,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAC,GAAG,EAAC,CACrC,CAAC;QACH,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,SAAS,SAAS,CAAC,GAAW;IAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,WAAW,CAAC,GAAG,CAAC;SACrB,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAC,MAAM,SAAS,CAAC;AAChF,OAAO,EAAC,MAAM,EAAC,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAC,MAAM,WAAW,CAAC;AACpD,OAAO,EAAW,CAAC,EAAC,MAAM,OAAO,CAAC;AAClC,OAAO,EACN,gBAAgB,EAGhB,iBAAiB,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAUnD,MAAM,qBAAqB,GAAwB,CAAC,GAAG,EAAE,EAAE,CAC1D,IAAI,iBAAiB,CAAC,EAAC,GAAG,EAAC,CAAC,CAAC;AAE9B,0FAA0F;AAC1F,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,cAAc,CAC7B,GAAY,EACZ,iBAAsC,qBAAqB;IAE3D,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE;QACrB,WAAW,EACV,yGAAyG;QAC1G,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,IAAI,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,OAAO,CAAC,SAAS,CAAC;iBAClB,QAAQ,CACR,oEAAoE,CACpE;YACF,IAAI,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACR,yIAAyI,CACzI;SACF,CAAC;QACF,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YACjB,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACR,+OAA+O,CAC/O;YACF,UAAU,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CACR,4RAA4R,CAC5R;YACF,WAAW,EAAE,CAAC;iBACZ,OAAO,EAAE;iBACT,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CACR,8GAA8G,CAC9G;YACF,UAAU,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,OAAO,CAAC,mBAAmB,CAAC;iBAC5B,QAAQ,CACR,mHAAmH,CACnH;SACF,CAAC;QACF,wEAAwE;QACxE,wEAAwE;QACxE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;YACb,UAAU,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4DAA4D,CAAC;YACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;SAC/D,CAAC;QACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,MAAM,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,CAAC,wDAAwD,CAAC;YACpE,IAAI,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACR,sEAAsE,CACtE;YACF,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YACzE,KAAK,EAAE,CAAC;iBACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,CAAC,mDAAmD,CAAC;YAC/D,WAAW,EAAE,CAAC;iBACZ,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;iBACxC,QAAQ,CACR,gGAAgG,CAChG;YACF,YAAY,EAAE,CAAC;iBACb,OAAO,EAAE;iBACT,QAAQ,CACR,2EAA2E,CAC3E;SACF,CAAC;QACF,QAAQ,EAAE;YACT,EAAC,WAAW,EAAE,8BAA8B,EAAC;YAC7C;gBACC,WAAW,EAAE,sCAAsC;gBACnD,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gCAAgC,EAAC;aAC/D;YACD;gBACC,WAAW,EACV,qEAAqE;gBACtE,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gCAAgC,EAAC;gBAC/D,OAAO,EAAE,EAAC,KAAK,EAAE,oBAAoB,EAAC;aACtC;YACD;gBACC,WAAW,EACV,yEAAyE;gBAC1E,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gCAAgC,EAAC;gBAC/D,OAAO,EAAE,EAAC,UAAU,EAAE,CAAC,EAAC;aACxB;YACD;gBACC,WAAW,EACV,6DAA6D;gBAC9D,IAAI,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gCAAgC,EAAC;gBAC/D,OAAO,EAAE,EAAC,WAAW,EAAE,IAAI,EAAC;aAC5B;SACD;QACD,KAAK,CAAC,GAAG,CAAC,EAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAC;YACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;gBACrC,CAAC,CAAC,IAAI,CAAC,IAAI;gBACX,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAErC,0EAA0E;YAC1E,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,cAAc,QAAQ,EAAE;oBACjC,QAAQ,EAAE,CAAC;iBACX,CAAC,CAAC;YACJ,CAAC;YAED,2EAA2E;YAC3E,wEAAwE;YACxE,uEAAuE;YACvE,qBAAqB;YACrB,MAAM,OAAO,GAAG,cAAc,CAAC,GAAwB,CAAC,CAAC;YACzD,MAAM,OAAO,GAAG,MAAM,kBAAkB,CACvC,QAAQ,EACR;gBACC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;aAC9B,EACD,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CACvB,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,QAAQ,EAAE,CAAC;oBACX,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1C,CAAC,CAAC;YACJ,CAAC;YAED,oEAAoE;YACpE,iEAAiE;YACjE,MAAM,MAAM,GACX,IAAI,CAAC,IAAI,KAAK,SAAS;gBACtB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;oBACtB,CAAC,CAAC,IAAI,CAAC,IAAI;oBACX,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC;gBACpC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;YAErD,uEAAuE;YACvE,wEAAwE;YACxE,eAAe;YACf,IAAI,MAAyB,CAAC;YAC9B,IAAI,CAAC;gBACJ,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;oBAAE,SAAS,CAAC,MAAM,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;gBAC9D,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;oBAC7B,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,MAAM;oBACN,QAAQ,EAAE,gBAAgB;oBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;iBAC9B,CAAC,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACV,OAAO,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAChB,sEAAsE;gBACtE,oDAAoD;gBACpD,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,MAAM,CAAC,MAAM;oBACnB,OAAO,EAAE,4BAA4B,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBACxF,QAAQ,EAAE,CAAC;iBACX,CAAC,CAAC;YACJ,CAAC;YAED,IAAI,EAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAC,GAAG,MAAM,CAAC,KAAK,CAAC;YAE3D,2EAA2E;YAC3E,yDAAyD;YACzD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1B,OAAO,KAAK,CAAC;oBACZ,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,YAAY;wBACpB,CAAC,CAAC,0OAA0O;wBAC5O,CAAC,CAAC,6EAA6E;oBAChF,QAAQ,EAAE,CAAC;iBACX,CAAC,CAAC;YACJ,CAAC;YAED,0EAA0E;YAC1E,2EAA2E;YAC3E,oBAAoB;YACpB,IAAI,OAAO,CAAC,WAAW,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACnD,IAAI,CAAC;oBACJ,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAClB,CAAC;gBAAC,MAAM,CAAC;oBACR,6DAA6D;gBAC9D,CAAC;gBACD,QAAQ,GAAG,SAAS,CAAC;gBACrB,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YAC3B,CAAC;YAED,MAAM,GAAG,GACR,YAAY,IAAI,CAAC,OAAO,CAAC,WAAW;gBACnC,CAAC,CAAC;oBACA,WAAW,EACV,uFAAuF;oBACxF,QAAQ,EAAE;wBACT;4BACC,OAAO,EAAE,sCAAsC;4BAC/C,WAAW,EACV,uFAAuF;yBACxF;wBACD;4BACC,OAAO,EAAE,iCAAiC;4BAC1C,WAAW,EACV,iJAAiJ;yBAClJ;qBACD;iBACD;gBACF,CAAC,CAAC,SAAS,CAAC;YAEd,OAAO,EAAE,CACR;gBACC,MAAM;gBACN,IAAI,EAAE,QAAQ;gBACd,EAAE,EAAE,MAAM;gBACV,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC;gBACjB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,YAAY;aACZ,EACD,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAC,GAAG,EAAC,CACrC,CAAC;QACH,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,SAAS,SAAS,CAAC,GAAW;IAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,WAAW,CAAC,GAAG,CAAC;SACrB,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC"}

package/dist/commands/label-cart.d.ts

@@ -0,0 +1,72 @@
+import { type DriveOptions, type Pico8DriveResult } from '../engine/pico8/index.js';
+/**
+ * The remedy for both label-image errors (`label-wrong-size`,
+ * `label-unsupported-png`): the screenshot `run`/`playtest` already wrote is a
+ * valid label as-is, so point at that rather than at an external image tool.
+ */
+export declare const LABEL_FIX_CTA: {
+    description: string;
+    commands: {
+        command: string;
+        description: string;
+    }[];
+};
+/** Where the exported cart's `__label__` came from. */
+export type LabelSource = 'cart' | 'image' | 'frame' | 'none';
+/** A cart ready to hand to PICO-8's export, plus how to tidy up after it. */
+export interface LabeledCart {
+    readonly ok: true;
+    /** The cart to export: the original, or a labeled throwaway copy. */
+    readonly cartPath: string;
+    /**
+     * Where the label comes from: the cart's own (`cart`), `--label` (`image`),
+     * `--label-frame` (`frame`), or nowhere (`none`, the cart stays labelless).
+     */
+    readonly labelSource: LabelSource;
+    /** Removes the throwaway copy (if one was made). Best-effort, idempotent. */
+    readonly cleanup: () => void;
+}
+/** A label-preparation failure, shaped for incur's `error({...})`. */
+export interface LabelCartFailure {
+    readonly ok: false;
+    readonly code: string;
+    readonly message: string;
+    readonly cta?: {
+        description: string;
+        commands: {
+            command: string;
+            description: string;
+        }[];
+    };
+}
+/** The label flags `export` and `serve` share. */
+export interface LabelOptions {
+    /** `--label <png>`: an image (a run/playtest screenshot as-is, or 128x128). */
+    readonly label?: string;
+    /** `--label-frame <n>`: capture frame `n` of the running cart, no input. */
+    readonly labelFrame?: number;
+    /** The backstop for the `--label-frame` capture run. */
+    readonly backstopMs: number;
+}
+/**
+ * The `--label` / `--label-frame` step shared by `export` and `serve` (ADR-0013,
+ * ADR-0015, ADR-0016): give a labelless cart a `__label__` (the export splash)
+ * without an interactive F7 capture.
+ *
+ *  - `--label <png>`: decode an image (a `run`/`playtest` screenshot as-is, any
+ *    square integer multiple of 128x128, or any 128x128 PNG).
+ *  - `--label-frame <n>`: RUN the cart headlessly through the playtest drive
+ *    harness (ADR-0011) with NO input, advance `n` frames, screenshot that frame,
+ *    and decode it. Needs PICO-8 (`drive`); an arbitrary cart does not have to
+ *    cooperate, since the harness owns its frame loop.
+ *
+ * The two flags are mutually exclusive (`label-flags-conflict`). The user's cart
+ * is NEVER mutated: a labeled copy is written NEXT TO it (same dir, so
+ * `#include main.lua` still resolves) and the caller exports that, then calls
+ * `cleanup()`. A cart that ALREADY has a label wins (the flags are a fallback,
+ * not an override): it is returned untouched and nothing is run.
+ *
+ * @param drive the adapter's `drive`, only called for `--label-frame`.
+ */
+export declare function prepareLabeledCart(cartPath: string, options: LabelOptions, drive: (options: DriveOptions) => Promise<Pico8DriveResult>): Promise<LabeledCart | LabelCartFailure>;
+//# sourceMappingURL=label-cart.d.ts.map

package/dist/commands/label-cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-cart.d.ts","sourceRoot":"","sources":["../../src/commands/label-cart.ts"],"names":[],"mappings":"AAWA,OAAO,EAGN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,MAAM,0BAA0B,CAAC;AAGlC;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;CAezB,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAC,EAAE,CAAC;KACnD,CAAC;CACF;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAKD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,gBAAgB,CAAC,GACzD,OAAO,CAAC,WAAW,GAAG,gBAAgB,CAAC,CAwGzC"}

package/dist/commands/label-cart.js

@@ -0,0 +1,228 @@
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { Cart, CartParseError } from '../engine/cart/index.js';
+import { labelHexFromPng, LabelError } from '../engine/gfx/index.js';
+import { buildDriveHarness, DriveError, } from '../engine/pico8/index.js';
+import { makeReadInclude } from './cart-includes.js';
+/**
+ * The remedy for both label-image errors (`label-wrong-size`,
+ * `label-unsupported-png`): the screenshot `run`/`playtest` already wrote is a
+ * valid label as-is, so point at that rather than at an external image tool.
+ */
+export const LABEL_FIX_CTA = {
+    description: 'Pass a picopilot screenshot directly; it is scaled for you (any 128*k square: 128x128, 256x256, 384x384, ...). No image tool needed:',
+    commands: [
+        {
+            command: 'run <cart> --shot-dir shots',
+            description: 'Capture a frame (the cart calls extcmd("screen")), then pass shots/<name>.png to --label unchanged.',
+        },
+        {
+            command: 'export <cart> <dest> --label shots/<name>.png',
+            description: 'Bake that screenshot in as the label splash (`serve --label` takes it the same way). playtest screenshots work too.',
+        },
+    ],
+};
+/** The base filename the `--label-frame` capture names its screenshot. */
+const LABEL_FRAME_BASENAME = 'label';
+/**
+ * The `--label` / `--label-frame` step shared by `export` and `serve` (ADR-0013,
+ * ADR-0015, ADR-0016): give a labelless cart a `__label__` (the export splash)
+ * without an interactive F7 capture.
+ *
+ *  - `--label <png>`: decode an image (a `run`/`playtest` screenshot as-is, any
+ *    square integer multiple of 128x128, or any 128x128 PNG).
+ *  - `--label-frame <n>`: RUN the cart headlessly through the playtest drive
+ *    harness (ADR-0011) with NO input, advance `n` frames, screenshot that frame,
+ *    and decode it. Needs PICO-8 (`drive`); an arbitrary cart does not have to
+ *    cooperate, since the harness owns its frame loop.
+ *
+ * The two flags are mutually exclusive (`label-flags-conflict`). The user's cart
+ * is NEVER mutated: a labeled copy is written NEXT TO it (same dir, so
+ * `#include main.lua` still resolves) and the caller exports that, then calls
+ * `cleanup()`. A cart that ALREADY has a label wins (the flags are a fallback,
+ * not an override): it is returned untouched and nothing is run.
+ *
+ * @param drive the adapter's `drive`, only called for `--label-frame`.
+ */
+export async function prepareLabeledCart(cartPath, options, drive) {
+    const keep = (labelSource) => ({
+        ok: true,
+        cartPath,
+        labelSource,
+        cleanup: () => { },
+    });
+    if (options.label !== undefined && options.labelFrame !== undefined) {
+        return {
+            ok: false,
+            code: 'label-flags-conflict',
+            message: 'pass either --label <png> (an image) or --label-frame <n> (capture a frame of the running cart), not both',
+        };
+    }
+    // With no label flag the cart is only read to REPORT `labelSource`; anything
+    // odd about it (unreadable, unparseable) is left for PICO-8 to judge, exactly
+    // as before the label flags existed.
+    const noFlag = options.label === undefined && options.labelFrame === undefined;
+    let cart;
+    try {
+        cart = Cart.parse(readFileSync(cartPath, 'utf8'));
+    }
+    catch (e) {
+        if (noFlag)
+            return keep('none');
+        if (e instanceof CartParseError) {
+            return {
+                ok: false,
+                code: `cart-${e.code}`,
+                message: `could not parse the cart to inject a label: ${e.message}`,
+            };
+        }
+        throw e;
+    }
+    const existingLabel = cart.getSection('label');
+    if (existingLabel !== undefined && existingLabel.trim() !== '') {
+        return keep('cart');
+    }
+    let png;
+    let labelSource;
+    if (options.label !== undefined) {
+        const labelPath = isAbsolute(options.label)
+            ? options.label
+            : resolve(process.cwd(), options.label);
+        if (!existsSync(labelPath)) {
+            return {
+                ok: false,
+                code: 'label-not-found',
+                message: `no label image at ${labelPath}`,
+            };
+        }
+        png = readFileSync(labelPath);
+        labelSource = 'image';
+    }
+    else if (options.labelFrame !== undefined) {
+        const captured = await captureFrame(cartPath, options.labelFrame, options.backstopMs, drive);
+        if (!captured.ok)
+            return captured;
+        png = captured.png;
+        labelSource = 'frame';
+    }
+    else {
+        return keep('none');
+    }
+    let hex;
+    try {
+        hex = labelHexFromPng(png);
+    }
+    catch (e) {
+        if (e instanceof LabelError) {
+            return {
+                ok: false,
+                code: `label-${e.code}`,
+                message: e.message,
+                cta: LABEL_FIX_CTA,
+            };
+        }
+        throw e;
+    }
+    cart.setSection('label', hex);
+    const copy = join(dirname(cartPath), `.picopilot-export-${process.pid}-${Date.now()}.p8`);
+    writeFileSync(copy, cart.serialize());
+    return {
+        ok: true,
+        cartPath: copy,
+        labelSource,
+        cleanup: () => {
+            try {
+                rmSync(copy, { force: true });
+            }
+            catch {
+                // A leftover dotfile is not fatal.
+            }
+        },
+    };
+}
+/**
+ * Runs the cart through the playtest drive harness with NO input for `frame + 1`
+ * frames, screenshotting after frame `frame` (0 = the first drawn frame), and
+ * returns that PNG. The driven cart and PICO-8's screenshot dir live in a temp
+ * dir that is removed before returning.
+ */
+async function captureFrame(cartPath, frame, backstopMs, drive) {
+    let harness;
+    try {
+        harness = buildDriveHarness(readFileSync(cartPath, 'utf8'), {
+            presses: [],
+            frames: frame + 1,
+            shotFrames: [frame],
+            shotBasename: LABEL_FRAME_BASENAME,
+            readInclude: makeReadInclude(cartPath),
+        });
+    }
+    catch (e) {
+        if (e instanceof DriveError) {
+            return { ok: false, code: e.code, message: e.message };
+        }
+        throw e;
+    }
+    const shotDir = mkdtempSync(join(tmpdir(), 'picopilot-label-frame-'));
+    try {
+        const drivenCart = join(shotDir, 'driven.p8');
+        writeFileSync(drivenCart, harness.cartText);
+        const result = await drive({
+            cartPath: drivenCart,
+            shotDir,
+            blocks: harness.blocks,
+            backstopMs,
+        });
+        if (!result.ok) {
+            return {
+                ok: false,
+                code: result.reason,
+                message: `PICO-8 is not installed, so --label-frame cannot capture a frame. ${result.remedy} (needs: ${result.needs.join(', ')})`,
+            };
+        }
+        const shot = result.value.screenshots[0];
+        if (shot === undefined) {
+            const { exitReason } = result.value;
+            const tail = result.value.printh.trim().split('\n').slice(-5).join('\n');
+            const commands = [
+                {
+                    command: 'verify',
+                    description: 'Run the static gate (tokens + lint + integrity).',
+                },
+                {
+                    command: 'playtest start <cart>',
+                    description: 'Reproduce the SAME no-input frame to look at it: start a paused session (nothing held), then step and shoot.',
+                },
+                {
+                    command: `playtest step <id> --frames ${frame + 1}`,
+                    description: `Advance to frame ${frame}, as --label-frame ${frame} does.`,
+                },
+                {
+                    command: 'playtest shot <id>',
+                    description: 'Screenshot it; if it looks right, pass that PNG with --label <png> (then `playtest stop <id>`).',
+                },
+            ];
+            if (exitReason === 'timeout') {
+                commands.push({
+                    command: `export <cart> --label-frame ${frame} --backstop-ms <more>`,
+                    description: 'The capture hit the backstop (it runs about one frame per PICO-8 tick): allow more time, or pick an earlier frame.',
+                });
+            }
+            return {
+                ok: false,
+                code: 'label-frame-not-captured',
+                message: `the cart produced no frame ${frame} screenshot (exit: ${exitReason}).${tail === '' ? '' : ` Last output:\n${tail}`}`,
+                cta: {
+                    description: 'The cart did not reach that frame. Check it boots, or look at the frame first:',
+                    commands,
+                },
+            };
+        }
+        return { ok: true, png: readFileSync(shot) };
+    }
+    finally {
+        rmSync(shotDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=label-cart.js.map

package/dist/commands/label-cart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-cart.js","sourceRoot":"","sources":["../../src/commands/label-cart.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,UAAU,EACV,WAAW,EACX,YAAY,EACZ,MAAM,EACN,aAAa,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAC,MAAM,EAAC,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAC,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAC,IAAI,EAAE,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAC,eAAe,EAAE,UAAU,EAAC,MAAM,wBAAwB,CAAC;AACnE,OAAO,EACN,iBAAiB,EACjB,UAAU,GAGV,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC5B,WAAW,EACV,sIAAsI;IACvI,QAAQ,EAAE;QACT;YACC,OAAO,EAAE,6BAA6B;YACtC,WAAW,EACV,qGAAqG;SACtG;QACD;YACC,OAAO,EAAE,+CAA+C;YACxD,WAAW,EACV,qHAAqH;SACtH;KACD;CACD,CAAC;AAwCF,0EAA0E;AAC1E,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,QAAgB,EAChB,OAAqB,EACrB,KAA2D;IAE3D,MAAM,IAAI,GAAG,CAAC,WAAwB,EAAe,EAAE,CAAC,CAAC;QACxD,EAAE,EAAE,IAAI;QACR,QAAQ;QACR,WAAW;QACX,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;KACjB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrE,OAAO;YACN,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EACN,2GAA2G;SAC5G,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,8EAA8E;IAC9E,qCAAqC;IACrC,MAAM,MAAM,GACX,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC;IACjE,IAAI,IAAU,CAAC;IACf,IAAI,CAAC;QACJ,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,IAAI,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,YAAY,cAAc,EAAE,CAAC;YACjC,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE;gBACtB,OAAO,EAAE,+CAA+C,CAAC,CAAC,OAAO,EAAE;aACnE,CAAC;QACH,CAAC;QACD,MAAM,CAAC,CAAC;IACT,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,GAAe,CAAC;IACpB,IAAI,WAAwB,CAAC;IAC7B,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;YAC1C,CAAC,CAAC,OAAO,CAAC,KAAK;YACf,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,qBAAqB,SAAS,EAAE;aACzC,CAAC;QACH,CAAC;QACD,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QAC9B,WAAW,GAAG,OAAO,CAAC;IACvB,CAAC;SAAM,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAClC,QAAQ,EACR,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,UAAU,EAClB,KAAK,CACL,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,QAAQ,CAAC;QAClC,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;QACnB,WAAW,GAAG,OAAO,CAAC;IACvB,CAAC;SAAM,CAAC;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACJ,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,IAAI,CAAC,YAAY,UAAU,EAAE,CAAC;YAC7B,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE;gBACvB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,GAAG,EAAE,aAAa;aAClB,CAAC;QACH,CAAC;QACD,MAAM,CAAC,CAAC;IACT,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAChB,OAAO,CAAC,QAAQ,CAAC,EACjB,qBAAqB,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,KAAK,CACnD,CAAC;IACF,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACtC,OAAO;QACN,EAAE,EAAE,IAAI;QACR,QAAQ,EAAE,IAAI;QACd,WAAW;QACX,OAAO,EAAE,GAAG,EAAE;YACb,IAAI,CAAC;gBACJ,MAAM,CAAC,IAAI,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC;YAC7B,CAAC;YAAC,MAAM,CAAC;gBACR,mCAAmC;YACpC,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,YAAY,CAC1B,QAAgB,EAChB,KAAa,EACb,UAAkB,EAClB,KAA2D;IAE3D,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACJ,OAAO,GAAG,iBAAiB,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;YAC3D,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,KAAK,GAAG,CAAC;YACjB,UAAU,EAAE,CAAC,KAAK,CAAC;YACnB,YAAY,EAAE,oBAAoB;YAClC,WAAW,EAAE,eAAe,CAAC,QAAQ,CAAC;SACtC,CAAC,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,IAAI,CAAC,YAAY,UAAU,EAAE,CAAC;YAC7B,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAC,CAAC;QACtD,CAAC;QACD,MAAM,CAAC,CAAC;IACT,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC;QACJ,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC9C,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;YAC1B,QAAQ,EAAE,UAAU;YACpB,OAAO;YACP,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU;SACV,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,MAAM,CAAC,MAAM;gBACnB,OAAO,EAAE,qEAAqE,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aACjI,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,EAAC,UAAU,EAAC,GAAG,MAAM,CAAC,KAAK,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzE,MAAM,QAAQ,GAAG;gBAChB;oBACC,OAAO,EAAE,QAAQ;oBACjB,WAAW,EAAE,kDAAkD;iBAC/D;gBACD;oBACC,OAAO,EAAE,uBAAuB;oBAChC,WAAW,EACV,8GAA8G;iBAC/G;gBACD;oBACC,OAAO,EAAE,+BAA+B,KAAK,GAAG,CAAC,EAAE;oBACnD,WAAW,EAAE,oBAAoB,KAAK,sBAAsB,KAAK,QAAQ;iBACzE;gBACD;oBACC,OAAO,EAAE,oBAAoB;oBAC7B,WAAW,EACV,iGAAiG;iBAClG;aACD,CAAC;YACF,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CAAC;oBACb,OAAO,EAAE,+BAA+B,KAAK,uBAAuB;oBACpE,WAAW,EACV,oHAAoH;iBACrH,CAAC,CAAC;YACJ,CAAC;YACD,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,0BAA0B;gBAChC,OAAO,EAAE,8BAA8B,KAAK,sBAAsB,UAAU,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,IAAI,EAAE,EAAE;gBAC9H,GAAG,EAAE;oBACJ,WAAW,EACV,gFAAgF;oBACjF,QAAQ;iBACR;aACD,CAAC;QACH,CAAC;QACD,OAAO,EAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,EAAC,CAAC;IAC5C,CAAC;YAAS,CAAC;QACV,MAAM,CAAC,OAAO,EAAE,EAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC;IACjD,CAAC;AACF,CAAC"}

package/dist/commands/playtest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playtest.d.ts","sourceRoot":"","sources":["../../src/commands/playtest.ts"],"names":[],"mappings":"AASA,OAAO,EAAC,KAAK,GAAG,EAAqB,MAAM,OAAO,CAAC;AACnD,OAAO,EAMN,KAAK,YAAY,EAajB,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC;AAiD3E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,mBAA2C,GACzD,IAAI,CAEN"}
+{"version":3,"file":"playtest.d.ts","sourceRoot":"","sources":["../../src/commands/playtest.ts"],"names":[],"mappings":"AASA,OAAO,EAAC,KAAK,GAAG,EAAqB,MAAM,OAAO,CAAC;AACnD,OAAO,EAMN,KAAK,YAAY,EAajB,MAAM,0BAA0B,CAAC;AAGlC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,YAAY,CAAC;AA2B3E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,cAAc,GAAE,mBAA2C,GACzD,IAAI,CAEN"}