picopilot 0.0.0 → 0.1.0

package/dist/engine/pico8/drive.js

@@ -0,0 +1,581 @@
+/**
+ * The `playtest` DRIVE-transform (ADR-0011): the PURE, CI-testable core that
+ * turns an ARBITRARY cart's Lua + a driven-run SPEC into a THROWAWAY driven cart
+ * whose input and frame loop the harness OWNS. This is the load-bearing seam of
+ * `picopilot playtest`, kept pure (cart text + spec in -> cart text + encoded
+ * command blocks out) so its correctness (the `btn`/`btnp` shim, the
+ * `_update`/`_draw` wrap, btnp-edge reconstruction, the opcode/block codec, the
+ * opt-in `srand`) is unit-tested WITHOUT the paid PICO-8 binary. Only the live
+ * drive-and-capture needs a real session (the manual/opt-in tier, ADR-0011).
+ *
+ * The recipe is DECIDED + spike-verified (PICO-8 v0.2.7). This module IMPLEMENTS
+ * it; it is not open design. The three load-bearing verified facts:
+ *  1. Redefine the global `btn`/`btnp` to read a per-frame held-buttons byte
+ *     from `serial(0x804)`, RECONSTRUCTING `btnp` EDGES from the held level (a
+ *     single scripted press = exactly one `btnp` true frame, not held-repeat).
+ *  2. The host<->cart transport is FIXED-SIZE command blocks (small unpadded
+ *     writes to a live `-x` stdin coalesce/drop in the OS pipe buffer), drained
+ *     ONE block per frame gated on the step-budget, with a `printh` ACK per
+ *     completed command (the resumable session waits on the ACK; the one-shot
+ *     ignores it).
+ *  3. The harness OWNS the frame loop: it wraps `_update`/`_update60`/`_draw` so
+ *     a STEP advances exactly N frames and a PAUSE (budget 0) FREEZES the game
+ *     (its callbacks skipped -> all state held, incl. logic in `_draw`).
+ *
+ * The one-shot command sends the whole script up front and exits; the cart-side
+ * machine here is identical to what the resumable session reuses (ADR-0011).
+ */
+import { Cart } from '../cart/index.js';
+import { CartParseError } from '../cart/errors.js';
+import { DONE_SENTINEL } from './adapter.js';
+/** A structured drive-harness-build failure. */
+export class DriveError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'DriveError';
+        this.code = code;
+    }
+}
+/**
+ * The PICO-8 button bit order (the `btn(i)`/`btnp(i)` index), used by the
+ * held-buttons byte the harness pipes over `serial(0x804)`: bit `i` set = button
+ * `i` held this frame. Matches PICO-8's own `btn` indices (verified).
+ */
+export const BUTTON_BITS = {
+    left: 0,
+    right: 1,
+    up: 2,
+    down: 3,
+    o: 4,
+    x: 5,
+};
+/** The valid button-bit range [0,5] a held-buttons byte can set. */
+export const BUTTON_BIT_MIN = 0;
+export const BUTTON_BIT_MAX = 5;
+/** The accepted button NAMES (and their bits) the live `input` verb parses. */
+export const BUTTON_NAMES = {
+    left: BUTTON_BITS.left,
+    right: BUTTON_BITS.right,
+    up: BUTTON_BITS.up,
+    down: BUTTON_BITS.down,
+    o: BUTTON_BITS.o,
+    x: BUTTON_BITS.x,
+    // Common single-letter directional aliases.
+    l: BUTTON_BITS.left,
+    r: BUTTON_BITS.right,
+    u: BUTTON_BITS.up,
+    d: BUTTON_BITS.down,
+    // PICO-8 KEY convention: z = the O button, x = the X button. Agents type
+    // these (they think in keys), so accept them. (`x` already = the X button.)
+    z: BUTTON_BITS.o,
+};
+/**
+ * Parses a live-session `input` button spec into a single HELD-buttons byte: a
+ * comma/space-separated list of button NAMES (`left right up down o x`, plus the
+ * single-letter aliases `l r u d`), e.g. `"right o"` = hold Right + O this turn.
+ * Case-insensitive; an empty spec is the byte 0 (release all). An unknown name is
+ * a structured {@link DriveError} (`playtest-input-invalid`), never a silent skip.
+ * This is the SESSION-facing input surface (per-turn held level); the one-shot's
+ * {@link parseInputScript} is the frame-scripted surface. Both land on the same
+ * held byte -> {@link btnpEdges} machine.
+ */
+export function parseButtons(spec) {
+    let held = 0;
+    for (const raw of spec.split(/[\s,]+/)) {
+        if (raw.trim().length === 0)
+            continue;
+        // Shares the button vocabulary with `--input` (names or bit digits 0..5).
+        held |= 1 << parseButtonToken(raw);
+    }
+    return held;
+}
+/**
+ * The FIXED command-block size in bytes (ADR-0011). Load-bearing: small unpadded
+ * writes to a live `pico8 -x` stdin coalesce/drop in the OS pipe buffer, so every
+ * command is sent as a block of exactly this many bytes (opcode + arg + pad). The
+ * cart reads exactly this many bytes per frame and buffers a partial block across
+ * frames. 4 bytes comfortably clears the 1-2 byte coalesce window the spike hit.
+ */
+export const BLOCK_SIZE = 4;
+/**
+ * The tagged opcodes carried in a command block's first byte (ADR-0011). One
+ * command per block; the cart drains one block per frame against the step budget.
+ *  - STEP<n>:   advance exactly `n` frames (the arg byte), then pause.
+ *  - INPUT<b>:  set the held-buttons byte to `b` (the arg byte) for the next STEP.
+ *  - SHOT:      screenshot the current (frozen) frame.
+ *  - PAUSE:     set the step budget to 0 (freeze; callbacks skipped).
+ *  - QUIT:      print the done-sentinel so the launcher kills PICO-8.
+ */
+export const OPCODE = {
+    step: 1,
+    input: 2,
+    shot: 3,
+    pause: 4,
+    quit: 5,
+};
+/**
+ * The cart-side ACK lines the drive shim `printh`s when a command COMPLETES
+ * (ADR-0011: the resumable session WAITS for the ACK before sending the next
+ * command; the one-shot ignores them and waits only for the QUIT sentinel). One
+ * source of truth shared by the Lua shim (which prints them) and the host-side
+ * {@link import('./session.js').DriveSession} (which waits on them), so the
+ * handshake can never drift between the two ends.
+ *
+ * The load-bearing one is {@link ACK.stepDone}: a STEP's ACK fires when the frame
+ * budget REACHES ZERO (the N frames have actually advanced), NOT when the STEP
+ * block is merely read. That is what makes stepping deterministic, the host acts
+ * on a SETTLED, known frame, never mid-step. INPUT/SHOT/PAUSE complete the frame
+ * they are read (instantaneous), so they ACK at read time.
+ */
+export const ACK = {
+    /** A STEP's frame budget has fully drained (the N frames advanced). */
+    stepDone: '__PP_ACK_STEP_DONE__',
+    /** The held-buttons byte was set (INPUT). */
+    input: '__PP_ACK_INPUT__',
+    /** A screenshot was queued for the current frame (SHOT). */
+    shot: '__PP_ACK_SHOT__',
+    /** The frame budget was forced to 0 (PAUSE). */
+    pause: '__PP_ACK_PAUSE__',
+};
+/**
+ * Encodes one {@link DriveCommand} into a FIXED-SIZE ({@link BLOCK_SIZE}) block:
+ * `[opcode, arg, 0, 0]`. `arg` carries the STEP frame count or the INPUT held
+ * byte; SHOT/PAUSE/QUIT ignore it (0). Fixed size is the point (ADR-0011): the
+ * cart always consumes exactly {@link BLOCK_SIZE} bytes per read.
+ */
+export function encodeCommand(cmd) {
+    const block = new Uint8Array(BLOCK_SIZE); // zero-padded by construction
+    switch (cmd.op) {
+        case 'step':
+            block[0] = OPCODE.step;
+            block[1] = cmd.frames & 0xff;
+            break;
+        case 'input':
+            block[0] = OPCODE.input;
+            block[1] = cmd.held & 0xff;
+            break;
+        case 'shot':
+            block[0] = OPCODE.shot;
+            break;
+        case 'pause':
+            block[0] = OPCODE.pause;
+            break;
+        case 'quit':
+            block[0] = OPCODE.quit;
+            break;
+    }
+    return block;
+}
+/** Encodes a whole command script into a single concatenated block stream. */
+export function encodeScript(script) {
+    const out = new Uint8Array(script.length * BLOCK_SIZE);
+    script.forEach((cmd, i) => out.set(encodeCommand(cmd), i * BLOCK_SIZE));
+    return out;
+}
+/**
+ * A stateful block DECODER mirroring the cart-side shim: feed it raw byte chunks
+ * (a live `-x` stdin delivers arbitrary-sized reads), it buffers partial blocks
+ * across chunks and yields exactly one {@link DriveCommand} per completed
+ * {@link BLOCK_SIZE}-byte block. This is the TS twin of the Lua decoder, so the
+ * codec (including "a block split across two reads still decodes once") is
+ * asserted in CI without the binary.
+ */
+export class BlockDecoder {
+    buffer = [];
+    /** Feeds a chunk of bytes; returns the commands newly completed by it. */
+    push(chunk) {
+        for (const b of chunk)
+            this.buffer.push(b & 0xff);
+        const out = [];
+        while (this.buffer.length >= BLOCK_SIZE) {
+            const block = this.buffer.splice(0, BLOCK_SIZE);
+            out.push(decodeBlock(block));
+        }
+        return out;
+    }
+}
+/** Decodes one {@link BLOCK_SIZE}-byte block into a {@link DriveCommand}. */
+export function decodeBlock(block) {
+    const [op = 0, arg = 0] = block;
+    switch (op) {
+        case OPCODE.step:
+            return { op: 'step', frames: arg };
+        case OPCODE.input:
+            return { op: 'input', held: arg };
+        case OPCODE.shot:
+            return { op: 'shot' };
+        case OPCODE.pause:
+            return { op: 'pause' };
+        case OPCODE.quit:
+            return { op: 'quit' };
+        default:
+            // An unknown opcode is a no-op step-0 (never a crash); the codec is total.
+            return { op: 'step', frames: 0 };
+    }
+}
+/**
+ * Reconstructs `btnp` EDGES from a per-frame HELD-buttons sequence (ADR-0011,
+ * the load-bearing verified fact). Given the held byte for each frame, returns
+ * the `btnp` byte for each frame: bit `i` is set only on the frame the button
+ * TRANSITIONS 0 -> 1 (a rising edge), so a single scripted press triggers exactly
+ * one `btnp` (menus/start/single-actions behave), a hold triggers one edge then
+ * stays held (no repeat), and a release+press triggers two edges. This is a pure
+ * mirror of the cart-side shim (`btnp = held & ~prev`), tested independently.
+ */
+export function btnpEdges(held) {
+    let prev = 0;
+    return held.map((cur) => {
+        const edge = cur & ~prev & 0xff;
+        prev = cur;
+        return edge;
+    });
+}
+/**
+ * Expands scripted presses into a per-frame HELD-buttons byte array of length
+ * `frames`: frame `f`'s byte has bit `p.bit` set for every press `p` whose
+ * `[from,to]` window covers `f`. This is the level signal the harness pipes; the
+ * cart reconstructs `btnp` edges from it (see {@link btnpEdges}).
+ */
+export function pressesToHeld(presses, frames) {
+    const held = new Array(frames).fill(0);
+    for (const p of presses) {
+        for (let f = Math.max(0, p.from); f <= p.to && f < frames; f++) {
+            held[f] = (held[f] ?? 0) | (1 << p.bit);
+        }
+    }
+    return held;
+}
+/**
+ * Resolves a single BUTTON token to its bit. Accepts a NAME (`left right up down
+ * o x`, plus aliases `l r u d`, case-insensitive) OR a bare bit digit `0..5`, so
+ * BOTH `playtest` input surfaces share one button vocabulary (the `--input`
+ * timeline and the session `input` verb). An unknown token is a structured
+ * {@link DriveError}.
+ */
+export function parseButtonToken(token) {
+    const t = token.trim().toLowerCase();
+    const named = BUTTON_NAMES[t];
+    if (named !== undefined)
+        return named;
+    if (/^\d+$/.test(t)) {
+        const bit = Number(t);
+        if (bit >= BUTTON_BIT_MIN && bit <= BUTTON_BIT_MAX)
+            return bit;
+    }
+    throw new DriveError('playtest-input-invalid', `unknown button "${token}": use a name (left/right/up/down/o/x, or l/r/u/d) or a bit 0..5 (0=L 1=R 2=U 3=D 4=O 5=X)`);
+}
+/**
+ * Parses an `--input` spec into scripted presses. Each comma-separated token is
+ * either a TIMELINE entry `frame:button` / `from-to:button` (a press at that
+ * frame, or a hold across the inclusive window) OR a BARE button (a name/key with
+ * no `frame:`), which is a press at frame 0, so a name-only spec like `"z"` or
+ * `"o right"` (the natural "just press this" form, matching the session `input`
+ * verb) Just Works. `button` is a NAME (`o x left right up down`, aliases
+ * `l r u d`, PICO-8 keys `z`/`x`) or a bit digit `0..5`, so both `playtest` input
+ * surfaces share ONE vocabulary. E.g. `"3:o, 18-22:o, 20:right"` = press O at
+ * frame 3, hold O frames 18..22, press right at frame 20; `"z"` = press O at
+ * frame 0. Whitespace around tokens is ignored (a bare list may be space- or
+ * comma-separated). An unknown button is a structured {@link DriveError}.
+ */
+export function parseInputScript(spec) {
+    const presses = [];
+    // A bare button list (no `frame:` colon anywhere) is the "just press these"
+    // form: each is a press at frame 0. Allow space- OR comma-separation for it.
+    const hasTimeline = spec.includes(':');
+    const tokens = hasTimeline ? spec.split(',') : spec.split(/[\s,]+/);
+    for (const raw of tokens) {
+        const tok = raw.trim();
+        if (tok.length === 0)
+            continue;
+        const m = /^(\d+)(?:-(\d+))?:(.+)$/.exec(tok);
+        if (m === null) {
+            if (tok.includes(':')) {
+                throw new DriveError('playtest-input-invalid', `bad input token "${tok}": expected "frame:button" or "from-to:button" (button = a name like o/right or a bit 0..5)`);
+            }
+            // A bare button = a press at frame 0.
+            presses.push({ from: 0, to: 0, bit: parseButtonToken(tok) });
+            continue;
+        }
+        const from = Number(m[1]);
+        const to = m[2] !== undefined ? Number(m[2]) : from;
+        const bit = parseButtonToken(m[3]);
+        if (to < from) {
+            throw new DriveError('playtest-input-invalid', `hold window end ${to} precedes start ${from} in "${tok}"`);
+        }
+        presses.push({ from, to, bit });
+    }
+    return presses;
+}
+/**
+ * The GENERIC input default (ADR-0011, US #9): applied when `--input` is omitted.
+ * Tuned to REACH play and stay there briefly for common one-button / runner /
+ * flappy shapes: press O once to START, a few well-spaced single-frame O presses
+ * (clean `btnp` edges) so a one-button game acts without dying instantly, a short
+ * O HOLD for hold-to-thrust games, and a right-nudge for directional runners. It
+ * is a best-effort default, NOT a universal driver; an unusual control scheme
+ * should pass an explicit per-cart `--input` (documented in the command help).
+ */
+export const GENERIC_INPUT = [
+    { from: 3, to: 3, bit: BUTTON_BITS.o }, // press O to start
+    { from: 16, to: 16, bit: BUTTON_BITS.o }, // a gentle action
+    { from: 18, to: 22, bit: BUTTON_BITS.o }, // a short hold (thrust games)
+    { from: 20, to: 20, bit: BUTTON_BITS.right }, // a right-nudge (runners)
+    { from: 24, to: 24, bit: BUTTON_BITS.o },
+    { from: 30, to: 30, bit: BUTTON_BITS.o },
+];
+/**
+ * The default number of frames the generic/one-shot driver advances the cart, and
+ * the shot points within it. Chosen (per the spike) to catch LIVE play soon after
+ * the start press (before any death/retry churn) then a couple more spread out.
+ */
+export const DEFAULT_DRIVE_FRAMES = 40;
+export const DEFAULT_SHOT_FRAMES = [12, 22, 34];
+/**
+ * Inlines `#include <file>` directives in a cart's Lua so the driven cart is
+ * self-contained (it runs from a throwaway temp dir where the included files are
+ * absent, and `definedCallbacks` must SEE the real `_update`/`_draw` that live in
+ * the included file). Matches PICO-8's own `#include`: a line whose first
+ * non-space token is `#include`, the rest of the line is the path. Resolves
+ * recursively (an included file may itself `#include`), guarding against cycles.
+ * A path the resolver cannot read is left verbatim (best-effort, like the rest of
+ * the transform). With no resolver, the Lua is returned unchanged.
+ */
+export function resolveIncludes(lua, readInclude, seen = new Set()) {
+    if (readInclude === undefined)
+        return lua;
+    return lua
+        .split('\n')
+        .map((line) => {
+        const m = /^\s*#include\s+(.+?)\s*$/.exec(line);
+        if (m === null)
+            return line;
+        const path = m[1];
+        if (seen.has(path))
+            return line; // cycle guard: leave it
+        const content = readInclude(path);
+        if (content === undefined)
+            return line; // unreadable: leave verbatim
+        return resolveIncludes(content, readInclude, new Set([...seen, path]));
+    })
+        .join('\n');
+}
+/** The default base filename SHOT names each screenshot (`play0.png`, ...). */
+export const SHOT_BASENAME = 'play';
+/**
+ * Builds the ONE-SHOT command SCRIPT from a spec: the full sequence of INPUT /
+ * STEP / SHOT / QUIT blocks that drives the cart frame-by-frame. Each frame is an
+ * INPUT (the held byte for that frame) followed by a single-frame STEP; SHOT
+ * blocks are interleaved at the shot frames; a trailing QUIT ends the run. The
+ * cart drains one block per frame, so the whole script is sent up front and the
+ * cart replays it deterministically (ADR-0011: the one-shot sends everything and
+ * exits; the block+ACK transport lets it queue without loss).
+ */
+export function buildDriveScript(spec) {
+    const presses = spec.presses ?? GENERIC_INPUT;
+    const frames = spec.frames ?? DEFAULT_DRIVE_FRAMES;
+    const shotFrames = new Set(spec.shotFrames ?? DEFAULT_SHOT_FRAMES);
+    const held = pressesToHeld(presses, frames);
+    const script = [];
+    let prevHeld = -1;
+    for (let f = 0; f < frames; f++) {
+        const h = held[f] ?? 0;
+        // Only re-send INPUT when the held level CHANGES (the cart holds the last
+        // value); this keeps the block stream compact without losing any edge.
+        if (h !== prevHeld) {
+            script.push({ op: 'input', held: h });
+            prevHeld = h;
+        }
+        script.push({ op: 'step', frames: 1 });
+        if (shotFrames.has(f))
+            script.push({ op: 'shot' });
+    }
+    script.push({ op: 'quit' });
+    return script;
+}
+/**
+ * Which frame callbacks the cart defines. `_update60` (60fps) takes precedence
+ * over `_update` (30fps) in PICO-8; a cart may define only `_draw` (a draw-only
+ * cart). The harness wraps whichever exist and is no-op-safe when one is missing.
+ */
+function definedCallbacks(lua) {
+    return {
+        update: /function\s+_update\s*\(/.test(lua),
+        update60: /function\s+_update60\s*\(/.test(lua),
+        draw: /function\s+_draw\s*\(/.test(lua),
+    };
+}
+/**
+ * The DRIVE shim, prepended to a throwaway copy of the cart (ADR-0011). It:
+ *  - redefines the global `btn`/`btnp` to read a per-frame held-buttons byte from
+ *    a harness-owned variable, reconstructing `btnp` edges (`held & ~prev`);
+ *  - decodes FIXED-SIZE ({@link BLOCK_SIZE}) command blocks from `serial(0x804)`,
+ *    buffering partial blocks across frames, one block drained per frame;
+ *  - owns the frame loop: a STEP advances exactly N frames (the budget); budget 0
+ *    FREEZES the game (both `_update*` AND `_draw` skipped between shots, so
+ *    logic-in-draw also freezes -> a stable framebuffer). A SHOT renders the
+ *    current state once (via `_draw`) THEN screenshots it, so the capture always
+ *    reflects the frame just drawn (never a stale/pre-draw framebuffer);
+ *  - `printh`s an ACK when a command COMPLETES (INPUT/SHOT/PAUSE at read time; a
+ *    STEP when its frame budget drains to 0, so a step ACK means the N frames
+ *    actually ran, see {@link ACK}), which the resumable session waits on; the
+ *    one-shot ignores the ACKs and waits only for the done-sentinel on QUIT.
+ *
+ * The shim wraps whichever of `_update`/`_update60`/`_draw` the cart defines by
+ * capturing them AFTER the cart's code runs (in `_init`-time via a deferred
+ * hook), so it is no-op-safe when a callback is missing.
+ */
+function driveShim(callbacks, sentinel, shotBasename) {
+    // PICO-8 sets _update60 XOR _update; capture whichever exists as the ticked
+    // callback. _draw is separate. We freeze BOTH when the budget is 0.
+    return [
+        '-- picopilot playtest drive shim (auto-injected; throwaway; ADR-0011).',
+        '-- Redefines btn/btnp to a harness-piped held-buttons byte (serial 0x804),',
+        '-- reconstructs btnp edges, and owns the frame loop (step/pause/shot/quit)',
+        '-- over fixed-size command blocks. The entry cart is UNTOUCHED (copy).',
+        '__drv_held=0 __drv_prev=0',
+        '__drv_budget=0 __drv_buf="" __drv_shot=0 __drv_pshot=nil',
+        `__drv_bs=${BLOCK_SIZE}`,
+        `function btn(i,p) if i==nil then return __drv_held end return (__drv_held & (1<<i))!=0 end`,
+        'function btnp(i,p) return (__drv_held & (1<<i))!=0 and (__drv_prev & (1<<i))==0 end',
+        '-- Read exactly one fixed-size block per frame from stdin; buffer partials.',
+        'function __drv_read_block()',
+        ' local n=serial(0x804,0x4300,__drv_bs)',
+        ' for j=0,n-1 do __drv_buf=__drv_buf..chr(peek(0x4300+j)) end',
+        ' if #__drv_buf<__drv_bs then return nil end',
+        ' local op=ord(__drv_buf,1) local arg=ord(__drv_buf,2)',
+        ' __drv_buf=sub(__drv_buf,__drv_bs+1)',
+        ' return op,arg',
+        'end',
+        '-- Drain one command block per frame, gated on the step budget.',
+        'function __drv_poll()',
+        ' if __drv_budget>0 then return end',
+        ' local op,arg=__drv_read_block()',
+        ' if op==nil then return end',
+        ` if op==${OPCODE.input} then __drv_held=arg printh("${ACK.input}")`,
+        // STEP does NOT ACK at read time; its ACK (`__drv_step_done`) fires when the
+        // budget drains to 0 (below), so the host learns the N frames ACTUALLY ran.
+        ` elseif op==${OPCODE.step} then __drv_budget=arg`,
+        ` elseif op==${OPCODE.shot} then __drv_pshot="${shotBasename}"..__drv_shot __drv_shot+=1 printh("${ACK.shot}")`,
+        ` elseif op==${OPCODE.pause} then __drv_budget=0 printh("${ACK.pause}")`,
+        ` elseif op==${OPCODE.quit} then printh("${sentinel}")`,
+        ' end',
+        'end',
+        '-- Frame ownership: advance the ticked callback only while budget>0, and',
+        '-- freeze _draw too so logic-in-draw holds. __drv_tick is set below.',
+        '-- btnp edges are computed relative to the PREVIOUS TICK (not the previous',
+        '-- host frame): INPUT and STEP arrive on separate frames, so __drv_prev is',
+        '-- updated to the held level only AFTER a tick runs. A single scripted press',
+        '-- (INPUT held then INPUT 0, each followed by a STEP) is thus one btnp edge.',
+        'function __drv_step()',
+        ' __drv_poll()',
+        ' if __drv_budget>0 then',
+        '  __drv_budget-=1',
+        '  if __drv_tick then __drv_tick() end',
+        '  __drv_prev=__drv_held',
+        // A STEP completes (its ACK) the frame its budget reaches 0: the requested N
+        // frames have now advanced, so the host acts on a settled frame (ADR-0011).
+        ` if __drv_budget==0 then printh("${ACK.stepDone}") end`,
+        '  return true',
+        ' end',
+        ' return false',
+        'end',
+        '',
+    ].join('\n');
+}
+/**
+ * The wrapper tab, appended AFTER the cart's code so the cart's callbacks are
+ * already defined when we capture them. It saves the cart's own
+ * `_update60`/`_update`/`_draw`, then installs harness-owned ones: the ticked
+ * callback runs the drain/step (advancing the cart's real update only while the
+ * budget allows), and `_draw` runs the cart's draw when a step advanced this
+ * frame OR a SHOT is pending (so a paused game shows a STABLE frame yet a SHOT
+ * always captures a freshly-drawn frame). A pending SHOT screenshots AFTER the
+ * cart's draw, so the capture reflects the frame just rendered, never a stale
+ * pre-draw framebuffer. No-op-safe when a callback is missing (draw-only carts).
+ */
+function wrapperTab(callbacks) {
+    const ticked = callbacks.update60
+        ? '_update60'
+        : callbacks.update
+            ? '_update'
+            : undefined;
+    const lines = [
+        '',
+        '-->8',
+        '-- picopilot playtest wrapper (auto-injected; throwaway; ADR-0011).',
+        '-- Captures the cart callbacks AFTER its code ran, then OWNS the frame loop.',
+    ];
+    // __drv_tick is the cart's real ticked callback (nil for a draw-only cart);
+    // __drv_step advances it under the budget.
+    if (ticked !== undefined) {
+        lines.push(`__drv_tick=${ticked}`);
+    }
+    lines.push('__drv_draw=_draw', '__drv_advanced=false');
+    // The harness-owned ticked callback: always defined so the drain runs even for
+    // a draw-only cart. It advances the cart's real callback via __drv_step.
+    lines.push('function _update() __drv_advanced=__drv_step() end', 
+    // A cart that defined _update60 gets a 60fps loop; alias it.
+    callbacks.update60
+        ? 'function _update60() __drv_advanced=__drv_step() end'
+        : '', 
+    // _draw renders the cart's draw when a step advanced (live) OR a SHOT is
+    // pending (render the frozen state for the capture). Between shots while
+    // paused it is skipped, so logic-in-draw freezes and the last frame persists.
+    // A pending SHOT screenshots AFTER the draw, so the PNG is the frame just
+    // drawn, never a stale pre-draw framebuffer.
+    'function _draw()', ' if __drv_draw and (__drv_advanced or __drv_pshot!=nil) then __drv_draw() end', ' if __drv_pshot!=nil then', '  extcmd("set_filename",__drv_pshot) extcmd("screen") __drv_pshot=nil', ' end', 'end', '');
+    return lines.filter((l) => l !== '').join('\n') + '\n';
+}
+/**
+ * Builds the throwaway DRIVE harness (ADR-0011). Takes the user's cart text + a
+ * {@link DriveSpec} and produces a new cart with the SAME `__gfx__`/`__sfx__`/...
+ * and a `__lua__` that is: the drive shim, then the cart's own Lua (optionally
+ * prefixed with `srand(seed)` iff `--seed` given), then the wrapper tab. The
+ * entry's own cart bytes are NEVER mutated (we transform a parsed COPY).
+ *
+ * Returns the driven cart text plus the encoded command blocks the command pipes
+ * to stdin. Kept pure so every path is unit-tested without the paid binary.
+ *
+ * @throws {DriveError} an unparseable cart.
+ */
+export function buildDriveHarness(cartText, spec = {}) {
+    let cart;
+    try {
+        cart = Cart.parse(cartText);
+    }
+    catch (e) {
+        if (e instanceof CartParseError) {
+            throw new DriveError('playtest-cart-parse-error', `cart does not parse: ${e.message}`);
+        }
+        throw e;
+    }
+    const sentinel = spec.sentinel ?? DONE_SENTINEL;
+    const shotBasename = spec.shotBasename ?? SHOT_BASENAME;
+    // Inline #include directives so the driven cart is self-contained in its temp
+    // dir AND so definedCallbacks sees the real _update/_draw (which live in the
+    // included file for picopilot's standard `#include main.lua` scaffold).
+    const cartLua = resolveIncludes(cart.getSection('lua') ?? '', spec.readInclude);
+    const callbacks = definedCallbacks(cartLua);
+    // The opt-in srand: injected at the TOP of the cart's own code iff a seed is
+    // given, never silently (it changes game behaviour). It runs before the cart's
+    // _init/first frame, so rnd() is deterministic from the start.
+    const seedLine = spec.seed !== undefined ? `srand(${spec.seed})\n` : '';
+    const lua = [
+        driveShim(callbacks, sentinel, shotBasename),
+        seedLine + cartLua,
+        wrapperTab(callbacks),
+    ].join('\n');
+    cart.setSection('lua', lua);
+    const script = buildDriveScript(spec);
+    const blocks = encodeScript(script);
+    const shotCount = script.filter((c) => c.op === 'shot').length;
+    return {
+        cartText: cart.serialize(),
+        script,
+        blocks,
+        shotBasename,
+        shotCount,
+    };
+}
+//# sourceMappingURL=drive.js.map

package/dist/engine/pico8/drive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive.js","sourceRoot":"","sources":["../../../src/engine/pico8/drive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAC,IAAI,EAAC,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAC,cAAc,EAAC,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAC,aAAa,EAAC,MAAM,cAAc,CAAC;AAY3C,gDAAgD;AAChD,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC3B,IAAI,CAAiB;IAC9B,YAAY,IAAoB,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,EAAE,EAAE,CAAC;IACL,IAAI,EAAE,CAAC;IACP,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC;CACK,CAAC;AAEX,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAqC;IAC7D,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,KAAK,EAAE,WAAW,CAAC,KAAK;IACxB,EAAE,EAAE,WAAW,CAAC,EAAE;IAClB,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,CAAC,EAAE,WAAW,CAAC,CAAC;IAChB,CAAC,EAAE,WAAW,CAAC,CAAC;IAChB,4CAA4C;IAC5C,CAAC,EAAE,WAAW,CAAC,IAAI;IACnB,CAAC,EAAE,WAAW,CAAC,KAAK;IACpB,CAAC,EAAE,WAAW,CAAC,EAAE;IACjB,CAAC,EAAE,WAAW,CAAC,IAAI;IACnB,yEAAyE;IACzE,4EAA4E;IAC5E,CAAC,EAAE,WAAW,CAAC,CAAC;CAChB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACxC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACtC,0EAA0E;QAC1E,IAAI,IAAI,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAE5B;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACrB,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;CACE,CAAC;AAIX;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IAClB,uEAAuE;IACvE,QAAQ,EAAE,sBAAsB;IAChC,6CAA6C;IAC7C,KAAK,EAAE,kBAAkB;IACzB,4DAA4D;IAC5D,IAAI,EAAE,iBAAiB;IACvB,gDAAgD;IAChD,KAAK,EAAE,kBAAkB;CAChB,CAAC;AAsBX;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAiB;IAC9C,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,8BAA8B;IACxE,QAAQ,GAAG,CAAC,EAAE,EAAE,CAAC;QAChB,KAAK,MAAM;YACV,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;YACvB,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;YAC7B,MAAM;QACP,KAAK,OAAO;YACX,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;YACxB,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;YAC3B,MAAM;QACP,KAAK,MAAM;YACV,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;YACvB,MAAM;QACP,KAAK,OAAO;YACX,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;YACxB,MAAM;QACP,KAAK,MAAM;YACV,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;YACvB,MAAM;IACR,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,MAA+B;IAC3D,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IACvD,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACxE,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IAChB,MAAM,GAAa,EAAE,CAAC;IAE9B,0EAA0E;IAC1E,IAAI,CAAC,KAAqC;QACzC,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAClD,MAAM,GAAG,GAAmB,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YAChD,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;CACD;AAED,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,KAAwB;IACnD,MAAM,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IAChC,QAAQ,EAAE,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC,IAAI;YACf,OAAO,EAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAC,CAAC;QAClC,KAAK,MAAM,CAAC,KAAK;YAChB,OAAO,EAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAC,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI;YACf,OAAO,EAAC,EAAE,EAAE,MAAM,EAAC,CAAC;QACrB,KAAK,MAAM,CAAC,KAAK;YAChB,OAAO,EAAC,EAAE,EAAE,OAAO,EAAC,CAAC;QACtB,KAAK,MAAM,CAAC,IAAI;YACf,OAAO,EAAC,EAAE,EAAE,MAAM,EAAC,CAAC;QACrB;YACC,2EAA2E;YAC3E,OAAO,EAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAC,CAAC;IACjC,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,IAAuB;IAChD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAChC,IAAI,GAAG,GAAG,CAAC;QACX,OAAO,IAAI,CAAC;IACb,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC5B,OAAiC,EACjC,MAAc;IAEd,MAAM,IAAI,GAAG,IAAI,KAAK,CAAS,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC7C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,GAAG,IAAI,cAAc,IAAI,GAAG,IAAI,cAAc;YAAE,OAAO,GAAG,CAAC;IAChE,CAAC;IACD,MAAM,IAAI,UAAU,CACnB,wBAAwB,EACxB,mBAAmB,KAAK,4FAA4F,CACpH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC5C,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC/B,MAAM,CAAC,GAAG,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAChB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,UAAU,CACnB,wBAAwB,EACxB,oBAAoB,GAAG,6FAA6F,CACpH,CAAC;YACH,CAAC;YACD,sCAAsC;YACtC,OAAO,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAC,CAAC,CAAC;YAC3D,SAAS;QACV,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,MAAM,GAAG,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAW,CAAC,CAAC;QAC7C,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CACnB,wBAAwB,EACxB,mBAAmB,EAAE,mBAAmB,IAAI,QAAQ,GAAG,GAAG,CAC1D,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,EAAE,EAAE,GAAG,EAAC,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAA6B;IACtD,EAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAC,EAAE,mBAAmB;IACzD,EAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAC,EAAE,kBAAkB;IAC1D,EAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAC,EAAE,8BAA8B;IACtE,EAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,KAAK,EAAC,EAAE,0BAA0B;IACtE,EAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAC;IACtC,EAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAC;CACtC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,mBAAmB,GAAsB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAqCnE;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC9B,GAAW,EACX,WAAsE,EACtE,OAA4B,IAAI,GAAG,EAAE;IAErC,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAC1C,OAAO,GAAG;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAW,CAAC;QAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,wBAAwB;QACzD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,CAAC,6BAA6B;QACrE,OAAO,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,MAAe,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,oBAAoB,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,mBAAmB,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvB,0EAA0E;QAC1E,uEAAuE;QACvE,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,EAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAC,CAAC,CAAC;YACpC,QAAQ,GAAG,CAAC,CAAC;QACd,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAC,CAAC,CAAC;QACrC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,EAAC,EAAE,EAAE,MAAM,EAAC,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,EAAC,EAAE,EAAE,MAAM,EAAC,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC;AACf,CAAC;AAgBD;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,GAAW;IAKpC,OAAO;QACN,MAAM,EAAE,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC;QAC3C,QAAQ,EAAE,2BAA2B,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/C,IAAI,EAAE,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC;KACvC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAS,SAAS,CACjB,SAA8D,EAC9D,QAAgB,EAChB,YAAoB;IAEpB,4EAA4E;IAC5E,oEAAoE;IACpE,OAAO;QACN,wEAAwE;QACxE,4EAA4E;QAC5E,4EAA4E;QAC5E,wEAAwE;QACxE,2BAA2B;QAC3B,0DAA0D;QAC1D,YAAY,UAAU,EAAE;QACxB,4FAA4F;QAC5F,qFAAqF;QACrF,6EAA6E;QAC7E,6BAA6B;QAC7B,wCAAwC;QACxC,8DAA8D;QAC9D,6CAA6C;QAC7C,uDAAuD;QACvD,sCAAsC;QACtC,gBAAgB;QAChB,KAAK;QACL,iEAAiE;QACjE,uBAAuB;QACvB,oCAAoC;QACpC,kCAAkC;QAClC,6BAA6B;QAC7B,WAAW,MAAM,CAAC,KAAK,gCAAgC,GAAG,CAAC,KAAK,IAAI;QACpE,6EAA6E;QAC7E,4EAA4E;QAC5E,eAAe,MAAM,CAAC,IAAI,wBAAwB;QAClD,eAAe,MAAM,CAAC,IAAI,sBAAsB,YAAY,uCAAuC,GAAG,CAAC,IAAI,IAAI;QAC/G,eAAe,MAAM,CAAC,KAAK,gCAAgC,GAAG,CAAC,KAAK,IAAI;QACxE,eAAe,MAAM,CAAC,IAAI,iBAAiB,QAAQ,IAAI;QACvD,MAAM;QACN,KAAK;QACL,0EAA0E;QAC1E,sEAAsE;QACtE,4EAA4E;QAC5E,4EAA4E;QAC5E,8EAA8E;QAC9E,8EAA8E;QAC9E,uBAAuB;QACvB,eAAe;QACf,yBAAyB;QACzB,mBAAmB;QACnB,uCAAuC;QACvC,yBAAyB;QACzB,6EAA6E;QAC7E,4EAA4E;QAC5E,oCAAoC,GAAG,CAAC,QAAQ,QAAQ;QACxD,eAAe;QACf,MAAM;QACN,eAAe;QACf,KAAK;QACL,EAAE;KACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,UAAU,CAAC,SAInB;IACA,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ;QAChC,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,SAAS,CAAC,MAAM;YACjB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,KAAK,GAAa;QACvB,EAAE;QACF,MAAM;QACN,qEAAqE;QACrE,8EAA8E;KAC9E,CAAC;IACF,4EAA4E;IAC5E,2CAA2C;IAC3C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAAC;IACvD,+EAA+E;IAC/E,yEAAyE;IACzE,KAAK,CAAC,IAAI,CACT,oDAAoD;IACpD,6DAA6D;IAC7D,SAAS,CAAC,QAAQ;QACjB,CAAC,CAAC,sDAAsD;QACxD,CAAC,CAAC,EAAE;IACL,yEAAyE;IACzE,yEAAyE;IACzE,8EAA8E;IAC9E,0EAA0E;IAC1E,6CAA6C;IAC7C,kBAAkB,EAClB,+EAA+E,EAC/E,2BAA2B,EAC3B,uEAAuE,EACvE,MAAM,EACN,KAAK,EACL,EAAE,CACF,CAAC;IACF,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAChC,QAAgB,EAChB,OAAkB,EAAE;IAEpB,IAAI,IAAU,CAAC;IACf,IAAI,CAAC;QACJ,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,IAAI,CAAC,YAAY,cAAc,EAAE,CAAC;YACjC,MAAM,IAAI,UAAU,CACnB,2BAA2B,EAC3B,wBAAwB,CAAC,CAAC,OAAO,EAAE,CACnC,CAAC;QACH,CAAC;QACD,MAAM,CAAC,CAAC;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,aAAa,CAAC;IAChD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,aAAa,CAAC;IACxD,8EAA8E;IAC9E,6EAA6E;IAC7E,wEAAwE;IACxE,MAAM,OAAO,GAAG,eAAe,CAC9B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,EAC5B,IAAI,CAAC,WAAW,CAChB,CAAC;IACF,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE5C,6EAA6E;IAC7E,+EAA+E;IAC/E,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAExE,MAAM,GAAG,GAAG;QACX,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC;QAC5C,QAAQ,GAAG,OAAO;QAClB,UAAU,CAAC,SAAS,CAAC;KACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE5B,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IAE/D,OAAO;QACN,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE;QAC1B,MAAM;QACN,MAAM;QACN,YAAY;QACZ,SAAS;KACT,CAAC;AACH,CAAC"}