webserial-flasher 1.0.0

package/dist/stk500.js

@@ -0,0 +1,426 @@
+// STK500v1 programmer — main class.
+//
+// Full rewrite addressing:
+//   - DTR/RTS reset before sync (bootloader entry)
+//   - Chip erase before programming
+//   - Real verify (readback + byte comparison, not echo validation)
+//   - Complete setOptions (all 20 SET_DEVICE parameters)
+//   - Typed errors (STK500SyncError, STK500SignatureMismatchError, etc.)
+//   - Retry with configurable backoff
+//   - Transport abstraction (Node.js SerialPort or WebSerial)
+//   - Levelled logging (debug / info / warn / error)
+import Constants from './core/constants.js';
+import { STK500SyncError, STK500SignatureMismatchError, STK500VerifyError, STK500ProtocolError, STK500InvalidHexError, } from './core/errors.js';
+import sendCommand from './protocol/sendCommand.js';
+import { parseIntelHex } from './protocol/hexParser.js';
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export class STK500 {
+    constructor(transport, board, opts = {}) {
+        this.transport = transport;
+        this.board = board;
+        this.syncAttempts = opts.retry?.syncAttempts ?? 5;
+        this.retryDelayMs = opts.retry?.retryDelayMs ?? 200;
+        if (opts.quiet) {
+            this.log = () => { };
+        }
+        else if (opts.logger) {
+            this.log = opts.logger;
+        }
+        else {
+            this.log = (level, msg) => {
+                /* istanbul ignore next */
+                if (typeof console !== 'undefined') {
+                    console.log(`[webserial-flasher] [${level}] ${msg}`);
+                }
+            };
+        }
+    }
+    // ─── Reset ────────────────────────────────────────────────────────────────
+    /**
+     * Toggle DTR or RTS to force the Arduino into bootloader mode.
+     * Skipped automatically when board.resetMethod === 'none' or when
+     * the transport does not implement setSignals().
+     */
+    async resetDevice() {
+        const method = this.board.resetMethod ?? 'dtr';
+        const delay = this.board.resetDelayMs ?? 200;
+        if (method === 'none') {
+            this.log('debug', 'resetDevice: skipped (resetMethod=none)');
+            return;
+        }
+        if (!this.transport.setSignals) {
+            this.log('debug', 'resetDevice: transport has no setSignals() — skipping');
+            return;
+        }
+        this.log('info', `resetDevice: toggling ${method.toUpperCase()}`);
+        const low = method === 'dtr' ? { dtr: false } : { rts: false };
+        const high = method === 'dtr' ? { dtr: true } : { rts: true };
+        await this.transport.setSignals(low);
+        await sleep(delay);
+        await this.transport.setSignals(high);
+        await sleep(delay); // Give bootloader time to start listening
+    }
+    // ─── Sync ─────────────────────────────────────────────────────────────────
+    /**
+     * Send GET_SYNC up to `attempts` times.
+     * Throws STK500SyncError if all attempts fail.
+     */
+    async sync(attempts) {
+        this.log('debug', `sync (max ${attempts} attempts)`);
+        for (let i = 1; i <= attempts; i++) {
+            try {
+                const data = await sendCommand(this.transport, {
+                    cmd: [Constants.Cmnd_STK_GET_SYNC],
+                    responseData: Constants.OK_RESPONSE,
+                    timeout: this.board.timeout,
+                });
+                this.log('debug', `sync OK on attempt ${i}`);
+                return data;
+            }
+            catch (err) {
+                this.log('debug', `sync attempt ${i}/${attempts} failed: ${err instanceof Error ? err.message : String(err)}`);
+                if (i < attempts)
+                    await sleep(this.retryDelayMs);
+            }
+        }
+        throw new STK500SyncError(attempts);
+    }
+    // ─── Signature ────────────────────────────────────────────────────────────
+    /**
+     * Read the device signature and verify it matches board.signature.
+     * Throws STK500SignatureMismatchError when wrong board type is selected.
+     */
+    async verifySignature() {
+        this.log('debug', 'verifySignature');
+        // Response: [INSYNC, sig0, sig1, sig2, OK]  = 5 bytes
+        const data = await sendCommand(this.transport, {
+            cmd: [Constants.Cmnd_STK_READ_SIGN],
+            responseLength: 5,
+            timeout: this.board.timeout,
+        });
+        const actual = data.subarray(1, 4); // Strip INSYNC and OK framing
+        const expected = this.board.signature;
+        if (!actual.every((b, i) => b === expected[i])) {
+            throw new STK500SignatureMismatchError(expected, actual);
+        }
+        const fmt = (b) => Array.from(b).map((x) => `0x${x.toString(16).padStart(2, '0')}`).join(', ');
+        this.log('info', `signature verified: [${fmt(actual)}]`);
+        return data;
+    }
+    /**
+     * Read the raw device signature without matching against a board.
+     * Useful for auto-detecting the board type.
+     */
+    async getSignature() {
+        this.log('debug', 'getSignature');
+        const data = await sendCommand(this.transport, {
+            cmd: [Constants.Cmnd_STK_READ_SIGN],
+            responseLength: 5,
+            timeout: this.board.timeout,
+        });
+        return data.subarray(1, 4);
+    }
+    // ─── Device Configuration ─────────────────────────────────────────────────
+    /**
+     * Send SET_DEVICE with full 20-parameter configuration.
+     * Merges board defaults with any override values passed in `options`.
+     * Previously sent only 2 of the required 20 parameters — now complete.
+     */
+    async setOptions(options = {}) {
+        this.log('debug', 'setOptions');
+        const b = this.board;
+        const o = options;
+        await sendCommand(this.transport, {
+            cmd: [
+                Constants.Cmnd_STK_SET_DEVICE,
+                o['devicecode'] ?? b.deviceCode ?? 0,
+                o['revision'] ?? 0,
+                o['progtype'] ?? b.progType ?? 0,
+                o['parmode'] ?? b.parMode ?? 0,
+                o['polling'] ?? b.polling ?? 0,
+                o['selftimed'] ?? b.selfTimed ?? 0,
+                o['lockbytes'] ?? b.lockBytes ?? 0,
+                o['fusebytes'] ?? b.fuseBytes ?? 0,
+                o['flashpollval1'] ?? b.flashPollVal1 ?? 0xff,
+                o['flashpollval2'] ?? b.flashPollVal2 ?? 0xff,
+                o['eeprompollval1'] ?? b.eepromPollVal1 ?? 0xff,
+                o['eeprompollval2'] ?? b.eepromPollVal2 ?? 0xff,
+                // Page size as two bytes (high, low)
+                (b.pageSize >> 8) & 0xff,
+                b.pageSize & 0xff,
+                // EEPROM size as two bytes
+                ((b.eepromSize ?? 0) >> 8) & 0xff,
+                (b.eepromSize ?? 0) & 0xff,
+                // Flash size as four bytes (MSB first)
+                ((b.flashSize ?? 0) >> 24) & 0xff,
+                ((b.flashSize ?? 0) >> 16) & 0xff,
+                ((b.flashSize ?? 0) >> 8) & 0xff,
+                (b.flashSize ?? 0) & 0xff,
+            ],
+            responseData: Constants.OK_RESPONSE,
+            timeout: this.board.timeout,
+        });
+    }
+    // ─── Programming Mode ─────────────────────────────────────────────────────
+    async enterProgrammingMode() {
+        this.log('debug', 'enterProgrammingMode');
+        return sendCommand(this.transport, {
+            cmd: [Constants.Cmnd_STK_ENTER_PROGMODE],
+            responseData: Constants.OK_RESPONSE,
+            timeout: this.board.timeout,
+        });
+    }
+    async exitProgrammingMode() {
+        this.log('debug', 'exitProgrammingMode');
+        return sendCommand(this.transport, {
+            cmd: [Constants.Cmnd_STK_LEAVE_PROGMODE],
+            responseData: Constants.OK_RESPONSE,
+            timeout: this.board.timeout,
+        });
+    }
+    // ─── Erase ────────────────────────────────────────────────────────────────
+    /** Erase the entire flash. Must be called before programming. */
+    async chipErase() {
+        this.log('info', 'chipErase');
+        await sendCommand(this.transport, {
+            cmd: [Constants.Cmnd_STK_CHIP_ERASE],
+            responseData: Constants.OK_RESPONSE,
+            timeout: this.board.timeout,
+        });
+        await sleep(this.board.eraseDelayMs ?? 10);
+    }
+    // ─── Address / Page Helpers ───────────────────────────────────────────────
+    async loadAddress(useaddr) {
+        return sendCommand(this.transport, {
+            cmd: [Constants.Cmnd_STK_LOAD_ADDRESS, useaddr & 0xff, (useaddr >> 8) & 0xff],
+            responseData: Constants.OK_RESPONSE,
+            timeout: this.board.timeout,
+        });
+    }
+    async loadPage(writeBytes) {
+        if (writeBytes.length > this.board.pageSize) {
+            throw new STK500ProtocolError(`loadPage: ${writeBytes.length} bytes exceeds page size ${this.board.pageSize}`);
+        }
+        // Command: [CMND, size_high, size_low, 'F'(0x46=Flash), ...data..., CRC_EOP]
+        const cmd = new Uint8Array([
+            Constants.Cmnd_STK_PROG_PAGE,
+            (writeBytes.length >> 8) & 0xff,
+            writeBytes.length & 0xff,
+            0x46, // 'F' = Flash
+            ...writeBytes,
+            Constants.Sync_CRC_EOP,
+        ]);
+        return sendCommand(this.transport, {
+            cmd,
+            responseData: Constants.OK_RESPONSE,
+            timeout: this.board.timeout,
+        });
+    }
+    /**
+     * Read one page from device flash.
+     * Returns only the data bytes (INSYNC/OK framing stripped).
+     */
+    async readPage(wordAddr, size) {
+        await this.loadAddress(wordAddr);
+        // Response: [INSYNC, ...size data bytes..., OK] = size + 2
+        const response = await sendCommand(this.transport, {
+            cmd: [
+                Constants.Cmnd_STK_READ_PAGE,
+                (size >> 8) & 0xff,
+                size & 0xff,
+                0x46, // 'F' = Flash
+            ],
+            responseLength: size + 2,
+            timeout: this.board.timeout,
+        });
+        return response.subarray(1, size + 1);
+    }
+    // ─── Universal SPI (fuse / lock bit access) ───────────────────────────────
+    /**
+     * Issue a raw 4-byte SPI command via the STK500v1 UNIVERSAL command (0x56).
+     * Returns the 4th byte of the SPI response, which is the data byte.
+     *
+     * Example: await stk.universalSpi([0x50, 0x00, 0x00, 0x00]) → low fuse byte
+     */
+    async universalSpi(spiCmd) {
+        const response = await sendCommand(this.transport, {
+            cmd: [Constants.Cmnd_STK_UNIVERSAL, ...spiCmd],
+            responseLength: 6, // [INSYNC, r0, r1, r2, r3, OK]
+            timeout: this.board.timeout,
+        });
+        return response[4] ?? 0; // 4th SPI response byte
+    }
+    /**
+     * Read all fuse bytes via SPI UNIVERSAL commands.
+     * Returns { low, high, ext, lock } fuse values.
+     */
+    async readFuses() {
+        this.log('debug', 'readFuses');
+        const low = await this.universalSpi([0x50, 0x00, 0x00, 0x00]);
+        const high = await this.universalSpi([0x58, 0x08, 0x00, 0x00]);
+        const ext = await this.universalSpi([0x50, 0x08, 0x00, 0x00]);
+        const lock = await this.universalSpi([0x58, 0x00, 0x00, 0x00]);
+        this.log('info', `fuses: low=0x${low.toString(16)} high=0x${high.toString(16)} ext=0x${ext.toString(16)} lock=0x${lock.toString(16)}`);
+        return { low, high, ext, lock };
+    }
+    /**
+     * Write fuse bytes via SPI UNIVERSAL commands.
+     * @param fuse  Which fuse to write: 'low' | 'high' | 'ext' | 'lock'
+     * @param val   New fuse value
+     */
+    async writeFuse(fuse, val) {
+        this.log('debug', `writeFuse: ${fuse}=0x${val.toString(16)}`);
+        const cmds = {
+            low: [0xAC, 0xA0, 0x00, val],
+            high: [0xAC, 0xA8, 0x00, val],
+            ext: [0xAC, 0xA4, 0x00, val],
+            lock: [0xAC, 0xE0, 0x00, val],
+        };
+        await this.universalSpi(cmds[fuse]);
+        await sleep(10); // fuse write delay
+    }
+    /**
+     * Write one EEPROM page.
+     * @param byteAddr  Byte address in EEPROM (NOT word address)
+     * @param data      Data to write (length ≤ board.pageSize)
+     */
+    async writeEepromPage(byteAddr, data) {
+        // EEPROM uses byte addresses and memType 'E' (0x45)
+        const addrForLoad = this.board.use8BitAddresses ? byteAddr : byteAddr >> 1;
+        await this.loadAddress(addrForLoad);
+        const cmd = new Uint8Array([
+            Constants.Cmnd_STK_PROG_PAGE,
+            (data.length >> 8) & 0xff,
+            data.length & 0xff,
+            0x45, // 'E' = EEPROM
+            ...data,
+            Constants.Sync_CRC_EOP,
+        ]);
+        await sendCommand(this.transport, {
+            cmd,
+            responseData: Constants.OK_RESPONSE,
+            timeout: this.board.timeout,
+        });
+    }
+    /**
+     * Read one EEPROM page.
+     * @param byteAddr  Byte address in EEPROM
+     * @param size      Number of bytes to read
+     */
+    async readEepromPage(byteAddr, size) {
+        const addrForLoad = this.board.use8BitAddresses ? byteAddr : byteAddr >> 1;
+        await this.loadAddress(addrForLoad);
+        const response = await sendCommand(this.transport, {
+            cmd: [
+                Constants.Cmnd_STK_READ_PAGE,
+                (size >> 8) & 0xff,
+                size & 0xff,
+                0x45, // 'E' = EEPROM
+            ],
+            responseLength: size + 2,
+            timeout: this.board.timeout,
+        });
+        return response.subarray(1, size + 1);
+    }
+    // ─── Upload ───────────────────────────────────────────────────────────────
+    async upload(hexData, progressCallback) {
+        this.log('info', 'upload: parsing HEX');
+        const { data: hex, byteCount } = parseIntelHex(hexData);
+        this.log('info', `upload: ${byteCount} bytes to write`);
+        // Phase G: HEX size validation
+        if (this.board.flashSize && byteCount > this.board.flashSize) {
+            throw new STK500InvalidHexError(`HEX too large: ${byteCount} bytes exceeds flash size ${this.board.flashSize} bytes`);
+        }
+        let pageaddr = 0;
+        while (pageaddr < hex.length) {
+            const useaddr = this.board.use8BitAddresses ? pageaddr : pageaddr >> 1;
+            const chunkSize = Math.min(this.board.pageSize, hex.length - pageaddr);
+            const chunk = hex.subarray(pageaddr, pageaddr + chunkSize);
+            await this.loadAddress(useaddr);
+            await this.loadPage(chunk);
+            pageaddr += chunkSize;
+            await sleep(4); // Brief yield — device writes the page to flash
+            progressCallback?.((pageaddr / hex.length) * 100);
+        }
+        this.log('info', 'upload complete');
+    }
+    // ─── Verify ───────────────────────────────────────────────────────────────
+    /**
+     * Read back flash and compare byte-by-byte against the HEX source.
+     *
+     * Fixed vs original: the original sent READ_PAGE but discarded the response,
+     * making verify() a no-op. This version actually reads and compares.
+     */
+    async verify(hexData, progressCallback) {
+        this.log('info', 'verify: parsing HEX');
+        const { data: hex, byteCount } = parseIntelHex(hexData);
+        this.log('info', `verify: checking ${byteCount} bytes`);
+        let pageaddr = 0;
+        while (pageaddr < hex.length) {
+            const useaddr = this.board.use8BitAddresses ? pageaddr : pageaddr >> 1;
+            const chunkSize = Math.min(this.board.pageSize, hex.length - pageaddr);
+            const expected = hex.subarray(pageaddr, pageaddr + chunkSize);
+            const actual = await this.readPage(useaddr, chunkSize);
+            for (let i = 0; i < chunkSize; i++) {
+                if (actual[i] !== expected[i]) {
+                    throw new STK500VerifyError(pageaddr + i, expected[i], actual[i]);
+                }
+            }
+            pageaddr += chunkSize;
+            await sleep(4);
+            progressCallback?.((pageaddr / hex.length) * 100);
+        }
+        this.log('info', 'verify OK — flash matches HEX');
+    }
+    // ─── bootload (main entry point) ──────────────────────────────────────────
+    /**
+     * Complete programming sequence:
+     *   reset → sync → verify signature → configure device →
+     *   enter prog mode → erase chip → upload → verify → exit prog mode
+     *
+     * @param hexData Intel HEX string or binary
+     * @param progressCallback Called with (status, 0–100) at each stage
+     */
+    async bootload(hexData, progressCallback) {
+        const progress = (status, pct) => {
+            this.log('info', `${status} (${Math.round(pct)}%)`);
+            progressCallback?.(status, pct);
+        };
+        // 1 ── Reset device so bootloader is listening
+        progress('Resetting device', 0);
+        await this.resetDevice();
+        // 2 ── Sync: retry several times — bootloader may need a moment
+        progress('Syncing', 5);
+        await this.sync(this.syncAttempts);
+        await this.sync(3); // Second sync for reliability
+        // 3 ── Confirm we're talking to the expected chip
+        progress('Verifying signature', 15);
+        await this.verifySignature();
+        // 4 ── Send device parameters
+        progress('Configuring device', 20);
+        await this.setOptions();
+        // 5 ── Enter programming mode
+        progress('Entering programming mode', 25);
+        await this.enterProgrammingMode();
+        // 6 ── Erase flash before writing
+        progress('Erasing chip', 30);
+        await this.chipErase();
+        // 7 ── Write firmware (35 → 75%)
+        progress('Uploading', 35);
+        await this.upload(hexData, (pct) => {
+            progress('Uploading', 35 + pct * 0.40);
+        });
+        // 8 ── Read back and verify (75 → 95%)
+        progress('Verifying', 75);
+        await this.verify(hexData, (pct) => {
+            progress('Verifying', 75 + pct * 0.20);
+        });
+        // 9 ── Exit programming mode — board resets and runs new firmware
+        progress('Exiting programming mode', 95);
+        await this.exitProgrammingMode();
+        progress('Complete', 100);
+    }
+}
+//# sourceMappingURL=stk500.js.map

