@onjmin/dtm 0.1.85 → 0.1.87

package/dist/index.d.mts

@@ -140,6 +140,17 @@ type ClipMeter = {
     dispose: () => void;
 };
 
+/**
+ * マスタディレイ（テンポ同期エコー）— send/return バス。
+ *
+ * リバーブ（{@link file://./reverb.ts}）と同じ設計: masterGain の並列センドとして
+ * 独立に存在し、各ボーカルトラックが個別のセンド量（`e`トークン）で参加を決める。
+ * リバーブと違い、ディレイは曲のBPMに同期しないと不自然に聞こえるため、音価
+ * （8分・付点8分等）を選ばせて実秒数へ変換する方式にしている（DTMツールの定番UX）。
+ */
+/** 選べる音価。value は保存用の短いキー、beats は四分音符を1とした拍数。 */
+type DelayDivision = "4" | "8" | "8d" | "16";
+
 /**
  * 自動ビブラート（ロングトーンに自動で掛けるピッチLFO）の定数と曲線生成。
  *
@@ -304,7 +315,7 @@ type VoiceModel = {
      * {@link renderToCache} 済みのバッファを絶対時刻 t0（AudioContextクロック秒）へスケジュールする。
      * t0 は未来の任意時刻でよく、再生はオーディオスレッドが担うのでメインスレッドのもたつきに影響されない。
      */
-    scheduleCached?: (key: string, t0: number, peak: number, pan: number, reverbSend?: number, destination?: AudioNode) => void;
+    scheduleCached?: (key: string, t0: number, peak: number, pan: number, reverbSend?: number, delaySend?: number, destination?: AudioNode) => void;
     /** スケジュール済みの発音をすべて即停止する（停止・一時停止・シーク時）。 */
     stopAll?: () => void;
 };
@@ -317,7 +328,7 @@ type VoiceModel = {
  * 戻り値の VoiceModel は (音節, PlayNoteEvent) を受け取り、
  * `ctx.currentTime + e.when` のタイミングで destination へ発音する。
  */
-declare const createKlattVoice: (ctx: AudioContext, destination: AudioNode, reverbBus?: AudioNode) => VoiceModel;
+declare const createKlattVoice: (ctx: AudioContext, destination: AudioNode, reverbBus?: AudioNode, delayBus?: AudioNode) => VoiceModel;
 /** koe音源（.koe）が置かれているパブリックバケットのベースURL */
 declare const KOE_BASE_URL = "https://pub-12482a6b5cbc4c9e906b2e1904cabae5.r2.dev";
 /**
@@ -380,6 +391,11 @@ type KoeVoiceOptions = {
      * （＝トラックごとの `r` トークンを書いてもリバーブが掛からない）。
      */
     reverbBus?: AudioNode;
+    /**
+     * マスタディレイのバス（センド先）。指定時のみ、ノートごとの `delaySend` に応じて
+     * ドライ経路とは別にこのノードへ送る。未指定ならディレイ送りは常にスキップされる。
+     */
+    delayBus?: AudioNode;
 };
 /**
  * @onjmin/koe の音源（UTAU由来 .koe）で1音節を歌う {@link VoiceModel} を生成する。
@@ -425,6 +441,11 @@ type StreamVoiceTrack = {
      * リバーブバスへ送るかを個別に決める。
      */
     reverbSend?: number;
+    /**
+     * マスタディレイへのセンド量 0-1。既定0（ディレイが掛からない）。マスタディレイ自体の
+     * つまみ（音価・掛かり具合）とは独立に、このトラックをどれだけディレイバスへ送るかを決める。
+     */
+    delaySend?: number;
     /**
      * フォルマント/ジェンダーファクター 0-1。既定0.5（無変化）。koe音源（Worldline）限定
      * — klattフォールバックには効かない。0.5未満で低め/太め、0.5超で高め/細めに寄る。
@@ -435,6 +456,11 @@ type StreamVoiceTrack = {
      * — klattフォールバックには効かない。
      */
     breathiness?: number;
+    /**
+     * オクターブダブル ON/OFF。既定false。ONにすると各音節を1オクターブ下（控えめな音量）で
+     * 同時に重ねて発音し、声に厚みを足す（オクターブユニゾン/ダブリング）。
+     */
+    octaveDouble?: boolean;
     /** 発音順（startSec昇順）の歌唱ノート列。 */
     notes: StreamVoiceNote[];
 };
