@ac-kit/format-midi 0.0.0-stage → 0.1.0

package/dist/message/encode-midi-message.d.ts

@@ -0,0 +1,21 @@
+import type { MidiMessage } from "./midi-message.js";
+/**
+ * Encodes one MIDI 1.0 message to its bytes on the wire, status byte always
+ * included.
+ *
+ * Use {@link MidiMessageEncoder} instead to send a sequence of messages with
+ * running status. A `sysEx` is framed with F0 and F7; its `data` must not carry
+ * them itself.
+ *
+ * Time complexity: O(1), or O(`data.length`) for a `sysEx`.
+ *
+ * @example
+ * 	encodeMidiMessage({ type: "pitchBend", channel: 0, value: 0 }); // [0xe0, 0x00, 0x40]
+ *
+ * @param message - The message to encode.
+ * @returns A fresh buffer holding the message.
+ * @throws {RangeError} When a field is out of its range or not an integer, or a
+ *   `sysEx` payload holds a byte above 127.
+ */
+export declare function encodeMidiMessage(message: MidiMessage): Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=encode-midi-message.d.ts.map

package/dist/message/encode-midi-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-midi-message.d.ts","sourceRoot":"","sources":["../../src/message/encode-midi-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAgBrD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,WAAW,GAClB,UAAU,CAAC,WAAW,CAAC,CAwGzB"}

package/dist/message/encode-midi-message.js

@@ -0,0 +1,93 @@
+function uint_(field, value, maximum) {
+    if (!Number.isInteger(value) || value < 0 || value > maximum) {
+        throw new RangeError(`encodeMidiMessage: ${field} must be an integer 0–${maximum}, got ${value}`);
+    }
+    return value;
+}
+function channelStatus_(kind, channel) {
+    return kind | uint_("channel", channel, 0x0f);
+}
+/**
+ * Encodes one MIDI 1.0 message to its bytes on the wire, status byte always
+ * included.
+ *
+ * Use {@link MidiMessageEncoder} instead to send a sequence of messages with
+ * running status. A `sysEx` is framed with F0 and F7; its `data` must not carry
+ * them itself.
+ *
+ * Time complexity: O(1), or O(`data.length`) for a `sysEx`.
+ *
+ * @example
+ * 	encodeMidiMessage({ type: "pitchBend", channel: 0, value: 0 }); // [0xe0, 0x00, 0x40]
+ *
+ * @param message - The message to encode.
+ * @returns A fresh buffer holding the message.
+ * @throws {RangeError} When a field is out of its range or not an integer, or a
+ *   `sysEx` payload holds a byte above 127.
+ */
+export function encodeMidiMessage(message) {
+    switch (message.type) {
+        case "noteOff":
+            return Uint8Array.of(channelStatus_(0x80, message.channel), uint_("note", message.note, 0x7f), uint_("velocity", message.velocity, 0x7f));
+        case "noteOn":
+            return Uint8Array.of(channelStatus_(0x90, message.channel), uint_("note", message.note, 0x7f), uint_("velocity", message.velocity, 0x7f));
+        case "polyphonicKeyPressure":
+            return Uint8Array.of(channelStatus_(0xa0, message.channel), uint_("note", message.note, 0x7f), uint_("pressure", message.pressure, 0x7f));
+        case "controlChange":
+            return Uint8Array.of(channelStatus_(0xb0, message.channel), uint_("controller", message.controller, 0x7f), uint_("value", message.value, 0x7f));
+        case "programChange":
+            return Uint8Array.of(channelStatus_(0xc0, message.channel), uint_("program", message.program, 0x7f));
+        case "channelPressure":
+            return Uint8Array.of(channelStatus_(0xd0, message.channel), uint_("pressure", message.pressure, 0x7f));
+        case "pitchBend": {
+            if (!Number.isInteger(message.value) ||
+                message.value < -8192 ||
+                message.value > 8191) {
+                throw new RangeError(`encodeMidiMessage: pitch bend value must be an integer -8192–8191, got ${message.value}`);
+            }
+            const raw = message.value + 8192;
+            return Uint8Array.of(channelStatus_(0xe0, message.channel), raw & 0x7f, raw >> 7);
+        }
+        case "sysEx": {
+            const out = new Uint8Array(message.data.length + 2);
+            out[0] = 0xf0;
+            for (let index = 0; index < message.data.length; index++) {
+                const byte = message.data[index];
+                if (byte > 0x7f) {
+                    throw new RangeError(`encodeMidiMessage: SysEx byte ${index} is 0x${byte.toString(16)}, above 0x7F`);
+                }
+                out[index + 1] = byte;
+            }
+            out[out.length - 1] = 0xf7;
+            return out;
+        }
+        case "timeCodeQuarterFrame":
+            return Uint8Array.of(0xf1, (uint_("piece", message.piece, 7) << 4) |
+                uint_("value", message.value, 0x0f));
+        case "songPositionPointer": {
+            const position = uint_("position", message.position, 0x3fff);
+            return Uint8Array.of(0xf2, position & 0x7f, position >> 7);
+        }
+        case "songSelect":
+            return Uint8Array.of(0xf3, uint_("song", message.song, 0x7f));
+        case "tuneRequest":
+            return Uint8Array.of(0xf6);
+        case "timingClock":
+            return Uint8Array.of(0xf8);
+        case "start":
+            return Uint8Array.of(0xfa);
+        case "continue":
+            return Uint8Array.of(0xfb);
+        case "stop":
+            return Uint8Array.of(0xfc);
+        case "activeSensing":
+            return Uint8Array.of(0xfe);
+        case "systemReset":
+            return Uint8Array.of(0xff);
+        default: {
+            const unknown = message;
+            throw new RangeError(`encodeMidiMessage: unknown message type ${String(unknown.type)}`);
+        }
+    }
+}
+//# sourceMappingURL=encode-midi-message.js.map

