@onjmin/dtm 2.1.10 → 2.1.11

package/dist/index.d.mts

@@ -741,13 +741,29 @@ declare const buildSectionPlan: (kinds: SectionKind[], templateName?: string) =>
  * ## 引いて、測って、選ぶ
  *
  * {@link DRAW_COUNT} 本の候補を独立に引き、{@link HARD} に触れたものだけを捨てて、
- * 残りから点数最大のものを返す（{@link evaluate}）。合否ではなく点数にしてあるのは
- * 「構造は良いが休符率が 0.09 だったので捨てる」を避けるため。
+ * 残りから**確率的に**引く（{@link evaluate}・{@link SELECT_TEMPERATURE}）。合否ではなく
+ * 点数にしてあるのは「構造は良いが休符率が 0.09 だったので捨てる」を避けるため。
+ * 最大値を必ず取っていた頃は、**引く本数を増やすほど分布が狭まっていた**——
+ * 順次進行の幅が 0.25〜0.86（1本）→ 0.32〜0.65（40本）と、採点式の頂点1点へ収束する。
  *
  * 採点の目標帯（{@link CORPUS_BANDS}）は**人間が書いたMIDIから実測した分布**で、手で
- * 決めた定数ではない。較正は `scripts/calibrate-corpus.ts`。帯の内側にも中央値へ向かう
- * 傾斜を付けてある（`centeredBand`）——周辺分布を一律に満点にすると、全項目が帯の端へ
- * 同時に寄った曲（スカスカで跳ねてばかりの曲）も満点を取れてしまう。
+ * 決めた定数ではない。較正は `scripts/calibrate-corpus.ts`。
+ *
+ * ## 「中央値へ寄せる」のをやめた理由
+ *
+ * 以前は帯の内側にも中央値へ向かう傾斜を付けていた（`centeredBand`）。全項目が帯の端へ
+ * 同時に寄った曲を弾くためだったが、**目標帯は21項目を独立に採った周辺分布**なので、
+ * その中央値は「どの曲でもない平均的な一点」でしかない。コーパス91本を自分の帯で
+ * 測り直すと、人間の曲は中央値で**10項目が帯の外**にあり、素点の中央値は 0.673——
+ * **生成物（0.851）のほうが較正元より高い点を取っていた**。選抜を完全に切っても
+ * 生成物 0.970 対 人間 0.921 で、選抜ではなく採点式そのものが中央を報酬にしていた。
+ *
+ * そこで周辺分布の項目は「人間の範囲に居るか」の確認だけに格下げし（`plausibleBand`）、
+ * 「人間が書いた曲の形か」の判断は**項目の組み合わせ**——コーパス91本のうち
+ * **いちばん近い1曲との距離**（`nearestProfileDistance`、重み `typicality`）——へ渡した。
+ * 中央から離れることではなく、**人が1本も居ない場所に居ること**を罰する形にしてある。
+ * さらに、人間の曲が普通いくつの軸を外すかを実測して {@link DEVIATION_BUDGET} とし、
+ * その本数だけは減点を見逃す。検算は `scripts/check-evaluator.ts`。
  *
  * 指標に最適化した結果として全曲が同じ統計値へ寄るのを防ぐため、直近に作った曲との
  * 距離も加点する（{@link ComposeOptions.recent}）。
@@ -759,6 +775,33 @@ declare const buildSectionPlan: (kinds: SectionKind[], templateName?: string) =>
  * 前後を比べる。耳で確かめるときは `scripts/export-samples.ts` で .mid を書き出す。
  */
 
