@onjmin/dtm 0.1.4 → 0.1.5

package/dist/index.d.mts

@@ -1121,6 +1121,139 @@ type Sequencer = {
 };
 declare const createSequencer: (options: SequencerOptions) => Sequencer;
 
+/**
+ * createDtmStudio — 「import して関数1つ」で鳴る、全部入りスタジオ（Layer 3）。
+ *
+ * @onjmin/dtm 本体（mountDAW / mountMmlPlayer）は発音を持たない注入式設計で、
+ * 楽器・ドラムの実音は外部 SoundFont（rpgen3）に委ねる。デモ index.html では
+ * その配線（AudioContext・SoundFontロード・歌声ワーカー・録音・MIDI/コード解析）を
+ * 手書きしていたが、本モジュールはそれを丸ごと内包する。
+ *
+ *   const studio = await createDtmStudio();
+ *   studio.mountEditor(editorEl, { initialMML });  // 編集UI（音・歌声込み）
+ *   studio.mountPlayer(playerEl, mml);             // 再生専用UI（音・歌声込み）
+ *
+ * 何も渡さなければ rpgen3 SoundFont を実行時にCDNから動的importし、歌声合成ワーカーは
+ * パッケージ同梱の dist/voice-worker.js を用いる。エンジンやURLは options で差し替え可能。
+ */
+
+type SoundFontInstance = {
+    play: (o: {
+        ctx: AudioContext;
+        destination: AudioNode;
+        pitch: number;
+        volume: number;
+        when: number;
+        duration: number;
+    }) => void;
+};
+type SoundFontEngine = {
+    load: (o: {
+        ctx: AudioContext;
+        fontName: string;
+        url: string;
+    }) => Promise<SoundFontInstance>;
+    toURL: (fullName: string) => string;
+};
+type SoundFontDrumEngine = {
+    load: (o: {
+        ctx: AudioContext;
+        font: string;
+        id: string;
+        keys: number[];
+    }) => Promise<void>;
+    play: (o: {
+        ctx: AudioContext;
+        destination: AudioNode;
+        pitch: number;
+        volume: number;
+        when: number;
+        duration: number;
+    }) => void;
+    font: unknown;
+};
+type SoundFontListEngine = {
+    init: () => void;
+    onload: (cb: () => void) => void;
+};
+/** 注入で差し替え可能な外部エンジン群（未指定なら CDN から取得）。 */
+type DtmStudioEngines = {
+    SoundFont?: SoundFontEngine;
+    SoundFont_drum?: SoundFontDrumEngine;
+    SoundFont_list?: SoundFontListEngine;
+    parseChord?: DawOptions["parseChord"];
+    parseChords?: DawOptions["parseChords"];
+    parseMidi?: DawOptions["parseMidi"];
+};
+/** 既定の取得元URL（rpgen3 / jsDelivr）。options.cdn で個別に上書きできる。 */
+declare const DEFAULT_CDN: {
+    readonly soundFont: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont.mjs";
+    readonly soundFontDrum: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont_drum.mjs";
+    readonly soundFontList: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont_list.mjs";
+    readonly parseChord: "https://rpgen3.github.io/piano/mjs/parseChord.mjs";
+    readonly parseChords: "https://rpgen3.github.io/piano/mjs/parseChords.mjs";
+    readonly midiParser: "https://cdn.jsdelivr.net/npm/midi-parser-js@4.0.4/+esm";
+};
+type DtmStudioOptions = {
+    /** 既存の AudioContext を使う（未指定なら内部生成）。 */
+    audioContext?: AudioContext;
+    /** マスター音量 0-1（楽器・歌声）。既定 1。 */
+    masterVolume?: number;
+    /** ドラム音量 0-1。既定 1。 */
+    drumVolume?: number;
+    /**
+     * 歌声合成ワーカー（voice-worker.js）のURL。
+     * 既定はパッケージ同梱の dist/voice-worker.js。
+     * `null` を渡すとワーカーを使わず klatt のみ（koe音源はメインスレッド合成）。
+     */
+    voiceWorkerUrl?: string | null;
+    /** 初期の楽器プリセットキー（INSTRUMENT_PRESETS）。既定 "retro_game"。 */
+    defaultPreset?: string;
+    /** 外部エンジンの注入（指定したものは CDN 取得をスキップ）。 */
+    engines?: DtmStudioEngines;
+    /** CDN URL の上書き。 */
+    cdn?: Partial<typeof DEFAULT_CDN>;
+    /** 有効化する機能。既定はすべて true。 */
+    features?: {
+        /** 録音→WAVダウンロード（編集UIの録音ボタン）。 */
+        recorder?: boolean;
+        /** MIDIファイル読み込み。 */
+        midi?: boolean;
+        /** コード入力（和音）。 */
+        chord?: boolean;
+        /** 編集UIに楽器プリセット選択UIを差し込む。 */
+        presetUI?: boolean;
+    };
+};
+/** 編集UIのマウント時オプション（DawOptions を一部上書きできる）。 */
+type MountEditorOptions = Partial<DawOptions> & {
+    /** このエディタで読み込む楽器プリセット（未指定なら studio の defaultPreset）。 */
+    preset?: string;
+    /** プリセット選択UIを出すか（未指定なら studio の features.presetUI）。 */
+    presetUI?: boolean;
+};
+/** 再生UIのマウント時オプション（MmlPlayerOptions を一部上書きできる）。 */
+type MountPlayerOptions = Partial<MmlPlayerOptions>;
+type DtmStudio = {
+    /** 内部で使用している AudioContext。 */
+    audioContext: AudioContext;
+    /** 歌声合成ヘルパ（klatt + koe音源）。 */
+    singingVoices: SingingVoices;
+    /** 編集UI（mountDAW）を音・歌声込みでマウントする。 */
+    mountEditor: (target: HTMLElement, options?: MountEditorOptions) => DawInstance;
+    /** 再生専用UI（mountMmlPlayer）を音・歌声込みでマウントする。 */
+    mountPlayer: (target: HTMLElement, mml: string, options?: MountPlayerOptions) => MmlPlayerInstance;
+    /** 楽器プリセットを（指定トラックぶん）ロードする。 */
+    loadPreset: (presetKey: string, trackIds?: string[]) => Promise<void>;
+    /** AudioContext を閉じ、生成物を破棄する。 */
+    dispose: () => void;
+};
+/**
+ * 全部入りスタジオを生成する。SoundFontエンジン・ドラム音源・楽器プリセットの
+ * 初期ロードまで待ってから解決するため、await して使う。
+ */
+declare const createDtmStudio: (options?: DtmStudioOptions) => Promise<DtmStudio>;
+
 /**
  * mountDAW が注入する自己完結スタイル。
  * すべてのクラスは `dtm-` プレフィックスでスコープし、ホスト側CSSと衝突しにくくする。
@@ -1133,4 +1266,4 @@ declare const DAW_CSS = "\n@font-face {\n  font-family: 'k8x12';\n  src: url('ht
  */
 declare const injectStyles: (doc?: Document) => void;
 