package/dist/message/encode-midi-message.js.map

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

package/dist/message/is-midi-note-release.d.ts

@@ -0,0 +1,15 @@
+import type { MidiMessage } from "./midi-message.js";
+/**
+ * Whether `message` releases a note: a `noteOff`, or a `noteOn` with velocity
+ * 0, which every MIDI receiver treats as a note-off.
+ *
+ * Use it instead of testing `type === "noteOff"`, which misses the note-on form
+ * most senders use so that running status covers a whole phrase.
+ *
+ * @example
+ * 	isMidiNoteRelease({ type: "noteOn", channel: 0, note: 60, velocity: 0 }); // true
+ */
+export declare function isMidiNoteRelease(message: MidiMessage): message is Extract<MidiMessage, {
+    type: "noteOff" | "noteOn";
+}>;
+//# sourceMappingURL=is-midi-note-release.d.ts.map

package/dist/message/is-midi-note-release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-midi-note-release.d.ts","sourceRoot":"","sources":["../../src/message/is-midi-note-release.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,WAAW,GAClB,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,CAAC,CAKjE"}

package/dist/message/is-midi-note-release.js

@@ -0,0 +1,15 @@
+/**
+ * Whether `message` releases a note: a `noteOff`, or a `noteOn` with velocity
+ * 0, which every MIDI receiver treats as a note-off.
+ *
+ * Use it instead of testing `type === "noteOff"`, which misses the note-on form
+ * most senders use so that running status covers a whole phrase.
+ *
+ * @example
+ * 	isMidiNoteRelease({ type: "noteOn", channel: 0, note: 60, velocity: 0 }); // true
+ */
+export function isMidiNoteRelease(message) {
+    return (message.type === "noteOff" ||
+        (message.type === "noteOn" && message.velocity === 0));
+}
+//# sourceMappingURL=is-midi-note-release.js.map

