@kongyo2/kongyoroid 1.0.0 → 2.0.0

package/README.md

@@ -2,6 +2,239 @@
 
 LLM エージェントが CLI やライブラリとして扱う前提で作った、日本語の**読み上げ**と**歌唱**のツールです。
 
+- **内蔵エンジンが本体**です。外部サービスも GPU も不要で、`npm install` だけで漢字かな交じり文を読み、歌います。同じリクエストからは常にビット単位で同じ WAV が出ます。
+- **JSON で会話します。** 入力は JSON Schema 付きのリクエスト、出力は 1 行 1 JSON。失敗は構造化エラー (`code` / `path` / `hint` / `repairOptions`) と終了コードで返します。
+- **レンダリングの前に確認できます。** `validate` と `plan` が読み (アクセント付きかな)、音素、音符の時刻、推定尺、警告を返すので、エージェントは音声を書き出す前に直せます。
+
+## 要件とインストール
+
+- Node.js 22.18 以上 (ESM)。
+- 依存は日本語テキストフロントエンド `kanji2koe-openjtalk` (jpreprocess + NAIST-JDic の WebAssembly、約 20 MB) のみ。初回ロードに 0.5 秒前後かかり、以降はプロセス内で再利用されます。
+
+```sh
+npm install @kongyo2/kongyoroid
+npx kongyoroid doctor
+```
+
+`doctor` が `"ok": true` を返せば、フロントエンドと合成器が動いています。
+
+## 30 秒で使う
+
+```sh
+# 読み上げ (漢字・数字・日付・英単語をそのまま)
+kongyoroid speak --text "テストが3件失敗しました。ログを確認してください。" -o result.wav
+
+# 歌唱 (歌詞 + 音名 + 拍)
+kongyoroid sing --lyrics "きらきらぼし" --melody "C4 C4 G4 G4 A4 A4" --beats "1 1 1 1 1 2" -o twinkle.wav
+
+# 書き出す前に読みを確認する
+kongyoroid plan --text "橋の端で箸を使う" | jq .plan.reading.kana
+# "ハシ'ノ/ハシデ/ハ'シヲ/_ツカウ。"
+
+# 読みを直す
+kongyoroid speak --text "kongyoroidは便利です" --dict-entry kongyoroid=コンギョロイド:0 -o dict.wav
+kongyoroid speak --text "橋の端" --kana "ハシ'ノ/ハシ" -o hashi.wav
+
+# 文が届き次第、音声を流す (LLM の出力をそのまま再生)
+llm-agent run | kongyoroid speak --input - --stream --output - --format pcm | aplay -f S16_LE -r 24000 -c 1
+```
+
+すべてのコマンドは標準出力に 1 行の JSON を書きます。
+
+```json
+{"ok":true,"path":"/work/result.wav","written":true,"unchanged":false,"engine":"formant","engineVersion":"formant-2.0.0","kind":"speech","voice":"neutral","kana":"テ'_ストガ/サン'ゲン/シッパイ/シマ'_シタ。","sha256":"66b3…","requestHash":"42de…","bytes":108942,"sampleRate":24000,"channels":1,"frames":54449,"durationSeconds":2.269,"peak":0.4772,"rms":0.081,"limitedSamples":0,"warnings":[],"adjustments":[]}
+```
+
+## エージェント向けの作法
+
+1. **`validate` → `plan` → `speak` / `sing` / `render`** の順に使うと、失敗を最短で直せます。`validate` は構造と意味 (読める文字か、音符が短すぎないか、音域内か) を検査して推定尺とハッシュを返し、`plan` は読みと時刻表を返します。どちらも音声を書きません。
+2. **エラーは `code` で分岐**してください。メッセージは人間向けで変わり得ます。`path` は JSON Pointer 風 (`$.notes[1].beats`、フラグなら `$flags.speed`)、`repairOptions[].action` は機械可読な修正案です。
+3. **終了コード**: `0` 成功、`1` 内部エラー、`2` 入力エラー (直して再送)、`3` エンジン利用不可 (VOICEVOX 未起動やフロントエンド破損)、`4` 入出力エラー (上書き拒否など)、`130` 中断。
+4. **同じ内容の再書き出しは no-op** です。`--output` の既存ファイルが同一内容なら `"unchanged": true`、異なる内容なら `IO_ERROR` と `use-force` の修正案を返します。
+5. **決定性**: 同じリクエスト・同じ `seed`・同じバージョンなら WAV は同一です。`requestHash` (正規化したリクエスト) と `planHash` (合成計画) で差分を追えます。
+6. **長文は `--stream`** で文単位に流し、短い通知はキャッシュ (`--cache-dir`) を効かせてください。
+
+エラーの例:
+
+```json
+{"ok":false,"error":{"code":"NOTE_TOO_SHORT","message":"Note n1 (カ) leaves only 25 ms for 1 vowel(s); at least 30 ms are needed.","retryable":false,"path":"$.notes[0].beats","hint":"Give the note more beats, lower the tempo, or use fewer moras in the lyric.","detail":{"availableMs":25,"requiredMs":30,"noteId":"n1"},"repairOptions":[{"action":"increase-duration","description":"Give the note more beats or lower the tempo.","path":"$.notes[0].beats"},{"action":"use-vowel-continuation","description":"Move some moras to neighbouring notes or hold the previous vowel.","path":"$.notes[0].lyric"}]}}
+```
+
+コマンドの完全な一覧と出力形式は [docs/cli.md](docs/cli.md)にあります。
+
+## テキストの読み方
+
+内蔵エンジンは次の順で文章を読みます。
+
+1. **正規化**: 日付 (`2026/09/07` → 2026年9月7日)、時刻 (`9:05` → 9時5分)、バージョン (`v1.2.3` → ブイ1テン2テン3)、単位 (`3ms` → 3ミリ秒、`100kg`、`25℃`)、通貨 (`¥1,200`、`$5`)、符号と範囲 (`-5`、`10〜20`)、`#42`、URL とメールアドレス (記号を読み下し、`URL_READ_LITERALLY` の助言付き)、Markdown の行頭記号、全角/半角。
+2. **英単語**: 約 500 語の技術系レキシコン (`npm`、`API`、`Claude Code`、`GitHub`、`deploy` …) をカタカナとアクセントに置き換えます。頭字語は「最後の文字の先頭にアクセント」(エーピーア'イ) で読み、フロントエンドが文字ごとに分割してしまう読みを 1 つのアクセント句にまとめます。未知の 5 文字以上の英単語には `ASCII_WORD_UNKNOWN` の助言が付きます。
+3. **形態素解析とアクセント**: jpreprocess (OpenJTalk の Rust 実装) と NAIST-JDic で読みとアクセント核、アクセント句境界を決めます。数詞・助数詞 (3件 → サン'ゲン、一本 → イッ'ポン)、助詞の付属、母音の無声化 (デ_ス) を含みます。
+4. **辞書**: リクエストの `dictionary`、`--dict-entry`、`--dictionary` ファイル (`KONGYOROID_DICTIONARY`) の順で表記を読みに置き換え、指定があればアクセントも上書きします。同じ読みが文中に複数ある場合は位置で照合するので、「橋の端」で `端 → ハシ (0)` を登録しても橋のアクセントは変わりません。
+5. **読めない文字**: フロントエンドが黙って落とす文字 (幽霊文字、ハングル、絵文字など) は既定で `UNREADABLE_TEXT` エラーになり、位置 (`sourceSpan`) と修正案 (かな指定・辞書追加・削除) を返します。`strictReading: false` (`--no-strict-reading`) なら警告付きで読み飛ばします。
+
+読みは `reading` コマンドか `plan` で確認できます。各アクセント句には `accentSource` (`frontend` / `dictionary` / `lexicon` / `user` / `rule`) が付き、どこから来た読みかが分かります。
+
+### かな記法
+
+`kana` を与えるとテキスト解析を飛ばして、その通りに読みます。
+
+| 記号 | 意味 | 例 |
+| --- | --- | --- |
+| `'` | 直前のモーラがアクセント核。無ければ平板 (0 型) | `ハ'シ` (橋)、`ハシ'` (端…尾高)、`ハシ` (平板) |
+| `/` | アクセント句の境界 (ポーズなし) | `コンニチワ'/セカ'イ` |
+| `、` | 短いポーズ (既定 0.2 秒) | `ハ'イ、ワカリマ'_シタ` |
+| `。` `？` `！` | 文末。`？` は文末上昇、`！` は文全体を強める | `デ_スカ？` |
+| `_` | 直後のモーラを無声化 | `_シテ`、`デ_ス` |
+| `ー` | 長音 | `トーキョー` |
+
+ひらがなでもカタカナでも構いません。`_` が 1 つも無い場合は、無声化規則 (無声子音に挟まれた イ・ウ、文末の ス) を自動で適用します。末尾の `、` は末尾ポーズとして残り、`。` などの文末記号は末尾に無音を足しません (末尾の無音は `postPause` で決めます)。
+
+## 読み上げのパラメータ
+
+| フィールド (CLI フラグ) | 既定 | 内容 |
+| --- | --- | --- |
+| `voice` (`--voice`) | `neutral` | 内蔵ボイス: `neutral` `female` `male` `child` `soft` `bright` `deep` |
+| `speed` (`--speed`) | 1 | 話速倍率 0.25–4。子音・母音・ポーズを一様に縮めます |
+| `pitchSemitones` (`--pitch-semitones`) | 0 | 基本ピッチの半音シフト −24..24 |
+| `pitch` (`--pitch`) | – | VOICEVOX 互換の `pitchScale` (F0 × 2^pitch)。`pitchSemitones` と排他 |
+| `intonation` (`--intonation`) | 1 | 抑揚の幅 0–3。0 でほぼ平坦 |
+| `volume` / `gainDb` | 1 / – | 出力レベル (線形 0–3、または dB)。ソフトリミッターの前段 |
+| `breathiness` (`--breathiness`) | 0 | 声門の張り −1..1.5。正で息っぽく |
+| `prePause` / `postPause` | 0.1 / 0.1 | 前後の無音 (秒) |
+| `pauseLength` / `pauseScale` | – / 1 | `、` の絶対長 (秒) と、全ポーズの倍率 |
+| `upspeak` (`--no-upspeak`) | true | 疑問文末の上昇 |
+| `sampleRate` (`--sample-rate`) | 24000 | 8000–48000 Hz |
+| `seed` (`--seed`) | 1 | ノイズ・揺らぎの種 |
+
+イントネーションは藤崎モデル (フレーズ指令 + アクセント指令) で生成し、文末の下降、疑問の上昇、感嘆の強調、段落末の長いポーズを付けます。
+
+## 歌唱
+
+譜面は 3 つの形で渡せます。
+
+```jsonc
+// 1. 音符リスト (最も細かい制御)
+{ "kind": "song", "tempo": 90, "voice": "male",
+  "notes": [
+    { "key": null, "beats": 0.5 },
+    { "id": "sa", "key": "E4", "beats": 1, "lyric": "さ" },
+    { "id": "ku", "key": "E4", "beats": 1, "lyric": "く", "velocity": 110 },
+    { "id": "ra", "key": "F4", "beats": 2, "lyric": "ら" },
+    { "id": "ra-hold", "key": "F4", "beats": 2, "continuation": "tie", "vibrato": { "depthCents": 45 } },
+    { "id": "ra-up", "key": "G4", "beats": 1, "continuation": "melisma" },
+    { "key": "C4", "beats": 2, "lyric": "きら" }        // 1 音に複数モーラ (最大 8)
+  ] }
+
+// 2. コンパクト譜 (歌詞 + 音名 + 拍)
+{ "kind": "song", "notes": { "lyrics": "きらきらぼし", "melody": "C4 C4 G4 G4 A4 ~ ~G4 R", "beats": "1 1 1 1 1 1 1 1" } }
+
+// 3. MML
+{ "kind": "song", "notes": { "mml": "t132 o4 l8 e e r e r c e4 g4 r4 <g4", "lyrics": "ららららら" } }
+```
+
+- `~` (タイ) は直前の母音を同じ高さで伸ばし、`~G4` (メリスマ) は高さを変えて伸ばします。母音は再アタックせず、ポルタメント (`portamentoMs`、既定 60 ms) で滑らかにつながります。
+- 同じ母音が続く音符 (「ああ」) は既定で再アーティキュレーション (`rearticulate`: 短い減衰と再アタック) になり、`articulation: "legato"` で連結できます。
+- `velocity` (1–127) または `gainDb` で音ごとの強さ、`vibrato` (`depthCents` / `rateHz` / `delayMs` / `fadeMs` または `false`) で持続音ごとのビブラート、`portamentoMs` で音ごとの移行時間を指定できます。`scoopCents` / `scoopMs` はフレーズ頭のしゃくりです。
+- 子音は前の休符・前の音符の末尾 (最大 40 %) から借りて、母音が拍頭に乗るように配置します。足りない時は子音を短縮して `CONSONANT_COMPRESSED` を `adjustments` に記録し、`consonantCompression: false` なら `NOTE_TOO_SHORT` で失敗します。母音が 30 ms を切る音符は常に `NOTE_TOO_SHORT` です。
+- 音域は 30–2500 Hz (かつサンプルレートの 20 %)。外れると `PITCH_OUT_OF_RANGE`、ボイスの得意音域を外れると `F0_OUTSIDE_VOICE_RANGE` の警告です。
+- 音高精度: 持続母音で 1 セント以内、拍ごとに変わる音階で 8 セント以内 (テストで検証)。
+
+`plan` の `notes[]` には音ごとの開始・母音開始・終了時刻、`sustainId`、`continuation`、`articulation` が入ります。
+
+## ストリーミング
+
+```sh
+# 文が確定するたびに合成し、PCM (s16le mono) を流す
+kongyoroid speak --input - --stream --output - --format pcm
+
+# 未確定長 WAV / NDJSON (文イベント + base64 音声ブロック)
+kongyoroid speak --input - --stream --output - --format wav
+kongyoroid speak --input - --stream --output - --format ndjson
+
+# ファイルへ (最後にヘッダーを書き戻す)
+kongyoroid speak --input - --stream -o long.wav --progress
+```
+
+文の切れ目 (`。！？` と改行) で分割し、次の文を先読みして合成するので、途切れません。文間ポーズは次の文の先頭に付くため、一括合成した場合と同じ長さになります。ライブラリでは `agent.speakStream(asyncIterable)` が `sentence` / `audio` / `end` イベントを返します。
+
+## 内蔵ボイス
+
+| id | 基本 F0 | 特徴 |
+| --- | --- | --- |
+| `neutral` | 170 Hz | 中性的な中音域。通知・検証の既定 |
+| `female` | 225 Hz | 短めの声道、やや息混じり |
+| `male` | 115 Hz | 長めの声道、張りのある声門 |
+| `child` | 290 Hz | 小さな声道と高いピッチ |
+| `soft` | 185 Hz | 息の多い穏やかな声、抑揚控えめ |
+| `bright` | 215 Hz | 張った明瞭な声、抑揚大きめ |
+| `deep` | 92 Hz | とても低い声、落ち着いた調子 |
+
+`kongyoroid voices` で音域とハッシュを確認できます。歌唱でも同じボイスを使います。
+
+## キャッシュとファイル
+
+- `--cache-dir DIR` (または `KONGYOROID_CACHE_DIR`) を与えると、`DIR/kongyoroid-cache/` の中だけに `.kcache` ファイルを書きます。`cache prune` / `cache clear` はこの名前空間の外に触りません。無関係なファイルが混ざっていても消しません。
+- キャッシュキーはエンジン・パッケージ版・エンジン版・フロントエンド版・辞書ダイジェスト・正規化リクエストから作るので、更新後に古い音声が返ることはありません。
+- 同時に同じリクエストが来た場合は 1 回だけ合成します (in-flight dedupe)。
+- 出力は一時ファイルに書いてからハードリンク/リネームするので、途中で落ちても壊れたファイルは残りません。
+
+## ライブラリとして使う
+
+```ts
+import { Kongyoroid } from "@kongyo2/kongyoroid";
+
+const agent = new Kongyoroid({
+  voice: "female",
+  dictionary: [{ surface: "kongyoroid", reading: "コンギョロイド", accent: 0 }],
+  cache: { directory: "./cache" },
+});
+
+// 読み上げ
+const speech = await agent.speak("kongyoroidは便利です。");
+speech.audio; // Uint8Array (WAV)
+speech.kana; // "コンギョロイドワ/ベ'ンリデ_ス。"
+
+// 歌唱
+const song = await agent.sing({ notes: { lyrics: "ドレミ", melody: "C4 D4 E4" }, tempo: 100 });
+
+// 確認してから書き出す
+const check = await agent.validate({ kind: "speech", text: "…" });
+if (check.renderable) {
+  const plan = await agent.plan({ kind: "speech", text: "…" }, "phonemes");
+  const compiled = await agent.compile({ kind: "speech", text: "…" });
+  const result = await agent.renderPlan(compiled.plan, { requestHash: compiled.requestHash });
+}
+
+// 文単位のストリーミング
+for await (const event of agent.speakStream(tokens())) {
+  if (event.type === "audio") play(event.block.samples); // Float32Array
+}
+```
+
+`Kongyoroid` の他に、テキスト処理 (`readJapanese`、`normalizeForReading`、`parseKanaNotation`、`LocalDictionary`)、計画 (`compileRequest`、`planSpeech`、`planSong`)、レンダリング (`PlanRenderer`、`renderPcm`、`renderPcmStream`、`encodePlanAsync`)、解析 (`estimatePitch`、`inspectWav`)、譜面 (`parseMml`、`parseScoreText`) を個別に import できます。型はすべて `dist/index.d.ts` に含まれます。
+
+## VOICEVOX (任意)
+
+VOICEVOX ENGINE が起動していれば、`--speaker` / `--singer` / `--teacher` (id か名前) を付けるだけで、そのスタイルで合成します。`--engine auto` はエンドポイントが応答すれば VOICEVOX、応答しなければ内蔵エンジンにフォールバックします。`dict --scope voicevox` でユーザー辞書、`voices --engine voicevox` でスタイル一覧、`doctor --engine voicevox` で診断ができます。VOICEVOX の歌唱は 1 音 1 モーラで、タイ・メリスマ・複数モーラは内蔵エンジン専用です。
+
+## 制限と環境変数
+
+| 項目 | 値 |
+| --- | --- |
+| テキスト / かな | 20,000 文字 |
+| 音符 | 4,096 個 |
+| 内蔵エンジンの 1 リクエスト | 1,800 秒 |
+| 入力ファイル | 8 MiB |
+| バッチ行数 / 並列度 | 10,000 / 16 |
+| 辞書エントリ | 20,000 |
+
+環境変数: `KONGYOROID_ENGINE`、`KONGYOROID_VOICE`、`KONGYOROID_DICTIONARY`、`KONGYOROID_CACHE_DIR`、`KONGYOROID_ENDPOINT` (別名 `VOICEVOX_URL`)、`KONGYOROID_SPEAKER`、`KONGYOROID_SINGER`、`KONGYOROID_TEACHER`。`kongyoroid capabilities` が対応機能・制限・エラーコードを JSON で返します。
+
+## ドキュメント
+
+- [docs/cli.md](docs/cli.md): コマンドと出力形式のリファレンス
+- `examples/`: 内蔵エンジン向け (`builtin/`)、VOICEVOX 向け (`voicevox/`)、バッチ (`batch.jsonl`) の実例
+
 ## ライセンス
 
 MIT

package/dist/cache.d.ts

@@ -1,8 +1,15 @@
 export declare function cacheKey(...parts: readonly unknown[]): string;
+export interface CacheStats {
+    readonly entries: number;
+    readonly bytes: number;
+    readonly budget: number | null;
+    readonly directory?: string;
+}
 export interface RenderCache {
     get(key: string): Promise<Uint8Array | undefined>;
     set(key: string, value: Uint8Array): Promise<void>;
-    clear(): Promise<void>;
+    clear(): Promise<number>;
+    stats(): Promise<CacheStats>;
 }
 export declare class MemoryCache implements RenderCache {
     private readonly entries;
@@ -11,26 +18,44 @@ export declare class MemoryCache implements RenderCache {
     constructor(budgetBytes: number);
     get(key: string): Promise<Uint8Array | undefined>;
     set(key: string, value: Uint8Array): Promise<void>;
-    clear(): Promise<void>;
-    stats(): {
+    clear(): Promise<number>;
+    stats(): Promise<CacheStats>;
+    statsSync(): {
         readonly entries: number;
         readonly bytes: number;
         readonly budget: number;
     };
 }
+export declare const CACHE_NAMESPACE: string;
+export declare const CACHE_FORMAT: string;
+export declare const CACHE_EXTENSION: string;
+export interface DiskCacheOptions {
+    readonly maxBytes?: number;
+    readonly maxEntries?: number;
+}
 export declare class DiskCache implements RenderCache {
-    private readonly directory;
-    constructor(directory: string);
+    readonly root: string;
+    readonly directory: string;
+    private readonly maxBytes;
+    private readonly maxEntries;
+    private prepared;
+    constructor(directory: string, options?: DiskCacheOptions);
     private pathFor;
+    private prepare;
     get(key: string): Promise<Uint8Array | undefined>;
     set(key: string, value: Uint8Array): Promise<void>;
-    clear(): Promise<void>;
+    private entries;
+    stats(): Promise<CacheStats>;
+    clear(): Promise<number>;
+    prune(maxBytes?: number | undefined, maxEntries?: number | undefined): Promise<number>;
+    remove(): Promise<void>;
 }
 export declare class LayeredCache implements RenderCache {
     private readonly layers;
     constructor(layers: readonly RenderCache[]);
     get(key: string): Promise<Uint8Array | undefined>;
     set(key: string, value: Uint8Array): Promise<void>;
-    clear(): Promise<void>;
+    clear(): Promise<number>;
+    stats(): Promise<CacheStats>;
 }
 //# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAKA,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAE7D;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,WAAY,YAAW,WAAW;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0D;IAClF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,IAAI,CAAa;gBAEN,WAAW,EAAE,MAAM;IAI/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAQjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,KAAK,IAAI;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAG9F;AAED,qBAAa,SAAU,YAAW,WAAW;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEhB,SAAS,EAAE,MAAM;IAIpC,OAAO,CAAC,OAAO;IAIF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAQjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAIpC;AAED,qBAAa,YAAa,YAAW,WAAW;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAE7B,MAAM,EAAE,SAAS,WAAW,EAAE;IAI1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAY3C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}

package/dist/cache.js

@@ -1,5 +1,5 @@
 import { createHash, randomUUID } from "node:crypto";
-import { mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { mkdir, readFile, readdir, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
 import { integer } from "./validate.js";
 export function cacheKey(...parts) {
@@ -40,23 +40,58 @@ export class MemoryCache {
         return Promise.resolve();
     }
     clear() {
+        const count = this.entries.size;
         this.entries.clear();
         this.used = 0;
-        return Promise.resolve();
+        return Promise.resolve(count);
     }
     stats() {
+        return Promise.resolve({ entries: this.entries.size, bytes: this.used, budget: this.budget });
+    }
+    statsSync() {
         return { entries: this.entries.size, bytes: this.used, budget: this.budget };
     }
 }
+export const CACHE_NAMESPACE = "kongyoroid-cache";
+export const CACHE_FORMAT = "v2";
+export const CACHE_EXTENSION = ".kcache";
+const MARKER_NAME = "CACHEDIR.TAG";
+const MARKER_TEXT = "Signature: 8a477f597d28d172789f06886806bc55\n# This directory is a kongyoroid render cache. Files here may be deleted at any time.\n";
+const KEY_PATTERN = /^[0-9a-f]{64}$/u;
 export class DiskCache {
+    root;
     directory;
-    constructor(directory) {
-        this.directory = resolve(directory);
+    maxBytes;
+    maxEntries;
+    prepared;
+    constructor(directory, options = {}) {
+        this.root = resolve(directory);
+        this.directory = join(this.root, CACHE_NAMESPACE, CACHE_FORMAT);
+        this.maxBytes = options.maxBytes;
+        this.maxEntries = options.maxEntries;
     }
     pathFor(key) {
-        return join(this.directory, key.slice(0, 2), `${key}.wav`);
+        return join(this.directory, key.slice(0, 2), `${key}${CACHE_EXTENSION}`);
+    }
+    prepare() {
+        this.prepared ??= (async () => {
+            await mkdir(this.directory, { recursive: true });
+            const marker = join(this.root, CACHE_NAMESPACE, MARKER_NAME);
+            try {
+                await stat(marker);
+            }
+            catch {
+                await writeFile(marker, MARKER_TEXT);
+            }
+        })().catch((error) => {
+            this.prepared = undefined;
+            throw error;
+        });
+        return this.prepared;
     }
     async get(key) {
+        if (!KEY_PATTERN.test(key))
+            return undefined;
         try {
             return new Uint8Array(await readFile(this.pathFor(key)));
         }
@@ -65,6 +100,9 @@ export class DiskCache {
         }
     }
     async set(key, value) {
+        if (!KEY_PATTERN.test(key))
+            return;
+        await this.prepare();
         const target = this.pathFor(key);
         const temp = `${target}.${randomUUID()}.tmp`;
         await mkdir(join(this.directory, key.slice(0, 2)), { recursive: true });
@@ -72,13 +110,98 @@ export class DiskCache {
             await writeFile(temp, value);
             await rename(temp, target);
         }
-        catch {
+        catch (error) {
             await unlink(temp).catch(() => undefined);
+            throw error;
+        }
+        if (this.maxBytes !== undefined || this.maxEntries !== undefined)
+            await this.prune();
+    }
+    async entries() {
+        const out = [];
+        let shards;
+        try {
+            shards = await readdir(this.directory);
+        }
+        catch {
+            return out;
+        }
+        for (const shard of shards) {
+            if (!/^[0-9a-f]{2}$/u.test(shard))
+                continue;
+            let names;
+            try {
+                names = await readdir(join(this.directory, shard));
+            }
+            catch {
+                continue;
+            }
+            for (const name of names) {
+                const stem = name.endsWith(CACHE_EXTENSION) ? name.slice(0, -CACHE_EXTENSION.length) : undefined;
+                const isTemp = /\.tmp$/u.test(name);
+                if (stem === undefined || !KEY_PATTERN.test(stem)) {
+                    if (isTemp)
+                        out.push({ path: join(this.directory, shard, name), bytes: 0, mtime: 0 });
+                    continue;
+                }
+                try {
+                    const info = await stat(join(this.directory, shard, name));
+                    out.push({ path: join(this.directory, shard, name), bytes: info.size, mtime: info.mtimeMs });
+                }
+                catch {
+                    continue;
+                }
+            }
         }
+        return out;
+    }
+    async stats() {
+        const entries = (await this.entries()).filter((entry) => entry.mtime > 0);
+        let bytes = 0;
+        for (const entry of entries)
+            bytes += entry.bytes;
+        return { entries: entries.length, bytes, budget: this.maxBytes ?? null, directory: this.directory };
     }
     async clear() {
-        const { rm } = await import("node:fs/promises");
-        await rm(this.directory, { recursive: true, force: true });
+        const entries = await this.entries();
+        let removed = 0;
+        for (const entry of entries) {
+            try {
+                await unlink(entry.path);
+                removed += 1;
+            }
+            catch {
+                continue;
+            }
+        }
+        return removed;
+    }
+    async prune(maxBytes = this.maxBytes, maxEntries = this.maxEntries) {
+        const entries = (await this.entries()).filter((entry) => entry.mtime > 0).sort((a, b) => a.mtime - b.mtime);
+        let bytes = 0;
+        for (const entry of entries)
+            bytes += entry.bytes;
+        let count = entries.length;
+        let removed = 0;
+        for (const entry of entries) {
+            const overBytes = maxBytes !== undefined && bytes > maxBytes;
+            const overCount = maxEntries !== undefined && count > maxEntries;
+            if (!overBytes && !overCount)
+                break;
+            try {
+                await unlink(entry.path);
+                removed += 1;
+                bytes -= entry.bytes;
+                count -= 1;
+            }
+            catch {
+                continue;
+            }
+        }
+        return removed;
+    }
+    async remove() {
+        await rm(join(this.root, CACHE_NAMESPACE), { recursive: true, force: true });
     }
 }
 export class LayeredCache {
@@ -103,7 +226,13 @@ export class LayeredCache {
         await Promise.all(this.layers.map((layer) => layer.set(key, value)));
     }
     async clear() {
-        await Promise.all(this.layers.map((layer) => layer.clear()));
+        const counts = await Promise.all(this.layers.map((layer) => layer.clear()));
+        return counts.reduce((sum, count) => sum + count, 0);
+    }
+    async stats() {
+        const all = await Promise.all(this.layers.map((layer) => layer.stats()));
+        const last = all.at(-1);
+        return last ?? { entries: 0, bytes: 0, budget: null };
     }
 }
 //# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}