picopilot 0.0.0 → 0.1.0

package/dist/engine/cart/map.js

@@ -0,0 +1,118 @@
+import { CartRangeError } from './errors.js';
+/**
+ * Addressable view over a cart's `__map__` section: the tile map as a grid of
+ * 8-bit tile indices, NOT an opaque hex string.
+ *
+ * The text `__map__` stores the base map: up to 32 rows of 128 tiles, each tile
+ * a byte written as two hex chars (`grid[y][x]`). Rows 32..63 (the shared half)
+ * are NOT stored here in the text format (they live in `__gfx__`'s upper bank
+), see `gfx.ts` {@link mapRowsForSprite}; this view models the `__map__` body
+ * as written. The 0x1000 overlap check reads a shared-bank sprite's aliased map
+ * region through {@link nonZeroTilesInRows} to decide whether a write clobbers
+ * real tiles.
+ *
+ * Reads/writes go through the parsed grid; call {@link commit} to write it back
+ * into the cart's `__map__` body. A missing/short section reads as zero tiles.
+ */
+export const MAP_WIDTH = 128;
+export const MAP_ROWS = 32;
+export class MapData {
+    /** `tiles[y][x]` is the 0..255 tile index at map cell (x, y). */
+    tiles;
+    newline;
+    constructor(tiles, newline) {
+        this.tiles = tiles;
+        this.newline = newline;
+    }
+    /** Builds an addressable map from a cart's `__map__` body (all-zero if absent). */
+    static fromBody(body) {
+        const newline = body !== undefined && /\r\n/.test(body) ? '\r\n' : '\n';
+        const lines = body === undefined ? [] : body.split(/\r?\n/);
+        const tiles = [];
+        for (let y = 0; y < MAP_ROWS; y++) {
+            const line = lines[y] ?? '';
+            const row = [];
+            for (let x = 0; x < MAP_WIDTH; x++) {
+                const hi = line[x * 2];
+                const lo = line[x * 2 + 1];
+                row.push(hi === undefined || lo === undefined ? 0 : hexByte(hi, lo));
+            }
+            tiles.push(row);
+        }
+        return new MapData(tiles, newline);
+    }
+    /** Reads the tile index (0..255) at map cell (x, y). */
+    getTile(x, y) {
+        this.assertCell(x, y);
+        return this.tiles[y]?.[x] ?? 0;
+    }
+    /** Writes the tile index (0..255) at map cell (x, y). */
+    setTile(x, y, value) {
+        this.assertCell(x, y);
+        if (!Number.isInteger(value) || value < 0 || value > 255) {
+            throw new CartRangeError(`tile value ${value} out of range 0..255`);
+        }
+        const row = this.tiles[y];
+        if (row !== undefined)
+            row[x] = value;
+    }
+    /** Reads one full map row (128 tile indices) at row `y`. */
+    getRow(y) {
+        if (!Number.isInteger(y) || y < 0 || y >= MAP_ROWS) {
+            throw new CartRangeError(`map row ${y} out of range 0..${MAP_ROWS - 1}`);
+        }
+        return (this.tiles[y] ?? []).slice();
+    }
+    /**
+     * Counts non-zero tiles across a half-open row range `[start, end)`, clamped
+     * to the stored `__map__` rows (0..31). Shared-bank rows (32..63) that the
+     * text `__map__` does not store contribute zero. This is the primitive the
+     * gfx/map overlap smart-refuse uses to decide whether a shared-bank sprite
+     * write would clobber real map data.
+     */
+    nonZeroTilesInRows(start, end) {
+        let count = 0;
+        for (let y = Math.max(0, start); y < Math.min(MAP_ROWS, end); y++) {
+            for (let x = 0; x < MAP_WIDTH; x++)
+                if ((this.tiles[y]?.[x] ?? 0) !== 0)
+                    count++;
+        }
+        return count;
+    }
+    /** Serializes the grid back to a `__map__` body (32 lines of 256 hex chars). */
+    toBody() {
+        const lines = [];
+        for (let y = 0; y < MAP_ROWS; y++) {
+            let line = '';
+            for (let x = 0; x < MAP_WIDTH; x++)
+                line += byteHex(this.tiles[y]?.[x] ?? 0);
+            lines.push(line);
+        }
+        return lines.join(this.newline) + this.newline;
+    }
+    /** Writes the grid back into the cart's `__map__` section. */
+    commit(cart) {
+        cart.setSection('map', this.toBody());
+    }
+    assertCell(x, y) {
+        if (!Number.isInteger(x) ||
+            !Number.isInteger(y) ||
+            x < 0 ||
+            y < 0 ||
+            x >= MAP_WIDTH ||
+            y >= MAP_ROWS) {
+            throw new CartRangeError(`map cell (${x}, ${y}) out of range 0..${MAP_WIDTH - 1} x 0..${MAP_ROWS - 1}`);
+        }
+    }
+}
+function hexByte(hi, lo) {
+    const v = Number.parseInt(`${hi}${lo}`, 16);
+    if (Number.isNaN(v)) {
+        throw new CartRangeError(`invalid hex byte "${hi}${lo}" in __map__`);
+    }
+    return v;
+}
+function byteHex(value) {
+    return value.toString(16).padStart(2, '0');
+}
+//# sourceMappingURL=map.js.map