package/dist/message/is-midi-note-release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-midi-note-release.js","sourceRoot":"","sources":["../../src/message/is-midi-note-release.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAChC,OAAoB;IAEpB,OAAO,CACN,OAAO,CAAC,IAAI,KAAK,SAAS;QAC1B,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,CAAC,CAAC,CACrD,CAAC;AACH,CAAC"}

package/dist/message/midi-message-decoder.d.ts

@@ -0,0 +1,67 @@
+import { type DecodeResult, type Decoder } from "@ac-kit/format-core";
+import type { MidiMessage } from "./midi-message.js";
+/** Options for {@link MidiMessageDecoder}. */
+export type MidiMessageDecoderOptions = {
+    /**
+     * Largest SysEx payload accepted, in bytes between F0 and F7. A longer one is
+     * reported as a recoverable `sysExTooLong` error and its remaining bytes are
+     * dropped up to its end. This bounds the memory the decoder holds, since a
+     * SysEx in progress is kept in its own state rather than the caller's
+     * buffer.
+     *
+     * Defaults to 1 048 576 (1 MiB), above a synthesizer's full bulk dump. Set it
+     * to what the devices on the link actually send.
+     */
+    maxSysExLength?: number;
+};
+/**
+ * Decodes MIDI 1.0 messages from a live byte stream — a USB-MIDI or serial
+ * port, an ALSA raw MIDI device, a Web MIDI capture — the way a MIDI receiver
+ * does.
+ *
+ * - **Running status**: data bytes after a channel message reuse its status. A
+ *   System Common message or a SysEx cancels it.
+ * - **Real-time bytes** (F8–FF) may arrive anywhere, even between a status and
+ *   its data bytes or inside a SysEx. They are returned immediately and the
+ *   interrupted message carries on.
+ * - **SysEx** ends at F7, or at any other non-real-time status byte (an implied
+ *   End of Exclusive): the SysEx is returned, then that status is read.
+ * - **Recoverable errors**: stray data bytes with no status, a message cut short
+ *   by a status byte, the undefined statuses F4, F5, F9 and FD, an F7 with no
+ *   SysEx open and an over-long SysEx come back as `error` results carrying a
+ *   {@link MidiStreamError}. Their bytes are consumed and decoding
+ *   resynchronises at the next status byte. The decoder never returns `fatal`.
+ *
+ * It is stateful and an instance must back exactly one stream. To return a
+ * real-time message that interrupts another one, it moves the interrupted
+ * message's leading bytes into its own state and reports them consumed; it does
+ * the same with a SysEx as it arrives, so a long dump does not sit in the
+ * caller's buffer. A message whose bytes were moved that way is completed by
+ * later input. When input ends, a SysEx in progress is still reported as
+ * truncated (its last byte is kept in the caller's buffer for that purpose),
+ * but a channel or System Common message whose start was absorbed because a
+ * real-time byte interrupted it is not: it stays in the state until
+ * {@link reset}.
+ *
+ * Time complexity: O(n) in the bytes received, amortised over calls. Memory:
+ * O(`maxSysExLength`).
+ *
+ * @see MidiMessageEncoder for the write half.
+ */
+export declare class MidiMessageDecoder implements Decoder<MidiMessage> {
+    private readonly maxSysExLength;
+    private state;
+    /** SysEx payload bytes moved out of the caller's buffer, in order. */
+    private sysExChunks;
+    /**
+     * @throws {RangeError} When `maxSysExLength` is not a non-negative safe
+     *   integer.
+     */
+    constructor(options?: MidiMessageDecoderOptions);
+    decode(view: Uint8Array): DecodeResult<MidiMessage>;
+    /** Discards running status, any message in progress and any SysEx accumulated. */
+    reset(): void;
+    private absorbSysEx_;
+    private fail_;
+}
+//# sourceMappingURL=midi-message-decoder.d.ts.map

