exquis-midi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Manuel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,181 @@
+# exquis-midi
+
+Full control of the [Intuitive Instruments **Exquis**](https://dualo.com/en/exquis/) — the
+hexagonal, MPE, RGB-lit MIDI controller — from TypeScript, in **Node and the browser**, over the
+device's official Developer Mode MIDI API. No custom firmware.
+
+- 🎛 **Full device control** — LEDs (batched, diffed), pads, encoders, buttons, slider, palette,
+  tempo, scales, snapshots.
+- 🧩 **Typed everything** — a semantic `EventEmitter` (`padPress`, `encoder`, `button`, …) and typed
+  SysEx encoders/decoder.
+- 🌈 **LED engine** — 7-bit colour with HSV/hex helpers, effects, and a frame buffer that coalesces
+  changes into the fewest possible `cmd 04` writes (one SysEx for a whole-board repaint).
+- 🎼 **Microtonal** — EDO & Scala (`.scl`/`.kbm`) tunings, isomorphic hex layouts (Exquis / Harmonic
+  Table / Jankó, incl. Lumatone EDO presets), and MPE / MTS emitters to play any tuning through a synth.
+- 🔌 **One API, two backends** — [`@julusian/midi`](https://www.npmjs.com/package/@julusian/midi) on
+  Node (optional), native Web MIDI in the browser.
+
+> The Exquis is 12-EDO internally, so genuine microtonality happens **host-side**: this library retunes
+> and emits MPE (or MTS) to a downstream synth.
+
+## Install
+
+```sh
+npm install exquis-midi
+# Node only: also install the MIDI backend (optional peer dependency)
+npm install @julusian/midi
+```
+
+The browser build uses the native Web MIDI API and needs no extra dependency.
+
+## Quick start — Node
+
+```ts
+import { Exquis, hsv } from 'exquis-midi';
+
+const exq = await Exquis.connect({ zones: ['pads', 'encoders'] }); // enters dev mode
+
+// light a pad on press (buffered + diffed → one cmd 04)
+exq.on('padPress', (e) => exq.leds.set(e.pad, hsv(e.pad / 61, 1, 1)));
+exq.on('encoder', (e) => console.log(`encoder ${e.index} ${e.delta > 0 ? '+' : ''}${e.delta}`));
+
+// …later
+await exq.disconnect(); // clears LEDs, exits dev mode, closes ports
+```
+
+## Quick start — Browser
+
+```ts
+import { Exquis } from 'exquis-midi';
+
+// requires a user gesture + Web MIDI (Chrome/Edge) with sysex permission
+const exq = await Exquis.connect();
+exq.on('padPress', (e) => exq.leds.set(e.pad, { r: 127, g: 0, b: 0 }));
+```
+
+## LEDs
+
+```ts
+exq.leds.set(pad, hsv(0.6, 1, 1)); // one pad
+exq.leds.setMany([
+  [0, RED],
+  [1, GREEN],
+]); // several
+exq.leds.all(BLACK); // every pad
+exq.leds.effect(pad, Fx.pulsateWhite()); // alpha / blendWhite / pulsate*
+exq.leds.palette.set(3, rgb(10, 20, 30)); // 128-entry palette (CC colouring)
+exq.leds.flush(); // auto-flushes on the next microtask, or force it
+```
+
+Colours are **7-bit** (`0..127`). Use `rgb`, `rgb255` (scales 8-bit), `hsv`, `hex`, `lerp`.
+
+## Events
+
+`padPress` · `padRelease` · `pressure` · `bend` · `controlChange` · `encoder` · `button` · `slider`
+· `noteOn` · `noteOff` · `tempo` · `rootNote` · `scale` · `refresh` · `sysex` · `message` ·
+`connect` · `disconnect`.
+
+Dev mode reports pads as ids `0..60` on channel 16 (no per-note expression); `mode: 'mpe'` leaves the
+device native for full MPE expression (velocity, pressure, pitch-bend, CC 74).
+
+## Microtonal
+
+```ts
+import {
+  Exquis,
+  Layouts,
+  LayoutPlayer,
+  MpeEmitter,
+  EqualTemperament,
+  ScaleTuning,
+} from 'exquis-midi';
+
+const exq = await Exquis.connect({ zones: ['pads'] });
+
+// pick a tuning + isomorphic layout
+const layout = Layouts.jankoEDO(31); // 31-EDO Jankó (Lumatone dilation)
+// or: Layouts.exquisDefault(EqualTemperament.edo(19))
+// or: Layouts.fromGenerators({ right: 1, upRight: 6 }, ScaleTuning.fromScl(sclText))
+
+// play it through any MPE synth output
+const mpe = new MpeEmitter((bytes) => synthOut.send(bytes), { bendRangeSemitones: 48 });
+mpe.configure();
+new LayoutPlayer(exq, layout, mpe).start(); // colours the scale + routes presses
+```
+
+Importing Scala files:
+
+```ts
+import { ScaleTuning, parseKbm, scaleFromSclBlob } from 'exquis-midi';
+const tuning = ScaleTuning.fromScl(sclText); // from a string
+const tuning2 = await scaleFromSclBlob(fileInput.files[0]); // from a browser File / Blob
+
+import { loadSclFile } from 'exquis-midi'; // Node file path
+const tuning3 = await loadSclFile('./scales/young.scl');
+```
+
+## Hex grid
+
+```ts
+import { rowCol, neighbors, bfsDist, ring } from 'exquis-midi';
+rowCol(60); // { row: 10, col: 5 }
+neighbors(27); // adjacent pad ids
+bfsDist(0); // hex hop-count from pad 0 to every pad (ripples, layouts)
+```
+
+## Examples
+
+```sh
+npm run example:web                    # interactive playground (Chrome/Edge)
+npx tsx examples/node/monitor.ts       # watch what the device sends (with audio feedback)
+npx tsx examples/node/microtonal.ts    # microtonal MIDI source → your synth/VST
+npx tsx examples/node/ripple.ts        # hex-grid ripple
+```
+
+The **web playground** (`examples/web`) has a device console, generative visuals, a microtonal player
+with a built-in Web Audio synth, and an isomorphic layout/tuning designer with `.scl` export — all
+usable without hardware (click the on-screen pads).
+
+### Microtonal → your synth/VST
+
+`examples/node/microtonal.ts` is a pure MIDI source — no built-in synth. By default it opens a virtual
+MIDI port **`exquis-midi`**; select it as input in your synth/DAW. Live controls: encoder 1 = transpose
+± step, Up/Down = transpose ± octave.
+
+```sh
+npx tsx examples/node/microtonal.ts --edo 31 --family janko   # tuning + isomorphic layout
+npx tsx examples/node/microtonal.ts --edo 12 --scale major    # lock to a scale (12-EDO only)
+npx tsx examples/node/microtonal.ts --out IAC                 # send to an existing port instead
+npx tsx examples/node/microtonal.ts --log-midi                # also print every message sent
+```
+
+**Microtonal polyphony needs a compatible mode** — plain MIDI is 12-EDO only, so the retuning rides on
+pitch bend (MPE) or a tuning message (MTS). Pick what your synth supports:
+
+| Mode          | Flag     | Requirement                                       | Polyphonic |
+| ------------- | -------- | ------------------------------------------------- | ---------- |
+| MPE (default) | —        | synth in MPE mode, pitch-bend range 48 (Surge XT) | ✅         |
+| MTS           | `--mts`  | synth reads MIDI-SysEx tuning (e.g. Pianoteq)     | ✅         |
+| mono + bend   | `--mono` | any synth (ch1 + pitch bend; set its range to 2)  | one note   |
+
+```sh
+npx tsx examples/node/microtonal.ts           # MPE — recommended (Surge XT: enable MPE, range 48)
+npx tsx examples/node/microtonal.ts --mono    # any synth, one note at a time (bend range 2)
+```
+
+Note: Surge XT retunes via **MPE** or MTS-ESP, not MIDI-SysEx tuning — use the default MPE mode for it.
+
+To watch the **device's own** output instead, use `examples/node/monitor.ts` or the web playground's
+Device console. On macOS, MIDI Monitor (snoize.com) shows every message on the `exquis-midi` port.
+
+## Protocol
+
+Built on the new-dialect Developer Mode SysEx frame `F0 00 21 7E 7F <cmd> … F7` (firmware 2.x/3.x).
+The official **Developer Mode MIDI specification** and 3D models are on the
+[Exquis Resources page](https://dualo.com/en/exquis-resources/); the microtonal layout math follows
+the _Microtonal Layouts for the Exquis_ document. (Those PDFs aren't redistributed here — grab them
+from the source and drop them in `docs/`.)
+
+## License
+
+MIT

package/dist/NodeMidiTransport-L7VRGYJ2.js

@@ -0,0 +1,4 @@
+export { openNodeOutput, openNodeTransport, openNodeVirtualOutput } from './chunk-7W2FT4RZ.js';
+import './chunk-C3YWUWRH.js';
+//# sourceMappingURL=NodeMidiTransport-L7VRGYJ2.js.map
+//# sourceMappingURL=NodeMidiTransport-L7VRGYJ2.js.map

package/dist/NodeMidiTransport-L7VRGYJ2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"NodeMidiTransport-L7VRGYJ2.js"}

package/dist/WebMidiTransport-RAUJGW6C.js

@@ -0,0 +1,4 @@
+export { openWebOutput, openWebTransport } from './chunk-BR4TVV2R.js';
+import './chunk-C3YWUWRH.js';
+//# sourceMappingURL=WebMidiTransport-RAUJGW6C.js.map
+//# sourceMappingURL=WebMidiTransport-RAUJGW6C.js.map

package/dist/WebMidiTransport-RAUJGW6C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"WebMidiTransport-RAUJGW6C.js"}

package/dist/chunk-7W2FT4RZ.js

@@ -0,0 +1,66 @@
+import { matchesPort } from './chunk-C3YWUWRH.js';
+
+// src/transport/NodeMidiTransport.ts
+async function loadMidi() {
+  try {
+    const mod = await import('@julusian/midi');
+    return mod.Input ? mod : mod.default;
+  } catch {
+    throw new Error(
+      "The '@julusian/midi' package is required for the Node MIDI backend. Install it with `npm i @julusian/midi`."
+    );
+  }
+}
+function findPort(port, match) {
+  for (let i = 0; i < port.getPortCount(); i++) {
+    if (matchesPort(port.getPortName(i), match)) return i;
+  }
+  return -1;
+}
+async function openNodeTransport(match = /exquis/i) {
+  const midi = await loadMidi();
+  const input = new midi.Input();
+  const output = new midi.Output();
+  const inIdx = findPort(input, match);
+  const outIdx = findPort(output, match);
+  if (inIdx < 0 || outIdx < 0) {
+    input.closePort?.();
+    output.closePort?.();
+    throw new Error(`No MIDI port matching ${String(match)} found (need both input and output).`);
+  }
+  input.ignoreTypes(false, true, true);
+  output.openPort(outIdx);
+  input.openPort(inIdx);
+  return {
+    send: (bytes) => output.sendMessage(bytes),
+    onMessage: (cb) => input.on("message", (_dt, message) => cb(message)),
+    close: async () => {
+      input.closePort();
+      output.closePort();
+    }
+  };
+}
+async function openNodeVirtualOutput(name = "exquis-midi") {
+  const midi = await loadMidi();
+  const output = new midi.Output();
+  output.openVirtualPort(name);
+  return {
+    send: (bytes) => output.sendMessage(bytes),
+    close: async () => output.closePort()
+  };
+}
+async function openNodeOutput(match) {
+  const midi = await loadMidi();
+  const output = new midi.Output();
+  const idx = findPort(output, match);
+  if (idx < 0) throw new Error(`No MIDI output matching ${String(match)} found.`);
+  output.openPort(idx);
+  return {
+    send: (bytes) => output.sendMessage(bytes),
+    close: async () => output.closePort()
+  };
+}
+
+export { openNodeOutput, openNodeTransport, openNodeVirtualOutput };
+//# sourceMappingURL=chunk-7W2FT4RZ.js.map
+//# sourceMappingURL=chunk-7W2FT4RZ.js.map

package/dist/chunk-7W2FT4RZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/NodeMidiTransport.ts"],"names":[],"mappings":"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","file":"chunk-7W2FT4RZ.js","sourcesContent":["import { matchesPort, type Transport, type Output } from './Transport';\n\n// Minimal shape of the `@julusian/midi` module we rely on (avoids a hard type dep).\ninterface JzMidiPort {\n  getPortCount(): number;\n  getPortName(i: number): string;\n  openPort(i: number): void;\n  closePort(): void;\n}\ninterface JzInput extends JzMidiPort {\n  on(event: 'message', cb: (deltaTime: number, message: number[]) => void): void;\n  ignoreTypes(sysex: boolean, timing: boolean, activeSensing: boolean): void;\n}\ninterface JzOutput extends JzMidiPort {\n  sendMessage(bytes: number[]): void;\n  openVirtualPort(name: string): void;\n}\ninterface JzMidiModule {\n  Input: new () => JzInput;\n  Output: new () => JzOutput;\n}\n\nasync function loadMidi(): Promise<JzMidiModule> {\n  try {\n    // Lazy, so browser bundles never resolve the native addon.\n    const mod = (await import('@julusian/midi')) as unknown as JzMidiModule & {\n      default?: JzMidiModule;\n    };\n    return mod.Input ? mod : (mod.default as JzMidiModule);\n  } catch {\n    throw new Error(\n      \"The '@julusian/midi' package is required for the Node MIDI backend. Install it with `npm i @julusian/midi`.\",\n    );\n  }\n}\n\nfunction findPort(port: JzMidiPort, match: RegExp | string): number {\n  for (let i = 0; i < port.getPortCount(); i++) {\n    if (matchesPort(port.getPortName(i), match)) return i;\n  }\n  return -1;\n}\n\n/** Open a bidirectional Node transport to the first Exquis port. */\nexport async function openNodeTransport(match: RegExp | string = /exquis/i): Promise<Transport> {\n  const midi = await loadMidi();\n  const input = new midi.Input();\n  const output = new midi.Output();\n  const inIdx = findPort(input, match);\n  const outIdx = findPort(output, match);\n  if (inIdx < 0 || outIdx < 0) {\n    input.closePort?.();\n    output.closePort?.();\n    throw new Error(`No MIDI port matching ${String(match)} found (need both input and output).`);\n  }\n  input.ignoreTypes(false, true, true); // receive SysEx; drop clock + active-sensing\n  output.openPort(outIdx);\n  input.openPort(inIdx);\n  return {\n    send: (bytes) => output.sendMessage(bytes),\n    onMessage: (cb) => input.on('message', (_dt, message) => cb(message)),\n    close: async () => {\n      input.closePort();\n      output.closePort();\n    },\n  };\n}\n\n/**\n * Create a **virtual** Node MIDI output port (macOS/Linux). It appears as a MIDI source\n * named `name` that any DAW, synth, or MIDI monitor can subscribe to — handy for testing\n * what the library actually sends.\n */\nexport async function openNodeVirtualOutput(name = 'exquis-midi'): Promise<Output> {\n  const midi = await loadMidi();\n  const output = new midi.Output();\n  output.openVirtualPort(name);\n  return {\n    send: (bytes) => output.sendMessage(bytes),\n    close: async () => output.closePort(),\n  };\n}\n\n/** Open a one-way Node output (e.g. to a synth) to the first matching port. */\nexport async function openNodeOutput(match: RegExp | string): Promise<Output> {\n  const midi = await loadMidi();\n  const output = new midi.Output();\n  const idx = findPort(output, match);\n  if (idx < 0) throw new Error(`No MIDI output matching ${String(match)} found.`);\n  output.openPort(idx);\n  return {\n    send: (bytes) => output.sendMessage(bytes),\n    close: async () => output.closePort(),\n  };\n}\n"]}

package/dist/chunk-BR4TVV2R.js

@@ -0,0 +1,53 @@
+import { matchesPort } from './chunk-C3YWUWRH.js';
+
+// src/transport/WebMidiTransport.ts
+function findByName(ports, match) {
+  for (const p of ports) if (p.name && matchesPort(p.name, match)) return p;
+  return void 0;
+}
+async function access() {
+  if (typeof navigator === "undefined" || typeof navigator.requestMIDIAccess !== "function") {
+    throw new Error("Web MIDI is not available in this environment.");
+  }
+  return navigator.requestMIDIAccess({ sysex: true });
+}
+async function openWebTransport(match = /exquis/i) {
+  const midi = await access();
+  const input = findByName(midi.inputs.values(), match);
+  const output = findByName(midi.outputs.values(), match);
+  if (!input || !output) {
+    throw new Error(
+      `No Web MIDI port matching ${String(match)} found (need both input and output).`
+    );
+  }
+  let handler;
+  input.onmidimessage = (e) => {
+    if (e.data) handler?.(Array.from(e.data));
+  };
+  return {
+    send: (bytes) => output.send(bytes),
+    onMessage: (cb) => {
+      handler = cb;
+    },
+    close: async () => {
+      input.onmidimessage = null;
+      await input.close();
+      await output.close();
+    }
+  };
+}
+async function openWebOutput(match) {
+  const midi = await access();
+  const output = findByName(midi.outputs.values(), match);
+  if (!output) throw new Error(`No Web MIDI output matching ${String(match)} found.`);
+  return {
+    send: (bytes) => output.send(bytes),
+    close: async () => {
+      await output.close();
+    }
+  };
+}
+
+export { openWebOutput, openWebTransport };
+//# sourceMappingURL=chunk-BR4TVV2R.js.map
+//# sourceMappingURL=chunk-BR4TVV2R.js.map

package/dist/chunk-BR4TVV2R.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/WebMidiTransport.ts"],"names":[],"mappings":";;;AAEA,SAAS,UAAA,CACP,OACA,KAAA,EACe;AACf,EAAA,KAAA,MAAW,CAAA,IAAK,KAAA,EAAO,IAAI,CAAA,CAAE,IAAA,IAAQ,YAAY,CAAA,CAAE,IAAA,EAAM,KAAK,CAAA,EAAG,OAAO,CAAA;AACxE,EAAA,OAAO,MAAA;AACT;AAEA,eAAe,MAAA,GAA8B;AAC3C,EAAA,IAAI,OAAO,SAAA,KAAc,WAAA,IAAe,OAAO,SAAA,CAAU,sBAAsB,UAAA,EAAY;AACzF,IAAA,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAAA,EAClE;AACA,EAAA,OAAO,SAAA,CAAU,iBAAA,CAAkB,EAAE,KAAA,EAAO,MAAM,CAAA;AACpD;AAGA,eAAsB,gBAAA,CAAiB,QAAyB,SAAA,EAA+B;AAC7F,EAAA,MAAM,IAAA,GAAO,MAAM,MAAA,EAAO;AAC1B,EAAA,MAAM,QAAQ,UAAA,CAAW,IAAA,CAAK,MAAA,CAAO,MAAA,IAAU,KAAK,CAAA;AACpD,EAAA,MAAM,SAAS,UAAA,CAAW,IAAA,CAAK,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AACtD,EAAA,IAAI,CAAC,KAAA,IAAS,CAAC,MAAA,EAAQ;AACrB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,0BAAA,EAA6B,MAAA,CAAO,KAAK,CAAC,CAAA,oCAAA;AAAA,KAC5C;AAAA,EACF;AACA,EAAA,IAAI,OAAA;AACJ,EAAA,KAAA,CAAM,aAAA,GAAgB,CAAC,CAAA,KAAwB;AAC7C,IAAA,IAAI,EAAE,IAAA,EAAM,OAAA,GAAU,MAAM,IAAA,CAAK,CAAA,CAAE,IAAI,CAAC,CAAA;AAAA,EAC1C,CAAA;AACA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAC,KAAA,KAAU,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,IAClC,SAAA,EAAW,CAAC,EAAA,KAAO;AACjB,MAAA,OAAA,GAAU,EAAA;AAAA,IACZ,CAAA;AAAA,IACA,OAAO,YAAY;AACjB,MAAA,KAAA,CAAM,aAAA,GAAgB,IAAA;AACtB,MAAA,MAAM,MAAM,KAAA,EAAM;AAClB,MAAA,MAAM,OAAO,KAAA,EAAM;AAAA,IACrB;AAAA,GACF;AACF;AAGA,eAAsB,cAAc,KAAA,EAAyC;AAC3E,EAAA,MAAM,IAAA,GAAO,MAAM,MAAA,EAAO;AAC1B,EAAA,MAAM,SAAS,UAAA,CAAW,IAAA,CAAK,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AACtD,EAAA,IAAI,CAAC,QAAQ,MAAM,IAAI,MAAM,CAAA,4BAAA,EAA+B,MAAA,CAAO,KAAK,CAAC,CAAA,OAAA,CAAS,CAAA;AAClF,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAC,KAAA,KAAU,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,IAClC,OAAO,YAAY;AACjB,MAAA,MAAM,OAAO,KAAA,EAAM;AAAA,IACrB;AAAA,GACF;AACF","file":"chunk-BR4TVV2R.js","sourcesContent":["import { matchesPort, type Transport, type Output } from './Transport';\n\nfunction findByName<T extends { name: string | null }>(\n  ports: Iterable<T>,\n  match: RegExp | string,\n): T | undefined {\n  for (const p of ports) if (p.name && matchesPort(p.name, match)) return p;\n  return undefined;\n}\n\nasync function access(): Promise<MIDIAccess> {\n  if (typeof navigator === 'undefined' || typeof navigator.requestMIDIAccess !== 'function') {\n    throw new Error('Web MIDI is not available in this environment.');\n  }\n  return navigator.requestMIDIAccess({ sysex: true });\n}\n\n/** Open a bidirectional Web MIDI transport to the first Exquis port. */\nexport async function openWebTransport(match: RegExp | string = /exquis/i): Promise<Transport> {\n  const midi = await access();\n  const input = findByName(midi.inputs.values(), match);\n  const output = findByName(midi.outputs.values(), match);\n  if (!input || !output) {\n    throw new Error(\n      `No Web MIDI port matching ${String(match)} found (need both input and output).`,\n    );\n  }\n  let handler: ((bytes: number[]) => void) | undefined;\n  input.onmidimessage = (e: MIDIMessageEvent) => {\n    if (e.data) handler?.(Array.from(e.data));\n  };\n  return {\n    send: (bytes) => output.send(bytes),\n    onMessage: (cb) => {\n      handler = cb;\n    },\n    close: async () => {\n      input.onmidimessage = null;\n      await input.close();\n      await output.close();\n    },\n  };\n}\n\n/** Open a one-way Web MIDI output (e.g. to a synth) to the first matching port. */\nexport async function openWebOutput(match: RegExp | string): Promise<Output> {\n  const midi = await access();\n  const output = findByName(midi.outputs.values(), match);\n  if (!output) throw new Error(`No Web MIDI output matching ${String(match)} found.`);\n  return {\n    send: (bytes) => output.send(bytes),\n    close: async () => {\n      await output.close();\n    },\n  };\n}\n"]}

package/dist/chunk-C3YWUWRH.js

@@ -0,0 +1,7 @@
+// src/transport/Transport.ts
+var toTest = (match) => typeof match === "string" ? (name) => name.toLowerCase().includes(match.toLowerCase()) : (name) => match.test(name);
+var matchesPort = (name, match) => toTest(match)(name);
+
+export { matchesPort };
+//# sourceMappingURL=chunk-C3YWUWRH.js.map
+//# sourceMappingURL=chunk-C3YWUWRH.js.map

package/dist/chunk-C3YWUWRH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/Transport.ts"],"names":[],"mappings":";AAwBA,IAAM,MAAA,GAAS,CAAC,KAAA,KACd,OAAO,UAAU,QAAA,GACb,CAAC,SAAS,IAAA,CAAK,WAAA,GAAc,QAAA,CAAS,KAAA,CAAM,aAAa,CAAA,GACzD,CAAC,IAAA,KAAS,KAAA,CAAM,KAAK,IAAI,CAAA;AAGxB,IAAM,cAAc,CAAC,IAAA,EAAc,UAAoC,MAAA,CAAO,KAAK,EAAE,IAAI","file":"chunk-C3YWUWRH.js","sourcesContent":["/** An opened, bidirectional MIDI connection to an Exquis. */\nexport interface Transport {\n  /** Send raw MIDI bytes (including SysEx) to the device. */\n  send(bytes: number[]): void;\n  /** Register a handler for every inbound MIDI message. */\n  onMessage(cb: (bytes: number[]) => void): void;\n  /** Close the underlying ports. */\n  close(): Promise<void>;\n}\n\n/** A minimal one-way MIDI output (e.g. to a downstream synth). */\nexport interface Output {\n  send(bytes: number[]): void;\n  close(): Promise<void>;\n}\n\nexport interface MidiPort {\n  id: string;\n  name: string;\n}\n\n/** Opens a `Transport` to the first port matching `match` (default `/exquis/i`). */\nexport type OpenTransport = (match?: RegExp | string) => Promise<Transport>;\n\nconst toTest = (match: RegExp | string): ((name: string) => boolean) =>\n  typeof match === 'string'\n    ? (name) => name.toLowerCase().includes(match.toLowerCase())\n    : (name) => match.test(name);\n\n/** Shared helper: does a port name match the requested pattern? */\nexport const matchesPort = (name: string, match: RegExp | string): boolean => toTest(match)(name);\n"]}