@audiofab-io/fv1-core 0.1.0 → 0.2.2

package/dist/pedal/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const MCP2221_VENDOR_ID = 1240;
+export declare const MCP2221_PRODUCT_ID = 221;
+export declare const DEFAULT_EEPROM_I2C_ADDRESS = 80;
+export declare const DEFAULT_I2C_CLOCK_HZ = 400000;
+export declare const DEFAULT_WRITE_PAGE_SIZE = 32;
+export declare const PROGRAM_SLOT_COUNT = 8;
+export declare const PROGRAM_SLOT_SIZE_BYTES = 512;
+export declare const EEPROM_TOTAL_BYTES: number;
+export declare function slotBaseAddress(slot: number): number;
+//# sourceMappingURL=constants.d.ts.map

package/dist/pedal/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/pedal/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,OAAS,CAAA;AACvC,eAAO,MAAM,kBAAkB,MAAS,CAAA;AAExC,eAAO,MAAM,0BAA0B,KAAO,CAAA;AAC9C,eAAO,MAAM,oBAAoB,SAAU,CAAA;AAC3C,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAEzC,eAAO,MAAM,kBAAkB,IAAI,CAAA;AACnC,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAC1C,eAAO,MAAM,kBAAkB,QAA+C,CAAA;AAE9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/pedal/constants.js

@@ -0,0 +1,17 @@
+// Audiofab pedal (MCP2221 + 24LC32 EEPROM) constants.
+// The FV-1 reads 8 programs of 128 × 32-bit words each from the EEPROM.
+export const MCP2221_VENDOR_ID = 0x04D8;
+export const MCP2221_PRODUCT_ID = 0x00DD;
+export const DEFAULT_EEPROM_I2C_ADDRESS = 0x50;
+export const DEFAULT_I2C_CLOCK_HZ = 400000;
+export const DEFAULT_WRITE_PAGE_SIZE = 32;
+export const PROGRAM_SLOT_COUNT = 8;
+export const PROGRAM_SLOT_SIZE_BYTES = 512;
+export const EEPROM_TOTAL_BYTES = PROGRAM_SLOT_COUNT * PROGRAM_SLOT_SIZE_BYTES;
+export function slotBaseAddress(slot) {
+    if (slot < 0 || slot >= PROGRAM_SLOT_COUNT) {
+        throw new RangeError(`Slot ${slot} out of range [0, ${PROGRAM_SLOT_COUNT})`);
+    }
+    return slot * PROGRAM_SLOT_SIZE_BYTES;
+}
+//# sourceMappingURL=constants.js.map

package/dist/pedal/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/pedal/constants.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,wEAAwE;AAExE,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAA;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAA;AAExC,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAA;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAO,CAAA;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAA;AAEzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAA;AACnC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAA;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,GAAG,uBAAuB,CAAA;AAE9E,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,kBAAkB,EAAE,CAAC;QAC3C,MAAM,IAAI,UAAU,CAAC,QAAQ,IAAI,qBAAqB,kBAAkB,GAAG,CAAC,CAAA;IAC9E,CAAC;IACD,OAAO,IAAI,GAAG,uBAAuB,CAAA;AACvC,CAAC"}

package/dist/pedal/hash.d.ts

@@ -0,0 +1,6 @@
+export declare function hashProgram(binary: Uint8Array): Promise<string>;
+/**
+ * True if the slot is unprogrammed — i.e. every byte is 0xFF (blank EEPROM).
+ */
+export declare function isBlankSlot(binary: Uint8Array): boolean;
+//# sourceMappingURL=hash.d.ts.map

package/dist/pedal/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/pedal/hash.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAOrE;AAUD;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAKvD"}

package/dist/pedal/hash.js