package/dist/message/midi-message-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"midi-message-decoder.d.ts","sourceRoot":"","sources":["../../src/message/midi-message-decoder.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,MAAM,qBAAqB,CAAC;AAe7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,8CAA8C;AAC9C,MAAM,MAAM,yBAAyB,GAAG;IACvC;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AA0DF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,kBAAmB,YAAW,OAAO,CAAC,WAAW,CAAC;IAC9D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,KAAK,CAAiC;IAE9C,sEAAsE;IACtE,OAAO,CAAC,WAAW,CAAoB;IAEvC;;;OAGG;IACH,YAAY,OAAO,CAAC,EAAE,yBAAyB,EAQ9C;IAED,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC,WAAW,CAAC,CAoNlD;IAED,kFAAkF;IAClF,KAAK,IAAI,IAAI,CAGZ;IAED,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,KAAK;CAcb"}

package/dist/message/midi-message-decoder.js

@@ -0,0 +1,254 @@
+import { concatBytes } from "@ac-kit/core";
+import { DECODE_INCOMPLETE, } from "@ac-kit/format-core";
+import { MidiStreamError } from "../errors.js";
+import { FIRST_REAL_TIME_, SONG_POSITION_POINTER_, SONG_SELECT_, SYSEX_END_, SYSEX_START_, TIME_CODE_QUARTER_FRAME_, TUNE_REQUEST_, channelDataLength_, createChannelMessage_, realTimeMessage_, } from "./_midi-status.js";
+const DEFAULT_MAX_SYSEX_LENGTH_ = 1048576;
+const INITIAL_STATE_ = {
+    runningStatus: 0,
+    status: 0,
+    data1: 0,
+    dataCount: 0,
+    sysExLength: 0,
+    discarding: false,
+};
+function dataLength_(status) {
+    if (status === SONG_POSITION_POINTER_) {
+        return 2;
+    }
+    if (status === TIME_CODE_QUARTER_FRAME_ || status === SONG_SELECT_) {
+        return 1;
+    }
+    return channelDataLength_(status);
+}
+function createMessage_(status, data1, data2) {
+    switch (status) {
+        case TIME_CODE_QUARTER_FRAME_:
+            return {
+                type: "timeCodeQuarterFrame",
+                piece: data1 >> 4,
+                value: data1 & 0x0f,
+            };
+        case SONG_POSITION_POINTER_:
+            return { type: "songPositionPointer", position: data1 | (data2 << 7) };
+        case SONG_SELECT_:
+            return { type: "songSelect", song: data1 };
+        default:
+            return createChannelMessage_(status, data1, data2);
+    }
+}
+/**
+ * Decodes MIDI 1.0 messages from a live byte stream — a USB-MIDI or serial
+ * port, an ALSA raw MIDI device, a Web MIDI capture — the way a MIDI receiver
+ * does.
+ *
+ * - **Running status**: data bytes after a channel message reuse its status. A
+ *   System Common message or a SysEx cancels it.
+ * - **Real-time bytes** (F8–FF) may arrive anywhere, even between a status and
+ *   its data bytes or inside a SysEx. They are returned immediately and the
+ *   interrupted message carries on.
+ * - **SysEx** ends at F7, or at any other non-real-time status byte (an implied
+ *   End of Exclusive): the SysEx is returned, then that status is read.
+ * - **Recoverable errors**: stray data bytes with no status, a message cut short
+ *   by a status byte, the undefined statuses F4, F5, F9 and FD, an F7 with no
+ *   SysEx open and an over-long SysEx come back as `error` results carrying a
+ *   {@link MidiStreamError}. Their bytes are consumed and decoding
+ *   resynchronises at the next status byte. The decoder never returns `fatal`.
+ *
+ * It is stateful and an instance must back exactly one stream. To return a
+ * real-time message that interrupts another one, it moves the interrupted
+ * message's leading bytes into its own state and reports them consumed; it does
+ * the same with a SysEx as it arrives, so a long dump does not sit in the
+ * caller's buffer. A message whose bytes were moved that way is completed by
+ * later input. When input ends, a SysEx in progress is still reported as
+ * truncated (its last byte is kept in the caller's buffer for that purpose),
+ * but a channel or System Common message whose start was absorbed because a
+ * real-time byte interrupted it is not: it stays in the state until
+ * {@link reset}.
+ *
+ * Time complexity: O(n) in the bytes received, amortised over calls. Memory:
+ * O(`maxSysExLength`).
+ *
+ * @see MidiMessageEncoder for the write half.
+ */
+export class MidiMessageDecoder {
+    maxSysExLength;
+    state = { ...INITIAL_STATE_ };
+    /** SysEx payload bytes moved out of the caller's buffer, in order. */
+    sysExChunks = [];
+    /**
+     * @throws {RangeError} When `maxSysExLength` is not a non-negative safe
+     *   integer.
+     */
+    constructor(options) {
+        const maxSysExLength = options?.maxSysExLength ?? DEFAULT_MAX_SYSEX_LENGTH_;
+        if (!Number.isSafeInteger(maxSysExLength) || maxSysExLength < 0) {
+            throw new RangeError(`MidiMessageDecoder: maxSysExLength must be a non-negative safe integer, got ${maxSysExLength}`);
+        }
+        this.maxSysExLength = maxSysExLength;
+    }
+    decode(view) {
+        if (view.length === 0) {
+            return DECODE_INCOMPLETE;
+        }
+        // Worked on a copy and committed only with a result that consumes bytes:
+        // an `incomplete` result leaves the bytes in the caller's buffer, so the
+        // next call must start again from the state this one started from.
+        const state = { ...this.state };
+        let sysExFrom = 0;
+        let strayFrom = -1;
+        for (let index = 0; index < view.length; index++) {
+            const byte = view[index];
+            if (byte >= FIRST_REAL_TIME_) {
+                if (strayFrom !== -1) {
+                    return this.fail_(state, "strayData", "data bytes with no status", index);
+                }
+                if (state.status === SYSEX_START_ && !state.discarding) {
+                    this.absorbSysEx_(view, sysExFrom, index);
+                }
+                const message = realTimeMessage_(byte);
+                if (message === undefined) {
+                    return this.fail_(state, "undefinedStatus", `undefined real-time status 0x${byte.toString(16)}`, index + 1);
+                }
+                this.state = state;
+                return { status: "decoded", value: message, consumed: index + 1 };
+            }
+            if (strayFrom !== -1) {
+                if (byte < 0x80) {
+                    continue;
+                }
+                return this.fail_(state, "strayData", "data bytes with no status", index);
+            }
+            if (state.status === SYSEX_START_) {
+                if (byte < 0x80) {
+                    if (state.discarding) {
+                        continue;
+                    }
+                    state.sysExLength++;
+                    if (state.sysExLength > this.maxSysExLength) {
+                        state.sysExLength = 0;
+                        state.discarding = true;
+                        this.sysExChunks = [];
+                        return this.fail_(state, "sysExTooLong", `SysEx longer than ${this.maxSysExLength} bytes`, index + 1);
+                    }
+                    continue;
+                }
+                if (state.discarding) {
+                    state.status = 0;
+                    state.discarding = false;
+                    if (byte === SYSEX_END_) {
+                        this.state = state;
+                        return { status: "skip", consumed: index + 1 };
+                    }
+                    // Any other status ends the discarded SysEx and is read below.
+                }
+                else {
+                    const data = concatBytes([
+                        ...this.sysExChunks,
+                        view.subarray(sysExFrom, index),
+                    ]);
+                    this.sysExChunks = [];
+                    state.status = 0;
+                    state.sysExLength = 0;
+                    this.state = state;
+                    return {
+                        status: "decoded",
+                        value: { type: "sysEx", data },
+                        // An implied End of Exclusive leaves the status byte to the next call.
+                        consumed: byte === SYSEX_END_ ? index + 1 : index,
+                    };
+                }
+            }
+            if (byte >= 0x80) {
+                if (state.status !== 0) {
+                    state.status = 0;
+                    state.dataCount = 0;
+                    return this.fail_(state, "incompleteMessage", `message 0x${byte.toString(16)} interrupted an incomplete message`, index);
+                }
+                if (byte < SYSEX_START_) {
+                    state.runningStatus = byte;
+                    state.status = byte;
+                    continue;
+                }
+                state.runningStatus = 0;
+                switch (byte) {
+                    case SYSEX_START_:
+                        state.status = byte;
+                        state.sysExLength = 0;
+                        sysExFrom = index + 1;
+                        continue;
+                    case TIME_CODE_QUARTER_FRAME_:
+                    case SONG_POSITION_POINTER_:
+                    case SONG_SELECT_:
+                        state.status = byte;
+                        continue;
+                    case TUNE_REQUEST_:
+                        this.state = state;
+                        return {
+                            status: "decoded",
+                            value: { type: "tuneRequest" },
+                            consumed: index + 1,
+                        };
+                    case SYSEX_END_:
+                        return this.fail_(state, "unexpectedEndOfExclusive", "End of Exclusive with no SysEx open", index + 1);
+                    default:
+                        return this.fail_(state, "undefinedStatus", `undefined System Common status 0x${byte.toString(16)}`, index + 1);
+                }
+            }
+            if (state.status === 0) {
+                if (state.runningStatus === 0) {
+                    strayFrom = index;
+                    continue;
+                }
+                state.status = state.runningStatus;
+            }
+            if (state.dataCount === 0 && dataLength_(state.status) === 2) {
+                state.data1 = byte;
+                state.dataCount = 1;
+                continue;
+            }
+            const message = createMessage_(state.status, state.dataCount === 0 ? byte : state.data1, byte);
+            state.status = 0;
+            state.dataCount = 0;
+            this.state = state;
+            return { status: "decoded", value: message, consumed: index + 1 };
+        }
+        if (strayFrom !== -1) {
+            return this.fail_(state, "strayData", "data bytes with no status", view.length);
+        }
+        if (state.status === SYSEX_START_) {
+            if (state.discarding) {
+                this.state = state;
+                return { status: "skip", consumed: view.length };
+            }
+            // Everything but the last payload byte moves into the state, so a
+            // driver still holds a byte and reports a truncation if input ends.
+            const kept = view.length - 1;
+            if (sysExFrom <= kept && kept > 0) {
+                this.absorbSysEx_(view, sysExFrom, kept);
+                state.sysExLength--;
+                this.state = state;
+                return { status: "skip", consumed: kept };
+            }
+        }
+        return DECODE_INCOMPLETE;
+    }
+    /** Discards running status, any message in progress and any SysEx accumulated. */
+    reset() {
+        this.state = { ...INITIAL_STATE_ };
+        this.sysExChunks = [];
+    }
+    absorbSysEx_(view, from, to) {
+        if (to > from) {
+            this.sysExChunks.push(view.slice(from, to));
+        }
+    }
+    fail_(state, reason, message, consumed) {
+        this.state = state;
+        return {
+            status: "error",
+            error: new MidiStreamError(`MidiMessageDecoder: ${message}`, reason),
+            consumed,
+        };
+    }
+}
+//# sourceMappingURL=midi-message-decoder.js.map

