@onjmin/dtm 2.0.2 → 2.0.3

package/dist/index.d.ts

@@ -57,6 +57,151 @@ type ChordPlayerInstance = {
  */
 declare const mountChordPlayer: (target: HTMLElement, chords: string, options?: MountChordPlayerOptions) => ChordPlayerInstance;
 
+/**
+ * 音律（12平均律 / 31平均律）と、ピッチの内部表現。
+ *
+ * ## 単位
+ *
+ * ノートのピッチは **1/372オクターブの整数** で持つ。372 = 12 × 31 で、12と31は
+ * 互いに素なので最小公倍数がこれになり、**12平均律と31平均律の両方が誤差ゼロで
+ * 同じ数直線に乗る**。
+ *
+ *   12平均律 1半音 = 31 units
+ *   31平均律 1度   = 12 units
+ *   1 unit = 1200/372 ≒ 3.2258 セント
+ *
+ * 整数のままなので `a.pitchUnits === b.pitchUnits` の同値判定が全部生き残る
+ * （重複判定・当たり判定・協調編集の (startStep, pitchUnits) キー）。小数にすると
+ * ここが軒並み壊れるため、細かい整数単位を選んでいる。
+ *
+ * ## 音律は音声経路に入らない
+ *
+ * ピッチが絶対値なので、シーケンサも発音器も音律を知らなくてよい。音律は
+ * 「格子・記譜・表示」だけに効く編集上の概念で、`RenderConfig.edo` に置く。
+ */
+/**
+ * ピッチの単位を型で区別するためのブランド。
+ *
+ * `Units` と `MidiNote` はどちらも実体は number だが、互いに代入できない。
+ * これは「半音の数値を units のつもりで使う」「units を SoundFont の
+ * MIDIノート番号として渡す」といった取り違えを**コンパイラに検出させる**ため。
+ * 単位の取り違えは型が同じ number である限り一切検出できず、実際に
+ * 「楽器音が無音」「オクターブユニゾンが0.4半音ずれる」「多音階音源のサンプル
+ * 選択が常に最高音になる」といった不具合を作り込んだ。
+ *
+ * 生の number から作るときは {@link units} / {@link midiNote} を通す。
+ * 変換は {@link midiToUnits} / {@link unitsToMidi} など、この module の関数に集約する。
+ */
+declare const UNITS_BRAND: unique symbol;
+declare const MIDI_BRAND: unique symbol;
+/** ピッチ。1/372オクターブの整数。 */
+type Units = number & {
+    readonly [UNITS_BRAND]: true;
+};
+/** MIDIノート番号（半音）。0-127。SoundFont のゾーン選択やMIDI入出力で使う。 */
+type MidiNote = number & {
+    readonly [MIDI_BRAND]: true;
+};
+/** 生の数値を units として扱う。単位が units であると確信できる箇所だけで使う。 */
+declare const units: (n: number) => Units;
+/** 生の数値をMIDIノート番号として扱う。MIDI入出力の境界だけで使う。 */
+declare const midiNote: (n: number) => MidiNote;
+/** units 同士・units と生の差分の加算。結果も units。 */
+declare const addUnits: (a: Units, delta: number) => Units;
+/** 1オクターブあたりの units。12 × 31。 */
+declare const UNITS_PER_OCTAVE = 372;
+/** 12平均律の1半音あたりの units。 */
+declare const UNITS_PER_SEMITONE: number;
+/** 31平均律の1度あたりの units。 */
+declare const UNITS_PER_EDO31_DEGREE: number;
+/** 1 unit のセント値。 */
+declare const CENTS_PER_UNIT: number;
+/** A4 (MIDI 69) の units。周波数計算の基準。 */
+declare const A4_UNITS: Units;
+/** A4 の周波数(Hz)。 */
+declare const A4_HZ = 440;
+/** 対応する音律（1オクターブの分割数）。 */
+type Edo = 12 | 31;
+/** 既定の音律。宣言のない曲はすべてこれ（＝既存データは素通り）。 */
+declare const DEFAULT_EDO: Edo;
+/** その音律の1格子ステップが何 units か。 */
+declare const unitsPerStep: (edo: Edo) => number;
+/** MIDIノート番号 → units。 */
+declare const midiToUnits: (midi: MidiNote | number) => Units;
+/**
+ * units → MIDIノート番号（小数）。
+ * 歌声合成（koe）は Hz を受けるためこの小数値をそのまま渡してよい。
+ * SoundFont のように整数ゾーンしか持たない発音器は {@link unitsToMidiDetune} を使う。
+ */
+declare const unitsToMidi: (u: Units) => number;
+/** units → 周波数(Hz)。 */
+declare const unitsToHz: (u: Units) => number;
+/**
+ * units → 「最寄りの整数MIDIノート番号 + セント補正」。
+ *
+ * SoundFont は音高ごとに整数キーでゾーンを持つため小数ピッチを直接鳴らせない。
+ * 最寄りのゾーンを鳴らして残差を `AudioBufferSourceNode.detune` で補正する。
+ * 31平均律での残差は最大 ±48.4 セントで、detune の可動域に十分収まる。
+ */
+declare const unitsToMidiDetune: (u: Units) => {
+    midi: MidiNote;
+    detuneCents: number;
+};
+/**
+ * 臨時記号1つあたりの格子ステップ数。
+ *
+ * - `#` / `+`(12平均律) … クロマチック半音上げ
+ * - `-` … クロマチック半音下げ
+ * - `+`(31平均律) … 格子1ステップ上げ（微分音）
+ * - `_` … 格子1ステップ下げ（微分音）
+ *
+ * 12平均律ではクロマチック半音＝1格子ステップなので4記号すべてが従来の意味に潰れ、
+ * 既存MMLの解釈は1文字も変わらない。31平均律でのみ `#`/`-`（±2度）と
+ * `+`/`_`（±1度）が分岐する。
+ */
+declare const chromaticStep: (edo: Edo) => number;
+/** 微分音記号 `+` / `_` 1つあたりの格子ステップ数。常に1。 */
+declare const MICRO_STEP = 1;
+/** 幹音の文字か。 */
+declare const isNaturalLetter: (ch: string) => boolean;
+/** 幹音の文字 → オクターブ内の格子ステップ。未知の文字は null。 */
+declare const naturalStep: (ch: string, edo: Edo) => number | null;
+/**
+ * 音名・オクターブ・臨時記号から units を組み立てる。
+ *
+ * `octave` はMMLの `o` 指定（MIDI慣習で o4 の c が中央ド = MIDI 60）。
+ * 臨時記号でオクターブを跨ぐ綴り（`b##` が次オクターブへ、`c--` が前オクターブへ）も
+ * そのまま加算されるので、度数を 0〜edo-1 にクランプしてはいけない。
+ */
+declare const spellingToUnits: (letter: string, octave: number, chromatic: number, micro: number, edo: Edo) => number | null;
+/**
+ * 五度圏インデックス（C=0, G=1, F=-1, C#=7, Db=-5）→ オクターブ内の格子ステップ。
+ *
+ * ミーントーン系の音律はすべて「五度を何ステップとするか」だけで決まるため、
+ * 綴りを持つ音（chord-parser の `rootFifth` / `noteFifths` など）はこの一本で
+ * どちらの音律へも正確に写せる。12平均律では C# と Db が同じ値に潰れ、
+ * 31平均律では 2 と 3 に分かれる。
+ */
+declare const fifthToStep: (fifthIndex: number, edo: Edo) => number;
+/** 五度圏インデックス → オクターブ内の units。 */
+declare const fifthToUnits: (fifthIndex: number, edo: Edo) => number;
+/**
+ * ピッチ表現のバージョン。
+ *
+ * - v1 … `pitch` が半音（MIDIノート番号）。dtm 1.x
+ * - v2 … `pitchUnits` が 1/372オクターブ単位。dtm 2.x
+ *
+ * dtm 自身は通信路を持たず `onNotesPatch` / `applyPatch` のフックを出すだけなので、
+ * バージョンの突き合わせは利用側アプリのハンドシェイクの責務になる。変換の知識だけを
+ * ここに置く。v1→v2 は無損失だが、**v2→v1 は12平均律の曲でしか成立しない**
+ * （31平均律を半音へ丸めると最大48.4セント動く）。
+ */
+declare const PITCH_ENCODING_VERSION = 2;
+/** v1（半音）→ v2（units）。無損失。 */
+declare const pitchV1ToUnits: (pitch: number) => Units;
+/** v2（units）→ v1（半音）。12平均律の曲でのみ無損失。 */
+declare const unitsToPitchV1: (u: Units) => number;
+
 /**
  * コード進行文字列を伴奏トラックのノート配置へ展開する。
  *
@@ -64,6 +209,7 @@ declare const mountChordPlayer: (target: HTMLElement, chords: string, options?:
  * 旧 demo/index.html の applyChordProgression を移植・整理し、
  * 実際のノート追加を行わず配置（placement）の配列を返す純関数にした。
  */
+
 type ChordPatternType = "block" | "arpeggio" | "arpeggio-fast" | "offbeat" | "yatsume" | "alternating";
 type ChordPlacement = {
     startStep: number;
@@ -71,7 +217,7 @@ type ChordPlacement = {
      * 1/372オクターブ単位。chord-parser が返すのは12平均律の半音なので、
      * ここへ入れる時点で音律に応じた格子へ写している。
      */
-    pitchUnits: number;
+    pitchUnits: Units;
     durationSteps: number;
     velocity: number;
 };
@@ -419,7 +565,7 @@ type StreamVoiceNote = {
      * ピッチ。単位は units（1/372オクターブ）。koe は Hz を受けるので、
      * ここから直接 Hz へ変換して歌わせる（整数MIDIノートに丸めない）。
      */
-    pitch: number;
+    pitch: Units;
     /** アンカー（再生開始時刻）からの相対秒。実発音時刻 = anchorTime + startSec。 */
     startSec: number;
     /** ゲート適用済みの発音長（秒）。 */
@@ -681,7 +827,7 @@ type Note = {
      * 12平均律の1半音 = 31、31平均律の1度 = 12。MIDIノート番号ではないので注意。
      * dtm 1.x の `pitch`（半音）から意味が変わっている。
      */
-    pitchUnits: number;
+    pitchUnits: Units;
     velocity?: number;
 };
 type RenderConfig = {
@@ -736,7 +882,7 @@ type LyricSyncData = {
 type NoteData = {
     startStep: number;
     /** 1/372オクターブ単位。{@link Note.pitchUnits} と同じ。 */
-    pitchUnits: number;
+    pitchUnits: Units;
     durationSteps: number;
     velocity?: number;
 };
@@ -744,7 +890,7 @@ type NoteData = {
 type NoteRemove = {
     startStep: number;
     /** 1/372オクターブ単位。{@link Note.pitchUnits} と同じ。 */
-    pitchUnits: number;
+    pitchUnits: Units;
 };
 type PianoRollOptions = {
     mountTarget: HTMLElement;
@@ -790,7 +936,7 @@ type PlayNoteEvent = {
      * `unitsToMidiDetune` を使う。{@link PlayDrumEvent.pitch} はGM打楽器のキー番号で
      * 音高ではないため、こちらとは別物。
      */
-    pitchUnits: number;
+    pitchUnits: Units;
     /** 元ノートのvelocity (0-127) */
     velocity: number;
     /** トラックvolume×velocityを反映した 0-1 程度の音量係数 */
@@ -1250,7 +1396,7 @@ type DawInstance = {
      * 画面外の場合は onScreen=false と方角 side を返す。
      * 協力DAWでのカーソル表示に使う。
      */
-    noteToCanvas: (step: number, pitch: number) => {
+    noteToCanvas: (step: number, pitch: Units) => {
         x: number;
         y: number;
         onScreen: boolean;
@@ -1404,7 +1550,8 @@ declare const playPlacements: (placements: Array<{
     trackIndex: number;
     startStep: number;
     durationSteps: number;
-    pitchUnits: number;
+    /** ピッチ。単位は units（1/372オクターブ）。 */
+    pitchUnits: Units;
     velocity: number;
 }>, options: PlayPlacementsOptions) => MmlPlayback;
 /**
@@ -1415,7 +1562,7 @@ declare const playMML: (mml: string, options?: PlayMmlOptions) => MmlPlayback;
 type PlayNoteOptions = {
     audioContext?: AudioContext;
     destination?: AudioNode;
-    pitchUnits: number;
+    pitchUnits: Units;
     volume?: number;
     duration?: number;
 };
@@ -1574,10 +1721,10 @@ declare class MMLCore {
      * @param pitch ピッチ番号
      * @param options ノート長などの設定
      */
-    addNote(step: number, pitch: number, options: AddNoteOptions): void;
+    addNote(step: number, pitch: Units, options: AddNoteOptions): void;
     deleteNoteById(noteId: number): void;
     private getMaxStep;
-    moveNote(noteId: number, startStep: number, pitch: number): void;
+    moveNote(noteId: number, startStep: number, pitch: Units): void;
     moveNoteEnd(_: number): void;
     resizeNote(noteId: number, durationSteps: number): void;
     resizeNoteEnd(_: number): void;
@@ -1875,7 +2022,7 @@ type MMLNotePlacement = {
     trackIndex: number;
     startStep: number;
     /** 1/372オクターブ単位（{@link Note.pitchUnits} と同じ）。 */
-    pitchUnits: number;
+    pitchUnits: Units;
     durationSteps: number;
     /** v コマンドで指定されたベロシティ（0-127、既定100） */
     velocity: number;
@@ -2069,11 +2216,12 @@ type Renderer = {
     getXY: (e: MouseEvent | PointerEvent) => [number, number, number];
     getGridPosition: (e: MouseEvent | PointerEvent) => {
         step: number;
-        pitch: number;
+        /** ピッチ。単位は units（1/372オクターブ）。 */
+        pitch: Units;
         x: number;
         y: number;
     };
-    onClick: (callback: (step: number, pitch: number) => void) => void;
+    onClick: (callback: (step: number, pitch: Units) => void) => void;
     setDrawOffset: (x: number, y: number) => void;
     /** Canvasをマウント先から取り外す。 */
     destroy: () => void;
@@ -2397,7 +2545,7 @@ type DtmStudio = {
     /** SoundFontを用いた単音再生を行う */
     playNote: (options: {
         /** ピッチ。単位は units（1/372オクターブ）。`pitchV1ToUnits` でMIDI番号から変換できる。 */
-        pitchUnits: number;
+        pitchUnits: Units;
         volume?: number;
         duration?: number;
         instrument?: string;
@@ -2493,7 +2641,7 @@ declare const showLoadingOverlay: (container: HTMLElement, options?: {
  * ピッチ(units) → 周波数(Hz)。A4 = 2139 units = 440Hz 基準。
  * 単位は 1/372オクターブの整数（`tuning.ts` 参照）。12平均律・31平均律とも同じ式で鳴る。
  */
-declare const freqFromPitch: (pitchUnits: number) => number;
+declare const freqFromPitch: (pitchUnits: Units) => number;
 type Synth = {
     /** メロディックノートを発音する（PlayNoteEvent.when は ctx.currentTime からの相対秒） */
     playNote: (e: PlayNoteEvent) => void;
@@ -2519,122 +2667,6 @@ type SynthTone = {
  */
 declare const createSynth: (ctx: AudioContext, destination?: AudioNode, tone?: SynthTone) => Synth;
 
-/**
- * 音律（12平均律 / 31平均律）と、ピッチの内部表現。
- *
- * ## 単位
- *
- * ノートのピッチは **1/372オクターブの整数** で持つ。372 = 12 × 31 で、12と31は
- * 互いに素なので最小公倍数がこれになり、**12平均律と31平均律の両方が誤差ゼロで
- * 同じ数直線に乗る**。
- *
- *   12平均律 1半音 = 31 units
- *   31平均律 1度   = 12 units
- *   1 unit = 1200/372 ≒ 3.2258 セント
- *
- * 整数のままなので `a.pitchUnits === b.pitchUnits` の同値判定が全部生き残る
- * （重複判定・当たり判定・協調編集の (startStep, pitchUnits) キー）。小数にすると
- * ここが軒並み壊れるため、細かい整数単位を選んでいる。
- *
- * ## 音律は音声経路に入らない
- *
- * ピッチが絶対値なので、シーケンサも発音器も音律を知らなくてよい。音律は
- * 「格子・記譜・表示」だけに効く編集上の概念で、`RenderConfig.edo` に置く。
- */
-/** 1オクターブあたりの units。12 × 31。 */
-declare const UNITS_PER_OCTAVE = 372;
-/** 12平均律の1半音あたりの units。 */
-declare const UNITS_PER_SEMITONE: number;
-/** 31平均律の1度あたりの units。 */
-declare const UNITS_PER_EDO31_DEGREE: number;
-/** 1 unit のセント値。 */
-declare const CENTS_PER_UNIT: number;
-/** A4 (MIDI 69) の units。周波数計算の基準。 */
-declare const A4_UNITS: number;
-/** A4 の周波数(Hz)。 */
-declare const A4_HZ = 440;
-/** 対応する音律（1オクターブの分割数）。 */
-type Edo = 12 | 31;
-/** 既定の音律。宣言のない曲はすべてこれ（＝既存データは素通り）。 */
-declare const DEFAULT_EDO: Edo;
-/** その音律の1格子ステップが何 units か。 */
-declare const unitsPerStep: (edo: Edo) => number;
-/** MIDIノート番号 → units。 */
-declare const midiToUnits: (midi: number) => number;
-/**
- * units → MIDIノート番号（小数）。
- * 歌声合成（koe）は Hz を受けるためこの小数値をそのまま渡してよい。
- * SoundFont のように整数ゾーンしか持たない発音器は {@link unitsToMidiDetune} を使う。
- */
-declare const unitsToMidi: (units: number) => number;
-/** units → 周波数(Hz)。 */
-declare const unitsToHz: (units: number) => number;
-/**
- * units → 「最寄りの整数MIDIノート番号 + セント補正」。
- *
- * SoundFont は音高ごとに整数キーでゾーンを持つため小数ピッチを直接鳴らせない。
- * 最寄りのゾーンを鳴らして残差を `AudioBufferSourceNode.detune` で補正する。
- * 31平均律での残差は最大 ±48.4 セントで、detune の可動域に十分収まる。
- */
-declare const unitsToMidiDetune: (units: number) => {
-    midi: number;
-    detuneCents: number;
-};
-/**
- * 臨時記号1つあたりの格子ステップ数。
- *
- * - `#` / `+`(12平均律) … クロマチック半音上げ
- * - `-` … クロマチック半音下げ
- * - `+`(31平均律) … 格子1ステップ上げ（微分音）
- * - `_` … 格子1ステップ下げ（微分音）
- *
- * 12平均律ではクロマチック半音＝1格子ステップなので4記号すべてが従来の意味に潰れ、
- * 既存MMLの解釈は1文字も変わらない。31平均律でのみ `#`/`-`（±2度）と
- * `+`/`_`（±1度）が分岐する。
- */
-declare const chromaticStep: (edo: Edo) => number;
-/** 微分音記号 `+` / `_` 1つあたりの格子ステップ数。常に1。 */
-declare const MICRO_STEP = 1;
-/** 幹音の文字か。 */
-declare const isNaturalLetter: (ch: string) => boolean;
-/** 幹音の文字 → オクターブ内の格子ステップ。未知の文字は null。 */
-declare const naturalStep: (ch: string, edo: Edo) => number | null;
-/**
- * 音名・オクターブ・臨時記号から units を組み立てる。
- *
- * `octave` はMMLの `o` 指定（MIDI慣習で o4 の c が中央ド = MIDI 60）。
- * 臨時記号でオクターブを跨ぐ綴り（`b##` が次オクターブへ、`c--` が前オクターブへ）も
- * そのまま加算されるので、度数を 0〜edo-1 にクランプしてはいけない。
- */
-declare const spellingToUnits: (letter: string, octave: number, chromatic: number, micro: number, edo: Edo) => number | null;
-/**
- * 五度圏インデックス（C=0, G=1, F=-1, C#=7, Db=-5）→ オクターブ内の格子ステップ。
- *
- * ミーントーン系の音律はすべて「五度を何ステップとするか」だけで決まるため、
- * 綴りを持つ音（chord-parser の `rootFifth` / `noteFifths` など）はこの一本で
- * どちらの音律へも正確に写せる。12平均律では C# と Db が同じ値に潰れ、
- * 31平均律では 2 と 3 に分かれる。
- */
-declare const fifthToStep: (fifthIndex: number, edo: Edo) => number;
-/** 五度圏インデックス → オクターブ内の units。 */
-declare const fifthToUnits: (fifthIndex: number, edo: Edo) => number;
-/**
- * ピッチ表現のバージョン。
- *
- * - v1 … `pitch` が半音（MIDIノート番号）。dtm 1.x
- * - v2 … `pitchUnits` が 1/372オクターブ単位。dtm 2.x
- *
- * dtm 自身は通信路を持たず `onNotesPatch` / `applyPatch` のフックを出すだけなので、
- * バージョンの突き合わせは利用側アプリのハンドシェイクの責務になる。変換の知識だけを
- * ここに置く。v1→v2 は無損失だが、**v2→v1 は12平均律の曲でしか成立しない**
- * （31平均律を半音へ丸めると最大48.4セント動く）。
- */
-declare const PITCH_ENCODING_VERSION = 2;
-/** v1（半音）→ v2（units）。無損失。 */
-declare const pitchV1ToUnits: (pitch: number) => number;
-/** v2（units）→ v1（半音）。12平均律の曲でのみ無損失。 */
-declare const unitsToPitchV1: (units: number) => number;
-
 declare const VOICE_IMAGES: Record<string, string>;
 
 /**
@@ -2650,4 +2682,4 @@ declare const encodeWavPCM16: (channels: Float32Array[], sampleRate: number) =>
 /** Float32Array のチャンクを1本へ連結する。 */
 declare const concatFloat32: (chunks: Float32Array[]) => Float32Array;
 
-export { A4_HZ, A4_UNITS, type AddNoteOptions, type AnyDrumPattern, type ApplyChordOptions, CENTS_PER_UNIT, type ChordPatternType, type ChordPlacement, type ChordPlayerInstance, type ConsumedSyllable, type CoreEventHandlers, type CustomVocalDef, DAW_CSS, DEFAULT_BPM, DEFAULT_EDO, DEFAULT_GATE, DEFAULT_PAN, DEFAULT_PLAYBACK_VELOCITY, DEFAULT_STEPS_PER_BAR, DEFAULT_VELOCITY, DEFAULT_VOCAL_VOLUME, DRUM_FONT, DRUM_KEYS, DRUM_PATTERNS, type DawInstance, type DawMode, type DawOptions, type DawViewState, type DrumPattern, type DrumPatternDef, type DtmStudio, type DtmStudioEngines, type DtmStudioOptions, EDO31_NAMES, type Edo, type ExportMidiOptions, type FadeScheduleParams, GM_INSTRUMENT_NAMES, INSTRUMENT_PRESETS, type InstrumentPreset, KEY_COUNT, KOE_BASE_URL, KOE_VOICEBANKS, KOE_VOICEBANK_LABELS, KOE_VOICEBANK_TERMS, type KoeVoiceOptions, LinkedList, type LoopConfig, type LoopPoint, type LyricSyllable, type LyricSyncData, type LyricTrack, type LyricsConductor, MAX_VOCAL_VOLUME, MICRO_STEP, MMLCore, type MMLDisplayToken, type MMLNotePlacement, MML_END_MARKER, type MidiExtraction, type MidiNotePlacement, MidiSearchClient, type MidiSearchConfig, type MidiTrackAnalysis, type MmlMeta, type MmlPlayback, type MmlPlayerInstance, type MmlPlayerOptions, type ModeSwitchInstance, type ModeSwitchOptions, type MountChordPlayerOptions, type MountEditorOptions, type MountPlayerOptions, type Note, type NoteData, type NoteRemove, type OctaveUnisonMode, PITCH_ENCODING_VERSION, PITCH_MAP, PITCH_RANGE_END, PITCH_RANGE_START, PREWARM_NOTES, type ParseMMLOptions, type ParseMidiFn, type ParsedMML, type PianoRollInstance, type PianoRollOptions, type PicotuneSearchParams, type PicotuneSong, type PitchToken, type PlayChordsOptions, type PlayDrumEvent, type PlayMmlOptions, type PlayNoteEvent, type PlayNoteOptions, type PlayPlacementsOptions, type PlaySingingMmlOptions, type PlaybackCue, type PlaybackState, type PresetSelectInstance, type PresetSelectOptions, type PreviewSoundCallback, type RenderConfig, type Renderer, type Sequencer, type SequencerOptions, type SequencerTrack, type SingingVoices, type SingingVoicesOptions, type StreamPlaybackOptions, type StreamVoiceNote, type StreamVoiceTrack, type Synth, TRACKS_ADVANCED, TRACKS_SIMPLE, type ToolMode, type TrackConfig, UNITS_PER_EDO31_DEGREE, UNITS_PER_OCTAVE, UNITS_PER_SEMITONE, VIBRATO_MIN_SEC, VOICE_IMAGES, VOICE_IMAGE_KEY, type VoiceExpression, type VoiceModel, type VoiceRegistry, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, buildChordPlacements, buildDrumPatternJson, buildNameToKeyMapping, chromaticStep, collectPitchTokens, concatFloat32, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createRenderer, createSequencer, createSingingVoices, createSynth, createVoiceRegistry, decodeMml, decomposeToMonophonic, encodeMml, encodeWavPCM16, exportMIDI, extractDrumPatternFromNotes, extractMidiDrumPattern, extractMidiPlacements, extractMidiPlacementsByTrack, fifthToStep, fifthToUnits, formatMmlMeta, freqFromPitch, generateRandomPattern, getDrumPatternKeys, getMidiBPM, icon, injectStyles, isChordHeavyTrack, isNaturalLetter, isPlausibleMidiTranscription, isValidHttpUrl, keyCountFor, koeUrl, midiToUnits, mountChordPlayer, mountDAW, mountMmlPlayer, naturalStep, normalizeDrumPatterns, normalizeLyrics, panToStereo, parseCustomVocals, parseLyrics, parseMML, parseMmlMeta, pitchV1ToUnits, playChords, playMML, playNote, playPlacements, playSingingMML, resolveDrumPattern, resolveLoopPoint, shiftNotes, showLoadingOverlay, spellingToUnits, stripCustomVocals, stripLyrics, stripMmlMeta, transposeNotes, unitsPerRow, unitsPerStep, unitsToHz, unitsToMidi, unitsToMidiDetune, unitsToPitchV1, vocalVolumeToGain };
+export { A4_HZ, A4_UNITS, type AddNoteOptions, type AnyDrumPattern, type ApplyChordOptions, CENTS_PER_UNIT, type ChordPatternType, type ChordPlacement, type ChordPlayerInstance, type ConsumedSyllable, type CoreEventHandlers, type CustomVocalDef, DAW_CSS, DEFAULT_BPM, DEFAULT_EDO, DEFAULT_GATE, DEFAULT_PAN, DEFAULT_PLAYBACK_VELOCITY, DEFAULT_STEPS_PER_BAR, DEFAULT_VELOCITY, DEFAULT_VOCAL_VOLUME, DRUM_FONT, DRUM_KEYS, DRUM_PATTERNS, type DawInstance, type DawMode, type DawOptions, type DawViewState, type DrumPattern, type DrumPatternDef, type DtmStudio, type DtmStudioEngines, type DtmStudioOptions, EDO31_NAMES, type Edo, type ExportMidiOptions, type FadeScheduleParams, GM_INSTRUMENT_NAMES, INSTRUMENT_PRESETS, type InstrumentPreset, KEY_COUNT, KOE_BASE_URL, KOE_VOICEBANKS, KOE_VOICEBANK_LABELS, KOE_VOICEBANK_TERMS, type KoeVoiceOptions, LinkedList, type LoopConfig, type LoopPoint, type LyricSyllable, type LyricSyncData, type LyricTrack, type LyricsConductor, MAX_VOCAL_VOLUME, MICRO_STEP, MMLCore, type MMLDisplayToken, type MMLNotePlacement, MML_END_MARKER, type MidiExtraction, type MidiNote, type MidiNotePlacement, MidiSearchClient, type MidiSearchConfig, type MidiTrackAnalysis, type MmlMeta, type MmlPlayback, type MmlPlayerInstance, type MmlPlayerOptions, type ModeSwitchInstance, type ModeSwitchOptions, type MountChordPlayerOptions, type MountEditorOptions, type MountPlayerOptions, type Note, type NoteData, type NoteRemove, type OctaveUnisonMode, PITCH_ENCODING_VERSION, PITCH_MAP, PITCH_RANGE_END, PITCH_RANGE_START, PREWARM_NOTES, type ParseMMLOptions, type ParseMidiFn, type ParsedMML, type PianoRollInstance, type PianoRollOptions, type PicotuneSearchParams, type PicotuneSong, type PitchToken, type PlayChordsOptions, type PlayDrumEvent, type PlayMmlOptions, type PlayNoteEvent, type PlayNoteOptions, type PlayPlacementsOptions, type PlaySingingMmlOptions, type PlaybackCue, type PlaybackState, type PresetSelectInstance, type PresetSelectOptions, type PreviewSoundCallback, type RenderConfig, type Renderer, type Sequencer, type SequencerOptions, type SequencerTrack, type SingingVoices, type SingingVoicesOptions, type StreamPlaybackOptions, type StreamVoiceNote, type StreamVoiceTrack, type Synth, TRACKS_ADVANCED, TRACKS_SIMPLE, type ToolMode, type TrackConfig, UNITS_PER_EDO31_DEGREE, UNITS_PER_OCTAVE, UNITS_PER_SEMITONE, type Units, VIBRATO_MIN_SEC, VOICE_IMAGES, VOICE_IMAGE_KEY, type VoiceExpression, type VoiceModel, type VoiceRegistry, addUnits, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, buildChordPlacements, buildDrumPatternJson, buildNameToKeyMapping, chromaticStep, collectPitchTokens, concatFloat32, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createRenderer, createSequencer, createSingingVoices, createSynth, createVoiceRegistry, decodeMml, decomposeToMonophonic, encodeMml, encodeWavPCM16, exportMIDI, extractDrumPatternFromNotes, extractMidiDrumPattern, extractMidiPlacements, extractMidiPlacementsByTrack, fifthToStep, fifthToUnits, formatMmlMeta, freqFromPitch, generateRandomPattern, getDrumPatternKeys, getMidiBPM, icon, injectStyles, isChordHeavyTrack, isNaturalLetter, isPlausibleMidiTranscription, isValidHttpUrl, keyCountFor, koeUrl, midiNote, midiToUnits, mountChordPlayer, mountDAW, mountMmlPlayer, naturalStep, normalizeDrumPatterns, normalizeLyrics, panToStereo, parseCustomVocals, parseLyrics, parseMML, parseMmlMeta, pitchV1ToUnits, playChords, playMML, playNote, playPlacements, playSingingMML, resolveDrumPattern, resolveLoopPoint, shiftNotes, showLoadingOverlay, spellingToUnits, stripCustomVocals, stripLyrics, stripMmlMeta, transposeNotes, units, unitsPerRow, unitsPerStep, unitsToHz, unitsToMidi, unitsToMidiDetune, unitsToPitchV1, vocalVolumeToGain };