-export { type AddNoteOptions, type ApplyChordOptions, type ChordPatternType, type ChordPlacement, type ConsumedSyllable, type CoreEventHandlers, 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 DawOptions, type DawViewState, type DrumPattern, type ExportMidiOptions, INSTRUMENT_PRESETS, type InstrumentPreset, KOE_BASE_URL, KOE_VOICEBANKS, KOE_VOICEBANK_LABELS, KOE_VOICEBANK_TERMS, type KoeVoiceOptions, LinkedList, type LyricSyllable, type LyricTrack, type LyricsConductor, MAX_VOCAL_VOLUME, MMLCore, type MMLDisplayToken, type MMLNotePlacement, type MidiExtraction, type MidiNotePlacement, type MidiTrackAnalysis, type MmlMeta, type MmlPlayerInstance, type MmlPlayerOptions, type Note, PITCH_MAP, PREWARM_NOTES, type ParseChordFn, type ParseChordsFn, type ParseMMLOptions, type ParseMidiFn, type ParsedMML, type PianoRollInstance, type PianoRollOptions, type PitchToken, type PlayDrumEvent, type PlayNoteEvent, type PlaybackState, type PreviewSoundCallback, type RenderConfig, type Sequencer, type SequencerOptions, type SequencerTrack, type SingingVoices, type SingingVoicesOptions, type StreamVoiceNote, type StreamVoiceTrack, TRACKS_ADVANCED, TRACKS_SIMPLE, type ToolMode, type TrackConfig, VOICE_IMAGE_KEY, type VoiceModel, type VoiceRegistry, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, buildChordPlacements, buildNameToKeyMapping, collectPitchTokens, createAudioContext, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createSequencer, createSingingVoices, createVoiceRegistry, decomposeToMonophonic, drawGrid, drawHeader, drawKeyboard, drawNotes, drawSelectedNotes, drawSelectionRect, exportMIDI, extractMidiPlacements, extractMidiPlacementsByTrack, fetchSoundFontList, formatMmlMeta, generateRandomPattern, getDrawOffset, getGridCanvas, getGridContext, getGridPosition, getHeaderCanvas, getMidiBPM, getRenderConfig, getXY, icon, init, injectStyles, isChordHeavyTrack, koeUrl, mountDAW, mountMmlPlayer, normalizeLyrics, onClick, panToStereo, parseLyrics, parseMML, parseMmlMeta, setDrawOffset, setupRecorder, shiftNotes, stripLyrics, stripMmlMeta, vocalVolumeToGain };
+export { type AddNoteOptions, type ApplyChordOptions, type ChordPatternType, type ChordPlacement, type ConsumedSyllable, type CoreEventHandlers, 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 DawOptions, type DawViewState, type DrumPattern, type DtmStudio, type DtmStudioEngines, type DtmStudioOptions, type ExportMidiOptions, INSTRUMENT_PRESETS, type InstrumentPreset, KOE_BASE_URL, KOE_VOICEBANKS, KOE_VOICEBANK_LABELS, KOE_VOICEBANK_TERMS, type KoeVoiceOptions, LinkedList, type LyricSyllable, type LyricTrack, type LyricsConductor, MAX_VOCAL_VOLUME, MMLCore, type MMLDisplayToken, type MMLNotePlacement, type MidiExtraction, type MidiNotePlacement, type MidiTrackAnalysis, type MmlMeta, type MmlPlayerInstance, type MmlPlayerOptions, type MountEditorOptions, type MountPlayerOptions, type Note, PITCH_MAP, PREWARM_NOTES, type ParseChordFn, type ParseChordsFn, type ParseMMLOptions, type ParseMidiFn, type ParsedMML, type PianoRollInstance, type PianoRollOptions, type PitchToken, type PlayDrumEvent, type PlayNoteEvent, type PlaybackState, type PreviewSoundCallback, type RenderConfig, type Sequencer, type SequencerOptions, type SequencerTrack, type SingingVoices, type SingingVoicesOptions, type StreamVoiceNote, type StreamVoiceTrack, TRACKS_ADVANCED, TRACKS_SIMPLE, type ToolMode, type TrackConfig, VOICE_IMAGE_KEY, type VoiceModel, type VoiceRegistry, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, buildChordPlacements, buildNameToKeyMapping, collectPitchTokens, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createSequencer, createSingingVoices, createVoiceRegistry, decomposeToMonophonic, drawGrid, drawHeader, drawKeyboard, drawNotes, drawSelectedNotes, drawSelectionRect, exportMIDI, extractMidiPlacements, extractMidiPlacementsByTrack, fetchSoundFontList, formatMmlMeta, generateRandomPattern, getDrawOffset, getGridCanvas, getGridContext, getGridPosition, getHeaderCanvas, getMidiBPM, getRenderConfig, getXY, icon, init, injectStyles, isChordHeavyTrack, koeUrl, mountDAW, mountMmlPlayer, normalizeLyrics, onClick, panToStereo, parseLyrics, parseMML, parseMmlMeta, setDrawOffset, setupRecorder, shiftNotes, stripLyrics, stripMmlMeta, vocalVolumeToGain };

package/dist/index.d.ts

@@ -1121,6 +1121,139 @@ type Sequencer = {
 };
 declare const createSequencer: (options: SequencerOptions) => Sequencer;
 