@@ -532,6 +558,12 @@ type SingingVoicesOptions = {
      * Convolver 入力を渡す想定）。
      */
     reverbBus?: AudioNode;
+    /**
+     * マスタディレイのバス（センド先）。指定すると、各歌詞トラックの `delay`（`e`トークン）
+     * に応じて klatt/koe いずれの音源もこのノードへセンドできるようになる。未指定なら
+     * トラック側で `e` を指定してもディレイは掛からない。
+     */
+    delayBus?: AudioNode;
     /**
      * トラックID → チャンネルストリップ入口ノードの解決関数。指定すると、各トラックの
      * 発音は共有の `destination`（singingVoices内部マスタ）へ直結する代わりに、この
@@ -645,8 +677,10 @@ type LyricSyncData = {
     vocalOctave: number;
     vocalVibrato?: boolean;
     vocalReverb?: number;
+    vocalDelay?: number;
     vocalGender?: number;
     vocalBreathiness?: number;
+    vocalOctaveDouble?: boolean;
 };
 /** パッチ送受信用ノートデータ（ローカルIDを持たない）。 */
 type NoteData = {
@@ -729,6 +763,11 @@ type PlayNoteEvent = {
      * 反映する。合成側はドライ経路とは別にこの割合だけリバーブバスへ送ればよい。
      */
     reverbSend?: number;
+    /**
+     * マスタディレイへのセンド量 0-1（既定0）。歌詞トラックの個別ディレイ送り設定を反映する。
+     * リバーブと同じくドライ経路とは別にこの割合だけディレイバスへ送ればよい。
+     */
+    delaySend?: number;
     /**
      * 発音先の上書き（未指定なら合成側の既定destinationへ）。トラック単位チャンネルストリップ
      * （コンプレッサー/ステレオワイド）の入口ノードを渡すことを想定。
@@ -787,6 +826,13 @@ type LyricTrack = {
      * MMLでは `@@n klatt r50 …` のように r トークンで付与する。
      */
     reverb?: number;
+    /**
+     * このボーカルトラック個別のディレイセンド量 0-100。既定0（マスタディレイの影響を受けない）。
+     * マスタディレイのつまみ（テンポ同期した音価・掛かり具合そのもの）とは別軸で、
+     * 「このトラックをどれだけディレイバスへ送るか」を個別に決める。
+     * MMLでは `@@n klatt e50 …` のように e トークンで付与する。
+     */
+    delay?: number;
     /**
      * フォルマント/ジェンダーファクター 0-100。既定50（無変化）。
      * ピッチはそのままに声の太さ/細さ（年齢・性別感）だけを動かす。
@@ -800,6 +846,13 @@ type LyricTrack = {
      * MMLでは `@@n klatt h70 …` のように h トークンで付与する。
      */
     breathiness?: number;
+    /**
+     * オクターブダブル ON/OFF。既定false。
+     * ONにすると各音節を1オクターブ下（控えめな音量）で同時に重ねて発音し、声に厚みを足す
+     * （オクターブユニゾン/ダブリング）。
+     * MMLでは `@@n klatt w1 …` のように w トークンで付与する。
+     */
+    octaveDouble?: boolean;
     /** 正規化済み音節列 */
     syllables: LyricSyllable[];
     /**
@@ -825,6 +878,20 @@ type PlayDrumEvent = {
     duration: number;
 };
 type ParseMidiFn = (bytes: Uint8Array) => unknown | Promise<unknown>;
+/**
+ * 1回の play() 呼び出しで使うフェードのスケジュール（絶対 AudioContext 時刻、秒）。
+ * いずれも未指定ならそちらのフェードは掛けない（曲頭から再生していない/フェード長0等）。
+ */
+type FadeScheduleParams = {
+    /** フェードイン開始時刻（通常は再生アンカー時刻と同じ）。 */
+    fadeInStartAt?: number;
+    /** フェードイン完了時刻（この時刻に音量1へ到達）。 */
+    fadeInEndAt?: number;
+    /** フェードアウト開始時刻（この時刻までは音量1を維持）。 */
+    fadeOutStartAt?: number;
+    /** フェードアウト完了時刻（この時刻に音量0へ到達、通常は曲の終端）。 */
+    fadeOutEndAt?: number;
+};
 /**
  * 永続化対象の表示・出力設定。利用側がブラウザ再訪時に復元する用途に使う。
  * （ノートやMML本体ではなく、エディタの見え方/出力の挙動の設定）
@@ -878,6 +945,27 @@ type DawOptions = {
     onTrackCompressionChange?: (trackId: string, amount: number) => void;
     /** トラック単位のステレオ幅 0-200 が変化したときに呼ばれる。 */
     onTrackWidthChange?: (trackId: string, width: number) => void;
+    /** トラック単位EQの低域（シェルフ）ゲイン -12〜+12dB が変化したときに呼ばれる。 */
+    onTrackEqLowChange?: (trackId: string, db: number) => void;
+    /** トラック単位EQの中域（ピーキング）ゲイン -12〜+12dB が変化したときに呼ばれる。 */
+    onTrackEqMidChange?: (trackId: string, db: number) => void;
+    /** トラック単位EQの高域（シェルフ）ゲイン -12〜+12dB が変化したときに呼ばれる。 */
+    onTrackEqHighChange?: (trackId: string, db: number) => void;
+    /**
+     * BPMが変化したときに呼ばれる（MML読込・スライダー操作・MIDI取り込み等、経路に依らず単一の窓口）。
+     * テンポ同期エフェクト（ディレイ等）が実時間へ再計算するために使う。
+     */
+    onBpmChange?: (bpm: number) => void;
+    /** 曲頭のフェードイン長（秒）。既定0（フェードなし）。範囲0〜10。 */
+    fadeInSec?: number;
+    /** 曲尾のフェードアウト長（秒）。既定0（フェードなし）。範囲0〜10。 */
+    fadeOutSec?: number;
+    /**
+     * play() のたびに、今回の再生で使うフェードのスケジュール（絶対 AudioContext 時刻）を
+     * 通知する。`params` が null ならフェードを解除し音量を1へ戻す（pause/stop時）。
+     * 実際のゲイン自動化は呼び出し側（studio）が担う。
+     */
+    onScheduleFade?: (params: FadeScheduleParams | null) => void;
     /**
      * 表示・出力設定（ズーム / 和音分解モード / 和音伴奏トラック無視）が変化したときに呼ばれる。
      * 利用側が選択状態を永続化する用途に使う。
@@ -912,6 +1000,26 @@ type DawOptions = {
     reverbAmount?: number;
     /** マスタリバーブのつまみが動かされたときに呼ばれる（0-100）。実際の音声処理は呼び出し側（studio）が担う。 */
     onReverbChange?: (amount: number) => void;
+    /** マスタリバーブのDecay（残響の長さ、秒）。既定2.2、範囲0.3〜4.0。 */
+    reverbDecay?: number;
+    /** マスタリバーブのDecayが変化したときに呼ばれる（秒）。 */
+    onReverbDecayChange?: (seconds: number) => void;
+    /** マスタリバーブのPre Delay（原音から残響が立ち上がるまでの遅延、ms）。既定0、範囲0〜150。 */
+    reverbPreDelay?: number;
+    /** マスタリバーブのPre Delayが変化したときに呼ばれる（ms）。 */
+    onReverbPreDelayChange?: (ms: number) => void;
+    /**
+     * マスタディレイの掛かり具合 0-100。既定0（オフ）。テンポに同期したエコー。
+     * 全トラック共通のバス自体は用意されるが、実際に送る量はボーカルトラック個別の
+     * ディレイ送り（`e`トークン）で決める（リバーブと同じ send/return の考え方）。
+     */
+    delayAmount?: number;
+    /** マスタディレイのつまみが動かされたときに呼ばれる（0-100）。 */
+    onDelayChange?: (amount: number) => void;
+    /** マスタディレイの音価（既定 "8" = 8分音符）。曲のBPMに同期した実秒数へ変換される。 */
+    delayDivision?: DelayDivision;
+    /** マスタディレイの音価が変更されたときに呼ばれる。 */
+    onDelayDivisionChange?: (division: DelayDivision) => void;
     parseMidi?: ParseMidiFn;
     /**
      * 動作モード（{@link DawMode}）。
@@ -1008,6 +1116,12 @@ type DawInstance = {
     setDrumVolume: (volume: number) => void;
     /** マスタリバーブの掛かり具合を 0-100 で変更する。 */
     setReverbAmount: (amount: number) => void;
+    /** マスタリバーブのDecay（残響の長さ）を秒で変更する。 */
+    setReverbDecay: (seconds: number) => void;
+    /** マスタリバーブのPre Delayをmsで変更する。 */
+    setReverbPreDelay: (ms: number) => void;
+    /** マスタディレイの掛かり具合を 0-100 で変更する。 */
+    setDelayAmount: (amount: number) => void;
     /** リモートから受信したトラック個別楽器を適用する（`onTrackInstrumentChange` は発火しない）。 */
     applyTrackInstrument: (trackIndex: number, instrumentName: string) => void;
     /**
@@ -1409,6 +1523,12 @@ declare const applyMonophonic: (targetCore: MMLCore, chordCore: MMLCore, options
  * 全トラックのノートを一括でステップシフトする（負方向で範囲外は削除）。
  */
 declare const shiftNotes: (cores: MMLCore[], shiftSteps: number) => void;
+/**
+ * 全トラックのノートを一括で移調する（半音単位）。歌唱ピッチもノート由来なので、
+ * 歌詞トラックの歌声も一緒に移調される。MIDI範囲(0-127)を超える場合はクランプする
+ * （音域外に飛んで無音・破綻するのを防ぐ）。
+ */
+declare const transposeNotes: (cores: MMLCore[], semitones: number) => void;
 
 type MidiTrackAnalysis = {
     index: number;
@@ -1528,6 +1648,25 @@ type MmlMeta = {
     drumVolume?: number;
     /** マスタリバーブの掛かり具合 0-100（全トラック共通、`#reverb=` で埋め込む） */
     reverb?: number;
+    /**
+     * マスタリバーブのDecay（残響の長さ）を10倍した整数（0.3〜4.0秒 → 3〜40）。
+     * `#reverbdecay=` で埋め込む。省略時は22（2.2秒）。
+     */
+    reverbDecay?: number;
+    /** マスタリバーブのPre Delay（ms、0〜150）。`#reverbpredelay=` で埋め込む。省略時は0。 */
+    reverbPreDelay?: number;
+    /** マスタディレイの掛かり具合 0-100（全トラック共通、`#delay=` で埋め込む） */
+    delay?: number;
+    /** マスタディレイの音価（"4"|"8"|"8d"|"16"）。`#delaydiv=` で埋め込む。省略時は"8"。 */
+    delayDivision?: string;
+    /**
+     * 曲頭のフェードイン長を10倍した整数（秒 → 0〜100）。`#fadein=` で埋め込む。省略時は0。
+     */
+    fadeIn?: number;
+    /**
+     * 曲尾のフェードアウト長を10倍した整数（秒 → 0〜100）。`#fadeout=` で埋め込む。省略時は0。
+     */
+    fadeOut?: number;
     /** DAWの動作モード（simple | advanced） */
     mode?: "simple" | "advanced";
     /**
@@ -1545,6 +1684,12 @@ type MmlMeta = {
      * トラックごとのステレオ幅 0-200。`#t<n>width=<値>` で埋め込む。省略時は100（原音のまま）。
      */
     trackWidth?: Record<number, number>;
+    /** トラックごとのEQ低域ゲイン -12〜+12dB。`#t<n>eqlo=<値>` で埋め込む。省略時は0（無変化）。 */
+    trackEqLow?: Record<number, number>;
+    /** トラックごとのEQ中域ゲイン -12〜+12dB。`#t<n>eqmid=<値>` で埋め込む。省略時は0（無変化）。 */
+    trackEqMid?: Record<number, number>;
+    /** トラックごとのEQ高域ゲイン -12〜+12dB。`#t<n>eqhi=<値>` で埋め込む。省略時は0（無変化）。 */
+    trackEqHigh?: Record<number, number>;
 };
 /** MMLからトップレベル宣言を抽出する */
 declare const parseMmlMeta: (mml: string) => MmlMeta;
@@ -1890,6 +2035,18 @@ type DtmStudioOptions = {
     drumVolume?: number;
     /** マスタリバーブの掛かり具合 0-100。既定0（オフ）。全トラックへ一律で掛かる。 */
     reverbAmount?: number;
+    /** マスタリバーブのDecay（残響の長さ、秒）。既定2.2、範囲0.3〜4.0。 */
+    reverbDecay?: number;
+    /** マスタリバーブのPre Delay（ms）。既定0、範囲0〜150。 */
+    reverbPreDelay?: number;
+    /** マスタディレイの掛かり具合 0-100。既定0（オフ）。テンポに同期したエコー。 */
+    delayAmount?: number;
+    /** マスタディレイの音価（既定 "8" = 8分音符）。 */
+    delayDivision?: DelayDivision;
+    /** 曲頭のフェードイン長（秒）。既定0（フェードなし）。 */
+    fadeInSec?: number;
+    /** 曲尾のフェードアウト長（秒）。既定0（フェードなし）。 */
+    fadeOutSec?: number;
     /**
      * 最終出力先の AudioNode。未指定時は audioCtx.destination（スピーカー）。
      * MediaStreamAudioDestinationNode や GainNode を指定できます。
@@ -2091,6 +2248,12 @@ type DtmStudio = {
     setVolume: (volume: number) => void;
     /** マスタリバーブの掛かり具合を 0-100 で変更する。 */
     setReverbAmount: (amount: number) => void;
+    /** マスタリバーブのDecay（残響の長さ）を秒で変更する。 */
+    setReverbDecay: (seconds: number) => void;
+    /** マスタリバーブのPre Delayをmsで変更する。 */
+    setReverbPreDelay: (ms: number) => void;
+    /** マスタディレイの掛かり具合を 0-100 で変更する。 */
+    setDelayAmount: (amount: number) => void;
     /** AudioContext を閉じ、生成物を破棄する。 */
     dispose: () => void;
 };
@@ -2166,4 +2329,4 @@ declare const createSynth: (ctx: AudioContext, destination?: AudioNode, tone?: S
 
 declare const VOICE_IMAGES: Record<string, string>;
 
-export { type AddNoteOptions, type AnyDrumPattern, type ApplyChordOptions, type ChordPatternType, type ChordPlacement, type ChordPlayerInstance, type ConsumedSyllable, type CoreEventHandlers, type CustomVocalDef, DAW_CSS, DEFAULT_BPM, 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, type ExportMidiOptions, GM_INSTRUMENT_NAMES, INSTRUMENT_PRESETS, type InstrumentPreset, 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, 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, PITCH_MAP, 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 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, VIBRATO_MIN_SEC, VOICE_IMAGES, VOICE_IMAGE_KEY, type VoiceExpression, type VoiceModel, type VoiceRegistry, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, buildChordPlacements, buildDrumPatternJson, buildNameToKeyMapping, collectPitchTokens, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createSequencer, createSingingVoices, createSynth, createVoiceRegistry, decodeMml, decomposeToMonophonic, drawGrid, drawHeader, drawKeyboard, drawNotes, drawSelectedNotes, drawSelectionRect, encodeMml, exportMIDI, extractDrumPatternFromNotes, extractMidiDrumPattern, extractMidiPlacements, extractMidiPlacementsByTrack, formatMmlMeta, freqFromPitch, generateRandomPattern, getDrawOffset, getDrumPatternKeys, getGridCanvas, getGridContext, getGridPosition, getHeaderCanvas, getMidiBPM, getRenderConfig, getXY, icon, init, injectStyles, isChordHeavyTrack, isPlausibleMidiTranscription, isValidHttpUrl, koeUrl, mountChordPlayer, mountDAW, mountMmlPlayer, normalizeDrumPatterns, normalizeLyrics, onClick, panToStereo, parseCustomVocals, parseLyrics, parseMML, parseMmlMeta, playChords, playMML, playNote, playPlacements, playSingingMML, resolveDrumPattern, resolveLoopPoint, setBackgroundActive, setDrawOffset, shiftNotes, showLoadingOverlay, stripCustomVocals, stripLyrics, stripMmlMeta, vocalVolumeToGain };
+export { type AddNoteOptions, type AnyDrumPattern, type ApplyChordOptions, type ChordPatternType, type ChordPlacement, type ChordPlayerInstance, type ConsumedSyllable, type CoreEventHandlers, type CustomVocalDef, DAW_CSS, DEFAULT_BPM, 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, type ExportMidiOptions, type FadeScheduleParams, GM_INSTRUMENT_NAMES, INSTRUMENT_PRESETS, type InstrumentPreset, 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, 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, PITCH_MAP, 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 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, VIBRATO_MIN_SEC, VOICE_IMAGES, VOICE_IMAGE_KEY, type VoiceExpression, type VoiceModel, type VoiceRegistry, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, buildChordPlacements, buildDrumPatternJson, buildNameToKeyMapping, collectPitchTokens, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createSequencer, createSingingVoices, createSynth, createVoiceRegistry, decodeMml, decomposeToMonophonic, drawGrid, drawHeader, drawKeyboard, drawNotes, drawSelectedNotes, drawSelectionRect, encodeMml, exportMIDI, extractDrumPatternFromNotes, extractMidiDrumPattern, extractMidiPlacements, extractMidiPlacementsByTrack, formatMmlMeta, freqFromPitch, generateRandomPattern, getDrawOffset, getDrumPatternKeys, getGridCanvas, getGridContext, getGridPosition, getHeaderCanvas, getMidiBPM, getRenderConfig, getXY, icon, init, injectStyles, isChordHeavyTrack, isPlausibleMidiTranscription, isValidHttpUrl, koeUrl, mountChordPlayer, mountDAW, mountMmlPlayer, normalizeDrumPatterns, normalizeLyrics, onClick, panToStereo, parseCustomVocals, parseLyrics, parseMML, parseMmlMeta, playChords, playMML, playNote, playPlacements, playSingingMML, resolveDrumPattern, resolveLoopPoint, setBackgroundActive, setDrawOffset, shiftNotes, showLoadingOverlay, stripCustomVocals, stripLyrics, stripMmlMeta, transposeNotes, vocalVolumeToGain };

package/dist/index.d.ts

@@ -140,6 +140,17 @@ type ClipMeter = {
     dispose: () => void;
 };
 
+/**
+ * マスタディレイ（テンポ同期エコー）— send/return バス。
+ *
+ * リバーブ（{@link file://./reverb.ts}）と同じ設計: masterGain の並列センドとして
+ * 独立に存在し、各ボーカルトラックが個別のセンド量（`e`トークン）で参加を決める。
+ * リバーブと違い、ディレイは曲のBPMに同期しないと不自然に聞こえるため、音価
+ * （8分・付点8分等）を選ばせて実秒数へ変換する方式にしている（DTMツールの定番UX）。
+ */
+/** 選べる音価。value は保存用の短いキー、beats は四分音符を1とした拍数。 */
+type DelayDivision = "4" | "8" | "8d" | "16";
+
 /**
  * 自動ビブラート（ロングトーンに自動で掛けるピッチLFO）の定数と曲線生成。
  *
@@ -304,7 +315,7 @@ type VoiceModel = {
      * {@link renderToCache} 済みのバッファを絶対時刻 t0（AudioContextクロック秒）へスケジュールする。
      * t0 は未来の任意時刻でよく、再生はオーディオスレッドが担うのでメインスレッドのもたつきに影響されない。
      */
-    scheduleCached?: (key: string, t0: number, peak: number, pan: number, reverbSend?: number, destination?: AudioNode) => void;
+    scheduleCached?: (key: string, t0: number, peak: number, pan: number, reverbSend?: number, delaySend?: number, destination?: AudioNode) => void;
     /** スケジュール済みの発音をすべて即停止する（停止・一時停止・シーク時）。 */
     stopAll?: () => void;
 };
@@ -317,7 +328,7 @@ type VoiceModel = {
  * 戻り値の VoiceModel は (音節, PlayNoteEvent) を受け取り、
  * `ctx.currentTime + e.when` のタイミングで destination へ発音する。
  */
-declare const createKlattVoice: (ctx: AudioContext, destination: AudioNode, reverbBus?: AudioNode) => VoiceModel;
+declare const createKlattVoice: (ctx: AudioContext, destination: AudioNode, reverbBus?: AudioNode, delayBus?: AudioNode) => VoiceModel;
 /** koe音源（.koe）が置かれているパブリックバケットのベースURL */
 declare const KOE_BASE_URL = "https://pub-12482a6b5cbc4c9e906b2e1904cabae5.r2.dev";
 /**
@@ -380,6 +391,11 @@ type KoeVoiceOptions = {
      * （＝トラックごとの `r` トークンを書いてもリバーブが掛からない）。
      */
     reverbBus?: AudioNode;
+    /**
+     * マスタディレイのバス（センド先）。指定時のみ、ノートごとの `delaySend` に応じて
+     * ドライ経路とは別にこのノードへ送る。未指定ならディレイ送りは常にスキップされる。
+     */
+    delayBus?: AudioNode;
 };
 /**
  * @onjmin/koe の音源（UTAU由来 .koe）で1音節を歌う {@link VoiceModel} を生成する。
@@ -425,6 +441,11 @@ type StreamVoiceTrack = {
      * リバーブバスへ送るかを個別に決める。
      */
     reverbSend?: number;
+    /**
+     * マスタディレイへのセンド量 0-1。既定0（ディレイが掛からない）。マスタディレイ自体の
+     * つまみ（音価・掛かり具合）とは独立に、このトラックをどれだけディレイバスへ送るかを決める。
+     */
+    delaySend?: number;
     /**
      * フォルマント/ジェンダーファクター 0-1。既定0.5（無変化）。koe音源（Worldline）限定
      * — klattフォールバックには効かない。0.5未満で低め/太め、0.5超で高め/細めに寄る。
@@ -435,6 +456,11 @@ type StreamVoiceTrack = {
      * — klattフォールバックには効かない。
      */
     breathiness?: number;
+    /**
+     * オクターブダブル ON/OFF。既定false。ONにすると各音節を1オクターブ下（控えめな音量）で
+     * 同時に重ねて発音し、声に厚みを足す（オクターブユニゾン/ダブリング）。
+     */
+    octaveDouble?: boolean;
     /** 発音順（startSec昇順）の歌唱ノート列。 */
     notes: StreamVoiceNote[];
 };
@@ -532,6 +558,12 @@ type SingingVoicesOptions = {
      * Convolver 入力を渡す想定）。
      */
     reverbBus?: AudioNode;
+    /**
+     * マスタディレイのバス（センド先）。指定すると、各歌詞トラックの `delay`（`e`トークン）
+     * に応じて klatt/koe いずれの音源もこのノードへセンドできるようになる。未指定なら
+     * トラック側で `e` を指定してもディレイは掛からない。
+     */
+    delayBus?: AudioNode;
     /**
      * トラックID → チャンネルストリップ入口ノードの解決関数。指定すると、各トラックの
      * 発音は共有の `destination`（singingVoices内部マスタ）へ直結する代わりに、この
@@ -645,8 +677,10 @@ type LyricSyncData = {
     vocalOctave: number;
     vocalVibrato?: boolean;
     vocalReverb?: number;
+    vocalDelay?: number;
     vocalGender?: number;
     vocalBreathiness?: number;
+    vocalOctaveDouble?: boolean;
 };
 /** パッチ送受信用ノートデータ（ローカルIDを持たない）。 */
 type NoteData = {
@@ -729,6 +763,11 @@ type PlayNoteEvent = {
      * 反映する。合成側はドライ経路とは別にこの割合だけリバーブバスへ送ればよい。
      */
     reverbSend?: number;
+    /**
+     * マスタディレイへのセンド量 0-1（既定0）。歌詞トラックの個別ディレイ送り設定を反映する。
+     * リバーブと同じくドライ経路とは別にこの割合だけディレイバスへ送ればよい。
+     */
+    delaySend?: number;
     /**
      * 発音先の上書き（未指定なら合成側の既定destinationへ）。トラック単位チャンネルストリップ
      * （コンプレッサー/ステレオワイド）の入口ノードを渡すことを想定。
@@ -787,6 +826,13 @@ type LyricTrack = {
      * MMLでは `@@n klatt r50 …` のように r トークンで付与する。
      */
     reverb?: number;
+    /**
+     * このボーカルトラック個別のディレイセンド量 0-100。既定0（マスタディレイの影響を受けない）。
+     * マスタディレイのつまみ（テンポ同期した音価・掛かり具合そのもの）とは別軸で、
+     * 「このトラックをどれだけディレイバスへ送るか」を個別に決める。
+     * MMLでは `@@n klatt e50 …` のように e トークンで付与する。
+     */
+    delay?: number;
     /**
      * フォルマント/ジェンダーファクター 0-100。既定50（無変化）。
      * ピッチはそのままに声の太さ/細さ（年齢・性別感）だけを動かす。
@@ -800,6 +846,13 @@ type LyricTrack = {
      * MMLでは `@@n klatt h70 …` のように h トークンで付与する。
      */
     breathiness?: number;
+    /**
+     * オクターブダブル ON/OFF。既定false。
+     * ONにすると各音節を1オクターブ下（控えめな音量）で同時に重ねて発音し、声に厚みを足す
+     * （オクターブユニゾン/ダブリング）。
+     * MMLでは `@@n klatt w1 …` のように w トークンで付与する。
+     */
+    octaveDouble?: boolean;
     /** 正規化済み音節列 */
     syllables: LyricSyllable[];
     /**
@@ -825,6 +878,20 @@ type PlayDrumEvent = {
     duration: number;
 };
 type ParseMidiFn = (bytes: Uint8Array) => unknown | Promise<unknown>;
+/**
+ * 1回の play() 呼び出しで使うフェードのスケジュール（絶対 AudioContext 時刻、秒）。
+ * いずれも未指定ならそちらのフェードは掛けない（曲頭から再生していない/フェード長0等）。
+ */
+type FadeScheduleParams = {
+    /** フェードイン開始時刻（通常は再生アンカー時刻と同じ）。 */
+    fadeInStartAt?: number;
+    /** フェードイン完了時刻（この時刻に音量1へ到達）。 */
+    fadeInEndAt?: number;
+    /** フェードアウト開始時刻（この時刻までは音量1を維持）。 */
+    fadeOutStartAt?: number;
+    /** フェードアウト完了時刻（この時刻に音量0へ到達、通常は曲の終端）。 */
+    fadeOutEndAt?: number;
+};
 /**
  * 永続化対象の表示・出力設定。利用側がブラウザ再訪時に復元する用途に使う。
  * （ノートやMML本体ではなく、エディタの見え方/出力の挙動の設定）
@@ -878,6 +945,27 @@ type DawOptions = {
     onTrackCompressionChange?: (trackId: string, amount: number) => void;
     /** トラック単位のステレオ幅 0-200 が変化したときに呼ばれる。 */
     onTrackWidthChange?: (trackId: string, width: number) => void;
+    /** トラック単位EQの低域（シェルフ）ゲイン -12〜+12dB が変化したときに呼ばれる。 */
+    onTrackEqLowChange?: (trackId: string, db: number) => void;
+    /** トラック単位EQの中域（ピーキング）ゲイン -12〜+12dB が変化したときに呼ばれる。 */
+    onTrackEqMidChange?: (trackId: string, db: number) => void;
+    /** トラック単位EQの高域（シェルフ）ゲイン -12〜+12dB が変化したときに呼ばれる。 */
+    onTrackEqHighChange?: (trackId: string, db: number) => void;
+    /**
+     * BPMが変化したときに呼ばれる（MML読込・スライダー操作・MIDI取り込み等、経路に依らず単一の窓口）。
+     * テンポ同期エフェクト（ディレイ等）が実時間へ再計算するために使う。
+     */
+    onBpmChange?: (bpm: number) => void;
+    /** 曲頭のフェードイン長（秒）。既定0（フェードなし）。範囲0〜10。 */
+    fadeInSec?: number;
+    /** 曲尾のフェードアウト長（秒）。既定0（フェードなし）。範囲0〜10。 */
+    fadeOutSec?: number;
+    /**
+     * play() のたびに、今回の再生で使うフェードのスケジュール（絶対 AudioContext 時刻）を
+     * 通知する。`params` が null ならフェードを解除し音量を1へ戻す（pause/stop時）。
+     * 実際のゲイン自動化は呼び出し側（studio）が担う。
+     */
+    onScheduleFade?: (params: FadeScheduleParams | null) => void;
     /**
      * 表示・出力設定（ズーム / 和音分解モード / 和音伴奏トラック無視）が変化したときに呼ばれる。
      * 利用側が選択状態を永続化する用途に使う。
@@ -912,6 +1000,26 @@ type DawOptions = {
     reverbAmount?: number;
     /** マスタリバーブのつまみが動かされたときに呼ばれる（0-100）。実際の音声処理は呼び出し側（studio）が担う。 */
     onReverbChange?: (amount: number) => void;
+    /** マスタリバーブのDecay（残響の長さ、秒）。既定2.2、範囲0.3〜4.0。 */
+    reverbDecay?: number;
+    /** マスタリバーブのDecayが変化したときに呼ばれる（秒）。 */
+    onReverbDecayChange?: (seconds: number) => void;
+    /** マスタリバーブのPre Delay（原音から残響が立ち上がるまでの遅延、ms）。既定0、範囲0〜150。 */
+    reverbPreDelay?: number;
+    /** マスタリバーブのPre Delayが変化したときに呼ばれる（ms）。 */
+    onReverbPreDelayChange?: (ms: number) => void;
+    /**
+     * マスタディレイの掛かり具合 0-100。既定0（オフ）。テンポに同期したエコー。
+     * 全トラック共通のバス自体は用意されるが、実際に送る量はボーカルトラック個別の
+     * ディレイ送り（`e`トークン）で決める（リバーブと同じ send/return の考え方）。
+     */
+    delayAmount?: number;
+    /** マスタディレイのつまみが動かされたときに呼ばれる（0-100）。 */
+    onDelayChange?: (amount: number) => void;
+    /** マスタディレイの音価（既定 "8" = 8分音符）。曲のBPMに同期した実秒数へ変換される。 */
+    delayDivision?: DelayDivision;
+    /** マスタディレイの音価が変更されたときに呼ばれる。 */
+    onDelayDivisionChange?: (division: DelayDivision) => void;
     parseMidi?: ParseMidiFn;
     /**
      * 動作モード（{@link DawMode}）。
@@ -1008,6 +1116,12 @@ type DawInstance = {
     setDrumVolume: (volume: number) => void;
     /** マスタリバーブの掛かり具合を 0-100 で変更する。 */
     setReverbAmount: (amount: number) => void;
+    /** マスタリバーブのDecay（残響の長さ）を秒で変更する。 */
+    setReverbDecay: (seconds: number) => void;
+    /** マスタリバーブのPre Delayをmsで変更する。 */
+    setReverbPreDelay: (ms: number) => void;
+    /** マスタディレイの掛かり具合を 0-100 で変更する。 */
+    setDelayAmount: (amount: number) => void;
     /** リモートから受信したトラック個別楽器を適用する（`onTrackInstrumentChange` は発火しない）。 */
     applyTrackInstrument: (trackIndex: number, instrumentName: string) => void;
     /**
@@ -1409,6 +1523,12 @@ declare const applyMonophonic: (targetCore: MMLCore, chordCore: MMLCore, options
  * 全トラックのノートを一括でステップシフトする（負方向で範囲外は削除）。
  */
 declare const shiftNotes: (cores: MMLCore[], shiftSteps: number) => void;
+/**
+ * 全トラックのノートを一括で移調する（半音単位）。歌唱ピッチもノート由来なので、
+ * 歌詞トラックの歌声も一緒に移調される。MIDI範囲(0-127)を超える場合はクランプする
+ * （音域外に飛んで無音・破綻するのを防ぐ）。
+ */
+declare const transposeNotes: (cores: MMLCore[], semitones: number) => void;
 
 type MidiTrackAnalysis = {
     index: number;
@@ -1528,6 +1648,25 @@ type MmlMeta = {
     drumVolume?: number;
     /** マスタリバーブの掛かり具合 0-100（全トラック共通、`#reverb=` で埋め込む） */
     reverb?: number;
+    /**
+     * マスタリバーブのDecay（残響の長さ）を10倍した整数（0.3〜4.0秒 → 3〜40）。
+     * `#reverbdecay=` で埋め込む。省略時は22（2.2秒）。
+     */
+    reverbDecay?: number;
+    /** マスタリバーブのPre Delay（ms、0〜150）。`#reverbpredelay=` で埋め込む。省略時は0。 */
+    reverbPreDelay?: number;
+    /** マスタディレイの掛かり具合 0-100（全トラック共通、`#delay=` で埋め込む） */
+    delay?: number;
+    /** マスタディレイの音価（"4"|"8"|"8d"|"16"）。`#delaydiv=` で埋め込む。省略時は"8"。 */
+    delayDivision?: string;
+    /**
+     * 曲頭のフェードイン長を10倍した整数（秒 → 0〜100）。`#fadein=` で埋め込む。省略時は0。
+     */
+    fadeIn?: number;
+    /**
+     * 曲尾のフェードアウト長を10倍した整数（秒 → 0〜100）。`#fadeout=` で埋め込む。省略時は0。
+     */
+    fadeOut?: number;
     /** DAWの動作モード（simple | advanced） */
     mode?: "simple" | "advanced";
     /**
@@ -1545,6 +1684,12 @@ type MmlMeta = {
      * トラックごとのステレオ幅 0-200。`#t<n>width=<値>` で埋め込む。省略時は100（原音のまま）。
      */
     trackWidth?: Record<number, number>;
+    /** トラックごとのEQ低域ゲイン -12〜+12dB。`#t<n>eqlo=<値>` で埋め込む。省略時は0（無変化）。 */
+    trackEqLow?: Record<number, number>;
+    /** トラックごとのEQ中域ゲイン -12〜+12dB。`#t<n>eqmid=<値>` で埋め込む。省略時は0（無変化）。 */
+    trackEqMid?: Record<number, number>;
+    /** トラックごとのEQ高域ゲイン -12〜+12dB。`#t<n>eqhi=<値>` で埋め込む。省略時は0（無変化）。 */
+    trackEqHigh?: Record<number, number>;
 };
 /** MMLからトップレベル宣言を抽出する */
 declare const parseMmlMeta: (mml: string) => MmlMeta;
@@ -1890,6 +2035,18 @@ type DtmStudioOptions = {
     drumVolume?: number;
     /** マスタリバーブの掛かり具合 0-100。既定0（オフ）。全トラックへ一律で掛かる。 */
     reverbAmount?: number;
+    /** マスタリバーブのDecay（残響の長さ、秒）。既定2.2、範囲0.3〜4.0。 */
+    reverbDecay?: number;
+    /** マスタリバーブのPre Delay（ms）。既定0、範囲0〜150。 */
+    reverbPreDelay?: number;
+    /** マスタディレイの掛かり具合 0-100。既定0（オフ）。テンポに同期したエコー。 */
+    delayAmount?: number;
+    /** マスタディレイの音価（既定 "8" = 8分音符）。 */
+    delayDivision?: DelayDivision;
+    /** 曲頭のフェードイン長（秒）。既定0（フェードなし）。 */
+    fadeInSec?: number;
+    /** 曲尾のフェードアウト長（秒）。既定0（フェードなし）。 */
+    fadeOutSec?: number;
     /**
      * 最終出力先の AudioNode。未指定時は audioCtx.destination（スピーカー）。
      * MediaStreamAudioDestinationNode や GainNode を指定できます。
@@ -2091,6 +2248,12 @@ type DtmStudio = {
     setVolume: (volume: number) => void;
     /** マスタリバーブの掛かり具合を 0-100 で変更する。 */
     setReverbAmount: (amount: number) => void;
+    /** マスタリバーブのDecay（残響の長さ）を秒で変更する。 */
+    setReverbDecay: (seconds: number) => void;
+    /** マスタリバーブのPre Delayをmsで変更する。 */
+    setReverbPreDelay: (ms: number) => void;
+    /** マスタディレイの掛かり具合を 0-100 で変更する。 */
+    setDelayAmount: (amount: number) => void;
     /** AudioContext を閉じ、生成物を破棄する。 */
     dispose: () => void;
 };
@@ -2166,4 +2329,4 @@ declare const createSynth: (ctx: AudioContext, destination?: AudioNode, tone?: S
 
 declare const VOICE_IMAGES: Record<string, string>;
 
-export { type AddNoteOptions, type AnyDrumPattern, type ApplyChordOptions, type ChordPatternType, type ChordPlacement, type ChordPlayerInstance, type ConsumedSyllable, type CoreEventHandlers, type CustomVocalDef, DAW_CSS, DEFAULT_BPM, 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, type ExportMidiOptions, GM_INSTRUMENT_NAMES, INSTRUMENT_PRESETS, type InstrumentPreset, 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, 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, PITCH_MAP, 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 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, VIBRATO_MIN_SEC, VOICE_IMAGES, VOICE_IMAGE_KEY, type VoiceExpression, type VoiceModel, type VoiceRegistry, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, buildChordPlacements, buildDrumPatternJson, buildNameToKeyMapping, collectPitchTokens, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createSequencer, createSingingVoices, createSynth, createVoiceRegistry, decodeMml, decomposeToMonophonic, drawGrid, drawHeader, drawKeyboard, drawNotes, drawSelectedNotes, drawSelectionRect, encodeMml, exportMIDI, extractDrumPatternFromNotes, extractMidiDrumPattern, extractMidiPlacements, extractMidiPlacementsByTrack, formatMmlMeta, freqFromPitch, generateRandomPattern, getDrawOffset, getDrumPatternKeys, getGridCanvas, getGridContext, getGridPosition, getHeaderCanvas, getMidiBPM, getRenderConfig, getXY, icon, init, injectStyles, isChordHeavyTrack, isPlausibleMidiTranscription, isValidHttpUrl, koeUrl, mountChordPlayer, mountDAW, mountMmlPlayer, normalizeDrumPatterns, normalizeLyrics, onClick, panToStereo, parseCustomVocals, parseLyrics, parseMML, parseMmlMeta, playChords, playMML, playNote, playPlacements, playSingingMML, resolveDrumPattern, resolveLoopPoint, setBackgroundActive, setDrawOffset, shiftNotes, showLoadingOverlay, stripCustomVocals, stripLyrics, stripMmlMeta, vocalVolumeToGain };
+export { type AddNoteOptions, type AnyDrumPattern, type ApplyChordOptions, type ChordPatternType, type ChordPlacement, type ChordPlayerInstance, type ConsumedSyllable, type CoreEventHandlers, type CustomVocalDef, DAW_CSS, DEFAULT_BPM, 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, type ExportMidiOptions, type FadeScheduleParams, GM_INSTRUMENT_NAMES, INSTRUMENT_PRESETS, type InstrumentPreset, 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, 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, PITCH_MAP, 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 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, VIBRATO_MIN_SEC, VOICE_IMAGES, VOICE_IMAGE_KEY, type VoiceExpression, type VoiceModel, type VoiceRegistry, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, buildChordPlacements, buildDrumPatternJson, buildNameToKeyMapping, collectPitchTokens, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createSequencer, createSingingVoices, createSynth, createVoiceRegistry, decodeMml, decomposeToMonophonic, drawGrid, drawHeader, drawKeyboard, drawNotes, drawSelectedNotes, drawSelectionRect, encodeMml, exportMIDI, extractDrumPatternFromNotes, extractMidiDrumPattern, extractMidiPlacements, extractMidiPlacementsByTrack, formatMmlMeta, freqFromPitch, generateRandomPattern, getDrawOffset, getDrumPatternKeys, getGridCanvas, getGridContext, getGridPosition, getHeaderCanvas, getMidiBPM, getRenderConfig, getXY, icon, init, injectStyles, isChordHeavyTrack, isPlausibleMidiTranscription, isValidHttpUrl, koeUrl, mountChordPlayer, mountDAW, mountMmlPlayer, normalizeDrumPatterns, normalizeLyrics, onClick, panToStereo, parseCustomVocals, parseLyrics, parseMML, parseMmlMeta, playChords, playMML, playNote, playPlacements, playSingingMML, resolveDrumPattern, resolveLoopPoint, setBackgroundActive, setDrawOffset, shiftNotes, showLoadingOverlay, stripCustomVocals, stripLyrics, stripMmlMeta, transposeNotes, vocalVolumeToGain };