@ac-kit/format-midi 0.1.1 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @ac-kit/format-midi
 
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies [235ec3c]
+  - @ac-kit/core@0.5.0
+  - @ac-kit/algo@0.2.2
+  - @ac-kit/format-core@0.1.5
+  - @ac-kit/format-varint@0.1.4
+  - @ac-kit/model-music@0.1.1
+
+## 0.2.0
+
+### Minor Changes
+
+- eb2aa3d: Reads a Standard MIDI File as music, not only as events:
+  
+  - `composeMidiNotes` pairs every note-on with its release into a `MidiNote`
+    with its start and end in ticks and seconds.
+  - `detectMidiTextEncoding` guesses whether a file's text meta events are
+    UTF-8, Shift JIS or windows-1252, to decode them with `@ac-kit/core`'s
+    `decodeText`.
+  - `composeMidiKaraoke` reads the tags and timed syllables of a Soft Karaoke
+    (`.kar`) file.
+  - `composeMidiSong`, on the new `@ac-kit/format-midi/song` subpath, converts a
+    file into an `@ac-kit/model-music` `Song`. The package now depends on
+    `@ac-kit/algo` and `@ac-kit/model-music`; the main entry does not load
+    `@ac-kit/model-music`.
+
+### Patch Changes
+
+- Updated dependencies [aca1cb1]
+- Updated dependencies [eb2aa3d]
+  - @ac-kit/core@0.4.0
+  - @ac-kit/model-music@0.1.0
+  - @ac-kit/algo@0.2.1
+  - @ac-kit/format-core@0.1.4
+  - @ac-kit/format-varint@0.1.3
+
 ## 0.1.1
 
 ### Patch Changes

package/README.md

@@ -99,6 +99,42 @@ independent sequences: each is timed on its own and they follow one another.
 An SMPTE division gives each tick a fixed length, with frame rate 29 meaning
 29.97.
 
