@onjmin/koe 1.0.6 → 1.0.7

package/README.md

@@ -3,6 +3,7 @@
 ブラウザ上でUTAU音源をラグ無しで再生するnpmモジュール。
 
 UTAU の oto.ini で定義された音源を `.koe` アーカイブに変換し、WebAssembly + AudioWorklet でリアルタイム再生・高品質再合成を行う。
+oto.ini が無い収録済み wav フォルダからは、原音設定そのものを自動生成できる。
 
 - [DEMO](https://onjmin.github.io/koe/demo) koeフォーマット作成もこちらで
 - [npm](https://www.npmjs.com/package/@onjmin/koe)
@@ -42,7 +43,114 @@ UTAU音源 (wav + oto.ini + frq)
 
 ## 使い方
 
-### 1. 音源の変換 (oto.ini → .koe)
+### 1. 原音設定の自動生成 (wav → oto.ini)
+
+収録済みの wav フォルダから oto.ini を生成する。CLI と [DEMO ページ](https://onjmin.github.io/koe/demo) の両方から使える。
+
+#### GUI から
+
+DEMO ページの「原音設定 — oto.ini を作る」カードで、wav フォルダ（または zip）を選んでボタンを押すだけ。wav が入っているフォルダごとに oto.ini ができ、そのまま保存（複数フォルダなら zip）できる。「変換へ」を押すと、作った oto.ini をそのまま使って `.koe` を生成し、その場で歌わせて確認できる。
+
+エイリアス接尾辞と、`- か` / `* あ` エイリアスを作るかどうかはカード内で切り替えられる。処理はすべてブラウザ内で完結し、wav はどこにも送信されない。
+
+#### CLI から
+
+```bash
+npx koe-oto <音源フォルダ>
+```
+
+フォルダを渡すだけで、その下の「wav が置かれている全フォルダ」それぞれに oto.ini が書き出される。
+
+| オプション | 説明 |
+| --- | --- |
+| `-n`, `--dry-run` | 書き込まず、生成結果の件数だけ表示する |
+| `-f`, `--force` | 既存の oto.ini を上書きする (`oto.ini.bak` を残す) |
+| `--suffix <s>` | 全エイリアスの末尾に `<s>` を付ける (既定: フォルダ名が音階名なら `_G4` 等) |
+| `-q`, `--quiet` | 集計行だけ出力する |
+
+既存の oto.ini があるフォルダは既定でスキップする。上書きしたい場合のみ `--force` を付ける。
+
+#### 収録方式の判定
+
+ファイル名がそのまま音素の書き起こしになっているので、方式はファイル名から決まる。
+
+| ファイル名 | 判定 | 生成されるエイリアス |
+| --- | --- | --- |
+| `か.wav` / `_きゃ.wav` | 単独音 | `か`, `- か` |
+| `_あ.wav` | 単独音 (母音) | `あ`, `- あ`, `* あ` |
+| `_ああいあうえあ.wav` | 連続音 | `- あ`, `a あ`, `a い`, `i あ`, … |
+| `_ああR.wav` | 連続音 + 語尾 | `- あ`, `a あ`, `a R` |
+| `_あb.wav` / `_ううわ↑.wav` | テイク違い | `あb`, `- あb` / `- う↑`, `u う↑` … |
+| `_xか.wav` | 語頭記号付き | `xか`, `- xか` |
+| `カラオケ.wav` | 仮名として読めない → スキップ | — |
+
+カタカナ・拗音・外来音 (`ヴぁ`, `てぃ`, `つぉ` 等) も解決する。仮名の前後に付いた `x` / `b` / `2` / `↑↓` のようなテイク記号はエイリアスに引き継ぐ。仮名として読めないファイルは音声ではないものとして飛ばすので、伴奏やサンプル曲が混ざったフォルダでもそのまま渡せる。
+
+フォルダ名が音階そのもの (`G4`) か、音階タグを含む (`多音階03：_G4（連続音）`) 場合は、多音階音源としてエイリアス末尾に `_G4` を付ける。音源全体で oto.ini のエイリアスは1つの名前空間に混ざるため、これが無いと音階ごとの `- あ` が互いを上書きしてしまう。
+
+#### 推定のしかた
+
+[UTAU音源制作wiki の原音設定記事](https://w.atwiki.jp/vbmaker/pages/17.html) のセオリーをそのまま実装している。
+
+- **オフセット** — 子音の立ち上がりの少し手前。さ行・は行のような摩擦音は 4kHz 以上の帯域で先に立ち上がるので、その帯域を見て検出する。
+- **先行発声** — 母音の開始点。無声子音 (か・さ・た・は・ぱ行) は声帯が鳴り出した瞬間、な・ま・ら行は鼻音/はじき音が開放された瞬間、や・わ行は渡りの中間。
+- **子音部 (固定範囲)** — 母音に入ってスペクトルが落ち着くまで。伸縮されるのが定常部の母音だけになる。
+- **オーバーラップ** — 先行発声に対する比で決める。共鳴音 (な・ま・ら・や・わ行) はおよそ 0.6 倍、摩擦音・破擦音は 0.3 倍、下限 12ms・上限 40ms。か・た・ぱ行は破裂前の無音を再現するため負値 (−10ms)。母音単体は 20ms 固定。
+- **右ブランク** — 減衰が始まる手前。負値 (オフセットからの相対値) で書き出す。
+
+連続音はガイドBGMに合わせて収録されるため、モーラが等間隔に並ぶ。オンセット検出の自己相関からテンポを求め、グリッドを当ててから各モーラを最寄りのオンセットに吸着させる。テンポが求まれば先行発声 = 間隔の 1/2、オーバーラップ = その 1/3、固定範囲 = その 1.5 倍、右ブランク = ノートの 2/3 間隔先、という既存音源が共通して使っているテンプレートを当てる。
+
+#### 精度
+
+手作業の音源との一致度 (絶対時刻でのずれ)。`重音テト単独音` は人力精度が高い音源として比較対象にした。
+
+| 音源 | 方式 | 先行発声 ≤20ms | ≤40ms | 中央絶対誤差 |
+| --- | --- | --- | --- | --- |
+| 重音テト単独音 | 単独音 | 72% | 85% | 11ms |
+| 欲音ルコ♀ A3 | 連続音 | 53% | 81% | 18ms |
+| つくよみちゃん _G4 | 連続音 | 42% | 71% | 25ms |
+| 束音ロゼ G4 | 連続音 | 43% | 61% | 28ms |
+| 欲音ルコ♂ | 連続音 | 30% | 55% | 37ms |
+
+テトでは他のパラメータも、オフセット ≤20ms 89% / 中央絶対誤差 8ms、オーバーラップ ≤20ms 79% / 10.6ms、右ブランク ≤20ms 85% / 8ms。一番緩いのは子音部 (固定範囲) で中央絶対誤差 34ms だが、これは伸縮の開始位置を決めるだけなのでリズムには効かない。
+
+連続音は音源ごとのテンプレート方針の差がそのまま誤差に出るため、単独音より一致率が落ちる (欲音ルコ♂ は人力でモーラごとに詰めてある音源)。
+
+setParam の自動推定と同程度で、そのまま歌わせられる水準ではあるが、商用配布するなら人の手で詰める前提の出力。
+
+なお `息.wav` `咳払い.wav` のような非言語音は、歌詞が仮名で書かれていない以上どんなエイリアスを振るべきか決めようがないのでスキップする (スキップしたファイルは `GenerateResult.skipped` と CLI の集計に出る)。必要ならその数行だけ手で足すことになる。
+
+#### コードから使う
+
+ブラウザでもそのまま動く (`fs` に依存しない)。
+
+```ts
+import { generateOto, formatOto, encodeOto } from "@onjmin/koe";
+
+const files = [{ name: "_あ.wav", data: arrayBuffer }, /* ... */];
+const { entries, skipped, style } = generateOto(files, { suffix: "_G4" });
+
+console.log(style);          // "solo" | "sequence" | "mixed"
+console.log(formatOto(entries));  // oto.ini のテキスト
+const bytes = encodeOto(entries); // Shift-JIS の Uint8Array
+```
+
+`generateOto` は同期処理なので、フォルダが大きいとブラウザのUIが固まる。進捗を出したい場合は1ファイルずつ回す:
+
+```ts
+import { generateOtoForFile, summarise } from "@onjmin/koe";
+
+for (const file of files) {
+  const { entries, skipped, style } = generateOtoForFile(file, { suffix: "_G4" });
+  // …集計して、ここでイベントループに制御を返す
+}
+```
+
+`generateOto` が返す `entries` は `parseOto` と同じ `OtoEntry[]` なので、そのまま `pack()` に渡して `.koe` 化できる。
+
+---
+
+### 2. 音源の変換 (oto.ini → .koe)
 
 CLIコマンド `koe-convert` で UTAU 音源を `.koe` アーカイブに変換する。
 
@@ -90,7 +198,7 @@ await fs.writeFile("voice.koe", buf);
 
 ---
 
-### 2. KoeEngine — リアルタイム再生 (ブラウザ)
+### 3. KoeEngine — リアルタイム再生 (ブラウザ)
 
 AudioWorklet を使った連接合成エンジン。`koe-worklet.js` を同じオリジンから配信する必要がある。
 
@@ -132,7 +240,7 @@ interface NoteEvent {
 
 ---
 
-### 3. VoiceBank — 音素 PCM の直接取得
+### 4. VoiceBank — 音素 PCM の直接取得
 
 AudioContext 不要。WORLD ボコーダや独自の合成処理に PCM を渡したい場合に使う。
 
@@ -161,7 +269,7 @@ bank.has("a"); // boolean
 
 ---
 
-### 4. Worldline — 高品質ノート合成 (WORLD ボコーダ)
+### 5. Worldline — 高品質ノート合成 (WORLD ボコーダ)
 
 OpenUtau の worldline WASM で F0 分析・再合成を行う。`worldline.js` と `worldline.wasm` を配信する必要がある。
 
@@ -201,7 +309,7 @@ if (audio) {
 
 ---
 
-### 5. .koe アーカイブ形式
+### 6. .koe アーカイブ形式
 
 ```
 [4B] magic 'KOE\0' (big-endian)
@@ -233,6 +341,14 @@ const pcmOffset = pcmBase(jsonLength); // PCM データの開始バイト位置
 | `KoeEngine` | AudioWorklet ベースの連接合成エンジン |
 | `VoiceBank` | .koe から音素 PCM をオンデマンド取得 |
 | `Worldline` | WORLD ボコーダによる高品質ノート合成 |
+| `generateOto` | wav 群 → oto.ini エントリを推定 (原音設定) |
+| `generateOtoForFile` | wav 1本ぶんの推定 (進捗表示したいとき用) |
+| `formatOto` / `encodeOto` | エントリ → oto.ini テキスト / Shift-JIS バイト列 |
+| `analyze` / `analyzeWav` | WAV → フレーム特徴量 (RMS・有声度・スペクトル) |
+| `estimateSolo` / `estimateSequence` | 単独音 / 連続音 1ファイル分のパラメータ推定 |
+| `detectGrid` | 連続音のモーラ位置とテンポを検出 |
+| `splitKana` | 仮名文字列 → モーラ (子音・母音・調音種別) |
+| `transcribe` | wav ファイル名 → モーラ列 |
 | `parseOto` | oto.ini テキストをパース |
 | `parseWav` | WAV バイナリをパース |
 | `toMono` | ステレオ → モノラル変換 |
@@ -242,6 +358,7 @@ const pcmOffset = pcmBase(jsonLength); // PCM データの開始バイト位置
 | `trimToOto` | WAV を oto リージョンにトリミング |
 | `packKoe` | manifest + PCM → .koe Blob |
 | `parseKoeHeader` | .koe ヘッダ解析 |
+| `unzipToFileMap` / `zipFiles` | zip の展開 / 作成 |
 | `pcmBase` | JSON長 → PCM 開始バイト位置 |
 | `detectF0` | PCM からピッチ自動検出 |
 | `noteNameToHz` | 音名 → Hz 変換 (例: `"A4"` → `440`) |

package/dist/index.d.ts

@@ -217,6 +217,14 @@ interface ZipFile {
  * original bytes and re-decode with the right encoding per entry.
  */
 declare function unzipToFileMap(data: ArrayBuffer): Promise<Record<string, ZipFile>>;
+/**
+ * Pack a path → bytes map into a zip Blob.
+ *
+ * Entry names are written as UTF-8 with the language flag set, which is what
+ * every current unzip tool reads — including Windows Explorer, so a bank whose
+ * folders are named in Japanese comes back out intact.
+ */
+declare function zipFiles(files: Record<string, Uint8Array>): Blob;
 
 /**
  * Read-only access to a .koe voice bank: its manifest plus per-phoneme PCM,
@@ -393,6 +401,25 @@ interface WorldlineLoadOptions {
  * function you give it once per frame.
  */
 type CurveInput = number | ((tMs: number, totalMs: number) => number);
+interface PhraseUnit {
+    pcm: Float64Array;
+    posMs: number;
+    skipMs: number;
+    lengthMs: number;
+    fadeInMs: number;
+    fadeOutMs: number;
+    consonantMs: number;
+    cutMs?: number;
+}
+interface RenderPhraseParams {
+    units: PhraseUnit[];
+    pitch: CurveInput;
+    gender?: CurveInput;
+    tension?: CurveInput;
+    breathiness?: CurveInput;
+    voicing?: CurveInput;
+    tempo?: number;
+}
 interface RenderNoteParams {
     /**
      * Source phoneme PCM normalised to [-1, 1] (e.g. from
@@ -485,6 +512,7 @@ declare class Worldline {
      * @returns Float32 PCM, or null when `pcm` is shorter than
      *          {@link MIN_WORLDLINE_SAMPLES} (too short for stable F0 analysis).
      */
+    renderPhrase(params: RenderPhraseParams): Float32Array | null;
     renderNote(params: RenderNoteParams): Float32Array | null;
 }
 
@@ -503,4 +531,303 @@ declare function parseKoeHeader(headerBytes: ArrayBuffer): {
 /** Byte offset where PCM data begins, given the JSON length. */
 declare const pcmBase: (jsonLength: number) => number;
 
-export { type FrqData, KoeEngine, type KoeEngineOptions, MIN_WORLDLINE_SAMPLES, type Manifest, type NoteEvent, type OtoEntry, type PackInput, type PackOutput, type PhonemeEntry, type PlayOptions, type RenderNoteParams, type TrimmedPhoneme, VoiceBank, WORLDLINE_SAMPLE_RATE, type WavData, Worldline, type WorldlineLoadOptions, type ZipFile, detectF0, frqAverageF0InRange, frqFileName, leadInFromEntry, normalizePcm, noteNameToHz, otoRegion, pack, packKoe, parseFrq, parseFrqAverageF0, parseKoeHeader, parseOto, parseWav, pcmBase, pitchFromAliasSuffix, readWavPcm48k, resample, samplesToMs, toInt16, toMono, trimToOto, unzipToFileMap };
+/**
+ * Frame-level acoustic features used to locate mora boundaries.
+ *
+ * Everything downstream reasons in *frames* at a fixed 2 ms hop, so a frame
+ * index doubles as a millisecond timestamp once multiplied by {@link HOP_MS}.
+ * The analysis runs at 16 kHz regardless of the source rate: that is well past
+ * the 4–8 kHz band where fricative noise lives, and keeps a 512-point FFT to
+ * 32 ms — short enough to see a plosive burst, long enough to resolve F1.
+ */
+
+interface Frames {
+    /** Number of frames. */
+    n: number;
+    /** Source duration in milliseconds. */
+    durationMs: number;
+    /** Short-time level in dBFS, −120 for digital silence. */
+    rmsDb: Float32Array;
+    /** {@link rmsDb} smoothed over ~30 ms, for threshold crossings. */
+    smoothDb: Float32Array;
+    /** Normalised autocorrelation peak, 0–1. Above ~0.5 reads as voiced. */
+    voiced: Float32Array;
+    /** Share of spectral energy above 4 kHz — high for /s/, /sh/, /ch/. */
+    highRatio: Float32Array;
+    /** Level of the >4 kHz band alone, in dB. Frication shows here first. */
+    highDb: Float32Array;
+    /** Noise floor of {@link highDb}, in dB. */
+    highFloorDb: number;
+    /** Positive spectral flux, normalised so its own median is 1. */
+    flux: Float32Array;
+    /** Median f0 of the voiced portion, in Hz (0 when nothing is voiced). */
+    f0: number;
+    /** Noise floor in dBFS, estimated from the quietest tenth of the file. */
+    floorDb: number;
+    /**
+     * Level of the quietest 50 ms in the file — a true noise floor, unlike
+     * {@link floorDb}, which a short recording's own voice can drag upwards.
+     * Used to trace an attack back past the point where it is merely audible.
+     */
+    quietDb: number;
+    /** Loudest smoothed frame, in dBFS. */
+    peakDb: number;
+}
+/** Extract every feature the mora estimator needs from one mono signal. */
+declare function analyze(wav: WavData): Frames;
+/** Convenience wrapper: decode a WAV buffer and analyse it. */
+declare function analyzeWav(buf: ArrayBuffer): Frames;
+
+/**
+ * Kana → phoneme tables for oto.ini generation.
+ *
+ * A UTAU recording's filename *is* its phonetic transcript: `か.wav` holds one
+ * mora, `_ああいあうえあ.wav` holds seven. Everything the estimator does — where
+ * to look for the vowel, how wide to make the crossfade, whether the overlap
+ * goes negative — follows from which consonant a mora starts with, so the kana
+ * has to be resolved into (consonant, vowel) before any audio is touched.
+ */
+/**
+ * Articulation class of a mora's initial consonant. The estimator branches on
+ * this to pick where the preutterance lands and what overlap the mora gets;
+ * see `ARTICULATION` in `estimate.ts`.
+ */
+type ConsonantClass = 
+/** あ/い/う/え/お — no consonant at all. */
+"vowel"
+/** ん — a syllabic nasal that is its own nucleus. */
+ | "nasalN"
+/** な/ま行 — voiced throughout, vowel starts at the nasal release. */
+ | "nasal"
+/** ら行 — a flap: brief closure, then the vowel. */
+ | "liquid"
+/** や/わ行 and vowel glides (いぇ, うぉ) — barely a consonant at all. */
+ | "semivowel"
+/** さ/は行 — voiceless noise, so voicing onset *is* the vowel onset. */
+ | "fricativeVoiceless"
+/** ざ行, ヴ — voiced noise. */
+ | "fricativeVoiced"
+/** つ/ち — a stop released into friction; behaves like a plosive. */
+ | "affricate"
+/** か/た/ぱ行 — a silent closure precedes the burst. */
+ | "plosiveVoiceless"
+/** が/だ/ば行 — may prevoice through the closure. */
+ | "plosiveVoiced";
+interface Syllable {
+    /** The kana as written, e.g. "きゃ". Used verbatim in the alias. */
+    kana: string;
+    /** Romanised onset, e.g. "ky". Empty for bare vowels and ん. */
+    consonant: string;
+    /** Romanised nucleus: a/i/u/e/o, or "n" for ん. */
+    vowel: string;
+    cls: ConsonantClass;
+}
+/**
+ * Katakana → hiragana, so ヴァ and ゔぁ resolve identically. Only the kana
+ * block is folded; ー and everything else is left alone for the caller to
+ * reject.
+ */
+declare function toHiragana(s: string): string;
+/**
+ * Split a kana string into moras.
+ *
+ * Returns null if any character is not kana we can resolve — that is the
+ * signal to skip the file entirely, which is what keeps a bank's karaoke
+ * tracks and readme audio out of the generated oto.ini.
+ */
+declare function splitKana(text: string): Syllable[] | null;
+
+/**
+ * Parameter estimation for oto.ini entries.
+ *
+ * The rules encoded here follow the UTAU音源制作wiki's 原音設定 articles
+ * (https://w.atwiki.jp/vbmaker/pages/17.html and its 単独音 / 連続音 sequels):
+ *
+ * - オフセット sits just before the consonant, keeping a little room so the
+ *   attack is never clipped.
+ * - 先行発声 marks where the *vowel* begins — the voicing onset for a voiceless
+ *   consonant, the release for a nasal or a flap, the midpoint of the glide for
+ *   や/わ行.
+ * - 子音部 runs from the offset through the vowel's onset until the spectrum
+ *   settles, so a long note stretches only steady-state vowel.
+ * - オーバーラップ is ~20 ms for さ/な/ま/ら行, ~30 ms for や/わ行, and goes
+ *   *negative* for 破裂音 to reproduce the silent closure of か/た/ぱ行.
+ * - 右ブランク lands just before the note starts to decay.
+ */
+
+/** Frame positions the oto parameters are built from. */
+interface MoraPosition {
+    /** Frame where the consonant (or vowel, if there is none) begins. */
+    consStart: number;
+    /** Frame where the vowel begins — the 先行発声 anchor. */
+    vowelOnset: number;
+    /** Frame past which the vowel is steady. */
+    stable: number;
+    /** True when a voiced stop prevoiced into its burst. */
+    prevoiced: boolean;
+}
+/**
+ * Locate one mora inside `[from, to)`, given what consonant it starts with.
+ */
+declare function locateMora(f: Frames, cls: ConsonantClass, from: number, to: number): MoraPosition;
+/**
+ * 単独音: one mora per file, one entry per alias.
+ *
+ * `aliases` lets a caller emit the usual family for a file — the bare kana plus
+ * a `- か` head variant — all sharing the same measurements.
+ */
+declare function estimateSolo(wav: string, f: Frames, syl: Syllable, aliases: string[]): OtoEntry[];
+/**
+ * A 母音結合 entry (`* あ`): a mid-phrase vowel taken from the steady part of
+ * the note, with the long symmetric crossfade those aliases are used with.
+ */
+declare function estimateVowelJoin(wav: string, f: Frames, syl: Syllable, alias: string): OtoEntry | null;
+/** A 連続音 recording's rhythmic grid. */
+interface Grid {
+    /** Frame of the first mora's onset. */
+    start: number;
+    /** Frames between successive moras. */
+    interval: number;
+    /** Per-mora onset frames, snapped to the strongest nearby transition. */
+    onsets: number[];
+}
+/**
+ * Fit `count` evenly spaced moras to the recording.
+ *
+ * 連続音 lists are sung to a guide BGM, so the moras land on a metronomic grid —
+ * which is exactly why the wiki treats 連続音 oto as something you *generate*
+ * and then touch up. Fitting a global tempo first, and only then snapping each
+ * mora to the nearest real transition, keeps one mis-detected onset from
+ * dragging the rest of the file out of alignment.
+ */
+declare function detectGrid(f: Frames, count: number): Grid | null;
+/**
+ * 連続音: every mora in the file gets an entry, aliased against the vowel it
+ * follows (`a か`), with the first written as a phrase head (`- あ`).
+ *
+ * The template — 先行発声 at half the mora interval, オーバーラップ at a third of
+ * that, 固定範囲 half again as long, 右ブランク two thirds of an interval past the
+ * note — is the one the established 連続音 banks ship, and it survives a mora
+ * whose consonant is longer than average because half an interval is far more
+ * room than any Japanese onset needs.
+ */
+declare function estimateSequence(wav: string, f: Frames, syllables: Syllable[], opts?: {
+    suffix?: string;
+    prefix?: string;
+    trailingRest?: boolean;
+}): OtoEntry[];
+
+/**
+ * Folder → oto.ini, with no manual step in between.
+ *
+ * The filename carries the transcript, so the recording style falls out of it:
+ * one mora per file is 単独音, several is 連続音. Everything else — which
+ * aliases to emit, where the phrase head goes, whether a trailing R belongs on
+ * the end — follows from the same parse.
+ */
+
+interface GenerateOptions {
+    /**
+     * Appended to every alias — the usual home for a multi-pitch or expression
+     * marker (`_G4`, `強`). Defaults to the folder's own note name when it has
+     * one; pass `""` to suppress that.
+     */
+    suffix?: string;
+    /** Emit `- か` phrase-head aliases alongside the bare kana. Default true. */
+    headAliases?: boolean;
+    /** Emit `* あ` 母音結合 aliases for vowel-only files. Default true. */
+    vowelJoinAliases?: boolean;
+}
+/** One file that could not be transcribed, and why. */
+interface SkippedFile {
+    wav: string;
+    reason: string;
+}
+interface GenerateResult {
+    entries: OtoEntry[];
+    skipped: SkippedFile[];
+    /** Recording style inferred from the filenames. */
+    style: "solo" | "sequence" | "mixed" | "empty";
+}
+/** What one recording produced. */
+interface FileResult {
+    entries: OtoEntry[];
+    /** Set instead of entries when the file could not be set up. */
+    skipped: SkippedFile | null;
+    /** Style this one file was read as, or null if it was skipped. */
+    style: "solo" | "sequence" | null;
+}
+interface WavInput {
+    /** Filename as it appears in oto.ini, e.g. `_ああいあう.wav`. */
+    name: string;
+    data: ArrayBuffer;
+}
+interface Transcript {
+    syllables: Syllable[];
+    trailingRest: boolean;
+    /** Non-kana marker before the kana, e.g. the `x` of `_xか.wav`. */
+    prefix: string;
+    /** Non-kana marker after the kana, e.g. the `b` of `_あb.wav`. */
+    mark: string;
+}
+/**
+ * Read the transcript out of a filename.
+ *
+ * The leading `_` that marks a recording-list file, an extension, and a
+ * trailing pitch tag are all noise; what is left has to be kana end to end, or
+ * the file is not a voice sample we can set up (a karaoke track, a sample song,
+ * a readme recording).
+ */
+declare function transcribe(filename: string): Transcript | null;
+/**
+ * Alias suffix implied by a folder's name.
+ *
+ * A multi-pitch bank keeps one folder per pitch and merges every oto.ini into
+ * one alias namespace, so without the pitch tag each folder's `- あ` would
+ * overwrite the last. The tag is taken either from a folder named for nothing
+ * but the pitch (`G4`) or from an explicit `_G4` token inside a longer name
+ * (`多音階03：_G4（連続音）`). A bare `G4` buried in a name is left alone — in
+ * `表情音01：強（G4歌連続音）` it describes the take, and the suffix the bank
+ * actually uses there is `強`, which no filename carries.
+ */
+declare function suffixFromFolderName(folder: string): string;
+/**
+ * Estimate oto.ini entries for every WAV in one folder.
+ *
+ * Decoding and analysis are per-file and independent, so a bad WAV is reported
+ * and skipped rather than failing the folder.
+ */
+declare function generateOtoForFile(file: WavInput, options?: GenerateOptions): FileResult;
+/**
+ * Estimate oto.ini entries for every WAV in one folder.
+ *
+ * Decoding and analysis are per-file and independent, so a bad WAV is reported
+ * and skipped rather than failing the folder. A caller that needs to stay
+ * responsive — a browser UI, say — should drive {@link generateOtoForFile}
+ * itself and yield between files.
+ */
+declare function generateOto(files: readonly WavInput[], options?: GenerateOptions): GenerateResult;
+/** Fold per-file styles into the one label that describes the folder. */
+declare function summarise(solo: number, sequence: number): GenerateResult["style"];
+
+/**
+ * oto.ini serialisation.
+ *
+ * UTAU reads oto.ini as Shift-JIS, and OpenUtau follows a bank's declared
+ * encoding, so writing UTF-8 would leave every kana alias mojibake in the
+ * original editor. There is no Shift-JIS *encoder* in the platform — only a
+ * decoder — so the table is built by decoding every legal byte pair once and
+ * inverting the result.
+ */
+
+/**
+ * Encode text as Shift-JIS. Characters with no Shift-JIS form become `?`,
+ * matching what UTAU's own tools do rather than corrupting the line.
+ */
+declare function encodeShiftJis(text: string): Uint8Array;
+/** Render entries as oto.ini text (CRLF, as UTAU writes it). */
+declare function formatOto(entries: readonly OtoEntry[]): string;
+/** Render entries as Shift-JIS oto.ini bytes, ready to write to disk. */
+declare function encodeOto(entries: readonly OtoEntry[]): Uint8Array;
+
+export { type ConsonantClass, type FileResult, type Frames, type FrqData, type GenerateOptions, type GenerateResult, type Grid, KoeEngine, type KoeEngineOptions, MIN_WORLDLINE_SAMPLES, type Manifest, type MoraPosition, type NoteEvent, type OtoEntry, type PackInput, type PackOutput, type PhonemeEntry, type PlayOptions, type RenderNoteParams, type SkippedFile, type Syllable, type TrimmedPhoneme, VoiceBank, WORLDLINE_SAMPLE_RATE, type WavData, type WavInput, Worldline, type WorldlineLoadOptions, type ZipFile, analyze, analyzeWav, detectF0, detectGrid, encodeOto, encodeShiftJis, estimateSequence, estimateSolo, estimateVowelJoin, formatOto, frqAverageF0InRange, frqFileName, generateOto, generateOtoForFile, leadInFromEntry, locateMora, normalizePcm, noteNameToHz, otoRegion, pack, packKoe, parseFrq, parseFrqAverageF0, parseKoeHeader, parseOto, parseWav, pcmBase, pitchFromAliasSuffix, readWavPcm48k, resample, samplesToMs, splitKana, suffixFromFolderName, summarise, toHiragana, toInt16, toMono, transcribe, trimToOto, unzipToFileMap, zipFiles };