package/dist/stk500.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stk500.js","sourceRoot":"","sources":["../src/stk500.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,2BAA2B;AAC3B,mDAAmD;AACnD,oCAAoC;AACpC,oEAAoE;AACpE,yDAAyD;AACzD,yEAAyE;AACzE,sCAAsC;AACtC,8DAA8D;AAC9D,qDAAqD;AAErD,OAAO,SAAS,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,WAAW,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,OAAO,MAAM;IAKjB,YACmB,SAAwB,EACxB,KAAY,EAC7B,OAAsB,EAAE;QAFP,cAAS,GAAT,SAAS,CAAe;QACxB,UAAK,GAAL,KAAK,CAAO;QAG7B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,EAAE,YAAY,IAAI,GAAG,CAAC;QAEpD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QACtB,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACxB,0BAA0B;gBAC1B,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;oBACnC,OAAO,CAAC,GAAG,CAAC,wBAAwB,KAAK,KAAK,GAAG,EAAE,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,6EAA6E;IAE7E;;;;OAIG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC;QAC/C,MAAM,KAAK,GAAI,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,GAAG,CAAC;QAE9C,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,yCAAyC,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,uDAAuD,CAAC,CAAC;YAC3E,OAAO;QACT,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAElE,MAAM,GAAG,GAAI,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAChE,MAAM,IAAI,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAG,CAAC;QAEhE,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,0CAA0C;IAChE,CAAC;IAED,6EAA6E;IAE7E;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,QAAQ,YAAY,CAAC,CAAC;QAErD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;oBAC7C,GAAG,EAAW,CAAC,SAAS,CAAC,iBAAiB,CAAC;oBAC3C,YAAY,EAAE,SAAS,CAAC,WAAW;oBACnC,OAAO,EAAO,IAAI,CAAC,KAAK,CAAC,OAAO;iBACjC,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,sBAAsB,CAAC,EAAE,CAAC,CAAC;gBAC7C,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,GAAG,CACN,OAAO,EACP,gBAAgB,CAAC,IAAI,QAAQ,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC5F,CAAC;gBACF,IAAI,CAAC,GAAG,QAAQ;oBAAE,MAAM,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAED,MAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,6EAA6E;IAE7E;;;OAGG;IACH,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAErC,sDAAsD;QACtD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YAC7C,GAAG,EAAa,CAAC,SAAS,CAAC,kBAAkB,CAAC;YAC9C,cAAc,EAAE,CAAC;YACjB,OAAO,EAAS,IAAI,CAAC,KAAK,CAAC,OAAO;SACnC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,8BAA8B;QACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,4BAA4B,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,GAAG,GAAG,CAAC,CAAa,EAAU,EAAE,CACpC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YAC7C,GAAG,EAAa,CAAC,SAAS,CAAC,kBAAkB,CAAC;YAC9C,cAAc,EAAE,CAAC;YACjB,OAAO,EAAS,IAAI,CAAC,KAAK,CAAC,OAAO;SACnC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,6EAA6E;IAE7E;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,UAA2C,EAAE;QAC5D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAEhC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACrB,MAAM,CAAC,GAAG,OAAO,CAAC;QAElB,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YAChC,GAAG,EAAE;gBACH,SAAS,CAAC,mBAAmB;gBAC7B,CAAC,CAAC,YAAY,CAAC,IAAO,CAAC,CAAC,UAAU,IAAU,CAAC;gBAC7C,CAAC,CAAC,UAAU,CAAC,IAAS,CAAC;gBACvB,CAAC,CAAC,UAAU,CAAC,IAAS,CAAC,CAAC,QAAQ,IAAY,CAAC;gBAC7C,CAAC,CAAC,SAAS,CAAC,IAAU,CAAC,CAAC,OAAO,IAAa,CAAC;gBAC7C,CAAC,CAAC,SAAS,CAAC,IAAU,CAAC,CAAC,OAAO,IAAa,CAAC;gBAC7C,CAAC,CAAC,WAAW,CAAC,IAAQ,CAAC,CAAC,SAAS,IAAW,CAAC;gBAC7C,CAAC,CAAC,WAAW,CAAC,IAAQ,CAAC,CAAC,SAAS,IAAW,CAAC;gBAC7C,CAAC,CAAC,WAAW,CAAC,IAAQ,CAAC,CAAC,SAAS,IAAW,CAAC;gBAC7C,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,aAAa,IAAO,IAAI;gBAChD,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,aAAa,IAAO,IAAI;gBAChD,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,cAAc,IAAK,IAAI;gBAChD,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,cAAc,IAAK,IAAI;gBAChD,qCAAqC;gBACrC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI;gBACxB,CAAC,CAAC,QAAQ,GAAG,IAAI;gBACjB,2BAA2B;gBAC3B,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI;gBACjC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,IAAI;gBAC1B,uCAAuC;gBACvC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;gBACjC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;gBACjC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAK,CAAC,CAAC,GAAG,IAAI;gBACjC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI;aAC1B;YACD,YAAY,EAAE,SAAS,CAAC,WAAW;YACnC,OAAO,EAAO,IAAI,CAAC,KAAK,CAAC,OAAO;SACjC,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,oBAAoB;QACxB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;QAC1C,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACjC,GAAG,EAAW,CAAC,SAAS,CAAC,uBAAuB,CAAC;YACjD,YAAY,EAAE,SAAS,CAAC,WAAW;YACnC,OAAO,EAAO,IAAI,CAAC,KAAK,CAAC,OAAO;SACjC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;QACzC,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACjC,GAAG,EAAW,CAAC,SAAS,CAAC,uBAAuB,CAAC;YACjD,YAAY,EAAE,SAAS,CAAC,WAAW;YACnC,OAAO,EAAO,IAAI,CAAC,KAAK,CAAC,OAAO;SACjC,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAE7E,iEAAiE;IACjE,KAAK,CAAC,SAAS;QACb,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC9B,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YAChC,GAAG,EAAW,CAAC,SAAS,CAAC,mBAAmB,CAAC;YAC7C,YAAY,EAAE,SAAS,CAAC,WAAW;YACnC,OAAO,EAAO,IAAI,CAAC,KAAK,CAAC,OAAO;SACjC,CAAC,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACjC,GAAG,EAAW,CAAC,SAAS,CAAC,qBAAqB,EAAE,OAAO,GAAG,IAAI,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;YACtF,YAAY,EAAE,SAAS,CAAC,WAAW;YACnC,OAAO,EAAO,IAAI,CAAC,KAAK,CAAC,OAAO;SACjC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAAsB;QACnC,IAAI,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC5C,MAAM,IAAI,mBAAmB,CAC3B,aAAa,UAAU,CAAC,MAAM,4BAA4B,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAChF,CAAC;QACJ,CAAC;QAED,6EAA6E;QAC7E,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC;YACzB,SAAS,CAAC,kBAAkB;YAC5B,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI;YAC/B,UAAU,CAAC,MAAM,GAAG,IAAI;YACxB,IAAI,EAAE,cAAc;YACpB,GAAG,UAAU;YACb,SAAS,CAAC,YAAY;SACvB,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACjC,GAAG;YACH,YAAY,EAAE,SAAS,CAAC,WAAW;YACnC,OAAO,EAAO,IAAI,CAAC,KAAK,CAAC,OAAO;SACjC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,IAAY;QAC3C,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAEjC,2DAA2D;QAC3D,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACjD,GAAG,EAAE;gBACH,SAAS,CAAC,kBAAkB;gBAC5B,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI;gBAClB,IAAI,GAAG,IAAI;gBACX,IAAI,EAAE,cAAc;aACrB;YACD,cAAc,EAAE,IAAI,GAAG,CAAC;YACxB,OAAO,EAAS,IAAI,CAAC,KAAK,CAAC,OAAO;SACnC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,6EAA6E;IAE7E;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,MAAwC;QACzD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACjD,GAAG,EAAa,CAAC,SAAS,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAAC;YACzD,cAAc,EAAE,CAAC,EAAE,+BAA+B;YAClD,OAAO,EAAS,IAAI,CAAC,KAAK,CAAC,OAAO;SACnC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAI,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAI,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,UAAU,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvI,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS,CAAC,IAAqC,EAAE,GAAW;QAChE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,IAAI,MAAM,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAqD;YAC7D,GAAG,EAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC;YAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC;YAC7B,GAAG,EAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC;YAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC;SAC9B,CAAC;QACF,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,CAAC;QACrC,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB;IACtC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,IAAgB;QACtD,oDAAoD;QACpD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC3E,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAEpC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC;YACzB,SAAS,CAAC,kBAAkB;YAC5B,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI;YACzB,IAAI,CAAC,MAAM,GAAG,IAAI;YAClB,IAAI,EAAE,eAAe;YACrB,GAAG,IAAI;YACP,SAAS,CAAC,YAAY;SACvB,CAAC,CAAC;QAEH,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YAChC,GAAG;YACH,YAAY,EAAE,SAAS,CAAC,WAAW;YACnC,OAAO,EAAO,IAAI,CAAC,KAAK,CAAC,OAAO;SACjC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,IAAY;QACjD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC3E,MAAM,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAEpC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE;YACjD,GAAG,EAAE;gBACH,SAAS,CAAC,kBAAkB;gBAC5B,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI;gBAClB,IAAI,GAAG,IAAI;gBACX,IAAI,EAAE,eAAe;aACtB;YACD,cAAc,EAAE,IAAI,GAAG,CAAC;YACxB,OAAO,EAAS,IAAI,CAAC,KAAK,CAAC,OAAO;SACnC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,MAAM,CACV,OAA4B,EAC5B,gBAA+C;QAE/C,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QACxC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,SAAS,iBAAiB,CAAC,CAAC;QAExD,+BAA+B;QAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YAC7D,MAAM,IAAI,qBAAqB,CAC7B,kBAAkB,SAAS,6BAA6B,IAAI,CAAC,KAAK,CAAC,SAAS,QAAQ,CACrF,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,OAAO,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAK,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;YACzE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;YACvE,MAAM,KAAK,GAAO,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;YAE/D,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAChC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAE3B,QAAQ,IAAI,SAAS,CAAC;YACtB,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,gDAAgD;YAChE,gBAAgB,EAAE,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACtC,CAAC;IAED,6EAA6E;IAE7E;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CACV,OAA4B,EAC5B,gBAA+C;QAE/C,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QACxC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,SAAS,QAAQ,CAAC,CAAC;QAExD,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,OAAO,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAK,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;YACzE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;YACvE,MAAM,QAAQ,GAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;YAE/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAEvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC9B,MAAM,IAAI,iBAAiB,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC;YAED,QAAQ,IAAI,SAAS,CAAC;YACtB,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;YACf,gBAAgB,EAAE,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,+BAA+B,CAAC,CAAC;IACpD,CAAC;IAED,6EAA6E;IAE7E;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CACZ,OAA4B,EAC5B,gBAA2C;QAE3C,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,GAAW,EAAQ,EAAE;YACrD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpD,gBAAgB,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC,CAAC;QAEF,+CAA+C;QAC/C,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;QAChC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,gEAAgE;QAChE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACvB,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,8BAA8B;QAElD,kDAAkD;QAClD,QAAQ,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAE7B,8BAA8B;QAC9B,QAAQ,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAExB,8BAA8B;QAC9B,QAAQ,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;QAC1C,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAElC,kCAAkC;QAClC,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC7B,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAEvB,iCAAiC;QACjC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACjC,QAAQ,CAAC,WAAW,EAAE,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,uCAAuC;QACvC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACjC,QAAQ,CAAC,WAAW,EAAE,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,kEAAkE;QAClE,QAAQ,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAEjC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/transport/IPicobootTransport.d.ts

