@onjmin/dtm 0.1.13 → 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コンポーネントをマウントする。
@@ -861,8 +867,13 @@ declare const getMidiBPM: (midi: unknown) => number;
  */
 declare const extractMidiPlacements: (midi: unknown, selectedTrackIndices: number[]) => MidiExtraction;
 /**
- * 上級者モード用：MIDIトラックインデックス N → DAW トラック trackIds[N] へ直接マッピング。
- * 自動分類なし。選択された MIDI トラック K のノートは DAW トラック K に入る。
+ * advancedモード用：選択された MIDI トラックを選択順に DAW トラックへ上から詰める
+ * （k番目に選んだトラック → trackIds[k]）。自動分類なし。
+ *
+ * MIDIの実トラック番号ではなく「選択順の位置」で割り当てるため、先頭のテンポ/コンダクタ
+ * トラックや、空・ドラムだけのトラックが混ざっていても DAW レーンがずれない
+ * （これらは選択リストに出ない／選ばれないので位置を消費しない）。
+ * ドラム(ch10 = channel 9)のノートはスキップする。
  */
 declare const extractMidiPlacementsByTrack: (midi: unknown, selectedIndices: number[], trackIds: string[]) => MidiExtraction;
 type ExportMidiOptions = {

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コンポーネントをマウントする。
@@ -861,8 +867,13 @@ declare const getMidiBPM: (midi: unknown) => number;
  */
 declare const extractMidiPlacements: (midi: unknown, selectedTrackIndices: number[]) => MidiExtraction;
 /**
- * 上級者モード用：MIDIトラックインデックス N → DAW トラック trackIds[N] へ直接マッピング。
- * 自動分類なし。選択された MIDI トラック K のノートは DAW トラック K に入る。
+ * advancedモード用：選択された MIDI トラックを選択順に DAW トラックへ上から詰める
+ * （k番目に選んだトラック → trackIds[k]）。自動分類なし。
+ *
+ * MIDIの実トラック番号ではなく「選択順の位置」で割り当てるため、先頭のテンポ/コンダクタ
+ * トラックや、空・ドラムだけのトラックが混ざっていても DAW レーンがずれない
+ * （これらは選択リストに出ない／選ばれないので位置を消費しない）。
+ * ドラム(ch10 = channel 9)のノートはスキップする。
  */
 declare const extractMidiPlacementsByTrack: (midi: unknown, selectedIndices: number[], trackIds: string[]) => MidiExtraction;
 type ExportMidiOptions = {

package/dist/index.js

@@ -3077,13 +3077,11 @@ var extractMidiPlacementsByTrack = (midi, selectedIndices, trackIds) => {
   const bpm = getMidiBPM(midi);
   const ticksPerStep = ticksPerBeat / STEPS_PER_BEAT;
   const placements = [];
-  const selectedSet = new Set(selectedIndices);
-  for (let midiIdx = 0; midiIdx < track.length; midiIdx++) {
-    if (!selectedSet.has(midiIdx)) continue;
-    if (midiIdx >= trackIds.length) continue;
-    const trackId = trackIds[midiIdx];
+  selectedIndices.forEach((midiIdx, lane) => {
+    if (lane >= trackIds.length) return;
     const trackData = track[midiIdx];
-    if (!trackData) continue;
+    if (!trackData) return;
+    const trackId = trackIds[lane];
     const active = [];
     let currentTime = 0;
     for (const event of trackData.event) {
@@ -3118,7 +3116,7 @@ var extractMidiPlacementsByTrack = (midi, selectedIndices, trackIds) => {
         velocity: note.velocity
       });
     }
-  }
+  });
   return { placements, bpm };
 };
 var to2byte = (n) => [(n & 65280) >> 8, n & 255];
@@ -3159,6 +3157,7 @@ var exportMIDI = (options) => {
   const midiTracks = [];
   tracks.forEach((track, ch) => {
     if (track.notes.length === 0) return;
+    const channel = ch < 9 ? ch : ch + 1 & 15;
     const events = [];
     for (const n of track.notes) {
       const startTick = Math.round(n.startStep * tickPerStep);
@@ -3168,8 +3167,8 @@ var exportMIDI = (options) => {
       const vel = Math.round(
         (n.velocity ?? DEFAULT_VELOCITY) * (track.volume ?? 100) / 100
       );
-      events.push({ t: startTick, m: [144 | ch & 15, n.pitch, vel] });
-      events.push({ t: endTick, m: [144 | ch & 15, n.pitch, 0] });
+      events.push({ t: startTick, m: [144 | channel, n.pitch, vel] });
+      events.push({ t: endTick, m: [144 | channel, n.pitch, 0] });
     }
     events.sort((a, b) => a.t - b.t);
     midiTracks.push(events);
@@ -5530,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

@@ -2972,13 +2972,11 @@ var extractMidiPlacementsByTrack = (midi, selectedIndices, trackIds) => {
   const bpm = getMidiBPM(midi);
   const ticksPerStep = ticksPerBeat / STEPS_PER_BEAT;
   const placements = [];
-  const selectedSet = new Set(selectedIndices);
-  for (let midiIdx = 0; midiIdx < track.length; midiIdx++) {
-    if (!selectedSet.has(midiIdx)) continue;
-    if (midiIdx >= trackIds.length) continue;
-    const trackId = trackIds[midiIdx];
+  selectedIndices.forEach((midiIdx, lane) => {
+    if (lane >= trackIds.length) return;
     const trackData = track[midiIdx];
-    if (!trackData) continue;
+    if (!trackData) return;
+    const trackId = trackIds[lane];
     const active = [];
     let currentTime = 0;
     for (const event of trackData.event) {
@@ -3013,7 +3011,7 @@ var extractMidiPlacementsByTrack = (midi, selectedIndices, trackIds) => {
         velocity: note.velocity
       });
     }
-  }
+  });
   return { placements, bpm };
 };
 var to2byte = (n) => [(n & 65280) >> 8, n & 255];
@@ -3054,6 +3052,7 @@ var exportMIDI = (options) => {
   const midiTracks = [];
   tracks.forEach((track, ch) => {
     if (track.notes.length === 0) return;
+    const channel = ch < 9 ? ch : ch + 1 & 15;
     const events = [];
     for (const n of track.notes) {
       const startTick = Math.round(n.startStep * tickPerStep);
@@ -3063,8 +3062,8 @@ var exportMIDI = (options) => {
       const vel = Math.round(
         (n.velocity ?? DEFAULT_VELOCITY) * (track.volume ?? 100) / 100
       );
-      events.push({ t: startTick, m: [144 | ch & 15, n.pitch, vel] });
-      events.push({ t: endTick, m: [144 | ch & 15, n.pitch, 0] });
+      events.push({ t: startTick, m: [144 | channel, n.pitch, vel] });
+      events.push({ t: endTick, m: [144 | channel, n.pitch, 0] });
     }
     events.sort((a, b) => a.t - b.t);
     midiTracks.push(events);
@@ -5425,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.13",
+  "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": {