+## Notes
+
+`composeMidiNotes` pairs every note-on of a timeline with the release that ends
+it — a `noteOff`, or a `noteOn` of velocity 0, on the same track, channel and
+note number — and gives each note its start and end in ticks and in seconds.
+Overlapping strikes of one note close first in, first out, and a note never
+released ends where its track ends. The sustain pedal is not applied: its
+controller events stay in the timeline.
+
+## Text
+
+Text meta events keep their bytes. `detectMidiTextEncoding` guesses one
+`MidiTextEncoding` for a whole file from all its text events — `utf-8`,
+`shift_jis` or `windows-1252` — and `decodeText` from `@ac-kit/core` decodes
+each event with it, or with strict ISO-8859-1 (`latin1`) when that is known.
+
+`composeMidiKaraoke` reads a Soft Karaoke (`.kar`) file: its `@V`, `@L`, `@T`
+and `@I` tags, and the syllables of its lyrics track with their times and their
+`/` line and `\` paragraph breaks. A file without the `@K` tag is not karaoke.
+
+## Songs
+
+`composeMidiSong`, from the `@ac-kit/format-midi/song` subpath, converts a file
+into a `Song` of `@ac-kit/model-music`: notes with their part, pitch, velocity
+and times, one part per track and channel with its name and program, the tempo
+map, time and key signatures, measures, the sustain, sostenuto and soft pedals,
+markers, and lyrics from karaoke or `lyric` events. A format 2 file is read one
+sequence at a time.
+
+```ts
+import { parseMidiFile } from "@ac-kit/format-midi";
+import { composeMidiSong } from "@ac-kit/format-midi/song";
+
+const song = composeMidiSong(parseMidiFile(bytes));
+```
+
 See the
 [generated API docs](https://anthochamp.github.io/node-essentials/api/format-midi/)
 for the full reference.

package/dist/file/_time-division.d.ts

@@ -0,0 +1,9 @@
+import type { MidiTimeDivision } from "./midi-file.js";
+/**
+ * Ticks per second of an SMPTE time division, with frame rate 29 read as 30
+ * drop-frame, 30000/1001 frames per second.
+ */
+export declare function timecodeTicksPerSecond_(division: Extract<MidiTimeDivision, {
+    type: "timecode";
+}>): number;
+//# sourceMappingURL=_time-division.d.ts.map

package/dist/file/_time-division.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_time-division.d.ts","sourceRoot":"","sources":["../../src/file/_time-division.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,GACvD,MAAM,CAKR"}

package/dist/file/_time-division.js

@@ -0,0 +1,9 @@
+/**
+ * Ticks per second of an SMPTE time division, with frame rate 29 read as 30
+ * drop-frame, 30000/1001 frames per second.
+ */
+export function timecodeTicksPerSecond_(division) {
+    const framesPerSecond = division.framesPerSecond === 29 ? 30000 / 1001 : division.framesPerSecond;
+    return framesPerSecond * division.ticksPerFrame;
+}
+//# sourceMappingURL=_time-division.js.map

package/dist/file/_time-division.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_time-division.js","sourceRoot":"","sources":["../../src/file/_time-division.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACtC,QAAyD;IAEzD,MAAM,eAAe,GACpB,QAAQ,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC,CAAC,KAAM,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;IAE5E,OAAO,eAAe,GAAG,QAAQ,CAAC,aAAa,CAAC;AACjD,CAAC"}

package/dist/file/detect-midi-text-encoding.d.ts

@@ -0,0 +1,42 @@
+import { type TextDecodingName } from "@ac-kit/core";
+import type { MidiFile } from "./midi-file.js";
+/**
+ * A character encoding found in the text meta events of Standard MIDI Files, to
+ * decode them with `@ac-kit/core`'s `decodeText`.
+ *
+ * - `utf-8` — recent tools; ASCII text is valid UTF-8 too.
+ * - `shift_jis` — Japanese sequencers.
+ * - `windows-1252` — Western European text from most other tools, and what Web
+ *   APIs mean by "Latin-1".
+ * - `latin1` — strict ISO-8859-1, mapping 0x80–0x9F to the C1 control codes where
+ *   `windows-1252` has printable characters.
+ */
+export type MidiTextEncoding = Extract<TextDecodingName, "utf-8" | "shift_jis" | "windows-1252" | "latin1">;
+/**
+ * Guesses the encoding of a file's text meta events, all of them together,
+ * since one tool wrote them.
+ *
+ * Use it when nothing else says which encoding a file uses, then decode each
+ * text event with `decodeText(data, encoding)` from `@ac-kit/core`, or pass the
+ * result to {@link composeMidiKaraoke}. It is a heuristic: Japanese text
+ * written in kanji only reads as `windows-1252`.
+ *
+ * - `utf-8` when every text is valid UTF-8, which includes plain ASCII and a file
+ *   with no text at all;
+ * - Otherwise `shift_jis` when every text is valid Shift JIS and some of it is
+ *   kana;
+ * - Otherwise `windows-1252`, which decodes any byte.
+ *
+ * Time complexity: O(n) in the total size of the text meta events. Memory:
+ * O(n).
+ *
+ * @example
+ * 	detectMidiTextEncoding(parseMidiFile(bytes)); // "utf-8"
+ *
+ * @param file - A parsed file.
+ * @returns The most plausible encoding.
+ * @throws {RangeError} When the text is not UTF-8 and the runtime's
+ *   `TextDecoder` lacks Shift JIS.
+ */
+export declare function detectMidiTextEncoding(file: MidiFile): MidiTextEncoding;
+//# sourceMappingURL=detect-midi-text-encoding.d.ts.map

package/dist/file/detect-midi-text-encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-midi-text-encoding.d.ts","sourceRoot":"","sources":["../../src/file/detect-midi-text-encoding.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CACrC,gBAAgB,EAChB,OAAO,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,CACjD,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,GAAG,gBAAgB,CA8BvE"}

package/dist/file/detect-midi-text-encoding.js

@@ -0,0 +1,55 @@
+import { decodeText, isValidText } from "@ac-kit/core";
+// Full-width hiragana and katakana: Japanese text nearly always has some, and
+// the Shift JIS pairs that Latin-1 letters happen to form are kanji instead.
+const KANA_PATTERN_ = /[\u3041-\u30ff]/u;
+/**
+ * Guesses the encoding of a file's text meta events, all of them together,
+ * since one tool wrote them.
+ *
+ * Use it when nothing else says which encoding a file uses, then decode each
+ * text event with `decodeText(data, encoding)` from `@ac-kit/core`, or pass the
+ * result to {@link composeMidiKaraoke}. It is a heuristic: Japanese text
+ * written in kanji only reads as `windows-1252`.
+ *
+ * - `utf-8` when every text is valid UTF-8, which includes plain ASCII and a file
+ *   with no text at all;
+ * - Otherwise `shift_jis` when every text is valid Shift JIS and some of it is
+ *   kana;
+ * - Otherwise `windows-1252`, which decodes any byte.
+ *
+ * Time complexity: O(n) in the total size of the text meta events. Memory:
+ * O(n).
+ *
+ * @example
+ * 	detectMidiTextEncoding(parseMidiFile(bytes)); // "utf-8"
+ *
+ * @param file - A parsed file.
+ * @returns The most plausible encoding.
+ * @throws {RangeError} When the text is not UTF-8 and the runtime's
+ *   `TextDecoder` lacks Shift JIS.
+ */
+export function detectMidiTextEncoding(file) {
+    const texts = [];
+    for (const { events } of file.tracks) {
+        for (const { event } of events) {
+            if (event.kind === "meta" &&
+                "data" in event.meta &&
+                event.meta.type !== "sequencerSpecific" &&
+                event.meta.type !== "unknown") {
+                texts.push(event.meta.data);
+            }
+        }
+    }
+    if (texts.every((text) => isValidText(text, "utf-8"))) {
+        return "utf-8";
+    }
+    if (!texts.every((text) => isValidText(text, "shift_jis"))) {
+        return "windows-1252";
+    }
+    const hasKana = texts.some((text) => KANA_PATTERN_.test(decodeText(text, "shift_jis")));
+    if (hasKana) {
+        return "shift_jis";
+    }
+    return "windows-1252";
+}
+//# sourceMappingURL=detect-midi-text-encoding.js.map

package/dist/file/detect-midi-text-encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-midi-text-encoding.js","sourceRoot":"","sources":["../../src/file/detect-midi-text-encoding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAyB,MAAM,cAAc,CAAC;AAoB9E,8EAA8E;AAC9E,6EAA6E;AAC7E,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAc;IACpD,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACtC,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;YAChC,IACC,KAAK,CAAC,IAAI,KAAK,MAAM;gBACrB,MAAM,IAAI,KAAK,CAAC,IAAI;gBACpB,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,mBAAmB;gBACvC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,EAC5B,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACF,CAAC;IACF,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,cAAc,CAAC;IACvB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACnC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CACjD,CAAC;IACF,IAAI,OAAO,EAAE,CAAC;QACb,OAAO,WAAW,CAAC;IACpB,CAAC;IAED,OAAO,cAAc,CAAC;AACvB,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./errors.js";
+export * from "./file/detect-midi-text-encoding.js";
 export * from "./file/midi-file.js";
 export * from "./file/midi-meta-event.js";
 export * from "./file/parse-midi-file.js";
@@ -8,5 +9,7 @@ export * from "./message/is-midi-note-release.js";
 export * from "./message/midi-message-decoder.js";
 export * from "./message/midi-message-encoder.js";
 export * from "./message/midi-message.js";
+export * from "./timeline/compose-midi-karaoke.js";
+export * from "./timeline/compose-midi-notes.js";
 export * from "./timeline/compose-midi-timeline.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,qCAAqC,CAAC;AACpD,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./errors.js";
+export * from "./file/detect-midi-text-encoding.js";
 export * from "./file/midi-file.js";
 export * from "./file/midi-meta-event.js";
 export * from "./file/parse-midi-file.js";
@@ -8,5 +9,7 @@ export * from "./message/is-midi-note-release.js";
 export * from "./message/midi-message-decoder.js";
 export * from "./message/midi-message-encoder.js";
 export * from "./message/midi-message.js";
+export * from "./timeline/compose-midi-karaoke.js";
+export * from "./timeline/compose-midi-notes.js";
 export * from "./timeline/compose-midi-timeline.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qCAAqC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,qCAAqC,CAAC;AACpD,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC"}

package/dist/song/compose-midi-song.d.ts

@@ -0,0 +1,55 @@
+import { type Song } from "@ac-kit/model-music";
+import { type MidiTextEncoding } from "../file/detect-midi-text-encoding.js";
+import type { MidiFile } from "../file/midi-file.js";
+/** Options of {@link composeMidiSong}. */
+export type ComposeMidiSongOptions = {
+    /**
+     * The encoding of the file's text; detected with `detectMidiTextEncoding`
+     * when omitted.
+     */
+    encoding?: MidiTextEncoding;
+    /**
+     * Which track of a format 2 file to read, each being a song of its own: 0 by
+     * default. Ignored for formats 0 and 1.
+     */
+    sequence?: number;
+};
+/**
+ * Converts a Standard MIDI File into a `Song` of `@ac-kit/model-music`: every
+ * note with its start and end in ticks and seconds, under one tempo map, with
+ * parts, meter, key, measures, pedals, markers and lyrics.
+ *
+ * Use it to read a file as music; use {@link composeMidiTimeline} and
+ * {@link composeMidiNotes} for its events as stored.
+ *
+ * - **Parts**: one per track and channel carrying notes, in the order they first
+ *   sound. Each is named by its track's name and given the channel's last
+ *   program change before its first note; channel 10 is percussion.
+ * - **Title**: the karaoke `@T` title, else the name of track 0 (of the sequence,
+ *   for format 2).
+ * - **Time**: a metrical file keeps its ticks and its Set Tempo events. An
+ *   SMPTE-timed file is given 480 ticks per quarter note and the one tempo that
+ *   keeps every event at its time.
+ * - **Measures** come from the time signatures, 4/4 before the first; a time
+ *   signature of numerator 0 is skipped.
+ * - **Pedals**: sustain (CC 64), sostenuto (CC 66) and soft (CC 67) on a channel
+ *   with notes, as 0–1.
+ * - **Lyrics**: the syllables of a Soft Karaoke file, else the `lyric` meta
+ *   events. **Markers**: `marker` and `cuePoint` meta events.
+ *
+ * Time complexity: O(n log n) in the number of events, for the timeline's sort.
+ * Memory: O(n).
+ *
+ * @example
+ * 	composeMidiSong(parseMidiFile(bytes)).notes[0];
+ * 	// { part: 0, staff: undefined, voice: undefined, pitch: 48, velocity: 96,
+ * 	//   startTick: 0, endTick: 384, startSeconds: 0, endSeconds: 2 }
+ *
+ * @param file - A parsed file.
+ * @param options - The text encoding and, for format 2, the sequence.
+ * @returns The song.
+ * @throws {RangeError} When `options.sequence` names no track of a format 2
+ *   file.
+ */
+export declare function composeMidiSong(file: MidiFile, options?: ComposeMidiSongOptions): Song;
+//# sourceMappingURL=compose-midi-song.d.ts.map

package/dist/song/compose-midi-song.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-midi-song.d.ts","sourceRoot":"","sources":["../../src/song/compose-midi-song.ts"],"names":[],"mappings":"AACA,OAAO,EAKN,KAAK,IAAI,EAST,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAEN,KAAK,gBAAgB,EACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQrD,0CAA0C;AAC1C,MAAM,MAAM,sBAAsB,GAAG;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAaF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE,sBAAsB,GAC9B,IAAI,CAoKN"}

package/dist/song/compose-midi-song.js

@@ -0,0 +1,250 @@
+import { decodeText } from "@ac-kit/core";
+import { composeMeasures, composeTempoMap, tempoMapSeconds, } from "@ac-kit/model-music";
+import { timecodeTicksPerSecond_ } from "../file/_time-division.js";
+import { detectMidiTextEncoding, } from "../file/detect-midi-text-encoding.js";
+import { composeMidiKaraoke } from "../timeline/compose-midi-karaoke.js";
+import { composeMidiNotes } from "../timeline/compose-midi-notes.js";
+import { composeMidiTimeline, } from "../timeline/compose-midi-timeline.js";
+// The resolution given to an SMPTE-timed file, whose ticks have no musical length.
+const TIMECODE_TICKS_PER_QUARTER_NOTE_ = 480;
+const PEDAL_CONTROLLERS_ = new Map([
+    [64, "sustain"],
+    [66, "sostenuto"],
+    [67, "soft"],
+]);
+const PERCUSSION_CHANNEL_ = 9;
+/**
+ * Converts a Standard MIDI File into a `Song` of `@ac-kit/model-music`: every
+ * note with its start and end in ticks and seconds, under one tempo map, with
+ * parts, meter, key, measures, pedals, markers and lyrics.
+ *
+ * Use it to read a file as music; use {@link composeMidiTimeline} and
+ * {@link composeMidiNotes} for its events as stored.
+ *
+ * - **Parts**: one per track and channel carrying notes, in the order they first
+ *   sound. Each is named by its track's name and given the channel's last
+ *   program change before its first note; channel 10 is percussion.
+ * - **Title**: the karaoke `@T` title, else the name of track 0 (of the sequence,
+ *   for format 2).
+ * - **Time**: a metrical file keeps its ticks and its Set Tempo events. An
+ *   SMPTE-timed file is given 480 ticks per quarter note and the one tempo that
+ *   keeps every event at its time.
+ * - **Measures** come from the time signatures, 4/4 before the first; a time
+ *   signature of numerator 0 is skipped.
+ * - **Pedals**: sustain (CC 64), sostenuto (CC 66) and soft (CC 67) on a channel
+ *   with notes, as 0–1.
+ * - **Lyrics**: the syllables of a Soft Karaoke file, else the `lyric` meta
+ *   events. **Markers**: `marker` and `cuePoint` meta events.
+ *
+ * Time complexity: O(n log n) in the number of events, for the timeline's sort.
+ * Memory: O(n).
+ *
+ * @example
+ * 	composeMidiSong(parseMidiFile(bytes)).notes[0];
+ * 	// { part: 0, staff: undefined, voice: undefined, pitch: 48, velocity: 96,
+ * 	//   startTick: 0, endTick: 384, startSeconds: 0, endSeconds: 2 }
+ *
+ * @param file - A parsed file.
+ * @param options - The text encoding and, for format 2, the sequence.
+ * @returns The song.
+ * @throws {RangeError} When `options.sequence` names no track of a format 2
+ *   file.
+ */
+export function composeMidiSong(file, options) {
+    const encoding = options?.encoding ?? detectMidiTextEncoding(file);
+    const sequence = options?.sequence ?? 0;
+    const timeline = selectSequence_(composeMidiTimeline(file), file, sequence);
+    const tempoMap = composeTempoMap_(file, timeline);
+    const secondsAt = (tick) => tempoMapSeconds(tempoMap, tick);
+    const midiNotes = composeMidiNotes(timeline);
+    const trackNames = new Map();
+    const programs = new Map();
+    const firstPrograms = new Map();
+    const partIndices = new Map();
+    const parts = [];
+    const timeSignatures = [];
+    const keySignatures = [];
+    const markers = [];
+    const lyricEvents = [];
+    let endTick = 0;
+    for (const { trackIndex, tick, event } of timeline) {
+        endTick = Math.max(endTick, tick);
+        if (event.kind === "channel") {
+            if (event.message.type === "programChange") {
+                programs.set(partKey_(trackIndex, event.message.channel), event.message.program);
+            }
+            else if (event.message.type === "noteOn" &&
+                event.message.velocity > 0) {
+                const key = partKey_(trackIndex, event.message.channel);
+                if (!partIndices.has(key)) {
+                    partIndices.set(key, partIndices.size);
+                    const program = programs.get(key);
+                    if (program !== undefined) {
+                        firstPrograms.set(key, program);
+                    }
+                }
+            }
+            continue;
+        }
+        if (event.kind !== "meta") {
+            continue;
+        }
+        const { meta } = event;
+        switch (meta.type) {
+            case "trackName":
+                if (!trackNames.has(trackIndex)) {
+                    trackNames.set(trackIndex, decodeText(meta.data, encoding));
+                }
+                break;
+            case "timeSignature":
+                if (meta.numerator >= 1) {
+                    pushAtTick_(timeSignatures, {
+                        tick,
+                        numerator: meta.numerator,
+                        denominator: 2 ** meta.denominatorPower,
+                    });
+                }
+                break;
+            case "keySignature":
+                pushAtTick_(keySignatures, {
+                    tick,
+                    fifths: meta.sharpsFlats,
+                    mode: meta.minor ? "minor" : "major",
+                });
+                break;
+            case "marker":
+            case "cuePoint":
+                markers.push({
+                    tick,
+                    seconds: secondsAt(tick),
+                    text: decodeText(meta.data, encoding),
+                    kind: meta.type === "marker" ? "marker" : "cue",
+                });
+                break;
+            case "lyric":
+                lyricEvents.push({
+                    part: undefined,
+                    tick,
+                    seconds: secondsAt(tick),
+                    text: decodeText(meta.data, encoding),
+                    break: "none",
+                });
+                break;
+            default:
+                // Tempo is read by composeTempoMap_; the other meta events carry nothing a Song holds.
+                break;
+        }
+    }
+    for (const [key, part] of partIndices) {
+        const trackIndex = Math.floor(key / 16);
+        const channel = key % 16;
+        parts[part] = {
+            name: trackNames.get(trackIndex),
+            program: firstPrograms.get(key),
+            percussion: channel === PERCUSSION_CHANNEL_,
+            staves: 1,
+        };
+    }
+    const notes = midiNotes.map((note) => {
+        endTick = Math.max(endTick, note.endTick);
+        return {
+            part: partIndices.get(partKey_(note.trackIndex, note.channel)),
+            staff: undefined,
+            voice: undefined,
+            pitch: note.note,
+            velocity: note.velocity,
+            startTick: note.startTick,
+            endTick: note.endTick,
+            startSeconds: secondsAt(note.startTick),
+            endSeconds: secondsAt(note.endTick),
+        };
+    });
+    notes.sort((a, b) => a.startTick - b.startTick || a.pitch - b.pitch);
+    const pedals = [];
+    for (const { trackIndex, tick, event } of timeline) {
+        if (event.kind !== "channel" || event.message.type !== "controlChange") {
+            continue;
+        }
+        const pedal = PEDAL_CONTROLLERS_.get(event.message.controller);
+        const part = partIndices.get(partKey_(trackIndex, event.message.channel));
+        if (pedal !== undefined && part !== undefined) {
+            pedals.push({
+                part,
+                tick,
+                seconds: secondsAt(tick),
+                pedal,
+                value: event.message.value / 127,
+            });
+        }
+    }
+    const karaoke = composeMidiKaraoke(timeline, encoding);
+    const lyrics = karaoke?.syllables.map(({ tick, text, break: lineBreak }) => ({
+        part: undefined,
+        tick,
+        seconds: secondsAt(tick),
+        text,
+        break: lineBreak,
+    })) ?? lyricEvents;
+    return {
+        title: karaoke?.titles[0] ?? trackNames.get(file.format === 2 ? sequence : 0),
+        tempoMap,
+        endTick,
+        endSeconds: secondsAt(endTick),
+        parts,
+        notes,
+        timeSignatures,
+        keySignatures,
+        measures: composeMeasures(timeSignatures, tempoMap, endTick),
+        markers,
+        pedals,
+        lyrics,
+    };
+}
+function partKey_(trackIndex, channel) {
+    return trackIndex * 16 + channel;
+}
+// Several signatures at one tick: the last one stands, as for a tempo.
+function pushAtTick_(items, item) {
+    if (items.at(-1)?.tick === item.tick) {
+        items[items.length - 1] = item;
+    }
+    else {
+        items.push(item);
+    }
+}
+function selectSequence_(timeline, file, sequence) {
+    if (file.format !== 2) {
+        return timeline;
+    }
+    if (!(Number.isInteger(sequence) &&
+        sequence >= 0 &&
+        sequence < file.tracks.length)) {
+        throw new RangeError(`sequence ${sequence} is not a track of this ${file.tracks.length}-track file`);
+    }
+    return timeline.filter(({ trackIndex }) => trackIndex === sequence);
+}
+function composeTempoMap_(file, timeline) {
+    const division = file.timeDivision;
+    if (division.type === "timecode") {
+        return composeTempoMap(TIMECODE_TICKS_PER_QUARTER_NOTE_, [
+            {
+                tick: 0,
+                microsecondsPerQuarterNote: (1000000 * TIMECODE_TICKS_PER_QUARTER_NOTE_) /
+                    timecodeTicksPerSecond_(division),
+            },
+        ]);
+    }
+    const marks = [];
+    for (const { tick, event } of timeline) {
+        if (event.kind === "meta" &&
+            event.meta.type === "setTempo" &&
+            event.meta.microsecondsPerQuarterNote > 0) {
+            marks.push({
+                tick,
+                microsecondsPerQuarterNote: event.meta.microsecondsPerQuarterNote,
+            });
+        }
+    }
+    return composeTempoMap(division.ticksPerQuarterNote, marks);
+}
+//# sourceMappingURL=compose-midi-song.js.map

package/dist/song/compose-midi-song.js.map

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

package/dist/song/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./compose-midi-song.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/song/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/song/index.js

@@ -0,0 +1,2 @@
+export * from "./compose-midi-song.js";
+//# sourceMappingURL=index.js.map

package/dist/song/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/song/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/timeline/compose-midi-karaoke.d.ts

@@ -0,0 +1,61 @@
+import type { MidiTextEncoding } from "../file/detect-midi-text-encoding.js";
+import type { MidiTimelineEvent } from "./compose-midi-timeline.js";
+/** One lyric syllable of a karaoke file, at the time it is sung. */
+export type MidiKaraokeSyllable = {
+    trackIndex: number;
+    tick: number;
+    seconds: number;
+    /** The syllable without its break mark; spaces between words included. */
+    text: string;
+    /**
+     * What comes before the syllable: `paragraph` for a `\` mark (a new screen),
+     * `line` for a `/` mark, `none` otherwise.
+     */
+    break: "none" | "line" | "paragraph";
+};
+/** The lyrics and tags of a Soft Karaoke (`.kar`) file. */
+export type MidiKaraoke = {
+    /** The `@V` tag: the format version, `0100` for 1.0. */
+    version: string | undefined;
+    /** The `@L` tag: the lyrics' language, such as `ENGL`. */
+    language: string | undefined;
+    /**
+     * The `@T` tags in order: by convention the title, the performer, then who
+     * sequenced it.
+     */
+    titles: string[];
+    /** The `@I` tags in order: free information lines. */
+    infos: string[];
+    syllables: MidiKaraokeSyllable[];
+};
+/**
+ * Reads the lyrics of a Soft Karaoke file, the `.kar` convention that carries
+ * them as text events with `@`-prefixed tags.
+ *
+ * Use it on files that carry `@K` (`@KMIDI KARAOKE FILE`); for lyrics stored as
+ * `lyric` meta events, read those from the timeline directly.
+ *
+ * - The tags are text events starting with `@K`, `@V`, `@L`, `@T` or `@I`, in any
+ *   track.
+ * - The syllables are the other text events of the lyrics track: the track
+ *   holding the first `@L` or `@T` tag, or else the track with the most
+ *   untagged text events.
+ * - A syllable starting with `\` opens a paragraph and one starting with `/`
+ *   opens a line; the mark is removed from `text`.
+ *
+ * Time complexity: O(n) in `timeline.length`. Memory: O(k) in the number of
+ * text events.
+ *
+ * @example
+ * 	composeMidiKaraoke(composeMidiTimeline(file), "windows-1252")?.titles;
+ * 	// ["Twinkle, Twinkle", "Traditional"]
+ *
+ * @param timeline - A file's events in playing order, from
+ *   {@link composeMidiTimeline}.
+ * @param encoding - The file's text encoding, typically from
+ *   {@link detectMidiTextEncoding}.
+ * @returns The karaoke content, or `undefined` when no `@K` tag marks the file
+ *   as Soft Karaoke.
+ */
+export declare function composeMidiKaraoke(timeline: readonly MidiTimelineEvent[], encoding: MidiTextEncoding): MidiKaraoke | undefined;
+//# sourceMappingURL=compose-midi-karaoke.d.ts.map

package/dist/timeline/compose-midi-karaoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-midi-karaoke.d.ts","sourceRoot":"","sources":["../../src/timeline/compose-midi-karaoke.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,oEAAoE;AACpE,MAAM,MAAM,mBAAmB,GAAG;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;CACrC,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG;IACzB,wDAAwD;IACxD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B;;;OAGG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sDAAsD;IACtD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,mBAAmB,EAAE,CAAC;CACjC,CAAC;AAIF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,EACtC,QAAQ,EAAE,gBAAgB,GACxB,WAAW,GAAG,SAAS,CAyDzB"}

package/dist/timeline/compose-midi-karaoke.js

@@ -0,0 +1,98 @@
+import { maxBy } from "@ac-kit/algo";
+import { decodeText } from "@ac-kit/core";
+const TAG_PATTERN_ = /^@([KVLTI])(.*)$/su;
+/**
+ * Reads the lyrics of a Soft Karaoke file, the `.kar` convention that carries
+ * them as text events with `@`-prefixed tags.
+ *
+ * Use it on files that carry `@K` (`@KMIDI KARAOKE FILE`); for lyrics stored as
+ * `lyric` meta events, read those from the timeline directly.
+ *
+ * - The tags are text events starting with `@K`, `@V`, `@L`, `@T` or `@I`, in any
+ *   track.
+ * - The syllables are the other text events of the lyrics track: the track
+ *   holding the first `@L` or `@T` tag, or else the track with the most
+ *   untagged text events.
+ * - A syllable starting with `\` opens a paragraph and one starting with `/`
+ *   opens a line; the mark is removed from `text`.
+ *
+ * Time complexity: O(n) in `timeline.length`. Memory: O(k) in the number of
+ * text events.
+ *
+ * @example
+ * 	composeMidiKaraoke(composeMidiTimeline(file), "windows-1252")?.titles;
+ * 	// ["Twinkle, Twinkle", "Traditional"]
+ *
+ * @param timeline - A file's events in playing order, from
+ *   {@link composeMidiTimeline}.
+ * @param encoding - The file's text encoding, typically from
+ *   {@link detectMidiTextEncoding}.
+ * @returns The karaoke content, or `undefined` when no `@K` tag marks the file
+ *   as Soft Karaoke.
+ */
+export function composeMidiKaraoke(timeline, encoding) {
+    let isKaraoke = false;
+    const karaoke = {
+        version: undefined,
+        language: undefined,
+        titles: [],
+        infos: [],
+        syllables: [],
+    };
+    let lyricsTrack;
+    const untagged = [];
+    const untaggedCounts = new Map();
+    for (const { trackIndex, tick, seconds, event } of timeline) {
+        if (event.kind !== "meta" || event.meta.type !== "text") {
+            continue;
+        }
+        const text = decodeText(event.meta.data, encoding);
+        const tag = TAG_PATTERN_.exec(text);
+        if (tag === null) {
+            untagged.push(composeSyllable_(trackIndex, tick, seconds, text));
+            untaggedCounts.set(trackIndex, (untaggedCounts.get(trackIndex) ?? 0) + 1);
+            continue;
+        }
+        const value = tag[2];
+        switch (tag[1]) {
+            case "K":
+                isKaraoke = true;
+                break;
+            case "V":
+                karaoke.version ??= value;
+                break;
+            case "L":
+                karaoke.language ??= value;
+                lyricsTrack ??= trackIndex;
+                break;
+            case "T":
+                karaoke.titles.push(value);
+                lyricsTrack ??= trackIndex;
+                break;
+            default:
+                karaoke.infos.push(value);
+        }
+    }
+    if (!isKaraoke) {
+        return undefined;
+    }
+    lyricsTrack ??= maxBy(untaggedCounts, ([, count]) => count)?.[0];
+    karaoke.syllables = untagged.filter(({ trackIndex }) => trackIndex === lyricsTrack);
+    return karaoke;
+}
+function composeSyllable_(trackIndex, tick, seconds, text) {
+    if (text.startsWith("\\")) {
+        return {
+            trackIndex,
+            tick,
+            seconds,
+            text: text.slice(1),
+            break: "paragraph",
+        };
+    }
+    if (text.startsWith("/")) {
+        return { trackIndex, tick, seconds, text: text.slice(1), break: "line" };
+    }
+    return { trackIndex, tick, seconds, text, break: "none" };
+}
+//# sourceMappingURL=compose-midi-karaoke.js.map

package/dist/timeline/compose-midi-karaoke.js.map

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

package/dist/timeline/compose-midi-notes.d.ts

@@ -0,0 +1,54 @@
+import type { MidiTimelineEvent } from "./compose-midi-timeline.js";
+/** A sounding note of a Standard MIDI File: a note-on paired with its release. */
+export type MidiNote = {
+    /** Index of the track the note-on came from. */
+    trackIndex: number;
+    /** 0–15. */
+    channel: number;
+    /** 0–127; 60 is middle C. */
+    note: number;
+    /** The note-on velocity, 1–127. */
+    velocity: number;
+    /**
+     * The note-off velocity, 0–127, or `undefined` when the note was released by
+     * a note-on of velocity 0 or by the end of its track.
+     */
+    releaseVelocity: number | undefined;
+    startTick: number;
+    endTick: number;
+    startSeconds: number;
+    endSeconds: number;
+};
+/**
+ * Pairs every note-on of a timeline with the release that ends it, giving each
+ * note its start and end in ticks and in seconds — what a piano roll, a
+ * practice tool or a converter to notation reads, rather than raw events.
+ *
+ * Use {@link composeMidiTimeline} directly when the other events matter as they
+ * are, controllers and the sustain pedal included: this keeps note events only,
+ * and does not lengthen a note held by the pedal.
+ *
+ * - A release is a `noteOff` or a `noteOn` of velocity 0 on the same track,
+ *   channel and note number.
+ * - A note struck again before its release stays open beside the first, and
+ *   releases close them first in, first out.
+ * - A note never released ends where its track ends: its End of Track event, or
+ *   its last event when it has none.
+ * - A release with no open note is ignored.
+ *
+ * Time complexity: O(n) in `timeline.length`. Memory: O(m) in the number of
+ * notes.
+ *
+ * @example
+ * 	// RP-001's format 0 example, 96 ticks per quarter note at 120 bpm:
+ * 	composeMidiNotes(composeMidiTimeline(file))[0];
+ * 	// { trackIndex: 0, channel: 2, note: 48, velocity: 96, releaseVelocity: 64,
+ * 	//   startTick: 0, endTick: 384, startSeconds: 0, endSeconds: 2 }
+ *
+ * @param timeline - A file's events in playing order, from
+ *   {@link composeMidiTimeline}.
+ * @returns The notes in the order of their note-ons in `timeline`: by start for
+ *   formats 0 and 1, track after track for format 2.
+ */
+export declare function composeMidiNotes(timeline: readonly MidiTimelineEvent[]): MidiNote[];
+//# sourceMappingURL=compose-midi-notes.d.ts.map

package/dist/timeline/compose-midi-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-midi-notes.d.ts","sourceRoot":"","sources":["../../src/timeline/compose-midi-notes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG;IACtB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAQF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GACpC,QAAQ,EAAE,CAgEZ"}

package/dist/timeline/compose-midi-notes.js

@@ -0,0 +1,97 @@
+import { isMidiNoteRelease } from "../message/is-midi-note-release.js";
+function noteKey_(trackIndex, channel, note) {
+    return (trackIndex * 16 + channel) * 128 + note;
+}
+/**
+ * Pairs every note-on of a timeline with the release that ends it, giving each
+ * note its start and end in ticks and in seconds — what a piano roll, a
+ * practice tool or a converter to notation reads, rather than raw events.
+ *
+ * Use {@link composeMidiTimeline} directly when the other events matter as they
+ * are, controllers and the sustain pedal included: this keeps note events only,
+ * and does not lengthen a note held by the pedal.
+ *
+ * - A release is a `noteOff` or a `noteOn` of velocity 0 on the same track,
+ *   channel and note number.
+ * - A note struck again before its release stays open beside the first, and
+ *   releases close them first in, first out.
+ * - A note never released ends where its track ends: its End of Track event, or
+ *   its last event when it has none.
+ * - A release with no open note is ignored.
+ *
+ * Time complexity: O(n) in `timeline.length`. Memory: O(m) in the number of
+ * notes.
+ *
+ * @example
+ * 	// RP-001's format 0 example, 96 ticks per quarter note at 120 bpm:
+ * 	composeMidiNotes(composeMidiTimeline(file))[0];
+ * 	// { trackIndex: 0, channel: 2, note: 48, velocity: 96, releaseVelocity: 64,
+ * 	//   startTick: 0, endTick: 384, startSeconds: 0, endSeconds: 2 }
+ *
+ * @param timeline - A file's events in playing order, from
+ *   {@link composeMidiTimeline}.
+ * @returns The notes in the order of their note-ons in `timeline`: by start for
+ *   formats 0 and 1, track after track for format 2.
+ */
+export function composeMidiNotes(timeline) {
+    const notes = [];
+    const openNotes = new Map();
+    const trackEnds = new Map();
+    for (const { trackIndex, tick, seconds, event } of timeline) {
+        // A track's events reach the timeline in tick order, so its last one ends it.
+        const trackEnd = trackEnds.get(trackIndex);
+        if (trackEnd === undefined) {
+            trackEnds.set(trackIndex, { tick, seconds });
+        }
+        else {
+            trackEnd.tick = tick;
+            trackEnd.seconds = seconds;
+        }
+        if (event.kind !== "channel") {
+            continue;
+        }
+        const { message } = event;
+        if (message.type !== "noteOn" && message.type !== "noteOff") {
+            continue;
+        }
+        const key = noteKey_(trackIndex, message.channel, message.note);
+        if (isMidiNoteRelease(message)) {
+            const note = openNotes.get(key)?.shift();
+            if (note !== undefined) {
+                note.endTick = tick;
+                note.endSeconds = seconds;
+                note.releaseVelocity =
+                    message.type === "noteOff" ? message.velocity : undefined;
+            }
+            continue;
+        }
+        const note = {
+            trackIndex,
+            channel: message.channel,
+            note: message.note,
+            velocity: message.velocity,
+            releaseVelocity: undefined,
+            startTick: tick,
+            endTick: tick,
+            startSeconds: seconds,
+            endSeconds: seconds,
+        };
+        notes.push(note);
+        const queue = openNotes.get(key);
+        if (queue === undefined) {
+            openNotes.set(key, [note]);
+        }
+        else {
+            queue.push(note);
+        }
+    }
+    for (const queue of openNotes.values()) {
+        for (const note of queue) {
+            const trackEnd = trackEnds.get(note.trackIndex);
+            note.endTick = trackEnd.tick;
+            note.endSeconds = trackEnd.seconds;
+        }
+    }
+    return notes;
+}
+//# sourceMappingURL=compose-midi-notes.js.map

package/dist/timeline/compose-midi-notes.js.map

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

package/dist/timeline/compose-midi-timeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose-midi-timeline.d.ts","sourceRoot":"","sources":["../../src/timeline/compose-midi-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,QAAQ,EACR,aAAa,EAEb,MAAM,sBAAsB,CAAC;AAE9B,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,GAAG;IAC/B,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,CAAC;CACrB,CAAC;AA2DF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB,EAAE,CAqBvE"}
+{"version":3,"file":"compose-midi-timeline.d.ts","sourceRoot":"","sources":["../../src/timeline/compose-midi-timeline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,QAAQ,EACR,aAAa,EAEb,MAAM,sBAAsB,CAAC;AAE9B,uEAAuE;AACvE,MAAM,MAAM,iBAAiB,GAAG;IAC/B,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,CAAC;CACrB,CAAC;AAuDF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB,EAAE,CAqBvE"}

package/dist/timeline/compose-midi-timeline.js

@@ -1,3 +1,4 @@
+import { timecodeTicksPerSecond_ } from "../file/_time-division.js";
 /** RP-001: a file with no Set Tempo event before a tick plays at 120 bpm. */
 const DEFAULT_TEMPO_ = 500000;
 function appendTrackEvents_(target, file, trackIndex) {
@@ -14,10 +15,7 @@ function appendTrackEvents_(target, file, trackIndex) {
  */
 function assignSeconds_(events, from, division) {
     if (division.type === "timecode") {
-        const framesPerSecond = division.framesPerSecond === 29
-            ? 30000 / 1001
-            : division.framesPerSecond;
-        const ticksPerSecond = framesPerSecond * division.ticksPerFrame;
+        const ticksPerSecond = timecodeTicksPerSecond_(division);
         for (let index = from; index < events.length; index++) {
             events[index].seconds = events[index].tick / ticksPerSecond;
         }

package/dist/timeline/compose-midi-timeline.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ac-kit/format-midi",
-  "version": "0.1.1",
-  "description": "MIDI 1.0: the message model with a live byte-stream Decoder/Encoder, Standard MIDI File parse/print, and tick-to-seconds timelines.",
+  "version": "0.2.1",
+  "description": "MIDI 1.0: the message model with a live byte-stream Decoder/Encoder, Standard MIDI File parse/print, tick-to-seconds timelines, notes, text decoding, and conversion to a model-music Song.",
   "keywords": [
     "midi",
     "midi-file",
@@ -27,12 +27,14 @@
   "sideEffects": false,
   "main": "./dist/index.js",
   "exports": {
-    ".": "./dist/index.js"
+    ".": "./dist/index.js",
+    "./song": "./dist/song/index.js"
   },
   "publishConfig": {
     "main": "./dist/index.js",
     "exports": {
-      ".": "./dist/index.js"
+      ".": "./dist/index.js",
+      "./song": "./dist/song/index.js"
     },
     "access": "public"
   },
@@ -45,9 +47,11 @@
     "prepack": "yarn build"
   },
   "dependencies": {
-    "@ac-kit/core": "^0.3.0",
-    "@ac-kit/format-core": "^0.1.3",
-    "@ac-kit/format-varint": "^0.1.2",
+    "@ac-kit/algo": "^0.2.2",
+    "@ac-kit/core": "^0.5.0",
+    "@ac-kit/format-core": "^0.1.5",
+    "@ac-kit/format-varint": "^0.1.4",
+    "@ac-kit/model-music": "^0.1.1",
     "@types/web": "^0.0.359"
   },
   "devDependencies": {