picopilot 0.0.0 → 0.1.1

package/dist/engine/audio/sfx.js

@@ -0,0 +1,506 @@
+/**
+ * `engine/audio` — the shrinko-free picopilot-MML to `__sfx__` codec.
+ *
+ * This module OWNS the picopilot-MML dialect and its transpilation into ONE
+ * `__sfx__` text row (the friendly text surface PICO-8 serializes, NOT the
+ * scattered RAM bit-packing). It is the greenfield/algorithmic seam of the audio
+ * path; the `sfx from-mml` command is thin wiring over {@link mmlToSfxRow}.
+ *
+ * The mapping is the CLOSED spec from the ADR-0005 spike, verified byte-for-byte
+ * against PICO-8 v0.2.7:
+ * `work/notes/findings/pico8-audio-sfx-music-layout-and-mml-subset.md` (Part A =
+ * the `__sfx__` text layout; Part B = the picopilot-MML grammar + mapping).
+ *
+ * The KEY reframe (finding B.4 / B.7 #1): PICO-8 has NO per-note duration or
+ * tempo. Every note occupies exactly one tracker ROW; all rows share ONE
+ * SFX-level `speed`. A picopilot-MML length is therefore a ROW COUNT, not a
+ * musical fraction, and there is no tempo/BPM token. Holding a note for M rows
+ * re-emits the same note in the following (M-1) rows (PICO-8 has no cross-row
+ * sustain bit).
+ *
+ * Out-of-range pitch and >32 rows are STRUCTURED ERRORS ({@link AudioMmlError}),
+ * never silent clamps: a silent clamp produces wrong-sounding music the author
+ * cannot see (finding B.2 / B.4, matching picopilot's smart-refuse philosophy).
+ *
+ * SFX-level FILTER directives (finding A.7): `!noiz !buzz !detune1/!detune2
+ * !reverb[1|2] !dampen[1|2]` set PICO-8's 5 per-SFX filters (the first header
+ * byte), reaching the class of DESIGNED sounds (explosion = DAMPEN body + REVERB
+ * tail, engine hum, pad) that no per-note pitch/waveform/volume MML can
+ * synthesize. `!`-prefixed keywords never collide with the note grammar (unlike
+ * the rejected bare-letter effect mnemonics, ADR-0008). A bad DAMPEN/REVERB level
+ * is a structured refusal, never a clamp.
+ */
+/** A `__sfx__` row is exactly this many hex chars: 8 header + 32 notes x 5. */
+export const SFX_ROW_LENGTH = 168;
+/** The number of tracker rows (notes) in one SFX. A hard PICO-8 limit. */
+export const SFX_MAX_ROWS = 32;
+/** The lowest representable pitch: C0 = 0 (finding A.2 / B.2). */
+export const PITCH_MIN = 0;
+/** The highest representable pitch: D#5 = 63 (finding A.2 / B.2). */
+export const PITCH_MAX = 63;
+/** The default octave when none is set (`o2`, pitch 24 = C2; finding B.2). */
+export const DEFAULT_OCTAVE = 2;
+/** The default SFX speed (ticks/row) when `s<N>` is omitted (finding B.5). */
+export const DEFAULT_SPEED = 16;
+/** The default note length in tracker rows (one row; finding B.4). */
+export const DEFAULT_LENGTH = 1;
+/**
+ * The per-SFX FILTER switches (finding A.7). They live in the FIRST header byte
+ * of the `__sfx__` row (the `[0:2]` hex pair, the byte A.1 called "editor mode"):
+ * an 8-bit bitfield whose LOW bit is the cosmetic pitch/tracker mode flag and
+ * whose upper 7 bits are the filters. picopilot emits mode 0 (pitch mode), so the
+ * byte is exactly the OR of the selected filter values below.
+ *
+ * Decoded byte-for-byte on PICO-8 v0.2.7 by poke-and-readback + single-bit audio
+ * diff (finding A.7). NOIZ applies only to instrument 6 (`@6`, manual);
+ * DAMPEN/REVERB have 2 levels each (`!dampen`/`!dampen2`, `!reverb`/`!reverb2`).
+ */
+export const FILTER_NOIZ = 0x02;
+export const FILTER_BUZZ = 0x04;
+export const FILTER_DETUNE_1 = 0x08;
+export const FILTER_DETUNE_2 = 0x10;
+/** REVERB (echo) switch (`0x20`); see the level note below (finding A.7). */
+export const FILTER_REVERB = 0x20;
+/**
+ * DAMPEN (low-pass) level 1 (`0x80`) and level 2 (`0xc0`); 0 = off (finding
+ * A.7). Verified progressive: `0xc0` low-passes strictly more than `0x80`.
+ */
+export const FILTER_DAMPEN_LEVEL = [0x00, 0x80, 0xc0];
+/** The highest level DAMPEN (`!dampen<N>`) accepts (finding A.7). */
+export const FILTER_MAX_LEVEL = 2;
+/**
+ * Semitone offset of each note letter from C, within an octave (finding B.2:
+ * `c=0,d=2,e=4,f=5,g=7,a=9,b=11`).
+ */
+const SEMITONE = {
+    c: 0,
+    d: 2,
+    e: 4,
+    f: 5,
+    g: 7,
+    a: 9,
+    b: 11,
+};
+/**
+ * A structured picopilot-MML transpile failure. Carries a machine-readable
+ * `code` (surfaced by the command as incur's `error({code,...})` envelope) plus
+ * a human-readable, actionable `message`. Never thrown for a case the spec
+ * defines a clamp/round for; only the genuine refusals + parse errors.
+ */
+export class AudioMmlError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'AudioMmlError';
+        this.code = code;
+    }
+}
+/**
+ * Transpiles a picopilot-MML string into ONE `__sfx__` text row (finding Part
+ * A/B). Emits the friendly text nibbles directly.
+ *
+ * Modal state model (finding B.1): `@<hex>` waveform, `v<0-7>` volume,
+ * `e<0-7>`/mnemonic effect, `o<0-5>` octave, `l<N>` default length, `>`/`<`
+ * octave shift, all sticky. A bare note emits one row using the current state.
+ *
+ * SFX-level directives (finding B.5): `s<N>` speed (default 16), `{`/`}` loop
+ * markers (single `{` = the LEN special case).
+ *
+ * Durations are TRACKER ROWS (finding B.4): a length `N` = N rows, emitted as
+ * the note then `(N-1)` tie rows re-striking it; `.` multiplies by 1.5 (rounded
+ * to the nearest whole row, warned); `r` = silent rows; `^` extends the previous
+ * note.
+ *
+ * @throws {AudioMmlError} `audio-mml-pitch-out-of-range` (a note below C0 / above
+ *   D#5), `audio-mml-sfx-overflow` (>32 rows), or `audio-mml-parse-error` (a
+ *   token that cannot be parsed, incl. a tempo-style input).
+ */
+export function mmlToSfxRow(mml) {
+    const state = {
+        octave: DEFAULT_OCTAVE,
+        waveform: 0,
+        volume: 7,
+        effect: 0,
+        length: DEFAULT_LENGTH,
+    };
+    const notes = [];
+    const warnings = [];
+    let speed = DEFAULT_SPEED;
+    let filters = 0;
+    let loopStartRow;
+    let loopEndRow;
+    let lastNote;
+    const src = mml;
+    let i = 0;
+    const len = src.length;
+    /** The overflow check, applied every time rows are appended (finding B.4). */
+    const pushNote = (note) => {
+        if (notes.length + 1 > SFX_MAX_ROWS) {
+            throw new AudioMmlError('audio-mml-sfx-overflow', `picopilot-MML produced more than ${SFX_MAX_ROWS} tracker rows (an SFX holds at most ${SFX_MAX_ROWS} rows). Split the melody across multiple SFX + a music pattern, or shorten it. (Remember: a length is a ROW COUNT, not a musical note value.)`);
+        }
+        notes.push(note);
+    };
+    while (i < len) {
+        const ch = src[i];
+        // Whitespace + `|` bar separators are cosmetic and ignored (readability).
+        if (/\s/.test(ch) || ch === '|') {
+            i++;
+            continue;
+        }
+        const lower = ch.toLowerCase();
+        // --- SFX-level directives -------------------------------------------------
+        if (lower === 's') {
+            const { value, next } = readInt(src, i + 1);
+            if (value === undefined) {
+                throw parseError(src, i, "expected a number after 's' (SFX speed)");
+            }
+            if (value < 1 || value > 255) {
+                throw parseError(src, i, `SFX speed 's${value}' out of range 1..255 (ticks per row)`);
+            }
+            speed = value;
+            i = next;
+            continue;
+        }
+        // `!<name>[<level>]`: an SFX-level FILTER directive (finding A.7). A `!` head
+        // never collides with the note grammar (unlike the rejected `sl vb dr`
+        // mnemonics, which WERE bare note-letter sequences, ADR-0008). They set the
+        // first header byte; DAMPEN/REVERB take an optional 1..2 level (default 1).
+        if (ch === '!') {
+            const parsed = readFilter(src, i);
+            filters |= parsed.bits;
+            i = parsed.next;
+            continue;
+        }
+        if (ch === '{') {
+            loopStartRow = notes.length;
+            i++;
+            continue;
+        }
+        if (ch === '}') {
+            loopEndRow = notes.length;
+            i++;
+            continue;
+        }
+        // --- Modal setters --------------------------------------------------------
+        if (lower === '@') {
+            // `@<hexdigit>`: waveform 0..7 built-in, 8..15 custom SFX-instrument.
+            const hd = src[i + 1];
+            const wv = hd === undefined ? Number.NaN : Number.parseInt(hd, 16);
+            if (Number.isNaN(wv)) {
+                throw parseError(src, i, "expected a hex digit 0-f after '@' (waveform 0-7, 8-f = custom SFX-instrument)");
+            }
+            state.waveform = wv;
+            i += 2;
+            continue;
+        }
+        if (lower === 'v') {
+            const { value, next } = readInt(src, i + 1);
+            if (value === undefined || value > 7) {
+                throw parseError(src, i, "expected a digit 0-7 after 'v' (volume)");
+            }
+            state.volume = value;
+            i = next;
+            continue;
+        }
+        if (lower === 'o') {
+            const { value, next } = readInt(src, i + 1);
+            if (value === undefined || value > 5) {
+                throw parseError(src, i, "expected a digit 0-5 after 'o' (octave)");
+            }
+            state.octave = value;
+            i = next;
+            continue;
+        }
+        if (lower === 'l') {
+            // `l<N>[.]`: default note length in ROWS (may be dotted).
+            const { value, next } = readInt(src, i + 1);
+            if (value === undefined || value < 1) {
+                throw parseError(src, i, "expected a positive number after 'l' (default note length in rows)");
+            }
+            const dots = countDots(src, next);
+            const token = src.slice(i, dots.next);
+            const rows = resolveRows(value, dots.count, token, warnings);
+            state.length = rows;
+            i = dots.next;
+            continue;
+        }
+        if (ch === '>') {
+            state.octave += 1;
+            i++;
+            continue;
+        }
+        if (ch === '<') {
+            state.octave -= 1;
+            i++;
+            continue;
+        }
+        // --- Effect ---------------------------------------------------------------
+        // `e` is BOTH a note letter and the effect prefix (finding B.1). The
+        // committed disambiguation (finding B.3: `e0..e7` is "the canonical,
+        // unambiguous form"): `e` FOLLOWED BY a digit 0-7 is the effect token; a
+        // bare `e` (or `e` + accidental/dot) falls through to the note-E handler
+        // below. So note E takes the default length (`l4 e`) rather than `e4`
+        // (which is effect 4). Documented in the command help (ADR-0008).
+        if (lower === 'e') {
+            const d = src[i + 1];
+            if (d !== undefined && d >= '0' && d <= '7') {
+                state.effect = Number.parseInt(d, 10);
+                i += 2;
+                continue;
+            }
+            if (d !== undefined && d >= '8' && d <= '9') {
+                throw parseError(src, i, "effect 'e8'/'e9' out of range; effects are e0..e7");
+            }
+            // else: fall through, `e` is the note E.
+        }
+        // --- Rest -----------------------------------------------------------------
+        if (lower === 'r') {
+            const dur = readDuration(src, i, i + 1, state.length);
+            for (let k = 0; k < dur.rows; k++) {
+                pushNote({ pitch: 0, waveform: state.waveform, volume: 0, effect: 0 });
+            }
+            collectWarning(dur, warnings);
+            lastNote = undefined;
+            i = dur.next;
+            continue;
+        }
+        // --- Tie: extend the previous note ---------------------------------------
+        if (ch === '^') {
+            if (lastNote === undefined) {
+                throw parseError(src, i, "'^' (tie) with no preceding note to extend");
+            }
+            const dur = readDuration(src, i, i + 1, state.length);
+            for (let k = 0; k < dur.rows; k++)
+                pushNote({ ...lastNote });
+            collectWarning(dur, warnings);
+            i = dur.next;
+            continue;
+        }
+        // --- Note -----------------------------------------------------------------
+        if (lower in SEMITONE) {
+            let semitone = SEMITONE[lower];
+            let j = i + 1;
+            // Accidental: `+`/`#` sharp, `-` flat.
+            if (src[j] === '+' || src[j] === '#') {
+                semitone += 1;
+                j++;
+            }
+            else if (src[j] === '-') {
+                semitone -= 1;
+                j++;
+            }
+            const pitch = 12 * state.octave + semitone;
+            const noteToken = src.slice(i, j);
+            if (pitch < PITCH_MIN || pitch > PITCH_MAX) {
+                throw new AudioMmlError('audio-mml-pitch-out-of-range', `note '${noteToken}' at octave o${state.octave} maps to pitch ${pitch}, outside PICO-8's range C0..D#5 (0..${PITCH_MAX}). PICO-8 has no notes above D#5 or below C0; pick an octave in range rather than transposing off the keyboard.`);
+            }
+            const dur = readDuration(src, i, j, state.length);
+            const note = {
+                pitch,
+                waveform: state.waveform,
+                volume: state.volume,
+                effect: state.effect,
+            };
+            for (let k = 0; k < dur.rows; k++)
+                pushNote({ ...note });
+            collectWarning(dur, warnings);
+            lastNote = note;
+            i = dur.next;
+            continue;
+        }
+        throw parseError(src, i, `unexpected token '${ch}'`);
+    }
+    const { loopStart, loopEnd } = resolveLoop(loopStartRow, loopEndRow, notes.length);
+    return {
+        row: emitRow({ filters, speed, loopStart, loopEnd, notes }),
+        rows: notes.length,
+        speed,
+        loopStart,
+        loopEnd,
+        filters,
+        roundingWarnings: warnings,
+    };
+}
+/**
+ * Reads an optional `[length][dots]` after a note/rest/tie head at `from`. If no
+ * explicit length digit is present the current default `length` (already in
+ * rows) is used, and any dots still multiply it.
+ */
+function readDuration(src, head, from, defaultRows) {
+    const { value, next } = readInt(src, from);
+    const dots = countDots(src, value === undefined ? from : next);
+    if (value === undefined && dots.count === 0) {
+        return { rows: defaultRows, next: dots.next };
+    }
+    const base = value ?? defaultRows;
+    const warnings = [];
+    const token = src.slice(head, dots.next);
+    const rows = resolveRows(base, dots.count, token, warnings);
+    return { rows, next: dots.next, warning: warnings[0] };
+}
+/**
+ * Resolves a base row count + dot count into an integer row count. Each dot
+ * multiplies by an added 1/2, 1/4, ... (dotted-note convention): `n` dots =>
+ * factor `2 - (1/2)^n`. Fractional results round to the nearest whole row (min
+ * 1), and a rounding is recorded so the command can warn (finding B.4).
+ */
+function resolveRows(base, dots, token, warnings) {
+    if (dots === 0)
+        return base;
+    const factor = 2 - 0.5 ** dots;
+    const exact = base * factor;
+    const rounded = Math.max(1, Math.round(exact));
+    if (rounded !== exact) {
+        warnings.push({ token, exactRows: exact, roundedRows: rounded });
+    }
+    return rounded;
+}
+/** Pushes a duration's rounding warning (if any) into the accumulator. */
+function collectWarning(dur, warnings) {
+    if (dur.warning)
+        warnings.push(dur.warning);
+}
+/** Counts consecutive `.` dots from `at`, returning the count + resume index. */
+function countDots(src, at) {
+    let n = at;
+    while (src[n] === '.')
+        n++;
+    return { count: n - at, next: n };
+}
+/** Reads a non-negative integer at `at`, or `undefined` if none; returns resume index. */
+function readInt(src, at) {
+    let j = at;
+    while (j < src.length && src[j] >= '0' && src[j] <= '9')
+        j++;
+    if (j === at)
+        return { value: undefined, next: at };
+    return { value: Number.parseInt(src.slice(at, j), 10), next: j };
+}
+/** Builds an `audio-mml-parse-error` naming the offending column (1-based). */
+function parseError(src, at, why) {
+    const col = at + 1;
+    const near = src.slice(at, at + 8);
+    return new AudioMmlError('audio-mml-parse-error', `picopilot-MML parse error at column ${col} (near "${near}"): ${why}. Note: durations are TRACKER ROWS (l4 = 4 rows), not tempo/BPM; there is no tempo token.`);
+}
+/**
+ * Parses one `!<name>[<level>]` FILTER directive at `at` (the `!`), returning the
+ * filter bits to OR into the SFX header byte + the resume index (finding A.7).
+ *
+ * The 5 switches: `!noiz` (instrument-6-only), `!buzz`, `!detune1`, `!detune2`,
+ * `!reverb[1|2]`, `!dampen[1|2]`. DAMPEN/REVERB take an optional level 1..2
+ * (default 1); `!dampen`/`!dampen1` = level 1, `!dampen2` = level 2. A level
+ * OUTSIDE 1..2 is a STRUCTURED refusal ({@link AudioMmlError}
+ * `audio-mml-filter-level-out-of-range`), never a silent clamp (matching the
+ * pitch/overflow refusals, ADR-0008). `!detune` requires an explicit 1/2 (the
+ * two detunes are distinct sub-modes, not levels of one).
+ *
+ * @throws {AudioMmlError} `audio-mml-filter-level-out-of-range` (bad DAMPEN/
+ *   REVERB/DETUNE level) or `audio-mml-parse-error` (an unknown `!<name>`).
+ */
+function readFilter(src, at) {
+    // Read the lowercase name letters after `!`.
+    let j = at + 1;
+    while (j < src.length && /[a-z]/i.test(src[j]))
+        j++;
+    const name = src.slice(at + 1, j).toLowerCase();
+    // Read an optional trailing level digit (e.g. `!dampen2`, `!detune1`).
+    const { value: level, next } = readInt(src, j);
+    const token = src.slice(at, next);
+    const leveled = (table, label, defaultLevel) => {
+        const lvl = level ?? defaultLevel;
+        if (lvl < 1 || lvl > FILTER_MAX_LEVEL) {
+            throw new AudioMmlError('audio-mml-filter-level-out-of-range', `filter '${token}' has ${label} level ${lvl}, outside 1..${FILTER_MAX_LEVEL}. PICO-8 gives ${label} exactly ${FILTER_MAX_LEVEL} levels; use !${name}1 or !${name}2.`);
+        }
+        return table[lvl];
+    };
+    switch (name) {
+        case 'noiz':
+            rejectLevel(src, at, token, name, level);
+            return { bits: FILTER_NOIZ, next };
+        case 'buzz':
+            rejectLevel(src, at, token, name, level);
+            return { bits: FILTER_BUZZ, next };
+        case 'reverb':
+            rejectLevel(src, at, token, name, level);
+            return { bits: FILTER_REVERB, next };
+        case 'detune': {
+            // `!detune` needs an explicit 1 or 2 (they are distinct sub-modes).
+            if (level === undefined) {
+                throw new AudioMmlError('audio-mml-filter-level-out-of-range', `filter '${token}' needs a mode: !detune1 (flange) or !detune2 (octave). PICO-8 has two distinct detunes, not a level.`);
+            }
+            if (level === 1)
+                return { bits: FILTER_DETUNE_1, next };
+            if (level === 2)
+                return { bits: FILTER_DETUNE_2, next };
+            throw new AudioMmlError('audio-mml-filter-level-out-of-range', `filter '${token}' mode ${level} is not 1 (flange) or 2 (octave).`);
+        }
+        case 'detune1':
+            return { bits: FILTER_DETUNE_1, next };
+        case 'detune2':
+            return { bits: FILTER_DETUNE_2, next };
+        case 'dampen':
+            return { bits: leveled(FILTER_DAMPEN_LEVEL, 'DAMPEN', 1), next };
+        default:
+            throw parseError(src, at, `unknown filter '${token}'. The 5 SFX filters are !noiz !buzz !detune1/!detune2 !reverb !dampen[1|2]`);
+    }
+}
+/** Refuses a level on a filter that has none (`!noiz2`, `!buzz1`), no silent drop. */
+function rejectLevel(src, at, token, name, level) {
+    if (level !== undefined) {
+        throw new AudioMmlError('audio-mml-filter-level-out-of-range', `filter '${token}' takes no level; !${name} is a simple on/off switch (only !dampen and !reverb have levels).`);
+    }
+}
+/**
+ * Resolves the raw `{`/`}` marker rows into header `loopStart`/`loopEnd` values
+ * (finding A.1 / B.5):
+ * - neither marker: loop off (`0 0`).
+ * - both: `loopStart` = row at `{`, `loopEnd` = row at `}`.
+ * - only `{`: the LEN special case (`loopEnd == 0`, `loopStart` reinterpreted as
+ *   the pattern length): emit `loopStart = rowCount`, `loopEnd = 0`.
+ */
+function resolveLoop(loopStartRow, loopEndRow, rowCount) {
+    if (loopStartRow === undefined && loopEndRow === undefined) {
+        return { loopStart: 0, loopEnd: 0 };
+    }
+    if (loopStartRow !== undefined && loopEndRow === undefined) {
+        // Single `{` = LEN special case: this SFX is `rowCount` rows long.
+        return { loopStart: rowCount, loopEnd: 0 };
+    }
+    // `}` present (with or without `{`): a real loop. A bare `}` loops back to 0.
+    return { loopStart: loopStartRow ?? 0, loopEnd: loopEndRow ?? 0 };
+}
+/** Serializes the header + notes into the 168-char `__sfx__` text row (finding A). */
+function emitRow(sfx) {
+    // Header: filter-byte(2) speed(2) loopstart(2) loopend(2). The first byte is the
+    // per-SFX FILTER bitfield (finding A.7); its low bit is the cosmetic pitch/
+    // tracker mode flag, which we leave 0 (pitch mode), so the byte is exactly the
+    // OR of the selected filter values.
+    const header = byte(sfx.filters) +
+        byte(sfx.speed) +
+        byte(sfx.loopStart) +
+        byte(sfx.loopEnd);
+    let body = '';
+    for (let r = 0; r < SFX_MAX_ROWS; r++) {
+        const note = sfx.notes[r];
+        if (note === undefined) {
+            // Unfilled rows are all-zero (pitch 0, wave 0, vol 0 = silent, eff 0).
+            body += '00000';
+            continue;
+        }
+        body +=
+            byte(note.pitch) +
+                nib(note.waveform) +
+                nib(note.volume) +
+                nib(note.effect);
+    }
+    return header + body;
+}
+/** A byte as two lowercase hex chars. */
+function byte(n) {
+    return n.toString(16).padStart(2, '0');
+}
+/** A nibble as one lowercase hex char. */
+function nib(n) {
+    return n.toString(16);
+}
+//# sourceMappingURL=sfx.js.map

