@onjmin/dtm 0.1.83 → 0.1.84

package/README.md

@@ -371,7 +371,7 @@ const cp = mountChordPlayer(document.getElementById("chord-app"), "| C | G | Am
 
 - モデルに `klatt` を指定すると内蔵フォルマント合成（音源ロード不要）。
 - 内蔵 UTAU 音源（@onjmin/koe）キーワード:
-  `tsukuyomi` / `rino` / `roze` / `ruko_male` / `ruko_female` / `teto` / `shiyo` / `rei` / `mgroid` / `motroid` / `nynroid`。
+  `tsukuyomi` / `rino` / `roze` / `uc` / `ruko_male` / `ruko_female` / `teto` / `shiyo` / `rei` / `mgroid` / `motroid` / `nynroid`。
 - `createDtmStudio` を使えば歌声は自動で配線されます。低レベル API で使う場合は
   `createSingingVoices` の戻り値を `mountDAW` / `mountMmlPlayer` の `singingVoices` に渡してください。
 

package/dist/index.d.mts

@@ -129,6 +129,24 @@ declare const resolveDrumPattern: (name: string, dict: Record<string, DrumPatter
 declare const DRUM_PATTERNS: Record<string, DrumPatternDef<DrumPattern>>;
 declare const getDrumPatternKeys: (name: string, dict: Record<string, AnyDrumPattern | DrumPatternDef>) => number[];
 
+/**
+ * 自動ビブラート（ロングトーンに自動で掛けるピッチLFO）の定数と曲線生成。
+ *
+ * メインスレッド（{@link file://./lyrics.ts} の local backend）とWorker
+ * （{@link file://./voice-worker.ts}）の両方から使う共通ロジックなのでここへ切り出す。
+ * 実際のLFOは koe の `Worldline.renderNote` が受け取る `CurveInput`（関数）として渡す
+ * だけで、koe自身は「ビブラートとは何か」を知らない — 表現の中身はdtm側の責務。
+ */
+/**
+ * 自動ビブラートを掛ける最短ノート長（秒）。テンポに関わらず一定（実時間基準）。
+ * ビブラート(5.5Hz程度)が最低1周期以上揺れきるには ~180ms 要るが、聴感上わかる
+ * 「歌っぽさ」を出すには2周期分は欲しいため、余裕を見て350msを既定閾値とする。
+ * これより短い音符は対象外（1周期も揺れきらず、ただの音程ブレとして不自然に響く）。
+ * beat/BPM基準ではなくms基準にしているのは、同じ「1拍」でもテンポが変われば実時間の
+ * 長さが変わり、ビブラートが自然に聞こえるかどうかは実時間側に依存するため。
+ */
+declare const VIBRATO_MIN_SEC = 0.35;
+
 /**
  * MML歌詞拡張 — 解析・正規化・同期（ヘッドレス）と、任意の歌唱合成ヘルパ。
  *
@@ -259,12 +277,12 @@ type VoiceModel = {
      * （モデル内部状態に依存しないので、同一モデルを複数トラックで共有しても干渉しない）。
      * 合成不能（該当音素なし・無声）なら null。klatt 等の軽量モデルは未実装でよい。
      */
-    renderToCache?: (syllable: LyricSyllable, prevVowel: string, pitch: number, durationMs: number) => Promise<string | null>;
+    renderToCache?: (syllable: LyricSyllable, prevVowel: string, pitch: number, durationMs: number, vibrato?: boolean) => Promise<string | null>;
     /**
      * {@link renderToCache} 済みのバッファを絶対時刻 t0（AudioContextクロック秒）へスケジュールする。
      * t0 は未来の任意時刻でよく、再生はオーディオスレッドが担うのでメインスレッドのもたつきに影響されない。
      */
-    scheduleCached?: (key: string, t0: number, peak: number, pan: number) => void;
+    scheduleCached?: (key: string, t0: number, peak: number, pan: number, reverbSend?: number) => void;
     /** スケジュール済みの発音をすべて即停止する（停止・一時停止・シーク時）。 */
     stopAll?: () => void;
 };
@@ -277,7 +295,7 @@ type VoiceModel = {
  * 戻り値の VoiceModel は (音節, PlayNoteEvent) を受け取り、
  * `ctx.currentTime + e.when` のタイミングで destination へ発音する。
  */
-declare const createKlattVoice: (ctx: AudioContext, destination: AudioNode) => VoiceModel;
+declare const createKlattVoice: (ctx: AudioContext, destination: AudioNode, reverbBus?: AudioNode) => VoiceModel;
 /** koe音源（.koe）が置かれているパブリックバケットのベースURL */
 declare const KOE_BASE_URL = "https://pub-12482a6b5cbc4c9e906b2e1904cabae5.r2.dev";
 /**
@@ -334,6 +352,12 @@ type KoeVoiceOptions = {
      * 省略時は従来どおりメインスレッドで合成する（後方互換）。
      */
     voiceWorkerUrl?: string;
+    /**
+     * マスタリバーブのバス（センド先）。指定時のみ、ノートごとの `reverbSend` に応じて
+     * ドライ経路とは別にこのノードへ送る。未指定ならリバーブ送りは常にスキップされる
+     * （＝トラックごとの `r` トークンを書いてもリバーブが掛からない）。
+     */
+    reverbBus?: AudioNode;
 };
 /**
  * @onjmin/koe の音源（UTAU由来 .koe）で1音節を歌う {@link VoiceModel} を生成する。
@@ -368,6 +392,17 @@ type StreamVoiceTrack = {
     volume: number;
     /** ステレオ定位 -1〜+1。 */
     pan: number;
+    /**
+     * 自動ビブラート ON/OFF。ONでも全ノートには掛からず、{@link VIBRATO_MIN_SEC} 以上の
+     * ロングトーンにだけ自動適用される（短い音符は不自然になるため対象外）。
+     */
+    vibrato?: boolean;
+    /**
+     * マスタリバーブへのセンド量 0-1。既定0（マスタリバーブが掛からない）。
+     * マスタリバーブ自体のつまみ（残響の質・量）とは独立に、このトラックをどれだけ
+     * リバーブバスへ送るかを個別に決める。
+     */
+    reverbSend?: number;
     /** 発音順（startSec昇順）の歌唱ノート列。 */
     notes: StreamVoiceNote[];
 };
