@onjmin/dtm 0.1.14 → 0.1.16

package/README.md

@@ -38,7 +38,7 @@ studio.mountPlayer(document.getElementById("player"), daw.getMML().full);
 | モード | トラック | MIDI 取り込み | 伴奏（コード進行）UI |
 | --- | --- | --- | --- |
 | `simple` | メロディー / サブメロ / ベース / 伴奏 の 4 本 | 各トラックの特徴から役割へ**自動分類** | `chord` トラックに表示（歌詞欄の代わり） |
-| `advanced` | TRACK 01〜16 の 16 本 | MIDI トラックを**1:1 マッピング** | なし（全トラックが通常のノート＋歌詞トラック） |
+| `advanced` | TRACK 01〜15 の 15 本（フラットな連番） | MIDI トラックを**1:1 マッピング** | なし（全トラックが通常のノート＋歌詞トラック） |
 
 ```ts
 import {
@@ -62,6 +62,26 @@ studio.mountEditor(editorEl, { mode: "advanced", tracks: TRACKS_ADVANCED });
 - MIDI のドラム（ch10）はピアノロールで編集できないため、取り込み時の**トラック選択 UI には出ません**。
 - `mode` / `tracks` は低レベル API の `mountDAW` でも同じく指定できます。
 
+### 備考: トラック採番と MIDI チャンネルの対応（暫定仕様）
+
+`advanced` の `@n` / タブ名は **MML 仕様に合わせたフラットな連番**（`@0`〜`@14` / TRACK 01〜15、欠番なし）です。
+「ch10 = ドラム」という MIDI の慣習は内部モデルには持ち込まず、**MIDI 入出力の変換時にだけ**扱います。
+
+- **出力**: レーン index → MIDI チャンネルに変換する際、打楽器ch（内部 `channel 9` = 1始まり ch10）を避けます。
+  結果、TRACK 01〜09 → ch1〜9 / **TRACK 10〜15 → ch11〜16** に書き出されます（タブ番号と MIDI ch は
+  10 番以降ズレますが、これは出力時の変換詳細です）。15 レーン ⇄ 15 個の非打楽器ch がちょうど 1:1 で、
+  チャンネル衝突は起きません。
+- **入力**: `channel 9`（ドラム）のノートは取り込まず、ドラムだけのトラックは選択 UI にも出しません。
+  選択したトラックは**選択順に上から**レーンへ詰めます（MIDI の実トラック番号やテンポトラックの有無に
+  左右されません）。
+- ドラム自体はノートレーンではなく、別系統の**ドラム設定**で編集します。
+
+> 経緯: 当初は「タブ番号 = MIDI チャンネル番号」に揃え、ドラムの ch10 をタブの欠番にする案も検討しましたが、
+> このアプリの正規フォーマットは MML（0 始まり・フラット・ドラムch非依存）であり、MIDI は境界の交換
+> フォーマットに過ぎません。MIDI の慣習を内部採番に漏らすと MML の一貫性が崩れる（モード間で採番が割れる、
+> 永続化される MML に欠番が残る等）ため、**内部は MML 仕様に寄せ、ch10=ドラムの面倒は変換層に閉じ込める**
+> 方針に決めました。
+
 ## 低レベル API（`mountDAW` / 注入式）
 
 本体は音を持たない設計で、`onPlayNote` / `onPlayDrum` に自前のシンセを繋ぐ

package/dist/index.d.mts

@@ -522,7 +522,7 @@ type PlayDrumEvent = {
     /** 秒 */
     duration: number;
 };
-type ParseMidiFn = (bytes: Uint8Array) => unknown;
+type ParseMidiFn = (bytes: Uint8Array) => unknown | Promise<unknown>;
 /**
  * 永続化対象の表示・出力設定。利用側がブラウザ再訪時に復元する用途に使う。
  * （ノートやMML本体ではなく、エディタの見え方/出力の挙動の設定）
@@ -604,7 +604,7 @@ type DawInstance = {
     /** 表示・出力設定を復元する（指定したキーのみ反映。UIにも反映する）。 */
     setViewState: (state: Partial<DawViewState>) => void;
     loadMML: (mml: string) => void;
-    loadMIDI: (bytes: Uint8Array) => void;
+    loadMIDI: (bytes: Uint8Array) => void | Promise<void>;
     exportMIDI: () => Blob;
     setBpm: (bpm: number) => void;
     getPlaybackState: () => PlaybackState;
@@ -621,7 +621,13 @@ type DawInstance = {
 
 /** シンプルモード（4トラック）— 役割別に自動分類してMIDIを読み込む */
 declare const TRACKS_SIMPLE: TrackConfig[];
-/** 上級者モード（16トラック）— MIDIトラックを1:1で扱う */
+/**
+ * advancedモード（15トラック）— MIDIトラックを1:1で扱う。
+ * 採番はMML仕様に合わせてフラットな連番（@0〜@14 / TRACK 01〜15、欠番なし）。
+ * MIDIの「ch10=ドラム」の慣習は内部モデルに持ち込まず、MIDI入出力の変換時にだけ扱う:
+ * 出力は打楽器ch（内部 channel 9）を避けて割り当て（TRACK 10以降は ch11〜16 へ）、
+ * 入力は channel 9 のドラムを除外する。ドラム自体は別系統の「ドラム設定」で編集する。
+ */
 declare const TRACKS_ADVANCED: TrackConfig[];
 /**
  * DAWコンポーネントをマウントする。
@@ -1212,7 +1218,6 @@ 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 midiParser: "https://cdn.jsdelivr.net/npm/midi-parser-js@4.0.4/+esm";
 };
 type DtmStudioOptions = {
     /** 既存の AudioContext を使う（未指定なら内部生成）。 */

package/dist/index.d.ts

@@ -522,7 +522,7 @@ type PlayDrumEvent = {
     /** 秒 */
     duration: number;
 };
-type ParseMidiFn = (bytes: Uint8Array) => unknown;
+type ParseMidiFn = (bytes: Uint8Array) => unknown | Promise<unknown>;
 /**
  * 永続化対象の表示・出力設定。利用側がブラウザ再訪時に復元する用途に使う。
  * （ノートやMML本体ではなく、エディタの見え方/出力の挙動の設定）
@@ -604,7 +604,7 @@ type DawInstance = {
     /** 表示・出力設定を復元する（指定したキーのみ反映。UIにも反映する）。 */
     setViewState: (state: Partial<DawViewState>) => void;
     loadMML: (mml: string) => void;
-    loadMIDI: (bytes: Uint8Array) => void;
+    loadMIDI: (bytes: Uint8Array) => void | Promise<void>;
     exportMIDI: () => Blob;
     setBpm: (bpm: number) => void;
     getPlaybackState: () => PlaybackState;
@@ -621,7 +621,13 @@ type DawInstance = {
 
 /** シンプルモード（4トラック）— 役割別に自動分類してMIDIを読み込む */
 declare const TRACKS_SIMPLE: TrackConfig[];
-/** 上級者モード（16トラック）— MIDIトラックを1:1で扱う */
+/**
+ * advancedモード（15トラック）— MIDIトラックを1:1で扱う。
+ * 採番はMML仕様に合わせてフラットな連番（@0〜@14 / TRACK 01〜15、欠番なし）。
+ * MIDIの「ch10=ドラム」の慣習は内部モデルに持ち込まず、MIDI入出力の変換時にだけ扱う:
+ * 出力は打楽器ch（内部 channel 9）を避けて割り当て（TRACK 10以降は ch11〜16 へ）、
+ * 入力は channel 9 のドラムを除外する。ドラム自体は別系統の「ドラム設定」で編集する。
+ */
 declare const TRACKS_ADVANCED: TrackConfig[];
 /**
  * DAWコンポーネントをマウントする。
@@ -1212,7 +1218,6 @@ 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 midiParser: "https://cdn.jsdelivr.net/npm/midi-parser-js@4.0.4/+esm";
 };
 type DtmStudioOptions = {
     /** 既存の AudioContext を使う（未指定なら内部生成）。 */