+/**
+ * 曲の**展開の仕方**。
+ *
+ * - `motif` … 2小節のモチーフを反復・セクエンツ・オクターブ上げの3通りに変形して
+ *   展開する。J-POPの歌モノの作り。
+ * - `ostinato` … **同じ型を曲全体で回す。**変形しない。対比は編曲（ドラム・楽器・
+ *   レイヤ）の側が担う。
+ * - `through` … **通し作曲。**同じ楽句を再現せず、書き進める。
+ *   反復が戻ってこない側の作り。
+ *
+ * ## なぜ要るか
+ *
+ * 初版は `motif` しか無く、しかも小節の役割が**セクション種別で決め打ち**だった
+ * （サビは必ず `climax` ＝オクターブ上げ、それ以外はほぼ `sequence`）。その結果、
+ * 生成系の反復プロファイルが**上にも下にも詰まった**狭い帯に固定されていた。
+ *
+ *   自己相似 sim1 の生成系レンジ 0.31〜0.76／sim4 0.58〜0.86
+ *
+ * 実測（`scripts/compare-reach.ts`）で、採点を完全に切って1500本引いても
+ * コーパス91本のうち27本へ到達できず、**その原因の1位が sim4/sim8 の各19本**だった。
+ * 通し作曲（低い側）にも静的なリフ（高い側・ヤツメ穴の sim1 は 0.97）にもなれない。
+ * 採点式をどう直してもこれは出ないので、生成の型そのものを増やす。
+ *
+ * `ostinato` を入れて上限を開けた後も、未到達26本の原因1位は依然 sim系だった
+ * （下側が空いたまま）。そこで `through` を足して反復の**下限**も開けている。
+ */
+type MelodyForm = "motif" | "ostinato" | "through";
 type ComposedNote = {
     startStep: number;
     pitchUnits: Units;
@@ -839,6 +882,11 @@ type ComposeOptions = {
      * 省略時は "any"（全24調からランダム抽選）。
      */
     baseKey?: string;
+    /**
+     * 展開の仕方（`"auto"` | `"motif"` | `"ostinato"`）。省略時は `"auto"` で曲ごとに引く。
+     * `"ostinato"` は同じ型を曲全体で回すリフ主体の作り。{@link MelodyForm}
+     */
+    form?: string;
     /**
      * 音階の指定（`"auto"` | `"any"` | 音階ID）。省略時は `"auto"` で、
      * ベース調の長短に合わせて陽音階（長調）／民謡音階（短調）を使う——
@@ -865,6 +913,8 @@ type ComposeResult = {
     scaleId: ComposeScaleId;
     /** 曲の音階の表示ラベル（例: "琉球音階"）。 */
     scaleLabel: string;
+    /** 曲の展開の仕方。{@link MelodyForm} */
+    form: MelodyForm;
     /** 雰囲気カテゴリのラベル（該当する場合）。 */
     moodLabel?: string;
     /** 曲のテンポ（BPM）。 */
@@ -2806,6 +2856,32 @@ type InstrumentPreset = {
      * 別トラックへ書き分けること**。
      */
     chorusLead: string;
+    /**
+     * 伴奏の2色目。**同じ進行を別の奏法で鳴らす層を、別の音色にするため**にある。
+     *
+     * 上級者モードは伴奏を t7〜t9 の3本に書き分けていて、奏法（`ChordPatternType`）は
+     * 実際に別のリズムになっている——発音位置の一致は中央 Jaccard 0.13、ほぼ完全一致は
+     * 4%しかない。にもかかわらず**t6〜t10 の5本すべてが `chord` の1楽器**だったため、
+     * せっかく書き分けた層が同じ音色で重なって団子になっていた。
+     * `chord` と喧嘩しない、かつ他のスロットと被らないものを選ぶこと。
+     */
+    chordAlt: string;
+    /**
+     * ウワモノ（装飾）の楽器。高い位置で薄く鳴らす、きらびやかな音。
+     * ここも以前は `chord` を使い回していた。
+     */
+    sparkle: string;
+    /**
+     * ベースの2色目。**セクションでベースの音色を替える**ために使う。
+     * t4 が静かな側、t5 が盛り上がる側を持ち、**同じ音を二度鳴らさずに**
+     * 境目で音色だけが入れ替わる。`bass` と喧嘩しない同族を選ぶこと。
+     */
+    bassAlt: string;
+    /**
+     * ハモリの2色目。同じくセクションで音色を替えるため（t2 が静かな側、
+     * t12 が盛り上がる側）。ハモリは声部なので、声もの・柔らかい持続音が合う。
+     */
+    harmonyAlt: string;
 };
 declare const INSTRUMENT_PRESETS: Record<string, InstrumentPreset>;
 /**
@@ -3928,7 +4004,7 @@ type Synth = {
 type SynthTone = {
     /** オシレータ波形。既定 "square" */
     wave?: OscillatorType;
-    /** アタック秒（0 で即時立ち上がり）。既定 0 */
+    /** アタック秒（0 でも {@link MIN_ATTACK_SEC} だけは掛かる）。既定 0 */
     attack?: number;
     /** true でピアノ/ギター的な指数減衰（持続音でなく減衰音になる） */
     decay?: boolean;
@@ -3958,4 +4034,4 @@ declare const encodeWavPCM16: (channels: Float32Array[], sampleRate: number) =>
 /** Float32Array のチャンクを1本へ連結する。 */
 declare const concatFloat32: (chunks: Float32Array[]) => Float32Array;
 
-export { A4_HZ, A4_UNITS, type AddNoteOptions, type AnyDrumPattern, type ApplyChordOptions, BLUES_SCALE, BREATH_MARK, type Band, 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, DEFAULT_BPM, DEFAULT_EDO, DEFAULT_GATE, DEFAULT_PAN, DEFAULT_PLAYBACK_VELOCITY, DEFAULT_SECTIONS, DEFAULT_STEPS_PER_BAR, DEFAULT_VELOCITY, DEFAULT_VOCAL_VOLUME, DRUM_FONT, DRUM_KEYS, DRUM_PATTERNS, 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, FADE_IN_MARK, FADE_OUT_MARK, type FadeScheduleParams, 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_TERMS, 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 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 Note, type NoteData, type NoteRemove, type OctaveUnisonMode, 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, STOP_MARK, type ScaleDegree, type SectionKind, type SectionSpec, type Sequencer, type SequencerOptions, type SequencerTrack, type SingingVoices, type SingingVoicesOptions, type StreamPlaybackOptions, type StreamVoiceNote, type StreamVoiceNoteOptions, type StreamVoiceTrack, type StructureFeatures, type Synth, TIE_MARK, TIE_MERGE_MAX_SEC, TRACKS_ADVANCED, TRACKS_SIMPLE, type TensionFeatures, type TieSourceNote, type TonicCenter, type TonicDegree, type ToolMode, type TrackConfig, UNITS_PER_EDO31_DEGREE, UNITS_PER_OCTAVE, UNITS_PER_SEMITONE, type Units, VIBRATO_MIN_SEC, VOICE_IMAGES, VOICE_IMAGE_KEY, type VoiceExpression, type VoiceModel, type VoiceRegistry, addUnits, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, band, buildChordPlacements, buildDrumPatternJson, buildNameToKeyMapping, buildSectionPlan, buildStreamVoiceNotes, chromaticStep, collectPitchTokens, complementarity, composeSong, concatFloat32, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createRenderer, createSequencer, createSingingVoices, createSynth, createVoiceRegistry, decodeMml, decomposeToMonophonic, displayKana, durationEntropy, encodeMml, encodeWavPCM16, exportMIDI, extractDrumPatternFromNotes, extractMidiDrumPattern, extractMidiPlacements, extractMidiPlacementsByTrack, featureDistance, featureVector, fifthToStep, fifthToUnits, fitInstrumentOctave, formatMmlMeta, freqFromPitch, generateRandomPattern, getComposeKeyDescription, getComposeScaleDescription, getDrumPatternKeys, getMidiBPM, icon, injectStyles, isChordHeavyTrack, isNaturalLetter, isPlausibleMidiTranscription, isValidHttpUrl, keyCountFor, koeUrl, midiNote, midiToUnits, mountChordPlayer, mountDAW, mountMmlPlayer, naturalStep, normalizeDrumPatterns, normalizeLyrics, panToStereo, parseCustomVocals, parseLyrics, parseMML, parseMmlMeta, pitchV1ToUnits, playChords, playMML, playNote, playPlacements, playSingingMML, programOfInstrumentName, readGlobalBool, readGlobalNumber, readGlobalSetting, readMacroSections, readMacroSetting, resolveCenter, resolveComposeKey, resolveComposeScale, resolveDrumPattern, resolveLoopPoint, scaleDegrees, scaleSize, semitonesToUnits, shiftNotes, showLoadingOverlay, spelledToUnits, spellingToUnits, stripCustomVocals, stripLyrics, stripMmlMeta, structureFeatures, syllablesToText, tensionFeatures, transposeNotes, units, unitsPerRow, unitsPerStep, unitsToHz, unitsToMidi, unitsToMidiDetune, unitsToPitchV1, vocalVolumeToGain, writeGlobalSetting, writeMacroSections, writeMacroSetting };
+export { A4_HZ, A4_UNITS, type AddNoteOptions, type AnyDrumPattern, type ApplyChordOptions, BLUES_SCALE, BREATH_MARK, type Band, 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, DEFAULT_BPM, DEFAULT_EDO, DEFAULT_GATE, DEFAULT_PAN, DEFAULT_PLAYBACK_VELOCITY, DEFAULT_SECTIONS, DEFAULT_STEPS_PER_BAR, DEFAULT_VELOCITY, DEFAULT_VOCAL_VOLUME, DRUM_FONT, DRUM_KEYS, DRUM_PATTERNS, 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, FADE_IN_MARK, FADE_OUT_MARK, type FadeScheduleParams, 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_TERMS, 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 Note, type NoteData, type NoteRemove, type OctaveUnisonMode, 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, STOP_MARK, type ScaleDegree, type SectionKind, type SectionSpec, type Sequencer, type SequencerOptions, type SequencerTrack, type SingingVoices, type SingingVoicesOptions, type StreamPlaybackOptions, type StreamVoiceNote, type StreamVoiceNoteOptions, type StreamVoiceTrack, type StructureFeatures, type Synth, TIE_MARK, TIE_MERGE_MAX_SEC, TRACKS_ADVANCED, TRACKS_SIMPLE, type TensionFeatures, type TieSourceNote, type TonicCenter, type TonicDegree, type ToolMode, type TrackConfig, UNITS_PER_EDO31_DEGREE, UNITS_PER_OCTAVE, UNITS_PER_SEMITONE, type Units, VIBRATO_MIN_SEC, VOICE_IMAGES, VOICE_IMAGE_KEY, type VoiceExpression, type VoiceModel, type VoiceRegistry, addUnits, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, band, buildChordPlacements, buildDrumPatternJson, buildNameToKeyMapping, buildSectionPlan, buildStreamVoiceNotes, chromaticStep, collectPitchTokens, complementarity, composeSong, concatFloat32, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createRenderer, createSequencer, createSingingVoices, createSynth, createVoiceRegistry, decodeMml, decomposeToMonophonic, displayKana, durationEntropy, encodeMml, encodeWavPCM16, exportMIDI, extractDrumPatternFromNotes, extractMidiDrumPattern, extractMidiPlacements, extractMidiPlacementsByTrack, featureDistance, featureVector, fifthToStep, fifthToUnits, fitInstrumentOctave, formatMmlMeta, freqFromPitch, generateRandomPattern, getComposeKeyDescription, getComposeScaleDescription, getDrumPatternKeys, getMidiBPM, icon, injectStyles, isChordHeavyTrack, isNaturalLetter, isPlausibleMidiTranscription, isValidHttpUrl, keyCountFor, koeUrl, midiNote, midiToUnits, mountChordPlayer, mountDAW, mountMmlPlayer, naturalStep, normalizeDrumPatterns, normalizeLyrics, panToStereo, parseCustomVocals, parseLyrics, parseMML, parseMmlMeta, pitchV1ToUnits, playChords, playMML, playNote, playPlacements, playSingingMML, programOfInstrumentName, readGlobalBool, readGlobalNumber, readGlobalSetting, readMacroSections, readMacroSetting, resolveCenter, resolveComposeKey, resolveComposeScale, resolveDrumPattern, resolveLoopPoint, scaleDegrees, scaleSize, semitonesToUnits, shiftNotes, showLoadingOverlay, spelledToUnits, spellingToUnits, stripCustomVocals, stripLyrics, stripMmlMeta, structureFeatures, syllablesToText, tensionFeatures, transposeNotes, units, unitsPerRow, unitsPerStep, unitsToHz, unitsToMidi, unitsToMidiDetune, unitsToPitchV1, vocalVolumeToGain, writeGlobalSetting, writeMacroSections, writeMacroSetting };

package/dist/index.d.ts

@@ -741,13 +741,29 @@ declare const buildSectionPlan: (kinds: SectionKind[], templateName?: string) =>
  * ## 引いて、測って、選ぶ
  *
  * {@link DRAW_COUNT} 本の候補を独立に引き、{@link HARD} に触れたものだけを捨てて、
- * 残りから点数最大のものを返す（{@link evaluate}）。合否ではなく点数にしてあるのは
- * 「構造は良いが休符率が 0.09 だったので捨てる」を避けるため。
+ * 残りから**確率的に**引く（{@link evaluate}・{@link SELECT_TEMPERATURE}）。合否ではなく
+ * 点数にしてあるのは「構造は良いが休符率が 0.09 だったので捨てる」を避けるため。
+ * 最大値を必ず取っていた頃は、**引く本数を増やすほど分布が狭まっていた**——
+ * 順次進行の幅が 0.25〜0.86（1本）→ 0.32〜0.65（40本）と、採点式の頂点1点へ収束する。
  *
  * 採点の目標帯（{@link CORPUS_BANDS}）は**人間が書いたMIDIから実測した分布**で、手で
- * 決めた定数ではない。較正は `scripts/calibrate-corpus.ts`。帯の内側にも中央値へ向かう
- * 傾斜を付けてある（`centeredBand`）——周辺分布を一律に満点にすると、全項目が帯の端へ
- * 同時に寄った曲（スカスカで跳ねてばかりの曲）も満点を取れてしまう。
+ * 決めた定数ではない。較正は `scripts/calibrate-corpus.ts`。
+ *
+ * ## 「中央値へ寄せる」のをやめた理由
+ *
+ * 以前は帯の内側にも中央値へ向かう傾斜を付けていた（`centeredBand`）。全項目が帯の端へ
+ * 同時に寄った曲を弾くためだったが、**目標帯は21項目を独立に採った周辺分布**なので、
+ * その中央値は「どの曲でもない平均的な一点」でしかない。コーパス91本を自分の帯で
+ * 測り直すと、人間の曲は中央値で**10項目が帯の外**にあり、素点の中央値は 0.673——
+ * **生成物（0.851）のほうが較正元より高い点を取っていた**。選抜を完全に切っても
+ * 生成物 0.970 対 人間 0.921 で、選抜ではなく採点式そのものが中央を報酬にしていた。
+ *
+ * そこで周辺分布の項目は「人間の範囲に居るか」の確認だけに格下げし（`plausibleBand`）、
+ * 「人間が書いた曲の形か」の判断は**項目の組み合わせ**——コーパス91本のうち
+ * **いちばん近い1曲との距離**（`nearestProfileDistance`、重み `typicality`）——へ渡した。
+ * 中央から離れることではなく、**人が1本も居ない場所に居ること**を罰する形にしてある。
+ * さらに、人間の曲が普通いくつの軸を外すかを実測して {@link DEVIATION_BUDGET} とし、
+ * その本数だけは減点を見逃す。検算は `scripts/check-evaluator.ts`。
  *
  * 指標に最適化した結果として全曲が同じ統計値へ寄るのを防ぐため、直近に作った曲との
  * 距離も加点する（{@link ComposeOptions.recent}）。
@@ -759,6 +775,33 @@ declare const buildSectionPlan: (kinds: SectionKind[], templateName?: string) =>
  * 前後を比べる。耳で確かめるときは `scripts/export-samples.ts` で .mid を書き出す。
  */
 
+/**
+ * 曲の**展開の仕方**。
+ *
+ * - `motif` … 2小節のモチーフを反復・セクエンツ・オクターブ上げの3通りに変形して
+ *   展開する。J-POPの歌モノの作り。
+ * - `ostinato` … **同じ型を曲全体で回す。**変形しない。対比は編曲（ドラム・楽器・
+ *   レイヤ）の側が担う。
+ * - `through` … **通し作曲。**同じ楽句を再現せず、書き進める。
+ *   反復が戻ってこない側の作り。
+ *
+ * ## なぜ要るか
+ *
+ * 初版は `motif` しか無く、しかも小節の役割が**セクション種別で決め打ち**だった
+ * （サビは必ず `climax` ＝オクターブ上げ、それ以外はほぼ `sequence`）。その結果、
+ * 生成系の反復プロファイルが**上にも下にも詰まった**狭い帯に固定されていた。
+ *
+ *   自己相似 sim1 の生成系レンジ 0.31〜0.76／sim4 0.58〜0.86
+ *
+ * 実測（`scripts/compare-reach.ts`）で、採点を完全に切って1500本引いても
+ * コーパス91本のうち27本へ到達できず、**その原因の1位が sim4/sim8 の各19本**だった。
+ * 通し作曲（低い側）にも静的なリフ（高い側・ヤツメ穴の sim1 は 0.97）にもなれない。
+ * 採点式をどう直してもこれは出ないので、生成の型そのものを増やす。
+ *
+ * `ostinato` を入れて上限を開けた後も、未到達26本の原因1位は依然 sim系だった
+ * （下側が空いたまま）。そこで `through` を足して反復の**下限**も開けている。
+ */
+type MelodyForm = "motif" | "ostinato" | "through";
 type ComposedNote = {
     startStep: number;
     pitchUnits: Units;
@@ -839,6 +882,11 @@ type ComposeOptions = {
      * 省略時は "any"（全24調からランダム抽選）。
      */
     baseKey?: string;
+    /**
+     * 展開の仕方（`"auto"` | `"motif"` | `"ostinato"`）。省略時は `"auto"` で曲ごとに引く。
+     * `"ostinato"` は同じ型を曲全体で回すリフ主体の作り。{@link MelodyForm}
+     */
+    form?: string;
     /**
      * 音階の指定（`"auto"` | `"any"` | 音階ID）。省略時は `"auto"` で、
      * ベース調の長短に合わせて陽音階（長調）／民謡音階（短調）を使う——
@@ -865,6 +913,8 @@ type ComposeResult = {
     scaleId: ComposeScaleId;
     /** 曲の音階の表示ラベル（例: "琉球音階"）。 */
     scaleLabel: string;
+    /** 曲の展開の仕方。{@link MelodyForm} */
+    form: MelodyForm;
     /** 雰囲気カテゴリのラベル（該当する場合）。 */
     moodLabel?: string;
     /** 曲のテンポ（BPM）。 */
@@ -2806,6 +2856,32 @@ type InstrumentPreset = {
      * 別トラックへ書き分けること**。
      */
     chorusLead: string;
+    /**
+     * 伴奏の2色目。**同じ進行を別の奏法で鳴らす層を、別の音色にするため**にある。
+     *
+     * 上級者モードは伴奏を t7〜t9 の3本に書き分けていて、奏法（`ChordPatternType`）は
+     * 実際に別のリズムになっている——発音位置の一致は中央 Jaccard 0.13、ほぼ完全一致は
+     * 4%しかない。にもかかわらず**t6〜t10 の5本すべてが `chord` の1楽器**だったため、
+     * せっかく書き分けた層が同じ音色で重なって団子になっていた。
+     * `chord` と喧嘩しない、かつ他のスロットと被らないものを選ぶこと。
+     */
+    chordAlt: string;
+    /**
+     * ウワモノ（装飾）の楽器。高い位置で薄く鳴らす、きらびやかな音。
+     * ここも以前は `chord` を使い回していた。
+     */
+    sparkle: string;
+    /**
+     * ベースの2色目。**セクションでベースの音色を替える**ために使う。
+     * t4 が静かな側、t5 が盛り上がる側を持ち、**同じ音を二度鳴らさずに**
+     * 境目で音色だけが入れ替わる。`bass` と喧嘩しない同族を選ぶこと。
+     */
+    bassAlt: string;
+    /**
+     * ハモリの2色目。同じくセクションで音色を替えるため（t2 が静かな側、
+     * t12 が盛り上がる側）。ハモリは声部なので、声もの・柔らかい持続音が合う。
+     */
+    harmonyAlt: string;
 };
 declare const INSTRUMENT_PRESETS: Record<string, InstrumentPreset>;
 /**
@@ -3928,7 +4004,7 @@ type Synth = {
 type SynthTone = {
     /** オシレータ波形。既定 "square" */
     wave?: OscillatorType;
-    /** アタック秒（0 で即時立ち上がり）。既定 0 */
+    /** アタック秒（0 でも {@link MIN_ATTACK_SEC} だけは掛かる）。既定 0 */
     attack?: number;
     /** true でピアノ/ギター的な指数減衰（持続音でなく減衰音になる） */
     decay?: boolean;
@@ -3958,4 +4034,4 @@ declare const encodeWavPCM16: (channels: Float32Array[], sampleRate: number) =>
 /** Float32Array のチャンクを1本へ連結する。 */
 declare const concatFloat32: (chunks: Float32Array[]) => Float32Array;
 
-export { A4_HZ, A4_UNITS, type AddNoteOptions, type AnyDrumPattern, type ApplyChordOptions, BLUES_SCALE, BREATH_MARK, type Band, 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, DEFAULT_BPM, DEFAULT_EDO, DEFAULT_GATE, DEFAULT_PAN, DEFAULT_PLAYBACK_VELOCITY, DEFAULT_SECTIONS, DEFAULT_STEPS_PER_BAR, DEFAULT_VELOCITY, DEFAULT_VOCAL_VOLUME, DRUM_FONT, DRUM_KEYS, DRUM_PATTERNS, 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, FADE_IN_MARK, FADE_OUT_MARK, type FadeScheduleParams, 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_TERMS, 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 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 Note, type NoteData, type NoteRemove, type OctaveUnisonMode, 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, STOP_MARK, type ScaleDegree, type SectionKind, type SectionSpec, type Sequencer, type SequencerOptions, type SequencerTrack, type SingingVoices, type SingingVoicesOptions, type StreamPlaybackOptions, type StreamVoiceNote, type StreamVoiceNoteOptions, type StreamVoiceTrack, type StructureFeatures, type Synth, TIE_MARK, TIE_MERGE_MAX_SEC, TRACKS_ADVANCED, TRACKS_SIMPLE, type TensionFeatures, type TieSourceNote, type TonicCenter, type TonicDegree, type ToolMode, type TrackConfig, UNITS_PER_EDO31_DEGREE, UNITS_PER_OCTAVE, UNITS_PER_SEMITONE, type Units, VIBRATO_MIN_SEC, VOICE_IMAGES, VOICE_IMAGE_KEY, type VoiceExpression, type VoiceModel, type VoiceRegistry, addUnits, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, band, buildChordPlacements, buildDrumPatternJson, buildNameToKeyMapping, buildSectionPlan, buildStreamVoiceNotes, chromaticStep, collectPitchTokens, complementarity, composeSong, concatFloat32, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createRenderer, createSequencer, createSingingVoices, createSynth, createVoiceRegistry, decodeMml, decomposeToMonophonic, displayKana, durationEntropy, encodeMml, encodeWavPCM16, exportMIDI, extractDrumPatternFromNotes, extractMidiDrumPattern, extractMidiPlacements, extractMidiPlacementsByTrack, featureDistance, featureVector, fifthToStep, fifthToUnits, fitInstrumentOctave, formatMmlMeta, freqFromPitch, generateRandomPattern, getComposeKeyDescription, getComposeScaleDescription, getDrumPatternKeys, getMidiBPM, icon, injectStyles, isChordHeavyTrack, isNaturalLetter, isPlausibleMidiTranscription, isValidHttpUrl, keyCountFor, koeUrl, midiNote, midiToUnits, mountChordPlayer, mountDAW, mountMmlPlayer, naturalStep, normalizeDrumPatterns, normalizeLyrics, panToStereo, parseCustomVocals, parseLyrics, parseMML, parseMmlMeta, pitchV1ToUnits, playChords, playMML, playNote, playPlacements, playSingingMML, programOfInstrumentName, readGlobalBool, readGlobalNumber, readGlobalSetting, readMacroSections, readMacroSetting, resolveCenter, resolveComposeKey, resolveComposeScale, resolveDrumPattern, resolveLoopPoint, scaleDegrees, scaleSize, semitonesToUnits, shiftNotes, showLoadingOverlay, spelledToUnits, spellingToUnits, stripCustomVocals, stripLyrics, stripMmlMeta, structureFeatures, syllablesToText, tensionFeatures, transposeNotes, units, unitsPerRow, unitsPerStep, unitsToHz, unitsToMidi, unitsToMidiDetune, unitsToPitchV1, vocalVolumeToGain, writeGlobalSetting, writeMacroSections, writeMacroSetting };
+export { A4_HZ, A4_UNITS, type AddNoteOptions, type AnyDrumPattern, type ApplyChordOptions, BLUES_SCALE, BREATH_MARK, type Band, 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, DEFAULT_BPM, DEFAULT_EDO, DEFAULT_GATE, DEFAULT_PAN, DEFAULT_PLAYBACK_VELOCITY, DEFAULT_SECTIONS, DEFAULT_STEPS_PER_BAR, DEFAULT_VELOCITY, DEFAULT_VOCAL_VOLUME, DRUM_FONT, DRUM_KEYS, DRUM_PATTERNS, 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, FADE_IN_MARK, FADE_OUT_MARK, type FadeScheduleParams, 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_TERMS, 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 Note, type NoteData, type NoteRemove, type OctaveUnisonMode, 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, STOP_MARK, type ScaleDegree, type SectionKind, type SectionSpec, type Sequencer, type SequencerOptions, type SequencerTrack, type SingingVoices, type SingingVoicesOptions, type StreamPlaybackOptions, type StreamVoiceNote, type StreamVoiceNoteOptions, type StreamVoiceTrack, type StructureFeatures, type Synth, TIE_MARK, TIE_MERGE_MAX_SEC, TRACKS_ADVANCED, TRACKS_SIMPLE, type TensionFeatures, type TieSourceNote, type TonicCenter, type TonicDegree, type ToolMode, type TrackConfig, UNITS_PER_EDO31_DEGREE, UNITS_PER_OCTAVE, UNITS_PER_SEMITONE, type Units, VIBRATO_MIN_SEC, VOICE_IMAGES, VOICE_IMAGE_KEY, type VoiceExpression, type VoiceModel, type VoiceRegistry, addUnits, analyzeMidiTracks, applyHarmonicFilter, applyMonophonic, band, buildChordPlacements, buildDrumPatternJson, buildNameToKeyMapping, buildSectionPlan, buildStreamVoiceNotes, chromaticStep, collectPitchTokens, complementarity, composeSong, concatFloat32, createAudioContext, createDtmStudio, createKlattVoice, createKoeVoice, createLyricsConductor, createPianoRoll, createRenderer, createSequencer, createSingingVoices, createSynth, createVoiceRegistry, decodeMml, decomposeToMonophonic, displayKana, durationEntropy, encodeMml, encodeWavPCM16, exportMIDI, extractDrumPatternFromNotes, extractMidiDrumPattern, extractMidiPlacements, extractMidiPlacementsByTrack, featureDistance, featureVector, fifthToStep, fifthToUnits, fitInstrumentOctave, formatMmlMeta, freqFromPitch, generateRandomPattern, getComposeKeyDescription, getComposeScaleDescription, getDrumPatternKeys, getMidiBPM, icon, injectStyles, isChordHeavyTrack, isNaturalLetter, isPlausibleMidiTranscription, isValidHttpUrl, keyCountFor, koeUrl, midiNote, midiToUnits, mountChordPlayer, mountDAW, mountMmlPlayer, naturalStep, normalizeDrumPatterns, normalizeLyrics, panToStereo, parseCustomVocals, parseLyrics, parseMML, parseMmlMeta, pitchV1ToUnits, playChords, playMML, playNote, playPlacements, playSingingMML, programOfInstrumentName, readGlobalBool, readGlobalNumber, readGlobalSetting, readMacroSections, readMacroSetting, resolveCenter, resolveComposeKey, resolveComposeScale, resolveDrumPattern, resolveLoopPoint, scaleDegrees, scaleSize, semitonesToUnits, shiftNotes, showLoadingOverlay, spelledToUnits, spellingToUnits, stripCustomVocals, stripLyrics, stripMmlMeta, structureFeatures, syllablesToText, tensionFeatures, transposeNotes, units, unitsPerRow, unitsPerStep, unitsToHz, unitsToMidi, unitsToMidiDetune, unitsToPitchV1, vocalVolumeToGain, writeGlobalSetting, writeMacroSections, writeMacroSetting };