@@ -458,6 +493,13 @@ type SingingVoicesOptions = {
      * 省略時は従来どおりメインスレッドで合成する。
      */
     voiceWorkerUrl?: string;
+    /**
+     * マスタリバーブのバス（センド先）。指定すると、各歌詞トラックの `reverb`（`r`トークン）
+     * に応じて klatt/koe いずれの音源もこのノードへセンドできるようになる。未指定なら
+     * トラック側で `r` を指定してもリバーブは掛からない（studio.ts がマスタの
+     * Convolver 入力を渡す想定）。
+     */
+    reverbBus?: AudioNode;
 };
 /**
  * klatt と koe音源を一括で扱う {@link SingingVoices} を生成する。
@@ -562,6 +604,8 @@ type LyricSyncData = {
     vocalGate: number;
     vocalPan: number;
     vocalOctave: number;
+    vocalVibrato?: boolean;
+    vocalReverb?: number;
 };
 /** パッチ送受信用ノートデータ（ローカルIDを持たない）。 */
 type NoteData = {
@@ -639,6 +683,11 @@ type PlayNoteEvent = {
     syllable?: LyricSyllable;
     /** syllable を歌う合成モデル名（"klatt" 等）。syllable とセットで届く */
     voiceModel?: string;
+    /**
+     * マスタリバーブへのセンド量 0-1（既定0）。歌詞トラックの個別リバーブ設定を
+     * 反映する。合成側はドライ経路とは別にこの割合だけリバーブバスへ送ればよい。
+     */
+    reverbSend?: number;
 };
 type LyricSyllable = {
     /** 表示用かな（"きょ" 等。長音は置換後の母音かな） */
@@ -678,6 +727,20 @@ type LyricTrack = {
      * MMLでは `@@n klatt o-1 …` のように o トークンで付与する。
      */
     octave?: number;
+    /**
+     * 自動ビブラート ON/OFF。既定false。
+     * ONでも全ノートに掛かるわけではなく、一定の長さ以上（ロングトーン）のノートにだけ
+     * 自動で適用される（短い音符は1周期も揺れきらず不自然になるため対象外）。
+     * MMLでは `@@n klatt b1 …` のように b トークンで付与する。
+     */
+    vibrato?: boolean;
+    /**
+     * このボーカルトラック個別のリバーブセンド量 0-100。既定0（マスタリバーブの影響を受けない）。
+     * マスタリバーブのつまみ（全トラック共通の残響そのもの）とは別軸で、
+     * 「このトラックをどれだけリバーブバスへ送るか」を個別に決める。
+     * MMLでは `@@n klatt r50 …` のように r トークンで付与する。
+     */
+    reverb?: number;
     /** 正規化済み音節列 */
     syllables: LyricSyllable[];
     /**
@@ -775,6 +838,13 @@ type DawOptions = {
     masterVolume?: number;
     /** ドラム音量 0-100。既定80。 */
     drumVolume?: number;
+    /**
+     * マスタリバーブの掛かり具合 0-100。既定0（オフ）。
+     * 全トラック（楽器・歌唱とも）に一律で掛かるマスタエフェクト。
+     */
+    reverbAmount?: number;
+    /** マスタリバーブのつまみが動かされたときに呼ばれる（0-100）。実際の音声処理は呼び出し側（studio）が担う。 */
+    onReverbChange?: (amount: number) => void;
     parseMidi?: ParseMidiFn;
     /**
      * 動作モード（{@link DawMode}）。
@@ -864,6 +934,8 @@ type DawInstance = {
     setVolume: (volume: number) => void;
     /** ドラム音量を 0-100 で変更する。 */
     setDrumVolume: (volume: number) => void;
+    /** マスタリバーブの掛かり具合を 0-100 で変更する。 */
+    setReverbAmount: (amount: number) => void;
     /** リモートから受信したトラック個別楽器を適用する（`onTrackInstrumentChange` は発火しない）。 */
     applyTrackInstrument: (trackIndex: number, instrumentName: string) => void;
     /**
@@ -1732,6 +1804,8 @@ type DtmStudioOptions = {
     masterVolume?: number;
     /** ドラム音量 0-1。既定 1。 */
     drumVolume?: number;
+    /** マスタリバーブの掛かり具合 0-100。既定0（オフ）。全トラックへ一律で掛かる。 */
+    reverbAmount?: number;
     /**
      * 最終出力先の AudioNode。未指定時は audioCtx.destination（スピーカー）。
      * MediaStreamAudioDestinationNode や GainNode を指定できます。
@@ -1931,6 +2005,8 @@ type DtmStudio = {
     setMasterVolume: (volume: number) => void;
     /** マスタ音量を 0-100 で変更する（`setMasterVolume` のエイリアス）。 */
     setVolume: (volume: number) => void;
+    /** マスタリバーブの掛かり具合を 0-100 で変更する。 */
+    setReverbAmount: (amount: number) => void;
     /** AudioContext を閉じ、生成物を破棄する。 */
     dispose: () => void;
 };
@@ -2006,4 +2082,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, VOICE_IMAGES, VOICE_IMAGE_KEY, 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, 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 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 };

package/dist/index.d.ts

@@ -129,6 +129,24 @@ declare const resolveDrumPattern: (name: string, dict: Record<string, DrumPatter
 declare const DRUM_PATTERNS: Record<string, DrumPatternDef<DrumPattern>>;
 declare const getDrumPatternKeys: (name: string, dict: Record<string, AnyDrumPattern | DrumPatternDef>) => number[];
 
+/**
+ * 自動ビブラート（ロングトーンに自動で掛けるピッチLFO）の定数と曲線生成。
+ *
+ * メインスレッド（{@link file://./lyrics.ts} の local backend）とWorker
+ * （{@link file://./voice-worker.ts}）の両方から使う共通ロジックなのでここへ切り出す。
+ * 実際のLFOは koe の `Worldline.renderNote` が受け取る `CurveInput`（関数）として渡す
+ * だけで、koe自身は「ビブラートとは何か」を知らない — 表現の中身はdtm側の責務。
+ */
+/**
+ * 自動ビブラートを掛ける最短ノート長（秒）。テンポに関わらず一定（実時間基準）。
+ * ビブラート(5.5Hz程度)が最低1周期以上揺れきるには ~180ms 要るが、聴感上わかる
+ * 「歌っぽさ」を出すには2周期分は欲しいため、余裕を見て350msを既定閾値とする。
+ * これより短い音符は対象外（1周期も揺れきらず、ただの音程ブレとして不自然に響く）。
+ * beat/BPM基準ではなくms基準にしているのは、同じ「1拍」でもテンポが変われば実時間の
+ * 長さが変わり、ビブラートが自然に聞こえるかどうかは実時間側に依存するため。
+ */
+declare const VIBRATO_MIN_SEC = 0.35;
+
 /**
  * MML歌詞拡張 — 解析・正規化・同期（ヘッドレス）と、任意の歌唱合成ヘルパ。
  *
@@ -259,12 +277,12 @@ type VoiceModel = {
      * （モデル内部状態に依存しないので、同一モデルを複数トラックで共有しても干渉しない）。
      * 合成不能（該当音素なし・無声）なら null。klatt 等の軽量モデルは未実装でよい。
      */
-    renderToCache?: (syllable: LyricSyllable, prevVowel: string, pitch: number, durationMs: number) => Promise<string | null>;
+    renderToCache?: (syllable: LyricSyllable, prevVowel: string, pitch: number, durationMs: number, vibrato?: boolean) => Promise<string | null>;
     /**
      * {@link renderToCache} 済みのバッファを絶対時刻 t0（AudioContextクロック秒）へスケジュールする。
      * t0 は未来の任意時刻でよく、再生はオーディオスレッドが担うのでメインスレッドのもたつきに影響されない。
      */
-    scheduleCached?: (key: string, t0: number, peak: number, pan: number) => void;
+    scheduleCached?: (key: string, t0: number, peak: number, pan: number, reverbSend?: number) => void;
     /** スケジュール済みの発音をすべて即停止する（停止・一時停止・シーク時）。 */
     stopAll?: () => void;
 };
@@ -277,7 +295,7 @@ type VoiceModel = {
  * 戻り値の VoiceModel は (音節, PlayNoteEvent) を受け取り、
  * `ctx.currentTime + e.when` のタイミングで destination へ発音する。
  */
-declare const createKlattVoice: (ctx: AudioContext, destination: AudioNode) => VoiceModel;
+declare const createKlattVoice: (ctx: AudioContext, destination: AudioNode, reverbBus?: AudioNode) => VoiceModel;
 /** koe音源（.koe）が置かれているパブリックバケットのベースURL */
 declare const KOE_BASE_URL = "https://pub-12482a6b5cbc4c9e906b2e1904cabae5.r2.dev";
 /**
@@ -334,6 +352,12 @@ type KoeVoiceOptions = {
      * 省略時は従来どおりメインスレッドで合成する（後方互換）。
      */
     voiceWorkerUrl?: string;
+    /**
+     * マスタリバーブのバス（センド先）。指定時のみ、ノートごとの `reverbSend` に応じて
+     * ドライ経路とは別にこのノードへ送る。未指定ならリバーブ送りは常にスキップされる
+     * （＝トラックごとの `r` トークンを書いてもリバーブが掛からない）。
+     */
+    reverbBus?: AudioNode;
 };
 /**
  * @onjmin/koe の音源（UTAU由来 .koe）で1音節を歌う {@link VoiceModel} を生成する。
@@ -368,6 +392,17 @@ type StreamVoiceTrack = {
     volume: number;
     /** ステレオ定位 -1〜+1。 */
     pan: number;
+    /**
+     * 自動ビブラート ON/OFF。ONでも全ノートには掛からず、{@link VIBRATO_MIN_SEC} 以上の
+     * ロングトーンにだけ自動適用される（短い音符は不自然になるため対象外）。
+     */
+    vibrato?: boolean;
+    /**
+     * マスタリバーブへのセンド量 0-1。既定0（マスタリバーブが掛からない）。
+     * マスタリバーブ自体のつまみ（残響の質・量）とは独立に、このトラックをどれだけ
+     * リバーブバスへ送るかを個別に決める。
+     */
+    reverbSend?: number;
     /** 発音順（startSec昇順）の歌唱ノート列。 */
     notes: StreamVoiceNote[];
 };