@@ -0,0 +1,28 @@
+// SHA-256 helpers for matching an EEPROM slot's contents against a known program.
+// Works in modern browsers (crypto.subtle) and Node 20+ (globalThis.crypto.subtle).
+export async function hashProgram(binary) {
+    // Copy into a fresh, ArrayBuffer-backed view so the type satisfies
+    // `BufferSource` on every TS/DOM-lib combo.
+    const copy = new Uint8Array(binary.byteLength);
+    copy.set(binary);
+    const digest = await globalThis.crypto.subtle.digest('SHA-256', copy);
+    return bytesToHex(new Uint8Array(digest));
+}
+function bytesToHex(bytes) {
+    let out = '';
+    for (let i = 0; i < bytes.length; i++) {
+        out += bytes[i].toString(16).padStart(2, '0');
+    }
+    return out;
+}
+/**
+ * True if the slot is unprogrammed — i.e. every byte is 0xFF (blank EEPROM).
+ */
+export function isBlankSlot(binary) {
+    for (let i = 0; i < binary.length; i++) {
+        if (binary[i] !== 0xFF)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=hash.js.map

package/dist/pedal/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/pedal/hash.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,oFAAoF;AAEpF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAkB;IAClD,mEAAmE;IACnE,4CAA4C;IAC5C,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAC9C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAChB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IACrE,OAAO,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC/C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAkB;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAA;IACtC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/pedal/index.d.ts

@@ -0,0 +1,6 @@
+export { MCP2221_VENDOR_ID, MCP2221_PRODUCT_ID, DEFAULT_EEPROM_I2C_ADDRESS, DEFAULT_I2C_CLOCK_HZ, DEFAULT_WRITE_PAGE_SIZE, EEPROM_TOTAL_BYTES, PROGRAM_SLOT_COUNT, PROGRAM_SLOT_SIZE_BYTES, slotBaseAddress, } from './constants.js';
+export { hashProgram, isBlankSlot } from './hash.js';
+export { PedalClient } from './pedal-client.js';
+export type { PedalClientOptions } from './pedal-client.js';
+export { createWebHidBinding } from './webhid-transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pedal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pedal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,GAChB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/pedal/index.js

@@ -0,0 +1,5 @@
+export { MCP2221_VENDOR_ID, MCP2221_PRODUCT_ID, DEFAULT_EEPROM_I2C_ADDRESS, DEFAULT_I2C_CLOCK_HZ, DEFAULT_WRITE_PAGE_SIZE, EEPROM_TOTAL_BYTES, PROGRAM_SLOT_COUNT, PROGRAM_SLOT_SIZE_BYTES, slotBaseAddress, } from './constants.js';
+export { hashProgram, isBlankSlot } from './hash.js';
+export { PedalClient } from './pedal-client.js';
+export { createWebHidBinding } from './webhid-transport.js';
+//# sourceMappingURL=index.js.map

package/dist/pedal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pedal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,GAChB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/pedal/pedal-client.d.ts

@@ -0,0 +1,44 @@
+import { MCP2221 } from '@johntalton/mcp2221';
+import { EEPROM } from '@johntalton/eeprom';
+type BindingBufferSource = ArrayBufferLike | ArrayBufferView;
+export interface PedalClientOptions {
+    /** EEPROM I²C address. Defaults to 0x50 (standard 24LC32). */
+    i2cAddress?: number;
+    /** I²C clock speed in Hz. Defaults to 400 kHz. */
+    i2cClockHz?: number;
+    /** EEPROM write page size in bytes. Defaults to 32. */
+    writePageSize?: number;
+}
+export declare class PedalClient {
+    readonly device: MCP2221;
+    readonly eeprom: EEPROM;
+    private readonly i2cAddress;
+    private readonly writePageSize;
+    private constructor();
+    /**
+     * Open a pedal connection using a pre-built HID stream binding.
+     * For browsers, build one with `createWebHidBinding(hidDevice)`.
+     */
+    static open(binding: ReadableWritablePair<BindingBufferSource, BindingBufferSource>, options?: PedalClientOptions): Promise<PedalClient>;
+    /** Read one program slot (512 bytes) from EEPROM. */
+    readSlot(slot: number): Promise<Uint8Array>;
+    /** Read the entire EEPROM (all 8 slots) in one sweep. */
+    readAllSlots(): Promise<Uint8Array[]>;
+    /** Write one program slot (512 bytes) to EEPROM and verify the write. */
+    writeSlot(slot: number, data: Uint8Array): Promise<void>;
+    /**
+     * Issue a single EEPROM page write (address prefix + data) and then wait
+     * for the MCP2221 I²C state machine to return to IDLE. Handles the 24LC32
+     * internal write cycle (~5 ms) by retrying if the chip NACKs the address.
+     */
+    private writePageWithPolling;
+    /**
+     * Poll MCP2221 status until the I²C state is IDLE or a terminal error
+     * state. Returns the final state name.
+     */
+    private waitForIdle;
+    /** Force the I²C state machine to IDLE, cancelling any stuck transaction. */
+    private ensureIdle;
+}
+export {};
+//# sourceMappingURL=pedal-client.d.ts.map

package/dist/pedal/pedal-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pedal-client.d.ts","sourceRoot":"","sources":["../../src/pedal/pedal-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAG7C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAY3C,KAAK,mBAAmB,GAAG,eAAe,GAAG,eAAe,CAAA;AAE5D,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAID,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IAEtC,OAAO;IAOP;;;OAGG;WACU,IAAI,CACf,OAAO,EAAE,oBAAoB,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,EACvE,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC;IAkBvB,qDAAqD;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMjD,yDAAyD;IACnD,YAAY,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAU3C,yEAAyE;IACnE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC9D;;;;OAIG;YACW,oBAAoB;IA8BlC;;;OAGG;YACW,WAAW;IAazB,6EAA6E;YAC/D,UAAU;CAMzB"}

package/dist/pedal/pedal-client.js

@@ -0,0 +1,137 @@
+// High-level pedal API built on the @johntalton/* I2C / MCP2221 / EEPROM stack.
+// Consumers pass in a ReadableWritablePair binding — use `createWebHidBinding`
+// from './webhid-transport' in the browser, or any node-hid bridge on Node.
+import { MCP2221 } from '@johntalton/mcp2221';
+import { I2CBusMCP2221 } from '@johntalton/i2c-bus-mcp2221';
+import { I2CAddressedBus } from '@johntalton/and-other-delights';
+import { EEPROM } from '@johntalton/eeprom';
+import { DEFAULT_EEPROM_I2C_ADDRESS, DEFAULT_I2C_CLOCK_HZ, DEFAULT_WRITE_PAGE_SIZE, EEPROM_TOTAL_BYTES, PROGRAM_SLOT_COUNT, PROGRAM_SLOT_SIZE_BYTES, slotBaseAddress, } from './constants.js';
+const delayMs = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+export class PedalClient {
+    constructor(device, eeprom, i2cAddress, writePageSize) {
+        this.device = device;
+        this.eeprom = eeprom;
+        this.i2cAddress = i2cAddress;
+        this.writePageSize = writePageSize;
+    }
+    /**
+     * Open a pedal connection using a pre-built HID stream binding.
+     * For browsers, build one with `createWebHidBinding(hidDevice)`.
+     */
+    static async open(binding, options = {}) {
+        const { i2cAddress = DEFAULT_EEPROM_I2C_ADDRESS, i2cClockHz = DEFAULT_I2C_CLOCK_HZ, writePageSize = DEFAULT_WRITE_PAGE_SIZE, } = options;
+        const device = MCP2221.from(binding);
+        await device.common.status({
+            opaque: `fv1-core::i2c-speed-${i2cClockHz}`,
+            i2cClock: i2cClockHz,
+        });
+        const bus = I2CBusMCP2221.from(device);
+        const abus = new I2CAddressedBus(bus, i2cAddress);
+        const eeprom = new EEPROM(abus, { writePageSize });
+        return new PedalClient(device, eeprom, i2cAddress, writePageSize);
+    }
+    /** Read one program slot (512 bytes) from EEPROM. */
+    async readSlot(slot) {
+        const address = slotBaseAddress(slot);
+        const buffer = await this.eeprom.read(address, PROGRAM_SLOT_SIZE_BYTES);
+        return new Uint8Array(buffer);
+    }
+    /** Read the entire EEPROM (all 8 slots) in one sweep. */
+    async readAllSlots() {
+        const buffer = await this.eeprom.read(0, EEPROM_TOTAL_BYTES);
+        const all = new Uint8Array(buffer);
+        const slots = [];
+        for (let i = 0; i < PROGRAM_SLOT_COUNT; i++) {
+            slots.push(all.slice(i * PROGRAM_SLOT_SIZE_BYTES, (i + 1) * PROGRAM_SLOT_SIZE_BYTES));
+        }
+        return slots;
+    }
+    /** Write one program slot (512 bytes) to EEPROM and verify the write. */
+    async writeSlot(slot, data) {
+        if (data.length !== PROGRAM_SLOT_SIZE_BYTES) {
+            throw new Error(`writeSlot expects ${PROGRAM_SLOT_SIZE_BYTES} bytes, got ${data.length}`);
+        }
+        const baseAddress = slotBaseAddress(slot);
+        // Page-by-page write that bypasses @johntalton/i2c-bus-mcp2221's checkWrite.
+        // The library polls MCP2221 status immediately after each writeData and
+        // throws if the I²C state machine isn't in a terminal state, which races
+        // against the in-flight transaction. We drive writeData directly and then
+        // poll for IDLE before moving on.
+        for (let offset = 0; offset < data.length;) {
+            const pageAddr = baseAddress + offset;
+            const nextBoundary = Math.floor((pageAddr + this.writePageSize) / this.writePageSize) * this.writePageSize;
+            const chunkLen = Math.min(nextBoundary - pageAddr, data.length - offset);
+            const pageData = data.subarray(offset, offset + chunkLen);
+            const buffer = new Uint8Array(2 + chunkLen);
+            buffer[0] = (pageAddr >> 8) & 0xFF;
+            buffer[1] = pageAddr & 0xFF;
+            buffer.set(pageData, 2);
+            await this.writePageWithPolling(buffer, `writeSlot::${slot}::${offset}`);
+            offset += chunkLen;
+        }
+        const verifyBuffer = await this.eeprom.read(baseAddress, PROGRAM_SLOT_SIZE_BYTES);
+        const verify = new Uint8Array(verifyBuffer);
+        for (let i = 0; i < data.length; i++) {
+            if (data[i] !== verify[i]) {
+                throw new Error(`Slot ${slot} verification failed at byte ${i}`);
+            }
+        }
+    }
+    /**
+     * Issue a single EEPROM page write (address prefix + data) and then wait
+     * for the MCP2221 I²C state machine to return to IDLE. Handles the 24LC32
+     * internal write cycle (~5 ms) by retrying if the chip NACKs the address.
+     */
+    async writePageWithPolling(buffer, opaque) {
+        // Make sure the state machine is clean before we start. If a prior op
+        // left it non-idle (e.g., a racy status poll), cancel and give it a beat.
+        await this.ensureIdle(`${opaque}::pre`);
+        // Retry the whole page up to a few times in case the EEPROM is still in
+        // its internal write cycle from a previous page and NACKs the address.
+        const MAX_ATTEMPTS = 20;
+        for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+            await this.device.i2c.writeData({
+                opaque: `${opaque}::writeData::${attempt}`,
+                address: this.i2cAddress,
+                buffer,
+            });
+            const state = await this.waitForIdle(`${opaque}::poll::${attempt}`, 50);
+            if (state === 'IDLE')
+                return;
+            // Chip is in its internal write cycle; wait a bit and retry.
+            if (state === 'ADDRESS_NACK_STOP' || state === 'ADDRESS_NACK_STOP_END') {
+                await delayMs(2);
+                continue;
+            }
+            throw new Error(`EEPROM page write stuck at state ${state}`);
+        }
+        throw new Error(`EEPROM page write did not complete after ${MAX_ATTEMPTS} attempts`);
+    }
+    /**
+     * Poll MCP2221 status until the I²C state is IDLE or a terminal error
+     * state. Returns the final state name.
+     */
+    async waitForIdle(opaque, timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        let lastState = 'UNKNOWN';
+        while (Date.now() < deadline) {
+            const status = await this.device.common.status({ opaque });
+            lastState = status.i2cStateName ?? 'UNKNOWN';
+            if (status.i2cState === 0)
+                return 'IDLE';
+            if (lastState === 'ADDRESS_NACK_STOP' || lastState === 'ADDRESS_NACK_STOP_END')
+                return lastState;
+            await delayMs(1);
+        }
+        return lastState;
+    }
+    /** Force the I²C state machine to IDLE, cancelling any stuck transaction. */
+    async ensureIdle(opaque) {
+        const status = await this.device.common.status({ opaque });
+        if (status.i2cState === 0)
+            return;
+        await this.device.common.status({ opaque: `${opaque}::cancel`, cancelI2c: true });
+        await delayMs(10);
+    }
+}
+//# sourceMappingURL=pedal-client.js.map

package/dist/pedal/pedal-client.js.map

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

package/dist/pedal/webhid-transport.d.ts

@@ -0,0 +1,14 @@
+type BindingBufferSource = ArrayBufferLike | ArrayBufferView;
+interface HIDDeviceLike extends EventTarget {
+    opened: boolean;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    sendReport(reportId: number, data: BufferSource): Promise<void>;
+}
+/**
+ * Create a duplex stream binding for a WebHID MCP2221 device.
+ * The returned pair can be passed directly to `MCP2221.from(binding)`.
+ */
+export declare function createWebHidBinding(device: HIDDeviceLike): ReadableWritablePair<BindingBufferSource, BindingBufferSource>;
+export {};
+//# sourceMappingURL=webhid-transport.d.ts.map

package/dist/pedal/webhid-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhid-transport.d.ts","sourceRoot":"","sources":["../../src/pedal/webhid-transport.ts"],"names":[],"mappings":"AAOA,KAAK,mBAAmB,GAAG,eAAe,GAAG,eAAe,CAAA;AAO5D,UAAU,aAAc,SAAQ,WAAW;IACzC,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE;AAKD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,GACpB,oBAAoB,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAuDhE"}

package/dist/pedal/webhid-transport.js

@@ -0,0 +1,75 @@
+// Bridges a WebHID `HIDDevice` to a `ReadableWritablePair` so it can drive
+// `@johntalton/mcp2221`, which expects a generic stream binding.
+//
+// The MCP2221 uses 64-byte reports with report ID 0. Each outgoing write
+// is sent as a single report; each incoming `inputreport` event becomes one
+// 64-byte chunk in the readable side of the pair.
+const REPORT_ID = 0;
+const REPORT_SIZE = 64;
+/**
+ * Create a duplex stream binding for a WebHID MCP2221 device.
+ * The returned pair can be passed directly to `MCP2221.from(binding)`.
+ */
+export function createWebHidBinding(device) {
+    const queue = [];
+    const waiters = [];
+    const onInputReport = (event) => {
+        const ev = event;
+        const src = new Uint8Array(ev.data.buffer, ev.data.byteOffset, ev.data.byteLength);
+        // Copy into a fresh, full-size (64-byte) buffer so downstream consumers
+        // always see a stable chunk size regardless of how the browser packages it.
+        const chunk = new Uint8Array(REPORT_SIZE);
+        chunk.set(src.subarray(0, Math.min(src.length, REPORT_SIZE)));
+        const waiter = waiters.shift();
+        if (waiter)
+            waiter(chunk);
+        else
+            queue.push(chunk);
+    };
+    device.addEventListener('inputreport', onInputReport);
+    const readable = new ReadableStream({
+        type: 'bytes',
+        pull(controller) {
+            const byob = controller;
+            if (queue.length > 0) {
+                byob.enqueue(queue.shift());
+                return;
+            }
+            return new Promise(resolve => {
+                waiters.push(chunk => {
+                    byob.enqueue(chunk);
+                    resolve();
+                });
+            });
+        },
+        cancel() {
+            device.removeEventListener('inputreport', onInputReport);
+        },
+    });
+    const writable = new WritableStream({
+        async write(chunk) {
+            const bytes = toBytes(chunk);
+            // MCP2221 always expects 64 bytes of payload. Always build a fresh,
+            // ArrayBuffer-backed view so it satisfies the DOM BufferSource type.
+            const padded = new Uint8Array(REPORT_SIZE);
+            padded.set(bytes.subarray(0, Math.min(bytes.length, REPORT_SIZE)));
+            await device.sendReport(REPORT_ID, padded);
+        },
+        close() {
+            device.removeEventListener('inputreport', onInputReport);
+        },
+        abort() {
+            device.removeEventListener('inputreport', onInputReport);
+        },
+    });
+    return { readable, writable };
+}
+function toBytes(chunk) {
+    if (chunk instanceof Uint8Array)
+        return chunk;
+    if (ArrayBuffer.isView(chunk)) {
+        return new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength);
+    }
+    return new Uint8Array(chunk);
+}
+//# sourceMappingURL=webhid-transport.js.map

package/dist/pedal/webhid-transport.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@audiofab-io/fv1-core",
-  "version": "0.1.0",
+  "version": "0.2.2",
   "description": "FV-1 DSP toolchain: assembler, simulator, and Intel HEX parser",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,6 +9,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./pedal": {
+      "import": "./dist/pedal/index.js",
+      "types": "./dist/pedal/index.d.ts"
     }
   },
   "files": [
@@ -19,6 +23,12 @@
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run build"
   },
+  "dependencies": {
+    "@johntalton/and-other-delights": "^8.6.4",
+    "@johntalton/eeprom": "^1.1.1",
+    "@johntalton/i2c-bus-mcp2221": "^4.2.1",
+    "@johntalton/mcp2221": "^4.0.4"
+  },
   "devDependencies": {
     "typescript": "^5.7.0"
   },