package/dist/engine/audio/sfx.js.map

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

package/dist/engine/cart/cart.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The section names picopilot models in a text-format `.p8` cart. These are the
+ * markers PICO-8 writes (`__lua__`, `__gfx__`, ...); `__label__` is the cart
+ * label image, also hex.
+ */
+export declare const CART_SECTION_NAMES: readonly ["lua", "gfx", "gff", "label", "map", "sfx", "music"];
+/** A recognised `.p8` section name (without the surrounding `__`). */
+export type CartSectionName = (typeof CART_SECTION_NAMES)[number];
+/**
+ * The in-memory model of a text-format `.p8` cart: the load-bearing seam every
+ * cart-touching command (init, gfx, tokens, verify) reads and writes through.
+ *
+ * Design contract:
+ *
+ * - **Round-trip is identity.** `Cart.parse(text).serialize() === text`, byte
+ *   for byte, for any well-formed cart, regardless of newline style or trailing
+ *   newline. Achieved by preserving the header, each marker line, and each
+ *   section body verbatim, and never normalising whitespace on the way through.
+ * - **Sections are independently addressable.** {@link getSection} /
+ *   {@link setSection} read and replace one section without disturbing the
+ *   others (or the header).
+ * - **gfx/map are addressable as regions, not opaque strings.** The `__gfx__`
+ *   and `__map__` hex bodies are exposed as row/pixel grids (see `gfx.ts` /
+ *   `map.ts`) so the gfx codec and the 0x1000 overlap check can target specific
+ *   sprites/map rows.
+ */
+export declare class Cart {
+    /**
+     * The raw text before the first section marker (the `pico-8 cartridge ...`
+     * line, the `version N` line, and any trailing blank lines), preserved
+     * verbatim so it round-trips exactly.
+     */
+    readonly header: string;
+    private readonly sections;
+    private constructor();
+    /**
+     * Parses a `.p8` text blob into a {@link Cart}.
+     *
+     * Malformed input throws a {@link CartParseError} with a machine-readable
+     * `code` (missing header/version, unknown or duplicate section) rather than
+     * crashing, so the command layer can surface a structured failure.
+     */
+    static parse(text: string): Cart;
+    /** The names of the sections present in this cart, in file order. */
+    sectionNames(): CartSectionName[];
+    /** True if the cart contains the named section. */
+    hasSection(name: CartSectionName): boolean;
+    /**
+     * Returns the raw body text of a section (everything after the marker line,
+     * verbatim including its own newlines), or `undefined` if the section is not
+     * present. The gfx/map region helpers build on this.
+     */
+    getSection(name: CartSectionName): string | undefined;
+    /**
+     * Replaces one section's body in place, leaving every other section and the
+     * header untouched. If the section is not yet present it is appended (with a
+     * `__name__\n` marker in the file's dominant newline style).
+     *
+     * The body is written verbatim; callers that want a trailing newline must
+     * include it. Region-level helpers (gfx/map) go through here.
+     */
+    setSection(name: CartSectionName, body: string): void;
+    /**
+     * Serializes the cart back to a `.p8` text blob. For an unmodified cart this
+     * is byte-identical to the text it was parsed from.
+     */
+    serialize(): string;
+    /**
+     * The dominant newline style of the file, inferred from the header, used only
+     * when APPENDING a brand-new section marker (existing markers keep their own
+     * terminator verbatim). Defaults to `\n`.
+     */
+    private newline;
+}
+//# sourceMappingURL=cart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../../src/engine/cart/cart.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,gEAQrB,CAAC;AAEX,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AA+BlE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,IAAI;IAChB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC,OAAO;IAKP;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAiEhC,qEAAqE;IACrE,YAAY,IAAI,eAAe,EAAE;IAIjC,mDAAmD;IACnD,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO;IAI1C;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS;IAIrD;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IASrD;;;OAGG;IACH,SAAS,IAAI,MAAM;IAQnB;;;;OAIG;IACH,OAAO,CAAC,OAAO;CAGf"}