@onjmin/dtm 0.1.85 → 0.1.86

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超で高め/細めに寄る。
@@ -532,6 +553,12 @@ type SingingVoicesOptions = {
      * Convolver 入力を渡す想定）。
      */
     reverbBus?: AudioNode;
+    /**
+     * マスタディレイのバス（センド先）。指定すると、各歌詞トラックの `delay`（`e`トークン）
+     * に応じて klatt/koe いずれの音源もこのノードへセンドできるようになる。未指定なら
+     * トラック側で `e` を指定してもディレイは掛からない。
+     */
+    delayBus?: AudioNode;
     /**
      * トラックID → チャンネルストリップ入口ノードの解決関数。指定すると、各トラックの
      * 発音は共有の `destination`（singingVoices内部マスタ）へ直結する代わりに、この
@@ -645,6 +672,7 @@ type LyricSyncData = {
     vocalOctave: number;
     vocalVibrato?: boolean;
     vocalReverb?: number;
+    vocalDelay?: number;
     vocalGender?: number;
     vocalBreathiness?: number;
 };
@@ -729,6 +757,11 @@ type PlayNoteEvent = {
      * 反映する。合成側はドライ経路とは別にこの割合だけリバーブバスへ送ればよい。
      */
     reverbSend?: number;
+    /**
+     * マスタディレイへのセンド量 0-1（既定0）。歌詞トラックの個別ディレイ送り設定を反映する。
+     * リバーブと同じくドライ経路とは別にこの割合だけディレイバスへ送ればよい。
+     */
+    delaySend?: number;
     /**
      * 発音先の上書き（未指定なら合成側の既定destinationへ）。トラック単位チャンネルストリップ
      * （コンプレッサー/ステレオワイド）の入口ノードを渡すことを想定。
@@ -787,6 +820,13 @@ type LyricTrack = {
      * MMLでは `@@n klatt r50 …` のように r トークンで付与する。
      */
     reverb?: number;
+    /**
+     * このボーカルトラック個別のディレイセンド量 0-100。既定0（マスタディレイの影響を受けない）。
+     * マスタディレイのつまみ（テンポ同期した音価・掛かり具合そのもの）とは別軸で、
+     * 「このトラックをどれだけディレイバスへ送るか」を個別に決める。
+     * MMLでは `@@n klatt e50 …` のように e トークンで付与する。
+     */
+    delay?: number;
     /**
      * フォルマント/ジェンダーファクター 0-100。既定50（無変化）。
      * ピッチはそのままに声の太さ/細さ（年齢・性別感）だけを動かす。
@@ -878,6 +918,17 @@ 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;
     /**
      * 表示・出力設定（ズーム / 和音分解モード / 和音伴奏トラック無視）が変化したときに呼ばれる。
      * 利用側が選択状態を永続化する用途に使う。
@@ -912,6 +963,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 +1079,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;
     /**
@@ -1528,6 +1605,17 @@ 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;
     /** DAWの動作モード（simple | advanced） */
     mode?: "simple" | "advanced";
     /**
@@ -1545,6 +1633,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 +1984,14 @@ 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;
     /**
      * 最終出力先の AudioNode。未指定時は audioCtx.destination（スピーカー）。
      * MediaStreamAudioDestinationNode や GainNode を指定できます。
@@ -2091,6 +2193,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;
 };

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超で高め/細めに寄る。
@@ -532,6 +553,12 @@ type SingingVoicesOptions = {
      * Convolver 入力を渡す想定）。
      */
     reverbBus?: AudioNode;
+    /**
+     * マスタディレイのバス（センド先）。指定すると、各歌詞トラックの `delay`（`e`トークン）
+     * に応じて klatt/koe いずれの音源もこのノードへセンドできるようになる。未指定なら
+     * トラック側で `e` を指定してもディレイは掛からない。
+     */
+    delayBus?: AudioNode;
     /**
      * トラックID → チャンネルストリップ入口ノードの解決関数。指定すると、各トラックの
      * 発音は共有の `destination`（singingVoices内部マスタ）へ直結する代わりに、この
@@ -645,6 +672,7 @@ type LyricSyncData = {
     vocalOctave: number;
     vocalVibrato?: boolean;
     vocalReverb?: number;
+    vocalDelay?: number;
     vocalGender?: number;
     vocalBreathiness?: number;
 };
@@ -729,6 +757,11 @@ type PlayNoteEvent = {
      * 反映する。合成側はドライ経路とは別にこの割合だけリバーブバスへ送ればよい。
      */
     reverbSend?: number;
+    /**
+     * マスタディレイへのセンド量 0-1（既定0）。歌詞トラックの個別ディレイ送り設定を反映する。
+     * リバーブと同じくドライ経路とは別にこの割合だけディレイバスへ送ればよい。
+     */
+    delaySend?: number;
     /**
      * 発音先の上書き（未指定なら合成側の既定destinationへ）。トラック単位チャンネルストリップ
      * （コンプレッサー/ステレオワイド）の入口ノードを渡すことを想定。
@@ -787,6 +820,13 @@ type LyricTrack = {
      * MMLでは `@@n klatt r50 …` のように r トークンで付与する。
      */
     reverb?: number;
+    /**
+     * このボーカルトラック個別のディレイセンド量 0-100。既定0（マスタディレイの影響を受けない）。
+     * マスタディレイのつまみ（テンポ同期した音価・掛かり具合そのもの）とは別軸で、
+     * 「このトラックをどれだけディレイバスへ送るか」を個別に決める。
+     * MMLでは `@@n klatt e50 …` のように e トークンで付与する。
+     */
+    delay?: number;
     /**
      * フォルマント/ジェンダーファクター 0-100。既定50（無変化）。
      * ピッチはそのままに声の太さ/細さ（年齢・性別感）だけを動かす。
@@ -878,6 +918,17 @@ 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;
     /**
      * 表示・出力設定（ズーム / 和音分解モード / 和音伴奏トラック無視）が変化したときに呼ばれる。
      * 利用側が選択状態を永続化する用途に使う。
@@ -912,6 +963,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 +1079,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;
     /**
@@ -1528,6 +1605,17 @@ 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;
     /** DAWの動作モード（simple | advanced） */
     mode?: "simple" | "advanced";
     /**
@@ -1545,6 +1633,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 +1984,14 @@ 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;
     /**
      * 最終出力先の AudioNode。未指定時は audioCtx.destination（スピーカー）。
      * MediaStreamAudioDestinationNode や GainNode を指定できます。
@@ -2091,6 +2193,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;
 };