package/dist/engine/cart/map.js.map

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

package/dist/engine/config/config.d.ts

@@ -0,0 +1,74 @@
+import { z } from 'incur';
+/**
+ * The per-cart `picopilot.json` config, US #10.
+ *
+ * picopilot's config is incur's built-in `config: { files: ['picopilot.json'] }`
+ * mechanism (declared in `createCli`): a JSON file whose values become option
+ * DEFAULTS for the matching command, with precedence `argv > config > zod
+ * defaults`. incur keys config by command path, a command's options live under
+ * `commands.<group>.commands.<name>.options.<key>`, so a policy an agent sets
+ * once (like `allowMapOverlap`) is stored where the command that reads it looks.
+ *
+ * This module is the single source of truth for the config SHAPE: `init`
+ * scaffolds a file from {@link defaultConfigFile}, and the later `gfx set`
+ * command reads `allowMapOverlap` through incur's config layer (its own
+ * `--allow-map-overlap` option default). Keeping the shape here, rather than
+ * inlining a blob in `init`, means the scaffolded file and the reader cannot
+ * drift.
+ */
+/**
+ * The `gfx set` options that `picopilot.json` may set as defaults.
+ *
+ * `allowMapOverlap` authorises `gfx set` to write sprites 128-255 even when the
+ * overlapping `__map__` rows hold real tiles (see ADR-0004). It is a rarely /
+ * once-set PROJECT setting: OFF by default (the smart-refuse is the safety), so
+ * a fresh cart never silently loses map data. The matching invocation flag is
+ * `--allow-map-overlap`; `argv > config > default` means the flag always wins.
+ */
+export declare const GfxSetOptions: z.ZodObject<{
+    allowMapOverlap: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * The full `picopilot.json` document shape, mirroring incur's config tree
+ * (`commands.<path>.options`). Only the keys picopilot actually reads are
+ * modelled; the schema is `.strict()`-free on purpose so a human/agent may add
+ * config for commands this version does not yet know about without a parse
+ * failure.
+ */
+export declare const PicopilotConfig: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    commands: z.ZodOptional<z.ZodObject<{
+        gfx: z.ZodOptional<z.ZodObject<{
+            commands: z.ZodOptional<z.ZodObject<{
+                set: z.ZodOptional<z.ZodObject<{
+                    options: z.ZodOptional<z.ZodObject<{
+                        allowMapOverlap: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PicopilotConfig = z.infer<typeof PicopilotConfig>;
+/**
+ * The default `picopilot.json` written by `init`: valid, minimal, and
+ * self-documenting via `$schema`. It sets `allowMapOverlap: false` explicitly
+ * so the one policy knob an agent is likely to flip is visible in the file (an
+ * agent is FREE to read/write this to match a higher-level instruction, US #10)
+ * rather than hidden behind a zod default.
+ */
+export declare const defaultConfig: PicopilotConfig;
+/** The default `picopilot.json` serialized as it is written to disk (trailing newline). */
+export declare function defaultConfigFile(): string;
+/**
+ * Reads `allowMapOverlap` out of a parsed `picopilot.json` tree, tolerating a
+ * partially-shaped or absent config. Returns `false` when the key is missing or
+ * the file is malformed enough that the value cannot be found, the SAFE default
+ * (the smart-refuse still guards the genuine data-loss corner).
+ *
+ * `gfx set` normally gets this value through incur's config → option-default
+ * layer; this helper exists for callers that hold a raw config object (and to
+ * keep the "where allowMapOverlap lives" knowledge in one place).
+ */
+export declare function readAllowMapOverlap(config: unknown): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/engine/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/engine/config/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,OAAO,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;iBAOxB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;iBAsB1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,eAa3B,CAAC;AAEF,2FAA2F;AAC3F,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAM5D"}

package/dist/engine/config/config.js

@@ -0,0 +1,103 @@
+import { z } from 'incur';
+/**
+ * The per-cart `picopilot.json` config, US #10.
+ *
+ * picopilot's config is incur's built-in `config: { files: ['picopilot.json'] }`
+ * mechanism (declared in `createCli`): a JSON file whose values become option
+ * DEFAULTS for the matching command, with precedence `argv > config > zod
+ * defaults`. incur keys config by command path, a command's options live under
+ * `commands.<group>.commands.<name>.options.<key>`, so a policy an agent sets
+ * once (like `allowMapOverlap`) is stored where the command that reads it looks.
+ *
+ * This module is the single source of truth for the config SHAPE: `init`
+ * scaffolds a file from {@link defaultConfigFile}, and the later `gfx set`
+ * command reads `allowMapOverlap` through incur's config layer (its own
+ * `--allow-map-overlap` option default). Keeping the shape here, rather than
+ * inlining a blob in `init`, means the scaffolded file and the reader cannot
+ * drift.
+ */
+/**
+ * The `gfx set` options that `picopilot.json` may set as defaults.
+ *
+ * `allowMapOverlap` authorises `gfx set` to write sprites 128-255 even when the
+ * overlapping `__map__` rows hold real tiles (see ADR-0004). It is a rarely /
+ * once-set PROJECT setting: OFF by default (the smart-refuse is the safety), so
+ * a fresh cart never silently loses map data. The matching invocation flag is
+ * `--allow-map-overlap`; `argv > config > default` means the flag always wins.
+ */
+export const GfxSetOptions = z.object({
+    allowMapOverlap: z
+        .boolean()
+        .default(false)
+        .describe('Authorise `gfx set` to overwrite __map__ tiles that alias sprites 128-255 (ADR-0004). Off by default; the smart-refuse is the safety.'),
+});
+/**
+ * The full `picopilot.json` document shape, mirroring incur's config tree
+ * (`commands.<path>.options`). Only the keys picopilot actually reads are
+ * modelled; the schema is `.strict()`-free on purpose so a human/agent may add
+ * config for commands this version does not yet know about without a parse
+ * failure.
+ */
+export const PicopilotConfig = z.object({
+    $schema: z.string().optional().describe('JSON Schema reference (optional).'),
+    commands: z
+        .object({
+        gfx: z
+            .object({
+            commands: z
+                .object({
+                set: z
+                    .object({
+                    options: GfxSetOptions.partial().optional(),
+                })
+                    .optional(),
+            })
+                .optional(),
+        })
+            .optional(),
+    })
+        .optional()
+        .describe('Per-command option defaults, keyed by command path (incur config layout).'),
+});
+/**
+ * The default `picopilot.json` written by `init`: valid, minimal, and
+ * self-documenting via `$schema`. It sets `allowMapOverlap: false` explicitly
+ * so the one policy knob an agent is likely to flip is visible in the file (an
+ * agent is FREE to read/write this to match a higher-level instruction, US #10)
+ * rather than hidden behind a zod default.
+ */
+export const defaultConfig = {
+    $schema: './picopilot.schema.json',
+    commands: {
+        gfx: {
+            commands: {
+                set: {
+                    options: {
+                        allowMapOverlap: false,
+                    },
+                },
+            },
+        },
+    },
+};
+/** The default `picopilot.json` serialized as it is written to disk (trailing newline). */
+export function defaultConfigFile() {
+    return `${JSON.stringify(defaultConfig, null, 2)}\n`;
+}
+/**
+ * Reads `allowMapOverlap` out of a parsed `picopilot.json` tree, tolerating a
+ * partially-shaped or absent config. Returns `false` when the key is missing or
+ * the file is malformed enough that the value cannot be found, the SAFE default
+ * (the smart-refuse still guards the genuine data-loss corner).
+ *
+ * `gfx set` normally gets this value through incur's config → option-default
+ * layer; this helper exists for callers that hold a raw config object (and to
+ * keep the "where allowMapOverlap lives" knowledge in one place).
+ */
+export function readAllowMapOverlap(config) {
+    const parsed = PicopilotConfig.safeParse(config);
+    if (!parsed.success)
+        return false;
+    return (parsed.data.commands?.gfx?.commands?.set?.options?.allowMapOverlap ?? false);
+}
+//# sourceMappingURL=config.js.map

package/dist/engine/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/engine/config/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,OAAO,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,eAAe,EAAE,CAAC;SAChB,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACR,uIAAuI,CACvI;CACF,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC5E,QAAQ,EAAE,CAAC;SACT,MAAM,CAAC;QACP,GAAG,EAAE,CAAC;aACJ,MAAM,CAAC;YACP,QAAQ,EAAE,CAAC;iBACT,MAAM,CAAC;gBACP,GAAG,EAAE,CAAC;qBACJ,MAAM,CAAC;oBACP,OAAO,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;iBAC3C,CAAC;qBACD,QAAQ,EAAE;aACZ,CAAC;iBACD,QAAQ,EAAE;SACZ,CAAC;aACD,QAAQ,EAAE;KACZ,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACR,2EAA2E,CAC3E;CACF,CAAC,CAAC;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC7C,OAAO,EAAE,yBAAyB;IAClC,QAAQ,EAAE;QACT,GAAG,EAAE;YACJ,QAAQ,EAAE;gBACT,GAAG,EAAE;oBACJ,OAAO,EAAE;wBACR,eAAe,EAAE,KAAK;qBACtB;iBACD;aACD;SACD;KACD;CACD,CAAC;AAEF,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB;IAChC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAe;IAClD,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,CACN,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,IAAI,KAAK,CAC3E,CAAC;AACH,CAAC"}

package/dist/engine/config/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The per-cart `picopilot.json` config model: the schema `init` scaffolds from
+ * and the later `gfx set` reads `allowMapOverlap` through (via incur's config
+ * layer). See `config.ts` for why the shape lives here as one source of truth.
+ */
+export { defaultConfig, defaultConfigFile, GfxSetOptions, PicopilotConfig, readAllowMapOverlap, } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,mBAAmB,GACnB,MAAM,aAAa,CAAC"}

package/dist/engine/config/index.js

@@ -0,0 +1,7 @@
+/**
+ * The per-cart `picopilot.json` config model: the schema `init` scaffolds from
+ * and the later `gfx set` reads `allowMapOverlap` through (via incur's config
+ * layer). See `config.ts` for why the shape lives here as one source of truth.
+ */
+export { defaultConfig, defaultConfigFile, GfxSetOptions, PicopilotConfig, readAllowMapOverlap, } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,mBAAmB,GACnB,MAAM,aAAa,CAAC"}

package/dist/engine/gfx/grid.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The shrinko-free char-grid codec: converts a sprite's per-pixel colour
+ * nibbles (as {@link import('../cart/index.js').GfxSheet} reads/writes them)
+ * to and from a readable CHAR GRID, and back, as an IDENTITY.
+ *
+ * The char grid is the "SVG for pixels" (CONTEXT.md `char grid`): the EDIT
+ * surface an agent reads with `gfx show` and writes with `gfx set`. Each pixel
+ * is one character:
+ *
+ * - `.` = transparent = colour index 0 (PICO-8's index-0 doubles as the default
+ *   transparent colour; the grid renders it as `.` so an agent SEES the empty
+ *   pixels rather than a wall of `0`s).
+ * - `0`..`f` (lowercase hex) = colour indices 1..15 (`__gfx__` stores nibbles
+ *   lowercase, so decode is case-insensitive but encode is lowercase to match
+ *   what PICO-8 writes).
+ *
+ * The grid is 8 lines of 8 characters (one 8x8 sprite). The round-trip
+ * `nibbles → grid → nibbles` is an identity for every valid sprite (asserted in
+ * the tests), because `.` maps to 0 and 0 maps to `.` with no other collision.
+ *
+ * This codec is deliberately SEPARABLE from the cart model and the commands: it
+ * only knows nibble grids and strings, so the later `gfx render` task can reuse
+ * it and a test can round-trip it without a cart.
+ */
+/** The width/height (in pixels) of one sprite; a char grid is this square. */
+export declare const GRID_SIZE = 8;
+/** The character that renders colour index 0 (transparent) in a char grid. */
+export declare const TRANSPARENT_CHAR = ".";
+/**
+ * Encodes an 8x8 grid of colour nibbles (0..15) into a char-grid string: 8
+ * lines of 8 chars, `\n`-joined, no trailing newline. Index 0 → `.`; 1..15 →
+ * the lowercase hex digit.
+ *
+ * @throws {GfxGridError} if the grid is not 8x8 or a cell is out of 0..15.
+ */
+export declare function nibblesToGrid(grid: number[][]): string;
+/**
+ * Decodes a char-grid string back into an 8x8 grid of colour nibbles (0..15),
+ * the inverse of {@link nibblesToGrid}. Accepts `.` (→ 0) and hex digits
+ * (case-insensitive). Blank lines / trailing whitespace-only content are
+ * tolerated so an agent may paste a grid with a trailing newline; the parsed
+ * content must still be exactly 8 rows of 8 cells.
+ *
+ * @throws {GfxGridError} if the parsed grid is not 8x8 or a char is invalid.
+ */
+export declare function gridToNibbles(text: string): number[][];
+/** A malformed char grid or nibble grid (wrong shape or an invalid cell/char). */
+export declare class GfxGridError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=grid.d.ts.map

package/dist/engine/gfx/grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../src/engine/gfx/grid.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,SAAS,IAAc,CAAC;AAErC,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAStD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CA4BtD;AAED,kFAAkF;AAClF,qBAAa,YAAa,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI3B"}

package/dist/engine/gfx/grid.js

@@ -0,0 +1,116 @@
+import { SPRITE_SIZE } from '../cart/index.js';
+/**
+ * The shrinko-free char-grid codec: converts a sprite's per-pixel colour
+ * nibbles (as {@link import('../cart/index.js').GfxSheet} reads/writes them)
+ * to and from a readable CHAR GRID, and back, as an IDENTITY.
+ *
+ * The char grid is the "SVG for pixels" (CONTEXT.md `char grid`): the EDIT
+ * surface an agent reads with `gfx show` and writes with `gfx set`. Each pixel
+ * is one character:
+ *
+ * - `.` = transparent = colour index 0 (PICO-8's index-0 doubles as the default
+ *   transparent colour; the grid renders it as `.` so an agent SEES the empty
+ *   pixels rather than a wall of `0`s).
+ * - `0`..`f` (lowercase hex) = colour indices 1..15 (`__gfx__` stores nibbles
+ *   lowercase, so decode is case-insensitive but encode is lowercase to match
+ *   what PICO-8 writes).
+ *
+ * The grid is 8 lines of 8 characters (one 8x8 sprite). The round-trip
+ * `nibbles → grid → nibbles` is an identity for every valid sprite (asserted in
+ * the tests), because `.` maps to 0 and 0 maps to `.` with no other collision.
+ *
+ * This codec is deliberately SEPARABLE from the cart model and the commands: it
+ * only knows nibble grids and strings, so the later `gfx render` task can reuse
+ * it and a test can round-trip it without a cart.
+ */
+/** The width/height (in pixels) of one sprite; a char grid is this square. */
+export const GRID_SIZE = SPRITE_SIZE;
+/** The character that renders colour index 0 (transparent) in a char grid. */
+export const TRANSPARENT_CHAR = '.';
+/**
+ * Encodes an 8x8 grid of colour nibbles (0..15) into a char-grid string: 8
+ * lines of 8 chars, `\n`-joined, no trailing newline. Index 0 → `.`; 1..15 →
+ * the lowercase hex digit.
+ *
+ * @throws {GfxGridError} if the grid is not 8x8 or a cell is out of 0..15.
+ */
+export function nibblesToGrid(grid) {
+    assertNibbleGrid(grid);
+    const lines = [];
+    for (let r = 0; r < GRID_SIZE; r++) {
+        let line = '';
+        for (let c = 0; c < GRID_SIZE; c++)
+            line += nibbleToChar(grid[r]?.[c] ?? 0);
+        lines.push(line);
+    }
+    return lines.join('\n');
+}
+/**
+ * Decodes a char-grid string back into an 8x8 grid of colour nibbles (0..15),
+ * the inverse of {@link nibblesToGrid}. Accepts `.` (→ 0) and hex digits
+ * (case-insensitive). Blank lines / trailing whitespace-only content are
+ * tolerated so an agent may paste a grid with a trailing newline; the parsed
+ * content must still be exactly 8 rows of 8 cells.
+ *
+ * @throws {GfxGridError} if the parsed grid is not 8x8 or a char is invalid.
+ */
+export function gridToNibbles(text) {
+    // Split on either newline style; drop a single trailing empty line (a paste
+    // with a final newline) but keep interior blank lines so a genuine malformed
+    // grid (too few rows) is caught rather than silently accepted.
+    const rawLines = text.split(/\r?\n/);
+    while (rawLines.length > 0 && rawLines[rawLines.length - 1] === '')
+        rawLines.pop();
+    if (rawLines.length !== GRID_SIZE) {
+        throw new GfxGridError(`char grid must have ${GRID_SIZE} rows, got ${rawLines.length}`);
+    }
+    const grid = [];
+    for (let r = 0; r < GRID_SIZE; r++) {
+        const line = rawLines[r] ?? '';
+        if (line.length !== GRID_SIZE) {
+            throw new GfxGridError(`char grid row ${r} must have ${GRID_SIZE} cells, got ${line.length}`);
+        }
+        const row = [];
+        for (let c = 0; c < GRID_SIZE; c++)
+            row.push(charToNibble(line[c], r, c));
+        grid.push(row);
+    }
+    return grid;
+}
+/** A malformed char grid or nibble grid (wrong shape or an invalid cell/char). */
+export class GfxGridError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GfxGridError';
+    }
+}
+function nibbleToChar(n) {
+    return n === 0 ? TRANSPARENT_CHAR : n.toString(16);
+}
+function charToNibble(ch, r, c) {
+    if (ch === TRANSPARENT_CHAR)
+        return 0;
+    const v = Number.parseInt(ch, 16);
+    if (Number.isNaN(v) || v < 0 || v > 15) {
+        throw new GfxGridError(`invalid char "${ch}" at (${c}, ${r}); expected "${TRANSPARENT_CHAR}" or a hex digit 0-f`);
+    }
+    return v;
+}
+function assertNibbleGrid(grid) {
+    if (grid.length !== GRID_SIZE) {
+        throw new GfxGridError(`nibble grid must have ${GRID_SIZE} rows, got ${grid.length}`);
+    }
+    for (let r = 0; r < GRID_SIZE; r++) {
+        const row = grid[r];
+        if (row === undefined || row.length !== GRID_SIZE) {
+            throw new GfxGridError(`nibble grid row ${r} must have ${GRID_SIZE} cells`);
+        }
+        for (let c = 0; c < GRID_SIZE; c++) {
+            const v = row[c] ?? 0;
+            if (!Number.isInteger(v) || v < 0 || v > 15) {
+                throw new GfxGridError(`nibble grid cell (${c}, ${r}) = ${v} out of range 0..15`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=grid.js.map

package/dist/engine/gfx/grid.js.map

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

package/dist/engine/gfx/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `engine/gfx` — the shrinko-free char-grid codec (`__gfx__` nibbles ↔ char
+ * grid) plus the gfx/map overlap smart-refuse decision.
+ *
+ * This module OWNS the char-grid representation (the "SVG for pixels" EDIT
+ * surface), the overlap safety logic, and the palette-accurate PNG render (the
+ * JUDGE surface). The `gfx show`/`gfx set`/`gfx render` commands are thin wiring
+ * over it. It is separable from the cart model (it only speaks nibble grids,
+ * strings, and RGB buffers) so it round-trips in isolation.
+ */
+export { GRID_SIZE, GfxGridError, gridToNibbles, nibblesToGrid, TRANSPARENT_CHAR, } from './grid.js';
+export { LABEL_SIZE, LabelError, labelHexFromPng, nearestPaletteIndex, } from './label.js';
+export { decideOverlap, type OverlapDecision, spriteHasData } from './overlap.js';
+export { PICO8_PALETTE, type PaletteColor, paletteColor } from './palette.js';
+export { encodePng, type RgbImage } from './png.js';
+export { RENDER_TARGET_PX, renderSheetPng, renderSpritePng, SHEET_RENDER_SCALE, SPRITE_RENDER_SCALE, upscale, } from './render.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/gfx/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/gfx/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACN,SAAS,EACT,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,UAAU,EACV,UAAU,EACV,eAAe,EACf,mBAAmB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAC,aAAa,EAAE,KAAK,eAAe,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AAChF,OAAO,EAAC,aAAa,EAAE,KAAK,YAAY,EAAE,YAAY,EAAC,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAC,SAAS,EAAE,KAAK,QAAQ,EAAC,MAAM,UAAU,CAAC;AAClD,OAAO,EACN,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,OAAO,GACP,MAAM,aAAa,CAAC"}

package/dist/engine/gfx/index.js

@@ -0,0 +1,17 @@
+/**
+ * `engine/gfx` — the shrinko-free char-grid codec (`__gfx__` nibbles ↔ char
+ * grid) plus the gfx/map overlap smart-refuse decision.
+ *
+ * This module OWNS the char-grid representation (the "SVG for pixels" EDIT
+ * surface), the overlap safety logic, and the palette-accurate PNG render (the
+ * JUDGE surface). The `gfx show`/`gfx set`/`gfx render` commands are thin wiring
+ * over it. It is separable from the cart model (it only speaks nibble grids,
+ * strings, and RGB buffers) so it round-trips in isolation.
+ */
+export { GRID_SIZE, GfxGridError, gridToNibbles, nibblesToGrid, TRANSPARENT_CHAR, } from './grid.js';
+export { LABEL_SIZE, LabelError, labelHexFromPng, nearestPaletteIndex, } from './label.js';
+export { decideOverlap, spriteHasData } from './overlap.js';
+export { PICO8_PALETTE, paletteColor } from './palette.js';
+export { encodePng } from './png.js';
+export { RENDER_TARGET_PX, renderSheetPng, renderSpritePng, SHEET_RENDER_SCALE, SPRITE_RENDER_SCALE, upscale, } from './render.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/gfx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/gfx/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACN,SAAS,EACT,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,UAAU,EACV,UAAU,EACV,eAAe,EACf,mBAAmB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAC,aAAa,EAAwB,aAAa,EAAC,MAAM,cAAc,CAAC;AAChF,OAAO,EAAC,aAAa,EAAqB,YAAY,EAAC,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAC,SAAS,EAAgB,MAAM,UAAU,CAAC;AAClD,OAAO,EACN,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,OAAO,GACP,MAAM,aAAa,CAAC"}

package/dist/engine/gfx/label.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The `__label__` builder: turn a 128x128 image into the hex a `.p8` cart's
+ * label section holds, so `picopilot export --label <png>` can give a labelless
+ * cart a loading splash WITHOUT an interactive PICO-8 (F7) capture.
+ *
+ * A PICO-8 label is a 128x128 grid of palette indices (0..15), serialised as 128
+ * rows of 128 hex nibbles. This module decodes a PNG to RGB (via Node's stdlib
+ * `zlib` inflate, no npm dependency), maps each pixel to the NEAREST PICO-8
+ * palette colour, and emits that hex. It is the inverse direction of the
+ * palette-accurate PNG RENDER in `render.ts`/`png.ts` (which goes indices -> RGB).
+ *
+ * It intentionally supports only the PNG subset a caller realistically produces
+ * for a 128x128 label: 8-bit, non-interlaced, colour types 2 (RGB) and 6 (RGBA),
+ * and (via the palette map) 0/3 are rejected with a clear error rather than
+ * guessed at. Anything else fails loud with a structured {@link LabelError}.
+ */
+/** The fixed PICO-8 label dimensions: a 128x128 image. */
+export declare const LABEL_SIZE = 128;
+/** A structured label-build failure (bad PNG, wrong size, unsupported format). */
+export declare class LabelError extends Error {
+    readonly code: 'not-a-png' | 'unsupported-png' | 'wrong-size' | 'truncated-png';
+    constructor(code: 'not-a-png' | 'unsupported-png' | 'wrong-size' | 'truncated-png', message: string);
+}
+/** The nearest PICO-8 palette index (by squared RGB distance) for an RGB triple. */
+export declare function nearestPaletteIndex(r: number, g: number, b: number): number;
+/**
+ * Builds the `__label__` hex body (128 rows of 128 nibbles, newline-joined, with
+ * a trailing newline) from a 128x128 PNG. Each pixel is mapped to its nearest
+ * PICO-8 palette colour. The PNG MUST be exactly 128x128 ({@link LABEL_SIZE});
+ * anything else is a {@link LabelError} (`wrong-size`) so a mis-sized image fails
+ * loud instead of being silently cropped or stretched.
+ */
+export declare function labelHexFromPng(pngBytes: Uint8Array): string;
+//# sourceMappingURL=label.d.ts.map

package/dist/engine/gfx/label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../src/engine/gfx/label.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,0DAA0D;AAC1D,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,kFAAkF;AAClF,qBAAa,UAAW,SAAQ,KAAK;IAEnC,QAAQ,CAAC,IAAI,EACZ,WAAW,GAAG,iBAAiB,GAAG,YAAY,GAAG,eAAe;gBADxD,IAAI,EACZ,WAAW,GAAG,iBAAiB,GAAG,YAAY,GAAG,eAAe,EACjE,OAAO,EAAE,MAAM;CAKhB;AAsJD,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAe3E;AAID;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAkB5D"}