@@ -458,6 +493,13 @@ type SingingVoicesOptions = {
      * 省略時は従来どおりメインスレッドで合成する。
      */
     voiceWorkerUrl?: string;
+    /**
+     * マスタリバーブのバス（センド先）。指定すると、各歌詞トラックの `reverb`（`r`トークン）
+     * に応じて klatt/koe いずれの音源もこのノードへセンドできるようになる。未指定なら
+     * トラック側で `r` を指定してもリバーブは掛からない（studio.ts がマスタの
+     * Convolver 入力を渡す想定）。
+     */
+    reverbBus?: AudioNode;
 };
 /**
  * klatt と koe音源を一括で扱う {@link SingingVoices} を生成する。
@@ -562,6 +604,8 @@ type LyricSyncData = {
     vocalGate: number;
     vocalPan: number;
     vocalOctave: number;
+    vocalVibrato?: boolean;
+    vocalReverb?: number;
 };
 /** パッチ送受信用ノートデータ（ローカルIDを持たない）。 */
 type NoteData = {
@@ -639,6 +683,11 @@ type PlayNoteEvent = {
     syllable?: LyricSyllable;
     /** syllable を歌う合成モデル名（"klatt" 等）。syllable とセットで届く */
     voiceModel?: string;
+    /**
+     * マスタリバーブへのセンド量 0-1（既定0）。歌詞トラックの個別リバーブ設定を
+     * 反映する。合成側はドライ経路とは別にこの割合だけリバーブバスへ送ればよい。
+     */
+    reverbSend?: number;
 };
 type LyricSyllable = {
     /** 表示用かな（"きょ" 等。長音は置換後の母音かな） */
@@ -678,6 +727,20 @@ type LyricTrack = {
      * MMLでは `@@n klatt o-1 …` のように o トークンで付与する。
      */
     octave?: number;
+    /**
+     * 自動ビブラート ON/OFF。既定false。
+     * ONでも全ノートに掛かるわけではなく、一定の長さ以上（ロングトーン）のノートにだけ
+     * 自動で適用される（短い音符は1周期も揺れきらず不自然になるため対象外）。
+     * MMLでは `@@n klatt b1 …` のように b トークンで付与する。
+     */
+    vibrato?: boolean;
+    /**
+     * このボーカルトラック個別のリバーブセンド量 0-100。既定0（マスタリバーブの影響を受けない）。
+     * マスタリバーブのつまみ（全トラック共通の残響そのもの）とは別軸で、
+     * 「このトラックをどれだけリバーブバスへ送るか」を個別に決める。
+     * MMLでは `@@n klatt r50 …` のように r トークンで付与する。
+     */
+    reverb?: number;
     /** 正規化済み音節列 */
     syllables: LyricSyllable[];
     /**
@@ -775,6 +838,13 @@ type DawOptions = {
     masterVolume?: number;
     /** ドラム音量 0-100。既定80。 */
     drumVolume?: number;
+    /**
+     * マスタリバーブの掛かり具合 0-100。既定0（オフ）。
+     * 全トラック（楽器・歌唱とも）に一律で掛かるマスタエフェクト。
+     */
+    reverbAmount?: number;
+    /** マスタリバーブのつまみが動かされたときに呼ばれる（0-100）。実際の音声処理は呼び出し側（studio）が担う。 */
+    onReverbChange?: (amount: number) => void;
     parseMidi?: ParseMidiFn;
     /**
      * 動作モード（{@link DawMode}）。
@@ -864,6 +934,8 @@ type DawInstance = {
     setVolume: (volume: number) => void;
     /** ドラム音量を 0-100 で変更する。 */
     setDrumVolume: (volume: number) => void;
+    /** マスタリバーブの掛かり具合を 0-100 で変更する。 */
+    setReverbAmount: (amount: number) => void;
     /** リモートから受信したトラック個別楽器を適用する（`onTrackInstrumentChange` は発火しない）。 */
     applyTrackInstrument: (trackIndex: number, instrumentName: string) => void;
     /**
@@ -1732,6 +1804,8 @@ type DtmStudioOptions = {
     masterVolume?: number;
     /** ドラム音量 0-1。既定 1。 */
     drumVolume?: number;
+    /** マスタリバーブの掛かり具合 0-100。既定0（オフ）。全トラックへ一律で掛かる。 */
+    reverbAmount?: number;
     /**
      * 最終出力先の AudioNode。未指定時は audioCtx.destination（スピーカー）。
      * MediaStreamAudioDestinationNode や GainNode を指定できます。
@@ -1931,6 +2005,8 @@ type DtmStudio = {
     setMasterVolume: (volume: number) => void;
     /** マスタ音量を 0-100 で変更する（`setMasterVolume` のエイリアス）。 */
     setVolume: (volume: number) => void;
+    /** マスタリバーブの掛かり具合を 0-100 で変更する。 */
+    setReverbAmount: (amount: number) => void;
     /** AudioContext を閉じ、生成物を破棄する。 */
     dispose: () => void;
 };
@@ -2006,4 +2082,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, VOICE_IMAGES, VOICE_IMAGE_KEY, 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, 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 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 };