+/**
+ * createDtmStudio — 「import して関数1つ」で鳴る、全部入りスタジオ（Layer 3）。
+ *
+ * @onjmin/dtm 本体（mountDAW / mountMmlPlayer）は発音を持たない注入式設計で、
+ * 楽器・ドラムの実音は外部 SoundFont（rpgen3）に委ねる。デモ index.html では
+ * その配線（AudioContext・SoundFontロード・歌声ワーカー・録音・MIDI/コード解析）を
+ * 手書きしていたが、本モジュールはそれを丸ごと内包する。
+ *
+ *   const studio = await createDtmStudio();
+ *   studio.mountEditor(editorEl, { initialMML });  // 編集UI（音・歌声込み）
+ *   studio.mountPlayer(playerEl, mml);             // 再生専用UI（音・歌声込み）
+ *
+ * 何も渡さなければ rpgen3 SoundFont を実行時にCDNから動的importし、歌声合成ワーカーは
+ * パッケージ同梱の dist/voice-worker.js を用いる。エンジンやURLは options で差し替え可能。
+ */
+
+type SoundFontInstance = {
+    play: (o: {
+        ctx: AudioContext;
+        destination: AudioNode;
+        pitch: number;
+        volume: number;
+        when: number;
+        duration: number;
+    }) => void;
+};
+type SoundFontEngine = {
+    load: (o: {
+        ctx: AudioContext;
+        fontName: string;
+        url: string;
+    }) => Promise<SoundFontInstance>;
+    toURL: (fullName: string) => string;
+};
+type SoundFontDrumEngine = {
+    load: (o: {
+        ctx: AudioContext;
+        font: string;
+        id: string;
+        keys: number[];
+    }) => Promise<void>;
+    play: (o: {
+        ctx: AudioContext;
+        destination: AudioNode;
+        pitch: number;
+        volume: number;
+        when: number;
+        duration: number;
+    }) => void;
+    font: unknown;
+};
+type SoundFontListEngine = {
+    init: () => void;
+    onload: (cb: () => void) => void;
+};
+/** 注入で差し替え可能な外部エンジン群（未指定なら CDN から取得）。 */
+type DtmStudioEngines = {
+    SoundFont?: SoundFontEngine;
+    SoundFont_drum?: SoundFontDrumEngine;
+    SoundFont_list?: SoundFontListEngine;
+    parseChord?: DawOptions["parseChord"];
+    parseChords?: DawOptions["parseChords"];
+    parseMidi?: DawOptions["parseMidi"];
+};
+/** 既定の取得元URL（rpgen3 / jsDelivr）。options.cdn で個別に上書きできる。 */
+declare const DEFAULT_CDN: {
+    readonly soundFont: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont.mjs";
+    readonly soundFontDrum: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont_drum.mjs";
+    readonly soundFontList: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont_list.mjs";
+    readonly parseChord: "https://rpgen3.github.io/piano/mjs/parseChord.mjs";
+    readonly parseChords: "https://rpgen3.github.io/piano/mjs/parseChords.mjs";
+    readonly midiParser: "https://cdn.jsdelivr.net/npm/midi-parser-js@4.0.4/+esm";
+};
+type DtmStudioOptions = {
+    /** 既存の AudioContext を使う（未指定なら内部生成）。 */
+    audioContext?: AudioContext;
+    /** マスター音量 0-1（楽器・歌声）。既定 1。 */
+    masterVolume?: number;
+    /** ドラム音量 0-1。既定 1。 */
+    drumVolume?: number;
+    /**
+     * 歌声合成ワーカー（voice-worker.js）のURL。
+     * 既定はパッケージ同梱の dist/voice-worker.js。
+     * `null` を渡すとワーカーを使わず klatt のみ（koe音源はメインスレッド合成）。
+     */
+    voiceWorkerUrl?: string | null;
+    /** 初期の楽器プリセットキー（INSTRUMENT_PRESETS）。既定 "retro_game"。 */
+    defaultPreset?: string;
+    /** 外部エンジンの注入（指定したものは CDN 取得をスキップ）。 */
+    engines?: DtmStudioEngines;
+    /** CDN URL の上書き。 */
+    cdn?: Partial<typeof DEFAULT_CDN>;
+    /** 有効化する機能。既定はすべて true。 */
+    features?: {
+        /** 録音→WAVダウンロード（編集UIの録音ボタン）。 */
+        recorder?: boolean;
+        /** MIDIファイル読み込み。 */
+        midi?: boolean;
+        /** コード入力（和音）。 */
+        chord?: boolean;
+        /** 編集UIに楽器プリセット選択UIを差し込む。 */
+        presetUI?: boolean;
+    };
+};
+/** 編集UIのマウント時オプション（DawOptions を一部上書きできる）。 */
+type MountEditorOptions = Partial<DawOptions> & {
+    /** このエディタで読み込む楽器プリセット（未指定なら studio の defaultPreset）。 */
+    preset?: string;
+    /** プリセット選択UIを出すか（未指定なら studio の features.presetUI）。 */
+    presetUI?: boolean;
+};
+/** 再生UIのマウント時オプション（MmlPlayerOptions を一部上書きできる）。 */
+type MountPlayerOptions = Partial<MmlPlayerOptions>;
+type DtmStudio = {
+    /** 内部で使用している AudioContext。 */
+    audioContext: AudioContext;
+    /** 歌声合成ヘルパ（klatt + koe音源）。 */
+    singingVoices: SingingVoices;
+    /** 編集UI（mountDAW）を音・歌声込みでマウントする。 */
+    mountEditor: (target: HTMLElement, options?: MountEditorOptions) => DawInstance;
+    /** 再生専用UI（mountMmlPlayer）を音・歌声込みでマウントする。 */
+    mountPlayer: (target: HTMLElement, mml: string, options?: MountPlayerOptions) => MmlPlayerInstance;
+    /** 楽器プリセットを（指定トラックぶん）ロードする。 */
+    loadPreset: (presetKey: string, trackIds?: string[]) => Promise<void>;
+    /** AudioContext を閉じ、生成物を破棄する。 */
+    dispose: () => void;
+};
+/**
+ * 全部入りスタジオを生成する。SoundFontエンジン・ドラム音源・楽器プリセットの
+ * 初期ロードまで待ってから解決するため、await して使う。
+ */
+declare const createDtmStudio: (options?: DtmStudioOptions) => Promise<DtmStudio>;
+
 /**
  * mountDAW が注入する自己完結スタイル。
  * すべてのクラスは `dtm-` プレフィックスでスコープし、ホスト側CSSと衝突しにくくする。
@@ -1133,4 +1266,4 @@ declare const DAW_CSS = "\n@font-face {\n  font-family: 'k8x12';\n  src: url('ht
  */
 declare const injectStyles: (doc?: Document) => void;
 
