@onjmin/dtm 0.1.14 → 0.1.15

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

@@ -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コンポーネントをマウントする。

package/dist/index.d.ts

@@ -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コンポーネントをマウントする。

package/dist/index.js

@@ -5529,13 +5529,6 @@ var TRACKS_ADVANCED = [
     color: [100, 255, 160],
     instrument: 14,
     volume: 100
-  },
-  {
-    id: "t15",
-    name: "TRACK 16",
-    color: [255, 150, 200],
-    instrument: 15,
-    volume: 100
   }
 ];
 var DEFAULT_TRACKS = TRACKS_SIMPLE;

package/dist/index.mjs

@@ -5424,13 +5424,6 @@ var TRACKS_ADVANCED = [
     color: [100, 255, 160],
     instrument: 14,
     volume: 100
-  },
-  {
-    id: "t15",
-    name: "TRACK 16",
-    color: [255, 150, 200],
-    instrument: 15,
-    volume: 100
   }
 ];
 var DEFAULT_TRACKS = TRACKS_SIMPLE;

package/package.json

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