@@ -0,0 +1,25 @@
+export interface IPicobootTransport {
+    /**
+     * Send a 32-byte PICOBOOT command packet to the USB OUT endpoint.
+     * Must be called before any data phase.
+     */
+    sendCommand(cmd: Uint8Array): Promise<void>;
+    /**
+     * Read up to `maxLength` bytes from the USB IN endpoint.
+     * Used for both data reads (READ command) and status responses.
+     */
+    receiveBytes(maxLength: number): Promise<Uint8Array>;
+    /**
+     * Send raw bytes to the USB OUT endpoint.
+     * Used for the data phase of a WRITE command.
+     */
+    sendBytes(data: Uint8Array): Promise<void>;
+    /**
+     * Issue a USB control transfer to reset the PICOBOOT interface state machine.
+     * Should be called before the first command to ensure a clean state.
+     */
+    resetInterface(): Promise<void>;
+    /** Release the USB interface and close the device. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=IPicobootTransport.d.ts.map

package/dist/transport/IPicobootTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPicobootTransport.d.ts","sourceRoot":"","sources":["../../src/transport/IPicobootTransport.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAErD;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC,sDAAsD;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/transport/IPicobootTransport.js

@@ -0,0 +1,10 @@
+// USB transport abstraction for the PICOBOOT protocol (RP2040 / RP2350 BOOTSEL mode).
+//
+// PICOBOOT is a USB vendor-class bulk-transfer protocol exposed on interface 1
+// of the RP2040 when held in BOOTSEL mode (VID=0x2E8A, PID=0x0003).
+//
+// Implementations:
+//   NodeUSBTransport — Node.js, uses the 'usb' npm package (libusb)
+//   (future) WebUSBTransport — browser, once RP2350 advertises WebUSB BOS descriptor
+export {};
+//# sourceMappingURL=IPicobootTransport.js.map

package/dist/transport/IPicobootTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPicobootTransport.js","sourceRoot":"","sources":["../../src/transport/IPicobootTransport.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,EAAE;AACF,+EAA+E;AAC/E,oEAAoE;AACpE,EAAE;AACF,mBAAmB;AACnB,oEAAoE;AACpE,qFAAqF"}

package/dist/transport/ITransport.d.ts

@@ -0,0 +1,33 @@
+export interface SerialSignals {
+    dtr?: boolean;
+    rts?: boolean;
+}
+export interface ISTKTransport {
+    /** Send raw bytes to the device */
+    write(data: Uint8Array): Promise<void>;
+    /** Subscribe to incoming data chunks */
+    on(event: 'data', handler: (chunk: Uint8Array) => void): void;
+    /** Unsubscribe a data handler */
+    off(event: 'data', handler: (chunk: Uint8Array) => void): void;
+    /**
+     * Set hardware handshake signals.
+     * Optional — not all transports support it.
+     * Used to toggle DTR/RTS for Arduino bootloader entry.
+     */
+    setSignals?(opts: SerialSignals): Promise<void>;
+    /**
+     * Send a BREAK condition on the serial line.
+     * Required for UPDI protocol — used to reset the UPDI state machine.
+     *
+     * Implementations should hold TX low for ≥ 12 bit-times (e.g. by sending 0x00
+     * at 300 baud, which produces a ~33 ms BREAK period at 115200 operating speed).
+     * WebSerialTransport closes/reopens the port; NodeSerialTransport uses hardware
+     * SET{brk} if available, falling back to the low-baud approach.
+     *
+     * Optional — only required for UPDI.
+     */
+    sendBreak?(): Promise<void>;
+    /** Release all resources */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=ITransport.d.ts.map

package/dist/transport/ITransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITransport.d.ts","sourceRoot":"","sources":["../../src/transport/ITransport.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,wCAAwC;IACxC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAE9D,iCAAiC;IACjC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAE/D;;;;OAIG;IACH,UAAU,CAAC,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;;;;;OAUG;IACH,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,4BAA4B;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/transport/ITransport.js

@@ -0,0 +1,4 @@
+// Minimal transport interface that stk500 requires.
+// Decouples the protocol logic from any specific I/O backend (Node.js, WebSerial, mock).
+export {};
+//# sourceMappingURL=ITransport.js.map

package/dist/transport/ITransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITransport.js","sourceRoot":"","sources":["../../src/transport/ITransport.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,yFAAyF"}

package/dist/transport/NodeSerialTransport.d.ts

@@ -0,0 +1,35 @@
+import type { ISTKTransport, SerialSignals } from './ITransport.js';
+/**
+ * Minimal duck-type interface of the Node.js `serialport` SerialPort class.
+ * This avoids a hard dependency on the `serialport` package.
+ */
+export interface NodeSerialPortLike {
+    write(data: Buffer | Uint8Array | readonly number[], callback?: (err: Error | null | undefined) => void): boolean;
+    on(event: 'data', listener: (data: Buffer) => void): this;
+    removeListener(event: 'data', listener: (data: Buffer) => void): this;
+    set?(options: {
+        dtr?: boolean;
+        rts?: boolean;
+        brk?: boolean;
+    }, callback?: (err: Error | null | undefined) => void): void;
+    drain?(callback?: (err: Error | null | undefined) => void): void;
+    close?(callback?: (err: Error | null | undefined) => void): void;
+}
+export declare class NodeSerialTransport implements ISTKTransport {
+    private readonly port;
+    private readonly handlerMap;
+    constructor(port: NodeSerialPortLike);
+    write(data: Uint8Array): Promise<void>;
+    on(_event: 'data', handler: (chunk: Uint8Array) => void): void;
+    off(_event: 'data', handler: (chunk: Uint8Array) => void): void;
+    setSignals(opts: SerialSignals): Promise<void>;
+    /**
+     * Send a BREAK condition for UPDI.
+     *
+     * Uses hardware SET{brk} if the port supports it (serialport >= 10).
+     * Holds TX low for ~12 ms (≥ 12 bit-times at any supported baud rate).
+     */
+    sendBreak(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=NodeSerialTransport.d.ts.map

package/dist/transport/NodeSerialTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeSerialTransport.d.ts","sourceRoot":"","sources":["../../src/transport/NodeSerialTransport.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CACH,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,MAAM,EAAE,EAC7C,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,GACjD,OAAO,CAAC;IACX,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACtE,GAAG,CAAC,CACF,OAAO,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,EACxD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,GACjD,IAAI,CAAC;IACR,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,GAAG,IAAI,CAAC;CAClE;AAED,qBAAa,mBAAoB,YAAW,aAAa;IAO3C,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGvB;gBAEyB,IAAI,EAAE,kBAAkB;IAE/C,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5C,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAM9D,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAQzD,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAmB7B"}