-export { type AddNoteOptions, type ApplyChordOptions, type ChordPatternType, type ChordPlacement, type ConsumedSyllable, type CoreEventHandlers, 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 DawOptions, type DawViewState, type DrumPattern, type ExportMidiOptions, INSTRUMENT_PRESETS, type InstrumentPreset, KOE_BASE_URL, KOE_VOICEBANKS, KOE_VOICEBANK_LABELS, KOE_VOICEBANK_TERMS, type KoeVoiceOptions, LinkedList, type LyricSyllable, type LyricTrack, type LyricsConductor, MAX_VOCAL_VOLUME, MMLCore, type MMLDisplayToken, type MMLNotePlacement, type MidiExtraction, type MidiNotePlacement, type MidiTrackAnalysis, type MmlMeta, type MmlPlayerInstance, type MmlPlayerOptions, type Note, PITCH_MAP, PREWARM_NOTES, type ParseChordFn, type ParseChordsFn, type ParseMMLOptions, type ParseMidiFn, type ParsedMML, type PianoRollInstance, type PianoRollOptions, type PitchToken, type PlayDrumEvent, type PlayNoteEvent, type PlaybackState, type PreviewSoundCallback, type RenderConfig, type Sequencer, type SequencerOptions, type SequencerTrack, type SingingVoices, type SingingVoicesOptions, type StreamVoiceNote, type StreamVoiceTrack, TRACKS_ADVANCED, TRACKS_SIMPLE, type ToolMode, type TrackConfig, VOICE_IMAGE_KEY, type VoiceModel, type VoiceRegistry, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, buildChordPlacements, buildNameToKeyMapping, collectPitchTokens, createAudioContext, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createSequencer, createSingingVoices, createVoiceRegistry, decomposeToMonophonic, drawGrid, drawHeader, drawKeyboard, drawNotes, drawSelectedNotes, drawSelectionRect, exportMIDI, extractMidiPlacements, extractMidiPlacementsByTrack, fetchSoundFontList, formatMmlMeta, generateRandomPattern, getDrawOffset, getGridCanvas, getGridContext, getGridPosition, getHeaderCanvas, getMidiBPM, getRenderConfig, getXY, icon, init, injectStyles, isChordHeavyTrack, koeUrl, mountDAW, mountMmlPlayer, normalizeLyrics, onClick, panToStereo, parseLyrics, parseMML, parseMmlMeta, setDrawOffset, setupRecorder, shiftNotes, stripLyrics, stripMmlMeta, vocalVolumeToGain };
+export { type AddNoteOptions, type ApplyChordOptions, type ChordPatternType, type ChordPlacement, type ConsumedSyllable, type CoreEventHandlers, 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 DawOptions, type DawViewState, type DrumPattern, type DtmStudio, type DtmStudioEngines, type DtmStudioOptions, type ExportMidiOptions, INSTRUMENT_PRESETS, type InstrumentPreset, KOE_BASE_URL, KOE_VOICEBANKS, KOE_VOICEBANK_LABELS, KOE_VOICEBANK_TERMS, type KoeVoiceOptions, LinkedList, type LyricSyllable, type LyricTrack, type LyricsConductor, MAX_VOCAL_VOLUME, MMLCore, type MMLDisplayToken, type MMLNotePlacement, type MidiExtraction, type MidiNotePlacement, type MidiTrackAnalysis, type MmlMeta, type MmlPlayerInstance, type MmlPlayerOptions, type MountEditorOptions, type MountPlayerOptions, type Note, PITCH_MAP, PREWARM_NOTES, type ParseChordFn, type ParseChordsFn, type ParseMMLOptions, type ParseMidiFn, type ParsedMML, type PianoRollInstance, type PianoRollOptions, type PitchToken, type PlayDrumEvent, type PlayNoteEvent, type PlaybackState, type PreviewSoundCallback, type RenderConfig, type Sequencer, type SequencerOptions, type SequencerTrack, type SingingVoices, type SingingVoicesOptions, type StreamVoiceNote, type StreamVoiceTrack, TRACKS_ADVANCED, TRACKS_SIMPLE, type ToolMode, type TrackConfig, VOICE_IMAGE_KEY, type VoiceModel, type VoiceRegistry, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, buildChordPlacements, buildNameToKeyMapping, collectPitchTokens, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createSequencer, createSingingVoices, createVoiceRegistry, decomposeToMonophonic, drawGrid, drawHeader, drawKeyboard, drawNotes, drawSelectedNotes, drawSelectionRect, exportMIDI, extractMidiPlacements, extractMidiPlacementsByTrack, fetchSoundFontList, formatMmlMeta, generateRandomPattern, getDrawOffset, getGridCanvas, getGridContext, getGridPosition, getHeaderCanvas, getMidiBPM, getRenderConfig, getXY, icon, init, injectStyles, isChordHeavyTrack, koeUrl, mountDAW, mountMmlPlayer, normalizeLyrics, onClick, panToStereo, parseLyrics, parseMML, parseMmlMeta, setDrawOffset, setupRecorder, shiftNotes, stripLyrics, stripMmlMeta, vocalVolumeToGain };

package/dist/index.js

