import { PhonemeEntry, SpeakingStyleInput, UtauTTSPlan, VoiceBank, UtauTTSRenderOptions } from '@onjmin/koe';

/**
 * オーディオ設定とSoundFont管理
 * Audio Context初期化、SoundFont読み込み、ノート再生等
 */
/**
 * Audio Context初期化
 * DOMに依存しない純粋な音声設定
 */
declare function createAudioContext(): {
    audioCtx: AudioContext;
    gainNode: GainNode;
    drumGainNode: GainNode;
};
/**
 * 楽器名からキーへのマッピングを構築（静的データから生成、外部fetchなし）
 */
declare function buildNameToKeyMapping(): Promise<Record<string, string>>;
/** GM楽器名一覧（128音色）。トラック個別楽器のプルダウン選択肢に使う。 */
declare const GM_INSTRUMENT_NAMES: string[];
/**
 * 楽器名（または正規化名）からGMプログラム番号(0-127)を取得する。見つからなければ null。
 */
declare const programOfInstrumentName: (name: string) => number | null;

/**
 * 伴奏音源（mp3 / wav / YouTube）の同時再生。
 *
 * 打ち込みと**同じ時計（AudioContext）**で頭を揃えるのがこのモジュールの仕事で、
 * 音源の種類ごとに揃え方が違う:
 *
 * - `buffer` … デコード済みの {@link AudioBuffer} を `start(when, offset)` で予約する。
 *   サンプル単位で正確。オーディオグラフを通るのでWAV書き出し・録音にも入る。
 * - `element` … `<audio>` 直再生。CORSが無いURLはデコードできないのでこちらへ落ちる。
 *   グラフの外で鳴るため録音には入らない。再生開始の遅延とドリフトを実測して詰める。
 * - `youtube` … IFrame Player API。`element` と同じくグラフの外＋ドリフト補正。
 *   ただし再生速度の微調整が効かない（離散値しか受け付けない）ので、ズレたら seek で直す。
 *
 * 「曲のどこで」「音源のどこから」鳴らすかは呼び出し側が {@link backingMediaSec} で
 * 1つの数（再生開始時点における音源内の位置）へ畳んでから渡す。イントロを飛ばす、
 * 曲の途中から重ねる、といった指定はすべてこの数の符号と大きさに吸収される。
 */
/** 音源の鳴らし方。URL/ファイルの種類と、デコードできたかで決まる。 */
type BackingMode = "buffer" | "element" | "youtube";
/** 読み込み結果。UIの状態表示に使う。 */
type BackingLoaded = {
    mode: BackingMode;
    /** 音源の長さ（秒）。取得できないときは0。 */
    durationSec: number;
    /**
     * オーディオグラフを通るか（＝マスタ音量・WAV書き出し・録音に乗るか）。
     * `buffer` のみ true。
     */
    routed: boolean;
    /** 表示名（ファイル名・動画ID等）。 */
    label: string;
};
/**
 * {@link BackingAudio.startRolling} の結果。
 *
 * `measured` が false でも**音源は鳴らし始めている**（時間内に進み始めたのを
 * 確認できなかっただけ）。呼び出し側は改めて鳴らし直してはいけない——
 * 止めて鳴らし直すと、立ち上がりをもう一度やり直すことになって余計に遅れる。
 */
type BackingRoll = {
    /** 実測（または推定）した時刻。 */
    atTime: number;
    /** その時刻に音源がいた位置（秒）。 */
    mediaSec: number;
    /** 本当に進み始めたのを確認できたか。 */
    measured: boolean;
};
/** 再生開始の指定。 */
type BackingStartOptions = {
    /** 打ち込み側の再生開始時刻（`getAudioTime()` と同じ時計の絶対秒）。 */
    atTime: number;
    /**
     * `atTime` の瞬間に鳴っているべき音源内の位置（秒）。
     * {@link rangeStartSec} より手前なら「まだ鳴らさない」区間で、そこへ達した時刻から鳴り始める。
     */
    mediaSec: number;
    /** 音源を鳴らし始める位置（秒）。未指定なら頭から。ここより手前は鳴らさない。 */
    rangeStartSec?: number;
    /** 音源を止める位置（秒）。0/未指定なら最後まで。 */
    endSec?: number;
};
type BackingAudio = {
    /** 音源を読み込む。URL文字列（mp3/wav/YouTube）またはアップロードされたファイル。 */
    load: (src: string | File) => Promise<BackingLoaded>;
    /** 読み込み済みの音源を破棄する（再生中なら止める）。 */
    clear: () => void;
    /**
     * 再生開始の直前に呼ぶ準備。YouTubeのように「鳴り始めるまで待ちが要る」音源が
     * 目的位置をバッファするための猶予で、他の音源では何もしない。
     */
    arm: (mediaSec: number) => Promise<void>;
    start: (options: BackingStartOptions) => void;
    /**
     * 音源を**今すぐ**鳴らし始め、本当に音が進み出すまで待ってから、
     * 「その瞬間の時計（`getAudioTime` と同じ絶対秒）と、そのとき音源がいた位置」を返す。
     *
     * 再生要求から実際に鳴り出すまでの遅れは環境依存で事前に読めない
     * （YouTubeのバッファ、`<audio>` のデコード、初回再生のウォームアップ等）。
     * 呼び出し側はこの実測値を見て、**打ち込み側の開始時刻を決められる**。
     *
     * 待ち合わせるのは**待たないと直しようがない音源だけ**（YouTube）。
     * - デコード済み（`buffer`）… 予約がサンプル単位で正確。`null`。
     * - `<audio>` 直再生 … 予約してから実測で詰めるほうが精度が出る（実測で数ms）。
     *   待ち合わせると、待った時点で音源が先行してしまい、戻す手段が
     *   seek（＝毎回100ms前後の立ち上がりを伴う）しか無くなる。`null`。
     * - 時間内に鳴り始めなかった … `null`（呼び出し側は従来どおり予約で始める）。
     */
    startRolling: (options: {
        mediaSec: number;
        rangeStartSec?: number;
        endSec?: number;
        /** 鳴り始めを待つ上限（秒）。既定5。 */
        timeoutSec?: number;
    }) => Promise<BackingRoll | null>;
    /**
     * 鳴らしたまま、合わせる先（時刻と音源位置の対応）だけ差し替える。
     * {@link startRolling} の実測で打ち込み側の開始時刻がずれたときに、
     * 音源をそこへ合わせ直すために使う。
     */
    rebase: (line: {
        atTime: number;
        mediaSec: number;
    }, options?: {
        snap?: boolean;
    }) => void;
    stop: () => void;
    /** 0-100。 */
    setVolume: (volume: number) => void;
    setMuted: (muted: boolean) => void;
    /** 読み込み済みなら true。 */
    isLoaded: () => boolean;
    getLoaded: () => BackingLoaded | null;
    destroy: () => void;
};
type BackingAudioOptions = {
    audioContext: AudioContext;
    /** グラフを通る音源（buffer）の接続先。通常はマスタゲイン。 */
    destination: AudioNode;
    /** YouTubeプレイヤーを描く枠。未指定/nullのときYouTubeは読み込めない。 */
    getYoutubeContainer?: () => HTMLElement | null;
    /** 読み込み・再生の失敗を利用側へ伝える（UIの状態表示用）。 */
    onError?: (message: string) => void;
};
/**
 * 再生開始時点における音源内の位置（秒）を求める。
 *
 * 音源と打ち込みのずれは「**どちらが何秒先に始まるか**」の1つの符号付きの数
 * （{@link BackingOffset.offsetSec}）だけで決まる。
 *
 * - `offsetSec > 0` … 音源が先。その秒数だけ音源を鳴らしてから打ち込みが始まる。
 * - `offsetSec < 0` … 打ち込みが先。その秒数だけ経ってから音源が鳴り出す。
 * - `offsetSec = 0` … 同時。
 *
 * 戻り値が再生範囲の開始より手前なら、そこへ届くまで音源は鳴らない（負なら待ち時間）。
 */
declare const backingMediaSec: (o: BackingOffset) => number;
/** {@link backingMediaSec} の引数。 */
type BackingOffset = {
    /** 打ち込みの再生開始ステップ。 */
    fromStep: number;
    /** 開始のずれ（秒）。正=音源が先、負=打ち込みが先。 */
    offsetSec: number;
    /** 音源の再生範囲の開始（秒）。頭のいらない部分を飛ばす。 */
    rangeStartSec: number;
    secondsPerStep: number;
};
/**
 * `1:23.456` / `83.456` / `1:02:03` のような時間表記を秒へ直す。
 * 読めない文字列は null（呼び出し側で入力を弾く）。
 */
declare const parseTimeSec: (text: string) => number | null;
/** 秒を `1:23.456` 表記へ直す（1時間以上は `1:02:03.000`）。 */
declare const formatTimeSec: (sec: number) => string;
/** YouTubeのURLから動画IDを取り出す（`youtu.be` 短縮・`/embed/`・`/shorts/` も見る）。 */
declare const parseYoutubeId: (url: string) => string | null;
/** URLがYouTubeか。 */
declare const isYoutubeUrl: (url: string) => boolean;
/**
 * 動画IDからサムネイル画像のURLを決める（APIキーも通信の事前確認も要らない）。
 *
 * `maxresdefault` は**無い動画がある**（元が低解像度・古い投稿）ので、実際に
 * 読み込んで確かめてから返す。存在しないサムネに対してYouTubeは404だけでなく
 * 120×90のグレー画像を返すことがあるため、大きさでも弾く。
 *
 * 見つからなければ null。呼び出し側は「背景を出さない」を選べる。
 */
declare const resolveYoutubeThumbnail: (videoId: string) => Promise<string | null>;
declare const createBackingAudio: (options: BackingAudioOptions) => BackingAudio;

type MountChordPlayerOptions = {
    /** 使用する AudioContext（省略時は内部生成） */
    audioContext?: AudioContext;
    /** 音量 0-100 */
    volume?: number;
    /** BPM 既定120 */
    bpm?: number;
    /** ループ再生（既定オフ）。#loop=on メタ行でも指定可 */
    loop?: boolean;
    /** スタジオインスタンス（DtmStudio）。指定時は高品質SoundFontが使われます */
    studio?: any;
    /** 再生終了時コールバック */
    onStop?: () => void;
    /** 埋め込みプレイヤーのベースURL */
    embedUrl?: string;
    /** 進行中のコード文字列を取得する */
    getChords?: () => string;
    /** モーダル等の表示をスキップするか（再帰防止用） */
    _skipInfoModals?: boolean;
};
type ChordPlayerInstance = {
    element: HTMLElement;
    /** 再生開始。fromIndex でコードイベントの途中から開始できる */
    play: (fromIndex?: number) => void;
    stop: () => void;
    destroy: () => void;
    /** メトロノームのオン/オフを切り替える */
    toggleMetronome: () => void;
    /** 再生中か否かを取得する */
    isPlaying: () => boolean;
    /** マスタ音量を 0-100 で変更する。 */
    setVolume: (volume: number) => void;
};
/**
 * コード進行再生専用プレイヤーを target 要素にマウントする。
 * デザインは dtm- クラス体系（PICO-8カラー・ゲームウィンドウ枠）に準拠。
 */
declare const mountChordPlayer: (target: HTMLElement, chords: string, options?: MountChordPlayerOptions) => ChordPlayerInstance;

/**
 * 音律（12平均律 / 31平均律）と、ピッチの内部表現。
 *
 * ## 単位
 *
 * ノートのピッチは **1/372オクターブの整数** で持つ。372 = 12 × 31 で、12と31は
 * 互いに素なので最小公倍数がこれになり、**12平均律と31平均律の両方が誤差ゼロで
 * 同じ数直線に乗る**。
 *
 *   12平均律 1半音 = 31 units
 *   31平均律 1度   = 12 units
 *   1 unit = 1200/372 ≒ 3.2258 セント
 *
 * 整数のままなので `a.pitchUnits === b.pitchUnits` の同値判定が全部生き残る
 * （重複判定・当たり判定・協調編集の (startStep, pitchUnits) キー）。小数にすると
 * ここが軒並み壊れるため、細かい整数単位を選んでいる。
 *
 * ## 音律は音声経路に入らない
 *
 * ピッチが絶対値なので、シーケンサも発音器も音律を知らなくてよい。音律は
 * 「格子・記譜・表示」だけに効く編集上の概念で、`RenderConfig.edo` に置く。
 */
/**
 * ピッチの単位を型で区別するためのブランド。
 *
 * `Units` と `MidiNote` はどちらも実体は number だが、互いに代入できない。「半音の数値を
 * units のつもりで使う」「units を SoundFont の MIDIノート番号として渡す」といった取り違えを
 * **コンパイラに検出させる**ため——単位の取り違えは型が同じ number である限り一切検出できない。
 *
 * 生の number から作るときは {@link units} / {@link midiNote} を通す。変換は
 * {@link midiToUnits} / {@link unitsToMidi} など、この module の関数に集約する。
 */
declare const UNITS_BRAND: unique symbol;
declare const MIDI_BRAND: unique symbol;
/** ピッチ。1/372オクターブの整数。 */
type Units = number & {
    readonly [UNITS_BRAND]: true;
};
/** MIDIノート番号（半音）。0-127。SoundFont のゾーン選択やMIDI入出力で使う。 */
type MidiNote = number & {
    readonly [MIDI_BRAND]: true;
};
/** 生の数値を units として扱う。単位が units であると確信できる箇所だけで使う。 */
declare const units: (n: number) => Units;
/** 生の数値をMIDIノート番号として扱う。MIDI入出力の境界だけで使う。 */
declare const midiNote: (n: number) => MidiNote;
/** units 同士・units と生の差分の加算。結果も units。 */
declare const addUnits: (a: Units, delta: number) => Units;
/** 1オクターブあたりの units。12 × 31。 */
declare const UNITS_PER_OCTAVE = 372;
/** 12平均律の1半音あたりの units。 */
declare const UNITS_PER_SEMITONE: number;
/** 31平均律の1度あたりの units。 */
declare const UNITS_PER_EDO31_DEGREE: number;
/** 1 unit のセント値。 */
declare const CENTS_PER_UNIT: number;
/** A4 (MIDI 69) の units。周波数計算の基準。 */
declare const A4_UNITS: Units;
/** A4 の周波数(Hz)。 */
declare const A4_HZ = 440;
/** 対応する音律（1オクターブの分割数）。 */
type Edo = 12 | 31;
/** 既定の音律。宣言のない曲はすべてこれ（＝既存データは素通り）。 */
declare const DEFAULT_EDO: Edo;
/** その音律の1格子ステップが何 units か。 */
declare const unitsPerStep: (edo: Edo) => number;
/** MIDIノート番号 → units。 */
declare const midiToUnits: (midi: MidiNote | number) => Units;
/**
 * units → MIDIノート番号（小数）。
 * 歌声合成（koe）は Hz を受けるためこの小数値をそのまま渡してよい。
 * SoundFont のように整数ゾーンしか持たない発音器は {@link unitsToMidiDetune} を使う。
 */
declare const unitsToMidi: (u: Units) => number;
/** units → 周波数(Hz)。 */
declare const unitsToHz: (u: Units) => number;
/**
 * units → 「最寄りの整数MIDIノート番号 + セント補正」。
 *
 * SoundFont は音高ごとに整数キーでゾーンを持つため小数ピッチを直接鳴らせない。
 * 最寄りのゾーンを鳴らして残差を `AudioBufferSourceNode.detune` で補正する。
 * 31平均律での残差は最大 ±48.4 セントで、detune の可動域に十分収まる。
 */
declare const unitsToMidiDetune: (u: Units) => {
    midi: MidiNote;
    detuneCents: number;
};
/**
 * 臨時記号1つあたりの格子ステップ数。
 *
 * - `#` / `+`(12平均律) … クロマチック半音上げ
 * - `-` … クロマチック半音下げ
 * - `+`(31平均律) … 格子1ステップ上げ（微分音）
 * - `_` … 格子1ステップ下げ（微分音）
 *
 * 12平均律ではクロマチック半音＝1格子ステップなので4記号すべてが従来の意味に潰れ、
 * 既存MMLの解釈は1文字も変わらない。31平均律でのみ `#`/`-`（±2度）と
 * `+`/`_`（±1度）が分岐する。
 */
declare const chromaticStep: (edo: Edo) => number;
/** 微分音記号 `+` / `_` 1つあたりの格子ステップ数。常に1。 */
declare const MICRO_STEP = 1;
/** 幹音の文字か。 */
declare const isNaturalLetter: (ch: string) => boolean;
/** 幹音の文字 → オクターブ内の格子ステップ。未知の文字は null。 */
declare const naturalStep: (ch: string, edo: Edo) => number | null;
/**
 * 音名・オクターブ・臨時記号から units を組み立てる。
 *
 * `octave` はMMLの `o` 指定（MIDI慣習で o4 の c が中央ド = MIDI 60）。
 * 臨時記号でオクターブを跨ぐ綴り（`b##` が次オクターブへ、`c--` が前オクターブへ）も
 * そのまま加算されるので、度数を 0〜edo-1 にクランプしてはいけない。
 */
declare const spellingToUnits: (letter: string, octave: number, chromatic: number, micro: number, edo: Edo) => number | null;
/**
 * 五度圏インデックス（C=0, G=1, F=-1, C#=7, Db=-5）→ オクターブ内の格子ステップ。
 *
 * ミーントーン系の音律はすべて「五度を何ステップとするか」だけで決まるため、
 * 綴りを持つ音（chord-parser の `rootFifth` / `noteFifths` など）はこの一本で
 * どちらの音律へも正確に写せる。12平均律では C# と Db が同じ値に潰れ、
 * 31平均律では 2 と 3 に分かれる。
 */
declare const fifthToStep: (fifthIndex: number, edo: Edo) => number;
/** 五度圏インデックス → オクターブ内の units。 */
declare const fifthToUnits: (fifthIndex: number, edo: Edo) => number;
/**
 * ピッチ表現のバージョン。
 *
 * - v1 … `pitch` が半音（MIDIノート番号）。dtm 1.x
 * - v2 … `pitchUnits` が 1/372オクターブ単位。dtm 2.x
 *
 * dtm 自身は通信路を持たず `onNotesPatch` / `applyPatch` のフックを出すだけなので、
 * バージョンの突き合わせは利用側アプリのハンドシェイクの責務になる。変換の知識だけを
 * ここに置く。v1→v2 は無損失だが、**v2→v1 は12平均律の曲でしか成立しない**
 * （31平均律を半音へ丸めると最大48.4セント動く）。
 */
declare const PITCH_ENCODING_VERSION = 2;
/** v1（半音）→ v2（units）。無損失。 */
declare const pitchV1ToUnits: (pitch: number) => Units;
/** v2（units）→ v1（半音）。12平均律の曲でのみ無損失。 */
declare const unitsToPitchV1: (u: Units) => number;

/**
 * コード進行文字列を伴奏トラックのノート配置へ展開する。
 *
 * parseChord / parseChords は外部実装を注入する想定。実際のノート追加は行わず、配置
 * （placement）の配列を返す純関数。
 */

type ChordPatternType = "block" | "arpeggio" | "arpeggio-fast" | "offbeat" | "yatsume" | "alternating";
type ChordPlacement = {
    startStep: number;
    /**
     * 1/372オクターブ単位。chord-parser が返すのは12平均律の半音なので、
     * ここへ入れる時点で音律に応じた格子へ写している。
     */
    pitchUnits: Units;
    durationSteps: number;
    velocity: number;
};
type ApplyChordOptions = {
    chordStr: string;
    /** 曲の音律（1オクターブの分割数）。省略時は12平均律。 */
    edo?: number;
    patternType: ChordPatternType;
    /** ルートのセミトーンシフト（0-11） */
    rootShift: number;
    bpm: number;
    stepsPerBar: number;
};
/**
 * 12平均律の半音で表した移調量を、その音律の units へ写す。
 *
 * 31平均律では半音をそのまま足すと格子から外れるので、ミーントーンの度数
 * （{@link MEANTONE_STEP_BY_SEMITONE}）を経由する。曲全体を同じ量だけずらす用途
 * （自動作曲の調決め）と、和音の基準位置を出す用途の両方で使う。
 */
declare const semitonesToUnits: (semitones: number, edo: 12 | 31) => number;
/**
 * 綴りを保った音（絶対半音＋五度圏インデックス）を units へ写す。
 *
 * 作曲マクロ（`compose.ts`）がメロディ・ベースの音を作るときにも使う。伴奏トラックと
 * **同じ写像を通す**ことで、31平均律で `D7` の増4度(15ステップ)に対しメロディが
 * 減5度(16ステップ)を鳴らして半端にぶつかる、といった食い違いを構造的に防ぐ。
 */
declare const spelledToUnits: (semitone: number, fifth: number, edo: 12 | 31) => Units;
declare const buildChordPlacements: (options: ApplyChordOptions) => ChordPlacement[];

/**
 * 生成した曲の「良さ」を測るための指標のうち、**順序に依存するもの**。
 *
 * 分布の指標（音価のエントロピー・休符率・跳躍率・音域）は、16小節の順番をシャッフルして曲を
 * 破壊しても値が動かない。モチーフの配置・盛り上がりの位置・フレーズの呼応は、そこでは評価
 * 対象にならない。
 *
 * 指標は {@link StructureFeatures}（コードを知らなくても測れる＝人間の曲から較正できる）と
 * {@link TensionFeatures}（和音が要る＝音楽理論から決める）に分けてある。前者は
 * `scripts/calibrate-corpus.ts` が人間の曲から採った実測値
 * （{@link file://./compose-corpus.ts}）を目標値に使う。
 *
 * MIDI取り込みの曲と生成物を**同じ関数で測る**ため、入力は units ではなく半音
 * （{@link MetricNote.pitchSemi}）とステップで受ける。
 */
/** 測定対象の1音。MIDIから作るときも生成物から作るときも、この形へ落としてから測る。 */
type MetricNote = {
    startStep: number;
    /** MIDIノート番号相当の半音。31平均律では小数になるが、指標の計算には影響しない。 */
    pitchSemi: number;
    durationSteps: number;
};
type MetricOptions = {
    stepsPerBar: number;
    bars: number;
};
type StructureFeatures = {
    /**
     * 自己相似プロファイル。lag 小節だけ離れた小節どうしの平均類似度。
     *
     * 良い曲は「lag4 と lag8 が高く、lag1 は低い」という山型になる——4小節・8小節の
     * フレーズで同じ形が戻ってくる一方、隣り合う小節は違う形をしている、ということ。
     * 平坦だと「全部同じ」か「全部バラバラ」のどちらかで、どちらも曲に聞こえない。
     */
    sim1: number;
    sim2: number;
    sim4: number;
    sim8: number;
    /** フレーズの切れ目（2小節ごと）で息継ぎ（ロングトーンか休符）があった比率。 */
    phraseBreath: number;
    /** 最高音が現れる位置。曲頭が0、曲末が1。 */
    climaxPosition: number;
    /** 最高音の2半音以内まで達する「頂点」の数。1〜2なら単峰。 */
    climaxPeaks: number;
    /** メロディが鳴っていないステップに、サブメロの音が入っている比率（コール&レスポンス）。 */
    complementarity: number;
    /**
     * 音の進む向きが反転した割合（折り返しの多さ）。跳躍率も順次進行率も隣接2音しか
     * 見ないので、「同じ方向へ流れ続ける旋律」と「上って下りる旋律」を区別できない。
     */
    turnRatio: number;
};
/**
 * コール&レスポンス。サブメロの**音の入り（オンセット）**のうち、メロディが休んでいる瞬間に
 * 入るものの割合。
 *
 * 「鳴っているステップ」で測ると伸ばしている音が一方的に不利になる——メロディの隙間で入って
 * そのまま伸びるパッドや保続音は対旋律として正しい書き方なのに、伸びた分だけ重なりとして
 * 数えられる。測りたいのは「サブメロはメロディが息継ぎしたときに喋るか」なので、**入りの
 * 瞬間だけ**を見る。
 *
 * ハモリはメロディと同時に入るのが正しい書法なので、1を目指す指標ではない。
 */
declare const complementarity: (melody: MetricNote[], submelody: MetricNote[], opts: MetricOptions) => number;
declare const structureFeatures: (melody: MetricNote[], submelody: MetricNote[], opts: MetricOptions) => StructureFeatures;
/**
 * メロディがどれくらい細かく動いているか。
 *
 * 音価エントロピーも種類数も**分布の散らばり**しか見ておらず、「4分中心に散らばった曲」と
 * 「16分中心に散らばった曲」を区別しない。休符率も自己相似も同じ。これが無いと、16分の曲を
 * 引いても採点で落ちる。メロディの速さは曲の性格そのものなので、採点項目として持つ。
 */
type DensityFeatures = {
    /** 1小節あたりの音数。 */
    notesPerBar: number;
    /** 8分音符以下の短い音が占める比率。曲の「刻みの細かさ」。 */
    shortNoteRatio: number;
    /**
     * 小節ごとの音数の変動係数（標準偏差÷平均）。歌っている小節だけを母数にする。
     * {@link notesPerBar} は平均なので、どの小節に音が集まっているかを何も言わない。
     */
    barDensityCv: number;
    /**
     * 音数の「崖」の割合。直前の小節が3音以上あり、そこから**3割以下**へ落ちる
     * 小節が、隣接する小節の組のうちどれだけあるか（参考曲は2%、初版の生成物は11%）。
     * 人間の曲もフレーズの切れ目で音数を落とすが、5.9音→1.3音の落とし方はしない。
     * **無音（0音）の小節は数えない**——間奏や落ちは構造として正しいため。
     */
    densityCliff: number;
};
type TensionFeatures = {
    /** B部（9〜12小節）がA部（1〜4小節）より緊張しているか。0〜1。 */
    rise: number;
    /** 終止（16小節目）で緊張が解けているか。0〜1。 */
    resolve: number;
};
/**
 * 小節ごとの緊張度から、曲の緊張カーブが「B部で上がって終止で解ける」形かを測る。
 *
 * `barTension` は各小節の不協和度（{@link file://./compose.ts} の `toneWeight` を
 * 音価で重み付けして集計したもの）。**この関数の存在意義は「1音ごとに使い捨てていた
 * 不協和度を時系列に積む」こと**で、材料は前からあった。
 */
declare const tensionFeatures: (barTension: number[], opts?: {
    verseBars?: number[];
    chorusBars?: number[];
}) => TensionFeatures;
/**
 * 台形の当てはめ。`[idealLo, idealHi]` の内側なら1、`lo`/`hi` の外側で0、間は線形。
 *
 * **しきい値の合否ではなく連続値にする**のが要点。初期実装は全部を1つの真偽値へ
 * 潰していたので、「構造は良いのに休符率が0.09だったので捨てられた曲」が
 * 大量に発生していた。
 */
declare const band: (v: number, lo: number, idealLo: number, idealHi: number, hi: number) => number;
/** 目標帯。`scripts/calibrate-corpus.ts` が人間の曲から採った値をこの形で出す。 */
type Band = [lo: number, idealLo: number, idealHi: number, hi: number];
/**
 * 曲の特徴ベクトル。各成分はおおよそ 0〜1 に収まるよう正規化してある。
 * 直近に作った曲との距離を採点へ入れることで、**指標に最適化した結果として
 * 全曲が同じ統計値へ寄る**のを防ぐ。
 */
declare const featureVector: (f: {
    entropy: number;
    restRatio: number;
    leapRatio: number;
    melodyRange: number;
    density: DensityFeatures;
    structure: StructureFeatures;
}) => number[];
/** 特徴ベクトル間のユークリッド距離。 */
declare const featureDistance: (a: number[], b: number[]) => number;

/**
 * 作曲で使う音階の定義。
 *
 * ## なぜ「中核音」と「主音の位置」だけで足りるのか
 *
 * `compose.ts` の旋律は、ハ長調の7音（`MAJOR_SCALE`）の**度数**で組み立ててから
 * 最後に半音へ落とす。この作りのまま音階を増やせるのは、**日本の伝統的な5音音階
 * （陽・民謡・律・都節・琉球）が4つともハ長調の7音の部分集合**だからで、違うのは
 *
 * - どの音を主音に置くか（{@link ComposeScale.tonic}）
 * - 7音のうちどの5音を旋律の柱にするか（{@link ComposeScale.core}）
 *
 * の2点しかない。チャーチモード（ドリアン等）も同じ2点で書ける。
 *
 * | 音階 | 主音 | 構成音 | 主音からの半音 |
 * |---|---|---|---|
 * | 陽 | ド | ド レ ミ ソ ラ | 0,2,4,7,9 |
 * | 民謡 | ラ | ラ ド レ ミ ソ | 0,3,5,7,10 |
 * | 律 | レ | レ ミ ソ ラ シ | 0,2,5,7,9 |
 * | 都節 | ミ | ミ ファ ラ シ ド | 0,1,5,7,8 |
 * | 琉球 | ド | ド ミ ファ ソ シ | 0,4,5,7,11 |
 *
 * 陽＝従来の長調、民謡＝従来の短調なので、**この2つは以前と完全に同じ挙動**になる
 * （`core` が昇順で `[0,1,2,4,5]`、`tonic` が 0 と 5）。
 *
 * ## 親音階を差し替える音階
 *
 * ハーモニックマイナー・ヒジャーズ・ハンガリアン・ブルースはハ長調に無いピッチクラスを
 * 含むので、上の2点では書けない。こちらは **{@link ComposeScale.parent} で音程集合
 * そのものを差し替える**。度数の計算は親音階の長さで回るので、6音のブルースも
 * そのまま乗る。
 *
 * | 音階 | 親の音程集合 | 主音 | 中核音 |
 * |---|---|---|---|
 * | ハーモニックマイナー | ド レ ミ ファ ソ♯ ラ シ | ラ | ラ ド レ ミ ソ♯ |
 * | ヒジャーズ | 同上 | ミ | ミ ファ ソ♯ ラ シ |
 * | ハンガリアン | ド レ♯ ミ ファ ソ♯ ラ シ | ラ | ラ ド レ♯ ミ ソ♯ |
 * | ブルース | ド ミ♭ ファ ソ♭ ソ シ♭ | ド | ド ミ♭ ファ ソ シ♭ |
 *
 * **親音階を差し替える音階は進行プールを必ず自前で持つ**（{@link ComposeScale.center}）。
 * ハ長調の和音をそのまま当てると、音階に無い音が伴奏から鳴って音階が壊れるため。
 */
/**
 * 音階の1つの音。`semi` は主音からの半音、`fifth` は五度圏インデックス
 * （C=0, G=1, D=2 … F=-1, B♭=-2 …）。**綴りを保持するために `fifth` を持つ**。
 * 31平均律で増4度と減5度、ソ♯とラ♭を区別するのに要る。
 */
type ScaleDegree = {
    semi: number;
    fifth: number;
};
/**
 * ハ長調（イ短調も同じ音の集合で、主音の取り方だけが違う）。
 * 既定の親音階で、日本の5音音階もチャーチモードも全部この上に乗る。
 */
declare const MAJOR_SCALE: ScaleDegree[];
/**
 * 和声的短音階の音程集合（イ短調から見て A B C D E F G♯）。ハ長調の座標で書くので
 * ソがソ♯に入れ替わった形になる。
 *
 * **導音（ソ♯）を持つのがこの音階の全部**で、`E7 → Am` の引力はここから出る。
 * ファとソ♯の間が増2度（3半音）空くのが特徴で、旋律がそこを跨ぐと一気に
 * 「泣き」の響きになる。主音をラに取れば和声的短音階、ミに取ればヒジャーズ
 * （フリジアン・ドミナント）で、音の集合は同じ。
 */
declare const HARMONIC_MINOR_SCALE: ScaleDegree[];
/**
 * ハンガリアン・マイナー（ジプシー音階）の音程集合（A B C D♯ E F G♯）。
 *
 * 和声的短音階のレをレ♯へ上げた形で、**増2度が2か所**（ド→レ♯、ファ→ソ♯）になる。
 * 音階の中で最も跳ねた響きを持つ代わりに、三和音がほとんど組めない
 * （{@link HUNGARIAN_CENTER} 参照）。
 */
declare const HUNGARIAN_SCALE: ScaleDegree[];
/**
 * ブルース音階（C E♭ F G♭ G B♭）。**この音階だけ6音**で、度数の計算が
 * 7で回らないことの試金石になっている。
 *
 * ソ♭がブルーノート。中核から外して経過音の位置に置くと、マイナーペンタの上を
 * 掠める本来の使われ方になる。伴奏は `C7`・`F7`・`G7` で長3度を鳴らすので、
 * **旋律の短3度と伴奏の長3度がぶつかる**——それがブルースの響きそのもの。
 */
declare const BLUES_SCALE: ScaleDegree[];
/** 音階の識別子。 */
type ComposeScaleId = "yo" | "minyo" | "ritsu" | "miyakobushi" | "ryukyu" | "dorian" | "phrygian" | "lydian" | "mixolydian" | "harmonic_minor" | "hijaz" | "hungarian" | "blues";
/**
 * 主音のダイアトニック度数。0=ド, 1=レ, ..., 6=シ。
 * 進行プールはこの値で引く（{@link TONIC_CENTERS}）。
 */
type TonicDegree = 0 | 1 | 2 | 3 | 4 | 5 | 6;
type ComposeScale = {
    id: ComposeScaleId;
    /** 表示名。 */
    label: string;
    /** 主音の度数（{@link ComposeScale.parent} の何番目か）。 */
    tonic: TonicDegree;
    /**
     * 音程集合そのものの差し替え。省略時は {@link MAJOR_SCALE}（ハ長調の7音）。
     *
     * ここを差し替えると `degreeToPitch` の返す音が変わるので、**旋律だけでなく
     * 順次進行・跳躍の埋め・着地音まで全部が新しい音程集合の上に乗る**。
     * 長さは7でなくてよい（ブルースは6音）。
     */
    parent?: ScaleDegree[];
    /**
     * 旋律の柱にする5音（ダイアトニック度数）。主音から順に書く。
     * ここに無い2音は「音階の外」として、和音構成音か経過音のときだけ通す。
     */
    core: number[];
    /**
     * **中核音の外を厳しく締めるか。**
     *
     * `true` にすると、和音の構成音であっても中核の外なら隣へ逃がし、変化音も減らし、
     * モチーフを必ず中核音の歩数で組み、ハモリも中核へ寄せる。
     *
     * 締めるのは、**中核の外が「音階に無い音」になる音階**だけ。
     *
     * - 律・都節・琉球 … 本物の5音音階。中核から外れた2音は音階に無い。琉球音階の
     *   `F` と `G` はレとラを持っていて、そこを無条件に通すと**「レとラを抜く」という
     *   音階の定義そのものが崩れる**（実測でレ8%・ラ6%が紛れ込んでいた）
     * - ブルース … 中核外のソ♭は音階の中だが、**伴奏の `C7`・`F7`・`G7` が
     *   音階に無い長3度を供給してくる**。締めないと旋律がそちらへ引かれ、
     *   短3度で歌う／長3度で鳴るというブルースの構図が消える
     *
     * 締めないのは次の2つ。
     *
     * - 陽・民謡 … ファ・シを自由に使うのはJ-POPの実際の書法で、参考曲の実測値も
     *   そちら（`compose.ts` の `applyPentatonic` 参照）。締めると従来の曲が変わる
     * - モード・和声的短音階・ヒジャーズ・ハンガリアン … 7音音階なので、中核の5音は
     *   旋律の柱を選んだだけ。残りの2音も立派な音階の構成音で、締める理由が無い
     */
    strict: boolean;
    /**
     * 進行プールの上書き。省略時は主音の位置から {@link TONIC_CENTERS} を引き、
     * それも無ければ（主音がド／ラ）従来の長調・短調のプールを使う。
     *
     * **音程集合を差し替える音階（{@link ComposeScale.parent}）では必須。** ハ長調の
     * 和音をそのまま当てると、音階に無い音が伴奏から鳴って音階が壊れる。
     *
     * **主音が同じでも音階が違えば使える和音が違う**ので、親が同じでもここが要る。琉球音階は
     * 主音がドだが `Am`・`Dm` を使うとレとラが前に出てしまうし、都節音階と
     * フリジアンはどちらも主音がミだが、`Am`（ラ・ド・ミ）が中核に収まるのは
     * 都節だけ。
     */
    center?: TonicCenter;
    /** どんな曲になるかの説明。UI のヒントに出す。 */
    description: string;
};
/** 音階のマスターデータ。 */
declare const COMPOSE_SCALES: Record<ComposeScaleId, ComposeScale>;
/** 全音階の識別子。 */
declare const COMPOSE_SCALE_IDS: ComposeScaleId[];
/**
 * 主音の位置ごとの「和声の中心」。進行プールと終止形をここで引く。
 *
 * **旋律が5音でも伴奏は7音のダイアトニック和音を使う。** ペンタトニックの旋律を
 * ダイアトニックの和音に乗せるのは民俗音楽でもポップスでも標準の書き方で、
 * 和音まで5音に絞ると三和音が組めない音階が出る（律音階には主音の3度が無い）。
 *
 * ド（0）とラ（5）は従来の長調・短調そのものなので、ここには置かず
 * `compose.ts` の既存プール（`SECTION_A_PROGRESSIONS` 他）をそのまま使う。
 */
type TonicCenter = {
    /** 主和音。セクションの締めはここへ落とす。 */
    tonic: string;
    /** 半終止に使う和音。「まだ続く」で止めるところに置く。 */
    half: string;
    /** 偽終止の落とし先。主和音の代理。 */
    deceptive: string;
    /** その主音がトニックかどうかを和音名から判定する正規表現。 */
    tonicPattern: RegExp;
    /** A部（Aメロ系）の進行候補。 */
    a: string[][];
    /** B部（サビ系）の進行候補。 */
    b: string[][];
    /** Cメロの進行候補。 */
    c: string[][];
};
/** その音階の音程集合。省略されていればハ長調。 */
declare const scaleDegrees: (scale: ComposeScale) => ScaleDegree[];
/** 1オクターブあたりの音数。7とは限らない（ブルースは6）。 */
declare const scaleSize: (scale: ComposeScale) => number;
/**
 * 音階の指定（`"auto"` | `"any"` | 音階ID）を解決する。
 *
 * - `"auto"`（既定）… 従来通り。長調なら陽音階、短調なら民謡音階
 * - `"any"` … 全音階から抽選
 * - 音階ID … その音階を使う
 */
declare const resolveComposeScale: (choice: string | undefined, minorKey: boolean, rnd?: () => number) => ComposeScale;
/** 音階の説明文（UI のヒント用）。 */
declare const getComposeScaleDescription: (choice: string) => string;
/**
 * その音階が使う和声の中心。音階ごとの上書き → 主音の位置の既定 → 無し（＝従来の
 * 長調・短調のプールを使う）の順に引く。
 */
declare const resolveCenter: (scale: ComposeScale) => TonicCenter | null;

/**
 * 曲のセクション（イントロ・Aメロ・Bメロ・サビ・Cメロ・落ちサビ・間奏・アウトロ）。
 *
 * 人が聴いて最初に分かるのは和音や音程ではなく**「ここはAメロだ」「サビに入った」という
 * 切り替わり**なので、どの小節が何なのかを持っていないと、細部を詰めても
 * 「曲の一部を切り出したもの」にしかならない。
 *
 * ## セクションごとに何を変えるか
 *
 * | | メロディ | 音域 | 密度 | 終わり方 |
 * |---|---|---|---|---|
 * | イントロ | 無し | — | — | — |
 * | Aメロ | 有り | 低め | 控えめ | 半終止 |
 * | Bメロ | 有り | 中 | 上げる | ドミナントで宙吊り |
 * | サビ | 有り | 高い | 最大 | 主音へ全終止 |
 * | Cメロ | 有り | 中高 | やや控えめ | 解決しない音 |
 * | 落ちサビ | 有り | 高い | 薄い | 主音へ全終止 |
 * | 間奏 | 無し | — | — | — |
 * | アウトロ | 有り | 低め | 薄い | 主音へ全終止 |
 *
 * メロディを書かないセクション（イントロ・間奏）でも、伴奏・ベース・ドラムは鳴る。
 * ここを「メロディが無いだけの同じ小節」にすると、結局のっぺりしたままになるので、
 * 伴奏の奏法で差を付ける。
 *
 * **ドラムはセクションで変えない。** 自動作曲のドラムは曲を通して固定パターンを
 * 選ぶ仕様なので（`compose.ts` の `pickBuiltinDrum`）、セクションごとの強度は持たない。
 *
 * 同じセクションの**繰り返し**が曲の基本構造なので、{@link STRUCTURE_TEMPLATES} に構成
 * パターンを持ち、2回目以降には `restatement: true` を付ける（compose側がメロディ・リズムを
 * 1回目から再現する）。
 */
/** セクションの種類。 */
type SectionKind = "intro" | "verse" | "prechorus" | "chorus"
/** Cメロ。Verse/Pre chorusとは違うメロディで、ラストのサビ前に緊張感を持たせる。 */
 | "bridge"
/**
 * 落ちサビ。サビのメロディを伴奏控えめに歌う。J-POPの王道パターン。
 * 2000年代のヒット曲に多く、現在も根強い人気がある。
 */
 | "drop_chorus" | "interlude" | "outro";
declare const SECTION_LABELS: Record<SectionKind, string>;
/** セクションの並び順（UIの並びと、指定が無いときの既定の順序）。 */
declare const SECTION_ORDER: SectionKind[];
/**
 * 既定で作るセクション。イントロ→Aメロ→Bメロ→サビ の、いちばん短い「1コーラス」。
 * 全部入れると長くなりすぎるので、間奏とアウトロは既定では作らない。
 */
declare const DEFAULT_SECTIONS: SectionKind[];
type SectionSpec = {
    /**
     * 小節数の代表値。`rnd` を渡さずに {@link buildSectionPlan} を呼んだときの長さで、
     * 「押す前に曲の長さを見せる」UI 表示などが使う。実際の作曲は
     * {@link SectionSpec.barChoices} から seed ごとに引く。
     */
    bars: number;
    /**
     * seed ごとに引くセクション長の候補（要素の重複が重み）。
     *
     * **定数にしない。** 長さが定数だと、BPM も調もメロディ型も引き直しているのに**曲の骨格だけが
     * 全 seed で同一**になる。曲の頭からの小節割りが毎回同じなのは生成器の指紋そのもの。加えて、
     * **候補に一度も現れない長さは、採点の重みをどう変えても出てこない**
     * （`scripts/README.md` の4番）。
     *
     * **4の倍数にする。** 参考コーパスの主旋律のブロック長は7割が4の倍数で、8/16/24/32小節に山が
     * 立つ。コード進行も4小節単位のまとまりで組んでいるので、4の倍数から外れた長さは締めの4小節が
     * 途中で切れる。**メロディの無いイントロだけは例外**（{@link SECTION_SPECS} の `intro`）。
     *
     * イントロは長さを秒で決めるので（{@link SectionSpec.seconds}）、ここの候補はテンポで
     * 絞られる前の母集団になる。0小節はここでは引かない——「イントロを作るか」は UI の
     * チェックで表明されているので、チェックが付いているのに消すのは筋が違う。
     *
     * 省略時は {@link SectionSpec.bars} 固定（外から独自の spec を渡す場合のため）。
     */
    barChoices?: number[];
    /**
     * そのセクションが占めてよい秒数の帯。{@link buildSectionPlan} に BPM を渡したときだけ効き、
     * 帯から外れる小節数は {@link SectionSpec.barChoices} から落とす。
     *
     * **小節数は時間ではない。** 同じ8小節でも BPM 112 なら 17秒、185 なら 10秒で、聴き手が
     * 感じる長さは3倍近くぶれる。曲の中ほどならそれでよい（拍で数えて聴いているので）が、
     * **歌が始まる前だけは違う**——まだ曲が始まっていない聴き手は拍ではなく時計で待っている
     * ので、ここが長い曲は歌に辿り着く前に閉じられる。
     */
    seconds?: {
        min: number;
        max: number;
    };
    /** メロディを書くか。イントロと間奏は伴奏だけ。 */
    melody: boolean;
    /**
     * メロディの音域の中心をどれだけずらすか（半音）。
     * サビが高く、Aメロが低いのが、セクションの差として最も分かりやすい。
     */
    registerShift: number;
    /**
     * 音数の傾き。1より小さいと休符寄りの薄いセクション、大きいと詰める。
     * リズム型を選ぶときの「休符を含む型」の引きやすさに効く。
     */
    density: number;
    /**
     * セクションの終わりの着地音（主音からの音階度数）。
     * `null` はメロディが無いセクション。
     */
    landing: number | null;
    /** 伴奏に使うコード進行の役割。 */
    progression: "a" | "b" | "c";
};
declare const SECTION_SPECS: Record<SectionKind, SectionSpec>;
/** 曲の中に置かれた1つのセクション。 */
type PlacedSection = {
    kind: SectionKind;
    /** 開始小節（0始まり）。 */
    startBar: number;
    bars: number;
    spec: SectionSpec;
    /**
     * セクション内の転調量（ハ長調基準からの半音シフト）。
     * ラスサビで +1/+2 半音上がるなど、曲中の転調を小節単位で表現する。
     */
    keyShift: number;
    /**
     * 同じ種類のセクションが曲中で2回目以降に現れた場合に true。
     * compose側でメロディ・リズムを1回目から再現するために使う。
     * 2番のAメロは1番と同じフレーズを使い回す、というのが曲の基本構造。
     */
    restatement: boolean;
};
/**
 * 選ばれたセクションを並べて、曲の設計図にする。
 *
 * テンプレート名が指定された場合はテンプレートの plan をそのまま使う。
 * kinds 配列が指定された場合は {@link SECTION_ORDER} に従って並べる
 * （従来の互換モード。各種別は1回ずつ）。
 * どちらも空のときは {@link DEFAULT_SECTIONS} を使う。
 *
 * 同じ種別が2回以上現れた場合、2回目以降は `restatement: true` が付く。
 * compose側はこのフラグを見て、1回目のメロディ・リズムを再現する。
 *
 * `rnd` を渡すと、セクション長を {@link SectionSpec.barChoices} から引く
 * （渡さなければ {@link SectionSpec.bars} の代表値。UI の長さ表示など、
 * 引くたびに答えが変わっては困る場所のため）。
 *
 * **長さは種別ごとに1回だけ引く。** 1番のAメロが8小節で2番が16小節、という
 * 曲は書けなくはないが、`restatement` は1番の対応小節をそのまま歌い直す仕組み
 * なので、長さが違うと後半だけ別のフレーズになる。同じ名前のセクションは同じ
 * 長さで揃えるほうが「同じフレーズが返ってきた」という手応えを壊さない。
 */
declare const buildSectionPlan: (kinds: SectionKind[], templateName?: string, rnd?: () => number, bpm?: number) => PlacedSection[];
/**
 * その構成で曲が何小節になりうるか（最短・最長・代表値）。
 *
 * セクション長を seed ごとに引くようにしたので、「押す前に何小節か」を
 * 1つの数で見せることはできない。UI はここが返す幅を出す。
 */
declare const sectionPlanBarRange: (kinds: SectionKind[], templateName?: string) => {
    min: number;
    max: number;
    typical: number;
};

/**
 * 自動作曲マクロ。コード進行・メロディ・サブメロ・ハモリ・ベース・伴奏・パッドを
 * まとめて組み立てる。曲の長さは選んだセクションで決まる
 * （{@link file://./compose-sections.ts}）。
 *
 * 組み立ては ①セクションの設計図 →②コード進行 →③各小節のリズム型 →④その上に音、の順。
 * 音を先に置いて音価を均等割りすると機械的な曲にしかならない。
 *
 * {@link DRAW_COUNT} 本の候補を引き、{@link HARD} に触れたものを捨て、残りから確率的に
 * 引く（{@link evaluate}・{@link SELECT_TEMPERATURE}）。目標帯（{@link CORPUS_BANDS}）は
 * 人間のMIDIからの実測で、較正は `scripts/calibrate-corpus.ts`。生成物とコーパスを同じ
 * 物差しで並べるのは `scripts/compare-*.ts`。
 */

/**
 * 曲の展開の仕方。
 *
 * - `motif` … 2小節のモチーフを反復・セクエンツ・オクターブ上げに変形して展開する。
 * - `ostinato` … 同じ型を曲全体で回す。変形しない。対比は編曲の側が担う。
 * - `through` … 通し作曲。同じ楽句を再現せず書き進める。
 *
 * `motif` しか無かった頃は反復プロファイルが狭い帯に固定され、通し作曲にも静的なリフにも
 * なれなかった。採点式をどう直しても出ないので、生成の型そのものを増やしてある。
 */
type MelodyForm = "motif" | "ostinato" | "through";
type ComposedNote = {
    startStep: number;
    pitchUnits: Units;
    durationSteps: number;
    velocity: number;
};
/** 生成結果の検算値。{@link composeSong} が基準を満たすまで引き直すのに使う。 */
type ComposeStats = {
    /** メロディの音価の種類数。 */
    valueKinds: number;
    /** メロディの音価のシャノンエントロピー（bit）。 */
    entropy: number;
    /** 休符が占めるステップの比率。 */
    restRatio: number;
    /** クライマックスを除く隣接音の最大跳躍（半音）。 */
    maxLeapSemitones: number;
    /** 隣接音程のうち跳躍（3半音以上）が占める比率。低すぎると「のっぺり」。 */
    leapRatio: number;
    /** 隣接音程のうち順次進行（1〜2半音）が占める比率。歌いやすさの側。 */
    stepRatio: number;
    /** 調の外の音（変化音）が音数に占める比率。0が続くと「調が固定」に聞こえる。 */
    chromaticRatio: number;
    /** メロディの密度（1小節あたりの音数・短い音の比率）。 */
    density: DensityFeatures;
    /** メロディが使った音域（半音）。 */
    melodyRange: number;
    /** サブメロが使った音域（半音）。小さいと旋律になっていない。 */
    submelodyRange: number;
    /** 順序に依存する構造の指標。{@link file://./compose-metrics.ts} 参照。 */
    structure: StructureFeatures;
    /** 緊張カーブの指標（B部で上がるか・終止で解けるか）。 */
    tension: TensionFeatures;
    /** 採点の総合点（0〜1）。{@link WEIGHTS} の加重和を重みの合計で割ったもの。 */
    score: number;
    /** 項目ごとの得点（0〜1）。どこで点を落としたかを調べるために持つ。 */
    scoreBreakdown: Record<string, number>;
    /** 引いた候補の数。 */
    attempts: number;
    /** ハード制約で捨てられた候補の数。 */
    rejected: number;
    /**
     * この曲の特徴ベクトル。次に作曲するとき {@link ComposeOptions.recent} へ
     * 渡すと、「前と似た曲」が出にくくなる。
     */
    fingerprint: number[];
};
type ComposeOptions = {
    /** 1小節のステップ数。DAW の renderConfig.stepsPerBar をそのまま渡す。 */
    stepsPerBar: number;
    /** 曲の音律。省略時は12平均律。 */
    edo?: number;
    /** 乱数源。テストから決定的な値を注入するために差し替えられる。 */
    random?: () => number;
    /**
     * 直近に作った曲の特徴ベクトル（{@link ComposeStats.fingerprint}）。指標に最適化すると
     * 全曲が同じ統計値へ寄るので、それらから離れている候補に加点する（{@link WEIGHTS.novelty}）。
     */
    recent?: number[][];
    /** 引く候補の数。既定 {@link DRAW_COUNT}。 */
    drawCount?: number;
    /**
     * 作るセクション。省略時は {@link DEFAULT_SECTIONS}。並び順は指定によらず
     * `SECTION_ORDER` に従う。
     */
    sections?: SectionKind[];
    /**
     * 曲構成テンプレート名（"1chorus" | "jpop_standard" | "jpop_drop" | "vocaloid" | "verse_chorus"）。
     * 指定時は sections より優先され、2コーラスやCメロ、落ちサビなどの王道構成を展開する。
     */
    template?: string;
    /**
     * ベースとなる調・雰囲気の指定（"any" | "major" | "minor" | "mood_*" | "key_*"）。
     * 省略時は "any"（全24調からランダム抽選）。
     */
    baseKey?: string;
    /**
     * 展開の仕方（`"auto"` | `"motif"` | `"ostinato"`）。省略時は `"auto"` で曲ごとに引く。
     * `"ostinato"` は同じ型を曲全体で回すリフ主体の作り。{@link MelodyForm}
     */
    form?: string;
    /**
     * 音階の指定（`"auto"` | `"any"` | 音階ID）。`"auto"` はベース調の長短に合わせて
     * 陽音階（長調）／民謡音階（短調）を使う。{@link COMPOSE_SCALES}
     */
    scale?: string;
};
type ComposeResult = {
    /** 伴奏トラック用のコード進行文字列。`buildChordPlacements` へそのまま渡せる。 */
    chordProgression: string;
    /** 伴奏の奏法。 */
    chordPattern: ChordPatternType;
    /**
     * 曲の調。ハ長調からの移調量（半音）。メロディ・サブメロ・ベースの音は既に移調済みなので、
     * 呼び出し側は伴奏トラックの `rootShift` へ同じ値を渡すだけでよい。
     */
    rootShift: number;
    /** 曲の調の名前（例: "C", "D", "Am"）。 */
    keyName: string;
    /** 曲の調の表示ラベル（例: "ハ長調 (C)", "イ短調 (Am)"）。 */
    keyLabel: string;
    /** 曲の音階の識別子（例: "yo", "ryukyu"）。{@link COMPOSE_SCALES} */
    scaleId: ComposeScaleId;
    /** 曲の音階の表示ラベル（例: "琉球音階"）。 */
    scaleLabel: string;
    /** 曲の展開の仕方。{@link MelodyForm} */
    form: MelodyForm;
    /** 雰囲気カテゴリのラベル（該当する場合）。 */
    moodLabel?: string;
    /** 曲のテンポ（BPM）。 */
    bpm: number;
    /** 曲の設計図。どの小節がどのセクションかを表す。 */
    sections: PlacedSection[];
    /** 曲の長さ（小節）。セクションの選び方で変わる。 */
    bars: number;
    /** 歌の割り当て（ハモリ・デュエット）。{@link VocalPlan} */
    vocal: VocalPlan;
    /** 調のふるまい（平行調・トニック回避）。{@link TonalPlan} */
    tonal: TonalPlan;
    /** 曲に合わせて組み込みから自動選択されたドラムパターン名（DRUM_PATTERNS のキー）。 */
    drum: string;
    /** 曲に合わせて組み込みから自動選択された楽器プリセット名（INSTRUMENT_PRESETS のキー）。 */
    instrument: string;
    melody: ComposedNote[];
    submelody: ComposedNote[];
    bass: ComposedNote[];
    /** ハモリトラック。メロディの3度/6度上。サビセクションでのみ鳴る。 */
    harmony: ComposedNote[];
    /** 2声目のハモリ。{@link VocalPlan.harmony2} が true のときだけ中身が入る。 */
    harmony2: ComposedNote[];
    /**
     * 主旋律のオクターブ下の重ね（{@link VocalPlan.octaveLayer}）。音高は主旋律の
     * ままで、トラック側のオクターブ設定で下げる。要所だけなので主旋律の一部。
     */
    octave: ComposedNote[];
    /** コードパッド。ストリングス/シンセパッド的なロングトーン。Bメロ以降で鳴る。 */
    pad: ComposedNote[];
    /**
     * 間奏の器楽ソロ。間奏の小節にしか音が入らないので、専用トラックへそのまま書き込めば
     * その1本だけ別の楽器に割り当てられる。歌メロと同時には鳴らない。
     */
    solo: ComposedNote[];
    /**
     * 上級者モードの編曲プラン。どの層をどのセクションでどの奏法で鳴らすか。
     * {@link ArrangePlan}
     */
    arrange: ArrangePlan;
    stats: ComposeStats;
};
/** 音価のシャノンエントロピー（bit）。全部同じ音価なら 0 になる。 */
declare const durationEntropy: (durations: number[]) => number;
/**
 * 歌の割り当て。歌入り作曲が、どのトラックに誰の声を当てるかを決めるのに使う。ハモリはサビ
 * （または Bメロ）から、デュエットは掛け合いで交互に。どちらもトラックが潤沢な advanced
 * モードでだけ展開し、ユーザーの操作パラメータにはしない——曲ごとに自動で引く。
 */
type DuetStyle = "none"
/** セクションごとに交代（1番のAメロはA、2番のAメロはB）。 */
 | "section"
/** Aメロ・Bメロで2小節ごとに交代（問い＝A、答え＝B）。 */
 | "phrase"
/** サビで2小節ごとに交代する掛け合いサビ。 */
 | "chorus"
/** Aメロだけ交代し、あとは1人が歌う。 */
 | "verse";
type VocalPlan = {
    /**
     * 2人目が歌う区間 `[開始ステップ, 終了ステップ)`。小節番号ではなく区間で持つ——小節線で
     * ぴったり交代すると機械的に聞こえるので、手前から食い気味に入れる。
     */
    duetSpans: [number, number][];
    duetStyle: DuetStyle;
    /** ハモリが入るセクション種別。 */
    harmonyKinds: SectionKind[];
    /**
     * 2声目のハモリを鳴らすか。参考曲（チョウチン少女 ch12/ch11/ch13）では
     * **1声目が下〜ユニゾン寄り、2声目が上**で主旋律を挟む形になっていた。
     */
    harmony2: boolean;
    /** 主旋律のオクターブ下を重ねるか（ハモリではなく厚みの層）。 */
    octaveLayer: boolean;
};
/**
 * 編曲の1層。伴奏・装飾・重ねを同じ形で表す。`sections` が `null` なら曲全体。
 * `octave` はトラック側のオクターブ設定（ノート自体は動かさない）。
 */
type ArrangeLayer = {
    pattern: ChordPatternType;
    sections: SectionKind[] | null;
    octave: number;
};
/**
 * 上級者モードの編曲プラン。曲ごとに引く。
 *
 * オクターブの重ねは主役にしない——人の耳はオクターブ違いを同じ音として聞く（オクターブ
 * 等価）ので、写した層は新しい声部にならず、音量と音色がわずかに変わるだけになる。
 *
 * - 伴奏の層は奏法そのものを変える（{@link ArrangeLayer.pattern}）。同じ和音でも鳴る音の
 *   位置が違うので、写しではない。
 * - 主旋律に重ねる層（{@link ArrangePlan.lead}）はオクターブ上だけでなくユニゾンも引く。
 * - ベースの重ね（{@link ArrangePlan.bassLayer}）は既定で出さない。出すときも下ではなく上へ
 *   ——下へ重ねると 30Hz 前後まで落ちて輪郭が濁る。
 */
type ArrangePlan = {
    /**
     * 伴奏の層。1本目は曲全体の「地」で、2本目以降はセクションを絞って足す。
     * 長さは1〜3。
     */
    backing: ArrangeLayer[];
    /** きらびやかな装飾（ウワモノ）。`null` なら出さない。 */
    sparkle: ArrangeLayer | null;
    /** コードパッドを鳴らすセクション。 */
    padSections: SectionKind[];
    /**
     * 主旋律に重ねる別音色の層。`null` なら重ねない。
     * `octave` が 0 ならユニゾン（音色だけが変わる）、1 ならオクターブ上。
     */
    lead: {
        sections: SectionKind[];
        octave: number;
    } | null;
    /** ベースの重ね。`null` なら出さない（多くの曲はこちら）。 */
    bassLayer: {
        sections: SectionKind[];
        octave: number;
    } | null;
};
/** 曲の調のふるまい。 */
type TonalPlan = {
    /**
     * 平行調へ振ったセクション種別。ハ長調とイ短調は同じ音の集合なので、調号も
     * 仲介の和音も要らずに明暗だけが入れ替わる（`keyShift` は 0 のまま）。
     */
    relativeKinds: SectionKind[];
    /**
     * 平行調なら 0、同主調なら ±3。平行調は調号が変わらないのが利点なので 0 のまま、
     * 同主調（ハ長調→ハ短調）は主音を保ったまま調号が3つ変わるので ±3 になる。
     */
    relativeShift: number;
    /** トニックを避けて浮遊感を出す曲か。主和音を鳴らさず、主音へも着地しない。 */
    floating: boolean;
};
/**
 * 16小節の曲を組み立てる。{@link DRAW_COUNT} 本の候補を引き、ハード制約（{@link HARD}）に
 * 触れたものだけを捨てて残りから選ぶ。全滅した場合も点数最大のものを返すので、「ボタンを
 * 押して何も起きない」状態にはならない。
 */
declare const composeSong: (options: ComposeOptions) => ComposeResult;

/**
 * **自動生成ファイル。手で編集しないこと。**
 *
 *   npx tsx scripts/calibrate-corpus.ts --dir <MIDIのフォルダ>
 *   npx tsx scripts/calibrate-corpus.ts --api --limit 200
 *
 * 人間が書いた曲 91本 から `src/compose-metrics.ts` と同じ指標を抽出し、
 * その分布の中央50%（p25〜p75）を満点、p05〜p95 の外側を0点とする目標帯にしたもの。
 * 手で決めた定数の代わりにこれを使うことで、受け入れ基準が
 * 「勘で決めた代理指標」から「人間の曲から採った代理指標」になる。
 *
 * コーパスを増やして測り直したら、このファイルごと差し替える。
 */

/** 較正に使った曲数。少ないほど帯が狭く・偏る点に注意。 */
declare const CORPUS_SIZE = 91;
declare const CORPUS_BANDS: {
    entropy: Band;
    valueKinds: Band;
    restRatio: Band;
    leapRatio: Band;
    stepRatio: Band;
    chromaticRatio: Band;
    maxLeap: Band;
    melodyRange: Band;
    notesPerBar: Band;
    shortNoteRatio: Band;
    barDensityCv: Band;
    densityCliff: Band;
    sim1: Band;
    sim2: Band;
    sim4: Band;
    sim8: Band;
    phraseBreath: Band;
    turnRatio: Band;
    climaxPosition: Band;
    climaxPeaks: Band;
    complementarity: Band;
};

/**
 * 調性格論に基づくベース調および雰囲気の定義と抽選ロジック。
 *
 * ## 背景
 * バロック〜古典派の調性格論（M.A.シャルパンティエ『作曲規則』、J.マッテゾン、
 * C.F.D.シューバルト等の文献やハルモニア楽典サイトのまとめ）に基づき、
 * 24調（長調12調・短調12調）の特徴を定義し、UIの幅がコンパクトになるよう
 * 類似する形容詞を8つの雰囲気カテゴリに集約している。
 */
type KeyMode = "major" | "minor";
type ComposeMoodId = "mood_happy" | "mood_triumphant" | "mood_fierce" | "mood_solemn" | "mood_plaintive" | "mood_melancholy" | "mood_anxious" | "mood_dark";
type ComposeKeyTarget = {
    id: string;
    name: string;
    label: string;
    mode: KeyMode;
    /** ハ長調（長調）またはイ短調（短調）からの移調量（半音、-5〜+6） */
    rootShift: number;
    moodId: ComposeMoodId;
    /** 調性格のキーワード・雰囲気説明 */
    description: string;
};
type ComposeMoodGroup = {
    id: ComposeMoodId;
    label: string;
    description: string;
    keyIds: string[];
};
/**
 * 24調のマスターデータ。
 * 長調はハ長調（C=0）、短調はイ短調（Am=0）からの半音シフト（-5〜+6）で管理。
 */
declare const COMPOSE_KEYS: Record<string, ComposeKeyTarget>;
/**
 * 似た形容詞をまとめた8つの雰囲気グループ。
 */
declare const COMPOSE_MOOD_GROUPS: ComposeMoodGroup[];
declare const MAJOR_KEY_IDS: string[];
declare const MINOR_KEY_IDS: string[];
type ResolvedComposeKey = {
    mode?: KeyMode;
    rootShift: number;
    keyName: string;
    keyLabel: string;
    moodLabel?: string;
    description?: string;
};
/**
 * プルダウン等の指定値（"any", "major", "minor", "mood_*", "key_*"）から
 * 具体的な調のモードと移調量（rootShift）を抽選・解決する。
 */
declare const resolveComposeKey: (choice?: string, rnd?: () => number) => ResolvedComposeKey;
/**
 * UI表示用の説明テキストを取得。
 */
declare const getComposeKeyDescription: (choice: string) => string;

/**
 * MusicXML の入出力。
 *
 * ## MIDI と何が違うか
 *
 * MIDI は「いつ・どの高さの音を鳴らすか」しか持たない。MusicXML は**楽譜**なので、
 * パートの名前・声部・歌詞・調号・拍子・音符の綴り（ファ♯かソ♭か）まで持つ。
 * このライブラリにとって効くのは主に2つ。
 *
 * - **主旋律がどれか分かる。** MIDI からの取り込みはチャンネルを見て推定するしか
 *   なく、ハモリや対旋律を主旋律と取り違える（`scripts/calibrate-corpus.ts` の
 *   主旋律選択が長い注釈を必要としているのはそのため）。MusicXML はパートが
 *   明示されている。
 * - **歌詞が音符に紐づいている。** 歌声合成へそのまま渡せる。MIDI では歌詞と
 *   音符の対応が失われる。
 *
 * ## 音律について
 *
 * 31平均律（{@link file://./tuning.ts}）の音は MusicXML の `<alter>` に小数を書けば
 * 表現できる（仕様上は許されている）。ただし**読める相手は限られる**ので、
 * 書き出しでは12平均律へ丸めた整数を使い、微分音は捨てる。31平均律の曲を
 * 往復させたいときは MML を使うこと。
 *
 * ## 対応範囲
 *
 * 読み込みは `score-partwise`（一般的なほう）のみ。`score-timewise` は実物が
 * ほぼ流通していないので見ない。和音（`<chord>`）・タイ・声部・複数パートは扱う。
 * 繰り返し記号（`<repeat>`）は**展開しない**——展開すると小節番号がずれて、
 * 取り込んだ後の編集で位置を見失う。
 *
 * ## 歌詞の記号と楽譜の要素
 *
 * 歌詞の制御記号（{@link file://./lyrics.ts}）は、楽譜ソフトが同じ意味で読み書きする
 * 標準の要素へ写す。記号を `<text>` に文字として書くと、楽譜ソフトでは歌詞の
 * ゴミになり、他の楽譜からは読めない。
 *
 * | 歌詞 | MusicXML | 備考 |
 * |---|---|---|
 * | `ー`（伸ばす） | 歌詞なしの音符。直前の歌詞に `<extend/>`（メリスマ線） | 読みは「歌詞の無い音符 = ー」 |
 * | `〜`（しゃくり） | `<notations><slide type="start"/>` … `<slide type="stop"/>` | ポルタメント記号。`<glissando>` も読む |
 * | `、`（ブレス） | `<notations><articulations><breath-mark/>` | 楽譜のブレス記号（コンマ形） |
 * | `↓` `↑` | `<direction><direction-type><wedge type="diminuendo"/"crescendo"/>` | 音符の前に開始、伸ばした音の後に `stop` |
 * | `っ` `_` `「…」` | `<text>` にそのまま | 楽譜側に対応物が無い |
 * | 鼻濁音 `ガ` | `<text>` にカタカナのまま | 読み直すと同じ意味になる |
 */

/** 取り込んだ1音。 */
type MusicXmlNotePlacement = {
    /** 何番目のパートから来たか（0始まり）。 */
    partIndex: number;
    startStep: number;
    /** MIDIノート番号。 */
    pitch: number;
    durationSteps: number;
    /**
     * 音符に紐づいた歌詞。`<lyric><text>` の文字に、楽譜の要素から起こした記号
     * （ブレス `、`・強弱 `↑` `↓`）を後ろへ付けた形（`displayKana` と同じ並び）。
     * 歌詞が無くポルタメントの着地なら `〜`、記号だけなら `ー` + 記号。無ければ空。
     */
    lyric: string;
};
type MusicXmlPart = {
    index: number;
    /** `<part-name>`。無ければ `Part 1` のような既定名。 */
    name: string;
    noteCount: number;
    /** このパートに歌詞が付いているか。歌トラックの候補を見分けるのに使う。 */
    hasLyrics: boolean;
    /** 平均音高（MIDIノート番号）。主旋律の目安。 */
    avgPitch: number;
};
type MusicXmlExtraction = {
    parts: MusicXmlPart[];
    placements: MusicXmlNotePlacement[];
    bpm: number;
};
/**
 * MusicXML を読んで、音符・パート情報・テンポを返す。
 *
 * @param xml `.musicxml` / `.xml` のテキスト。圧縮形式（`.mxl`）は呼び出し側で
 *            展開してから渡すこと（ZIP の展開をこのライブラリへ持ち込まない）。
 */
declare const parseMusicXML: (xml: string) => MusicXmlExtraction;
type ExportMusicXmlPart = {
    /** パート名。楽譜ソフトの左端に出る。 */
    name: string;
    notes: Note[];
    /**
     * 音符に付ける歌詞（`displayKana` の形: 文字 + `、` `↑` `↓`、継続は `ー` `〜`）。
     * `notes` と同じ並び順で対応させる。短ければ足りないぶんは付かない。
     * 記号は楽譜の要素（ブレス記号・松葉・メリスマ線・スライド）へ写す。
     */
    lyrics?: string[];
};
type ExportMusicXmlOptions = {
    parts: ExportMusicXmlPart[];
    bpm: number;
    stepsPerBar: number;
    /** 曲名。`<work-title>` に入る。 */
    title?: string;
};
/**
 * トラック群から MusicXML（`score-partwise`）を作る。
 *
 * **同時刻に始まる音は `<chord>` でまとめる。** ここを素直に並べて書くと、重なって
 * いた音が後ろへずれて**曲が変わる**（実測で 384/67 の音が 432 へ動いた）。
 * `<chord>` は声部の概念ではなく「直前の音と同時に鳴る」という意味なので、
 * 声部を持たないピアノロールでもそのまま使える。
 *
 * 声部は分けない。開始位置が違うまま重なる音（`<backup>` が要る形）は、
 * **次の音までで切る**——位置は保たれ、音価だけが短くなる。小節をまたぐ音を
 * 小節の終わりで切るのと同じ扱いで、鳴りの開始と高さは変えない。
 */
declare const exportMusicXML: (options: ExportMusicXmlOptions) => string;
/**
 * 取り込んだ音を、このライブラリのノート表現へ写す。
 *
 * `id` は付けない——採番はピアノロール側（`addNote`）の仕事で、ここで振ると
 * 既存のノートと衝突する。MIDI 取り込みが `MidiNotePlacement` を返して
 * 呼び出し側に置かせているのと同じ形。
 */
declare const musicXmlToNotes: (placements: MusicXmlNotePlacement[], partIndex: number) => Omit<Note, "id">[];

/**
 * UST（UTAU Sequence Text）入出力ユーティリティ。
 *
 * - 入力: `.ust` のテキストを解析し、ノート配置と歌詞（かな）を返す。
 *   USTは1ファイル＝1パートなので、ハモリ等で分かれた複数ファイルを
 *   それぞれ別トラックへ流し込む使い方を想定している。
 * - 出力: 1トラックぶんのノートと歌詞から `.ust` テキストを生成する。
 *
 * MIDIと違い、USTは**歌詞を持っている**のが取り込む価値の中心にある。
 * ノートだけならMIDIで足りるので、歌詞をこのアプリの歌詞表現
 * （かな＋制御記号。ノート1つにつき1音節）へ落とすことに注力する。
 *
 * 中国語音源のUST（原音名がピンイン）も、かなへ転写して取り込む。
 * 詳細は {@link looksLikePinyin} と `pinyin.ts`。
 */

/** USTの音価の解像度（4分音符あたり）。UTAUでは480固定。 */
declare const UST_TICKS_PER_BEAT = 480;
/** {@link lyricToSyllable} の結果。 */
type ParsedLyric = {
    /**
     * このアプリの歌詞へ写したモーラ列（＝必要なノート数）。休符・ブレスなら空。
     * 日本語の原音名なら必ず1つだが、ピンインは1音節が2〜3モーラになる
     * （`xing` → `["し", "ん"]`）。呼び出し側はノートを割って割り当てる。
     */
    moras: string[];
    /** `Lyric=R` 等の休符か。 */
    rest: boolean;
    /** `息R` `R吸` `@br1` 等のブレスか。休符と同じくノートを作らない。 */
    breath: boolean;
    /** かなへ落とせなかったか（読み込み結果の注意書き用）。 */
    unknown: boolean;
};
/**
 * USTの `Lyric=` 1つを、このアプリの歌詞へ変換する。
 *
 * UTAUの原音名は音源ごとに流儀が違うので、実体のかなだけを掬う:
 * - 連続音 `a か` / `- か` … 空白区切りの**最後の語**が実体。
 * - サフィックス付き `かC4` `か強` … 先頭のかな列だけを採る。
 * - ローマ字命名 `ka` `kya` … {@link ROMAJI_KANA} でかなへ寄せる。
 * - ブレス `息R` `R吸` `@br1` … 歌詞ではなく息継ぎ（{@link UST_BREATH_KANJI_RE}）。
 * - 休符 `R` `RE` `a R2` … 歌わない（{@link isUstRest}）。接尾辞付きも休符。
 * - ピンイン `xing` `tou` … 中国語音源のとき（{@link looksLikePinyin}）だけ
 *   {@link pinyinToMoras} でかなへ寄せる。日本語ローマ字と綴りが衝突する
 *   （`wo` = を / ウオ）ため、ファイル単位で決めた結果を渡してもらう。
 *
 * 変換できない綴り（CVVCの `a k` のような子音だけの断片など）は継続記号にする。
 * 言い直さずに繋ぐのが元の意図に一番近く、音節とノートの1:1もずれない。
 */
declare const lyricToSyllable: (raw: string, pinyin?: boolean) => ParsedLyric;
/**
 * このUSTが中国語ピンインで書かれているか、歌詞全体から決める。
 *
 * `ni` `ta` `ka` は日本語ローマ字とピンインの両方で成立し、`wo` に至っては
 * 読みが違う（を / ウオ）。トークン単位では決められないので、**ピンインでしか
 * 成立しない綴り**（`xing` `tou` `she` …）がローマ字歌詞の過半を占めるか、で見る。
 *
 * 日本語音源が持つ拡張かなの原音名（`she` `fa` など）はピンインとしても読めて
 * しまうため、数個の一致では倒れないように割合で判定する。
 */
declare const looksLikePinyin: (lyrics: Iterable<string>) => boolean;
/** USTから取り出したノート1つ（ピッチはMIDIノート番号＝`NoteNum` そのまま）。 */
type UstNotePlacement = {
    startStep: number;
    pitch: number;
    durationSteps: number;
    velocity: number;
};
/** UST1ファイル＝1パートぶんの取り込み結果。 */
type UstTrackData = {
    /** 読み込んだファイル名（トラック割り当ての表示用）。 */
    name: string;
    /** `Tempo` の値。書かれていなければ null。 */
    bpm: number | null;
    notes: UstNotePlacement[];
    /** ノート1つにつき1音節の歌詞テキスト（かな＋制御記号）。 */
    lyrics: string;
    /** かなへ落とせなかった歌詞の数（読み込み結果の注意書き用）。 */
    unknownLyricCount: number;
    /** 中国語ピンインとして読んだか（{@link looksLikePinyin} の判定結果）。 */
    pinyin: boolean;
};
/**
 * USTのバイト列を文字列へ復号する。
 *
 * UTAUの標準はShift_JIS、OpenUtau等の新しい環境はUTF-8で書く。拡張子では
 * 見分けられないので、**UTF-8として妥当かどうか**で判定する（日本語の
 * Shift_JIS列がUTF-8として妥当になることはほぼ無い）。
 */
declare const decodeUstText: (bytes: Uint8Array) => string;
/**
 * USTを解析し、ノート配置と歌詞を返す。
 *
 * `[#PREV]` / `[#NEXT]` は編集中の前後関係を表す参考情報でパートの一部ではないため
 * 取り込まない。休符（`Lyric=R`）とブレス（`息R` `R吸` `@br1`）はノートを作らない
 * ——このアプリのブレス `、` はノートを消費しない記号なので、直前の音節へ畳む。
 * 逆に、1音節が複数モーラになる歌詞（ピンインの `xing` → シ＋ン）では**ノートを割って**
 * 増やす（{@link splitNoteSteps}）。どちらの場合も「ノート1つにつき音節1つ」は保たれる。
 */
declare const parseUst: (source: Uint8Array | string, name?: string) => UstTrackData;
type BuildUstOptions = {
    /** 出力するトラックのノート（`startStep` 昇順）。 */
    notes: Note[];
    /**
     * ノートと index で1:1に対応する歌詞かな（`normalizeLyrics` の結果を
     * 1音節ずつ文字列にしたもの）。足りないぶんは {@link DEFAULT_UST_LYRIC} を使う。
     */
    syllables?: string[];
    bpm: number;
    /** `[#SETTING]` の ProjectName / OutFile の元にする名前。 */
    projectName?: string;
};
/** 歌詞が無いノートに当てる歌詞。UTAU側で必ず何か鳴らせるように「あ」にする。 */
declare const DEFAULT_UST_LYRIC = "\u3042";
/**
 * 1トラックぶんのノートと歌詞から `.ust` テキストを生成する。
 *
 * USTは**単旋律しか表現できない**フォーマットなので、和音・重なりは先勝ちで
 * 1本へ潰す（同時刻なら先に置かれたノート、跨ぎは前のノートを優先）。捨てた
 * ノートに割り当たっていた音節も一緒に捨て、音節とノートの1:1を保つ。
 *
 * ノートを消費しない記号のうち、クレッシェンド `↑` とデクレッシェンド `↓` は
 * `Envelope=`（音量エンベロープ）へ写す（{@link assignFadeEnvelopes}）。
 * ブレス `、` に当たる表現はUSTに無いので落とす。
 *
 * 文字コードはUTF-8で書き、`Charset=UTF-8` を添える（UTAU本体はShift_JISが
 * 既定だが、`Charset` 行があればUTF-8のUSTも読める）。改行はUTAUに合わせてCRLF。
 */
declare const buildUst: (options: BuildUstOptions) => string;

/**
 * ガイドツアー（スポットライト型ウォークスルー）。
 *
 * 画面を暗幕で覆い、対象要素だけをくり抜いて吹き出しで説明する。
 * 「解説はあるのに、どこを触ればいいのか分からない」を解消するための導線で、
 * このライブラリが持つ大量の `dtm-infobtn`（個別の解説モーダル）への入口も兼ねる。
 *
 * 単体で使える純粋なDOMユーティリティにしてある。`mountDAW` に依存しないので、
 * 埋め込み側が自分のUIを指すステップを書いて呼ぶこともできる。
 *
 *   startTour({ steps: DAW_TOUR_STEPS, root: dawRoot });
 *
 * 暗幕は `document.body` 直下に置く。`.dtm-daw` の外に出るため、スタイル側で
 * `.dtm-tour` にもデザイントークンを供給している（styles.ts の共有セレクタ参照）。
 */
/** ツアーの1ステップ。 */
type TourStep = {
    /**
     * ハイライトする要素。CSSセレクタ（`root` の中を検索）か、要素を返す関数。
     * 省略すると画面中央のカードだけを出す（導入・締めのステップ向け）。
     *
     * 解決できない・非表示（`display:none` や 0 サイズ）の場合、そのステップは
     * 自動的に飛ばされる。機能を切って使う利用者（`features.midi: false` 等）でも
     * 存在しないUIを指して固まらないようにするため。
     */
    target?: string | (() => Element | null | undefined);
    /** 吹き出しの見出し。 */
    title: string;
    /** 吹き出しの本文。HTMLを書ける。 */
    body: string;
    /**
     * 吹き出しを対象の上下どちらに出すか。既定 `"auto"`（入る方を選ぶ）。
     * 対象が画面に対して大きすぎる場合は `"auto"` でも画面下部に固定される。
     */
    placement?: "auto" | "top" | "bottom";
    /**
     * 表示直前に呼ばれる。対象要素（解決できていれば）が渡る。
     * `false` を返すとこのステップを飛ばす。
     */
    before?: (target: Element | null) => boolean | undefined;
    /**
     * 目的別の分岐。指定すると「次へ」の代わりに選択肢ボタンを並べ、
     * 選ばれた枝のステップ列で以降を差し替える。
     *
     * 「カバーを作りたい」「自動作曲したい」「自分で打ち込みたい」のように
     * 入口の目的がはっきり分かれる場合、全員に同じ順路を歩かせるより短く終わる。
     */
    branches?: TourBranch[];
};
/** {@link TourStep.branches} の選択肢。 */
type TourBranch = {
    /** ボタンの見出し。 */
    label: string;
    /** 見出しの下に添える補足（省略可）。 */
    hint?: string;
    /** この枝を選んだときに続けて表示するステップ列。 */
    steps: TourStep[];
    /**
     * この枝を出してよいか（省略時は常に出す）。表示の直前に評価する。
     *
     * 個々のステップは対象が無ければ勝手に飛ぶが、枝そのものは飛ばせない。
     * 機能を切っている利用者に「カバー曲を作りたい」を見せて、選んだ先が
     * 全部飛んで空になる——という行き止まりを防ぐために要る。
     */
    when?: (root: ParentNode) => boolean;
};
/**
 * `selector` に一致する要素が実際に表示されているか。
 * {@link TourBranch.when} に書く「この機能、そもそもこの画面にある？」の判定用。
 */
declare const isTourTargetVisible: (root: ParentNode, selector: string) => boolean;
/** 吹き出しの文言。日本語以外へ差し替えるためのフック。 */
type TourLabels = {
    next: string;
    prev: string;
    skip: string;
    /** 最終ステップの「次へ」に使う文言。 */
    done: string;
    /** 進捗表示（1始まりの現在位置と総数）。 */
    progress: (current: number, total: number) => string;
};
/** {@link startTour} のオプション。 */
type TourOptions = {
    /** 表示するステップ列。空なら何もしない。 */
    steps: TourStep[];
    /**
     * `target` にセレクタを書いたときの検索基点（既定 `document`）。
     * DAWのルート要素を渡すと、同一ページに複数マウントしていても取り違えない。
     */
    root?: ParentNode;
    /**
     * 「もう見た」フラグの保存先キー（既定 `"dtm-tour-seen"`）。
     * 最後まで進むか、スキップ／中断したときに記録する。`null` で記録しない。
     */
    storageKey?: string | null;
    /** 文言の差し替え。 */
    labels?: Partial<TourLabels>;
    /** 終了時に呼ばれる。最後まで見たかどうかが渡る。 */
    onEnd?: (completed: boolean) => void;
};
/** {@link startTour} の戻り値。 */
type TourInstance = {
    /** 次のステップへ。最終ステップでは終了する。 */
    next: () => void;
    /** 前のステップへ。 */
    prev: () => void;
    /** 中断して閉じる。 */
    stop: () => void;
    /** 表示中かどうか。 */
    isActive: () => boolean;
};
/** 「もう見た」フラグの既定の保存キー。 */
declare const TOUR_STORAGE_KEY = "dtm-tour-seen";
/** ツアーを既に見たかどうか。初回だけ自動再生したいときの判定に使う。 */
declare const hasSeenTour: (storageKey?: string) => boolean;
/** 「もう見た」フラグを立てる。 */
declare const markTourSeen: (storageKey?: string) => void;
/** 「もう見た」フラグを消す（ツアーをもう一度自動再生させたいとき用）。 */
declare const clearTourSeen: (storageKey?: string) => void;
/**
 * ガイドツアーを開始する。既に別のツアーが動いていても、呼ぶ側で止める必要はない
 * （新しい方が古い方を閉じる）。
 */
declare const startTour: (options: TourOptions) => TourInstance;
/**
 * `mountDAW` が組み立てるUIに対する既定のツアー。
 *
 * 入口で<b>目的</b>を尋ね、その枝だけを歩かせる。想定している層が
 *
 *   1. 音源に合わせてカバーを作りたい
 *   2. とりあえず自動で曲が欲しい
 *   3. 自分で打ち込みたい
 *
 * と目的からして分かれており、全員に同じ順路を歩かせると
 * 「自分に関係のない説明を我慢して読む時間」が大半になってしまうため。
 *
 * セレクタはすべて `data-dtm` 属性で書いてある。存在しないUI（機能を切っている、
 * 伴奏音源を注入していない等）を指すステップは自動的に飛ばされるので、
 * 利用側の構成に合わせて間引く必要はない。
 */
declare const DAW_TOUR_STEPS: TourStep[];
/** ヘルプから目的別ツアーを直接始めるための枝の一覧（`label` は表示用）。 */
declare const DAW_TOUR_BRANCHES: Record<"cover" | "compose" | "sequence", {
    label: string;
    steps: TourStep[];
}>;

type SongDrumInstruction = {
    ranges: [number, number][];
    patternBars?: number;
    pattern: DrumPattern;
};
type SongDrumPattern = SongDrumInstruction[];

/**
 * ドラム音源関連の設定
 * ドラムキー値とドラムパターンを定義
 */
declare const DRUM_FONT = "FluidR3_GM_sf2_file";
declare const DRUM_KEYS: {
    readonly bassDrum1: 36;
    readonly acousticSnare: 38;
    readonly handClap: 39;
    readonly sideStick: 37;
    readonly closedHihat: 42;
    readonly pedalHihat: 44;
    readonly openHihat: 46;
    readonly lowTom: 45;
    readonly lowMidTom: 47;
    readonly highTom: 50;
    readonly crashCymbal1: 49;
    readonly rideCymbal1: 51;
    readonly splashCymbal: 55;
    readonly tambourine: 54;
};
type DrumPattern = {
    step: number;
    pitch: number;
    velocity: number;
}[];
type DrumPatternDef<T = AnyDrumPattern> = {
    label: string;
    font?: string;
    pattern: T;
};

type AnyDrumPattern = DrumPattern | SongDrumPattern;
declare const normalizeDrumPatterns: (patterns: Record<string, AnyDrumPattern | DrumPatternDef>) => Record<string, DrumPatternDef>;
declare const resolveDrumPattern: (name: string, dict: Record<string, DrumPatternDef>, currentBar: number) => DrumPattern | null;
declare const DRUM_PATTERNS: Record<string, DrumPatternDef<DrumPattern>>;
declare const getDrumPatternKeys: (name: string, dict: Record<string, AnyDrumPattern | DrumPatternDef>) => number[];

type ClipMeter = {
    /** クリップ状態（ON/OFF）が変化するたびに呼ばれる。戻り値は購読解除関数。 */
    onClipChange: (cb: (clipping: boolean) => void) => () => void;
    /** 直近フレームのピークレベル（0付近〜1超。1.0が0dBFS）。簡易メーター表示用。 */
    getPeakLevel: () => number;
    /** クリップ表示を手動でリセットする（ユーザーが警告バッジを消す操作向け）。 */
    reset: () => void;
    /** 監視を止めてノードを解放する。 */
    dispose: () => void;
};

/**
 * マスタディレイ（テンポ同期エコー）— send/return バス。
 *
 * リバーブ（{@link file://./reverb.ts}）と同じ設計: masterGain の並列センドとして
 * 独立に存在し、各ボーカルトラックが個別のセンド量（`e`トークン）で参加を決める。
 * リバーブと違い、ディレイは曲のBPMに同期しないと不自然に聞こえるため、音価
 * （8分・付点8分等）を選ばせて実秒数へ変換する方式にしている（DTMツールの定番UX）。
 */
/** 選べる音価。value は保存用の短いキー、beats は四分音符を1とした拍数。 */
type DelayDivision = "4" | "8" | "8d" | "16";

/**
 * 継続記号（`ー` / `〜`）で結合したノート内のピッチ推移を、koe の `CurveInput`
 * （1フレームごとに評価される関数）へ変換する。
 *
 * メインスレッド（{@link file://./lyrics.ts} の local backend）とWorker
 * （{@link file://./voice-worker.ts}）の双方から使う純ロジックなのでここへ切り出す。
 * {@link file://./vibrato.ts} と同じ方針で、「何が歌唱表現か」を決めるのは dtm 側の責務。
 *
 * 副作用ゼロ・DOM非依存なので、Worker の別バンドルからも安全に import できる。
 */
/**
 * 継続記号で結合されたノートの、2区間目以降のピッチ推移。
 * Worker へも postMessage で渡すため、素の JSON で表せる形にしてある。
 */
type PitchSegment = {
    /** この区間のピッチ。単位は units（1/372オクターブの整数）。 */
    pitch: number;
    /** ノートの母音オンセットからの相対秒（区間の開始位置）。 */
    atSec: number;
    /**
     * 直前区間から時間を掛けて滑る（`〜`）。false（`ー`）は素早く移る。
     * どちらもピッチは連続に動く——違いは掛ける時間だけ（{@link glideMsForSegments}）。
     */
    portamento: boolean;
};

/**
 * 語り（読み上げ）の前段 — テキストから UtauTTS の合成計画を作る。
 *
 * 歌詞の `「…」`（{@link file://./lyrics.ts} の `kind: "speak"`）は、歌唱の
 * 「1文字＝1ノート」とは別の経路で音になる:
 *
 *   本文 → jpreprocess（読み・アクセント・ポーズ）→ HTS 音声モデル（モーラ長・F0）
 *        → UtauTTS プランナー（ユニット選択・配置・F0 曲線）→ worldline（合成）
 *
 * このファイルは最後の合成を除く**計画まで**を担う。計画は Wasm（Go）と
 * jpreprocess（Rust）をメインスレッドで動かす（koe のデモと同じ構成。合成と違い
 * 1文あたり数十 ms なので UI を塞がない）。合成そのものは音源 PCM と WORLD を持つ
 * バックエンド（voice-worker / ローカル）が計画を受け取って行う。
 *
 * 必要なアセット（約 45MB。Cache API に保存され 2 回目以降はネットワークを使わない）:
 *   - `utautts.wasm` + `wasm_exec.js` … UtauTTS プランナー（Go）
 *   - `jpreprocess_wasm/` + `naist-jdic/*.gz` … OpenJTalk 互換の読み解析と辞書
 *   - `frame-intonation-v8.json` … TCN イントネーションモデル（HTS 整列失敗時の保険）
 *   - `hts/tohoku-f01-neutral.htsvoice` … HTS 音声モデル（音素長と F0 だけを移植する）
 */

/**
 * HTS 音声モデルの感情。tohoku-f01（CC BY 4.0）は 4 種を同梱し、音素長と F0 の
 * 「起伏そのもの」が変わる（話し方プリセット {@link SpeakingStyleInput} は
 * その上に掛かる話速・抑揚幅・ポーズなどの係数）。各約 2MB、初めて使うときに取得する。
 */
type SpeechEmotion = "neutral" | "happy" | "sad" | "angry";
declare const SPEECH_EMOTIONS: readonly SpeechEmotion[];
/** 語りの 1 モーラの時刻（口パク・字幕送り用）。時刻は最初のモーラが鳴る時点を 0 とする秒。 */
type SpeechMora = {
    startSec: number;
    endSec: number;
    /** かな 1 モーラ（「きょ」「ー」など）。 */
    mora: string;
    /** 母音。撥音は "n"。 */
    vowel: "a" | "i" | "u" | "e" | "o" | "n";
};
/**
 * 計画からモーラ列を引く。timeline の各ユニットの配置（先行発声込みの先頭余白を除く）を
 * 秒に直し、母音は計画の `morae` から取る。ポーズ・促音・無音ユニットは含めない。
 */
declare const speechPlanMorae: (plan: UtauTTSPlan) => SpeechMora[];
/**
 * 話し方プリセットから、合成段（`renderChunks`）に渡すオプションを引く。
 * 計画（{@link SpeechPlanner.plan}）と合成は別スレッドになり得るので、
 * 合成側はこれを計画とは別に受け取る。
 */
declare const speechRenderOptions: (style?: SpeakingStyleInput) => UtauTTSRenderOptions;
/**
 * TTS アセットの既定の配信元（koe のデモと同じ配置）。`createDtmStudio` の
 * `ttsBaseUrl` / `createSingingVoices` の `ttsBaseUrl` で差し替えられる。
 */
declare const DEFAULT_TTS_BASE_URL = "https://onjmin.github.io/koe/demo/utautts/";
/** 読み上げの計画に必要な音源の見え方（マニフェストの音素表だけ。PCM は要らない）。 */
type SpeechBank = {
    manifest: {
        phonemes: Record<string, PhonemeEntry>;
    };
};
type SpeechPlanOptions = {
    /** prefix.map 用の音名（多音階音源の収録セット名。省略時 "C4"）。 */
    tone?: string;
    /** イントネーションの強さ 0..4。省略時は `style` の抑揚（neutral で 1）。 */
    intonationStrength?: number;
    /**
     * 話し方プリセット（"neutral" / "calm" / "lively"、またはプリセット＋上書き）。
     * 話速・抑揚幅・基準ピッチ・ポーズ倍率・モーラ長コントラストに効く。既定 neutral。
     */
    style?: SpeakingStyleInput;
    /**
     * 感情（HTS 音声モデルの差し替え）。既定 neutral。未取得の感情を指定したときは
     * {@link SpeechPlanner.prepareEmotion} を先に済ませておくこと（済んでいなければ
     * 直前まで使っていた音声モデルのまま計画する）。
     */
    emotion?: SpeechEmotion;
};
/** ダウンロード進捗（全アセット合算のバイト数）。 */
type SpeechProgressListener = (loadedBytes: number, totalBytes: number) => void;
type SpeechPlannerOptions = {
    /** アセットのベース URL（末尾 `/` は無くてもよい）。既定 {@link DEFAULT_TTS_BASE_URL}。 */
    baseUrl?: string;
    /**
     * ダウンロード進捗（全アセット合算のバイト数）。{@link getSpeechPlanner} に渡した場合、
     * 計画器が既に存在していても購読として追加される（{@link SpeechPlanner.onProgress}）。
     */
    onProgress?: SpeechProgressListener;
};
type SpeechPlanner = {
    /** アセットをすべて読み込む（初回のみ実際にダウンロード。以降は即解決）。 */
    ready: () => Promise<void>;
    /** {@link ready} が完了しているか。 */
    isReady: () => boolean;
    /**
     * ダウンロード進捗の購読を追加する。戻り値で解除する。読み込み中に追加すると、
     * それまでの合算値が直後に 1 回通知される（途中参加でも表示が空にならない）。
     */
    onProgress: (listener: SpeechProgressListener) => () => void;
    /**
     * 感情の HTS 音声モデルを取得しておく（初回のみダウンロード、以降は即解決）。
     * {@link ready} を含む。`plan` は同期なので、感情を使う計画の前に必ず呼ぶ。
     */
    prepareEmotion: (emotion: SpeechEmotion) => Promise<void>;
    /**
     * 本文の合成計画を作る。{@link ready} 完了後に呼ぶこと。
     * 読みが取れない本文（記号だけ等）は例外を投げる。
     */
    plan: (bank: SpeechBank, text: string, options?: SpeechPlanOptions) => UtauTTSPlan;
};
/**
 * 語りの計画器を取得する。Wasm（Go / jpreprocess）はページにつき 1 インスタンスなので、
 * ベース URL が違っても最初に作られたものを使い回す（警告を出す）。
 */
declare const getSpeechPlanner: (options?: SpeechPlannerOptions) => SpeechPlanner;
/**
 * 語りの計画器を作る（通常は {@link getSpeechPlanner} を使う）。
 * 読み込みは {@link SpeechPlanner.ready} を呼んだときに始まる（作っただけでは何も取りに行かない）。
 */
declare const createSpeechPlanner: (options?: SpeechPlannerOptions) => SpeechPlanner;
/**
 * 計画のピッチ曲線を比率で平行移動し、ユニットのエイリアスを実在の名前へ写した
 * 合成用の複製を返す（元の計画は変えない）。
 *
 * - `ratio` … ノートの音高 ÷ 計画の基準ピッチ（`timeline.reference_hz`）。
 *   1 で音源の素の声、2 で 1 オクターブ上。韻律の起伏は保たれる。
 * - `toReal` … 多音階音源の「音名接尾辞を剥がした見え方」で計画したエイリアスを、
 *   音源に実在する名前（`あ` → `あ_G4`）へ戻す。
 */
declare const prepareSpeechPlan: (plan: UtauTTSPlan, ratio: number, toReal?: (alias: string) => string) => UtauTTSPlan;
/**
 * 語りの先頭余白（秒）。タイムラインの 0 は最初のモーラより `leading_ms` だけ前
 * （先行発声ぶんの余白）にあるので、ノートの位置にはタイムラインのこの時刻を合わせる
 * （歌唱が母音オンセットを拍頭に合わせるのと同じ考え方）。
 */
declare const speechPlanLeadingSec: (plan: UtauTTSPlan) => number;
/**
 * 語りが実際に音を占める長さ（秒）。ノートの位置（{@link speechPlanLeadingSec} 後）から
 * 最後のユニットの終わりまで。`timeline.duration_ms` は語尾のリリースや句点の間まで
 * 含む計画上の長さで、鳴る音より長いので帯には使わない。
 */
declare const speechPlanDurationSec: (plan: UtauTTSPlan) => number;
/**
 * 計画に出てくるユニットの PCM を、合成に先立って（合成と重ねて）取りに行く。
 *
 * URL 配信の音源は 1 ユニット = 1 回の Range 取得で、`renderChunks` はユニットを
 * 逐次 await するため、何もしないとチャンクごとに「取得 → 合成」が交互に走り、
 * 往復時間がまるごと合成時間に乗る（つくよみちゃん × r2.dev で 1 往復 約 115ms、
 * 1 チャンク 6 ユニット ≈ 0.7 秒。WORLD 合成 約 0.4 秒と足すと 0.9 秒の音に 1.1 秒掛かり
 * 実時間を割る）。先に取得を走らせておけば取得と合成が重なり、実時間を上回る。
 * koe のデモは音源が手元の Blob なのでこの問題が無い。
 *
 * `getPcm` は呼び出し側のキャッシュ付きのもの（同じ関数を `renderChunks` にも
 * 見せること）。取得は計画の順（先頭チャンクのぶんが先に揃う）。失敗は握りつぶす
 * （合成側が改めて同じ取得を待ち、そこで扱う）。
 */
declare const prefetchSpeechPcm: (plan: UtauTTSPlan, getPcm: (alias: string) => Promise<unknown>, concurrency?: number) => void;
/**
 * `renderChunks` に見せる音源の見え方。PCM を引く口だけをキャッシュ付き `getPcm` へ
 * 向ける（`renderChunks` が音源に求めるのは `getPcm` だけ）。{@link prefetchSpeechPcm}
 * と同じ関数を渡すと、先取りした PCM がそのまま合成に使われる。
 */
declare const speechBankView: (bank: VoiceBank, getPcm: (alias: string) => Promise<Float64Array | null>) => VoiceBank;
/** 音素表の収録ピッチ（Hz）の中央値。0（未検出）は無視する。無ければ undefined。 */
declare const medianRecordedPitchHz: (phonemes: Record<string, PhonemeEntry>) => number | undefined;

/**
 * 自動ビブラート（ロングトーンに自動で掛けるピッチ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歌詞拡張 — 解析・正規化・同期（ヘッドレス）と、任意の歌唱合成ヘルパ。
 *
 * 既存の演奏トラック（@n）とは独立した「歌詞専用行」(@@n) を扱う。
 *   @@<トラックID> <モデル名> <歌詞>
 *   例: `@@2 klatt どはどなつのど`
 *       `@@3 external_engine きょー`
 *
 * 区切りは半角スペース（引用符不要）。歌詞内のひらがな・カタカナと、
 * 制御記号 `ー` `〜`（継続）・`っ`（促音）・`_`（休符）・`、`（ブレス）以外は破棄する。
 *
 * 演奏データ（テンポ・休符・音符長）とは完全に分離されており、
 * Note On のタイミングで音節を1つずつ消費して歌わせる。
 *
 * このライブラリ自体は音を出さない方針のため、解析・同期（createLyricsConductor）と
 * オプトインのフォルマント合成ヘルパ（createKlattVoice / createVoiceRegistry）を分離して提供する。
 */

/**
 * 継続記号。直前の音を言い直さずに保ち、ピッチだけを次の音へ移す。
 * 声が繋がっている以上ピッチも繋がっているべきなので、移動は音価に比例した
 * 短いグライドで行う（瞬間移動させると耳が「言い直した」と受け取る）。
 */
declare const TIE_MARK = "\u30FC";
/**
 * 継続記号（ポルタメント）。{@link TIE_MARK} と同じだが、区間の大半を掛けて
 * ゆっくり滑る＝しゃくり・スラーになる。違いは掛ける時間だけ。
 */
declare const PORTAMENTO_MARK = "\u301C";
/** 促音。ノートを消費し、無音の閉鎖として間を作る。 */
declare const STOP_MARK = "\u3063";
/** 明示的な休符。ノートを消費するが歌わない（そのノートは無音になる）。 */
declare const REST_MARK = "_";
/** ブレス。ノートは消費せず、直前ノートの尻を削って息継ぎを差し込む。 */
declare const BREATH_MARK = "\u3001";
/**
 * デクレッシェンド。ノートは消費せず、直前の音（継続で結合されていればその全体）を
 * 歌いながら声量0へ落とす。`あーーーーー↓` で「あ」を伸ばしたまま消えていく。
 *
 * 1音へ複数書くと、書いた位置が減り方の中継点になる（`ぎ↓ー↓` = 50%→0%）。
 * 詳細は {@link buildFadeCurve}。
 */
declare const FADE_OUT_MARK = "\u2193";
/**
 * クレッシェンド。ノートは消費せず、直前の音（継続で結合されていればその全体）を
 * 歌いながら声量を上げていく。{@link FADE_OUT_MARK} と併用するとスウェルになる。
 */
declare const FADE_IN_MARK = "\u2191";
/**
 * 語り（読み上げ）の開き括弧。`「こんにちは」` のように囲んだ部分は歌わずに
 * UtauTTS で読み上げる。括弧ひとかたまりでノートを1つ消費し、そのノートの位置から
 * 話し始める。中身は漢字・数字・句読点を含んでよい（読みは jpreprocess が決める）。
 * 閉じ括弧が無ければ行末までを語りとみなす。
 */
declare const SPEAK_OPEN = "\u300C";
/** 語りの閉じ括弧（{@link SPEAK_OPEN} の対）。対応する開き括弧が無ければ無視する。 */
declare const SPEAK_CLOSE = "\u300D";
/**
 * 歌詞文字列（かな＋制御記号）を正規化済み音節列へ変換する。
 *
 * 出力の1要素＝ノート1つぶん。ブレス（`、`）だけはノートを消費せず、
 * 直前の音節の {@link LyricSyllable.breathAfter} へ畳まれる。
 *
 * 継続記号（`ー` / `〜`）は直前の音節の母音を焼き込んで返す（例: きょ + ー → きょ + お）。
 * `kind: "tie"` は残るので、発音側は「言い直さない」判断ができ、表示側は `ー` へ戻せる。
 *
 * - 撥音（ん）の直後の継続は「ん」を伸ばす（ハミング）。
 * - 促音（`っ`）は母音の文脈を切らない（語中の詰まりなので直前母音を保つ）。
 * - 休符（`_`）は歌わず、ブレス（`、`）ともども母音の文脈を切る。次の音節は語頭として歌われる。
 * - 引き継ぐ母音が無い継続（行頭・ブレス直後）は意味を持たないので捨てる。
 * - `「…」` は語り（{@link SPEAK_OPEN}）。ひとかたまりで `kind: "speak"` の1音節になり、
 *   中身は {@link LyricSyllable.text} に生のまま残る（かな以外も捨てない）。
 *   語りのあとは母音の文脈が切れる。
 */
declare const normalizeLyrics: (text: string) => LyricSyllable[];
/**
 * 音節を歌詞テキストの1文字（表示・MMLへの書き戻し用）へ戻す。
 * 継続・休符は元の記号へ、ブレスは直後に `、` を付けて返す。
 *
 * {@link LyricSyllable.kana} は継続のとき「引き継いだ母音のかな」なので、
 * これをそのまま繋ぐと `あーー` が `あああ` になって継続の意図が失われる。
 * 表示と往復（MML ⇄ エディタ）には必ずこちらを使うこと。
 */
declare const displayKana: (syl: LyricSyllable) => string;
/** 音節列を歌詞テキストへ戻す（{@link displayKana} の連結）。 */
declare const syllablesToText: (syllables: LyricSyllable[]) => string;
/**
 * 歌唱の声量の上限（%）。100=等倍。100超は合成音声をブースト（増幅）する。
 * 100では音量が足りないケース向けに大きめのヘッドルームを確保する。
 * UIスライダー・MML（`v<n>`）パースの双方でこの上限を共有する。
 * {@link vocalVolumeToGain} により v=400 で約 +24dB（≒15.8倍）まで上げられる。
 */
declare const MAX_VOCAL_VOLUME = 400;
/**
 * 声量値（0-{@link MAX_VOCAL_VOLUME}）を実際のゲイン係数へ変換する。
 *
 * - 0 → 0（無音）, 100 → 1（等倍）。
 * - 0-100 は従来どおりの線形（既存MMLの音量を変えないため）。
 * - 100超は dB 線形（=ゲインは対数）のブースト。スライダーを等間隔で動かすと
 *   等dB＝知覚的に均等な音量変化になる。
 *
 * v=100 で両分岐が連続（線形側=1、対数側=10^0=1）するため、つなぎ目で段差は出ない。
 */
declare const vocalVolumeToGain: (v: number) => number;
/**
 * MMLから全歌詞トラックを解析し、トラックIDをキーにした辞書を返す（プリスキャン）。
 * 同一IDが複数あれば後勝ち。
 *
 * 記法: `@@<トラックID> <モデル名> [v<声量>] [q<ゲート>] <歌詞>`
 *   例: `@@4 klatt v100 歌詞`（声量100＝等倍。100超でブースト、上限 {@link MAX_VOCAL_VOLUME}）
 * 声量は 0-{@link MAX_VOCAL_VOLUME}、ゲートは 0-100。モデル名直後の `v`/`q` トークンとして任意順で付与でき、
 * 最初に現れた歌詞（かな）トークンより前にあるものだけを解釈する。
 * 後方互換として `klatt:80` のコロン区切り声量も受け付ける。
 */
declare const parseLyrics: (mml: string) => Map<number, LyricTrack>;
/**
 * 歌詞専用行を除去し、演奏トラックのみのMMLを返す。
 * parseMML が @@n を演奏ノートとして誤解釈しないよう前処理する。
 */
declare const stripLyrics: (mml: string) => string;
/** URL 文字列が http / https スキームの妥当な形式かを簡易チェックする（UI入力の検証にも使う） */
declare const isValidHttpUrl: (s: string) => boolean;
/**
 * MMLからカスタムボーカル宣言行を解析し、定義配列を返す。
 *
 * 記法: `@@key icon_url koe_url`
 *   例: `@@testvocal https://example.com/icon.png https://example.com/voice.koe`
 *
 * - key は英字始まりの英数字・アンダースコア列（数字のみは既存 LYRIC_LINE 扱い）
 * - icon_url は http / https の URL のみ有効。不正・長すぎは 404Chip.png にフォールバック
 * - koe_url は http / https の URL かつ {CUSTOM_VOCAL_URL_MAX_LEN} 文字以内のみ有効。
 *   不正・長すぎの場合はその宣言ごとスキップ（楽曲読み込みは継続する）。
 * - 同一 key が複数あれば後勝ち。
 */
declare const parseCustomVocals: (mml: string) => CustomVocalDef[];
/**
 * カスタムボーカル宣言行を除去し、残りの MML を返す。
 * `parseMML` / `parseLyrics` が `@@keyword` を誤解釈しないよう前処理する。
 *
 * 宣言セグメントだけを取り除き、それ以外の行・`;` 区切りは元の構造のまま残す
 * （コメント除去より前の生MMLに適用しても他セグメントへ影響しないため）。
 */
declare const stripCustomVocals: (mml: string) => string;
/** 1つの音節を消費した結果。利用側はこれを歌唱合成へ渡す */
type ConsumedSyllable = {
    /** 歌う合成モデル名 */
    model: string;
    /** 消費した音節 */
    syllable: LyricSyllable;
    /**
     * 歌唱の声量係数（歌詞トラックの volume 0-{@link MAX_VOCAL_VOLUME} を正規化したもの）。
     * 1=等倍で、100超指定時は 1 を超える（ブースト）。ノートのvelocityとは独立。
     * 利用側はこれにマスタ音量を掛けて発音音量とする。
     */
    volume: number;
    /**
     * 歌唱のゲートタイム係数 0-1（歌詞トラックの gate 0-100 を正規化したもの）。
     * 利用側はノートの発音長（秒）にこれを掛けて実際の歌唱長とする。既定1（レガート）。
     */
    gate: number;
    /**
     * ステレオ定位 -1(左)〜+1(右)、0が中央（歌詞トラックの pan 0-127 を正規化したもの）。
     * 利用側は StereoPannerNode.pan などへそのまま渡す。
     */
    pan: number;
};
/** MML の pan 値(0-127, 64=中央) を StereoPanner 用の -1〜+1 へ正規化する */
declare const panToStereo: (pan: number) => number;
/** 歌詞同期コンダクタ。音節ポインタを保持し、Note On ごとに1音節消費する */
type LyricsConductor = {
    /**
     * 演奏トラック trackId の Note On に対応する音節を1つ消費して返す。
     * 歌詞が無い／尽きた場合は null（利用側は楽器音として鳴らす）。
     */
    consume: (trackId: number) => ConsumedSyllable | null;
    /** ポインタを初期化する（再生開始時に呼ぶ） */
    reset: () => void;
};
/**
 * 歌詞トラック辞書から同期コンダクタを生成する。
 *
 * 演奏トラック（@n）で Note On されるたびに consume(n) を呼び、対応する歌詞配列の
 * 現在の音節を消費（ポインタをインクリメント）する。合成方法には依存しない。
 */
declare const createLyricsConductor: (lyrics: Map<number, LyricTrack>) => LyricsConductor;
/**
 * トラック単位で固定の声質パラメータ（0-1、既定0.5=無変化）。koe音源（Worldline）限定
 * — klattフォールバックには効かない。ビブラート/リバーブ送りと違い、ノート単位の判定は
 * 挟まず、指定されたトラックの全ノートへ一律に掛かる（声質そのものを決めるパラメータのため）。
 */
type VoiceExpression = {
    /** フォルマント/ジェンダーファクター。0.5未満で低め/太め、0.5超で高め/細めに寄る。 */
    gender?: number;
    /** ブレシネス（息成分）。大きいほど息っぽく（ささやき寄り）。 */
    breathiness?: number;
    /** テンション（張り/力強さ）。大きいほど張った・押した声（こぶし寄り、力強く歌う）。 */
    tension?: number;
};
/** 歌唱合成モデルの実装シグネチャ */
type VoiceModel = {
    /** 1音節を `ctx.currentTime + e.when` のタイミングで即時発音する（直接呼び出し用）。 */
    (syllable: LyricSyllable, e: PlayNoteEvent): void;
    /** 内部状態（直前母音など）を初期化する。 */
    reset?: () => void;
    /**
     * 1音節を合成してキャッシュへ積み、再生に使うキャッシュキーを返す（重い処理はここ）。
     * ストリーミングスケジューラが「先回り合成」に使う。直前母音は呼び出し側が明示で渡す
     * （モデル内部状態に依存しないので、同一モデルを複数トラックで共有しても干渉しない）。
     * 合成不能（該当音素なし・無声）なら null。klatt 等の軽量モデルは未実装でよい。
     */
    renderToCache?: (syllable: LyricSyllable, prevVowel: string, pitch: number, durationMs: number, vibrato?: boolean, expr?: VoiceExpression, 
    /**
     * 継続記号（`ー` / `〜`）で結合されたノート内のピッチ推移（2区間目以降）。
     * 先頭区間は `pitch`、`durationMs` は結合後の全長。未指定なら単一ピッチ。
     */
    pitchSegments?: PitchSegment[]) => Promise<string | null>;
    /**
     * {@link renderToCache} 済みのバッファを絶対時刻 t0（AudioContextクロック秒）へスケジュールする。
     * t0 は未来の任意時刻でよく、再生はオーディオスレッドが担うのでメインスレッドのもたつきに影響されない。
     */
    scheduleCached?: (key: string, t0: number, peak: number, pan: number, reverbSend?: number, delaySend?: number, destination?: AudioNode, 
    /**
     * 直前ノートからの継続として鳴らす（継続記号がノート結合できなかったときの分割再生）。
     * 先行母音を切り、立ち上がりを直前ノートの減衰へ被せて言い直し感を消す。
     */
    continuation?: boolean, 
    /** 歌いながら声量0へ落とす（`↓`）。{@link LyricSyllable.fadeOut} を引き回したもの。 */
    fadeOut?: boolean, 
    /** 歌いながら声量を上げる（`↑`）。両方立てるとスウェルになる。 */
    fadeIn?: boolean, 
    /** 記号を複数書いたときの声量の中継点列（{@link buildFadeCurve}）。 */
    fadeCurve?: FadeStop[], 
    /**
     * この音が占める長さ（秒。`t0` から数える）。
     * 合成した素片は音価より長いことがある（短すぎるノートは合成の都合で
     * 引き伸ばして作られる）ので、渡すと**その長さで切って**鳴らす。
     * 省略すると素片の長さのまま鳴らす（従来どおり）。
     */
    durationSec?: number) => void;
    /** スケジュール済みの発音をすべて即停止する（停止・一時停止・シーク時）。 */
    stopAll?: () => void;
    /**
     * 語尾の素片（連続音バンクの `a R` `n R` 等: 母音が自然に抜けていく収録）を
     * 目標ピッチで合成してキャッシュへ積み、キーを返す。音源に無ければ null
     * （呼び出し側はゲインのフェードだけで終える従来どおりになる）。
     * 長さは素片の固定範囲（抜けの部分）から決めるので、呼び出し側は指定しない。
     */
    renderEndingToCache?: (vowel: string, pitch: Units, expr?: VoiceExpression) => Promise<string | null>;
    /**
     * 音源が持つ息継ぎ素片（`息` `息短` `b1` など）から、吸う形（包絡の山が後ろ寄り）で
     * `targetSec` の隙間にいちばん合う長さのものを選んで AudioBuffer で返す。
     * 素片は最大振幅1へ正規化済み。音源に息継ぎ素片が無ければ null
     * （呼び出し側はノイズ合成へ落とす）。候補の PCM は音源ごとに1度だけまとめて引く。
     */
    breathSample?: (targetSec: number) => Promise<AudioBuffer | null>;
    /**
     * 語り（`「…」`）を合成してキャッシュへ積み、再生に使うキャッシュキーを返す。
     * 計画（読み・韻律・ユニット選択）が出来た時点で返り、合成はチャンクごとに裏で続く
     * （{@link scheduleSpeech} は届いたチャンクから順に置く）。`awaitRender` は
     * `"first-chunk"` で最初のチャンクが出るまで（頭出しの貯金用。長文でも再生開始を
     * 塞がない）、`true` で全チャンクの合成完了まで待つ（書き出し用）。
     * `pitch` は話す基準ピッチ（units）。計画不能（読みが取れない・アセット取得失敗）なら null。
     * koe 音源専用。klatt 等は未実装でよい（その場合は語りは鳴らない）。
     */
    speakToCache?: (text: string, pitch: number, expr?: VoiceExpression, awaitRender?: boolean | "first-chunk") => Promise<string | null>;
    /**
     * {@link speakToCache} 済みの語りを絶対時刻 t0（AudioContext クロック秒）へスケジュールする。
     * まだ合成中のチャンクは届き次第、同じ t0 基準で置く。t0 を過ぎてから届いた分は
     * 途中から（遅れたぶんを飛ばして）鳴らし、後続との同期を保つ。
     */
    scheduleSpeech?: (key: string, t0: number, peak: number, pan: number, reverbSend?: number, delaySend?: number, destination?: AudioNode) => void;
    /** {@link speakToCache} 済みの語りが占める長さ（秒）。未計画なら undefined。 */
    speechDurationSec?: (key: string) => number | undefined;
    /**
     * 語りの計画だけを行い、占める長さ（秒）を返す（ピアノロールの帯表示用）。
     * 長さは基準ピッチに依らないので本文だけで引ける。アセット未取得なら取得から始める。
     * `options` の感情・話し方で長さは変わる（省略時 neutral）。
     */
    planSpeech?: (text: string, options?: SpeechPlanDetailOptions) => Promise<number | null>;
    /** {@link planSpeech} と同じ計画から、長さに加えてモーラ列も返す。 */
    planSpeechDetail?: (text: string, options?: SpeechPlanDetailOptions) => Promise<SpeechPlanInfo | null>;
    /** 計画済みの語りの長さ（秒）を同期で引く（描画ループ用。未計画なら undefined）。 */
    peekSpeechDurationSec?: (text: string) => number | undefined;
    /**
     * 語りの基準ピッチ（units）。この行にノートを置くと音源の素の声の高さで話す。
     * 音源の収録ピッチの中央値（多音階音源では収録セットの中央値）。
     */
    speechReferenceUnits?: () => number | undefined;
    /**
     * 本文をこの音源で読み上げる（MML を介さない単発の語り）。{@link speakToCache} と
     * {@link scheduleSpeech} をまとめ、発話ごとに止められるハンドルを返す。
     * 計画不能（読みが取れない・アセット取得失敗）なら null。koe 音源専用。
     */
    speak?: (text: string, pitch: number, options?: SpeakVoiceOptions) => Promise<SpeechHandle | null>;
};
/** {@link VoiceModel.speak} のオプション（ピッチは引数で受けるので含まない）。 */
type SpeakVoiceOptions = {
    /** 声色（ジェンダー/息/張り）。 */
    expr?: VoiceExpression;
    /**
     * 話し方プリセット（"neutral" / "calm" / "lively"、またはプリセット＋上書き）。
     * 話速・抑揚幅・基準ピッチ・ポーズ倍率・音量曲線に効く。既定 neutral。
     */
    style?: SpeakingStyleInput;
    /**
     * 感情（HTS 音声モデル neutral / happy / sad / angry の差し替え）。既定 neutral。
     * 初めて使う感情は約 2MB を取得してから鳴る（{@link SingingVoices.prepareSpeech} の
     * `emotions` で先取りできる）。
     */
    emotion?: SpeechEmotion;
    /** 音量（ピーク、0〜1。既定 1）。 */
    volume?: number;
    /** 定位（-1〜1。既定 0）。 */
    pan?: number;
    /**
     * 鳴らし始める AudioContext クロック秒。省略時は「今」（計画が出来しだい）。
     * 過去を渡しても今に丸める。
     */
    at?: number;
    /**
     * 全チャンクの合成完了を待ってから鳴らす。既定 false（届いた順に置く＝数モーラ分で
     * 鳴り出す）。長文をぴったり揃えて出したいときだけ立てる。
     */
    awaitRender?: boolean;
    /** 出力先ノード（既定は音源共有の出力＝ singingVoices のマスタ）。 */
    destination?: AudioNode;
    /** 中断用。abort されると計画中なら null を返し、再生中なら止める。 */
    signal?: AbortSignal;
};
/** 計画だけの結果（{@link VoiceModel.planSpeechDetail} / {@link SingingVoices.planSpeechDetail}）。 */
type SpeechPlanInfo = {
    /** 語りが音を占める長さ（秒）。 */
    durationSec: number;
    /** モーラ列。時刻は最初のモーラが鳴る時点を 0 とする秒。 */
    morae: SpeechMora[];
};
/** 計画だけを行うときのオプション（感情・話し方。ピッチは長さに効かないので無い）。 */
type SpeechPlanDetailOptions = {
    style?: SpeakingStyleInput;
    emotion?: SpeechEmotion;
};
/** 単発の語り 1 回ぶんのハンドル。 */
type SpeechHandle = {
    /** 語りが音を占める長さ（秒）。 */
    durationSec: number;
    /** 最初のモーラが鳴る AudioContext クロック秒。 */
    startTime: number;
    /** モーラ列（口パク・字幕送り用）。時刻は `startTime` 基準の秒。 */
    morae: SpeechMora[];
    /** この発話だけを即停止する（他の語り・歌には触らない）。 */
    stop: () => void;
    /** 鳴り終わった（または止められた）ときに解決する。 */
    ended: Promise<void>;
};
/**
 * klatt風フォルマント合成モデルを生成する。
 *
 * のこぎり波の声門音源を2つのバンドパス(F1,F2)で共鳴させ母音を作る。
 * 子音が摩擦音・破裂音なら短いノイズバーストを頭に付加する。
 *
 * 戻り値の VoiceModel は (音節, PlayNoteEvent) を受け取り、
 * `ctx.currentTime + e.when` のタイミングで destination へ発音する。
 */
declare const createKlattVoice: (ctx: AudioContext, destination: AudioNode, reverbBus?: AudioNode, delayBus?: AudioNode) => VoiceModel;
/** koe音源（.koe）が置かれているパブリックバケットのベースURL */
declare const KOE_BASE_URL = "https://pub-12482a6b5cbc4c9e906b2e1904cabae5.r2.dev";
/**
 * 内蔵koe音源カタログ: MML中の簡略キーワード → バケット直下の .koe ファイル名。
 * 例: `@@0 roze かな…` で「束音ロゼ」を使う。
 * ファイル名はそのまま encodeURIComponent して URL を組み立てる（{@link koeUrl}）。
 */
declare const KOE_VOICEBANKS: Record<string, string>;
/**
 * 内蔵koe音源の表示名（キーワード → 音源名）。音源選択 UI のラベル用。
 * {@link KOE_VOICEBANKS} のファイル名から版数を落としたもの。
 */
declare const KOE_VOICEBANK_NAMES: Record<string, string>;
/**
 * koe音源キーワード → UI表示名（日本語）。歌詞モデルのプルダウン等で使う。
 * MML中の値はキーワード（{@link KOE_VOICEBANKS} のキー）のまま、表示だけ和名にする。
 */
declare const KOE_VOICEBANK_LABELS: Record<string, string>;
/**
 * 音源プルダウンの大分類（optgroup）。歌唱モデルの選択 UI（mountDAW）と、
 * 読み上げ（{@link DtmStudio.speak}）を使う側の音源選択 UI で共通に使う。
 *
 * 分類に載せ忘れたキーが選べなくなると音源が増やせないので、実際の並びは
 * {@link groupVoiceModels} が作り、ここに無いキーは「その他」へ落とす。
 */
declare const VOICE_MODEL_CATEGORIES: ReadonlyArray<{
    label: string;
    models: readonly string[];
}>;
/** {@link groupVoiceModels} が返す 1 グループ（`<optgroup>` 1 つぶん）。 */
type VoiceModelGroup = {
    label: string;
    models: {
        value: string;
        label: string;
    }[];
};
/**
 * 音源一覧（キーワード → 表示名）を {@link VOICE_MODEL_CATEGORIES} の大分類へ分ける。
 * 渡された `names` に載っているキーだけを返すので、歌唱用（klatt 込み＝
 * {@link KOE_VOICEBANK_LABELS} + klatt）でも読み上げ用（klatt は語れないので
 * {@link KOE_VOICEBANK_NAMES} だけ）でも同じ関数で組める。
 * 分類に無いキーは末尾の「その他」にまとめる（音源を足した日に選べなくならないように）。
 */
declare const groupVoiceModels: (names: Record<string, string>) => VoiceModelGroup[];
/**
 * モデルキーワード → 内蔵キャラクター画像キー（voice-images.ts の VOICE_IMAGES キー）。
 * klatt合成は "puyuyu"、koe音源は音源名に対応する画像キーを返す。
 */
declare const VOICE_IMAGE_KEY: Record<string, string>;
/**
 * UTAU音源キーワード → 利用規約URL。
 */
declare const KOE_VOICEBANK_TERMS: Record<string, string>;
/** ファイル名（日本語可）を encodeURIComponent して .koe のフルURLにする */
declare const koeUrl: (name: string, base?: string) => string;
/** 多音階バンクのピッチトークン1件（トークン文字列とそのMIDI番号）。 */
type PitchToken = {
    token: string;
    midi: number;
};
/**
 * 音源マニフェストのエイリアス一覧から、多音階のピッチトークン（"_G4" 等）を収集する。
 * 接尾辞を持つエイリアスが1つも無ければ空配列（＝単独音/連続音バンク）。
 * 多音階バンクでは全エイリアスが `_ピッチ` 付きで bare エイリアスが存在しないことがあり、
 * その場合は目標ノートに最も近いトークンを base に付与しないと解決できない。
 */
declare const collectPitchTokens: (aliases: Iterable<string>) => PitchToken[];
/**
 * 語り（UtauTTS）の計画に渡す「音源の見え方」。
 *
 * UtauTTS のユニット選択は prefix.map 前提で、音名接尾辞つきのエイリアス
 * （`- あ_G4`）を素の名前では引けない。多音階音源では**収録セットを1つ選び**、
 * その接尾辞を剥がした音素表を計画に見せ、出来た計画のエイリアスを {@link toReal} で
 * 実在の名前へ戻す。接尾辞の無いエイリアスはそのまま残す（接尾辞つきと重複したら
 * 接尾辞つき＝選んだセットを優先）。単独音・連続音バンク（`token` null）は素通し。
 */
type SpeechToneView = {
    view: SpeechBank;
    /** 計画上のエイリアス → 音源に実在するエイリアス。 */
    toReal: (alias: string) => string;
    /** この見え方での収録ピッチの中央値（Hz）。基準ピッチのガイドに使う。 */
    referenceHz: number | undefined;
};
declare const createSpeechToneView: (phonemes: Record<string, PhonemeEntry>, token: string | null) => SpeechToneView;
/**
 * 音節と直前母音から、音源へ問い合わせるエイリアス候補を優先順で作る（純粋関数）。
 *
 * 命名の幅（単独音 "か" / 連続音 "a か" "- か" / ローマ字 "ka"）に加えて、
 * 音源に「本来あるのに引けていなかった」素片を拾う:
 *  - 鼻濁音（{@link LyricSyllable.nasal}）: カタカナ別名（"ガ" / "a ガ"）を最優先。
 *  - ヴ系: 音源の綴りは "ヴぁ"（ヴ+小書きひらがな）か "ヴァ"（全角カタカナ）。
 *    どちらも無ければバ行で近似する。
 *  - ぢ・づ: 同じ音の じ・ず（{@link SAME_SOUND_KANA}）。母音だけに落とす前に試す。
 *  - 語中の柔らかい立ち上がり "* あ"（重音テト単独音）: 語頭でないときに素の "あ" より優先。
 * 最後は母音単体、撥音は "ん" "n" "N" へ落とす。
 */
declare const koeAliasCandidates: (syl: LyricSyllable, prevVowel: string) => string[];
/** koe音源の生成オプション */
type KoeVoiceOptions = {
    /** .koe アーカイブのURL、または Blob/File */
    koe: string | Blob;
    /**
     * worldline.js のURL（WORLDボコーダによる高品質再合成）。
     * 省略時は GitHub Pages のホストを使う。`worldline.wasm` は同じ階層から解決される。
     */
    worldlineScriptUrl?: string;
    /**
     * Worldline（WASM）を使わず、素片を AudioBufferSource の playbackRate で
     * ピッチシフトして鳴らす軽量モード。WASMの読み込みを避けたいときに。
     */
    lightweight?: boolean;
    /**
     * 歌声合成Worker（`voice-worker.js`）のURL。指定すると重いWORLD再合成を
     * 別スレッドで実行し、メインスレッド（楽器・UI）を一切ブロックしない。
     * 省略時は従来どおりメインスレッドで合成する（後方互換）。
     */
    voiceWorkerUrl?: string;
    /**
     * マスタリバーブのバス（センド先）。指定時のみ、ノートごとの `reverbSend` に応じて
     * ドライ経路とは別にこのノードへ送る。未指定ならリバーブ送りは常にスキップされる
     * （＝トラックごとの `r` トークンを書いてもリバーブが掛からない）。
     */
    reverbBus?: AudioNode;
    /**
     * マスタディレイのバス（センド先）。指定時のみ、ノートごとの `delaySend` に応じて
     * ドライ経路とは別にこのノードへ送る。未指定ならディレイ送りは常にスキップされる。
     */
    delayBus?: AudioNode;
    /**
     * 語り（`「…」`）用の TTS アセットのベース URL（{@link file://./speech.ts}）。
     * 省略時は koe のデモと同じ GitHub Pages のホストを使う。アセットはページにつき
     * 一度だけ読み込まれ、最初の語りを合成するときに取得が始まる。
     */
    ttsBaseUrl?: string;
};
/**
 * @onjmin/koe の音源（UTAU由来 .koe）で1音節を歌う {@link VoiceModel} を生成する。
 *
 * VoiceBank で音素PCMをオンデマンド取得し、Worldline（WORLDボコーダ）で目標ピッチ・
 * 音価へ再合成して、共有 AudioContext のタイムライン（`ctx.currentTime + e.when`）へ
 * スケジュールする。Worldlineが使えない／素片が短すぎる場合は素片のピッチシフトへ自動フォールバックする。
 *
 * 音源とWASMの読み込みは非同期のため、戻り値は Promise。`await` してから歌わせること。
 */
declare const createKoeVoice: (ctx: AudioContext, destination: AudioNode, options: KoeVoiceOptions) => Promise<VoiceModel>;
/**
 * 音源の息継ぎ素片のエイリアスかどうか。
 *
 * 手元の UTAU 音源を洗った命名（oto.ini のエイリアス側）:
 *   - 重音テト（エクストラ）: `息1` `息2` `息3` と、その別名 `b1` `b2` `b3`
 *   - 蓄音キリコ: `息`
 *   - 束音ロゼ: `息短` `息短2` `息中` `息深` `息深2`（拡張音声は `息（短）拡` 等）
 *   - 欲音ルコ♀: `息1`〜`息3`、吐く息 `息吐1` `息吐2`
 *   - 英語圏の慣習: `br` `br1` `breath`
 * 除くもの: `息吐`（吐く息＝語尾の抜け）、`a息 R`（母音の後の吐息。テトの `_あb.wav`）、
 * `巻`（巻き舌）。ブレス記号 `、` は吸気なので、吸う素片だけを拾う。
 */
declare const isBreathAlias: (alias: string) => boolean;
/**
 * 隙間 `targetSec` にいちばん合う息継ぎ素片を音素表から選ぶ。
 *
 * 吸気は終わり際（発声直前）が山なので、隙間より長い素片は尻を揃えて頭を切れば
 * 自然に収まる。逆に短すぎる素片は伸ばせない。そこで「隙間以上でいちばん短いもの」を
 * 第一候補にし、無ければ「いちばん長いもの」を選ぶ。ただし極端に長い素片
 * （深い息）は頭を切っても質感が違うので、上限を超えるものは後回しにする。
 */
declare const pickBreathAlias: (phonemes: Record<string, PhonemeEntry>, targetSec: number) => string | null;
/** 取得済みの息素片（{@link VoiceModel.breathSample} の候補）。 */
type BreathSample = {
    alias: string;
    buffer: AudioBuffer;
    /** 長さ（秒）。 */
    sec: number;
    /** 包絡の山の位置 0〜1（{@link breathPeakPosition}）。 */
    peakAt: number;
};
/**
 * 息素片の包絡の山の位置（0=頭、1=尻）。10ms の実効値を取り、最大から -30dB 以上の
 * 区間を有効区間として、その中で最大が何割の位置にあるかを返す。
 * 吸う息は発声の直前が山なので後ろ寄り、吐く息は頭で出て減るので前寄りになる。
 */
declare const breathPeakPosition: (pcm: ArrayLike<number>, sampleRate: number) => number;
/**
 * 隙間 `targetSec` に使う息素片を選ぶ。吸う形（{@link BREATH_INHALE_PEAK_MIN}）のものが
 * あればその中から、無ければ全部の中から、{@link pickByLength} で長さの合うものを取る。
 */
declare const pickBreathSample: <T extends {
    sec: number;
    peakAt: number;
}>(samples: readonly T[], targetSec: number) => T | null;
/** ストリーミング再生する歌唱ノート1つ（絶対時刻ベース）。 */
type StreamVoiceNote = {
    syllable: LyricSyllable;
    /**
     * ピッチ。単位は units（1/372オクターブ）。koe は Hz を受けるので、
     * ここから直接 Hz へ変換して歌わせる（整数MIDIノートに丸めない）。
     * 継続記号で複数ノートが結合されている場合は**先頭区間**のピッチ。
     */
    pitch: Units;
    /** アンカー（再生開始時刻）からの相対秒。実発音時刻 = anchorTime + startSec。 */
    startSec: number;
    /** ゲート適用済みの発音長（秒）。結合されている場合は結合後の全長。 */
    durationSec: number;
    /**
     * 継続記号（`ー` / `〜`）で結合された2区間目以降のピッチ推移。
     * これがあるノートは「1回の合成で歌い切る長い1音」で、区間の境界では
     * 言い直さずにピッチだけが動く。
     */
    pitchSegments?: PitchSegment[];
    /**
     * 直前ノートからの継続として鳴らす（結合できなかった `ー` / `〜`）。
     * 発音側は先行母音を切り、立ち上がりを直前ノートへ被せて言い直し感を消す。
     */
    continuation?: boolean;
    /**
     * このノートの直後にブレス（`、`）を入れる。
     * `durationSec` は既にブレスぶん切り詰めてある。
     */
    breath?: boolean;
    /**
     * ブレスのために `durationSec` から実際に削った長さ（秒）。息はこの隙間を
     * 埋めるように鳴る（短い音符では {@link BREATH_MAX_RATIO} で隙間も短くなる）。
     */
    breathGapSec?: number;
    /**
     * 直前のノートとの間に {@link PHRASE_GAP_SEC} 以上の休符がある（旋律側の休符）。
     * 歌詞に `_` が無くても声は一度止まっているので、語頭（"- か"）として歌う。
     */
    phraseStart?: boolean;
    /**
     * このノートでフレーズが終わる（次が休符・語り・ブレス・行末、または旋律側の
     * {@link PHRASE_GAP_SEC} 以上の隙間）。音源に語尾の素片があればそれで抜く。
     * 促音（っ）の前は閉鎖であって抜けではないので立てない。`↓` で消える音にも立てない。
     */
    phraseEnd?: boolean;
    /**
     * このノートを歌いながら声量0へ落とす（`↓`）。継続記号で結合されたグループの
     * どこに `↓` が付いていても、**結合後の1音全体**に掛かる。
     */
    fadeOut?: boolean;
    /** このノートを歌いながら声量を上げていく（`↑`）。{@link StreamVoiceNote.fadeOut} の対。 */
    fadeIn?: boolean;
    /**
     * 声量の中継点列（`↓` / `↑` を1音へ複数書いたとき）。{@link buildFadeCurve} 参照。
     * 記号が1つだけ／スウェルのときは付かない（＝従来どおり1音まるごと）。
     */
    fadeCurve?: FadeStop[];
};
/**
 * 継続記号でノートを結合できる上限（秒）。これを超える長さは1回の合成に載せず、
 * 分割して継続ノート（{@link StreamVoiceNote.continuation}）として繋ぐ。
 *
 * WORLD再合成のコストは音価にほぼ比例するので、際限なく結合すると先読みが
 * 間に合わず「遅延スキップ」で歌が抜ける。
 * ロングトーンとして実用になる長さを確保しつつ、合成が破綻しない上限。
 */
declare const TIE_MERGE_MAX_SEC = 4;
/**
 * 旋律の休符をフレーズの切れ目とみなす最短の隙間（秒）。これ以上空いていれば
 * 歌い手は一度声を止めているので、前は語尾の素片で抜き、次は語頭（"- か"）で入る。
 * これより短い隙間はスタッカート扱いで、声の文脈（直前母音）は繋いだままにする。
 */
declare const PHRASE_GAP_SEC = 0.15;
/** {@link buildStreamVoiceNotes} が受け取る演奏ノート（startStep 昇順で渡すこと）。 */
type TieSourceNote = {
    startStep: number;
    durationSteps: number;
    pitchUnits: Units;
};
/** {@link buildStreamVoiceNotes} のタイミング・移調パラメータ。 */
type StreamVoiceNoteOptions = {
    /** シーク開始位置（ステップ）。これより前に始まるノートは切り落とす。 */
    fromStep: number;
    /** 1ステップの実時間（秒）。 */
    secondsPerStep: number;
    /** ゲートタイム係数 0-1（歌詞トラックの `q` を正規化したもの）。 */
    gate: number;
    /** 歌唱ピッチのオクターブシフト（units）。 */
    octaveShiftUnits: number;
};
/**
 * 音節列と演奏ノート列を突き合わせ、ストリーミング用のノート列を組み立てる。
 *
 * 音節とノートは**発音順（startStep昇順）の index で1:1**に対応する。これは
 * ピアノロールの歌詞表示（`renderer.drawNoteLyrics`）とも共通の規則。
 *
 * 継続記号（`ー` / `〜`）はここでノートへ畳まれる:
 * - 直前ノートと**隙間なく続いている**なら1音へ結合し、{@link StreamVoiceNote.pitchSegments}
 *   としてピッチ推移だけを持たせる（＝1回の合成で歌い切る）。
 * - 隙間がある／{@link TIE_MERGE_MAX_SEC} を超えるなら結合をやめ、
 *   {@link StreamVoiceNote.continuation} を立てた別ノートとして繋ぐ。
 * - シークで先頭が切り落とされた継続（結合相手が居ない）も同じく継続ノートになる。
 *
 * 隙間の判定は**ゲート適用前のステップ**で行う。ゲートを短くすると全ノートの間に
 * 隙間ができるが、それは発音長の設定であって「音が途切れている」ことではないため。
 */
declare const buildStreamVoiceNotes: (syllables: LyricSyllable[], sorted: TieSourceNote[], o: StreamVoiceNoteOptions) => StreamVoiceNote[];
/** ストリーミング再生する歌詞トラック1本。 */
type StreamVoiceTrack = {
    /**
     * 呼び出し側がソロ/ミュート判定に使う識別子（演奏トラックの config.id 等）。
     * {@link StreamPlaybackOptions.isAudible} で参照する。省略時は常に可聴。
     */
    id?: string;
    /** 歌唱モデル名（koe音源キーワード or "klatt"）。 */
    model: string;
    /** 最終ゲイン（声量×マスタ等を適用済み。1=等倍）。 */
    volume: number;
    /** ステレオ定位 -1〜+1。 */
    pan: number;
    /**
     * 自動ビブラート ON/OFF。ONでも全ノートには掛からず、{@link VIBRATO_MIN_SEC} 以上の
     * ロングトーンにだけ自動適用される（短い音符は不自然になるため対象外）。
     */
    vibrato?: boolean;
    /**
     * マスタリバーブへのセンド量 0-1。既定0（マスタリバーブが掛からない）。
     * マスタリバーブ自体のつまみ（残響の質・量）とは独立に、このトラックをどれだけ
     * リバーブバスへ送るかを個別に決める。
     */
    reverbSend?: number;
    /**
     * マスタディレイへのセンド量 0-1。既定0（ディレイが掛からない）。マスタディレイ自体の
     * つまみ（音価・掛かり具合）とは独立に、このトラックをどれだけディレイバスへ送るかを決める。
     */
    delaySend?: number;
    /**
     * フォルマント/ジェンダーファクター 0-1。既定0.5（無変化）。koe音源（Worldline）限定
     * — klattフォールバックには効かない。0.5未満で低め/太め、0.5超で高め/細めに寄る。
     */
    gender?: number;
    /**
     * ブレシネス（息成分）0-1。既定0.5（無変化）。koe音源（Worldline）限定
     * — klattフォールバックには効かない。
     */
    breathiness?: number;
    /**
     * テンション（張り/力強さ、"こぶし"寄り）0-1。既定0.5（無変化）。koe音源（Worldline）限定
     * — klattフォールバックには効かない。
     */
    tension?: number;
    /**
     * オクターブユニゾン。各音節をもう1声、1オクターブ上/下（控えめな音量）で重ねて発音し、
     * 声に厚み（下）または煌びやかさ（上）を足す。既定 "none"（重ねない）。
     */
    octaveUnison?: OctaveUnisonMode;
    /** 発音順（startSec昇順）の歌唱ノート列。 */
    notes: StreamVoiceNote[];
};
/** {@link SingingVoices.startStream} の任意オプション。 */
type StreamPlaybackOptions = {
    /**
     * そのトラックを今この瞬間に発音してよいか（ソロ/ミュート判定）。
     * 各ノートを合成・スケジュールする直前にライブで評価するため、再生中に
     * ソロを切り替えると先読み地平（最大 {@link STREAM_LOOKAHEAD_SEC} 秒）以降のノートへ反映される。
     * 既にスケジュール済みのノートは鳴り切る（楽器側のミュート挙動と同じ）。
     * 省略時は全トラック可聴。
     */
    isAudible?: (track: StreamVoiceTrack) => boolean;
    /**
     * 合成が間に合わず発音をスキップ（ミュート）した際のコールバック。
     * 引数には遅れたノート情報と遅延秒数が渡されます。
     */
    onLateSkip?: (note: StreamVoiceNote, delay: number) => void;
    /**
     * ノートの発音が実際にスケジュールされた瞬間に呼ばれる（合成完了後、AudioContext へ
     * 予約する直前）。UI側で「今このトラックが鳴っている」を可視化する用途を想定。
     * t0 は発音予定の AudioContext 絶対時刻。
     */
    onScheduled?: (track: StreamVoiceTrack, note: StreamVoiceNote, t0: number) => void;
    /** シームレスループ用の1周の長さ（秒）。指定時は曲末に達したら音節インデックスを先頭に戻し内部オフセットへ加算する */
    loopLengthSec?: number;
    /** ループ再開位置（秒）。省略時は 0 */
    loopStartSec?: number;
};
/**
 * 歌唱モデルをまとめて管理し、koeデモ式の「先読みストリーミング合成」で歌わせる高レベルヘルパ。
 *
 * 再生開始時に {@link startStream} を呼ぶと、各音を**全力で先回り合成**しながら、
 * 出来た音を AudioContext クロックの**絶対時刻へ即スケジュール**する。再生はオーディオスレッドが
 * 担うため、合成中にメインスレッドがもたついても同期ズレ・音切れが起きない。スロットルは掛けない。
 *
 * 典型的な使い方（呼び出し側＝シーケンサ）:
 *   await voices.loadModels(models);          // .koe をfetch（ローディング表示）
 *   await voices.warm(tracks);                // 先頭数音だけ先に合成（頭出しの貯金）
 *   seq.start(fromStep);                      // 楽器とUIはシーケンサ
 *   voices.startStream(tracks, seq.getStartTime()); // 歌声は同じアンカーで先読み合成
 */
type SingingVoices = {
    /** 使用する歌唱モデル（.koe）をロードして完了を待つ。 */
    loadModels: (models: Iterable<string>) => Promise<void>;
    /**
     * koe音源カタログへキーワード → .koe URL（または Blob）を追加・上書き登録する。
     * カスタムボーカル（`@@key icon_url koe_url` / DawOptions.customVocals）の音源を
     * 再生前に流し込むために使う。同一キーへ同じ値を再登録した場合はロード済み
     * キャッシュを保ったまま無視する。省略可能（外部注入の実装が無くても動くように）。
     */
    registerVoicebanks?: (banks: Record<string, string | Blob>) => void;
    /**
     * 各トラック先頭の数音を先に合成してキャッシュへ積む（頭出しの貯金）。
     * これで再生開始直後の密なフレーズでもアンダーランしにくくなる。count 既定 {@link PREWARM_NOTES}。
     */
    warm: (tracks: StreamVoiceTrack[], count?: number, onProgress?: (done: number, total: number) => void) => Promise<void>;
    /**
     * 歌声のストリーミング再生を開始する。anchorTime は startSec=0 が鳴るべき
     * AudioContextクロック秒（＝シーケンサの開始時刻と一致させること）。
     * 即座に return し、合成は裏で先回り進行する。
     */
    startStream: (tracks: StreamVoiceTrack[], anchorTime: number, opts?: StreamPlaybackOptions) => void;
    /** 進行中のストリームを中断し、スケジュール済みの発音をすべて止める（停止・一時停止・シーク）。 */
    stopStream: () => void;
    /** ストリーム停止＋各モデルの内部状態を初期化する。 */
    reset: () => void;
    /**
     * マスタ音量（0〜1のゲイン）をリアルタイムに反映する。
     * 発音時にゲインを焼き込む方式だと再生中の音量変更が既にスケジュール済み・
     * ストリーミング中の音符に効かないため、全モデル共通の GainNode を介して
     * 常時ライブ反映できるようにする。
     */
    setVolume: (gain: number) => void;
    /**
     * 語り（`「…」`）の計画だけを行い、占める長さ（秒）を返す（ピアノロールの帯表示用）。
     * 音源が未ロードならロードし、TTS アセットが未取得なら取得から始める（初回は重い）。
     * klatt 等の語りに対応しないモデルや、計画できない本文では null。省略可能。
     */
    planSpeech?: (model: string, text: string, options?: SpeechPlanDetailOptions) => Promise<number | null>;
    /**
     * 語りの計画だけを行い、長さとモーラ列（口パク・字幕送り用）を返す。
     * {@link planSpeech} と同じ条件で null。省略可能。
     */
    planSpeechDetail?: (model: string, text: string, options?: SpeechPlanDetailOptions) => Promise<SpeechPlanInfo | null>;
    /** 計画済みの語りの長さ（秒）を同期で引く（描画ループ用。未計画なら undefined）。 */
    peekSpeechDurationSec?: (model: string, text: string) => number | undefined;
    /**
     * 語りの基準ピッチ（units）。この行にノートを置くと音源の素の声の高さで話す。
     * 音源がロード済みのときだけ返る（ロード前・klatt は undefined）。
     */
    getSpeechReferenceUnits?: (model: string) => number | undefined;
    /**
     * 読み上げに必要なもの（TTS アセット約 45MB と、指定した音源のマニフェスト）を
     * 先に取得する。ゲームのロード画面など、最初の一言で待たせたくない場面で呼ぶ。
     * 進捗は TTS アセットの合算バイト数（Cache API 済みなら一瞬で total に達する）。
     * 何度呼んでも二重取得はしない。
     */
    prepareSpeech?: (models: Iterable<string>, options?: SpeechPrepareOptions) => Promise<void>;
    /**
     * 本文を指定した音源で読み上げる（MML を介さない単発の語り。セリフ・ナレーション用）。
     * 音源が未ロードならロードし、TTS アセットが未取得なら取得から始める（初回は重い。
     * {@link prepareSpeech} で先に済ませられる）。
     * klatt 等の語りに対応しないモデル、未知のモデル、計画できない本文では null。
     */
    speak?: (model: string, text: string, options?: SpeakOptions) => Promise<SpeechHandle | null>;
};
/** {@link SingingVoices.prepareSpeech} のオプション。 */
type SpeechPrepareOptions = {
    /** ダウンロード進捗（TTS アセット＋感情モデルの合算バイト数）。 */
    onProgress?: (loadedBytes: number, totalBytes: number) => void;
    /** 先取りしておく感情モデル（neutral は常に含まれるので書かなくてよい）。 */
    emotions?: Iterable<SpeechEmotion>;
};
/** {@link SingingVoices.speak} のオプション。 */
type SpeakOptions = SpeakVoiceOptions & {
    /**
     * 話す高さ。音源の素の声（収録ピッチ）からの半音オフセット。既定 0。
     * ±24 を超えると声にならないので、その範囲で丸める。
     */
    pitchOffset?: number;
};
/** {@link SingingVoices.warm} の既定先合成数（各トラック先頭からの音数）。 */
declare const PREWARM_NOTES = 3;
type SingingVoicesOptions = {
    /** 追加・上書きするkoe音源カタログ（キーワード → .koe URL または Blob） */
    voicebanks?: Record<string, string | Blob>;
    /** worldline.js のURL（{@link createKoeVoice} に渡す） */
    worldlineScriptUrl?: string;
    /** koe音源を軽量モード（素片ピッチシフト）で鳴らす */
    lightweight?: boolean;
    /**
     * 歌声合成Worker（`voice-worker.js`）のURL。指定すると重いWORLD再合成を
     * 別スレッドで実行し、メインスレッド（楽器・UI）を一切ブロックしない（モバイル推奨）。
     * 省略時は従来どおりメインスレッドで合成する。
     */
    voiceWorkerUrl?: string;
    /**
     * マスタリバーブのバス（センド先）。指定すると、各歌詞トラックの `reverb`（`r`トークン）
     * に応じて klatt/koe いずれの音源もこのノードへセンドできるようになる。未指定なら
     * トラック側で `r` を指定してもリバーブは掛からない（studio.ts がマスタの
     * Convolver 入力を渡す想定）。
     */
    reverbBus?: AudioNode;
    /**
     * マスタディレイのバス（センド先）。指定すると、各歌詞トラックの `delay`（`e`トークン）
     * に応じて klatt/koe いずれの音源もこのノードへセンドできるようになる。未指定なら
     * トラック側で `e` を指定してもディレイは掛からない。
     */
    delayBus?: AudioNode;
    /**
     * トラックID → チャンネルストリップ入口ノードの解決関数。指定すると、各トラックの
     * 発音は共有の `destination`（singingVoices内部マスタ）へ直結する代わりに、この
     * 関数が返すノードへ流れる（コンプレッサー/ステレオワイドを個別に掛けるため）。
     * 未指定または戻り値が undefined のトラックは共有の `destination` へそのまま流れる。
     */
    getTrackDestination?: (trackId: string) => AudioNode | undefined;
    /**
     * 語り（`「…」`）用の TTS アセットのベース URL（{@link createKoeVoice} に渡す）。
     * 省略時は koe のデモと同じ GitHub Pages のホスト（{@link DEFAULT_TTS_BASE_URL}）。
     */
    ttsBaseUrl?: string;
};
/**
 * klatt と koe音源を一括で扱う {@link SingingVoices} を生成する。
 */
declare const createSingingVoices: (ctx: AudioContext, destination: AudioNode, options?: SingingVoicesOptions) => SingingVoices;
/** 歌唱合成モデルのレジストリ（プラグイン方式） */
type VoiceRegistry = {
    /** 指定モデルで1音節を歌う。未登録モデルは fallback へ委譲する */
    sing: (model: string, syllable: LyricSyllable, e: PlayNoteEvent) => void;
    /** 歌唱合成モデルを登録する（拡張用） */
    register: (name: string, model: VoiceModel) => void;
};
/**
 * モデル名 → 合成実装のレジストリを生成する（プラグイン方式）。
 * 未登録のモデル名は fallback（既定 "klatt"）へ委譲する。
 */
declare const createVoiceRegistry: (models?: Record<string, VoiceModel>, fallback?: string) => VoiceRegistry;

type RechordScore = {
    id: number;
    title: string;
    content: string;
    bpm?: number;
    capo?: number;
    beat?: string;
    instrument?: string;
    loop?: boolean;
    user?: {
        id: number;
        name: string;
        screen_name: string;
        twitter?: string;
    };
};
type MidiSearchConfig = {
    apiKey?: string;
    baseUrl?: string;
};
type PicotuneSong = {
    id: string;
    file: string;
    title: string;
    user: string;
    twitter_id?: string;
    date?: string;
    no?: number;
    description?: string;
};
type PicotuneSearchParams = {
    title?: string;
    user?: string;
    twitter_id?: string;
};
declare class MidiSearchClient {
    private config;
    constructor(config?: MidiSearchConfig);
    get enabled(): boolean;
    private get baseUrl();
    private headers;
    searchSongs(params: PicotuneSearchParams): Promise<PicotuneSong[]>;
    fetchMidi(fileName: string): Promise<ArrayBuffer>;
    searchRechord(word: string): Promise<RechordScore[]>;
}

declare const DEFAULT_VOCAL_VOLUME = 200;
declare const DEFAULT_BPM = 120;
declare const DEFAULT_GATE = 100;
declare const DEFAULT_PAN = 64;
declare const DEFAULT_VELOCITY = 100;
declare const DEFAULT_PLAYBACK_VELOCITY = 127;
declare const DEFAULT_STEPS_PER_BAR = 192;
declare const MML_END_MARKER = "#end;";
/**
 * ピアノロールが扱う音域の下端・上端（両端含む）。音律に依らず固定で、MIDI 0-127 に相当する。
 * 「音律を変えても鳴らせる音の高さの範囲は変わらない」を保証するための不変条件。
 */
declare const PITCH_RANGE_START = 0;
/** MIDI 127 相当。単位は 1/372オクターブ（127 × 31）。 */
declare const PITCH_RANGE_END = 3937;
/**
 * 1行が受け持つピッチ幅（units）。12平均律は1半音 = 31、31平均律は1度 = 12。
 * 行数はここから導出されるので、12平均律で128行・31平均律で328行になる。
 */
declare const unitsPerRow: (edo: number) => number;
/** その音律での行数。音域と1行あたりのピッチ幅から導出する（直接指定しないこと）。 */
declare const keyCountFor: (edo: number) => number;
/** 12平均律の行数（従来と同じ128）。 */
declare const KEY_COUNT: number;
type Note = {
    id: number;
    startStep: number;
    durationSteps: number;
    /**
     * ピッチ。単位は **1/372オクターブの整数**（`tuning.ts` 参照）。
     * 12平均律の1半音 = 31、31平均律の1度 = 12。MIDIノート番号ではないので注意。
     * dtm 1.x の `pitch`（半音）から意味が変わっている。
     */
    pitchUnits: Units;
    velocity?: number;
};
type RenderConfig = {
    stepsPerBar: number;
    /**
     * 行数。{@link KEY_COUNT} のように「音域 ÷ 1行あたりのピッチ幅」から導出した値を渡す。
     * 音律ごとに直接指定しないこと（31平均律で音域が勝手に縮む）。
     */
    keyCount: number;
    /** 音域の下端。単位は units（1/372オクターブ）。 */
    pitchRangeStart: number;
    /** 1行が受け持つ units。{@link unitsPerRow} から導出した値を渡す。省略時は31（12平均律）。 */
    unitsPerRow?: number;
    keyHeight: number;
    stepWidth: number;
    /**
     * 曲全体の音律（1オクターブの分割数）。省略時は12（12平均律）。
     *
     * 音律はデータにも音声経路にも入らず、格子・記譜・表示だけに効く編集上の概念なので、
     * 描画設定と同じ場所に置く。MMLCore も `getConfig()` 経由でここから音律を読み、
     * 綴り（`#`=2度 / `+`=1度 など）を切り替える。
     */
    edo?: number;
};
type CoreEventHandlers = {
    onMMLGenerated: (mml: string) => void;
    onNotesChanged: (notes: Note[]) => void;
    onNoteClick?: (step: number, pitch: number, isErasing: boolean) => void;
};
type PreviewSoundCallback = (pitch: number, position: number) => void;
type AddNoteOptions = {
    noteLengthSteps: number;
    velocity?: number;
};
/** 歌詞・UTAU設定の同期データ。 */
type LyricSyncData = {
    lyrics: string;
    model: string;
    vocalVolume: number;
    vocalGate: number;
    vocalPan: number;
    vocalOctave: number;
    vocalVibrato?: boolean;
    vocalReverb?: number;
    vocalDelay?: number;
    vocalGender?: number;
    vocalBreathiness?: number;
    vocalTension?: number;
    vocalOctaveUnison?: OctaveUnisonMode;
};
/** パッチ送受信用ノートデータ（ローカルIDを持たない）。 */
type NoteData = {
    startStep: number;
    /** 1/372オクターブ単位。{@link Note.pitchUnits} と同じ。 */
    pitchUnits: Units;
    durationSteps: number;
    velocity?: number;
};
/** パッチ削除指定（startStep + pitchUnits で音符を特定）。 */
type NoteRemove = {
    startStep: number;
    /** 1/372オクターブ単位。{@link Note.pitchUnits} と同じ。 */
    pitchUnits: Units;
};
type PianoRollOptions = {
    mountTarget: HTMLElement;
    width?: number;
    height?: number;
    config: RenderConfig;
    noteLengthSteps?: number;
    onPreviewSound?: PreviewSoundCallback;
};
type ToolMode = "pen" | "select" | "eraser";
/**
 * カスタムボーカル定義。
 * MML 中の `@@key icon_url koe_url` 構文で宣言するか、
 * `DawOptions.customVocals` から静的に登録できる。
 *
 * - `key`     : MML 中のモデル名（例: "testvocal"）。小文字で一意。
 * - `iconUrl` : アイコン画像の URL。読み込み失敗時は assets/404Chip.png にフォールバック。
 *              未指定・空文字・不正 URL もフォールバック扱い。
 * - `url`     : koe 音源 URL（.koe ファイル）。常識外の長さ（> 2048 文字）は無視する。
 * - `label`   : UI プルダウン表示名。省略時は key をそのまま使う。
 */
type CustomVocalDef = {
    key: string;
    iconUrl: string;
    url: string;
    label?: string;
};
type TrackConfig = {
    id: string;
    name: string;
    /** ノート描画色 [r, g, b] */
    color: [number, number, number];
    /** MMLチャンネル番号 (@n)。再生時のトラック識別にも使う */
    instrument: number;
    /** 0-127。velocity兼ボリューム（既存挙動を踏襲） */
    volume: number;
};
/**
 * 声量エンベロープの中継点。`↓` / `↑` を1音へ複数書いたときの
 * 「途中でここまで落とす（上げる）」を表す。
 *
 * 位置を秒ではなく比率で持つのは、音源ごとに実時間の決め方（合成長・リリースの
 * 取り方）が違うため。受け取った側が自分のサステイン区間へ写して使う。
 */
type FadeStop = {
    /** サステイン区間内の位置 0〜1（0=立ち上がり直後、1=終端）。 */
    at: number;
    /** その位置で到達する声量（ピークに対する比 0〜1）。 */
    level: number;
};
type PlayNoteEvent = {
    trackId: string;
    /**
     * ピッチ。単位は 1/372オクターブの整数（{@link Note.pitchUnits} と同じ）。
     * 周波数へは `tuning.ts` の `unitsToHz`、SoundFont のような整数ゾーンの音源へは
     * `unitsToMidiDetune` を使う。{@link PlayDrumEvent.pitch} はGM打楽器のキー番号で
     * 音高ではないため、こちらとは別物。
     */
    pitchUnits: Units;
    /** 元ノートのvelocity (0-127) */
    velocity: number;
    /** トラックvolume×velocityを反映した 0-1 程度の音量係数 */
    volume: number;
    /** 「今」からの相対秒。利用側は audioCtx.currentTime + when で発音する */
    when: number;
    /** 秒 */
    duration: number;
    /**
     * 継続記号（`ー` / `〜`）で結合されたノート内のピッチ推移（2区間目以降）。
     * 先頭区間のピッチは {@link PlayNoteEvent.pitchUnits}、`duration` は結合後の全長。
     * 未指定なら従来どおり単一ピッチの1音として鳴らせばよい。
     */
    pitchSegments?: PitchSegment[];
    /**
     * 声量エンベロープの中継点列（`↓` / `↑` を1音へ複数書いたとき）。
     * 未指定なら {@link LyricSyllable.fadeOut} / {@link LyricSyllable.fadeIn} の
     * とおり「1音まるごと」の増減になる。
     */
    fadeCurve?: FadeStop[];
    /**
     * ステレオ定位 -1(完全左)〜+1(完全右)、0が中央。未指定は中央扱い。
     * 歌詞トラックに p<n>(0-127, 既定64=中央) があれば正規化した値が載る。
     * 合成側は StereoPannerNode.pan などにそのまま渡せばよい。
     */
    pan?: number;
    /**
     * 歌詞同期で消費された音節（@@n 歌詞トラックがあるときのみ）。
     * 利用側は voiceModel に応じて歌唱合成へ回す。未指定なら楽器音として鳴らす。
     *
     * この音節が載っているとき、volume はノートのvelocityではなく
     * 歌詞トラック独自の「声量」(model:vol) ×マスタ音量を反映する。
     * 合成音声は velocity を参照せず volume をそのまま音量係数として使えばよい。
     */
    syllable?: LyricSyllable;
    /** syllable を歌う合成モデル名（"klatt" 等）。syllable とセットで届く */
    voiceModel?: string;
    /**
     * マスタリバーブへのセンド量 0-1（既定0）。歌詞トラックの個別リバーブ設定を
     * 反映する。合成側はドライ経路とは別にこの割合だけリバーブバスへ送ればよい。
     */
    reverbSend?: number;
    /**
     * マスタディレイへのセンド量 0-1（既定0）。歌詞トラックの個別ディレイ送り設定を反映する。
     * リバーブと同じくドライ経路とは別にこの割合だけディレイバスへ送ればよい。
     */
    delaySend?: number;
    /**
     * 発音先の上書き（未指定なら合成側の既定destinationへ）。トラック単位チャンネルストリップ
     * （コンプレッサー/ステレオワイド）の入口ノードを渡すことを想定。
     */
    destination?: AudioNode;
};
/**
 * 音節の種別。省略時（undefined）は通常のかな音節。
 *
 * - `"tie"`  : 継続記号（`ー` / `〜`）。ノートは消費するが**言い直さない**。
 *   直前の母音をそのまま引き継ぎ、ピッチだけを動かす。
 * - `"stop"` : 促音（`っ`）。ノートを消費し、無音の閉鎖として間を作る。
 * - `"rest"` : 明示的な休符（`_`）。ノートを消費するが歌わない（そのノートは無音）。
 *   歌詞トラックは楽器音も鳴らさないので、`_` はそのまま「歌の休み」になる。
 *   直前母音の文脈もここで切れる（次の音節は語頭として扱われる）。
 * - `"speak"`: 語り（`「…」`）。括弧ひとかたまりでノートを1つ消費し、そのノートの
 *   位置から中身のテキストを読み上げる（UtauTTS）。長さは読み上げが決めるので
 *   ノートの音価は使わない。音高は話す基準ピッチになる。中身は漢字混じりでよく、
 *   読みとアクセントは jpreprocess（OpenJTalk 互換）が決める。
 *   直前母音の文脈は切れる（次の音節は語頭として歌われる）。
 */
type LyricSyllableKind = "tie" | "stop" | "rest" | "speak";
type LyricSyllable = {
    /** 表示用かな（"きょ" 等。長音は置換後の母音かな） */
    kana: string;
    /** ローマ字子音（"k" "sh" 等。母音始まり・撥音は ""／"N"、促音は "Q"） */
    consonant: string;
    /** 母音 "a"|"i"|"u"|"e"|"o"、撥音 "N"、促音・語り "" */
    vowel: string;
    /**
     * 鼻濁音（が゜ / カタカナのガ行）。UTAU音源はカタカナのガ行を鼻濁音の別名にする
     * 慣習があり（重音テト・欲音ルコ♀）、その素片を引くための印。表示はカタカナへ戻す。
     */
    nasal?: boolean;
    /**
     * `kind === "speak"` のとき、読み上げる本文（`「…」` の中身、漢字混じり可）。
     * 歌唱の音節では付かない。
     */
    text?: string;
    /**
     * 音節の種別。省略時は通常のかな音節。
     * 発音・表示・MMLへの書き戻しの分岐に使う（{@link LyricSyllableKind}）。
     */
    kind?: LyricSyllableKind;
    /**
     * `kind === "tie"` のとき、直前ピッチから時間を掛けて滑る（`〜`）。
     * false（`ー`）なら素早く移る。どちらもピッチは連続に動き、違いは掛ける時間だけ。
     */
    portamento?: boolean;
    /**
     * この音節の直後にブレス（息継ぎ）を入れる（`、`）。
     * ブレス自体はノートを消費しない — 直前ノートの尻を削って息を差し込み、
     * 次の音節を語頭（連続音の `- か`）として歌わせる。
     */
    breathAfter?: boolean;
    /**
     * この音節を歌いながら声量を0へ落としていく（`↓`）。
     *
     * 記号自体はノートを消費しない（{@link LyricSyllable.breathAfter} と同じ扱い）。
     * 継続記号で1音へ結合されたグループに付いた場合は、**結合後の音全体**に掛かる——
     * `あーーーーー↓` は「あ」を伸ばしたまま最後まで滑らかに消えていく、という意味になる。
     *
     * 1つの音へ**複数書く**と、書いた位置が減り方の中継点になる（{@link FadeStop}）。
     * k個書いたとき、i番目が付いた区間の終わりで声量が (k-i)/k 倍になる:
     * `ぎ↓ー↓` なら「ぎ」の終わりで50%→音の終わりで0%、`ぎ↓ー↓ー↓` なら
     * 66%→33%→0%。最後の1つだけは書いた位置に関わらず音の終端へ置かれる。
     */
    fadeOut?: boolean;
    /**
     * この音節を歌いながら声量を上げていく（`↑`）。{@link LyricSyllable.fadeOut} の対。
     *
     * 両方立っている場合（`あーーー↑↓`）は**スウェル**——小さく入って中央で最大、
     * そこから消えていく。声楽の messa di voce にあたる形で、`↑↓` `↓↑` どちらの
     * 順で書いても同じ意味になる。
     *
     * {@link LyricSyllable.fadeOut} と同じく複数書けば中継点になる（`ぎ↑ー↑` なら
     * 「ぎ」の終わりで50%→音の終わりで最大）。ただし `↑` と `↓` が同じ音に
     * 混在するときはスウェル優先で、中継点は付かない。
     */
    fadeIn?: boolean;
};
/**
 * オクターブユニゾンの重ね方。
 * - "none": 重ねない（既定）
 * - "down": 1オクターブ下をもう1声重ねる（声に厚み・重みを足す）
 * - "up"  : 1オクターブ上をもう1声重ねる（煌びやかさ・可憐さを足す）
 * - "both": 上下両方を重ねる
 */
type OctaveUnisonMode = "none" | "down" | "up" | "both";
type LyricTrack = {
    /** 対応する演奏トラックID（@n の n） */
    trackId: number;
    /** 合成モデル名（"klatt" 等。小文字化済み） */
    model: string;
    /**
     * 歌唱の声量 0-400。ノートのvelocity（楽器の強弱）とは独立した合成音声専用パラメータ。
     * MMLでは `@@n klatt v80 …` のように v トークンで付与する（`model:80` も後方互換で可）。既定300。
     * 0 で無音、100 で等倍、100超は増幅（ブースト）。実ゲインは vocalVolumeToGain により
     * 0-100は線形・100超はdB線形（対数）で換算され、v=400 で約 +24dB（≒15.8倍）になる。
     */
    volume: number;
    /**
     * 歌唱のゲートタイム 0-100（音価に対する発音長の割合）。既定100（レガート）。
     * MMLでは `@@n klatt q80 …` のように q トークンで付与する。
     * 小さいほど短く切れた発音（ハイライトも早く消える）、100 で次の音節直前まで持続。
     */
    gate: number;
    /**
     * ステレオ定位 0-127（0=完全左, 64=中央, 127=右）。既定64。
     * MMLでは `@@n klatt p0 …` のように p トークンで付与する。
     */
    pan: number;
    /**
     * オクターブシフト -2〜+2（octave×372 units = octave オクターブぶん歌唱ピッチを上下する）。既定0。
     * 音源ごとに得意な音域が異なるため、演奏ノート（@n）のピッチをそのまま使わず
     * オクターブ単位でずらして歌わせるための合成専用パラメータ。
     * 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;
    /**
     * このボーカルトラック個別のディレイセンド量 0-100。既定0（マスタディレイの影響を受けない）。
     * マスタディレイのつまみ（テンポ同期した音価・掛かり具合そのもの）とは別軸で、
     * 「このトラックをどれだけディレイバスへ送るか」を個別に決める。
     * MMLでは `@@n klatt e50 …` のように e トークンで付与する。
     */
    delay?: number;
    /**
     * フォルマント/ジェンダーファクター 0-100。既定50（無変化）。
     * ピッチはそのままに声の太さ/細さ（年齢・性別感）だけを動かす。
     * 50未満で低め/太め（大人びる）、50超で高め/細め（若く/明るく）に寄る。
     * MMLでは `@@n klatt g30 …` のように g トークンで付与する。
     */
    gender?: number;
    /**
     * ブレシネス（息成分）0-100。既定50（無変化）。大きいほど息っぽく（ささやき寄り）、
     * 小さいほど芯のある声になる。
     * MMLでは `@@n klatt h70 …` のように h トークンで付与する。
     */
    breathiness?: number;
    /**
     * テンション（張り/力強さ）0-100。既定50（無変化）。大きいほど張った・押した声
     * （こぶし寄り、力強く歌わせる）、小さいほど脱力・リラックス（ブレシネス寄り）になる。
     * MMLでは `@@n klatt t70 …` のように t トークンで付与する。
     */
    tension?: number;
    /**
     * オクターブユニゾン。既定"none"。
     * "down"/"up"/"both" にすると各音節をもう1オクターブ上/下/両方（控えめな音量）で
     * 同時に重ねて発音し、声に厚み（down）や煌びやかさ（up）を足す。
     * MMLでは `@@n klatt w1 …`（0=none,1=down,2=up,3=both）のように w トークンで付与する。
     */
    octaveUnison?: OctaveUnisonMode;
    /** 正規化済み音節列 */
    syllables: LyricSyllable[];
    /**
     * 歌詞が複数行（改行）で書かれていたときの改行位置。
     * 値は「この音節インデックスの直前に改行があった」を表す syllables のインデックス列。
     * 表示UIが改行を `\n` として見せるために使う（発音・同期には一切影響しない）。
     */
    lineBreaks?: number[];
    /**
     * 歌詞行のメタ部分（モデル名＋ v/q/p 等のオプション）の原文。
     * 例: `@@3 teto v200 …` なら "teto v200"。
     * 再生専用UIがメタ部分をグレーアウト表示するために使う（発音・同期には影響しない）。
     */
    metaText?: string;
};
type PlayDrumEvent = {
    pitch: number;
    /** 0-1 */
    velocity: number;
    /** 「今」からの相対秒 */
    when: number;
    /** 秒 */
    duration: number;
};
type ParseMidiFn = (bytes: Uint8Array) => unknown | Promise<unknown>;
/**
 * 1回の play() 呼び出しで使うフェードのスケジュール（絶対 AudioContext 時刻、秒）。
 * いずれも未指定ならそちらのフェードは掛けない（曲頭から再生していない/フェード長0等）。
 */
type FadeScheduleParams = {
    /** フェードイン開始時刻（通常は再生アンカー時刻と同じ）。 */
    fadeInStartAt?: number;
    /** フェードイン完了時刻（この時刻に音量1へ到達）。 */
    fadeInEndAt?: number;
    /** フェードアウト開始時刻（この時刻までは音量1を維持）。 */
    fadeOutStartAt?: number;
    /** フェードアウト完了時刻（この時刻に音量0へ到達、通常は曲の終端）。 */
    fadeOutEndAt?: number;
};
/**
 * 永続化対象の表示・出力設定。利用側がブラウザ再訪時に復元する用途に使う。
 * （ノートやMML本体ではなく、エディタの見え方/出力の挙動の設定）
 */
type DawViewState = {
    /** 横方向ズーム（%） */
    zoomX: number;
    /** 縦方向ズーム（%） */
    zoomY: number;
    /** 和音分解モード（getMMLで和音を単音トラックへ分解する） */
    decomposeChord: boolean;
    /** 和音分解時に和音伴奏トラックを分解対象から除外するフラグ */
    ignoreChordHeavy: boolean;
};
/**
 * DAWの動作モード。
 * - `simple`: 4トラック（メロディー/サブメロ/ベース/伴奏）。MIDIは役割別に自動分類して取り込み、
 *   id `chord` のトラックには歌詞欄の代わりに伴奏（コード進行）UIを出す。
 * - `advanced`: MIDIトラックを1:1でマッピング。全トラックが通常のノートトラックとして振る舞う。
 */
type DawMode = "simple" | "advanced";
type DawOptions = {
    /** メロディックトラックのノート発音要求 */
    onPlayNote?: (e: PlayNoteEvent) => void;
    /** ドラムノート発音要求 */
    onPlayDrum?: (e: PlayDrumEvent) => void;
    /** 初回ユーザー操作時に呼ばれる（AudioContextのresume等に使う） */
    onResumeAudio?: () => void | Promise<void>;
    /**
     * 「MIDI / MML 出力」パネルの「WAV書き出し」ボタン押下時に呼ばれる。
     * 未指定ならボタン自体を表示しない（ライブラリは音を出さないため、書き出し処理は
     * AudioContextを持つ利用側 = createDtmStudio 等が担う）。
     */
    onExportWav?: () => void | Promise<void>;
    /** 再生の基準クロック秒。既定 performance.now()/1000。利用側は audioCtx.currentTime を返す */
    getAudioTime?: () => number;
    /**
     * ドラムパターンが変化したときに呼ばれる（ユーザー操作・MML読み込みによる自動入力の両方）。
     * 利用側が選択状態を永続化する用途に使う。
     */
    onDrumChange?: (name: string) => void;
    /**
     * 楽器プリセットが変化したときに呼ばれる（ユーザー操作・MML読み込みによる自動入力の両方）。
     * 利用側が選択状態を永続化したり、外部音源のロードを行ったりする用途に使う。
     */
    onInstrumentChange?: (name: string) => void;
    /**
     * トラックごとの個別楽器が変化したときに呼ばれる。
     * `trackIndex` は @n の n と同じトラック番号。`instrumentName` は GM楽器名（空文字はデフォルト＝プリセット）。
     */
    onTrackInstrumentChange?: (trackIndex: number, instrumentName: string) => void;
    /**
     * トラック単位のコンプレッサー（音圧強化）量 0-100 が変化したときに呼ばれる。
     * `trackId` は演奏トラックのID（歌詞トラックと同じIDを共有していれば同じ処理が掛かる）。
     * 実際の音声処理は呼び出し側（studio）が担う。
     */
    onTrackCompressionChange?: (trackId: string, amount: number) => void;
    /** トラック単位のステレオ幅 0-200 が変化したときに呼ばれる。 */
    onTrackWidthChange?: (trackId: string, width: number) => void;
    /**
     * トラック単位のマスタリバーブへのセンド量 0-100 が変化したときに呼ばれる。
     * 楽器・歌詞トラックを問わず掛かる（歌詞トラック固有の `vocalReverb`/`r`トークンとは別軸で、
     * 両方が同じマスタリバーブへ加算的に送られる）。既定0（センドしない＝リバーブが掛からない）。
     */
    onTrackReverbSendChange?: (trackId: string, amount: number) => void;
    /**
     * トラック単位のマスタディレイへのセンド量 0-100 が変化したときに呼ばれる。
     * 楽器・歌詞トラックを問わず掛かる（歌詞トラック固有の `vocalDelay`/`d`トークンとは別軸で、
     * 両方が同じマスタディレイへ加算的に送られる）。既定0（センドしない＝ディレイが掛からない）。
     */
    onTrackDelaySendChange?: (trackId: string, amount: number) => void;
    /** トラック単位EQの低域（シェルフ）ゲイン -12〜+12dB が変化したときに呼ばれる。 */
    onTrackEqLowChange?: (trackId: string, db: number) => void;
    /** トラック単位EQの中域（ピーキング）ゲイン -12〜+12dB が変化したときに呼ばれる。 */
    onTrackEqMidChange?: (trackId: string, db: number) => void;
    /** トラック単位EQの高域（シェルフ）ゲイン -12〜+12dB が変化したときに呼ばれる。 */
    onTrackEqHighChange?: (trackId: string, db: number) => void;
    /**
     * トラック単位のステレオ定位（パン）0-127（64=中央、0=左いっぱい、127=右いっぱい）が
     * 変化したときに呼ばれる。歌詞トラック固有の `vocalPan`（歌唱の定位）とは別軸で、
     * 楽器トラック自体の左右配置を決める。
     */
    onTrackPanChange?: (trackId: string, pan: number) => void;
    /**
     * BPMが変化したときに呼ばれる（MML読込・スライダー操作・MIDI取り込み等、経路に依らず単一の窓口）。
     * テンポ同期エフェクト（ディレイ等）が実時間へ再計算するために使う。
     */
    onBpmChange?: (bpm: number) => void;
    /** 曲頭のフェードイン長（秒）。既定0（フェードなし）。範囲0〜10。 */
    fadeInSec?: number;
    /** 曲尾のフェードアウト長（秒）。既定0（フェードなし）。範囲0〜10。 */
    fadeOutSec?: number;
    /**
     * play() のたびに、今回の再生で使うフェードのスケジュール（絶対 AudioContext 時刻）を
     * 通知する。`params` が null ならフェードを解除し音量を1へ戻す（pause/stop時）。
     * 実際のゲイン自動化は呼び出し側（studio）が担う。
     */
    onScheduleFade?: (params: FadeScheduleParams | null) => void;
    /**
     * 表示・出力設定（ズーム / 和音分解モード / 和音伴奏トラック無視）が変化したときに呼ばれる。
     * 利用側が選択状態を永続化する用途に使う。
     */
    onViewStateChange?: (state: DawViewState) => void;
    /**
     * ユーザー操作によってノートが追加・削除されたときに呼ばれる（差分パッチ）。
     * リアルタイム同期のための送信フックとして使う。
     * `applyPatch` による適用時には呼ばれない（エコーループ防止）。
     */
    onNotesPatch?: (trackId: string, added: NoteData[], removed: NoteRemove[]) => void;
    /** 歌詞・UTAUデータが変更されたときに呼ばれる（300msデバウンス済み）。 */
    onLyricsChange?: (trackId: string, data: LyricSyncData) => void;
    /**
     * 編集をロックするトラックIDの配列。
     * 指定されたトラックへのユーザー操作（音符追加・削除）は無視される。
     * 協力DAWで他人のトラックを誤編集しないために使う。
     */
    lockedTracks?: string[];
    /** 初期アクティブトラックID（未指定なら最初のトラック）。協力DAWで自分のトラックを初期選択するために使う。 */
    initialActiveTrack?: string;
    /** 初期スクロールで中央に表示するMIDIピッチ番号（0–127）。未指定なら既定位置。 */
    initialScrollPitch?: number;
    /** マスタ音量 0-100。既定50。 */
    masterVolume?: number;
    /** ドラム音量 0-100。既定80。 */
    drumVolume?: number;
    /**
     * マスタリバーブの掛かり具合 0-100。既定0（オフ）。
     * 全トラック（楽器・歌唱とも）に一律で掛かるマスタエフェクト。
     */
    reverbAmount?: number;
    /** マスタリバーブのつまみが動かされたときに呼ばれる（0-100）。実際の音声処理は呼び出し側（studio）が担う。 */
    onReverbChange?: (amount: number) => void;
    /** マスタリバーブのDecay（残響の長さ、秒）。既定2.2、範囲0.3〜4.0。 */
    reverbDecay?: number;
    /** マスタリバーブのDecayが変化したときに呼ばれる（秒）。 */
    onReverbDecayChange?: (seconds: number) => void;
    /** マスタリバーブのPre Delay（原音から残響が立ち上がるまでの遅延、ms）。既定0、範囲0〜150。 */
    reverbPreDelay?: number;
    /** マスタリバーブのPre Delayが変化したときに呼ばれる（ms）。 */
    onReverbPreDelayChange?: (ms: number) => void;
    /**
     * マスタディレイの掛かり具合 0-100。既定0（オフ）。テンポに同期したエコー。
     * 全トラック共通のバス自体は用意されるが、実際に送る量はボーカルトラック個別の
     * ディレイ送り（`e`トークン）で決める（リバーブと同じ send/return の考え方）。
     */
    delayAmount?: number;
    /** マスタディレイのつまみが動かされたときに呼ばれる（0-100）。 */
    onDelayChange?: (amount: number) => void;
    /** マスタディレイの音価（既定 "8" = 8分音符）。曲のBPMに同期した実秒数へ変換される。 */
    delayDivision?: DelayDivision;
    /** マスタディレイの音価が変更されたときに呼ばれる。 */
    onDelayDivisionChange?: (division: DelayDivision) => void;
    /**
     * マスタバスの「グルーコンプレッサー」量 0-100。既定0（オフ）。
     * 全トラックの合流点（リバーブ・ディレイの戻りも含む）にまとめて軽く掛ける、
     * 表現目的の音楽的な圧縮（常時ONの安全リミッターとは別物）。
     */
    masterCompression?: number;
    /** マスタバスのグルーコンプレッサー量のつまみが動かされたときに呼ばれる（0-100）。 */
    onMasterCompressionChange?: (amount: number) => void;
    parseMidi?: ParseMidiFn;
    /**
     * 動作モード（{@link DawMode}）。
     * 未指定のときは後方互換のため `tracks` の本数から推論する（4本以下→simple / 5本以上→advanced）。
     * 4トラック構成でも1:1取り込みをしたい等、トラック数と意図がずれる場合は明示指定する。
     */
    mode?: DawMode;
    /** トラック構成。既定は melody/submelody/bass/chord の4本 */
    tracks?: TrackConfig[];
    /** ドラムパターン辞書。既定は DRUM_PATTERNS */
    drumPatterns?: Record<string, AnyDrumPattern | DrumPatternDef>;
    /** ドラム音源が変更されたときのコールバック（font:id形式） */
    onDrumFontChange?: (fontId: string) => void;
    /** 初期ドラム音源（font:id形式）。既定は "FluidR3_GM_sf2_file:0" */
    drumFont?: string;
    /** 歌唱合成の先読みや制御を行うヘルパ（.koe音源の再生前プリロードに使用） */
    singingVoices?: SingingVoices;
    /**
     * 伴奏音源（mp3 / wav / YouTube）の同時再生器。
     *
     * ライブラリ自身は音を出さないので、AudioContextを持つ利用側（`createDtmStudio` 等）が
     * `createBackingAudio` で作って渡す。渡さないとオーディオ同時再生のUIごと出ない。
     */
    backingAudio?: BackingAudio;
    /**
     * 編集中の音割れ検知メーター（マスタの安全リミッター手前を監視）。
     * 渡すとDAW UIにクリップ警告バッジを表示できる。studio.mountEditor が自動的に渡す。
     */
    clipMeter?: ClipMeter;
    /**
     * 静的に登録するカスタムボーカル定義の配列。
     * MML 中の `@@key icon_url koe_url` 宣言行と同等だが、コードから直接渡せる。
     * MML 宣言行と両方ある場合は MML 側（後読み）が優先して上書きする。
     */
    customVocals?: CustomVocalDef[];
    defaultBpm?: number;
    initialMML?: string;
    /**
     * ループ再生の初期状態（既定 false）。
     * MML読み込み時に #loop=on があればそちらが優先される。
     */
    initialLoop?: boolean;
    /** ループ再生のON/OFFが変化したときに呼ばれる */
    onLoopChange?: (loop: boolean) => void;
    /**
     * @deprecated 同意画面は既定で出なくなったので、この指定は何もしない（後方互換のため残置）。
     * DAW は元からこの値を読んでいない。聴く人に同意を求めない理由は
     * `MmlPlayerOptions.requireConsent` の説明を参照。
     */
    skipConsent?: boolean;
    /**
     * ツールバーにヘルプ（「?」）ボタンを出すか（既定 true）。
     * 使い方モーダルとガイドツアーの入口で、画面内に散らばる ⓘ 解説への案内も兼ねる。
     */
    showHelp?: boolean;
    /**
     * ガイドツアー（スポットライト型ウォークスルー）の設定。
     *
     * **自動再生は既定でオフ**。埋め込み先の第一印象を勝手に上書きしないための既定値で、
     * 初回に流したいアプリ（デモページ等）だけが `autoStart: true` を渡す。
     * 自動再生を切っていても、ヘルプボタンからはいつでも開始できる。
     */
    tour?: {
        /** 初回訪問時（`storageKey` が未記録のとき）に自動で開始する。既定 false。 */
        autoStart?: boolean;
        /** 既定ステップ（{@link import("./tour").DAW_TOUR_STEPS}）を丸ごと差し替える。 */
        steps?: TourStep[];
        /** 既定ステップの後ろに足すステップ（埋め込み側のUIを案内したいとき）。 */
        extraSteps?: TourStep[];
        /** 「もう見た」フラグの保存キー（既定 `"dtm-tour-seen"`）。`null` で記録しない。 */
        storageKey?: string | null;
        /** 吹き出しの文言の差し替え（日本語以外へ差し替えるとき）。 */
        labels?: Partial<TourLabels>;
    };
    /** MIDI検索クライアントの設定（未指定なら検索UI非表示）。 */
    midiSearch?: MidiSearchConfig;
    /**
     * シンプルモードでトラック数超過コンテンツを読み込もうとしたとき、上級者モードへの切替を
     * 要求するコールバック。`mountModeSwitch` が自動的に接続する。未接続なら確認モーダルは
     * 表示しない。
     * - MML読み込み時: `pendingMml` にMML文字列が渡され、`applyMidi` は undefined。
     * - MIDI読み込み時: `pendingMml` は undefined、`applyMidi` に新DAWへ適用する関数が渡される。
     */
    onRequestAdvancedMode?: (pendingMml?: string, applyMidi?: (daw: DawInstance) => void) => void;
};
type PlaybackState = "stopped" | "playing" | "paused";
type DawInstance = {
    play: () => void;
    pause: () => void;
    stop: () => void;
    getMML: () => {
        full: string;
        minified: string;
    };
    /**
     * MML出力の先頭に埋め込む楽器プリセット名を設定する（トラックとは1対1でないトップレベル宣言）。
     * 空文字で宣言なし。ライブラリ自体は音源を持たないため、名前を運ぶだけ（再生側が解決する）。
     */
    setInstrument: (name: string) => void;
    /** 現在のドラムパターン名を返す（永続化の保存用）。 */
    getDrum: () => string;
    /** 現在のドラムパターンで使用されているキー一覧を返す */
    getUsedDrumKeys: () => number[];
    /** ドラムパターンを設定する（未知のキーは無視）。選択UIにも反映する。 */
    setDrum: (name: string) => void;
    /** 指定したドラムパターンを追加し、利用可能にする */
    addDrumPattern: (name: string, pattern: DrumPatternDef) => void;
    /** 現在のドラム音源（font:id）を返す */
    getDrumFont: () => string;
    /** ドラム音源を設定する（font:id） */
    setDrumFont: (fontId: string) => void;
    /** 現在の表示・出力設定を返す（永続化の保存用）。 */
    getViewState: () => DawViewState;
    /** 表示・出力設定を復元する（指定したキーのみ反映。UIにも反映する）。 */
    setViewState: (state: Partial<DawViewState>) => void;
    loadMML: (mml: string) => void;
    loadMIDI: (bytes: Uint8Array) => void | Promise<void>;
    exportMIDI: () => Blob;
    /** 全トラックをMusicXML（楽譜）テキストのBlobで返す。 */
    exportMusicXML: () => Blob;
    /** 選択中のトラック1本をUST（UTAU）テキストのBlobで返す。 */
    exportUST: () => Blob;
    setBpm: (bpm: number) => void;
    /** 現在のループ再生状態（ON/OFF）を返す */
    getLoop: () => boolean;
    /** ループ再生状態を設定する。UIおよび再生シーケンサへ反映される。 */
    setLoop: (loop: boolean) => void;
    getPlaybackState: () => PlaybackState;
    getCurrentPlayStep: () => number;
    forcePauseAt: (step: number) => void;
    setLoading?: (loading: boolean) => void;
    /**
     * リモートから受信したパッチをローカルに適用する。
     * `onNotesPatch` は発火しない（エコーループ防止）。
     * 音符の識別は (startStep, pitch) ペアで行う（ローカルIDに依存しない）。
     */
    applyPatch: (trackId: string, added: NoteData[], removed: NoteRemove[]) => void;
    /** リモートから受信した歌詞・UTAU設定を適用する。 */
    applyLyrics: (trackId: string, data: LyricSyncData) => void;
    /**
     * このDAWインスタンス自身が持つ「曲自体の音量」（`#volume=`）を 0-100 で変更する。
     * `getMML()`で出力・`loadMML()`で復元される、曲データの一部として永続化される値。
     * `loadMML()` を呼ぶたびにそのMMLの `#volume=` で上書きされるため、リスナー側の
     * 音量の好みを別途乗せたい場合は代わりに `DtmStudio.setMasterVolume`
     * （`studio.masterGain`、曲データと無関係な出力段ゲイン）を使うこと。
     */
    setMasterVolume: (volume: number) => void;
    /** `setMasterVolume` のエイリアス。 */
    setVolume: (volume: number) => void;
    /** ドラム音量を 0-100 で変更する。 */
    setDrumVolume: (volume: number) => void;
    /** マスタリバーブの掛かり具合を 0-100 で変更する。 */
    setReverbAmount: (amount: number) => void;
    /** マスタリバーブのDecay（残響の長さ）を秒で変更する。 */
    setReverbDecay: (seconds: number) => void;
    /** マスタリバーブのPre Delayをmsで変更する。 */
    setReverbPreDelay: (ms: number) => void;
    /** マスタディレイの掛かり具合を 0-100 で変更する。 */
    setDelayAmount: (amount: number) => void;
    /** リモートから受信したトラック個別楽器を適用する（`onTrackInstrumentChange` は発火しない）。 */
    applyTrackInstrument: (trackIndex: number, instrumentName: string) => void;
    /**
     * 指定トラックの音符をキャンバス上で表示・非表示にする（目ミュート）。
     * 非表示にしても内部データは保持される。
     */
    setTrackVisible: (trackId: string, visible: boolean) => void;
    /**
     * 指定トラックの発音を有効・無効にする（音ミュート）。
     * false にすると onPlayNote が呼ばれなくなる。
     */
    setTrackAudible: (trackId: string, audible: boolean) => void;
    /**
     * 指定ノート位置（step, pitchUnits）のキャンバス上のピクセル座標を返す。
     * `pitch` の単位は units（1/372オクターブ）。
     * 画面外の場合は onScreen=false と方角 side を返す。
     * 協力DAWでのカーソル表示に使う。
     */
    noteToCanvas: (step: number, pitch: Units) => {
        x: number;
        y: number;
        onScreen: boolean;
        side: "left" | "right" | "top" | "bottom" | null;
    };
    /** パース済みMIDIオブジェクトと選択トラックインデックスを直接適用する（上級者モード切替後の再ロード用）。 */
    applyMidiParsed?: (midi: unknown, selectedIndices: number[]) => void;
    /**
     * 解析済みUSTを `startIndex` のトラックから順に適用する
     * （上級者モード切替後の再ロード用。省略時は選択中のトラックから）。
     */
    applyUstParsed?: (ustTracks: UstTrackData[], startIndex?: number) => void;
    /** 解析済みMusicXMLの選択パートを適用する（上級者モード切替後の再ロード用）。 */
    applyMusicXmlParsed?: (xml: MusicXmlExtraction, selectedIndices: number[]) => void;
    /**
     * ガイドツアーを開始する（自動再生の設定に関わらず、いつでも呼べる）。
     * ヘルプボタンの「ガイドツアーを見る」と同じ入口。
     */
    startTour: () => void;
    destroy: () => void;
};
type LoopPoint = {
    bar: number;
} | {
    step: number;
} | {
    seconds: number;
};
type LoopConfig = {
    start?: LoopPoint;
    end?: LoopPoint;
};
type PlaybackCue = {
    id: string;
    time: LoopPoint;
};

/**
 * mountDAW — 1関数でマウントできるモバイルファーストDAWコンポーネント（Layer 2）。
 *
 * 発音は注入フック（onPlayNote / onPlayDrum）へ委譲し、ライブラリ自体は音を出さない。
 * MIDI/コード解析も注入（parseMidi / parseChord / parseChords）。未注入なら該当UIを隠す。
 */

/** シンプルモード（4トラック）— 役割別に自動分類してMIDIを読み込む */
declare const TRACKS_SIMPLE: TrackConfig[];
/**
 * 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コンポーネントをマウントする。
 */
declare const mountDAW: (target: HTMLElement, options?: DawOptions) => DawInstance;

/**
 * 全体トラック設定アコーディオン内で選択された設定値の localStorage 永続化
 *
 * 音律、ループ再生、全体音量、グルーコンプ、マスタリバーブ（量・Decay・PreDelay）、
 * マスタディレイ（量・音価）、フェードイン、フェードアウトの各設定を保持し、
 * 次回ロード時に復元できるようにする。
 */
declare const GLOBAL_STORAGE_KEYS: {
    readonly edo: "dtm-global:edo";
    readonly loop: "dtm-global:loop";
    readonly masterVolume: "dtm-global:master-volume";
    readonly masterComp: "dtm-global:master-comp";
    readonly reverbAmount: "dtm-global:reverb-amount";
    readonly reverbDecay: "dtm-global:reverb-decay";
    readonly reverbPreDelay: "dtm-global:reverb-predelay";
    readonly delayAmount: "dtm-global:delay-amount";
    readonly delayDivision: "dtm-global:delay-division";
    readonly fadeIn: "dtm-global:fade-in";
    readonly fadeOut: "dtm-global:fade-out";
};
type GlobalStorageKey = keyof typeof GLOBAL_STORAGE_KEYS;
/**
 * 全体トラック設定の単一項目を localStorage から取得する。
 * 未設定または localStorage にアクセスできない場合は null を返す。
 */
declare const readGlobalSetting: (key: GlobalStorageKey) => string | null;
/**
 * 全体トラック設定の単一項目を localStorage に保存する。
 * localStorage にアクセスできない環境や容量制限等は無視する。
 */
declare const writeGlobalSetting: (key: GlobalStorageKey, value: string) => void;
/**
 * 全体トラック設定の数値項目を localStorage から取得し、クランプして返す。
 * 未設定・パース失敗の場合は null を返す。
 */
declare const readGlobalNumber: (key: GlobalStorageKey, min: number, max: number) => number | null;
/**
 * 全体トラック設定の真偽値項目を localStorage から取得して返す。
 * 未設定・不正値の場合は null を返す。
 */
declare const readGlobalBool: (key: GlobalStorageKey) => boolean | null;

/**
 * playMML — DOM非依存（ヘッドレス）の MML 再生関数。
 *
 * mountMmlPlayer が「絵文字・プレイヘッド付きの再生ビュー」なのに対し、こちらは
 * 画面を一切持たず音だけを鳴らす。ゲームの BGM のように「文字列を渡して鳴らし、
 * 止めたいときに止める」用途を想定している。
 *
 * 設計の要点:
 *   - 発音そのものは Web Audio のオーディオスレッド上で行われる（未来時刻に予約するため
 *     メインスレッドの負荷と独立して鳴る）。スケジューラは createSequencer の先読み方式。
 *   - `loop: true` で曲末停止せずシームレスにループ（BGM用）。
 *   - AudioContext を外から注入でき、出力先ノード（ゲームのマスターGain/ミキサー）へ繋げる。
 *   - タブが非アクティブになったら一時停止する挙動を、ctx の所有権に応じて自動で行う:
 *       内部生成 ctx … 既定で suspend/resume する（自分の ctx なので止めてよい）。
 *       注入 ctx     … 既定では触らない（SE 等と共有している可能性があるため）。
 *                      代わりに返り値の suspend()/resume() を呼び出し側から叩ける。
 *
 * 歌声合成（@@n 歌詞トラック）はこのヘッドレス関数では未対応（楽器・ドラムのみ）。
 * 歌声が必要なら mountMmlPlayer / createDtmStudio を使う。
 */

type PlayMmlOptions = {
    /** ループ設定（true=全体ループ、LoopConfig=特定範囲ループ、false/省略=ループなし） */
    loop?: boolean | LoopConfig;
    /** 再生中にイベントを発火させるタイミング */
    cues?: PlaybackCue[];
    /** キューポイント通過時のコールバック */
    onCue?: (cueId: string) => void;
    /**
     * 使用する AudioContext。省略時は内部生成し、destroy()/stop() で閉じる。
     * onPlayNote で自前シンセを鳴らす場合は、時計をそろえるため自分の ctx を渡すこと。
     */
    audioContext?: AudioContext;
    /** 出力先ノード（省略時は ctx.destination）。ゲームのマスターGain 等へ繋ぐ。 */
    destination?: AudioNode;
    /** 0-100 のマスタ音量。既定は MML の #volume → このオプション → 100 の順で解決。 */
    volume?: number;
    /** BPM未検出時のフォールバック。既定120 */
    defaultBpm?: number;
    /** ドラムパターン辞書。既定は DRUM_PATTERNS */
    drumPatterns?: Record<string, AnyDrumPattern | DrumPatternDef>;
    /** 内蔵 square synth を使うか。既定は onPlayNote 未指定なら true */
    synth?: boolean;
    /** メロディックノートの発音要求（自前シンセに繋ぐ）。 */
    onPlayNote?: (e: PlayNoteEvent) => void;
    /** ドラムノートの発音要求。 */
    onPlayDrum?: (e: PlayDrumEvent) => void;
    /** 再生開始時に呼ばれる（追加の resume 処理等に使う）。 */
    onResumeAudio?: () => void | Promise<void>;
    /**
     * タブ非アクティブ時に自動で suspend/resume するか。
     * 既定は「内部生成 ctx のとき true / 注入 ctx のとき false」。
     * 注入 ctx で true にすると、共有 ctx ごと suspend する点に注意。
     */
    pauseWhenHidden?: boolean;
    /** ループ無効時に曲末（または stop()）で呼ばれる。 */
    onStop?: () => void;
    /** 再生中のステップ更新（1/192小節ごと）時のコールバック */
    onTick?: (step: number) => void;
    /** 再生開始位置（ステップ単位）。指定すると途中から再生する。 */
    startStep?: number;
};
type MmlPlayback = {
    /** 再生を止める（ループ中でも停止）。 */
    stop: () => void;
    isPlaying: () => boolean;
    /** マスタ音量を 0-100 で変更する（再生中も即時反映）。 */
    setVolume: (volume: number) => void;
    /** AudioContext を suspend（注入 ctx の場合、共有先も止まる点に注意）。 */
    suspend: () => Promise<void>;
    /** suspend からの復帰。 */
    resume: () => Promise<void>;
    /** 停止し、内部生成 ctx なら閉じてリスナも解除する。 */
    destroy: () => void;
};
type PlayPlacementsOptions = PlayMmlOptions & {
    bpm: number;
    metaVolume?: number;
    metaDrum?: string;
    metaDrumVolume?: number;
    /** マスタリバーブの掛かり具合 0-100（エディタの `#reverb=` 相当）。省略時0。 */
    metaReverb?: number;
    /** マスタリバーブのDecayを10倍した整数（3〜40 → 0.3〜4.0秒）。省略時22。 */
    metaReverbDecay?: number;
    /** マスタリバーブのPre Delay（ms）。省略時0。 */
    metaReverbPreDelay?: number;
    /** 曲頭のフェードイン長を10倍した整数（`#fadein=`）。省略時0（フェードなし）。 */
    metaFadeIn?: number;
    /** 曲尾のフェードアウト長を10倍した整数（`#fadeout=`）。省略時0（フェードなし）。 */
    metaFadeOut?: number;
    /** トラック（trackIndex）ごとのコンプレッサー量 0-100。 */
    trackCompression?: Record<number, number>;
    /** トラック（trackIndex）ごとのステレオ幅 0-200。 */
    trackWidth?: Record<number, number>;
    /** トラック（trackIndex）ごとのマスタリバーブへのセンド量 0-100。 */
    trackReverbSend?: Record<number, number>;
    /** トラック（trackIndex）ごとのEQ低域ゲイン -12〜+12dB。 */
    trackEqLow?: Record<number, number>;
    /** トラック（trackIndex）ごとのEQ中域ゲイン -12〜+12dB。 */
    trackEqMid?: Record<number, number>;
    /** トラック（trackIndex）ごとのEQ高域ゲイン -12〜+12dB。 */
    trackEqHigh?: Record<number, number>;
};
/**
 * パース済みの配置データ（placements）を画面なしで再生する。
 */
declare const playPlacements: (placements: Array<{
    trackIndex: number;
    startStep: number;
    durationSteps: number;
    /** ピッチ。単位は units（1/372オクターブ）。 */
    pitchUnits: Units;
    velocity: number;
}>, options: PlayPlacementsOptions) => MmlPlayback;
/**
 * MML 文字列を画面なしで再生する。呼び出した時点で再生を開始する。
 * ブラウザの自動再生ポリシー上、初回はユーザー操作のコールスタック内で呼ぶこと。
 */
declare const playMML: (mml: string, options?: PlayMmlOptions) => MmlPlayback;
type PlayNoteOptions = {
    audioContext?: AudioContext;
    destination?: AudioNode;
    pitchUnits: Units;
    volume?: number;
    duration?: number;
};
/**
 * 簡易な単音（軽量シンセ）を再生する。
 */
declare const playNote: (options: PlayNoteOptions) => void;
type PlayChordsOptions = PlayMmlOptions & {
    patternType?: ChordPatternType;
    rootShift?: number;
    bpm?: number;
};
/**
 * コード進行（軽量シンセ）を再生する。
 */
declare const playChords: (chordStr: string, options?: PlayChordsOptions) => MmlPlayback;

/**
 * playSingingMML — 歌声付き（@@n 歌詞トラック）のヘッドレス MML 再生。
 *
 * 楽器・ドラムのみの {@link playMML} とは別関数として切り出す。歌声は重い WORLD 再合成・
 * worker のホスティング・非同期プリロードを伴うため、軽量な playMML に混ぜず分離する方針。
 * 中身は実質「mountMmlPlayer の音響経路（sequencer + 内蔵synth + 歌声ストリーム配線）から
 * DOM を抜いたもの」。
 */

type PlaySingingMmlOptions = PlayMmlOptions & {
    /**
     * 歌声合成 Worker（`voice-worker.js`）のURL。利用側がホストして渡す。
     * 省略時はメインスレッド合成へフォールバック（BGM用途では worker 推奨）。
     */
    voiceWorkerUrl?: string;
    /**
     * 語り（歌詞の `「…」`）用の TTS アセットのベース URL。省略時は koe のデモと同じ
     * GitHub Pages のホスト。`singingVoices` を注入した場合は無視される。
     */
    ttsBaseUrl?: string;
    /**
     * 既存の歌唱合成ヘルパを注入する（createDtmStudio と同様の配線を流用したい場合）。
     * 指定時は voiceWorkerUrl より優先し、内部で createSingingVoices しない。
     */
    singingVoices?: SingingVoices;
};
/**
 * 歌声付き MML を画面なしで再生する。
 *
 * @param mml MML文字列
 * @param options 再生オプション
 * @returns MmlPlayback コントロールオブジェクトを含む Promise
 */
declare const playSingingMML: (mml: string, options?: PlaySingingMmlOptions) => Promise<MmlPlayback>;

/**
 * インラインSVGアイコン。外部アイコンフォント(MDI等)への依存を避けるため、
 * 必要最小限のパスをライブラリ内に同梱する。
 */
type IconDef = {
    d: string;
    stroke?: boolean;
};
declare const ICONS: Record<string, IconDef>;
/**
 * アイコン名からSVG文字列を生成する。
 */
declare const icon: (name: keyof typeof ICONS | string, size?: number) => string;

/**
 * 楽器プリセット定義
 * FluidR3_GM Instrument Presets
 *
 * 独自の価値観に基づくソート基準:
 * 1. 汎用性 (Standard): どんな曲にも合う基本セット
 * 2. 時代感 (Vibe): シンセやレトロなど特定の空気感
 * 3. 世界観 (World): 特定の地域やファンタジー
 * 4. 感情 (Atmosphere): アンビエントやシネマティック
 */
type InstrumentPreset = {
    displayName: string;
    description: string;
    melody: string;
    submelody: string;
    bass: string;
    chord: string;
    /**
     * 間奏のソロを弾く楽器。**歌が休んでいる場所を担当する**ので、`melody` と
     * 同じでも構わない（ロックの間奏がボーカルと同じ歪みギターなのは正しい）。
     * 逆に、ここを持たせないと間奏が「伴奏だけの空白」になる。
     */
    solo: string;
    /**
     * サビでだけ重ねる楽器。主旋律のオクターブ上に薄く足して、サビの手前と
     * 音色そのものを変える。1トラック1楽器という制約の下で
     * 「セクションで楽器が変わる」を作る唯一の方法が、**セクションごとに
     * 別トラックへ書き分けること**。
     */
    chorusLead: string;
    /**
     * 伴奏の2色目。**同じ進行を別の奏法で鳴らす層を、別の音色にするため**にある。
     *
     * 上級者モードは伴奏を複数本に書き分けていて、奏法（`ChordPatternType`）は実際に別のリズムに
     * なっている。ここが `chord` の使い回しだと、せっかく書き分けた層が同じ音色で重なって団子に
     * なる。`chord` と喧嘩しない、かつ他のスロットと被らないものを選ぶこと。
     */
    chordAlt: string;
    /**
     * ウワモノ（装飾）の楽器。高い位置で薄く鳴らす、きらびやかな音。
     * `chord` と喧嘩しない、他のスロットと被らないものを選ぶこと。
     */
    sparkle: string;
    /**
     * ベースの2色目。**セクションでベースの音色を替える**ために使う。
     * t4 が静かな側、t5 が盛り上がる側を持ち、**同じ音を二度鳴らさずに**
     * 境目で音色だけが入れ替わる。`bass` と喧嘩しない同族を選ぶこと。
     */
    bassAlt: string;
    /**
     * ハモリの2色目。同じくセクションで音色を替えるため（t2 が静かな側、
     * t12 が盛り上がる側）。ハモリは声部なので、声もの・柔らかい持続音が合う。
     */
    harmonyAlt: string;
};
declare const INSTRUMENT_PRESETS: Record<string, InstrumentPreset>;
/**
 * 実物の楽器の音域（実音・MIDIノート番号、C4=60）。
 *
 * **音を作るためではなく、置き場所を決めるために要る。** 1トラック1楽器という制約の下で
 * セクションごとに音色を変えるには、同じ旋律を別のトラックへオクターブを変えて置くことに
 * なるが、そのオクターブを楽器の都合と無関係に決めると**その楽器が出せない高さ**へ行く。
 * サンプルが引き伸ばされて金切り音になり、聴き手には「耳が痛い」としか感じられない。
 *
 * 実測すると、サビの重ねを1オクターブ上げる指定は、ミュートトランペット・トランペットで
 * 14半音、ブラス・合唱・Lead 7 で12半音ぶん音域を突き抜けていた。コードパッド（実音
 * 77〜93）も、伴奏用の楽器をそのまま使うためナイロンギターで10半音・カリンバで9半音
 * はみ出していた。
 *
 * ソフトシンセは実物が無いので、一般的な音源の使用域を入れてある。
 * **この表は判断であって実測ではない**——音源を差し替えたら見直すこと。
 * 未登録の楽器は制限なしとして扱う（{@link fitInstrumentOctave}）。
 */
declare const GM_INSTRUMENT_RANGE: Record<string, [number, number]>;
/**
 * 明るい音色を持続的に鳴らしてよい高さの上限（実音・MIDIノート番号）。
 *
 * **「耳が痛い」は音域の話ではなく、絶対的な高さの話。** 金属体・ベル系の音色は
 * 倍音が 2〜4kHz に集まり、そこは人の耳がいちばん敏感な帯域なので、実物の音域に
 * 収まっていても高いところで鳴らし続けると刺さる。グロッケンは実物の音域が
 * G5(79)〜C8 なので、{@link GM_INSTRUMENT_RANGE} だけで見ると旋律の音域（〜C6）は
 * 「余裕で範囲内」と判定されてしまう。実際には C6 のグロッケンは金切り音になる。
 *
 * ここに載せた楽器は、この高さより上で鳴らないところまでオクターブを下げる
 * （{@link fitInstrumentOctave}）。**楽器を候補から外すのではなく、置き場所を変える**
 * ——トラックのオクターブ設定（{@link TrackState.trackOctave} 相当）は、まさに
 * こういう「得意な音域が偏った音源」を使えるようにするために在る。
 * 低く鳴らしたグロッケンやオルゴールは、ポップスで普通に使われる柔らかい音になる。
 */
declare const GM_BRIGHT_CEILING: Record<string, number>;
/**
 * その楽器で無理なく鳴る位置まで、トラックのオクターブを下げる。
 *
 * **音色を選び直すのではなく、置き場所を変える。** 得意な音域が偏った音源
 * （グロッケンのような高音楽器）を使えるようにするのがオクターブ設定の役目なので、
 * 「その楽器では痛いから候補から外す」は筋が悪い。外すと音色の幅がそのぶん減る。
 *
 * **下げる方向にしか動かさない。** 上げる側は「耳が痛い」を作る方向で、直したい当のもの。
 * 低いほうへはみ出すのは（サンプルは伸びるが）柔らかく鳴るだけなので放っておく。
 *
 * @param semitoneRange そのトラックが実際に鳴らす音域 `[最低, 最高]`（オクターブ補正前）
 * @param instrument GM楽器名。{@link GM_INSTRUMENT_RANGE} に無ければ何もしない
 * @param wanted 編曲が指定したオクターブ
 * @returns 実際に設定するオクターブ（`wanted` 以下）
 */
declare const fitInstrumentOctave: (semitoneRange: [number, number] | null, instrument: string, wanted: number) => number;

/**
 * 操作履歴を管理するための双方向連結リスト
 */
declare class LinkedList<T> {
    #private;
    constructor();
    /**
     * 履歴を1つ追加
     */
    add(value: T): void;
    /**
     * 履歴を1つ戻す
     */
    undo(): T | null;
    /**
     * 履歴を1つ進める
     */
    redo(): T | null;
    /**
     * Undo可能かチェック（カーソル移動なし）
     */
    canUndo(): boolean;
    /**
     * Redo可能かチェック（カーソル移動なし）
     */
    canRedo(): boolean;
}

/**
 * 自動作曲・一括編集アコーディオン内で選択された設定値の localStorage 永続化
 *
 * 構成プリセット、作る部分（セクション）、ベース調、音階（自動作曲パネル）と、
 * 全体シフト、移調（一括編集パネル）の選択状態を保持し、次回ロード時に復元できる
 * ようにする。キーの `dtm-macro:` 接頭辞は、両パネルが1枚だった頃の名残。
 */
declare const MACRO_STORAGE_KEYS: {
    readonly template: "dtm-macro:template";
    readonly sections: "dtm-macro:sections";
    readonly key: "dtm-macro:key";
    readonly scale: "dtm-macro:scale";
    readonly shift: "dtm-macro:shift";
    readonly shiftActiveOnly: "dtm-macro:shift-active-only";
    readonly transpose: "dtm-macro:transpose";
};
type MacroStorageKey = keyof typeof MACRO_STORAGE_KEYS;
/**
 * 単一項目を localStorage から取得する。
 * 未設定または localStorage にアクセスできない場合は null を返す。
 */
declare const readMacroSetting: (key: MacroStorageKey) => string | null;
/**
 * 単一項目を localStorage に保存する。
 * localStorage にアクセスできない環境や容量制限等は無視する。
 */
declare const writeMacroSetting: (key: MacroStorageKey, value: string) => void;
/**
 * 作る部分（セクション選択）の配列を localStorage から取得・検証して返す。
 * 未設定・パース失敗・配列でない場合は null を返す。
 */
declare const readMacroSections: () => string[] | null;
/**
 * 作る部分（セクション選択）の配列を JSON 文字列として localStorage に保存する。
 */
declare const writeMacroSections: (sections: string[]) => void;
/**
 * 自動作曲の「キープ」に取っておいた曲。
 *
 * 中身は `generateMML` が出す MML そのもの（トラック・楽器・ドラム・テンポ・歌詞・
 * エフェクトまで全部入り）と、キープした時点の再生開始位置。再生位置も一緒に
 * 持つのは、キープした曲を呼び出したときに**同じ場所（サビの頭）から**聴き比べたい
 * ため——MML には曲の設計図（どこがサビか）が残らないので、位置だけ別に控える。
 */
type KeptSong = {
    mml: string;
    /** キープした時点の再生開始位置（ステップ）。 */
    startStep: number;
};
/**
 * キープ枠を localStorage から読む。無い・壊れている・読めない場合は null。
 *
 * **リロードをまたいで残す**のは、スマホでは「別アプリを見て戻ったらタブが
 * 再読み込みされていた」が日常的に起きるため。メモリだけに持つと、取っておいた
 * つもりの曲がそこで消える。
 */
declare const readKeptSong: () => KeptSong | null;
/**
 * キープ枠を localStorage へ書く。null で枠を空にする。
 * 容量超過や private モードなど、書けない環境では黙って諦める
 * （その場合もメモリ上の枠は生きているので、リロードまでは使える）。
 */
declare const writeKeptSong: (kept: KeptSong | null) => void;

declare const PITCH_MAP: string[];
/**
 * 31平均律の綴り表（度数0〜30）。
 *
 * 五度連鎖の伝統的綴りを基本にしつつ、重複臨時記号（`##`／`--`）を要する度数だけ
 * 微分音記号（`+`／`_`）の短縮形を採る。結果として全31度が2文字以内に収まる。
 * どの綴りもオクターブを跨がないものを選んであるので、`o<n>` の直後に置ける
 * （たとえば29度は `c-` ではなく `b+`。`c-` はCの2度下＝前オクターブになってしまう）。
 */
declare const EDO31_NAMES: string[];
/**
 * ノートデータ管理とMML生成の責務を持つDOM非依存のコアロジック
 */
declare class MMLCore {
    private notes;
    private nextNoteId;
    private handlers;
    private volume;
    private tempo;
    private history;
    private isUndoRedo;
    isBatchOperation: boolean;
    private lastHistorySnapshot;
    private lastUndoTime;
    private static readonly UNDO_DEBOUNCE_MS;
    private toolMode;
    /** グリッド寸法の供給元（描画器ではなく呼び出し側が持つ設定を読む） */
    private getConfig;
    constructor(handlers: CoreEventHandlers, volume: number | undefined, getConfig: () => RenderConfig);
    beginBatch(): void;
    endBatch(): void;
    saveHistory(): void;
    private restoreHistory;
    undo(): boolean;
    redo(): boolean;
    canUndo(): boolean;
    canRedo(): boolean;
    setToolMode(mode: "pen" | "select" | "eraser"): void;
    getToolMode(): "pen" | "select" | "eraser";
    resetHistory(): void;
    addHistoryOnce(): void;
    clearNotesWithoutHistory(): void;
    setLoadMode(mode: boolean): void;
    /**
     * 指定されたグリッド位置にノートを追加する操作
     * @param step ステップ位置
     * @param pitch ピッチ番号
     * @param options ノート長などの設定
     */
    addNote(step: number, pitch: Units, options: AddNoteOptions): void;
    deleteNoteById(noteId: number): void;
    private getMaxStep;
    moveNote(noteId: number, startStep: number, pitch: Units): void;
    moveNoteEnd(_: number): void;
    resizeNote(noteId: number, durationSteps: number): void;
    resizeNoteEnd(_: number): void;
    /**
     * 全ノートをまとめて時間方向へずらす（マクロの「シフト」用）。
     *
     * {@link moveNote} は「いまの曲の長さ＋1小節」でクランプするが、こちらはしない。
     * 曲の頭に無音を作る操作＝曲を伸ばす操作なので、いまの長さで頭打ちにすると
     * 大きくずらしたときにノートが末尾へ団子になってしまう。
     * 0より前へはみ出したノートは捨てる（従来のシフトと同じ）。
     */
    shiftAllNotes(steps: number): void;
    getNotes(): Note[];
    getMML(volumeOverride?: number): string;
    setVolume(volume: number): void;
    setTempo(tempo: number): void;
    private generateAndNotify;
    /**
     * 近似値を許容して単一音符を決定する。
     * ただし、残りステップ(limit)は絶対に超えない。
     */
    private stepsToMMLDuration;
    /**
     * ギャップに収まる最大の音符を探す（減算アルゴリズム用）
     */
    private findBestFitDuration;
    /** ピッチ(units) → その音律での「オクターブ番号」と「音名」。 */
    private spell;
    /**
     * ピッチからオクターブ最適化のある音名を取得
     */
    private getNoteWithOctave;
    /**
     * MML生成（単一パス・発音順スキャン）。
     *
     * 全ノートを発音順に一度で処理し、次の発音までの距離だけを上限として各音符の長さを忠実に
     * 出力する（次の音符がなければ曲末まで伸ばせる）。小節ウィンドウで走査すると、境界をまたぐ
     * 音符が切り詰められて「ぶつ切り」になり、歌詞（@@n）の音節割り当てもずれる。
     */
    private generateMML;
    /**
     * ノート配列を直接渡してMMLを生成する（一時的に内部状態を差し替えて生成後に復元）
     */
    getMMLFromNotes(notes: Note[], tempo?: number, volume?: number): string;
    /**
     * MMLの音長文字列（"4", "4.", "12"など）をステップ数に変換する
     */
    private getStepFromDottedMML;
}
/**
 * 和音を含むノート配列を、各トラックが単音（モノフォニック）になるよう
 * 最小トラック数に分解する（区間スケジューリング・グリーディ法）。
 * 最小トラック数 = 任意の瞬間の最大同時発音数。
 */
declare const decomposeToMonophonic: (notes: Note[]) => Note[][];
/**
 * ノート配列が「和音伴奏トラック」かどうかを判定する。
 * 和音 = 同一 startStep に3音以上同時発音しているもの。
 * そのような和音構成ノートの割合が threshold 以上であれば true。
 * @param threshold 0〜1。デフォルト 0.6（60%以上が和音ノートならば伴奏トラック）
 */
declare const isChordHeavyTrack: (notes: Note[], threshold?: number) => boolean;

declare const generateRandomPattern: (core: MMLCore, options: {
    stepsPerBar: number;
    startStep: number;
    pitchRangeStart: number;
    /** 曲の音律。省略時は12平均律。 */
    edo?: number;
}) => void;
/**
 * 半小節ごとに伴奏トラックの構成音(pitch class)に合致しない音を削除する。
 */
declare const applyHarmonicFilter: (targetCore: MMLCore, chordCore: MMLCore, options: {
    stepsPerBar: number;
}) => void;
/**
 * 伴奏フィルタに加え、同タイミングの重なりを最高音優先で単音化する。
 */
declare const applyMonophonic: (targetCore: MMLCore, chordCore: MMLCore, options: {
    stepsPerBar: number;
}) => void;
/**
 * 全トラックのノートを一括でステップシフトする（負方向で範囲外は削除）。
 */
declare const shiftNotes: (cores: MMLCore[], shiftSteps: number) => void;
/**
 * 全トラックのノートを一括で移調する。歌唱ピッチもノート由来なので、歌詞トラックの
 * 歌声も一緒に移調される。音域（{@link PITCH_RANGE_START}〜{@link PITCH_RANGE_END}）を
 * 超える場合はクランプする（音域外に飛んで無音・破綻するのを防ぐ）。
 *
 * 単位は「半音」ではなく**格子1ステップ**。12平均律では1ステップ＝1半音だが、
 * 31平均律では1ステップ＝1度（≒38.7セント）になる。31平均律で「半音」は
 * クロマチック半音（2度）とダイアトニック半音（3度）に分岐して一意に定まらないため、
 * 画面の「移調」操作と同じ格子基準に揃えてある。
 */
declare const transposeNotes: (cores: MMLCore[], steps: number) => void;

type MidiTrackAnalysis = {
    index: number;
    name: string;
    noteCount: number;
    selected: boolean;
};
type MidiNotePlacement = {
    /** melody/submelody/bass/chord */
    trackId: string;
    startStep: number;
    pitch: number;
    durationSteps: number;
    velocity: number;
};
type MidiExtraction = {
    placements: MidiNotePlacement[];
    bpm: number;
};
/**
 * MIDIの各トラックを走査し、ノート数などの概要を返す（トラック選択UI用）。
 * ノート数はピアノロールで編集可能なノートのみを数える（ドラム ch10 は除外）。
 * ドラム(ch10)だけで構成されたトラックは編集できないため、結果に含めない。
 */
declare const analyzeMidiTracks: (midi: unknown) => MidiTrackAnalysis[];
/** MIDIメタイベントからBPMを取得（無ければ120）。 */
declare const getMidiBPM: (midi: unknown) => number;
/**
 * 選択トラックからノートを抽出し、チャンネル特性に基づいて
 * melody/submelody/bass/chord へ自動分類した配置を返す。
 */
declare const extractMidiPlacements: (midi: unknown, selectedTrackIndices: number[]) => MidiExtraction;
/**
 * AI採譜（audio→MIDI）にありがちな「めちゃくちゃな採譜」を弾くための簡易品質判定。
 * 人力採譜では起こりにくい特徴を検出する:
 *   - 極端に短い音符（グレースノート未満）が大半を占める → onset誤検出の乱打
 *   - 同一startStepに多数の音（半音混じりの塊）が積み重なる → ノイズをそのまま音高化した塊
 * どちらかが閾値を超えたら「人力採譜ではなさそう」と判定する。
 */
declare const isPlausibleMidiTranscription: (midi: unknown, selectedIndices: number[]) => boolean;
/**
 * advancedモード用：選択された MIDI トラックを選択順に DAW トラックへ上から詰める
 * （k番目に選んだトラック → trackIds[k]）。自動分類なし。
 *
 * MIDIの実トラック番号ではなく「選択順の位置」で割り当てるため、先頭のテンポ/コンダクタ
 * トラックや、空・ドラムだけのトラックが混ざっていても DAW レーンがずれない
 * （これらは選択リストに出ない／選ばれないので位置を消費しない）。
 * ドラム(ch10 = channel 9)のノートはスキップする。
 */
declare const extractMidiPlacementsByTrack: (midi: unknown, selectedIndices: number[], trackIds: string[]) => MidiExtraction;
type ExportMidiTrack = {
    notes: Note[];
    volume: number;
    program?: number;
};
type ExportMidiOptions = {
    tracks: ExportMidiTrack[];
    getDrumPattern?: (currentBar: number) => DrumPattern | null;
    drumVolume?: number;
    bpm: number;
    stepsPerBar: number;
};
/**
 * トラック群とドラムパターンから .mid バイナリ(Blob)を生成する。
 */
declare const exportMIDI: (options: ExportMidiOptions) => Blob;
/**
 * MIDIからドラムトラック(Ch.10)を抽出し、動的計画法(DP)を用いて
 * 最もコンパクトな SongDrumInstruction[] のJSON文字列を生成する。
 */
declare const extractDrumPatternFromNotes: (rawNotes: {
    step: number;
    pitch: number;
    velocity: number;
}[], drumFont?: string) => {
    json: string;
    patternDef: DrumPatternDef;
};
/**
 * 抽出済みドラム定義（SongDrumInstruction[]）と音源を
 * `extracted_song: { label, font, pattern }` 形式の文字列に組み立てる。
 * コピー＆ペーストできるよう JSON 生成ロジックを分離したもの。
 */
declare const buildDrumPatternJson: (instructions: SongDrumPattern, drumFont: string) => string;
/**
 * MIDIからドラムトラック(Ch.10)を抽出し、動的計画法(DP)を用いて
 * 最もコンパクトな SongDrumInstruction[] のJSON文字列を生成する。
 */
declare const extractMidiDrumPattern: (midi: unknown, drumFont?: string) => {
    json: string;
    patternDef: DrumPatternDef;
};

/**
 * MML文字列を解析し、トラックごとのノート配置へ復元するローダ。
 *
 * 旧来 demo/index.html の `loadMML` をライブラリへ移植・整理したもの。
 * 実際のノート追加（MMLCore への反映）は呼び出し側で行う。
 *
 * 歌詞専用行（@@n model lyrics）は演奏ノートではないため常に取り除く。
 * `collectLyrics` 指定時は解析済みの歌詞トラック辞書も併せて返す。
 */

/**
 * 曲全体に効くトップレベル宣言（トラックとは1対1ではない）。
 * MMLの先頭などに `#inst=<プリセット> #drum=<パターン> #volume=<全体音量>` の形で埋め込む。
 * 他のMMLプレイヤーには無害（解析時に除去される）。
 */
type MmlMeta = {
    /**
     * 書き出したライブラリのバージョン（`#ver=`）。
     *
     * 自動作曲の素材は外部コーパスから作るので、**どのバージョンまでが
     * どの素材で作られたか**を後から辿れる必要がある（権利の申告が誤っていた
     * 場合の是正範囲を言うため）。台帳は `docs/dataset-provenance.md`。
     *
     * 読み込み側は使わない——**記録のためだけ**に持つ。
     */
    version?: string;
    /** 楽器プリセット名（INSTRUMENT_PRESETS のキー等。利用側が音源解決に使う） */
    instrument?: string;
    /** ドラムパターン名（DRUM_PATTERNS のキー） */
    drum?: string;
    /** ドラムフォント名 */
    drumFont?: string;
    /** 全体音量（0-100等） */
    volume?: number;
    /** ドラム音量（0-100等） */
    drumVolume?: number;
    /** マスタリバーブの掛かり具合 0-100（全トラック共通、`#reverb=` で埋め込む） */
    reverb?: number;
    /**
     * マスタリバーブのDecay（残響の長さ）を10倍した整数（0.3〜4.0秒 → 3〜40）。
     * `#reverbdecay=` で埋め込む。省略時は22（2.2秒）。
     */
    reverbDecay?: number;
    /** マスタリバーブのPre Delay（ms、0〜150）。`#reverbpredelay=` で埋め込む。省略時は0。 */
    reverbPreDelay?: number;
    /** マスタディレイの掛かり具合 0-100（全トラック共通、`#delay=` で埋め込む） */
    delay?: number;
    /** マスタディレイの音価（"4"|"8"|"8d"|"16"）。`#delaydiv=` で埋め込む。省略時は"8"。 */
    delayDivision?: string;
    /**
     * マスタバスのグルーコンプレッサー量 0-100（全トラック共通、`#mastercomp=` で埋め込む）。
     * 省略時は0（オフ）。
     */
    masterCompression?: number;
    /**
     * 曲頭のフェードイン長を10倍した整数（秒 → 0〜100）。`#fadein=` で埋め込む。省略時は0。
     */
    fadeIn?: number;
    /**
     * 曲尾のフェードアウト長を10倍した整数（秒 → 0〜100）。`#fadeout=` で埋め込む。省略時は0。
     */
    fadeOut?: number;
    /** DAWの動作モード（simple | advanced） */
    mode?: "simple" | "advanced";
    /**
     * 曲全体の音律（1オクターブの分割数）。`#edo=31` で埋め込む。省略時は12（12平均律）。
     * 12と31のみ対応。音律は曲単位で、トラックや小節では変えられない。
     */
    edo?: number;
    /**
     * トラックごとの個別楽器名（GM楽器名）。`#t<n>inst=<名前>` で埋め込む。
     * 省略されたトラックはプリセットが適用される。
     */
    trackInstruments?: Record<number, string>;
    /**
     * トラックごとのコンプレッサー（音圧強化）量 0-100。`#t<n>comp=<値>` で埋め込む。
     * 省略されたトラックは0（実質無圧縮）。ボーカル・楽器どちらのトラックにも掛かる
     * チャンネルストリップ共通のパラメータ（歌詞トラック固有の `r`/`g`/`h` とは別軸）。
     */
    trackCompression?: Record<number, number>;
    /**
     * トラックごとのステレオ幅 0-200。`#t<n>width=<値>` で埋め込む。省略時は100（原音のまま）。
     */
    trackWidth?: Record<number, number>;
    /**
     * トラックごとのマスタリバーブへのセンド量 0-100。`#t<n>rev=<値>` で埋め込む。
     * 省略時は0（センドしない＝掛からない）。楽器・歌詞トラックどちらにも掛かる
     * チャンネルストリップ共通のパラメータ（歌詞トラック固有の `vocalReverb`/`r`トークンとは別軸）。
     */
    trackReverbSend?: Record<number, number>;
    /** トラックごとのEQ低域ゲイン -12〜+12dB。`#t<n>eqlo=<値>` で埋め込む。省略時は0（無変化）。 */
    trackEqLow?: Record<number, number>;
    /** トラックごとのEQ中域ゲイン -12〜+12dB。`#t<n>eqmid=<値>` で埋め込む。省略時は0（無変化）。 */
    trackEqMid?: Record<number, number>;
    /** トラックごとのEQ高域ゲイン -12〜+12dB。`#t<n>eqhi=<値>` で埋め込む。省略時は0（無変化）。 */
    trackEqHigh?: Record<number, number>;
    /**
     * トラックごとのステレオ定位 0-127（64=中央）。`#t<n>pan=<値>` で埋め込む。省略時は64（中央）。
     * 歌詞トラック固有の `p`（歌唱の定位）とは別軸で、楽器トラック自体の左右配置を決める。
     */
    trackPan?: Record<number, number>;
    /**
     * トラックごとのマスタディレイへのセンド量 0-100。`#t<n>dly=<値>` で埋め込む。
     * 省略時は0（センドしない＝掛からない）。楽器・歌詞トラックどちらにも掛かる
     * チャンネルストリップ共通のパラメータ（歌詞トラック固有の `vocalDelay`/`d`トークンとは別軸）。
     */
    trackDelaySend?: Record<number, number>;
    /**
     * ループ再生の指定（#loop=on / off）。BGM等で曲末停止せずシームレスにループさせる。
     * 省略時はオフ。
     */
    loop?: boolean;
    /**
     * 自動作曲の乱数種（`#seed=`）。同じ種・同じ設定（{@link MmlMeta.compose}）で
     * `composeSong` を呼ぶと**同じ曲が出る**。読み込み側は使わない——気に入った曲が
     * 貼られたとき、どの抽選から出たかを後から再現・分析するための記録。
     */
    seed?: number;
    /**
     * 自動作曲の設定（`#compose=`）。`テンプレート:調:音階:セクション` を `:` 区切りで
     * 持つ（セクションは `-` 区切り）。{@link MmlMeta.seed} と組で曲を再現する。
     */
    compose?: string;
    /**
     * 同時再生する伴奏音源のURL（mp3 / wav / YouTube）。`#audio=` で埋め込む。
     *
     * URLだけを持ち、**アップロードされたファイルは持たない**（受け取った相手が
     * 再生できないMMLになるため、ファイル読み込み時は音源関連の宣言ごと出力しない）。
     */
    audio?: string;
    /** 伴奏音源のどこから鳴らすか（秒）。`#audiostart=` で埋め込む。省略時は0（頭から）。 */
    audioStart?: number;
    /** 伴奏音源のどこで止めるか（秒）。`#audioend=` で埋め込む。省略時は最後まで。 */
    audioEnd?: number;
    /**
     * 伴奏音源と打ち込みの**開始のずれ**（秒）。`#audiooffset=` で埋め込む。省略時は0（同時）。
     *
     * 正なら音源が先に始まり、その秒数だけ経ってから打ち込みが始まる。
     * 負ならその逆（打ち込みが先で、音源が後から入る）。
     */
    audioOffset?: number;
    /**
     * 伴奏音源を貼り付ける曲側の位置（ステップ。1小節=192）。`#audioat=` で埋め込む**旧形式**。
     * {@link audioOffset} に置き換わったが、既存のMMLを読めるよう解析だけ残してある
     * （利用側でテンポを使って `audioOffset` へ読み替える）。
     */
    audioAt?: number;
    /** 伴奏音源の音量 0-100。`#audiovol=` で埋め込む。省略時は80。 */
    audioVolume?: number;
};
/** MMLからトップレベル宣言を抽出する */
declare const parseMmlMeta: (mml: string) => MmlMeta;
/** MMLからトップレベル宣言を取り除く（ノート解析が誤解釈しないように） */
declare const stripMmlMeta: (mml: string) => string;
/** メタ情報を `#inst=… #drum=… #volume=… #mode=…` のMML宣言文字列へ直列化する（空なら空文字） */
declare const formatMmlMeta: (meta: MmlMeta, space?: string) => string;
type MMLNotePlacement = {
    /** 0:melody 1:submelody 2:bass 3:chord */
    trackIndex: number;
    startStep: number;
    /** 1/372オクターブ単位（{@link Note.pitchUnits} と同じ）。 */
    pitchUnits: Units;
    durationSteps: number;
    /** v コマンドで指定されたベロシティ（0-127、既定100） */
    velocity: number;
};
/** 再生ビュー用の表示トークン（mountMmlPlayer のノート列ハイライトに使う） */
type MMLDisplayToken = {
    /** 正規化済みのトークン文字列（小文字・空白除去） */
    text: string;
    /** 発音開始ステップ。制御トークン（o/l/</>）は直近の currentStep */
    startStep: number;
    /** 長さステップ。制御トークンは 0（ハイライト対象外） */
    durationSteps: number;
    type: "note" | "chord" | "rest" | "octave" | "shift" | "length" | "ctrl";
};
type ParsedMML = {
    placements: MMLNotePlacement[];
    /** メロディトラックの t 指定から検出したBPM（無ければ null） */
    bpm: number | null;
    /**
     * trackIndex → 表示トークン列。`collectTokens` 指定時のみ生成。
     * placements と同一パスで構築するため発音位置と完全に同期する。
     */
    tokenTracks?: Map<number, MMLDisplayToken[]>;
    /**
     * 歌詞トラックID → 歌詞トラック。`collectLyrics` 指定時のみ生成。
     * 演奏トラック（@n）の n と同じIDで対応づく。
     */
    lyrics?: Map<number, LyricTrack>;
    /**
     * 1つの取り込み先トラックへ2系統以上のソースチャンネル（@n）の発音が合算された
     * トラック数。`clampTrackCount` による畳み込み等で発生する。0なら合算なし。
     * シンプルモードで「複数トラックを合算した」旨を控えめに知らせる用途。
     */
    mergedTrackCount: number;
    /**
     * トラックごとに最後に指定された v（ベロシティ）コマンドの値。
     * generateMML はトラック全体で単一の v をヘッダーに出力するため、
     * 読込時はこの値をトラックの既定ベロシティ（GUIのスライダー）へ復元する。
     */
    trackVelocity: Map<number, number>;
    /** トップレベル宣言（楽器プリセット・ドラムパターン）。常に返す（無ければ空オブジェクト） */
    meta: MmlMeta;
};
type ParseMMLOptions = {
    /** 1小節あたりのステップ数。既定192 */
    stepsPerBar?: number;
    /** 再生ビュー用の表示トークン列も併せて返す。既定 false */
    collectTokens?: boolean;
    /** 歌詞トラック（@@n）の解析結果も併せて返す。既定 false */
    collectLyrics?: boolean;
    /**
     * このトラック数以上のチャンネル（@n）をベース(index 2)へ畳み込む。
     * 4トラックDAWの読込専用の都合。未指定なら畳み込まず実際の @n をそのまま使う
     * （再生専用ビュー等、全トラックを忠実に表示したい用途の既定）。
     */
    clampTrackCount?: number;
};
/**
 * MML文字列を解析してノート配置とBPMを返す。
 */
declare const parseMML: (mml: string, options?: ParseMMLOptions) => ParsedMML;

type MmlPlayerOptions = {
    /** ループ再生（既定オフ）。#loop=on メタ行でも指定可 */
    loop?: boolean;
    /** メロディックノートの発音要求。未指定かつ synth 未指定なら内蔵synthが鳴る */
    onPlayNote?: (e: PlayNoteEvent) => void;
    /**
     * ドラムノートの発音要求（MMLのトップレベル宣言 `#drum=…` から解決）。
     * 未指定かつ内蔵synth有効なら、簡易ドラム音で鳴る。
     */
    onPlayDrum?: (e: PlayDrumEvent) => void;
    /** ドラムパターン辞書。`#drum=<キー>` の解決に使う。既定 DRUM_PATTERNS */
    drumPatterns?: Record<string, AnyDrumPattern | DrumPatternDef>;
    /** 再生クロック秒。既定は内蔵synthの AudioContext.currentTime もしくは performance.now()/1000 */
    getAudioTime?: () => number;
    /** 初回再生時に呼ばれる（AudioContext.resume 等に使う） */
    onResumeAudio?: () => void | Promise<void>;
    /**
     * 曲頭/曲尾のフェード（`#fadein=` / `#fadeout=`）の予約要求。null で解除。
     * 内蔵synthを使わず外のマスタバスへ鳴らしている場合（studio 経由など）に、
     * そのバス最終段のゲインへ掛けてもらうためのフック。
     * 時刻は `getAudioTime` と同じクロックで渡すので、両者は同じ AudioContext のものにすること。
     */
    onScheduleFade?: (params: FadeScheduleParams | null) => void;
    /** 内蔵の簡易square-wave synthを使うか。既定は onPlayNote 未指定なら true */
    synth?: boolean;
    /** マスタ音量 0-100。既定50（DAW編集画面の全体音量スライダーの既定値に合わせている）。 */
    masterVolume?: number;
    /** BPM未検出時のフォールバック。既定120 */
    defaultBpm?: number;
    /** 各トラックの 0-100 ボリューム。既定100 */
    volume?: number;
    /** trackIndex順の表示色。既定はPICO-8パレット4色 */
    trackColors?: string[];
    /** 歌唱合成の先読みや制御を行うヘルパ（.koe音源の再生前プリロードに使用） */
    singingVoices?: SingingVoices;
    /**
     * 伴奏音源（mp3 / wav / YouTube）の同時再生器。
     * MMLの `#audio=<URL>` を鳴らすのに使う（URLを持たないファイル読み込みはMMLに載らないので、
     * ここで鳴るのは常にURLの音源）。渡さないと `#audio=` は無視される。
     */
    backingAudio?: BackingAudio;
    /** 再生終了または手動停止時に呼び出されるコールバック */
    onStop?: () => void;
    /** 埋め込みプレイヤーのベースURL（例: "https://onjmin.github.io/dtm/demo/embed.html"） */
    embedUrl?: string;
    /**
     * 再生の前に音源の利用規約への同意画面を出すか（既定 false ＝ 出さない）。
     *
     * **聴く人は同意する立場ではない。** UTAU 音源の規約が縛るのは音源を使って作品を作り
     * 公開する側で、出来た曲を再生する人ではないので、再生を同意で塞がない。聴く人には
     * クレジット（「この曲には◯◯の音源を使用しています」＋規約へのリンク）を常に出していて、
     * 作る人向けの義務の告知は DAW の歌声モデル欄が受け持つ。
     * 作る画面の一部としてプレイヤーを置いていて、そこで同意を取りたいときだけ true にする。
     */
    requireConsent?: boolean;
    /**
     * @deprecated 同意画面は既定で出なくなったので、この指定は何もしない（後方互換のため残置）。
     * 同意画面が要る画面では {@link MmlPlayerOptions.requireConsent} を使う。
     */
    skipConsent?: boolean;
    /**
     * @internal モーダル（MMLを表示/MML書式とは/埋め込む）のメニュー項目を省略する。
     * 再帰的な mountMmlPlayer 呼び出しの無限ネストを防ぐために使う。
     */
    _skipInfoModals?: boolean;
    /**
     * 「MMLを表示」「MMLコピー」押下時に呼ばれる MML 取得コールバック。
     * 省略時は mountMmlPlayer に渡した mml をそのまま使う。
     * DAW と連携する場合は `() => daw.getMML().full` を渡すと
     * 常に最新の full フォーマット（メタ行・#end; 込み）を返せる。
     */
    getMml?: () => string;
};
type MmlPlayerInstance = {
    play: () => void;
    stop: () => void;
    isPlaying: () => boolean;
    setVolume: (volume: number) => void;
    destroy: () => void;
};
declare const encodeMml: (mml: string) => Promise<string>;
declare const decodeMml: (payload: string) => Promise<string>;
/**
 * MML文字列を再生専用ビューとして target にマウントする。
 */
declare const mountMmlPlayer: (target: HTMLElement, mml: string, options?: MmlPlayerOptions) => MmlPlayerInstance;

type PianoRollInstance = {
    core: MMLCore;
    getNotes: () => Note[];
    getMML: () => string;
    setVolume: (volume: number) => void;
    setNoteLengthSteps: (steps: number) => void;
    redraw: () => void;
    setToolMode: (mode: ToolMode) => void;
    getToolMode: () => ToolMode;
    getSelectionRect: () => {
        x: number;
        y: number;
        width: number;
        height: number;
    } | null;
    getNotesInRect: (rect: {
        x: number;
        y: number;
        width: number;
        height: number;
    }) => Note[];
    clearSelection: () => void;
    copySelection: () => Note[];
    pasteNotes: (notes: Note[], startStep: number) => void;
};
declare const createPianoRoll: (options: PianoRollOptions, handlers: CoreEventHandlers) => PianoRollInstance;

/**
 * 中国語ピンイン → かな の転写。
 *
 * UTAUの中国語音源は原音名をピンインのまま並べる（`xing` `tou` `she`）。
 * このアプリの歌詞は**かな＝日本語のモーラ**しか持てないので、
 * 「日本語話者がカタカナで書き取る」やり方で寄せる。歌わせた音は
 * 日本語訛りの中国語になるが、読めない綴りとして落とすよりはるかに近い。
 *
 * 割り切っていること:
 * - **声調は落とす。** 歌では旋律が声調を上書きするので、実害が小さい。
 * - **日本語に無い音は慣用のカタカナ表記へ倒す。** そり舌音（`zh` `ch` `sh` `r`）は
 *   ジャ／チャ／シャ行、`e`[ɤ] はア段（`le` → ラ、`she` → シャ）、舌尖母音の
 *   `i`（`zi` `ci` `si` `zhi` …）はズ／ツ／ス／ジ…、`ü` はユ段。
 * - **1音節が複数モーラになる。** `xing` → シ＋ン、`tou` → ト＋オ、`guo` → グ＋オ。
 *   このアプリは1ノート1モーラなので、呼び出し側はノートを割って割り当てる
 *   （撥音を独立ノートに置くのは日本語の歌でも同じ）。
 */
/**
 * ピンイン1音節をかなのモーラ列へ写す。ピンインとして読めなければ null。
 *
 * 声調番号（`xing1`）と `v` / `u:`（ü の代替綴り）は受ける。
 */
declare const pinyinToMoras: (raw: string) => string[] | null;

/**
 * 1つのピアノロール描画面（ヘッダー/鍵盤/グリッドの3枚のCanvas）を表す描画器。
 *
 * **描画状態はインスタンスに閉じ込める。** モジュールグローバルに置くと、1ページに2つ以上の
 * エディタをマウントしたとき後からマウントした側がそれを奪い、先にマウントした側の描画が
 * 相手のCanvasへ流れ込む。曲ごとに音律（12平均律 / 31平均律）が違うと格子まで食い違う。
 */
type Renderer = {
    getRenderConfig: () => RenderConfig;
    setBackgroundActive: (active: boolean) => void;
    getDrawOffset: () => {
        x: number;
        y: number;
    };
    getGridCanvas: () => HTMLCanvasElement;
    getGridContext: () => CanvasRenderingContext2D;
    getHeaderCanvas: () => HTMLCanvasElement;
    drawKeyboard: () => void;
    drawHeader: () => void;
    drawGrid: (noteLengthSteps?: number) => void;
    drawNotes: (notes: Note[], color?: number[], isActive?: boolean) => void;
    drawNoteLyrics: (notes: Note[], syllables: string[]) => void;
    /**
     * 語り（`「…」`）が実際に占める長さを、ノートの行に薄い帯で重ねる（プレビュー）。
     * 語りの長さは読み上げが決めるのでノートの音価とは一致しない。帯を見れば
     * 次の歌い出しと重なるかが分かる。
     */
    drawSpeechSpans: (spans: {
        note: Note;
        durationSteps: number;
    }[], color?: number[]) => void;
    /**
     * 語りの基準ピッチの行にガイドを引く。この行にノートを置くと音源の素の声の高さで話す。
     * ラベルは行の左端に出す。
     */
    drawPitchGuide: (pitchUnits: number, label: string) => void;
    drawSelectionRect: (rect: {
        x: number;
        y: number;
        width: number;
        height: number;
    } | null) => void;
    drawSelectedNotes: (notes: Note[], selectedIds: Set<number>, baseColor?: number[]) => void;
    getXY: (e: MouseEvent | PointerEvent) => [number, number, number];
    getGridPosition: (e: MouseEvent | PointerEvent) => {
        step: number;
        /** ピッチ。単位は units（1/372オクターブ）。 */
        pitch: Units;
        x: number;
        y: number;
    };
    onClick: (callback: (step: number, pitch: Units) => void) => void;
    setDrawOffset: (x: number, y: number) => void;
    /** Canvasをマウント先から取り外す。 */
    destroy: () => void;
};
/**
 * Canvasを生成してマウントし、そのマウント面専用の描画器を返す。
 * 同じページに複数生成しても互いの状態を踏まない。
 */
declare const createRenderer: (mountTarget: HTMLElement, width: number | undefined, height: number | undefined, config: RenderConfig) => Renderer;

/**
 * 再生シーケンサ。タイムライン計算と先読みスケジューリングを担い、
 * 実際の発音は注入されたフック（onPlayNote / onPlayDrum）へ委譲する。
 * 描画（プレイヘッド・オートスクロール）は onTick 経由で呼び出し側へ。
 */

/**
 * `start()` してから実際に曲が始まるまでの安全先読みバッファ（秒）。
 * 開始時刻を外から逆算したい呼び出し側（伴奏音源との待ち合わせ等）が使う。
 */
declare const SEQUENCER_START_DELAY = 0.1;
type SequencerTrack = {
    id: string;
    volume: number;
    notes: Note[];
};
type SequencerOptions = {
    getTracks: () => SequencerTrack[];
    getBpm: () => number;
    getPlayStartStep: () => number;
    getDrumPattern: (currentBar: number) => DrumPattern | null;
    /** ソロ対象トラックID（null=ソロ無効） */
    getSoloTrackId: () => string | null;
    /**
     * ループ再生設定（BGM用途）。
     * boolean または詳細な LoopConfig を指定可能。
     */
    getLoop?: () => boolean | LoopConfig;
    /** 再生中にイベントを発火させるタイミング */
    cues?: PlaybackCue[];
    /** キューポイント通過時のコールバック */
    onCue?: (cueId: string) => void;
    getAudioTime: () => number;
    onPlayNote: (e: PlayNoteEvent) => void;
    onPlayDrum: (e: PlayDrumEvent) => void;
    /** 毎フレーム currentPlayStep を通知（プレイヘッド/オートスクロール用） */
    onTick: (currentPlayStep: number) => void;
    /**
     * ノートが尽きても、ここで返す秒数（再生開始からの相対秒）までは曲を終わらせない。
     *
     * 伴奏音源（mp3等）を一緒に鳴らしているとき、打ち込みが先に終わっても曲は
     * まだ続いている。これが無いと音源の途中で「終了」してしまい、プレイヘッドも
     * 止まる。ノートが1つも無くても、これが正なら再生自体は走る。
     */
    getMinEndSec?: () => number;
    onEnd: (interrupted?: boolean) => void;
    stepsPerBar: number;
};
type Sequencer = {
    /**
     * 再生を始める。`preRollSec` を渡すと、その秒数だけ**待ってから**曲を走らせる
     * （伴奏音源の前奏を先に鳴らす用途。曲データには手を触れない）。
     */
    start: (fromStep?: number, preRollSec?: number) => void;
    stop: () => void;
    isActive: () => boolean;
    /**
     * 直近の start() が確定した再生開始時刻（getAudioTimeクロック秒、START_DELAY込み）。
     * 歌声ストリーミング等を同じアンカーで揃えるのに使う。start前は0。
     */
    getStartTime: () => number;
    /**
     * 曲が終わる時刻（再生開始からの相対秒）。音符の終端と {@link SequencerOptions.getMinEndSec}
     * の大きいほうで、ドラムの予約打ち切りと終了判定に使っているものと同じ値。
     * フェードアウトの着地点もこれに合わせること（音符の終端で代用すると、
     * ドラムや伴奏音源がフェードの外に出てフル音量で鳴り残る）。start前・ループ中は0。
     */
    getEndSec: () => number;
};
declare const resolveLoopPoint: (point: LoopPoint, _bpm: number, stepsPerBar: number, sps: number) => number;
declare const createSequencer: (options: SequencerOptions) => Sequencer;

/**
 * トラックへ挿す音作りの種別。GMプログラム番号から決める（{@link toneForProgram}）。
 *
 * - `bass` … パラレル・サチュレーション。
 * - `guitar-clean` … キャビネットのみ（クリーン系エレキ。歪ませない）。
 * - `guitar-drive` … 軽いドライブ＋キャビネット（オーバードライブ／ディストーション）。
 * - `acoustic` … 生の撥弦楽器。プレゼンス＋エアのEQだけ。
 * - `none` … 何も挿さない（鍵盤・管弦・シンセなど）。
 */
type InstrumentTone = "bass" | "guitar-clean" | "guitar-drive" | "acoustic" | "none";

type SoundFontInstance = {
    play: (o: {
        ctx: AudioContext;
        destination: AudioNode;
        /** 最寄りの整数MIDIノート番号（ゾーン選択用）。 */
        pitch: number;
        volume: number;
        /** 元ノートのvelocity(0-127)。音量ではなく音色の明るさにだけ効く。 */
        velocity?: number;
        /** pitch からの微調整（セント）。31平均律など整数ノートに乗らない音高用。 */
        detuneCents?: number;
        when: number;
        duration: number;
    }) => void;
    /**
     * この音源に合った音作りの種別（ベース／ギター等）。チャンネルストリップへ挿す
     * 段（サチュレーション・キャビネット）の選択に使う。外部から差し替えたエンジンが
     * 持たない場合は "none" 扱い。
     */
    tone?: InstrumentTone;
};
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;
    parseMidi?: DawOptions["parseMidi"];
};
type DtmStudioOptions = {
    /** 既存の AudioContext を使う（未指定なら内部生成）。 */
    audioContext?: AudioContext;
    /**
     * マスター音量 0-100（楽器・歌声）。既定100。
     * ライブラリ内の他の音量パラメータ（`setMasterVolume` 等）と同じ0-100スケール。
     */
    masterVolume?: number;
    /** ドラム音量 0-100。既定100。 */
    drumVolume?: number;
    /** マスタリバーブの掛かり具合 0-100。既定0（オフ）。全トラックへ一律で掛かる。 */
    reverbAmount?: number;
    /** マスタリバーブのDecay（残響の長さ、秒）。既定2.2、範囲0.3〜4.0。 */
    reverbDecay?: number;
    /** マスタリバーブのPre Delay（ms）。既定0、範囲0〜150。 */
    reverbPreDelay?: number;
    /** マスタディレイの掛かり具合 0-100。既定0（オフ）。テンポに同期したエコー。 */
    delayAmount?: number;
    /**
     * マスタバスの「グルーコンプレッサー」量 0-100。既定0（オフ）。
     * 全トラックの合流点（リバーブ・ディレイの戻りも含む）にまとめて軽く掛ける、
     * 表現目的の音楽的な圧縮（常時ONの安全リミッターとは別物）。
     */
    masterCompression?: number;
    /** マスタディレイの音価（既定 "8" = 8分音符）。 */
    delayDivision?: DelayDivision;
    /** 曲頭のフェードイン長（秒）。既定0（フェードなし）。 */
    fadeInSec?: number;
    /** 曲尾のフェードアウト長（秒）。既定0（フェードなし）。 */
    fadeOutSec?: number;
    /**
     * 最終出力先の AudioNode。未指定時は audioCtx.destination（スピーカー）。
     * MediaStreamAudioDestinationNode や GainNode を指定できます。
     */
    destination?: AudioNode;
    /**
     * 歌声合成ワーカー（voice-worker.js）のURL。
     * 既定はパッケージ同梱の dist/voice-worker.js。
     * `null` を渡すとワーカーを使わず klatt のみ（koe音源はメインスレッド合成）。
     */
    voiceWorkerUrl?: string | null;
    /** 初期の楽器プリセットキー（INSTRUMENT_PRESETS）。既定 "retro_game"。 */
    defaultPreset?: string;
    /** 外部エンジンの注入（指定したものは組み込み実装をスキップ）。 */
    engines?: DtmStudioEngines;
    /**
     * koe音源（.koe）のベースURL。
     * Discord Activity など CSP 制限下で `/.proxy/koe` を渡すと
     * worker 内の fetch も同オリジン経由になり CSP を通過できる。
     */
    koeBaseUrl?: string;
    /**
     * worldline.js（WORLDボコーダ）のURL。
     * Discord Activity など CSP 制限下で `/.proxy/koe-lib/demo/world/worldline.js`
     * を渡すと worker 内の importScripts も同オリジン経由になり CSP を通過できる。
     */
    worldlineScriptUrl?: string;
    /**
     * 語り（歌詞の `「…」`）用の TTS アセット（UtauTTS の Wasm・jpreprocess 辞書・
     * HTS 音声モデル、合計約 45MB）のベース URL。省略時は koe のデモと同じ
     * `https://onjmin.github.io/koe/demo/utautts/`。最初の語りを鳴らすときに取得し、
     * Cache API に保存する。CSP 制限下では同オリジンのプロキシを渡す。
     */
    ttsBaseUrl?: string;
    /** 有効化する機能。既定はすべて true。 */
    features?: {
        /** MIDIファイル読み込み。 */
        midi?: boolean;
        /** コード入力（和音）。 */
        chord?: boolean;
        /** 編集UIに楽器プリセット選択UIを差し込む。 */
        presetUI?: boolean;
        /**
         * 編集UIのツールバーにヘルプ（「?」）ボタンを出す。
         * 使い方モーダルと目的別ガイドツアーの入口になる。
         */
        help?: boolean;
    };
    /**
     * ガイドツアーの設定。この studio から生やす編集UI全体の既定値になる
     * （`mountEditor` の `tour` で個別に上書きできる）。
     *
     * **自動再生は既定でオフ**。埋め込み先の第一印象を勝手に上書きしないための既定値で、
     * 初回に流したいアプリだけが `{ autoStart: true }` を渡す。
     */
    tour?: DawOptions["tour"];
    /** MIDI検索クライアントの設定（未指定なら検索UI非表示）。 */
    midiSearch?: MidiSearchConfig;
    /** ドラムパターン辞書。 */
    drumPatterns?: Record<string, AnyDrumPattern | DrumPatternDef>;
};
/** 編集UIのマウント時オプション（DawOptions を一部上書きできる）。 */
type MountEditorOptions = Partial<DawOptions> & {
    /** このエディタで読み込む楽器プリセット（未指定なら studio の defaultPreset）。 */
    preset?: string;
    /** プリセット選択UIを出すか（未指定なら studio の features.presetUI）。 */
    presetUI?: boolean;
};
/** 再生UIのマウント時オプション（MmlPlayerOptions を一部上書きできる）。 */
type MountPlayerOptions = Partial<MmlPlayerOptions>;
/** {@link DtmStudio.mountPresetSelect} のオプション。 */
type PresetSelectOptions = {
    /**
     * 操作対象の現在の DawInstance を返す getter。
     * モード再マウントで daw が差し替わるため、参照ではなく関数で受け取る。
     */
    getDaw: () => DawInstance | null;
    /**
     * プリセットをロードするトラックID群を返す（都度評価）。
     * モードでトラック構成が変わるため関数。未指定なら4役割（simpleモード相当）。
     */
    getTrackIds?: () => string[];
    /** 初期選択プリセットキー（未指定なら studio の defaultPreset）。 */
    value?: string;
    /**
     * プリセット読み込み中にローディングオーバーレイを被せる要素。
     * 未指定なら DAW 内蔵の「LOADING」表示（setLoading）だけに任せる。
     */
    loadingTarget?: HTMLElement | null;
    /** プリセット確定時に呼ばれる（永続化用）。 */
    onChange?: (presetKey: string) => void;
    /** wrapper 要素に付与する className（既定 "dtm-controlbar"）。 */
    className?: string;
    /** 先頭ラベルの文言（既定 "INSTRUMENT"）。`null` でラベル無し。 */
    label?: string | null;
    /** target への挿入位置（既定 "append"）。 */
    position?: "append" | "prepend";
};
/** {@link DtmStudio.mountPresetSelect} の戻り値。 */
type PresetSelectInstance = {
    /** 生成したUIのルート要素（ラベル＋select を内包）。 */
    element: HTMLElement;
    /** select 要素そのもの。 */
    select: HTMLSelectElement;
    /** 選択値を変更する（changeイベントは発火しない）。 */
    setValue: (presetKey: string) => void;
    /** 現在の選択プリセットキーを返す。 */
    getValue: () => string;
    /** UIを破棄する。 */
    destroy: () => void;
};
/** {@link DtmStudio.mountModeSwitch} のオプション。 */
type ModeSwitchOptions = {
    /** 編集UI（mountEditor）をマウントするコンテナ。 */
    editorTarget: HTMLElement;
    /** 初期モード（既定 "simple"）。 */
    mode?: DawMode;
    /**
     * モード→トラック構成。
     * 既定は simple→TRACKS_SIMPLE / advanced→TRACKS_ADVANCED。
     */
    tracksFor?: (mode: DawMode) => TrackConfig[];
    /**
     * mountEditor に渡す共通オプション（initialMML / preset / defaultBpm / 各コールバック等）。
     * 関数を渡すとモードごとに切り替えられる。`mode` / `tracks` / `initialMML` は
     * モード切替側が上書きするため、ここで指定しても再マウント時には無視される。
     */
    editorOptions?: MountEditorOptions | ((mode: DawMode) => MountEditorOptions);
    /** マウント／再マウント完了時に呼ばれる（最新 daw を受け取る。MMLポーリング開始等）。 */
    onMount?: (daw: DawInstance, mode: DawMode) => void;
    /**
     * 破棄直前に呼ばれる（MMLポーリング停止等）。
     * 再マウント時の最新MMLの引き継ぎは内部で行うため、ここでの保存は任意。
     */
    onUnmount?: (daw: DawInstance, mode: DawMode) => void;
    /** モード確定時に呼ばれる（永続化用。初期マウントでは呼ばれない）。 */
    onChange?: (mode: DawMode) => void;
    /** 各モードのボタンラベル（既定 simple="シンプル" / advanced="アドバンス"）。 */
    labels?: Partial<Record<DawMode, string>>;
    /** 先頭ラベルの文言（既定 "MODE"）。`null` でラベル無し。 */
    label?: string | null;
    /** wrapper 要素に付与する className（既定 "dtm-controlbar"）。 */
    className?: string;
    /** target への挿入位置（既定 "append"）。 */
    position?: "append" | "prepend";
};
/** {@link DtmStudio.mountModeSwitch} の戻り値。 */
type ModeSwitchInstance = {
    /** 生成したUIのルート要素。 */
    element: HTMLElement;
    /** 現在マウント中の DawInstance（再マウントで差し替わる）。 */
    getDaw: () => DawInstance | null;
    /** 現在のモード。 */
    getMode: () => DawMode;
    /** モードを変更し、編集UIを再マウントする（MMLは引き継ぐ）。 */
    setMode: (mode: DawMode) => void;
    /** UIと編集UIをまとめて破棄する。 */
    destroy: () => void;
};
/**
 * {@link DtmStudio.speak} で `model` を省略したときの音源。つくよみちゃんは
 * 読み上げ用途を含む利用規約が緩く、内蔵音源の中で最初に入れた基準の声。
 */
declare const DEFAULT_SPEECH_MODEL = "tsukuyomi";
type DtmStudio = {
    /** 内部で使用している AudioContext。 */
    audioContext: AudioContext;
    /** マスターゲインノード（全音色の最終出力先）。 */
    masterGain: GainNode;
    /**
     * 録画・録音用の MediaStreamAudioDestinationNode を生成/取得する。
     * masterGain が接続され、その stream から音声トラックを取得できます。
     */
    createMediaStreamDestination: () => MediaStreamAudioDestinationNode;
    /**
     * 録画・録音用の Audio MediaStreamTrack を取得する。
     * MediaRecorder のストリーム合成（canvas + audio）に使えます。
     */
    getAudioStreamTrack: () => MediaStreamTrack;
    /**
     * WAV書き出し用の録音を開始する（マスタバス最終段＝リバーブ/ディレイ/コンプ/
     * リミッター/フェード適用後のPCMをそのままタップする）。
     * 呼び出し側で再生（daw.play() 等）を開始し、曲が終わったら stopWavRecording を呼ぶ想定。
     * 実際の再生と同じ経路を録るため等速（曲の長さ分だけ実時間がかかる）。
     */
    startWavRecording: () => void;
    /** startWavRecording で開始した録音を止め、16bit PCM WAVのBlobを返す。 */
    stopWavRecording: () => Promise<Blob>;
    /** 歌声合成ヘルパ（klatt + koe音源）。 */
    singingVoices: SingingVoices;
    /**
     * 本文を koe 音源で読み上げる（MML を介さない単発の語り。セリフ・ナレーション用）。
     * `model` 省略時は {@link DEFAULT_SPEECH_MODEL}。ブラウザの自動再生ポリシーのため、
     * 最初の呼び出しはユーザー操作のコールスタック内から行うこと。
     * 音量はマスタ（{@link setMasterVolume}）に従う。
     * 初回は TTS アセット約 45MB を取得する（{@link prepareSpeech} で先に済ませられる）。
     * 読み上げできない（未知のモデル・読みが取れない本文）ときは null。
     */
    speak: (text: string, options?: SpeakOptions & {
        model?: string;
    }) => Promise<SpeechHandle | null>;
    /**
     * 読み上げに必要なもの（TTS アセットと音源マニフェスト）を先に取得する。
     * `models` 省略時は {@link DEFAULT_SPEECH_MODEL} だけ。
     */
    prepareSpeech: (models?: Iterable<string>, options?: SpeechPrepareOptions) => Promise<void>;
    /**
     * 読み上げの計画だけを行い、長さ（秒）とモーラ列を返す（鳴らさない）。台本の各行の
     * 長さを先に知って時間軸を組む用途。`model` 省略時は {@link DEFAULT_SPEECH_MODEL}。
     * 未知のモデル・読みが取れない本文では null。
     */
    planSpeech: (text: string, options?: SpeechPlanDetailOptions & {
        model?: string;
    }) => Promise<SpeechPlanInfo | null>;
    /** 編集UI（mountDAW）を音・歌声込みでマウントする。 */
    mountEditor: (target: HTMLElement, options?: MountEditorOptions) => DawInstance;
    /** 再生専用UI（mountMmlPlayer）を音・歌声込みでマウントする。 */
    mountPlayer: (target: HTMLElement, mml: string, options?: MountPlayerOptions) => MmlPlayerInstance;
    /** コード進行再生専用プレイヤー（UI）をマウントする */
    mountChordPlayer: (target: HTMLElement, chords: string, options?: Omit<MountChordPlayerOptions, "studio">) => ChordPlayerInstance;
    /** UIなしで高品質な楽器再生（SoundFont）を行う */
    play: (mml: string, options?: Omit<PlayMmlOptions, "audioContext" | "destination" | "onPlayNote" | "onPlayDrum" | "synth">) => MmlPlayback;
    /** UIなしで高品質な楽器再生（SoundFont）＋歌声合成を行う */
    playSingingMML: (mml: string, options?: Omit<PlaySingingMmlOptions, "audioContext" | "destination" | "onPlayNote" | "onPlayDrum" | "synth">) => Promise<MmlPlayback>;
    /** SoundFontへ PlayNoteEvent を鳴らす（headless API の onPlayNote フック用） */
    playNoteEvent: (e: PlayNoteEvent) => void;
    /** SoundFontへ PlayDrumEvent を鳴らす（headless API の onPlayDrum フック用） */
    playDrumEvent: (e: PlayDrumEvent) => void;
    /** SoundFontを用いた単音再生を行う */
    playNote: (options: {
        /** ピッチ。単位は units（1/372オクターブ）。`pitchV1ToUnits` でMIDI番号から変換できる。 */
        pitchUnits: Units;
        volume?: number;
        duration?: number;
        instrument?: string;
    }) => Promise<void>;
    /** SoundFontを用いたコード進行再生を行う */
    playChords: (chordStr: string, options?: Omit<PlayChordsOptions, "audioContext" | "destination" | "onPlayNote" | "onPlayDrum" | "synth">) => MmlPlayback;
    /** 楽器プリセットを（指定トラックぶん）ロードする。 */
    loadPreset: (presetKey: string, trackIds?: string[]) => Promise<void>;
    /** 既定の楽器プリセットキー（options.defaultPreset ?? "retro_game"）。 */
    defaultPreset: string;
    /**
     * 楽器プリセット選択UI（INSTRUMENT）を target に差し込む。
     * 変更時に内部で setInstrument＋loadPreset（再生中なら一旦停止→再開）まで配線する。
     * 編集UIの外側に独自配置したいライブラリ利用者向け（mountEditor の presetUI と同等）。
     */
    mountPresetSelect: (target: HTMLElement, options: PresetSelectOptions) => PresetSelectInstance;
    /**
     * モード切替UI（SIMPLE/ADVANCED）を target に差し込み、編集UIのマウントごと面倒を見る。
     * 切替時に「最新MML取り込み→destroy→新トラック構成で再マウント→MML復元」まで内部で行う。
     * getDaw() で現在の DawInstance を取得できる（mountPresetSelect の getDaw に渡せる）。
     */
    mountModeSwitch: (target: HTMLElement, options: ModeSwitchOptions) => ModeSwitchInstance;
    /**
     * studio 全体（このstudioを共有する全ての mountEditor / mountPlayer / mountChordPlayer /
     * playSingingMML インスタンス）の出力段ゲインを 0-100 で変更する。
     *
     * これは「聴く人（リスナー）側の音量設定」用のノブで、曲データとは無関係に
     * オーディオグラフの最終段（`studio.masterGain`）に一度だけ掛かる。
     * `DawInstance.setMasterVolume` / `MmlPlayerOptions.masterVolume`（`#volume=`
     * と往復する“曲自体が持つ音量”）とは別物なので混同しないこと。
     * `daw.loadMML()` や `#volume=` の内容に一切影響されない。
     */
    setMasterVolume: (volume: number) => void;
    /** `setMasterVolume` のエイリアス。 */
    setVolume: (volume: number) => void;
    /** マスタリバーブの掛かり具合を 0-100 で変更する。 */
    setReverbAmount: (amount: number) => void;
    /** マスタリバーブのDecay（残響の長さ）を秒で変更する。 */
    setReverbDecay: (seconds: number) => void;
    /** マスタリバーブのPre Delayをmsで変更する。 */
    setReverbPreDelay: (ms: number) => void;
    /** マスタディレイの掛かり具合を 0-100 で変更する。 */
    setDelayAmount: (amount: number) => void;
    /** マスタバスのグルーコンプレッサー量を 0-100 で変更する。 */
    setMasterCompression: (amount: number) => void;
    /**
     * 直近にマウントした編集UIでガイドツアーを開始する。
     * 自動再生（`tour.autoStart`）を切っていても、独自の「使い方」ボタンから呼べる。
     * 編集UIが1つも無いときは何もしない。
     */
    startTour: () => void;
    /** AudioContext を閉じ、生成物を破棄する。 */
    dispose: () => void;
};
/**
 * 全部入りスタジオを生成する。SoundFontエンジン・ドラム音源・楽器プリセットの
 * 初期ロードまで待ってから解決するため、await して使う。
 */
declare const createDtmStudio: (options?: DtmStudioOptions) => Promise<DtmStudio>;

/**
 * mountDAW が注入する自己完結スタイル。
 * すべてのクラスは `dtm-` プレフィックスでスコープし、ホスト側CSSと衝突しにくくする。
 * ドット絵・レトロゲーム風ピクセルアートデザイン（美咲フォント・角なし・ハードシャドウ）。
 * モバイルファースト（狭幅基準）で設計し、min-width メディアクエリで広幅に拡張する。
 */
declare const DAW_CSS = "\n@font-face {\n  font-family: 'k8x12';\n  src: url('https://db.onlinewebfonts.com/t/777630d46640dc5a928ea833c2fcb875.woff2') format('woff2'),\n       url('https://db.onlinewebfonts.com/t/777630d46640dc5a928ea833c2fcb875.woff') format('woff'),\n       url('https://db.onlinewebfonts.com/t/777630d46640dc5a928ea833c2fcb875.ttf') format('truetype');\n  font-weight: normal;\n  font-style: normal;\n}\n\n/* ====================================================\n   PIXEL MUSIC STUDIO \u2014 \u30C9\u30C3\u30C8\u7D75UI\u30B7\u30B9\u30C6\u30E0\n   PICO-8\u30AB\u30E9\u30FC\u30D1\u30EC\u30C3\u30C8\u30FB\u7F8E\u54B2\u30D5\u30A9\u30F3\u30C8\u30FB\u30B2\u30FC\u30E0\u30A6\u30A3\u30F3\u30C9\u30A6\u67A0\n   ==================================================== */\n\n/* \u30C7\u30B6\u30A4\u30F3\u30C8\u30FC\u30AF\u30F3\u306F\u7DE8\u96C6UI\u672C\u4F53\uFF08.dtm-daw\uFF09\u306B\u52A0\u3048\u3001\u305D\u306E\u5916\u5074\u306B\u5DEE\u3057\u8FBC\u307E\u308C\u308B\n   \u30B3\u30F3\u30C8\u30ED\u30FC\u30EB\u30D0\u30FC\uFF08.dtm-controlbar\uFF09\u306B\u3082\u4F9B\u7D66\u3059\u308B\u3002mountPresetSelect /\n   mountModeSwitch \u306EUI\u306F .dtm-daw \u306E\u5144\u5F1F\u3068\u3057\u3066\u7F6E\u304B\u308C\u308B\u305F\u3081\u3001\u3053\u3053\u3067\u914D\u3089\u306A\u3044\u3068\n   var(--dtm-*) \u304C\u89E3\u6C7A\u3067\u304D\u305A\u7121\u88C5\u98FE\uFF08\u767D\u5730\u30FB\u65E2\u5B9A\u30D5\u30A9\u30F3\u30C8\uFF09\u306B\u306A\u3063\u3066\u3057\u307E\u3046\u3002\n   \u518D\u751F\u5C02\u7528\u30D3\u30E5\u30FC\u306E\u30E2\u30FC\u30C0\u30EB\uFF0F\u5229\u7528\u898F\u7D04\u30AB\u30D0\u30FC\u3001\u6B4C\u58F0\u30E2\u30C7\u30EB\u540D\u306E\u5439\u304D\u51FA\u3057(.dtm-player-balloon)\n   \u30AC\u30A4\u30C9\u30C4\u30A2\u30FC\u306E\u6697\u5E55(.dtm-tour)\u306F document.body \u76F4\u4E0B\u3078\u91CD\u306D\u308B\u305F\u3081\u3001.dtm-daw \u306E\u5916\u306B\u51FA\u308B\u3002\n   \u3053\u308C\u3089\u3082\u540C\u69D8\u306B\u30C8\u30FC\u30AF\u30F3\u3092\u4F9B\u7D66\u3057\u306A\u3044\u3068\u7121\u88C5\u98FE\uFF08\u67A0\u7DDA\u306A\u3057\u30FB\u6587\u5B57\u8272\u4E0D\u660E\u306E\u767D\u3044\u7BB1\uFF09\u306B\u306A\u308B\u3002 */\n.dtm-daw,\n.dtm-controlbar,\n.dtm-modal-overlay,\n.dtm-consent-overlay,\n.dtm-chord-player,\n.dtm-player-balloon,\n.dtm-tour {\n  /* PICO-8 16\u8272\u30D1\u30EC\u30C3\u30C8\u3088\u308A */\n  --c-black:   #000000;\n  --c-navy:    #1d2b53;\n  --c-purple:  #7e2553;\n  --c-dkgreen: #008751;\n  --c-brown:   #ab5236;\n  --c-dkgray:  #5f574f;\n  --c-gray:    #c2c3c7;\n  --c-white:   #fff1e8;\n  --c-red:     #ff004d;\n  --c-orange:  #ffa300;\n  --c-yellow:  #ffec27;\n  --c-green:   #00e436;\n  --c-cyan:    #29adff;\n  --c-lavend:  #83769c;\n  --c-pink:    #ff77a8;\n  --c-peach:   #ffccaa;\n\n  /* \u30BB\u30DE\u30F3\u30C6\u30A3\u30C3\u30AF\u30C8\u30FC\u30AF\u30F3 */\n  --dtm-bg:       var(--c-black);\n  --dtm-surface:  var(--c-navy);\n  --dtm-deep:     #0a0f1f;\n  --dtm-border:   var(--c-cyan);\n  --dtm-border2:  var(--c-dkgray);\n  --dtm-text:     var(--c-white);\n  --dtm-muted:    var(--c-lavend);\n  --dtm-primary:  var(--c-cyan);\n  --dtm-pfg:      var(--c-black);\n  --dtm-danger:   var(--c-red);\n  --dtm-success:  var(--c-green);\n  --dtm-accent:   var(--c-pink);\n  --dtm-gold:     var(--c-yellow);\n  --dtm-warn:     var(--c-orange);\n  --dtm-tap:      40px;\n  --dtm-gap:      6px;\n  --dtm-font:     'k8x12',ui-monospace,monospace;\n}\n\n.dtm-daw {\n  box-sizing: border-box;\n  font-family: var(--dtm-font);\n  font-size: 14px;\n  line-height: 1.6;\n  letter-spacing: .06em;\n  color: var(--dtm-text);\n  background: var(--dtm-bg);\n  width: 100%;\n  display: flex;\n  flex-direction: column;\n  gap: var(--dtm-gap);\n  padding: 0;\n  image-rendering: pixelated;\n  -webkit-font-smoothing: none;\n  -moz-osx-font-smoothing: unset;\n  font-smooth: never;\n  -webkit-tap-highlight-color: transparent;\n}\n.dtm-daw *,\n.dtm-daw *::before,\n.dtm-daw *::after { box-sizing: border-box; }\n\n/* \u2500\u2500\u2500 \u30EC\u30A4\u30A2\u30A6\u30C8\uFF08\u7DE8\u96C6\u30D8\u30C3\u30C9\u306E\u8CBC\u308A\u4ED8\u3051\uFF09 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   \u30D1\u30CD\u30EB\u306F\u7E26\u306B\u7A4D\u3080\u3057\u304B\u306A\u3044\u306E\u3067\u3001\u958B\u304F\u307B\u3069\u30D4\u30A2\u30CE\u30ED\u30FC\u30EB\u304C\u753B\u9762\u5916\u3078\u6D41\u308C\u3066\u3044\u304F\u3002\n   \u30D8\u30C3\u30C9\uFF08\u30C8\u30E9\u30F3\u30B9\u30DD\u30FC\u30C8\u30FB\u30C4\u30FC\u30EB\u30FB\u30ED\u30FC\u30EB\uFF09\u3092 sticky \u3067\u753B\u9762\u4E0A\u90E8\u306B\u7559\u3081\u308C\u3070\u3001\n   \u4F55\u679A\u958B\u3044\u3066\u3082\u30ED\u30FC\u30EB\u3068\u306E\u8DDD\u96E2\u306F0\u306E\u307E\u307E\u306B\u306A\u308B\u3002\n\n   \u305F\u3060\u30571\u30AB\u30E9\u30E0\u306E\u3042\u3044\u3060\u3001\u8CBC\u3063\u305F\u30D8\u30C3\u30C9\u306F\u305D\u306E\u9AD8\u3055\u3076\u3093\u753B\u9762\u3092\u5360\u6709\u3057\u7D9A\u3051\u308B\u3002\n   \u30D8\u30C3\u30C9\u306E\u9AD8\u3055\u306F\u300C\u56FA\u5B9A\u90E8\u304A\u3088\u305D194px \uFF0B \u30ED\u30FC\u30EB32vh\u300D\u306A\u306E\u3067\u3001\u753B\u9762\u304C\u4F4E\u3044\u307B\u3069\n   \u5360\u6709\u7387\u304C\u4E0A\u304C\u308B\uFF08844px\u306755%\u3001667px\u306764%\uFF09\u3002\u5360\u6709\u7387\u304C6\u5272\u3092\u5207\u308B\u7E26760px\u4EE5\u4E0A\u3067\n   \u3060\u3051\u8CBC\u308A\u3001\u305D\u308C\u672A\u6E80\u306F\u5F93\u6765\u3069\u304A\u308A\u30C8\u30E9\u30F3\u30B9\u30DD\u30FC\u30C8\u3060\u3051\u3092\u8CBC\u308B\u3002\n   \uFF08\u6A2A\u306B\u5272\u3063\u3066\u7E26\u306E\u53D6\u308A\u5408\u3044\u3092\u7121\u304F\u30592\u30AB\u30E9\u30E0\u6848\u306F\u3001\u30C7\u30E2\u306E #app \u304C max-w-4xl \u306E\n   \u305F\u3081\u4ECA\u306E\u307E\u307E\u3060\u3068\u30ED\u30FC\u30EB\u304C\u7D30\u304F\u306A\u308B\u306E\u3067\u898B\u9001\u3063\u3066\u3044\u308B\u3002\uFF09 */\n.dtm-daw-panels {\n  display: flex;\n  flex-direction: column;\n  gap: var(--dtm-gap);\n  min-width: 0;\n}\n/* \u8CBC\u3089\u306A\u3044\u753B\u9762\u3067\u306F\u7BB1\u3054\u3068\u7573\u3080\u3002display:contents \u306A\u3089\u4E2D\u8EAB\u304C .dtm-daw \u306E\u76F4\u63A5\u306E\n   \u5B50\u306B\u623B\u308B\u306E\u3067\u3001\u4F59\u767D\u3082\u30C8\u30E9\u30F3\u30B9\u30DD\u30FC\u30C8\u306E sticky \u57FA\u6E96\u3082\u5F93\u6765\u306E\u307E\u307E\u5909\u308F\u3089\u306A\u3044\u3002 */\n.dtm-daw-head { display: contents; }\n.dtm-topbar {\n  position: sticky;\n  top: 0;\n  z-index: 20;\n}\n@media (min-height: 760px) {\n  .dtm-daw-head {\n    display: flex;\n    flex-direction: column;\n    gap: var(--dtm-gap);\n    min-width: 0;\n    position: sticky;\n    top: 0;\n    z-index: 20;\n    /* \u4E0B\u3092\u304F\u3050\u308B\u30D1\u30CD\u30EB\u3092\u900F\u304B\u3055\u306A\u3044\u305F\u3081\u306E\u4E0D\u900F\u660E\u306A\u4E0B\u6577\u304D\u3002\n       .dtm-daw \u306E gap \u3076\u3093\u3092 padding \u3067\u57CB\u3081\u3001\u9699\u9593\u304B\u3089\u4E2D\u8EAB\u3092\u898B\u305B\u306A\u3044\u3002 */\n    background: var(--dtm-bg);\n    padding-bottom: var(--dtm-gap);\n  }\n}\n\n/* \u30A8\u30C7\u30A3\u30BF\u81EA\u8EAB\u304C\u5341\u5206\u306B\u5E83\u3044\u3068\u304D\u306F\u3001\u30D8\u30C3\u30C9\u3068\u30D1\u30CD\u30EB\u3092\u5DE6\u53F3\u306B\u4E26\u3079\u3066\u3001\u7E26\u306E\n   \u7A4D\u307F\u4E0A\u304C\u308A\u3092\u6A2A\u3078\u9003\u304C\u3059\u3002\u3053\u3046\u306A\u308B\u3068\u30D8\u30C3\u30C9\u306F\u30D1\u30CD\u30EB\u304B\u3089\u7E26\u3092\u596A\u308F\u306A\u3044\u306E\u3067\u3001\n   \u753B\u9762\u306E\u9AD8\u3055\u306B\u95A2\u4FC2\u306A\u304F\u8CBC\u308C\u308B\u3057\u3001\u30ED\u30FC\u30EB\u3082\u5E83\u304F\u4F7F\u3048\u308B\n   \uFF08.dtm-daw--wide \u306F daw.ts \u306E ResizeObserver \u304C\u4ED8\u3051\u308B\uFF09\u3002 */\n.dtm-daw--wide {\n  flex-direction: row;\n  align-items: flex-start;\n}\n.dtm-daw--wide .dtm-daw-head {\n  display: flex;\n  flex-direction: column;\n  gap: var(--dtm-gap);\n  min-width: 0;\n  flex: 1 1 auto;\n  position: sticky;\n  top: 0;\n  z-index: 20;\n  background: var(--dtm-bg);\n  padding-bottom: 0;\n}\n.dtm-daw--wide .dtm-daw-panels {\n  flex: 0 0 360px;\n}\n/* 768px \u6642\u70B9\u306E height:420px \u306F max-height:32vh \u306B\u982D\u6253\u3061\u306B\u3055\u308C\u3066\u3044\u305F\u3002\n   2\u30AB\u30E9\u30E0\u3067\u306F\u7E26\u3092\u53D6\u308A\u5408\u308F\u306A\u3044\u306E\u3067\u3001\u305D\u306E\u610F\u56F3\u3069\u304A\u308A\u306E\u9AD8\u3055\u3092\u89E3\u7981\u3059\u308B\n   \uFF08\u4F4E\u3044\u753B\u9762\u3067\u306F 45vh \u3067\u982D\u6253\u3061\u306B\u3057\u3066\u753B\u9762\u3092\u98DF\u3044\u6F70\u3055\u306A\u3044\u3088\u3046\u306B\u3059\u308B\uFF09\u3002 */\n.dtm-daw--wide .dtm-roll {\n  height: min(420px, 45vh);\n  max-height: none;\n}\n\n/* \u2500\u2500\u2500 \u30B2\u30FC\u30E0\u30A6\u30A3\u30F3\u30C9\u30A6\u5171\u901A\u67A0 \u2500\u2500\u2500 */\n/* \u5916\u67A0(\u9ED22px) \u2192 \u8272\u4ED8\u304D2px border \u2192 \u5185\u67A0(\u9ED2inset2px) \u306E3\u91CD\u69CB\u9020 */\n.dtm-win {\n  border: 2px solid var(--c-black);\n  box-shadow:\n    inset 0 0 0 2px var(--c-black),\n    0 0 0 2px var(--dtm-primary),\n    4px 4px 0 var(--c-black);\n  background: var(--dtm-surface);\n}\n\n/* \u2500\u2500\u2500 \u5171\u901A\u30DC\u30BF\u30F3 \u2500\u2500\u2500 */\n.dtm-btn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  gap: 4px;\n  min-height: var(--dtm-tap);\n  min-width: var(--dtm-tap);\n  padding: 0 10px;\n  border: 2px solid var(--dtm-border2);\n  background: var(--dtm-surface);\n  color: var(--dtm-text);\n  font-family: var(--dtm-font);\n  font-size: 13px;\n  text-transform: uppercase;\n  letter-spacing: .12em;\n  cursor: pointer;\n  user-select: none;\n  white-space: nowrap;\n  box-shadow: 3px 3px 0 var(--c-black);\n  transition: none;\n}\n.dtm-btn:active  { transform: translate(3px,3px); box-shadow: none; }\n.dtm-btn:disabled { opacity: .3; cursor: default; box-shadow: none; }\n.dtm-btn--ghost   { background: transparent; border-color: var(--dtm-border2); }\n.dtm-btn--primary { border-color: var(--dtm-primary); background: var(--dtm-primary); color: var(--dtm-pfg); }\n.dtm-btn--success { border-color: var(--dtm-success); background: var(--dtm-success); color: var(--c-black); }\n.dtm-btn--danger  { border-color: var(--dtm-danger);  background: var(--dtm-danger);  color: var(--c-white); }\n.dtm-btn--accent  { border-color: var(--dtm-accent);  background: var(--dtm-accent);  color: var(--c-black); }\n.dtm-btn--icon    { padding: 0; }\n\n/* \u2500\u2500\u2500 \u30A2\u30A4\u30B3\u30F3\u30DC\u30BF\u30F3 \u2500\u2500\u2500 */\n.dtm-iconbtn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: var(--dtm-tap);\n  height: var(--dtm-tap);\n  flex: 0 0 auto;\n  border: 2px solid var(--dtm-border2);\n  background: var(--dtm-surface);\n  color: var(--dtm-text);\n  font-size: 16px;\n  cursor: pointer;\n  box-shadow: 3px 3px 0 var(--c-black);\n}\n.dtm-iconbtn:active  { transform: translate(3px,3px); box-shadow: none; }\n.dtm-iconbtn:disabled { opacity: .3; cursor: default; box-shadow: none; }\n\n/* \u2500\u2500\u2500 \u30C8\u30E9\u30F3\u30B9\u30DD\u30FC\u30C8\u30D0\u30FC\uFF08HUD\u30B9\u30BF\u30A4\u30EB\uFF09 \u2500\u2500\u2500 */\n.dtm-topbar {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: var(--dtm-gap);\n  padding: 6px;\n  background: var(--dtm-deep);\n  border: 2px solid var(--c-black);\n  box-shadow:\n    inset 0 0 0 2px var(--c-black),\n    0 0 0 2px var(--dtm-success),\n    4px 4px 0 var(--c-black);\n}\n.dtm-topbar-row1 {\n  display: flex;\n  align-items: center;\n  gap: var(--dtm-gap);\n  flex-basis: 100%;\n  min-width: 0;\n  overflow-x: auto;\n  scrollbar-width: none;\n}\n.dtm-topbar-row1::-webkit-scrollbar { display: none; }\n.dtm-topbar-row1 > * { flex-shrink: 0; }\n.dtm-topbar-row1 > .dtm-grow { flex-shrink: 1; }\n\n/* PLAY\u30DC\u30BF\u30F3 \u2014 \u30B2\u30FC\u30E0\u306E\u300C\u6C7A\u5B9A\u30DC\u30BF\u30F3\u300D\u7684\u5B58\u5728\u611F */\n.dtm-play {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: var(--dtm-tap);\n  height: var(--dtm-tap);\n  flex: 0 0 auto;\n  border: 2px solid var(--c-black);\n  background: var(--dtm-success);\n  color: var(--c-black);\n  cursor: pointer;\n  box-shadow: 0 0 0 2px var(--dtm-success), 4px 4px 0 var(--c-black);\n}\n.dtm-play:active  { transform: translate(4px,4px); box-shadow: none; }\n.dtm-play:disabled { opacity: .35; cursor: default; box-shadow: none; }\n.dtm-play--stop {\n  background: var(--dtm-danger);\n  box-shadow: 0 0 0 2px var(--dtm-danger), 4px 4px 0 var(--c-black);\n}\n.dtm-rec { color: var(--dtm-danger); }\n\n/* BPM \u2014 \u30C7\u30B8\u30BF\u30EB\u30AB\u30A6\u30F3\u30BF\u30FC\u98A8 */\n.dtm-label {\n  font-family: var(--dtm-font);\n  font-size: 11px;\n  text-transform: uppercase;\n  letter-spacing: .14em;\n  color: var(--dtm-muted);\n  white-space: nowrap;\n}\n.dtm-checkbox-label {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  font-family: var(--dtm-font);\n  font-size: 11px;\n  text-transform: uppercase;\n  letter-spacing: .12em;\n  color: var(--dtm-muted);\n  cursor: pointer;\n  user-select: none;\n  margin-top: 4px;\n}\n.dtm-checkbox-label:hover { color: var(--dtm-text); }\n\n/* \u2500\u2500\u2500 \u4F5C\u66F2\u3059\u308B\u30BB\u30AF\u30B7\u30E7\u30F3\u306E\u9078\u629E\uFF08\u30A4\u30F3\u30C8\u30ED\u30FBA\u30E1\u30ED\u2026\u306E\u30C1\u30A7\u30C3\u30AF\uFF09 \u2500\u2500\u2500 */\n.dtm-checks {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 4px 10px;\n  align-items: center;\n}\n.dtm-check {\n  display: inline-flex;\n  align-items: center;\n  gap: 4px;\n  font-family: var(--dtm-font);\n  font-size: 11px;\n  color: var(--dtm-muted);\n  cursor: pointer;\n  user-select: none;\n  white-space: nowrap;\n}\n.dtm-check:hover { color: var(--dtm-text); }\n.dtm-check input {\n  width: 13px;\n  height: 13px;\n  accent-color: var(--dtm-success);\n  cursor: pointer;\n  flex-shrink: 0;\n}\n.dtm-info-table {\n  border-collapse: collapse;\n  margin: 6px 0;\n  font-size: 11px;\n  width: 100%;\n}\n.dtm-info-table th,\n.dtm-info-table td {\n  border: 1px solid var(--dtm-border);\n  padding: 3px 6px;\n  text-align: left;\n  white-space: nowrap;\n}\n.dtm-info-table th { color: var(--dtm-muted); font-weight: normal; }\n.dtm-hint {\n  font-family: var(--dtm-font);\n  font-size: 10px;\n  color: var(--dtm-muted);\n  white-space: nowrap;\n}\n.dtm-checkbox-label--sub { margin-left: 20px; font-size: 10px; }\n.dtm-checkbox {\n  width: 14px;\n  height: 14px;\n  accent-color: var(--dtm-success);\n  cursor: pointer;\n  flex-shrink: 0;\n}\n\n.dtm-toggle {\n  display: inline-flex;\n  align-items: center;\n  gap: 6px;\n  font-family: var(--dtm-font);\n  font-size: 12px;\n  text-transform: uppercase;\n  letter-spacing: .1em;\n  color: var(--dtm-muted);\n  cursor: pointer;\n}\n.dtm-toggle input { width: 16px; height: 16px; accent-color: var(--dtm-accent); }\n\n/* \u2500\u2500\u2500 \u30C4\u30FC\u30EB\u30C9\u30C3\u30AF\uFF08\u88C5\u5099\u30B9\u30ED\u30C3\u30C8\u98A8\uFF09 \u2500\u2500\u2500 */\n.dtm-tooldock {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: var(--dtm-gap);\n  padding: 6px;\n  background: var(--dtm-deep);\n  border: 2px solid var(--c-black);\n  box-shadow:\n    inset 0 0 0 2px var(--c-black),\n    0 0 0 2px var(--dtm-border2),\n    4px 4px 0 var(--c-black);\n}\n.dtm-sep {\n  width: 2px; align-self: stretch;\n  background: var(--dtm-border2); margin: 2px;\n}\n.dtm-row .dtm-label[data-dtm] { min-width: 48px; text-align: center; }\n\n/* \u2500\u2500\u2500 \u30BB\u30B0\u30E1\u30F3\u30C8\uFF08\u30A2\u30A4\u30C6\u30E0\u30B9\u30ED\u30C3\u30C8\uFF09 \u2500\u2500\u2500 */\n.dtm-seg {\n  display: inline-flex;\n  border: 2px solid var(--dtm-border2);\n  background: var(--dtm-deep);\n  box-shadow: 3px 3px 0 var(--c-black);\n}\n.dtm-segbtn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: var(--dtm-tap);\n  height: var(--dtm-tap);\n  border: none;\n  border-right: 2px solid var(--dtm-border2);\n  background: transparent;\n  color: var(--dtm-muted);\n  cursor: pointer;\n}\n.dtm-segbtn:last-child { border-right: none; }\n.dtm-segbtn--active {\n  background: var(--dtm-gold);\n  color: var(--c-black);\n}\n.dtm-segbtn:not(.dtm-segbtn--active):active { background: var(--dtm-border2); }\n\n/* \u2500\u2500\u2500 \u30D5\u30A9\u30FC\u30E0\u8981\u7D20 \u2500\u2500\u2500 */\n.dtm-select, .dtm-input, .dtm-textarea {\n  min-height: var(--dtm-tap);\n  padding: 4px 8px;\n  border: 2px solid var(--dtm-border2);\n  background: var(--dtm-deep);\n  color: var(--dtm-text);\n  font-family: var(--dtm-font);\n  font-size: 13px;\n  letter-spacing: .06em;\n  box-shadow: inset 2px 2px 0 var(--c-black);\n}\n.dtm-select:focus, .dtm-input:focus, .dtm-textarea:focus {\n  outline: none;\n  border-color: var(--dtm-primary);\n}\n.dtm-input--num { width: 64px; text-align: center; font-size: 16px; }\n/* \u4ED6\u306E\u30B3\u30F3\u30C8\u30ED\u30FC\u30EB\u3068\u540C\u3058\u884C\u306B\u7F6E\u304F\u30D7\u30EB\u30C0\u30A6\u30F3\uFF08\u697D\u5668\u30FB\u6B4C\u5531\u30E2\u30C7\u30EB\uFF09 */\n.dtm-select--half { flex: 1 1 120px; min-width: 0; max-width: 200px; }\n.dtm-textarea { width: 100%; min-height: 56px; resize: vertical; line-height: 1.7; }\n.dtm-textarea.dtm-grow { width: 0; }\n.dtm-range { height: var(--dtm-tap); accent-color: var(--dtm-primary); }\n.dtm-range:disabled { opacity: .35; cursor: default; }\n\n/* \u2500\u2500\u2500 \u30B3\u30F3\u30C8\u30ED\u30FC\u30EB\u30D0\u30FC\uFF08\u697D\u5668\u30D7\u30EA\u30BB\u30C3\u30C8 / \u30E2\u30FC\u30C9\u5207\u66FF\u306A\u3069\u306E\u5DEE\u3057\u8FBC\u307FUI\uFF09 \u2500\u2500\u2500 */\n.dtm-controlbar {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: var(--dtm-gap);\n  padding: 6px 8px;\n  background: var(--dtm-deep);\n  border: 2px solid var(--c-black);\n  box-shadow:\n    inset 0 0 0 2px var(--c-black),\n    0 0 0 2px var(--dtm-border2),\n    4px 4px 0 var(--c-black);\n  margin-bottom: var(--dtm-gap);\n}\n.dtm-controlbar-label {\n  font-family: var(--dtm-font);\n  font-size: 11px;\n  text-transform: uppercase;\n  letter-spacing: .14em;\n  color: var(--dtm-accent);\n  white-space: nowrap;\n  flex-shrink: 0;\n}\n.dtm-controlbar .dtm-select { flex: 1 1 160px; }\n\n/* \u30E2\u30FC\u30C9\u5207\u66FF\uFF08\u30C6\u30AD\u30B9\u30C8\u7248\u30BB\u30B0\u30E1\u30F3\u30C8\uFF09 */\n.dtm-modeseg {\n  display: inline-flex;\n  border: 2px solid var(--dtm-border2);\n  box-shadow: 3px 3px 0 var(--c-black);\n}\n.dtm-modebtn {\n  min-height: var(--dtm-tap);\n  padding: 0 14px;\n  border: none;\n  border-right: 2px solid var(--dtm-border2);\n  background: var(--dtm-deep);\n  color: var(--dtm-muted);\n  font-family: var(--dtm-font);\n  font-size: 11px;\n  text-transform: uppercase;\n  letter-spacing: .12em;\n  cursor: pointer;\n}\n.dtm-modebtn:last-child { border-right: none; }\n.dtm-modebtn--active { background: var(--dtm-primary); color: var(--dtm-pfg); }\n.dtm-modebtn:not(.dtm-modebtn--active):active { background: var(--dtm-border2); }\n\n/* \u2500\u2500\u2500 \u30C8\u30E9\u30C3\u30AF\u30D4\u30EB\uFF08\u756A\u53F7\u30DC\u30BF\u30F3\u3001\u30C8\u30E9\u30F3\u30B9\u30DD\u30FC\u30C8\u30D0\u30FC2\u884C\u76EE\uFF09 \u2500\u2500\u2500 */\n.dtm-tracks {\n  flex-basis: 100%;\n  display: flex;\n  flex-wrap: nowrap;\n  gap: 4px;\n  align-items: flex-end;\n}\n.dtm-pill {\n  --dtm-pill-color: var(--dtm-primary);\n  position: relative;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  flex: 1 1 0;\n  min-width: 0;\n  height: 24px;\n  padding: 0;\n  border: 2px solid var(--c-black);\n  background: color-mix(in srgb, var(--dtm-pill-color) 22%, #0e121e);\n  color: color-mix(in srgb, var(--c-white) 60%, transparent);\n  font-family: var(--dtm-font);\n  font-size: 11px;\n  font-weight: bold;\n  cursor: pointer;\n  box-shadow: 1px 1px 0 var(--c-black);\n  opacity: 0.55;\n  transition: opacity 120ms ease, background 120ms ease, transform 120ms ease;\n}\n.dtm-pill:hover:not(.dtm-pill--active) {\n  opacity: 0.85;\n  background: color-mix(in srgb, var(--dtm-pill-color) 45%, #0e121e);\n  color: var(--c-white);\n}\n/* \u30A2\u30AF\u30C6\u30A3\u30D6\u9078\u629E = \u9BAE\u660E\u306A\u30C8\u30E9\u30C3\u30AF\u8272 + \u30B4\u30FC\u30EB\u30C9\u67A0 + \u30B0\u30ED\u30FC + \u4E0A\u6607\u7ACB\u4F53\u30BF\u30D6\u8868\u73FE */\n.dtm-pill--active {\n  opacity: 1;\n  height: 28px;\n  background: var(--dtm-pill-color);\n  color: #ffffff;\n  text-shadow: 1px 1px 0 #000, -1px -1px 0 #000, 1px -1px 0 #000, -1px 1px 0 #000;\n  border-color: var(--dtm-gold);\n  box-shadow:\n    0 0 0 1.5px var(--dtm-gold),\n    0 0 10px color-mix(in srgb, var(--dtm-pill-color) 70%, transparent),\n    2px 2px 0 var(--c-black);\n  z-index: 1;\n  transform: translateY(-2px);\n}\n.dtm-pill--active::before {\n  content: '';\n  position: absolute;\n  top: -2px;\n  left: 2px;\n  right: 2px;\n  height: 2px;\n  background: #ffffff;\n  border-radius: 1px;\n  opacity: 0.85;\n}\n.dtm-pill:not(.dtm-pill--active):active { transform: translate(1px,1px); box-shadow: none; }\n/* \u30DC\u30FC\u30AB\u30EB\u304C\u9078\u629E\u3055\u308C\u3066\u3044\u308B\u30C8\u30E9\u30C3\u30AF\u306E\u30BF\u30D6\u306B\u3001\u3046\u3063\u3059\u3089\u58F0\u306E\u30A2\u30A4\u30B3\u30F3\u3092\u91CD\u306D\u308B\uFF08\u80CC\u666F\u8272\u30FB\u30B5\u30A4\u30BA\u306F\u5909\u3048\u306A\u3044\uFF09 */\n.dtm-pill--vocal::after {\n  content: '';\n  position: absolute;\n  inset: 0;\n  background-image: var(--dtm-pill-icon);\n  background-size: contain;\n  background-repeat: no-repeat;\n  background-position: right center;\n  opacity: 0.4;\n  pointer-events: none;\n}\n.dtm-pill__label {\n  position: relative;\n  z-index: 1;\n}\n/* \u518D\u751F\u4E2D\u3001\u5B9F\u969B\u306B\u767A\u97F3\u3057\u305F\u77AC\u9593\u3060\u3051\u70B9\u706F\uFF08\u3069\u306E\u30BF\u30D6\u304C\u4ECA\u9CF4\u3063\u3066\u3044\u308B\u304B\u8996\u899A\u7684\u306B\u5206\u304B\u308B\u3088\u3046\u306B\uFF09 */\n.dtm-pill--sounding {\n  filter: brightness(1.6);\n  transition: filter 30ms linear;\n}\n\n/* \u2500\u2500\u2500 \u30D4\u30A2\u30CE\u30ED\u30FC\u30EB\uFF08\u30C8\u30E9\u30C3\u30AB\u30FC\u98A8\uFF09 \u2500\u2500\u2500 */\n.dtm-roll-wrap { display: flex; gap: var(--dtm-gap); }\n.dtm-roll {\n  position: relative;\n  flex: 1 1 auto;\n  height: 32vh;\n  max-height: 32vh;\n  background: var(--dtm-deep);\n  border: 2px solid var(--c-black);\n  box-shadow:\n    inset 0 0 0 2px var(--c-black),\n    0 0 0 2px var(--dtm-border2),\n    4px 4px 0 var(--c-black);\n  overflow: hidden;\n}\n/* \u30AB\u30B9\u30BF\u30E0\u80CC\u666F\u753B\u50CF\u30EC\u30A4\u30E4\u30FC\uFF08\u753B\u50CF\u81EA\u4F53\u3092\u534A\u900F\u660E\u5316\u3057\u3001\u30AD\u30E3\u30F3\u30D0\u30B9\u5074\u306E\u5857\u308A\u306F\u7DAD\u6301\uFF09 */\n.dtm-roll::before {\n  content: '';\n  position: absolute;\n  inset: 0;\n  background-image: var(--dtm-roll-bg-image, none);\n  background-size: cover;\n  background-position: center;\n  background-repeat: no-repeat;\n  opacity: var(--dtm-roll-bg-opacity, 0.4);\n  pointer-events: none;\n}\n.dtm-vscroll {\n  position: relative;\n  width: 20px;\n  background: var(--dtm-deep);\n  border: 2px solid var(--dtm-border2);\n  cursor: pointer;\n  flex: 0 0 auto;\n  touch-action: none;\n}\n.dtm-vscroll-thumb, .dtm-hscroll-thumb {\n  position: absolute;\n  background: var(--dtm-primary);\n  min-width: 20px;\n  min-height: 20px;\n}\n.dtm-vscroll-thumb { left: 0; width: 100%; }\n.dtm-hscroll {\n  position: relative;\n  width: 100%; height: 20px;\n  background: var(--dtm-deep);\n  border: 2px solid var(--dtm-border2);\n  cursor: pointer;\n  touch-action: none;\n}\n.dtm-hscroll-thumb { top: 0; height: 100%; }\n\n/* \u2500\u2500\u2500 \u30D1\u30CD\u30EB\uFF08RPG\u30C0\u30A4\u30A2\u30ED\u30B0\u30A6\u30A3\u30F3\u30C9\u30A6\uFF09 \u2500\u2500\u2500 */\n.dtm-panel {\n  background: var(--dtm-surface);\n  border: 2px solid var(--c-black);\n  box-shadow:\n    inset 0 0 0 2px var(--c-black),\n    0 0 0 2px var(--dtm-primary),\n    4px 4px 0 var(--c-black);\n  overflow: hidden;\n}\n.dtm-panel > summary {\n  list-style: none;\n  cursor: pointer;\n  padding: 0 12px;\n  font-family: var(--dtm-font);\n  font-size: 12px;\n  text-transform: uppercase;\n  letter-spacing: .14em;\n  display: flex;\n  align-items: center;\n  min-height: var(--dtm-tap);\n  background: var(--dtm-deep);\n  border-bottom: 2px solid var(--dtm-border2);\n  color: var(--dtm-primary);\n  gap: 8px;\n}\n.dtm-panel:not([open]) > summary { border-bottom: none; }\n.dtm-panel > summary::-webkit-details-marker { display: none; }\n/* \u5DE6\u7AEF\u30E9\u30A4\u30F3\uFF08\u30B2\u30FC\u30E0UI\u306E\u30BB\u30AF\u30B7\u30E7\u30F3\u8272\u5206\u3051\uFF09 */\n.dtm-panel > summary::before {\n  content: '';\n  display: block;\n  width: 4px;\n  height: 20px;\n  background: var(--dtm-accent);\n  flex: 0 0 auto;\n}\n.dtm-panel[open] > summary::before { background: var(--dtm-primary); }\n/* \u6298\u308A\u305F\u305F\u307F\u77E2\u5370 */\n.dtm-panel > summary::after {\n  content: \"\u25B6\";\n  margin-left: auto;\n  color: var(--dtm-muted);\n  font-size: 10px;\n}\n.dtm-panel[open] > summary::after { content: \"\u25BC\"; }\n.dtm-panel-body { padding: 10px 12px 12px; display: flex; flex-direction: column; gap: 10px; }\n.dtm-row { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; }\n.dtm-track-body { display: flex; flex-direction: column; gap: 10px; }\n\n/* \u2500\u2500\u2500 \u81EA\u52D5\u4F5C\u66F2\u30D1\u30CD\u30EB\uFF08\u770B\u677F\u6A5F\u80FD\u306A\u306E\u3067\u67A0\u3068\u898B\u51FA\u3057\u3092 success \u8272\u3067\u5DEE\u5225\u5316\u3059\u308B\uFF09 \u2500\u2500\u2500 */\n.dtm-panel--compose {\n  box-shadow:\n    inset 0 0 0 2px var(--c-black),\n    0 0 0 2px var(--dtm-success),\n    4px 4px 0 var(--c-black);\n}\n.dtm-panel--compose > summary { color: var(--dtm-success); }\n.dtm-panel--compose > summary::before,\n.dtm-panel--compose[open] > summary::before {\n  background: var(--dtm-success);\n}\n\n/* \u2500\u2500\u2500 \u30A2\u30AF\u30C6\u30A3\u30D6\u30C8\u30E9\u30C3\u30AF\u8272\uFF08\u500B\u5225\u30C8\u30E9\u30C3\u30AF\u8A2D\u5B9A\u30D1\u30CD\u30EB\u306E\u5DE6\u7AEF\u30E9\u30A4\u30F3\uFF09 \u2500\u2500\u2500 */\n.dtm-panel--track > summary::before,\n.dtm-panel--track[open] > summary::before {\n  background: var(--dtm-track-color, var(--dtm-primary));\n}\n\n/* \u2500\u2500\u2500 MML\u51FA\u529B\uFF08CRT\u30BF\u30FC\u30DF\u30CA\u30EB\uFF09 \u2500\u2500\u2500 */\n.dtm-output {\n  background: var(--c-black);\n  color: var(--dtm-success);\n  border: 2px solid var(--dtm-success);\n  padding: 10px;\n  box-shadow: 0 0 0 2px var(--c-black), 4px 4px 0 var(--c-black);\n}\n.dtm-output::before {\n  content: \"C:\\> MML OUTPUT\";\n  display: block;\n  font-size: 11px;\n  color: var(--dtm-muted);\n  letter-spacing: .14em;\n  margin-bottom: 6px;\n  padding-bottom: 6px;\n  border-bottom: 1px solid var(--dtm-border2);\n}\n.dtm-output pre {\n  margin: 0;\n  background: transparent;\n  padding: 0;\n  overflow-x: auto;\n  font-family: var(--dtm-font);\n  font-size: 12px;\n  line-height: 1.8;\n  color: var(--dtm-success);\n}\n.dtm-output-label {\n  font-size: 11px;\n  color: var(--dtm-muted);\n  font-family: var(--dtm-font);\n  margin-top: 10px;\n}\n.dtm-output-label:first-of-type {\n  margin-top: 0;\n}\n.dtm-output-row { display: flex; gap: 8px; align-items: flex-start; margin-top: 6px; }\n.dtm-output-row pre { flex: 1; }\n.dtm-output-scroll { max-height: 240px; overflow-y: auto; }\n\n/* \u2500\u2500\u2500 \u30ED\u30FC\u30C7\u30A3\u30F3\u30B0\u30AA\u30FC\u30D0\u30FC\u30EC\u30A4 \u2500\u2500\u2500 */\n.dtm-overlay {\n  position: absolute; inset: 0; z-index: 10;\n  background: rgba(0,0,0,.92);\n  display: flex; align-items: center; justify-content: center;\n  flex-direction: column; gap: 14px;\n  pointer-events: auto;\n  cursor: wait;\n}\n.dtm-overlay[hidden] { display: none; }\n.dtm-overlay::before {\n  content: '\u30ED\u30FC\u30C9\u4E2D';\n  font-family: var(--dtm-font);\n  font-size: 13px;\n  color: var(--dtm-primary);\n  text-transform: uppercase;\n  letter-spacing: .25em;\n  animation: dtm-blink 1s steps(1) infinite;\n}\n/* 8\u30D6\u30ED\u30C3\u30AF\u523B\u307F\u3067\u57CB\u307E\u308B\u30D4\u30AF\u30BB\u30EB\u30D0\u30FC */\n.dtm-spinner {\n  width: 96px; height: 12px;\n  position: relative;\n  background: var(--c-navy);\n  border: 2px solid var(--dtm-primary);\n  box-shadow: 0 0 0 2px var(--c-black), 4px 4px 0 var(--c-black);\n}\n.dtm-spinner::after {\n  content: '';\n  position: absolute;\n  left: 0; top: 0; height: 100%;\n  background: var(--dtm-primary);\n  animation: dtm-load 1.6s steps(8) infinite;\n}\n@keyframes dtm-load { 0%{width:0} 100%{width:100%} }\n/* \u9032\u6357\u304C\u78BA\u5B9A\u3057\u305F\u3089\u7121\u9650\u30EB\u30FC\u30D7\u6F14\u51FA\u3092\u6B62\u3081\u3001\u5B9F\u6E2C\u5024\u3067\u5857\u308A\u3064\u3076\u3059 */\n.dtm-spinner--determinate::after { display: none; }\n.dtm-spinner-fill {\n  position: absolute;\n  left: 0; top: 0; height: 100%;\n  width: 0;\n  background: var(--dtm-primary);\n  transition: width .12s steps(8);\n}\n.dtm-loading-label {\n  font-family: var(--dtm-font);\n  font-size: 11px;\n  color: var(--dtm-primary);\n  letter-spacing: .15em;\n  min-height: 1em;\n}\n.dtm-overlay-skip-btn {\n  margin-top: 12px;\n  min-height: 32px;\n  font-size: 11px;\n  font-family: var(--dtm-font);\n  padding: 0 12px;\n  background: var(--dtm-surface);\n  border: 2px solid var(--dtm-border2);\n  color: var(--dtm-muted);\n  box-shadow: 2px 2px 0 var(--c-black);\n  cursor: pointer;\n  pointer-events: auto;\n}\n.dtm-overlay-skip-btn:hover {\n  color: var(--dtm-text);\n  border-color: var(--dtm-primary);\n}\n.dtm-overlay-skip-btn:active {\n  transform: translate(2px, 2px);\n  box-shadow: none;\n}\n.dtm-overlay-skip-btn:disabled {\n  opacity: .3;\n  cursor: default;\n  box-shadow: none;\n  transform: none;\n}\n.dtm-topbar-loading {\n  display: none;\n  font-family: var(--dtm-font);\n  font-size: 11px;\n  color: var(--dtm-primary);\n  margin-left: 12px;\n  letter-spacing: .15em;\n  align-self: center;\n}\n.dtm-topbar.is-loading .dtm-topbar-loading {\n  display: inline-block;\n}\n.dtm-topbar.is-loading {\n  pointer-events: none;\n  opacity: 0.7;\n}\n\n@keyframes dtm-blink { 0%,100%{opacity:1} 50%{opacity:0} }\n.dtm-blink { animation: dtm-blink 1s steps(1) infinite; }\n\n/* \u2500\u2500\u2500 \u97F3\u5272\u308C\u691C\u77E5\u30D0\u30C3\u30B8 \u2500\u2500\u2500 \u30AF\u30EA\u30C3\u30D7\u767A\u751F\u4E2D\u3060\u3051\u8868\u793A\u3055\u308C\u308B\u8B66\u544A\u30DC\u30BF\u30F3\u3002\u30AF\u30EA\u30C3\u30AF\u3067\u6D88\u305B\u308B\u3002 */\n.dtm-clip-badge {\n  flex: 0 0 auto;\n  min-height: 24px;\n  padding: 0 8px;\n  border: 2px solid var(--c-black);\n  background: var(--dtm-danger);\n  color: var(--c-white);\n  font-family: var(--dtm-font);\n  font-size: 10px;\n  letter-spacing: .1em;\n  cursor: pointer;\n  box-shadow: 0 0 0 2px var(--dtm-danger), 2px 2px 0 var(--c-black);\n  animation: dtm-blink .5s steps(1) infinite;\n}\n.dtm-clip-badge:active { transform: translate(2px,2px); box-shadow: none; }\n\n/* \u2500\u2500\u2500 \u30A4\u30F3\u30D5\u30A9\u30DC\u30BF\u30F3 \u2500\u2500\u2500 */\n.dtm-infobtn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 20px;\n  height: 20px;\n  flex: 0 0 auto;\n  border: 2px solid var(--dtm-border2);\n  background: var(--dtm-surface);\n  color: var(--dtm-muted);\n  cursor: pointer;\n  box-shadow: 1px 1px 0 var(--c-black);\n  padding: 0;\n  margin: 0;\n}\n.dtm-infobtn:hover {\n  color: var(--dtm-primary);\n  border-color: var(--dtm-primary);\n}\n.dtm-infobtn:active {\n  transform: translate(1px, 1px);\n  box-shadow: none;\n}\n\n/* \u2500\u2500\u2500 \u89E3\u8AAC\u30E2\u30FC\u30C0\u30EB \u2500\u2500\u2500 */\n.dtm-modal-overlay {\n  position: fixed;\n  inset: 0;\n  z-index: 10000;\n  background: rgba(0, 0, 0, 0.7);\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: 16px;\n  backdrop-filter: blur(2px);\n  /* body\u76F4\u4E0B\u306B\u91CD\u306D\u305F\u5834\u5408\uFF08\u518D\u751F\u5C02\u7528\u30D3\u30E5\u30FC\uFF09\u3067\u3082\u6587\u5B57\u8272\u30FB\u30D5\u30A9\u30F3\u30C8\u304C\n     .dtm-daw \u304B\u3089\u7D99\u627F\u3067\u304D\u306A\u3044\u305F\u3081\u3001\u3053\u3053\u3067\u660E\u793A\u3059\u308B\u3002 */\n  color: var(--dtm-text);\n  font-family: var(--dtm-font);\n}\n.dtm-modal-overlay[hidden] {\n  display: none !important;\n}\n\n/* \u2500\u2500\u2500 \u5229\u7528\u898F\u7D04\u540C\u610F\u30AB\u30D0\u30FC \u2500\u2500\u2500 */\n.dtm-consent-overlay {\n  position: fixed;\n  inset: 0;\n  z-index: 10100;\n  background: rgba(0, 0, 0, 0.6);\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: 16px;\n  backdrop-filter: blur(2px);\n  /* body\u76F4\u4E0B\u306B\u91CD\u306D\u308B\u305F\u3081 .dtm-daw \u304B\u3089\u7D99\u627F\u3067\u304D\u306A\u3044\u6587\u5B57\u8272\u30FB\u30D5\u30A9\u30F3\u30C8\u3092\u660E\u793A\u3002 */\n  color: var(--dtm-text);\n  font-family: var(--dtm-font);\n}\n.dtm-consent-overlay[hidden] {\n  display: none !important;\n}\n.dtm-consent-modal {\n  max-width: 450px;\n  width: 100%;\n  max-height: 85vh;\n  display: flex;\n  flex-direction: column;\n  background: var(--dtm-surface);\n  border: 2px solid var(--c-black);\n  box-shadow:\n    inset 0 0 0 2px var(--c-black),\n    0 0 0 2px var(--dtm-primary),\n    4px 4px 0 var(--c-black);\n  overflow-y: auto;\n}\n.dtm-consent-header {\n  background: var(--dtm-deep);\n  color: var(--dtm-text);\n  padding: 8px 12px;\n  border-bottom: 2px solid var(--c-black);\n  font-weight: bold;\n  text-align: center;\n  font-size: 14px;\n}\n.dtm-consent-body {\n  padding: 12px 16px;\n  font-size: 13px;\n  line-height: 1.6;\n}\n.dtm-consent-body a {\n  color: var(--dtm-primary);\n  text-decoration: underline;\n}\n.dtm-consent-body a:hover {\n  color: var(--dtm-accent);\n}\n.dtm-consent-footer {\n  padding: 8px;\n  border-top: 2px solid var(--c-black);\n  background: var(--dtm-deep);\n  display: flex;\n  justify-content: center;\n}\n\n.dtm-confirm-footer {\n  padding: 8px 12px;\n  border-top: 2px solid var(--c-black);\n  background: var(--dtm-deep);\n  display: flex;\n  gap: 8px;\n  justify-content: flex-end;\n}\n\n.dtm-modal {\n  max-width: 500px;\n  width: 100%;\n  max-height: 80vh;\n  display: flex;\n  flex-direction: column;\n  background: var(--dtm-surface);\n  border: 2px solid var(--c-black);\n  box-shadow:\n    inset 0 0 0 2px var(--c-black),\n    0 0 0 2px var(--dtm-primary),\n    4px 4px 0 var(--c-black);\n  overflow: hidden;\n}\n.dtm-modal-header {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  background: var(--dtm-deep);\n  padding: 8px 12px;\n  border-bottom: 2px solid var(--c-black);\n}\n.dtm-modal-title {\n  font-family: var(--dtm-font);\n  font-size: 14px;\n  color: var(--dtm-gold);\n  font-weight: bold;\n}\n.dtm-modal-close {\n  background: transparent;\n  border: none;\n  color: var(--dtm-text);\n  font-size: 20px;\n  cursor: pointer;\n  padding: 0;\n  line-height: 1;\n}\n.dtm-modal-close:hover {\n  color: var(--dtm-danger);\n}\n.dtm-modal-body {\n  padding: 12px;\n  overflow-y: auto;\n  overflow-x: hidden;\n  font-size: 13px;\n  line-height: 1.6;\n}\n.dtm-modal-body * {\n  max-width: 100%;\n  box-sizing: border-box;\n}\n.dtm-modal-body a {\n  color: var(--dtm-primary);\n  text-decoration: underline;\n}\n.dtm-modal-body a:hover {\n  color: var(--dtm-accent);\n}\n.dtm-modal-body h4 {\n  margin: 12px 0 6px 0;\n  color: var(--dtm-primary);\n  font-size: 13px;\n}\n.dtm-modal-body h4:first-child {\n  margin-top: 0;\n}\n.dtm-modal-body p {\n  margin: 0 0 8px 0;\n}\n.dtm-modal-body ul {\n  margin: 0 0 8px 0;\n  padding-left: 16px;\n}\n.dtm-modal-body li {\n  margin-bottom: 4px;\n}\n.dtm-modal-body code {\n  background: var(--dtm-deep);\n  color: var(--dtm-accent);\n  padding: 1px 4px;\n  font-family: var(--dtm-font);\n  font-size: 12px;\n}\n.dtm-modal-body pre {\n  background: var(--dtm-deep);\n  color: var(--dtm-success);\n  padding: 8px;\n  border: 1px solid var(--dtm-border2);\n  margin: 6px 0;\n  overflow-x: auto;\n  font-family: var(--dtm-font);\n  font-size: 12px;\n}\n\n.dtm-modal-sample-box {\n  background: var(--dtm-deep);\n  border: 1px solid var(--dtm-border2);\n  border-radius: 4px;\n  padding: 8px 10px;\n  margin-bottom: 12px;\n}\n.dtm-modal-sample-box:last-child {\n  margin-bottom: 0;\n}\n.dtm-modal-sample-header {\n  display: flex;\n  justify-content: space-between;\n  align-items: center;\n  margin-bottom: 6px;\n}\n.dtm-modal-sample-tag {\n  font-family: var(--dtm-font);\n  font-size: 11px;\n  font-weight: bold;\n  color: var(--dtm-accent);\n}\n.dtm-modal-sample-desc {\n  margin: 6px 0 0 0;\n  font-size: 11px;\n  color: var(--dtm-muted);\n}\n.dtm-modal-sample-player-container {\n  margin-top: 8px;\n}\n.dtm-modal-sample-player-container:empty {\n  margin-top: 0;\n}\n.dtm-modal-sample-player-container .dtm-player {\n  border: 1px solid var(--dtm-border2);\n  box-shadow: none;\n  background: rgba(0, 0, 0, 0.3);\n}\n.dtm-modal-sample-player-container .dtm-player-body {\n  max-height: 100px;\n  overflow-y: auto;\n}\n\n/* \u2500\u2500\u2500 \u30AC\u30A4\u30C9\u30C4\u30A2\u30FC\uFF08\u30B9\u30DD\u30C3\u30C8\u30E9\u30A4\u30C8\u578B\u30A6\u30A9\u30FC\u30AF\u30B9\u30EB\u30FC\uFF09 \u2500\u2500\u2500 */\n/* \u6697\u5E55\u306F .dtm-tour-spot \u306E\u5DE8\u5927\u306A box-shadow \u3067\u63CF\u304F\u3002box-shadow \u306F\u5F53\u305F\u308A\u5224\u5B9A\u3092\n   \u6301\u305F\u306A\u3044\u306E\u3067\u3001\u7D20\u901A\u308A\u3092\u9632\u3050\u906E\u853D\u306F .dtm-tour\uFF08\u5168\u753B\u9762\uFF09\u5074\u304C\u62C5\u5F53\u3059\u308B\u3002 */\n.dtm-tour {\n  position: fixed;\n  inset: 0;\n  z-index: 10050;\n  color: var(--dtm-text);\n  font-family: var(--dtm-font);\n  font-size: 13px;\n  line-height: 1.6;\n  letter-spacing: .04em;\n  -webkit-font-smoothing: none;\n  font-smooth: never;\n  -webkit-tap-highlight-color: transparent;\n}\n.dtm-tour * { box-sizing: border-box; max-width: 100%; }\n.dtm-tour-spot {\n  position: fixed;\n  left: 0;\n  top: 0;\n  width: 0;\n  height: 0;\n  pointer-events: none;\n  border: 2px solid var(--dtm-gold);\n  box-shadow: 0 0 0 9999px rgba(0, 0, 0, 0.74);\n  transition: left .18s ease, top .18s ease, width .18s ease, height .18s ease;\n}\n.dtm-tour-bubble {\n  position: fixed;\n  left: 0;\n  top: 0;\n  display: flex;\n  flex-direction: column;\n  background: var(--dtm-surface);\n  border: 2px solid var(--c-black);\n  box-shadow:\n    inset 0 0 0 2px var(--c-black),\n    0 0 0 2px var(--dtm-primary),\n    4px 4px 0 var(--c-black);\n  transition: left .18s ease, top .18s ease;\n}\n.dtm-tour-head {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  background: var(--dtm-deep);\n  padding: 4px 8px;\n  border-bottom: 2px solid var(--c-black);\n}\n.dtm-tour-progress {\n  font-size: 11px;\n  color: var(--dtm-muted);\n}\n.dtm-tour-close {\n  background: transparent;\n  border: none;\n  color: var(--dtm-text);\n  font-size: 18px;\n  line-height: 1;\n  padding: 0 2px;\n  cursor: pointer;\n}\n.dtm-tour-close:hover { color: var(--dtm-danger); }\n.dtm-tour-title {\n  padding: 8px 10px 0;\n  color: var(--dtm-gold);\n  font-size: 14px;\n  font-weight: bold;\n}\n.dtm-tour-body {\n  padding: 6px 10px 8px;\n  max-height: 40vh;\n  overflow-y: auto;\n}\n.dtm-tour-body p { margin: 0 0 6px; }\n.dtm-tour-body p:last-child { margin-bottom: 0; }\n.dtm-tour-body ul { margin: 0 0 6px; padding-left: 16px; }\n.dtm-tour-body li { margin-bottom: 3px; }\n.dtm-tour-body b { color: var(--dtm-primary); }\n.dtm-tour-foot {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  padding: 6px 8px;\n  border-top: 2px solid var(--c-black);\n  background: var(--dtm-deep);\n}\n.dtm-tour-spacer { flex: 1; }\n.dtm-tour-btn {\n  min-height: 32px;\n  padding: 0 10px;\n  border: 2px solid var(--dtm-border2);\n  background: var(--dtm-surface);\n  color: var(--dtm-text);\n  font-family: var(--dtm-font);\n  font-size: 12px;\n  letter-spacing: .04em;\n  cursor: pointer;\n  box-shadow: 2px 2px 0 var(--c-black);\n}\n.dtm-tour-btn:active { transform: translate(2px, 2px); box-shadow: none; }\n.dtm-tour-btn--ghost { background: transparent; }\n.dtm-tour-btn--primary {\n  border-color: var(--dtm-primary);\n  background: var(--dtm-primary);\n  color: var(--dtm-pfg);\n}\n\n/* \u76EE\u7684\u5225\u306E\u5206\u5C90\uFF08\u30C4\u30A2\u30FC\u5192\u982D\u306E\u300C\u4F55\u3092\u3057\u3066\u307F\u305F\u3044\uFF1F\u300D\uFF09\u3002 */\n.dtm-tour-branches {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n  margin-top: 8px;\n}\n.dtm-tour-branch {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 2px;\n  width: 100%;\n  min-height: var(--dtm-tap);\n  padding: 6px 10px;\n  border: 2px solid var(--dtm-primary);\n  background: var(--dtm-surface);\n  color: var(--dtm-text);\n  font-family: var(--dtm-font);\n  font-size: 13px;\n  letter-spacing: .04em;\n  text-align: left;\n  cursor: pointer;\n  box-shadow: 2px 2px 0 var(--c-black);\n}\n.dtm-tour-branch:active { transform: translate(2px, 2px); box-shadow: none; }\n.dtm-tour-branch-label { color: var(--dtm-primary); }\n.dtm-tour-branch-hint { font-size: 11px; color: var(--dtm-muted); }\n\n/* \u2500\u2500\u2500 \u30D8\u30EB\u30D7\u306E\u30CF\u30D6\uFF08\u300C?\u300D\u30DC\u30BF\u30F3\u306E\u30E2\u30FC\u30C0\u30EB\uFF09 \u2500\u2500\u2500 */\n.dtm-help-goals {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n  margin: 6px 0 4px;\n}\n/* \u76EE\u7684\u30DC\u30BF\u30F3\u306F\u898B\u51FA\u3057\u3068\u88DC\u8DB3\u306E2\u6BB5\u7D44\u307F\u306B\u3059\u308B\u3002.dtm-btn \u306F1\u884C\u524D\u63D0\u306E\n   inline-flex \u306A\u306E\u3067\u3001\u3053\u3053\u3060\u3051\u7E26\u4E26\u3073\u30FB\u5DE6\u5BC4\u305B\u30FB\u9AD8\u3055\u81EA\u52D5\u306B\u4E0A\u66F8\u304D\u3059\u308B\u3002 */\n.dtm-help-goals .dtm-btn {\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 1px;\n  width: 100%;\n  height: auto;\n  padding: 6px 10px;\n  text-align: left;\n  white-space: normal;\n}\n.dtm-help-goals .dtm-btn small {\n  font-size: 11px;\n  opacity: .8;\n  font-weight: normal;\n}\n.dtm-help-topics {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 6px;\n  margin-top: 6px;\n}\n.dtm-help-topics .dtm-btn {\n  min-height: 32px;\n  padding: 0 8px;\n  font-size: 12px;\n}\n\n.dtm-hidden { display: none !important; }\n/* \u8AAD\u8FBC\u6642\u306E\u8B66\u544A\u304A\u77E5\u3089\u305B\uFF08\u4F8B: \u30B7\u30F3\u30D7\u30EB\u30E2\u30FC\u30C9\u3067\u306E\u30C8\u30E9\u30C3\u30AF\u5408\u7B97\uFF09\u3002 */\n.dtm-load-note {\n  margin: 6px 0 0;\n  padding: 0 2px;\n  font-family: var(--dtm-font);\n  font-size: 11px;\n  line-height: 1.5;\n  letter-spacing: .04em;\n  color: var(--dtm-warn); /* \u8B66\u544A\u8272\uFF08\u30AA\u30EC\u30F3\u30B8\uFF09 */\n  font-weight: bold;\n  opacity: 1.0;\n}\n.dtm-load-note::before { content: \"\u26A0 \"; }\n/* \u4F34\u594F\u97F3\u6E90\uFF08mp3/wav/YouTube\uFF09\u306E\u72B6\u614B\u8868\u793A\u3002\u8AAD\u307F\u8FBC\u307F\u7D50\u679C\u306E\u5831\u544A\u306A\u306E\u3067\u8B66\u544A\u8272\u306B\u306F\u3057\u306A\u3044\u3002 */\n.dtm-audio-note {\n  margin: 6px 0 0;\n  padding: 0 2px;\n  font-family: var(--dtm-font);\n  font-size: 11px;\n  line-height: 1.5;\n  letter-spacing: .04em;\n  color: var(--dtm-muted);\n}\n.dtm-audio-note--warn { color: var(--dtm-warn); font-weight: bold; }\n/* YouTube\u30D7\u30EC\u30A4\u30E4\u30FC\u306E\u67A0\u3002API\u304C\u4E2D\u306E\u8981\u7D20\u3092 iframe \u3078\u5DEE\u3057\u66FF\u3048\u308B\u306E\u3067\u3001\u67A0\u5074\u3067\u5BF8\u6CD5\u3092\u6C7A\u3081\u308B\u3002 */\n.dtm-audio-yt { width: 100%; max-width: 320px; aspect-ratio: 16 / 9; }\n.dtm-audio-yt iframe { display: block; width: 100%; height: 100%; border: 0; }\n.dtm-grow { flex: 1 1 auto; }\n.dtm-lyric-icon {\n  flex: 0 0 auto;\n  width: 20px;\n  height: 20px;\n  border-radius: 50%;\n  object-fit: cover;\n  image-rendering: pixelated;\n}\n/* \u6B4C\u8A5E\u30C8\u30E9\u30C3\u30AF\u306E\u300C\u8A73\u7D30\u8A2D\u5B9A\u300D\u2014 \u5E38\u7528\u3057\u306A\u3044\u30D1\u30E9\u30E1\u30FC\u30BF\uFF08\u30AA\u30AF\u30BF\u30FC\u30D6/\u5B9A\u4F4D/\u30EA\u30D0\u30FC\u30D6\u9001\u308A/\n   \u30B8\u30A7\u30F3\u30C0\u30FC/\u30D6\u30EC\u30B7\u30CD\u30B9/\u30D3\u30D6\u30E9\u30FC\u30C8\uFF09\u3092\u7573\u3093\u3067\u304A\u304F\u8EFD\u91CF\u306A details\u3002dtm-panel \u307B\u3069\n   \u4EF0\u3005\u3057\u304F\u305B\u305A\u3001\u5C0F\u3055\u3044\u25B6\u30DE\u30FC\u30AB\u30FC\u3060\u3051\u4ED8\u3051\u308B\uFF08\u4ED5\u5207\u308A\u7DDA\u306F\u9AD8\u3055\u3092\u98DF\u3046\u306E\u3067\u7F6E\u304B\u306A\u3044\uFF09\u3002 */\n.dtm-advanced {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n}\n.dtm-advanced > summary {\n  list-style: none;\n  cursor: pointer;\n  font-size: 11px;\n  letter-spacing: .08em;\n  color: var(--dtm-text);\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  min-height: 28px;\n  padding: 0 8px;\n  border: 2px solid var(--dtm-border2);\n  background: var(--dtm-deep);\n  box-shadow: 2px 2px 0 var(--c-black);\n  width: fit-content;\n}\n.dtm-advanced > summary:active { transform: translate(2px,2px); box-shadow: none; }\n.dtm-advanced > summary::-webkit-details-marker { display: none; }\n.dtm-advanced > summary::before { content: \"\u25B6\"; font-size: 9px; color: var(--dtm-accent); }\n.dtm-advanced[open] > summary::before { content: \"\u25BC\"; }\n.dtm-advanced[open] > summary { border-color: var(--dtm-primary); color: var(--dtm-primary); }\n\n/* \u2500\u2500\u2500 \u5E83\u5E45\u62E1\u5F35 \u2500\u2500\u2500 */\n@media (min-width: 768px) {\n  .dtm-daw { gap: 8px; padding: 10px; }\n  .dtm-roll { height: 420px; }\n}\n\n/* ====================================================\n   MML PLAYER \u2014 \u518D\u751F\u5C02\u7528\u30D3\u30E5\u30FC\uFF08mountMmlPlayer\uFF09\n   ==================================================== */\n.dtm-player {\n  display: flex;\n  flex-direction: column;\n  gap: var(--dtm-gap);\n  padding: var(--dtm-gap);\n  background: var(--dtm-deep);\n  border: 2px solid var(--dtm-border2);\n  box-shadow: 4px 4px 0 var(--c-black);\n}\n.dtm-player-message {\n  padding: 4px 8px;\n  background: var(--c-purple);\n  color: var(--c-yellow);\n  font-size: 11px;\n  border: 2px solid var(--c-black);\n  box-shadow: inset 0 -2px 0 rgba(0,0,0,0.2);\n  font-family: var(--dtm-font);\n  text-align: center;\n  width: 100%;\n  box-sizing: border-box;\n}\n.dtm-player-head {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  flex-wrap: wrap;\n}\n.dtm-player-play {\n  flex: 0 0 auto;\n  width: 28px;\n  height: 28px;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  background: var(--dtm-primary);\n  color: var(--dtm-pfg);\n  border: 2px solid var(--c-black);\n  box-shadow: 2px 2px 0 var(--c-black);\n  cursor: pointer;\n  padding: 0;\n}\n.dtm-player-play:active { transform: translate(2px, 2px); box-shadow: none; }\n.dtm-player-play--stop { background: var(--dtm-danger); }\n.dtm-player-play:disabled { opacity: 0.4; cursor: default; }\n.dtm-player-loop {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  padding: 0;\n  border: 2px solid var(--dtm-border2);\n  background: var(--dtm-bg);\n  color: var(--dtm-muted);\n  cursor: pointer;\n  flex: 0 0 auto;\n}\n.dtm-player-loop:active { transform: translate(1px, 1px); }\n.dtm-player-loop--on {\n  border-color: var(--c-black);\n  background: var(--dtm-gold);\n  color: var(--c-black);\n  box-shadow: 2px 2px 0 var(--c-black);\n}\n.dtm-player-loop:disabled { opacity: 0.4; cursor: default; }\n.dtm-player-beat-row {\n  display: flex;\n  align-items: center;\n  gap: 4px;\n}\n.dtm-player-beat-dot {\n  width: 8px;\n  height: 8px;\n  border-radius: 50%;\n  background: var(--dtm-border2);\n  transition: background 0.06s;\n}\n.dtm-player-beat-dot--on { background: var(--dtm-primary); }\n.dtm-player-bar {\n  font-family: 'k8x12', monospace;\n  font-size: 11px;\n  color: var(--dtm-text);\n  min-width: 2em;\n  margin-left: 4px;\n}\n.dtm-player-chord {\n  font-family: 'k8x12', monospace;\n  font-size: 11px;\n  color: var(--dtm-accent);\n  min-width: 4em;\n  margin-left: 8px;\n  font-weight: bold;\n}\n.dtm-player-seek-row {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n.dtm-player-seek {\n  --fill: 0%;\n  flex: 1 1 auto;\n  min-width: 0;\n  height: 12px;\n  margin: 0;\n  background: transparent;\n  cursor: pointer;\n  -webkit-appearance: none;\n  appearance: none;\n}\n.dtm-player-seek:disabled { cursor: default; opacity: 0.4; }\n/* \u518D\u751F\u6E08\u307F\u533A\u9593\u3092YouTube\u98A8\u306B\u8272\u5857\u308A\u3059\u308B\uFF08--fill \u306F\u518D\u751F\u4F4D\u7F6E\u306B\u5FDC\u3058\u3066JS\u304B\u3089\u8A2D\u5B9A\uFF09 */\n.dtm-player-seek::-webkit-slider-runnable-track {\n  height: 6px;\n  background: linear-gradient(\n    to right,\n    var(--dtm-primary) var(--fill),\n    var(--dtm-border2) var(--fill)\n  );\n  border: 2px solid var(--c-black);\n}\n.dtm-player-seek::-moz-range-track {\n  height: 6px;\n  background: var(--dtm-border2);\n  border: 2px solid var(--c-black);\n}\n.dtm-player-seek::-moz-range-progress {\n  height: 6px;\n  background: var(--dtm-primary);\n  border: 2px solid var(--c-black);\n  border-right: none;\n}\n.dtm-player-seek::-webkit-slider-thumb {\n  -webkit-appearance: none;\n  width: 12px;\n  height: 16px;\n  margin-top: -7px;\n  background: var(--dtm-primary);\n  border: 2px solid var(--c-black);\n  box-shadow: 2px 2px 0 var(--c-black);\n  cursor: pointer;\n}\n.dtm-player-seek::-moz-range-thumb {\n  width: 12px;\n  height: 16px;\n  background: var(--dtm-primary);\n  border: 2px solid var(--c-black);\n  box-shadow: 2px 2px 0 var(--c-black);\n  cursor: pointer;\n  border-radius: 0;\n}\n.dtm-player-time {\n  flex: 0 0 auto;\n  font-family: 'k8x12', monospace;\n  font-size: 11px;\n  color: var(--dtm-text);\n  white-space: nowrap;\n}\n.dtm-player-dots {\n  margin-left: auto;\n  display: flex;\n  align-items: center;\n  gap: 6px;\n}\n.dtm-player-dot { width: 8px; height: 8px; display: inline-block; }\n.dtm-player-mml-header {\n  margin-left: auto;\n  display: flex;\n  align-items: center;\n  gap: 4px;\n}\n.dtm-player-mml-link {\n  font-family: 'k8x12', monospace;\n  font-size: 10px;\n  color: var(--dtm-muted);\n  text-decoration: none;\n  white-space: nowrap;\n}\n.dtm-player-mml-link:hover { color: var(--dtm-primary); }\n.dtm-player-more-container {\n  position: relative;\n  display: inline-flex;\n  align-items: center;\n}\n.dtm-player-more-btn {\n  background: transparent;\n  border: none;\n  color: var(--dtm-muted);\n  cursor: pointer;\n  padding: 2px;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  border-radius: 50%;\n  width: 24px;\n  height: 24px;\n  transition: color 0.15s, background-color 0.15s;\n}\n.dtm-player-more-btn:hover,\n.dtm-player-more-btn.is-active {\n  color: var(--dtm-text);\n  background: var(--dtm-border2);\n}\n.dtm-player-menu {\n  position: absolute;\n  top: calc(100% + 4px);\n  right: 0;\n  background: var(--dtm-deep);\n  border: 2px solid var(--dtm-border2);\n  box-shadow: 4px 4px 0 var(--c-black);\n  z-index: 200;\n  display: flex;\n  flex-direction: column;\n  padding: 4px 0;\n  min-width: 130px;\n  font-family: var(--dtm-font);\n}\n.dtm-player-menu-item {\n  background: transparent;\n  border: none;\n  color: var(--dtm-text);\n  padding: 6px 12px;\n  text-align: left;\n  cursor: pointer;\n  font-size: 11px;\n  font-family: inherit;\n  white-space: nowrap;\n  width: 100%;\n  box-sizing: border-box;\n  transition: background-color 0.1s, color 0.1s;\n}\n.dtm-player-menu-item:hover {\n  background: var(--dtm-primary);\n  color: var(--dtm-pfg);\n}\n.dtm-player-emoji {\n  position: relative;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 20px;\n  height: 20px;\n  border-radius: 50%;\n  font-size: 18px;\n  line-height: 1;\n  user-select: none;\n}\n.dtm-player-balloon {\n  /* body \u76F4\u4E0B\u306B\u751F\u6210\u3055\u308C\u3001JS(positionBalloon)\u304C\u6BCE\u56DE left/top \u3092\u30A2\u30F3\u30AB\u30FC\u306E\u753B\u9762\u5EA7\u6A19\u3067\n     \u8A2D\u5B9A\u3059\u308B\u3002overflow:hidden \u306A\u7956\u5148\uFF08\u6295\u7A3F\u30AB\u30FC\u30C9\u7B49\uFF09\u306B\u30AF\u30EA\u30C3\u30D7\u3055\u308C\u306A\u3044\u3088\u3046 fixed \u3067\u6D6E\u304B\u305B\u308B\u3002\n     top \u306F\u30A2\u30F3\u30AB\u30FC\u4E0A\u7AEF-6px\u3001transform \u3067\u81EA\u8EAB\u306E\u5DE6\u4E0B\u89D2\u3092\u305D\u306E\u70B9\u306B\u5408\u308F\u305B\u308B\u3002 */\n  position: fixed;\n  left: 0;\n  top: 0;\n  transform: translate(-50%, -100%);\n  z-index: 1000;\n  display: none;\n  pointer-events: none;\n  font-family: var(--dtm-font);\n  font-size: 9px;\n  color: var(--c-black);\n  background: var(--c-white);\n  border: 2px solid var(--c-black);\n  padding: 2px 4px;\n  white-space: nowrap;\n  box-shadow: 2px 2px 0 var(--c-black);\n}\n.dtm-player-balloon::after {\n  content: \"\";\n  position: absolute;\n  bottom: -6px;\n  left: 50%;\n  transform: translateX(-50%) rotate(45deg);\n  width: 8px;\n  height: 8px;\n  background: var(--c-white);\n  border-right: 2px solid var(--c-black);\n  border-bottom: 2px solid var(--c-black);\n}\n/* \u30A2\u30A4\u30B3\u30F3\u304C\u753B\u9762\u4E0A\u7AEF\u306B\u8FD1\u304F\u4E0A\u306B\u51FA\u3059\u4F59\u767D\u304C\u7121\u3044\u5834\u5408\u306F\u4E0B\u306B\u53CD\u8EE2\u8868\u793A\u3059\u308B\uFF08positionBalloon \u304C\u4ED8\u4E0E\uFF09 */\n.dtm-player-balloon--below {\n  transform: translate(-50%, 0);\n}\n.dtm-player-balloon--below::after {\n  bottom: auto;\n  top: -6px;\n  border-right: none;\n  border-bottom: none;\n  border-left: 2px solid var(--c-black);\n  border-top: 2px solid var(--c-black);\n}\n.dtm-player-balloon--visible {\n  display: block;\n  animation: dtm-balloon-fade-in 0.1s steps(2);\n}\n.dtm-player-balloon--below.dtm-player-balloon--visible {\n  animation-name: dtm-balloon-fade-in-below;\n}\n@keyframes dtm-balloon-fade-in {\n  from { opacity: 0; transform: translate(-50%, -100%) translateY(4px); }\n  to { opacity: 1; transform: translate(-50%, -100%) translateY(0); }\n}\n@keyframes dtm-balloon-fade-in-below {\n  from { opacity: 0; transform: translate(-50%, 0) translateY(-4px); }\n  to { opacity: 1; transform: translate(-50%, 0) translateY(0); }\n}\n@keyframes dtm-emoji-jump {\n  0%   { transform: translateY(0); }\n  35%  { transform: translateY(-5px); }\n  65%  { transform: translateY(-5px); }\n  100% { transform: translateY(0); }\n}\n.dtm-player-emoji--jump {\n  animation: dtm-emoji-jump 0.18s ease-out forwards;\n}\n.dtm-player-chip {\n  font-family: 'k8x12', monospace;\n  font-size: 9px;\n  color: var(--dtm-text);\n  background: var(--dtm-border2);\n  padding: 2px 6px;\n  white-space: nowrap;\n}\n.dtm-player-body {\n  position: relative; /* \u30ED\u30FC\u30C7\u30A3\u30F3\u30B0\u30AA\u30FC\u30D0\u30FC\u30EC\u30A4\u306E\u57FA\u6E96\u3002\u30EC\u30FC\u30F3\u7FA4\u3060\u3051\u3092\u8986\u3046 */\n  display: flex;\n  flex-direction: column;\n  gap: var(--dtm-gap);\n}\n.dtm-player-lane-row {\n  position: relative;\n  display: flex;\n  align-items: stretch;\n  gap: 6px;\n}\n.dtm-player-lane-label {\n  position: relative;\n  flex: 0 0 auto;\n  width: 16px;\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  gap: 2px;\n}\n.dtm-player-lane-label--btn {\n  cursor: pointer;\n  user-select: none;\n}\n.dtm-player-lane-label--btn:hover { opacity: 0.7; }\n.dtm-player-lane-label--muted { opacity: 0.3; }\n\n/* \u2500\u2500\u2500 \u30DF\u30E5\u30FC\u30C8\u8868\u793A\uFF08\u6392\u4ED6\u540C\u671F\uFF09 \u2500\u2500\u2500 */\n.dtm-player-emoji.is-muted,\n.dtm-player-lane-label.is-muted {\n  position: relative;\n}\n\n/* \u30DF\u30E5\u30FC\u30C8\u6642\u306E\u300C\u00D7\u300D\u30DE\u30FC\u30AF\u91CD\u306D\u63CF\u304D */\n.dtm-player-emoji.is-muted::before,\n.dtm-player-lane-label.is-muted::before {\n  content: \"\u00D7\";\n  position: absolute;\n  inset: 0;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  color: var(--dtm-danger);\n  font-family: var(--dtm-font);\n  font-size: 16px;\n  font-weight: bold;\n  z-index: 10;\n  pointer-events: none;\n  text-shadow: 1px 1px 0 var(--c-black);\n}\n\n.dtm-player-lane-label.is-muted::before {\n  font-size: 14px;\n}\n\n/* \u30DF\u30E5\u30FC\u30C8\u6642\u306E\u30A2\u30A4\u30B3\u30F3\u3084\u8981\u7D20\u306E\u8584\u6697\u5316\uFF08\u5439\u304D\u51FA\u3057\u306F\u9664\u5916\uFF09 */\n.dtm-player-emoji.is-muted > img,\n.dtm-player-emoji.is-muted > span:not(.dtm-player-balloon) {\n  opacity: 0.25;\n  filter: grayscale(80%);\n}\n\n.dtm-player-lane-label.is-muted {\n  opacity: 0.25;\n}\n\n/* \u30DF\u30E5\u30FC\u30C8\u6642\u306E\u30C8\u30E9\u30C3\u30AF\u30EC\u30FC\u30F3\uFF08\u30B9\u30AF\u30ED\u30FC\u30EB\u90E8\uFF09\u306E\u8584\u6697\u5316\u3068\u30C7\u30AB\u00D7\u30DE\u30FC\u30AF\uFF08\u8272\u5F31\u5BFE\u5FDC\uFF09 */\n.dtm-player-lane-row.is-muted::after {\n  content: \"\u00D7\";\n  position: absolute;\n  top: 0;\n  bottom: 0;\n  left: 22px; /* label width (16px) + gap (6px) */\n  right: 0;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  color: var(--dtm-danger);\n  font-family: var(--dtm-font);\n  font-size: 24px;\n  font-weight: bold;\n  background: rgba(0, 0, 0, 0.45);\n  z-index: 10;\n  pointer-events: none;\n  text-shadow: 1px 1px 0 var(--c-black);\n}\n.dtm-player-lane-no {\n  font-family: 'k8x12', monospace;\n  font-size: 9px;\n  color: var(--dtm-muted);\n}\n.dtm-player-lane {\n  position: relative; /* \u30C8\u30FC\u30AF\u30F3\u306E offsetParent \u3092\u30EC\u30FC\u30F3\u306B\u56FA\u5B9A\u3057\u3001\u4E2D\u592E\u5BC4\u305B\u8A08\u7B97\u3092\u6B63\u3059 */\n  flex: 1 1 auto;\n  overflow-x: auto;\n  overflow-y: hidden;\n  white-space: nowrap;\n  background: var(--c-black);\n  border: none;\n  padding: 0 6px;\n  scrollbar-width: none;\n  display: flex;\n  align-items: center;\n}\n.dtm-player-lane::-webkit-scrollbar { display: none; }\n.dtm-tk {\n  font-family: 'k8x12', monospace;\n  font-size: 12px;\n  color: var(--dtm-text);\n  flex: 0 0 auto;\n}\n.dtm-tk--rest { color: var(--dtm-muted); }\n.dtm-tk--octave,\n.dtm-tk--shift,\n.dtm-tk--length,\n.dtm-tk--ctrl { color: var(--dtm-border2); }\n.dtm-tk--lyric { color: var(--dtm-text); letter-spacing: 1px; }\n/* \u7D99\u7D9A\uFF08\u30FC / \u301C\uFF09\u306F\u300C\u8A00\u3044\u76F4\u3055\u306A\u3044\u300D\u97F3\u3002\u304B\u306A\u3088\u308A\u6DE1\u304F\u3057\u3066\u97F3\u7BC0\u306E\u5207\u308C\u76EE\u3092\u76EE\u3067\u8FFD\u3048\u308B\u3088\u3046\u306B\u3059\u308B */\n.dtm-tk--lyric-tie { color: var(--dtm-muted); }\n/* \u4FC3\u97F3\uFF08\u3063\uFF09\u30FB\u4F11\u7B26\uFF08_\uFF09\u306F\u6B4C\u308F\u306A\u3044\u30CE\u30FC\u30C8\u3002\u3055\u3089\u306B\u843D\u3068\u3057\u3066\u7121\u97F3\u3067\u3042\u308B\u3053\u3068\u3092\u793A\u3059 */\n.dtm-tk--lyric-stop,\n.dtm-tk--lyric-rest { color: var(--dtm-border2); }\n/* \u8A9E\u308A\uFF08\u300C\u2026\u300D\uFF09\u306F\u6B4C\u308F\u305A\u306B\u8AAD\u307F\u4E0A\u3052\u308B 1 \u30CE\u30FC\u30C8\u3002\u6B4C\u8A5E\u3068\u533A\u5225\u3067\u304D\u308B\u3088\u3046\u5F37\u8ABF\u8272\u306B\u3059\u308B */\n.dtm-tk--lyric-speak { color: var(--dtm-primary); letter-spacing: 0; }\n.dtm-tk--break { color: var(--dtm-muted); opacity: 0.7; margin: 0 2px; }\n.dtm-tk--meta { color: var(--dtm-border2); margin-right: 4px; }\n.dtm-tk.is-active {\n  background: var(--tk, var(--dtm-primary));\n  color: var(--c-black);\n  font-weight: bold;\n}\n\n/* \u2500\u2500\u2500 \u30B3\u30FC\u30C9\u9032\u884C\u30D7\u30EC\u30A4\u30E4\u30FC \u2500\u2500\u2500 */\n/* MML\u518D\u751F\u5C02\u7528\u30D7\u30EC\u30A4\u30E4\u30FC\uFF08.dtm-player\uFF09\u3068\u67A0\u30C7\u30B6\u30A4\u30F3\u3092\u63C3\u3048\u308B */\n.dtm-chord-player {\n  display: flex;\n  flex-direction: column;\n  gap: var(--dtm-gap);\n  padding: var(--dtm-gap);\n  font-family: var(--dtm-font);\n  font-size: 13px;\n  letter-spacing: .06em;\n  color: var(--dtm-text);\n  background: var(--dtm-deep);\n  border: 2px solid var(--dtm-border2);\n  box-shadow: 4px 4px 0 var(--c-black);\n  image-rendering: pixelated;\n  -webkit-font-smoothing: none;\n}\n.dtm-chord-player *,\n.dtm-chord-player *::before,\n.dtm-chord-player *::after { box-sizing: border-box; }\n\n/* \u30B3\u30F3\u30C8\u30ED\u30FC\u30EB\u30D0\u30FC \u2014 MML\u518D\u751F\u5C02\u7528\u30D7\u30EC\u30A4\u30E4\u30FC\u306E .dtm-player-head \u3068\u63C3\u3048\u308B */\n.dtm-cp-ctrl {\n  display: flex;\n  align-items: center;\n  flex-wrap: wrap;\n  gap: 8px;\n}\n.dtm-cp-ctrl .dtm-player-more-container {\n  margin-left: auto;\n}\n\n/* \u30EB\u30FC\u30D7\u5207\u66FF\u30DC\u30BF\u30F3 */\n.dtm-cp-loop {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  padding: 0;\n  border: 2px solid var(--dtm-border2);\n  background: var(--dtm-bg);\n  color: var(--dtm-muted);\n  cursor: pointer;\n  flex: 0 0 auto;\n}\n.dtm-cp-loop:active { transform: translate(1px,1px); }\n.dtm-cp-loop--on {\n  border-color: var(--c-black);\n  background: var(--dtm-gold);\n  color: var(--c-black);\n  box-shadow: 2px 2px 0 var(--c-black);\n}\n\n/* \u30E1\u30BF\u60C5\u5831 (BPM) */\n.dtm-cp-meta {\n  font-size: 11px;\n  text-transform: uppercase;\n  letter-spacing: .12em;\n  color: var(--dtm-muted);\n}\n\n/* \u30B9\u30AF\u30ED\u30FC\u30EB\u30A8\u30EA\u30A2 */\n.dtm-cp-scroll {\n  position: relative;\n  max-height: 180px;\n  overflow-y: auto;\n  padding: 8px 10px 10px;\n  scrollbar-width: none;\n  display: flex;\n  flex-direction: column;\n  gap: 3px;\n}\n.dtm-cp-scroll::-webkit-scrollbar { display: none; }\n\n/* \u30BB\u30AF\u30B7\u30E7\u30F3\u898B\u51FA\u3057 \u2014 \u30BB\u30AF\u30B7\u30E7\u30F3\u8272\u306E\u5E2F\u3068\u30D4\u30AF\u30BB\u30EB\u30DE\u30FC\u30AB\u30FC */\n.dtm-cp-section {\n  font-size: 11px;\n  text-transform: uppercase;\n  letter-spacing: .14em;\n  margin-top: 8px;\n  padding: 1px 8px 1px 5px;\n  color: var(--cp-fg, var(--dtm-text));\n  border-left: 4px solid var(--cp-fg, var(--dtm-text));\n  background: linear-gradient(90deg, var(--cp-bg, transparent), transparent);\n  align-self: flex-start;\n}\n.dtm-cp-section::before {\n  content: \"\u25A0\";\n  margin-right: 5px;\n}\n\n/* \u5C0F\u7BC0\u884C */\n.dtm-cp-bar {\n  display: flex;\n  align-items: center;\n  flex-wrap: wrap;\n  gap: 2px;\n  margin-top: 2px;\n}\n\n/* \u5C0F\u7BC0\u533A\u5207\u308A\u30D1\u30A4\u30D7 */\n.dtm-cp-pipe {\n  font-size: 13px;\n  color: rgba(255, 255, 255, 0.35);\n  font-family: var(--dtm-font);\n  font-weight: bold;\n  margin: 0 4px;\n  user-select: none;\n}\n\n/* \u30B3\u30FC\u30C9\u30BB\u30EB \u2014 \u30B2\u30FC\u30E0\u306E\u30DC\u30BF\u30F3\u98A8\u30C1\u30C3\u30D7\uFF08\u30BF\u30C3\u30D7\u3067\u305D\u3053\u304B\u3089\u518D\u751F\uFF09 */\n.dtm-cp-chord {\n  display: inline-block;\n  font-family: var(--dtm-font);\n  font-size: 12px;\n  padding: 2px 5px;\n  border: 2px solid transparent;\n  color: var(--cp-fg, var(--dtm-text));\n  background: var(--cp-bg, transparent);\n  cursor: pointer;\n  user-select: none;\n  -webkit-user-select: none;\n}\n.dtm-cp-chord:not(.dtm-cp-chord--dead):hover {\n  border-color: var(--cp-fg, var(--dtm-text));\n}\n.dtm-cp-chord:not(.dtm-cp-chord--dead):active {\n  transform: translate(1px,1px);\n}\n.dtm-cp-chord:focus-visible {\n  outline: 2px solid var(--c-white);\n  outline-offset: 0;\n}\n.dtm-cp-chord--dead { cursor: default; }\n.dtm-cp-chord--played { opacity: .45; }\n.dtm-cp-chord--active {\n  border-color: var(--c-black);\n  color: var(--c-black);\n  background: var(--cp-fg, var(--dtm-primary));\n  box-shadow: 2px 2px 0 var(--c-black);\n  opacity: 1;\n}\n";
/**
 * スタイルを document.head に一度だけ注入する。
 */
declare const injectStyles: (doc?: Document) => void;
/**
 * container 内にローディング画面を表示する。
 *
 * - `remove()` でオーバーレイを除去する。
 * - `setProgress(done, total)` で進捗を反映する。total>0 のときはバーを実測値で
 *   塗り、`done / total (NN%)` を表示する。total<=0 なら不確定（無限ループ）演出に戻す。
 */
declare const showLoadingOverlay: (container: HTMLElement, options?: {
    onSkip?: () => void;
    skipLabel?: string;
}) => {
    remove: () => void;
    setProgress: (done: number, total: number, remainingTimeSec?: number | null) => void;
};

/**
 * 内蔵の簡易square-wave synth + 合成ドラム音（synth-drums.ts）。
 *
 * もともと mml-player.ts の中にインラインで持っていたものを、DOM非依存の発音器として
 * 切り出したもの。これにより mountMmlPlayer（DOMビュー）と playMML（ヘッドレス）の双方が
 * 同じ発音ロジックを共有できる。
 *
 * 設計上、AudioContext と出力先ノードは「外から渡す」。これは利用側が自前のマスターGain /
 * ミキサーへルーティングしたり、SE と AudioContext を共有したりできるようにするため。
 */

/**
 * ピッチ(units) → 周波数(Hz)。A4 = 2139 units = 440Hz 基準。
 * 単位は 1/372オクターブの整数（`tuning.ts` 参照）。12平均律・31平均律とも同じ式で鳴る。
 */
declare const freqFromPitch: (pitchUnits: Units) => number;
type Synth = {
    /** メロディックノートを発音する（PlayNoteEvent.when は ctx.currentTime からの相対秒） */
    playNote: (e: PlayNoteEvent) => void;
    /** ドラムノートを発音する（General MIDI のドラムキー番号で音色を分岐） */
    playDrum: (e: PlayDrumEvent) => void;
};
/** createSynth の音色設定。省略時は従来どおりの square 持続音。 */
type SynthTone = {
    /** オシレータ波形。既定 "square" */
    wave?: OscillatorType;
    /** アタック秒（0 でも {@link MIN_ATTACK_SEC} だけは掛かる）。既定 0 */
    attack?: number;
    /** true でピアノ/ギター的な指数減衰（持続音でなく減衰音になる） */
    decay?: boolean;
    /** 波形ごとの聴感補正に使う音量倍率。既定 1 */
    gain?: number;
};
/**
 * AudioContext と出力先ノードを束ねた発音器を作る。
 * @param ctx 発音に使う AudioContext
 * @param destination 接続先（省略時は ctx.destination）。ゲーム側ミキサーへ繋ぐ用途。
 * @param tone 音色設定（波形・エンベロープ）。省略時は従来の square 持続音。
 */
declare const createSynth: (ctx: AudioContext, destination?: AudioNode, tone?: SynthTone) => Synth;

/**
 * ライブラリのバージョン。**書き出したファイルに埋め込むための唯一の出どころ。**
 *
 * ## 何のためにあるか
 *
 * 自動作曲が使う素材（`compose-phrases.ts` など）は外部のコーパスから作る。
 * そのコーパスに「パブリックドメインとして投稿されたが実はそうでなかった」ものが
 * 混じっていた場合、**どのバージョンまでが汚染されているか**を後から言えなければ、
 * 是正のしようがない（全部を疑うか、何もしないかの二択になる）。
 *
 * だから書き出す MML と MIDI にバージョンを埋める。手元のファイルを見れば、
 * それがどの素材から作られたかを {@link file://../docs/dataset-provenance.md} で
 * 引ける。素材を差し替えたらバージョンを上げ、台帳に追記する。
 *
 * ## package.json と二重管理になる理由
 *
 * ブラウザ向けのバンドルに `package.json` を読ませたくないので定数で持つ。
 * ずれると埋め込む値が嘘になるので、`scripts/check-version.ts` が一致を検算する。
 */
declare const DTM_VERSION = "2.1.23";

declare const VOICE_IMAGES: Record<string, string>;

/**
 * PCM（Float32、チャンネル別）から 16bit PCM WAV の Blob を作る、依存なしの小さなエンコーダ。
 * 追加ライブラリなしで完結させたいので RIFF/WAVE ヘッダを手書きしている。
 */
/**
 * チャンネルごとの Float32Array（同じ長さ）から 16bit PCM WAV の Blob を生成する。
 * @param channels 各チャンネルのサンプル列（例: [left, right]）
 * @param sampleRate サンプリングレート（Hz）
 */
declare const encodeWavPCM16: (channels: Float32Array[], sampleRate: number) => Blob;
/** Float32Array のチャンクを1本へ連結する。 */
declare const concatFloat32: (chunks: Float32Array[]) => Float32Array;

export { A4_HZ, A4_UNITS, type AddNoteOptions, type AnyDrumPattern, type ApplyChordOptions, BLUES_SCALE, BREATH_MARK, type BackingAudio, type BackingAudioOptions, type BackingLoaded, type BackingMode, type BackingStartOptions, type Band, type BreathSample, type BuildUstOptions, CENTS_PER_UNIT, COMPOSE_KEYS, COMPOSE_MOOD_GROUPS, COMPOSE_SCALES, COMPOSE_SCALE_IDS, CORPUS_BANDS, CORPUS_SIZE, type ChordPatternType, type ChordPlacement, type ChordPlayerInstance, type ComposeKeyTarget, type ComposeMoodGroup, type ComposeMoodId, type ComposeOptions, type ComposeResult, type ComposeScale, type ComposeScaleId, type ComposeStats, type ComposedNote, type ConsumedSyllable, type CoreEventHandlers, type CustomVocalDef, DAW_CSS, DAW_TOUR_BRANCHES, DAW_TOUR_STEPS, DEFAULT_BPM, DEFAULT_EDO, DEFAULT_GATE, DEFAULT_PAN, DEFAULT_PLAYBACK_VELOCITY, DEFAULT_SECTIONS, DEFAULT_SPEECH_MODEL, DEFAULT_STEPS_PER_BAR, DEFAULT_TTS_BASE_URL, DEFAULT_UST_LYRIC, DEFAULT_VELOCITY, DEFAULT_VOCAL_VOLUME, DRUM_FONT, DRUM_KEYS, DRUM_PATTERNS, DTM_VERSION, type DawInstance, type DawMode, type DawOptions, type DawViewState, type DrumPattern, type DrumPatternDef, type DtmStudio, type DtmStudioEngines, type DtmStudioOptions, EDO31_NAMES, type Edo, type ExportMidiOptions, type ExportMidiTrack, type ExportMusicXmlOptions, type ExportMusicXmlPart, FADE_IN_MARK, FADE_OUT_MARK, type FadeScheduleParams, type FadeStop, GLOBAL_STORAGE_KEYS, GM_BRIGHT_CEILING, GM_INSTRUMENT_NAMES, GM_INSTRUMENT_RANGE, type GlobalStorageKey, HARMONIC_MINOR_SCALE, HUNGARIAN_SCALE, INSTRUMENT_PRESETS, type InstrumentPreset, KEY_COUNT, KOE_BASE_URL, KOE_VOICEBANKS, KOE_VOICEBANK_LABELS, KOE_VOICEBANK_NAMES, KOE_VOICEBANK_TERMS, type KeptSong, type KeyMode, type KoeVoiceOptions, LinkedList, type LoopConfig, type LoopPoint, type LyricSyllable, type LyricSyllableKind, type LyricSyncData, type LyricTrack, type LyricsConductor, MACRO_STORAGE_KEYS, MAJOR_KEY_IDS, MAJOR_SCALE, MAX_VOCAL_VOLUME, MICRO_STEP, MINOR_KEY_IDS, MMLCore, type MMLDisplayToken, type MMLNotePlacement, MML_END_MARKER, type MacroStorageKey, type MelodyForm, type MetricNote, type MetricOptions, type MidiExtraction, type MidiNote, 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 MusicXmlExtraction, type MusicXmlNotePlacement, type MusicXmlPart, type Note, type NoteData, type NoteRemove, type OctaveUnisonMode, PHRASE_GAP_SEC, PITCH_ENCODING_VERSION, PITCH_MAP, PITCH_RANGE_END, PITCH_RANGE_START, PORTAMENTO_MARK, PREWARM_NOTES, type ParseMMLOptions, type ParseMidiFn, type ParsedMML, type PianoRollInstance, type PianoRollOptions, type PicotuneSearchParams, type PicotuneSong, type PitchSegment, type PitchToken, type PlacedSection, type PlayChordsOptions, type PlayDrumEvent, type PlayMmlOptions, type PlayNoteEvent, type PlayNoteOptions, type PlayPlacementsOptions, type PlaySingingMmlOptions, type PlaybackCue, type PlaybackState, type PresetSelectInstance, type PresetSelectOptions, type PreviewSoundCallback, REST_MARK, type RenderConfig, type Renderer, type ResolvedComposeKey, SECTION_LABELS, SECTION_ORDER, SECTION_SPECS, SEQUENCER_START_DELAY, SPEAK_CLOSE, SPEAK_OPEN, SPEECH_EMOTIONS, STOP_MARK, type ScaleDegree, type SectionKind, type SectionSpec, type Sequencer, type SequencerOptions, type SequencerTrack, type SingingVoices, type SingingVoicesOptions, type SpeakOptions, type SpeakVoiceOptions, type SpeechBank, type SpeechEmotion, type SpeechHandle, type SpeechMora, type SpeechPlanDetailOptions, type SpeechPlanInfo, type SpeechPlanOptions, type SpeechPlanner, type SpeechPlannerOptions, type SpeechPrepareOptions, type SpeechProgressListener, type SpeechToneView, type StreamPlaybackOptions, type StreamVoiceNote, type StreamVoiceNoteOptions, type StreamVoiceTrack, type StructureFeatures, type Synth, TIE_MARK, TIE_MERGE_MAX_SEC, TOUR_STORAGE_KEY, TRACKS_ADVANCED, TRACKS_SIMPLE, type TensionFeatures, type TieSourceNote, type TonicCenter, type TonicDegree, type ToolMode, type TourBranch, type TourInstance, type TourLabels, type TourOptions, type TourStep, type TrackConfig, UNITS_PER_EDO31_DEGREE, UNITS_PER_OCTAVE, UNITS_PER_SEMITONE, UST_TICKS_PER_BEAT, type Units, type UstNotePlacement, type UstTrackData, VIBRATO_MIN_SEC, VOICE_IMAGES, VOICE_IMAGE_KEY, VOICE_MODEL_CATEGORIES, type VoiceExpression, type VoiceModel, type VoiceModelGroup, type VoiceRegistry, addUnits, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, backingMediaSec, band, breathPeakPosition, buildChordPlacements, buildDrumPatternJson, buildNameToKeyMapping, buildSectionPlan, buildStreamVoiceNotes, buildUst, chromaticStep, clearTourSeen, collectPitchTokens, complementarity, composeSong, concatFloat32, createAudioContext, createBackingAudio, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createRenderer, createSequencer, createSingingVoices, createSpeechPlanner, createSpeechToneView, createSynth, createVoiceRegistry, decodeMml, decodeUstText, decomposeToMonophonic, displayKana, durationEntropy, encodeMml, encodeWavPCM16, exportMIDI, exportMusicXML, extractDrumPatternFromNotes, extractMidiDrumPattern, extractMidiPlacements, extractMidiPlacementsByTrack, featureDistance, featureVector, fifthToStep, fifthToUnits, fitInstrumentOctave, formatMmlMeta, formatTimeSec, freqFromPitch, generateRandomPattern, getComposeKeyDescription, getComposeScaleDescription, getDrumPatternKeys, getMidiBPM, getSpeechPlanner, groupVoiceModels, hasSeenTour, icon, injectStyles, isBreathAlias, isChordHeavyTrack, isNaturalLetter, isPlausibleMidiTranscription, isTourTargetVisible, isValidHttpUrl, isYoutubeUrl, keyCountFor, koeAliasCandidates, koeUrl, looksLikePinyin, lyricToSyllable, markTourSeen, medianRecordedPitchHz, midiNote, midiToUnits, mountChordPlayer, mountDAW, mountMmlPlayer, musicXmlToNotes, naturalStep, normalizeDrumPatterns, normalizeLyrics, panToStereo, parseCustomVocals, parseLyrics, parseMML, parseMmlMeta, parseMusicXML, parseTimeSec, parseUst, parseYoutubeId, pickBreathAlias, pickBreathSample, pinyinToMoras, pitchV1ToUnits, playChords, playMML, playNote, playPlacements, playSingingMML, prefetchSpeechPcm, prepareSpeechPlan, programOfInstrumentName, readGlobalBool, readGlobalNumber, readGlobalSetting, readKeptSong, readMacroSections, readMacroSetting, resolveCenter, resolveComposeKey, resolveComposeScale, resolveDrumPattern, resolveLoopPoint, resolveYoutubeThumbnail, scaleDegrees, scaleSize, sectionPlanBarRange, semitonesToUnits, shiftNotes, showLoadingOverlay, speechBankView, speechPlanDurationSec, speechPlanLeadingSec, speechPlanMorae, speechRenderOptions, spelledToUnits, spellingToUnits, startTour, stripCustomVocals, stripLyrics, stripMmlMeta, structureFeatures, syllablesToText, tensionFeatures, transposeNotes, units, unitsPerRow, unitsPerStep, unitsToHz, unitsToMidi, unitsToMidiDetune, unitsToPitchV1, vocalVolumeToGain, writeGlobalSetting, writeKeptSong, writeMacroSections, writeMacroSetting };