package/dist/message/midi-message-decoder.js.map

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

package/dist/message/midi-message-encoder.d.ts

@@ -0,0 +1,43 @@
+import type { Encoder } from "@ac-kit/format-core";
+import type { MidiMessage } from "./midi-message.js";
+/** Options for {@link MidiMessageEncoder}. */
+export type MidiMessageEncoderOptions = {
+    /**
+     * Omit a channel message's status byte when it repeats the previous one (MIDI
+     * 1.0 running status), saving a third of the bandwidth of a run of notes.
+     * Defaults to `false`.
+     *
+     * Enable it only for a link with a single sender and a receiver that sees
+     * every byte from the start: a receiver joining mid-stream cannot read data
+     * bytes until the next status byte.
+     */
+    runningStatus?: boolean;
+};
+/**
+ * Encodes MIDI 1.0 messages for a byte stream — the write half matching
+ * {@link MidiMessageDecoder}.
+ *
+ * With `runningStatus`, the encoder remembers the last channel status it wrote
+ * and an instance must back exactly one stream. A System Common message or a
+ * SysEx clears that memory, as it does in a receiver; a System Real-Time
+ * message leaves it untouched. Without it, the result of every call is
+ * {@link encodeMidiMessage}'s.
+ */
+export declare class MidiMessageEncoder implements Encoder<MidiMessage> {
+    private readonly runningStatus;
+    /** Last channel status written, 0 when running status is not in effect. */
+    private lastStatus;
+    constructor(options?: MidiMessageEncoderOptions);
+    /**
+     * Encodes one message, omitting its status byte under running status.
+     *
+     * @throws {RangeError} As {@link encodeMidiMessage}.
+     */
+    encode(message: MidiMessage): Uint8Array<ArrayBuffer>;
+    /**
+     * Forgets the running status, so the next channel message carries its status
+     * byte.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=midi-message-encoder.d.ts.map

package/dist/message/midi-message-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"midi-message-encoder.d.ts","sourceRoot":"","sources":["../../src/message/midi-message-encoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,8CAA8C;AAC9C,MAAM,MAAM,yBAAyB,GAAG;IACvC;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,OAAO,CAAC,WAAW,CAAC;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IAExC,2EAA2E;IAC3E,OAAO,CAAC,UAAU,CAAK;IAEvB,YAAY,OAAO,CAAC,EAAE,yBAAyB,EAE9C;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,CAiBpD;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI,CAEZ;CACD"}

package/dist/message/midi-message-encoder.js

@@ -0,0 +1,49 @@
+import { encodeMidiMessage } from "./encode-midi-message.js";
+/**
+ * Encodes MIDI 1.0 messages for a byte stream — the write half matching
+ * {@link MidiMessageDecoder}.
+ *
+ * With `runningStatus`, the encoder remembers the last channel status it wrote
+ * and an instance must back exactly one stream. A System Common message or a
+ * SysEx clears that memory, as it does in a receiver; a System Real-Time
+ * message leaves it untouched. Without it, the result of every call is
+ * {@link encodeMidiMessage}'s.
+ */
+export class MidiMessageEncoder {
+    runningStatus;
+    /** Last channel status written, 0 when running status is not in effect. */
+    lastStatus = 0;
+    constructor(options) {
+        this.runningStatus = options?.runningStatus ?? false;
+    }
+    /**
+     * Encodes one message, omitting its status byte under running status.
+     *
+     * @throws {RangeError} As {@link encodeMidiMessage}.
+     */
+    encode(message) {
+        const bytes = encodeMidiMessage(message);
+        if (!this.runningStatus) {
+            return bytes;
+        }
+        const status = bytes[0];
+        if (status < 0xf0) {
+            if (status === this.lastStatus) {
+                return bytes.subarray(1);
+            }
+            this.lastStatus = status;
+        }
+        else if (status < 0xf8) {
+            this.lastStatus = 0;
+        }
+        return bytes;
+    }
+    /**
+     * Forgets the running status, so the next channel message carries its status
+     * byte.
+     */
+    reset() {
+        this.lastStatus = 0;
+    }
+}
+//# sourceMappingURL=midi-message-encoder.js.map

package/dist/message/midi-message-encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"midi-message-encoder.js","sourceRoot":"","sources":["../../src/message/midi-message-encoder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAiB7D;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAkB;IACb,aAAa,CAAU;IAExC,2EAA2E;IACnE,UAAU,GAAG,CAAC,CAAC;IAEvB,YAAY,OAAmC;QAC9C,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,KAAK,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAoB;QAC1B,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACzB,IAAI,MAAM,GAAG,IAAI,EAAE,CAAC;YACnB,IAAI,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QAC1B,CAAC;aAAM,IAAI,MAAM,GAAG,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK;QACJ,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IACrB,CAAC;CACD"}