@@ -51,6 +51,7 @@ __export(index_exports, {
   buildNameToKeyMapping: () => buildNameToKeyMapping,
   collectPitchTokens: () => collectPitchTokens,
   createAudioContext: () => createAudioContext,
+  createDtmStudio: () => createDtmStudio,
   createKlattVoice: () => createKlattVoice,
   createKoeVoice: () => createKoeVoice,
   createLyricsConductor: () => createLyricsConductor,
@@ -6490,8 +6491,6 @@ var mountMmlPlayer = (target, mml, options = {}) => {
       if (useSynth) synthPlay(e);
     },
     onPlayDrum: (e) => {
-      const em = emojiEls[0];
-      if (em) jumpEmojiAt(em, e.when);
       const velocity = e.velocity * (trackVolume / 100);
       options.onPlayDrum?.({ ...e, velocity });
       if (useSynth) drumSynth({ ...e, velocity });
@@ -6884,6 +6883,324 @@ var createPianoRoll = (options, handlers) => {
     }
   };
 };
+
+// src/studio.ts
+var import_meta = {};
+var DEFAULT_CDN = {
+  soundFont: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont.mjs",
+  soundFontDrum: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont_drum.mjs",
+  soundFontList: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont_list.mjs",
+  parseChord: "https://rpgen3.github.io/piano/mjs/parseChord.mjs",
+  parseChords: "https://rpgen3.github.io/piano/mjs/parseChords.mjs",
+  midiParser: "https://cdn.jsdelivr.net/npm/midi-parser-js@4.0.4/+esm"
+};
+var SOUNDFONT_NAME = "FluidR3_GM_sf2_file";
+var TRACK_ROLES = ["melody", "submelody", "bass", "chord"];
+var resolveDefaultVoiceWorkerUrl = () => {
+  try {
+    return new URL("./voice-worker.js", import_meta.url).href;
+  } catch {
+    return void 0;
+  }
+};
+var importFrom = async (url, name) => {
+  const mod = await import(
+    /* @vite-ignore */
+    url
+  );
+  return mod[name] ?? mod.default;
+};
+var createDtmStudio = async (options = {}) => {
+  const cdn = { ...DEFAULT_CDN, ...options.cdn };
+  const features = {
+    recorder: true,
+    midi: true,
+    chord: true,
+    presetUI: true,
+    ...options.features
+  };
+  const audioCtx = options.audioContext ?? new AudioContext();
+  const masterGain = audioCtx.createGain();
+  masterGain.gain.value = options.masterVolume ?? 1;
+  masterGain.connect(audioCtx.destination);
+  const drumGain = audioCtx.createGain();
+  drumGain.gain.value = options.drumVolume ?? 1;
+  drumGain.connect(audioCtx.destination);
+  const resumeAudio = () => {
+    if (audioCtx.state === "suspended") void audioCtx.resume();
+  };
+  const eng = options.engines ?? {};
+  const [SoundFont, SoundFont_drum, SoundFont_list] = await Promise.all([
+    eng.SoundFont ?? importFrom(cdn.soundFont, "SoundFont"),
+    eng.SoundFont_drum ?? importFrom(cdn.soundFontDrum, "SoundFont_drum"),
+    eng.SoundFont_list ?? importFrom(cdn.soundFontList, "SoundFont_list")
+  ]);
+  let parseChord = eng.parseChord;
+  let parseChords = eng.parseChords;
+  if (features.chord && (!parseChord || !parseChords)) {
+    try {
+      [parseChord, parseChords] = await Promise.all([
+        parseChord ?? importFrom(
+          cdn.parseChord,
+          "parseChord"
+        ),
+        parseChords ?? importFrom(
+          cdn.parseChords,
+          "parseChords"
+        )
+      ]);
+    } catch (e) {
+      console.warn("[dtm] \u30B3\u30FC\u30C9\u89E3\u6790\u306E\u8AAD\u307F\u8FBC\u307F\u306B\u5931\u6557\u3057\u307E\u3057\u305F", e);
+    }
+  }
+  let midiParser = null;
+  let parseMidi;
+  if (features.midi) {
+    parseMidi = eng.parseMidi;
+    if (!parseMidi) {
+      const midiPromise = importFrom(
+        cdn.midiParser,
+        "default"
+      ).then((m) => {
+        midiParser = m;
+      }).catch((e) => console.warn("[dtm] midi-parser \u306E\u8AAD\u307F\u8FBC\u307F\u306B\u5931\u6557", e));
+      void midiPromise;
+      parseMidi = (bytes) => {
+        if (!midiParser) throw new Error("midi-parser not ready");
+        return midiParser.parse(bytes);
+      };
+    }
+  }
+  const voiceWorkerUrl = options.voiceWorkerUrl === null ? void 0 : options.voiceWorkerUrl ?? resolveDefaultVoiceWorkerUrl();
+  const singingVoices = createSingingVoices(audioCtx, masterGain, {
+    voiceWorkerUrl
+  });
+  const recorder = features.recorder ? setupRecorder(audioCtx, masterGain, drumGain) : null;
+  const downloadWav = () => {
+    if (!recorder) return;
+    const recordedData = recorder.getRecordedData();
+    const ch = recordedData.length;
+    const len = recordedData[0].length;
+    if (len === 0) return;
+    const bufSize = recordedData[0][0].length;
+    const wave = new Float32Array(ch * len * bufSize);
+    let idx = 0;
+    for (let i = 0; i < len; i++)
+      for (let j = 0; j < bufSize; j++)
+        for (let k = 0; k < ch; k++) wave[idx++] = recordedData[k][i][j];
+    const sampleRate = audioCtx.sampleRate;
+    const channels = 2;
+    const bitRate = 16;
+    const step = bitRate / 8;
+    const blockSize = channels * step;
+    const byteLen = wave.length * step;
+    const view = new DataView(new ArrayBuffer(44 + byteLen));
+    const ws = (off2, s) => {
+      for (let i = 0; i < s.length; i++)
+        view.setUint8(off2 + i, s.charCodeAt(i));
+    };
+    ws(0, "RIFF");
+    view.setUint32(4, 32 + byteLen, true);
+    ws(8, "WAVE");
+    ws(12, "fmt ");
+    view.setUint32(16, 16, true);
+    view.setUint16(20, 1, true);
+    view.setUint16(22, channels, true);
+    view.setUint32(24, sampleRate, true);
+    view.setUint32(28, sampleRate * blockSize, true);
+    view.setUint16(32, blockSize, true);
+    view.setUint16(34, bitRate, true);
+    ws(36, "data");
+    view.setUint32(40, byteLen, true);
+    const clamp4 = (n, a2, b) => Math.max(a2, Math.min(b, n));
+    let off = 44;
+    for (let i = 0; i < wave.length; i++, off += step)
+      view.setInt16(
+        off,
+        clamp4(Math.round(wave[i] * 32768), -32768, 32767),
+        true
+      );
+    const blob = new Blob([view], { type: "audio/wav" });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = "record.wav";
+    a.click();
+    URL.revokeObjectURL(url);
+  };
+  const onToggleRecord = recorder ? () => {
+    if (recorder.isRecording()) {
+      recorder.stopRecording();
+      downloadWav();
+    } else {
+      recorder.clearRecordedData();
+      recorder.startRecording();
+    }
+  } : void 0;
+  const listReady = new Promise((resolve) => {
+    SoundFont_list.init();
+    SoundFont_list.onload(() => resolve());
+  });
+  const drumReady = (async () => {
+    try {
+      await SoundFont_drum.load({
+        ctx: audioCtx,
+        font: DRUM_FONT,
+        id: "0",
+        keys: Object.values(DRUM_KEYS)
+      });
+    } catch (e) {
+      console.error("[dtm] \u30C9\u30E9\u30E0\u97F3\u6E90\u306E\u8AAD\u307F\u8FBC\u307F\u306B\u5931\u6557", e);
+    }
+  })();
+  let nameToKey = {};
+  const soundFonts = /* @__PURE__ */ new Map();
+  const loadedKeyByTrack = /* @__PURE__ */ new Map();
+  const loadSoundFont = async (instrumentKey, trackId) => {
+    if (loadedKeyByTrack.get(trackId) === instrumentKey) return;
+    try {
+      const fullName = `${instrumentKey}_${SOUNDFONT_NAME}`;
+      soundFonts.set(
+        trackId,
+        await SoundFont.load({
+          ctx: audioCtx,
+          fontName: `_tone_${fullName}`,
+          url: SoundFont.toURL(fullName)
+        })
+      );
+      loadedKeyByTrack.set(trackId, instrumentKey);
+    } catch (e) {
+      console.error(`[dtm] \u697D\u5668 "${instrumentKey}" \u306E\u8AAD\u307F\u8FBC\u307F\u306B\u5931\u6557`, e);
+    }
+  };
+  const defaultPreset = options.defaultPreset ?? "retro_game";
+  const instrumentNameFor = (preset, trackId) => preset[trackId] ?? preset.melody;
+  const loadPreset = async (presetKey, trackIds = [...TRACK_ROLES]) => {
+    const preset = INSTRUMENT_PRESETS[presetKey];
+    if (!preset) return;
+    await listReady;
+    await Promise.all(
+      trackIds.map((trackId) => {
+        const key = nameToKey[instrumentNameFor(preset, trackId)];
+        return key ? loadSoundFont(key, trackId) : Promise.resolve();
+      })
+    );
+  };
+  await listReady;
+  nameToKey = await buildNameToKeyMapping();
+  await Promise.all([drumReady, loadPreset(defaultPreset)]);
+  const playNote = (e) => {
+    const sf = soundFonts.get(e.trackId);
+    if (!sf) return;
+    sf.play({
+      ctx: audioCtx,
+      destination: masterGain,
+      pitch: e.pitch,
+      volume: e.volume,
+      when: e.when,
+      duration: e.duration
+    });
+  };
+  const playDrum = (e) => {
+    if (!SoundFont_drum.font) return;
+    SoundFont_drum.play({
+      ctx: audioCtx,
+      destination: drumGain,
+      pitch: e.pitch,
+      volume: e.velocity,
+      when: e.when,
+      duration: e.duration
+    });
+  };
+  const sfForPlayerTrack = (trackId) => soundFonts.get(TRACK_ROLES[Number(trackId)] ?? "") ?? soundFonts.get(`t${trackId}`);
+  const playPlayerNote = (e) => {
+    const sf = sfForPlayerTrack(e.trackId);
+    if (!sf) return;
+    sf.play({
+      ctx: audioCtx,
+      destination: masterGain,
+      pitch: e.pitch,
+      volume: e.volume,
+      when: e.when,
+      duration: e.duration
+    });
+  };
+  const editorPresetSelects = /* @__PURE__ */ new WeakMap();
+  const mountedEditors = [];
+  const mountedPlayers = [];
+  const mountEditor = (target, opts = {}) => {
+    const { preset, presetUI, ...dawOverrides } = opts;
+    const tracks = dawOverrides.tracks ?? TRACKS_SIMPLE;
+    const trackIds = tracks.map((t) => t.id);
+    const base = {
+      getAudioTime: () => audioCtx.currentTime,
+      onResumeAudio: resumeAudio,
+      onPlayNote: playNote,
+      onPlayDrum: playDrum,
+      singingVoices,
+      parseChord,
+      parseChords,
+      parseMidi,
+      onToggleRecord,
+      ...dawOverrides
+    };
+    const wantPresetUI = presetUI ?? features.presetUI;
+    if (wantPresetUI) {
+      const select = target.ownerDocument.createElement("select");
+      select.className = "dtm-studio-preset";
+      for (const [key, p] of Object.entries(INSTRUMENT_PRESETS)) {
+        const opt = target.ownerDocument.createElement("option");
+        opt.value = key;
+        opt.textContent = p.displayName;
+        select.appendChild(opt);
+      }
+      select.value = preset && INSTRUMENT_PRESETS[preset] ? preset : defaultPreset;
+      target.appendChild(select);
+      editorPresetSelects.set(target, select);
+      select.addEventListener("change", async () => {
+        daw.setInstrument(select.value);
+        await loadPreset(select.value, trackIds);
+      });
+    }
+    const daw = mountDAW(target, base);
+    mountedEditors.push(daw);
+    const presetKey = preset && INSTRUMENT_PRESETS[preset] ? preset : defaultPreset;
+    daw.setInstrument(presetKey);
+    void loadPreset(presetKey, trackIds);
+    return daw;
+  };
+  const mountPlayer = (target, mml, opts = {}) => {
+    const meta = parseMML(mml, {}).meta ?? {};
+    if (meta.instrument && INSTRUMENT_PRESETS[meta.instrument]) {
+      void loadPreset(meta.instrument);
+    }
+    const player = mountMmlPlayer(target, mml, {
+      getAudioTime: () => audioCtx.currentTime,
+      onResumeAudio: resumeAudio,
+      onPlayNote: playPlayerNote,
+      onPlayDrum: playDrum,
+      singingVoices,
+      ...opts
+    });
+    mountedPlayers.push(player);
+    return player;
+  };
+  const dispose = () => {
+    for (const p of mountedPlayers) p.destroy();
+    for (const d of mountedEditors) d.destroy();
+    mountedPlayers.length = 0;
+    mountedEditors.length = 0;
+    void audioCtx.close();
+  };
+  return {
+    audioContext: audioCtx,
+    singingVoices,
+    mountEditor,
+    mountPlayer,
+    loadPreset,
+    dispose
+  };
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DAW_CSS,
@@ -6917,6 +7234,7 @@ var createPianoRoll = (options, handlers) => {
   buildNameToKeyMapping,
   collectPitchTokens,
   createAudioContext,
+  createDtmStudio,
   createKlattVoice,
   createKoeVoice,
   createLyricsConductor,

package/dist/index.mjs

@@ -6387,8 +6387,6 @@ var mountMmlPlayer = (target, mml, options = {}) => {
       if (useSynth) synthPlay(e);
     },
     onPlayDrum: (e) => {
-      const em = emojiEls[0];
-      if (em) jumpEmojiAt(em, e.when);
       const velocity = e.velocity * (trackVolume / 100);
       options.onPlayDrum?.({ ...e, velocity });
       if (useSynth) drumSynth({ ...e, velocity });
@@ -6781,6 +6779,323 @@ var createPianoRoll = (options, handlers) => {
     }
   };
 };
+
+// src/studio.ts
+var DEFAULT_CDN = {
+  soundFont: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont.mjs",
+  soundFontDrum: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont_drum.mjs",
+  soundFontList: "https://rpgen3.github.io/soundfont/mjs/surikov/SoundFont_list.mjs",
+  parseChord: "https://rpgen3.github.io/piano/mjs/parseChord.mjs",
+  parseChords: "https://rpgen3.github.io/piano/mjs/parseChords.mjs",
+  midiParser: "https://cdn.jsdelivr.net/npm/midi-parser-js@4.0.4/+esm"
+};
+var SOUNDFONT_NAME = "FluidR3_GM_sf2_file";
+var TRACK_ROLES = ["melody", "submelody", "bass", "chord"];
+var resolveDefaultVoiceWorkerUrl = () => {
+  try {
+    return new URL("./voice-worker.js", import.meta.url).href;
+  } catch {
+    return void 0;
+  }
+};
+var importFrom = async (url, name) => {
+  const mod = await import(
+    /* @vite-ignore */
+    url
+  );
+  return mod[name] ?? mod.default;
+};
+var createDtmStudio = async (options = {}) => {
+  const cdn = { ...DEFAULT_CDN, ...options.cdn };
+  const features = {
+    recorder: true,
+    midi: true,
+    chord: true,
+    presetUI: true,
+    ...options.features
+  };
+  const audioCtx = options.audioContext ?? new AudioContext();
+  const masterGain = audioCtx.createGain();
+  masterGain.gain.value = options.masterVolume ?? 1;
+  masterGain.connect(audioCtx.destination);
+  const drumGain = audioCtx.createGain();
+  drumGain.gain.value = options.drumVolume ?? 1;
+  drumGain.connect(audioCtx.destination);
+  const resumeAudio = () => {
+    if (audioCtx.state === "suspended") void audioCtx.resume();
+  };
+  const eng = options.engines ?? {};
+  const [SoundFont, SoundFont_drum, SoundFont_list] = await Promise.all([
+    eng.SoundFont ?? importFrom(cdn.soundFont, "SoundFont"),
+    eng.SoundFont_drum ?? importFrom(cdn.soundFontDrum, "SoundFont_drum"),
+    eng.SoundFont_list ?? importFrom(cdn.soundFontList, "SoundFont_list")
+  ]);
+  let parseChord = eng.parseChord;
+  let parseChords = eng.parseChords;
+  if (features.chord && (!parseChord || !parseChords)) {
+    try {
+      [parseChord, parseChords] = await Promise.all([
+        parseChord ?? importFrom(
+          cdn.parseChord,
+          "parseChord"
+        ),
+        parseChords ?? importFrom(
+          cdn.parseChords,
+          "parseChords"
+        )
+      ]);
+    } catch (e) {
+      console.warn("[dtm] \u30B3\u30FC\u30C9\u89E3\u6790\u306E\u8AAD\u307F\u8FBC\u307F\u306B\u5931\u6557\u3057\u307E\u3057\u305F", e);
+    }
+  }
+  let midiParser = null;
+  let parseMidi;
+  if (features.midi) {
+    parseMidi = eng.parseMidi;
+    if (!parseMidi) {
+      const midiPromise = importFrom(
+        cdn.midiParser,
+        "default"
+      ).then((m) => {
+        midiParser = m;
+      }).catch((e) => console.warn("[dtm] midi-parser \u306E\u8AAD\u307F\u8FBC\u307F\u306B\u5931\u6557", e));
+      void midiPromise;
+      parseMidi = (bytes) => {
+        if (!midiParser) throw new Error("midi-parser not ready");
+        return midiParser.parse(bytes);
+      };
+    }
+  }
+  const voiceWorkerUrl = options.voiceWorkerUrl === null ? void 0 : options.voiceWorkerUrl ?? resolveDefaultVoiceWorkerUrl();
+  const singingVoices = createSingingVoices(audioCtx, masterGain, {
+    voiceWorkerUrl
+  });
+  const recorder = features.recorder ? setupRecorder(audioCtx, masterGain, drumGain) : null;
+  const downloadWav = () => {
+    if (!recorder) return;
+    const recordedData = recorder.getRecordedData();
+    const ch = recordedData.length;
+    const len = recordedData[0].length;
+    if (len === 0) return;
+    const bufSize = recordedData[0][0].length;
+    const wave = new Float32Array(ch * len * bufSize);
+    let idx = 0;
+    for (let i = 0; i < len; i++)
+      for (let j = 0; j < bufSize; j++)
+        for (let k = 0; k < ch; k++) wave[idx++] = recordedData[k][i][j];
+    const sampleRate = audioCtx.sampleRate;
+    const channels = 2;
+    const bitRate = 16;
+    const step = bitRate / 8;
+    const blockSize = channels * step;
+    const byteLen = wave.length * step;
+    const view = new DataView(new ArrayBuffer(44 + byteLen));
+    const ws = (off2, s) => {
+      for (let i = 0; i < s.length; i++)
+        view.setUint8(off2 + i, s.charCodeAt(i));
+    };
+    ws(0, "RIFF");
+    view.setUint32(4, 32 + byteLen, true);
+    ws(8, "WAVE");
+    ws(12, "fmt ");
+    view.setUint32(16, 16, true);
+    view.setUint16(20, 1, true);
+    view.setUint16(22, channels, true);
+    view.setUint32(24, sampleRate, true);
+    view.setUint32(28, sampleRate * blockSize, true);
+    view.setUint16(32, blockSize, true);
+    view.setUint16(34, bitRate, true);
+    ws(36, "data");
+    view.setUint32(40, byteLen, true);
+    const clamp4 = (n, a2, b) => Math.max(a2, Math.min(b, n));
+    let off = 44;
+    for (let i = 0; i < wave.length; i++, off += step)
+      view.setInt16(
+        off,
+        clamp4(Math.round(wave[i] * 32768), -32768, 32767),
+        true
+      );
+    const blob = new Blob([view], { type: "audio/wav" });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = "record.wav";
+    a.click();
+    URL.revokeObjectURL(url);
+  };
+  const onToggleRecord = recorder ? () => {
+    if (recorder.isRecording()) {
+      recorder.stopRecording();
+      downloadWav();
+    } else {
+      recorder.clearRecordedData();
+      recorder.startRecording();
+    }
+  } : void 0;
+  const listReady = new Promise((resolve) => {
+    SoundFont_list.init();
+    SoundFont_list.onload(() => resolve());
+  });
+  const drumReady = (async () => {
+    try {
+      await SoundFont_drum.load({
+        ctx: audioCtx,
+        font: DRUM_FONT,
+        id: "0",
+        keys: Object.values(DRUM_KEYS)
+      });
+    } catch (e) {
+      console.error("[dtm] \u30C9\u30E9\u30E0\u97F3\u6E90\u306E\u8AAD\u307F\u8FBC\u307F\u306B\u5931\u6557", e);
+    }
+  })();
+  let nameToKey = {};
+  const soundFonts = /* @__PURE__ */ new Map();
+  const loadedKeyByTrack = /* @__PURE__ */ new Map();
+  const loadSoundFont = async (instrumentKey, trackId) => {
+    if (loadedKeyByTrack.get(trackId) === instrumentKey) return;
+    try {
+      const fullName = `${instrumentKey}_${SOUNDFONT_NAME}`;
+      soundFonts.set(
+        trackId,
+        await SoundFont.load({
+          ctx: audioCtx,
+          fontName: `_tone_${fullName}`,
+          url: SoundFont.toURL(fullName)
+        })
+      );
+      loadedKeyByTrack.set(trackId, instrumentKey);
+    } catch (e) {
+      console.error(`[dtm] \u697D\u5668 "${instrumentKey}" \u306E\u8AAD\u307F\u8FBC\u307F\u306B\u5931\u6557`, e);
+    }
+  };
+  const defaultPreset = options.defaultPreset ?? "retro_game";
+  const instrumentNameFor = (preset, trackId) => preset[trackId] ?? preset.melody;
+  const loadPreset = async (presetKey, trackIds = [...TRACK_ROLES]) => {
+    const preset = INSTRUMENT_PRESETS[presetKey];
+    if (!preset) return;
+    await listReady;
+    await Promise.all(
+      trackIds.map((trackId) => {
+        const key = nameToKey[instrumentNameFor(preset, trackId)];
+        return key ? loadSoundFont(key, trackId) : Promise.resolve();
+      })
+    );
+  };
+  await listReady;
+  nameToKey = await buildNameToKeyMapping();
+  await Promise.all([drumReady, loadPreset(defaultPreset)]);
+  const playNote = (e) => {
+    const sf = soundFonts.get(e.trackId);
+    if (!sf) return;
+    sf.play({
+      ctx: audioCtx,
+      destination: masterGain,
+      pitch: e.pitch,
+      volume: e.volume,
+      when: e.when,
+      duration: e.duration
+    });
+  };
+  const playDrum = (e) => {
+    if (!SoundFont_drum.font) return;
+    SoundFont_drum.play({
+      ctx: audioCtx,
+      destination: drumGain,
+      pitch: e.pitch,
+      volume: e.velocity,
+      when: e.when,
+      duration: e.duration
+    });
+  };
+  const sfForPlayerTrack = (trackId) => soundFonts.get(TRACK_ROLES[Number(trackId)] ?? "") ?? soundFonts.get(`t${trackId}`);
+  const playPlayerNote = (e) => {
+    const sf = sfForPlayerTrack(e.trackId);
+    if (!sf) return;
+    sf.play({
+      ctx: audioCtx,
+      destination: masterGain,
+      pitch: e.pitch,
+      volume: e.volume,
+      when: e.when,
+      duration: e.duration
+    });
+  };
+  const editorPresetSelects = /* @__PURE__ */ new WeakMap();
+  const mountedEditors = [];
+  const mountedPlayers = [];
+  const mountEditor = (target, opts = {}) => {
+    const { preset, presetUI, ...dawOverrides } = opts;
+    const tracks = dawOverrides.tracks ?? TRACKS_SIMPLE;
+    const trackIds = tracks.map((t) => t.id);
+    const base = {
+      getAudioTime: () => audioCtx.currentTime,
+      onResumeAudio: resumeAudio,
+      onPlayNote: playNote,
+      onPlayDrum: playDrum,
+      singingVoices,
+      parseChord,
+      parseChords,
+      parseMidi,
+      onToggleRecord,
+      ...dawOverrides
+    };
+    const wantPresetUI = presetUI ?? features.presetUI;
+    if (wantPresetUI) {
+      const select = target.ownerDocument.createElement("select");
+      select.className = "dtm-studio-preset";
+      for (const [key, p] of Object.entries(INSTRUMENT_PRESETS)) {
+        const opt = target.ownerDocument.createElement("option");
+        opt.value = key;
+        opt.textContent = p.displayName;
+        select.appendChild(opt);
+      }
+      select.value = preset && INSTRUMENT_PRESETS[preset] ? preset : defaultPreset;
+      target.appendChild(select);
+      editorPresetSelects.set(target, select);
+      select.addEventListener("change", async () => {
+        daw.setInstrument(select.value);
+        await loadPreset(select.value, trackIds);
+      });
+    }
+    const daw = mountDAW(target, base);
+    mountedEditors.push(daw);
+    const presetKey = preset && INSTRUMENT_PRESETS[preset] ? preset : defaultPreset;
+    daw.setInstrument(presetKey);
+    void loadPreset(presetKey, trackIds);
+    return daw;
+  };
+  const mountPlayer = (target, mml, opts = {}) => {
+    const meta = parseMML(mml, {}).meta ?? {};
+    if (meta.instrument && INSTRUMENT_PRESETS[meta.instrument]) {
+      void loadPreset(meta.instrument);
+    }
+    const player = mountMmlPlayer(target, mml, {
+      getAudioTime: () => audioCtx.currentTime,
+      onResumeAudio: resumeAudio,
+      onPlayNote: playPlayerNote,
+      onPlayDrum: playDrum,
+      singingVoices,
+      ...opts
+    });
+    mountedPlayers.push(player);
+    return player;
+  };
+  const dispose = () => {
+    for (const p of mountedPlayers) p.destroy();
+    for (const d of mountedEditors) d.destroy();
+    mountedPlayers.length = 0;
+    mountedEditors.length = 0;
+    void audioCtx.close();
+  };
+  return {
+    audioContext: audioCtx,
+    singingVoices,
+    mountEditor,
+    mountPlayer,
+    loadPreset,
+    dispose
+  };
+};
 export {
   DAW_CSS,
   DEFAULT_BPM,
@@ -6813,6 +7128,7 @@ export {
   buildNameToKeyMapping,
   collectPitchTokens,
   createAudioContext,
+  createDtmStudio,
   createKlattVoice,
   createKoeVoice,
   createLyricsConductor,

package/package.json

@@ -2,7 +2,7 @@
   "author": "onjmin",
   "license": "MIT",
   "name": "@onjmin/dtm",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "MMLを中間言語に用いた、モバイルファーストなDAW / ピアノロール打ち込みコンポーネント",
   "homepage": "https://onjmin.github.io/dtm",
   "repository": {