@coeiro-operator/audio 1.0.0

package/dist/chunk-generation-manager.d.ts

@@ -0,0 +1,77 @@
+/**
+ * src/core/say/chunk-generation-manager.ts: 並行チャンク生成管理
+ * 複数チャンクの生成を並行して行い、完成順序ではなく論理順序で管理
+ */
+import type { Chunk, AudioResult, VoiceConfig } from './types.js';
+export interface GenerationTask {
+    chunk: Chunk;
+    voiceConfig: VoiceConfig;
+    speed: number;
+    startTime: number;
+    promise: Promise<AudioResult>;
+}
+export interface GenerationOptions {
+    maxConcurrency: number;
+    delayBetweenRequests: number;
+    pauseUntilFirstComplete: boolean;
+}
+/**
+ * チャンク生成の並行制御管理クラス
+ */
+export declare class ChunkGenerationManager {
+    private activeTasks;
+    private completedResults;
+    private options;
+    private synthesizeFunction;
+    private firstChunkCompleted;
+    constructor(synthesizeFunction: (chunk: Chunk, voiceConfig: VoiceConfig, speed: number) => Promise<AudioResult>, options?: Partial<GenerationOptions>);
+    /**
+     * チャンクの生成を開始（並行制御あり）
+     */
+    startGeneration(chunk: Chunk, voiceConfig: VoiceConfig, speed: number): Promise<void>;
+    /**
+     * 指定されたチャンクの生成結果を取得（完了まで待機）
+     */
+    getResult(chunkIndex: number): Promise<AudioResult>;
+    /**
+     * 指定されたチャンクが生成完了しているかチェック
+     */
+    isCompleted(chunkIndex: number): boolean;
+    /**
+     * 指定されたチャンクが生成中かチェック
+     */
+    isInProgress(chunkIndex: number): boolean;
+    /**
+     * 現在の並行生成数を取得
+     */
+    getActiveConcurrency(): number;
+    /**
+     * 完了待ちの結果数を取得
+     */
+    getPendingResultsCount(): number;
+    /**
+     * すべてのタスクの完了を待機
+     */
+    waitForAllTasks(): Promise<void>;
+    /**
+     * すべてのタスクをクリア
+     */
+    clear(): void;
+    /**
+     * 生成統計情報を取得
+     */
+    getStats(): {
+        activeTasks: number;
+        completedResults: number;
+        totalMemoryUsage: number;
+    };
+    private waitForAnyTaskCompletion;
+    /**
+     * 初回チャンク（チャンク0）の完了を待機
+     */
+    private waitForFirstChunkCompletion;
+    private onTaskCompleted;
+    private onTaskFailed;
+    private delay;
+}
+//# sourceMappingURL=chunk-generation-manager.d.ts.map

package/dist/chunk-generation-manager.js

@@ -0,0 +1,178 @@
+/**
+ * src/core/say/chunk-generation-manager.ts: 並行チャンク生成管理
+ * 複数チャンクの生成を並行して行い、完成順序ではなく論理順序で管理
+ */
+import { logger } from '@coeiro-operator/common';
+/**
+ * チャンク生成の並行制御管理クラス
+ */
+export class ChunkGenerationManager {
+    activeTasks = new Map();
+    completedResults = new Map();
+    options;
+    synthesizeFunction;
+    firstChunkCompleted = false; // 初回チャンク完了フラグ
+    constructor(synthesizeFunction, options = {}) {
+        this.synthesizeFunction = synthesizeFunction;
+        this.options = {
+            maxConcurrency: 2,
+            delayBetweenRequests: 100, // 間隔を増加して安定性向上
+            pauseUntilFirstComplete: true, // デフォルトで初回ポーズを有効化
+            ...options,
+        };
+    }
+    /**
+     * チャンクの生成を開始（並行制御あり）
+     */
+    async startGeneration(chunk, voiceConfig, speed) {
+        // 初回ポーズ機能: 初回チャンク完了まで後続チャンクの生成を待機
+        if (this.options.pauseUntilFirstComplete && chunk.index > 0 && !this.firstChunkCompleted) {
+            logger.debug(`チャンク${chunk.index}: 初回チャンク完了まで生成をポーズ`);
+            await this.waitForFirstChunkCompletion();
+        }
+        // 並行数制限のチェック
+        while (this.activeTasks.size >= this.options.maxConcurrency) {
+            await this.waitForAnyTaskCompletion();
+        }
+        // 新しい生成タスクを開始
+        const task = {
+            chunk,
+            voiceConfig,
+            speed,
+            startTime: Date.now(),
+            promise: this.synthesizeFunction(chunk, voiceConfig, speed),
+        };
+        this.activeTasks.set(chunk.index, task);
+        logger.debug(`チャンク${chunk.index}の生成開始 (並行数: ${this.activeTasks.size}, 初回完了: ${this.firstChunkCompleted})`);
+        // 生成完了時の処理を設定
+        task.promise
+            .then((result) => {
+            this.onTaskCompleted(chunk.index, result);
+        })
+            .catch((error) => {
+            this.onTaskFailed(chunk.index, error);
+        });
+        // リクエスト間隔の調整
+        if (this.options.delayBetweenRequests > 0) {
+            await this.delay(this.options.delayBetweenRequests);
+        }
+    }
+    /**
+     * 指定されたチャンクの生成結果を取得（完了まで待機）
+     */
+    async getResult(chunkIndex) {
+        // 既に完了している場合
+        if (this.completedResults.has(chunkIndex)) {
+            const result = this.completedResults.get(chunkIndex);
+            this.completedResults.delete(chunkIndex); // 取得後はクリア
+            return result;
+        }
+        // 生成中の場合は完了を待機
+        const activeTask = this.activeTasks.get(chunkIndex);
+        if (activeTask) {
+            return await activeTask.promise;
+        }
+        throw new Error(`チャンク${chunkIndex}の生成タスクが見つかりません`);
+    }
+    /**
+     * 指定されたチャンクが生成完了しているかチェック
+     */
+    isCompleted(chunkIndex) {
+        return this.completedResults.has(chunkIndex);
+    }
+    /**
+     * 指定されたチャンクが生成中かチェック
+     */
+    isInProgress(chunkIndex) {
+        return this.activeTasks.has(chunkIndex);
+    }
+    /**
+     * 現在の並行生成数を取得
+     */
+    getActiveConcurrency() {
+        return this.activeTasks.size;
+    }
+    /**
+     * 完了待ちの結果数を取得
+     */
+    getPendingResultsCount() {
+        return this.completedResults.size;
+    }
+    /**
+     * すべてのタスクの完了を待機
+     */
+    async waitForAllTasks() {
+        const promises = Array.from(this.activeTasks.values()).map(task => task.promise);
+        await Promise.all(promises);
+    }
+    /**
+     * すべてのタスクをクリア
+     */
+    clear() {
+        this.activeTasks.clear();
+        this.completedResults.clear();
+        this.firstChunkCompleted = false; // 初回完了フラグもリセット
+    }
+    /**
+     * 生成統計情報を取得
+     */
+    getStats() {
+        let totalMemoryUsage = 0;
+        for (const result of this.completedResults.values()) {
+            totalMemoryUsage += result.audioBuffer.byteLength;
+        }
+        return {
+            activeTasks: this.activeTasks.size,
+            completedResults: this.completedResults.size,
+            totalMemoryUsage,
+        };
+    }
+    async waitForAnyTaskCompletion() {
+        if (this.activeTasks.size === 0) {
+            return;
+        }
+        const promises = Array.from(this.activeTasks.values()).map(task => task.promise);
+        await Promise.race(promises);
+    }
+    /**
+     * 初回チャンク（チャンク0）の完了を待機
+     */
+    async waitForFirstChunkCompletion() {
+        // 既に完了している場合は即座に返す
+        if (this.firstChunkCompleted) {
+            return;
+        }
+        // チャンク0のタスクが存在する場合は完了を待機
+        const firstTask = this.activeTasks.get(0);
+        if (firstTask) {
+            await firstTask.promise;
+        }
+        // ポーリングによる確認（安全のため）
+        while (!this.firstChunkCompleted) {
+            await this.delay(10); // 10ms間隔でチェック
+        }
+    }
+    onTaskCompleted(chunkIndex, result) {
+        const task = this.activeTasks.get(chunkIndex);
+        if (task) {
+            const duration = Date.now() - task.startTime;
+            logger.debug(`チャンク${chunkIndex}生成完了 (所要時間: ${duration}ms)`);
+            this.activeTasks.delete(chunkIndex);
+            this.completedResults.set(chunkIndex, result);
+            // 初回チャンク完了フラグの設定
+            if (chunkIndex === 0 && !this.firstChunkCompleted) {
+                this.firstChunkCompleted = true;
+                logger.debug('初回チャンク完了: 並行生成ポーズを解除');
+            }
+        }
+    }
+    onTaskFailed(chunkIndex, error) {
+        logger.error(`チャンク${chunkIndex}生成失敗: ${error.message}`);
+        this.activeTasks.delete(chunkIndex);
+        // エラーの場合は結果をストアしない（getResultで例外が発生）
+    }
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=chunk-generation-manager.js.map

package/dist/constants.d.ts

@@ -0,0 +1,180 @@
+/**
+ * src/say/constants.ts: 音声合成システムのデフォルト定数定義
+ *
+ * 📖 関連ドキュメント：
+ * - docs/configuration-options.md - 設定オプション詳細ガイド
+ * - docs/installation.md - インストール・セットアップガイド（設定例）
+ * - docs/audio-system.md - 音声システム仕様
+ * - docs/config-samples/ - 設定ファイルサンプル
+ *
+ * ⚠️  重要：これらの定数値を変更した場合は、上記ドキュメントも同期更新が必要です
+ *
+ * 🔄 設定値同期チェックリスト：
+ * 1. constants.ts（このファイル）
+ * 2. docs/configuration-options.md の設定表とデフォルト値
+ * 3. docs/installation.md の設定例
+ * 4. docs/config-samples/*.json のサンプル設定
+ * 5. README.md の機能説明（該当する場合）
+ */
+export declare const CONNECTION_SETTINGS: {
+    /** デフォルトホスト */
+    readonly DEFAULT_HOST: "localhost";
+    /** デフォルトポート */
+    readonly DEFAULT_PORT: "50032";
+};
+export declare const SAMPLE_RATES: {
+    /** 音声生成時のサンプルレート（効率重視） */
+    readonly SYNTHESIS: 24000;
+    /** 再生時のサンプルレート（高品質） */
+    readonly PLAYBACK: 48000;
+};
+export declare const AUDIO_FORMAT: {
+    /** チャンネル数（モノラル） */
+    readonly CHANNELS: 1;
+    /** ビット深度 */
+    readonly BIT_DEPTH: 16;
+};
+export declare const BUFFER_SIZES: {
+    /** デフォルトバッファサイズ（CLI安定性のため2048に増強） */
+    readonly DEFAULT: 2048;
+    /** 最小バッファサイズ */
+    readonly MIN: 256;
+    /** 最大バッファサイズ */
+    readonly MAX: 8192;
+    readonly PRESETS: {
+        readonly ULTRA_LOW: {
+            readonly HIGH_WATER_MARK: 64;
+            readonly LOW_WATER_MARK: 32;
+        };
+        readonly BALANCED: {
+            readonly HIGH_WATER_MARK: 512;
+            readonly LOW_WATER_MARK: 256;
+        };
+        readonly QUALITY: {
+            readonly HIGH_WATER_MARK: 512;
+            readonly LOW_WATER_MARK: 256;
+        };
+    };
+};
+export declare const FILTER_SETTINGS: {
+    /** ローパスフィルターのデフォルトカットオフ周波数 */
+    readonly LOWPASS_CUTOFF: 24000;
+    /** ノイズリダクションのデフォルト状態 */
+    readonly NOISE_REDUCTION_DEFAULT: false;
+    /** ローパスフィルターのデフォルト状態 */
+    readonly LOWPASS_FILTER_DEFAULT: false;
+};
+export declare const SPLIT_SETTINGS: {
+    readonly DEFAULTS: {
+        readonly SMALL_SIZE: 30;
+        readonly MEDIUM_SIZE: 50;
+        readonly LARGE_SIZE: 100;
+        readonly OVERLAP_RATIO: 0.1;
+    };
+    readonly PUNCTUATION: {
+        readonly MAX_CHUNK_SIZE: 150;
+        readonly PREFER_SENTENCE: true;
+        readonly ALLOW_COMMA_SPLIT: true;
+        readonly MIN_CHUNK_SIZE: 10;
+        readonly OVERLAP_CHARS: 0;
+    };
+    readonly PRESETS: {
+        readonly ULTRA_LOW: {
+            readonly SMALL_SIZE: 20;
+            readonly MEDIUM_SIZE: 30;
+            readonly LARGE_SIZE: 50;
+            readonly OVERLAP_RATIO: 0.05;
+        };
+        readonly BALANCED: {
+            readonly SMALL_SIZE: 30;
+            readonly MEDIUM_SIZE: 50;
+            readonly LARGE_SIZE: 100;
+            readonly OVERLAP_RATIO: 0.1;
+        };
+        readonly QUALITY: {
+            readonly SMALL_SIZE: 40;
+            readonly MEDIUM_SIZE: 70;
+            readonly LARGE_SIZE: 150;
+            readonly OVERLAP_RATIO: 0.15;
+        };
+    };
+};
+export declare const PADDING_SETTINGS: {
+    readonly DEFAULTS: {
+        readonly ENABLED: true;
+        readonly PRE_PHONEME_LENGTH: 0.01;
+        readonly POST_PHONEME_LENGTH: 0.01;
+        readonly FIRST_CHUNK_ONLY: true;
+    };
+    readonly PRESETS: {
+        readonly ULTRA_LOW: {
+            readonly ENABLED: false;
+            readonly PRE_PHONEME_LENGTH: 0;
+            readonly POST_PHONEME_LENGTH: 0;
+            readonly FIRST_CHUNK_ONLY: true;
+        };
+        readonly BALANCED: {
+            readonly ENABLED: true;
+            readonly PRE_PHONEME_LENGTH: 0.01;
+            readonly POST_PHONEME_LENGTH: 0.01;
+            readonly FIRST_CHUNK_ONLY: true;
+        };
+        readonly QUALITY: {
+            readonly ENABLED: true;
+            readonly PRE_PHONEME_LENGTH: 0.02;
+            readonly POST_PHONEME_LENGTH: 0.02;
+            readonly FIRST_CHUNK_ONLY: false;
+        };
+    };
+};
+export declare const CROSSFADE_SETTINGS: {
+    readonly DEFAULTS: {
+        readonly ENABLED: true;
+        readonly SKIP_FIRST_CHUNK: true;
+        readonly OVERLAP_SAMPLES: 24;
+    };
+    readonly PRESETS: {
+        readonly ULTRA_LOW: {
+            readonly ENABLED: false;
+            readonly SKIP_FIRST_CHUNK: true;
+            readonly OVERLAP_SAMPLES: 0;
+        };
+        readonly BALANCED: {
+            readonly ENABLED: true;
+            readonly SKIP_FIRST_CHUNK: true;
+            readonly OVERLAP_SAMPLES: 24;
+        };
+        readonly QUALITY: {
+            readonly ENABLED: true;
+            readonly SKIP_FIRST_CHUNK: false;
+            readonly OVERLAP_SAMPLES: 48;
+        };
+    };
+};
+export declare const SYNTHESIS_SETTINGS: {
+    /** デフォルト話速（WPM） */
+    readonly DEFAULT_RATE: 200;
+    /** デフォルト音量 */
+    readonly DEFAULT_VOLUME: 1;
+    /** デフォルト音高 */
+    readonly DEFAULT_PITCH: 0;
+    /** デフォルトイントネーション */
+    readonly DEFAULT_INTONATION: 1;
+};
+export declare const STREAM_SETTINGS: {
+    /** チャンク分割の基準文字数 */
+    readonly CHUNK_SIZE_CHARS: 50;
+    /** チャンク間のオーバーラップ文字数 */
+    readonly OVERLAP_CHARS: 5;
+    /** 音声バッファサイズ（並列処理数） */
+    readonly BUFFER_SIZE: 3;
+    /** 音声出力バッファ時間（ms） */
+    readonly AUDIO_BUFFER_MS: 100;
+    /** 無音パディング時間（ms） */
+    readonly SILENCE_PADDING_MS: 50;
+    /** 先読みチャンク数 */
+    readonly PRELOAD_CHUNKS: 2;
+};
+export type LatencyMode = 'ultra-low' | 'balanced' | 'quality';
+export type SplitMode = 'none' | 'small' | 'medium' | 'large' | 'punctuation';
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -0,0 +1,219 @@
+/**
+ * src/say/constants.ts: 音声合成システムのデフォルト定数定義
+ *
+ * 📖 関連ドキュメント：
+ * - docs/configuration-options.md - 設定オプション詳細ガイド
+ * - docs/installation.md - インストール・セットアップガイド（設定例）
+ * - docs/audio-system.md - 音声システム仕様
+ * - docs/config-samples/ - 設定ファイルサンプル
+ *
+ * ⚠️  重要：これらの定数値を変更した場合は、上記ドキュメントも同期更新が必要です
+ *
+ * 🔄 設定値同期チェックリスト：
+ * 1. constants.ts（このファイル）
+ * 2. docs/configuration-options.md の設定表とデフォルト値
+ * 3. docs/installation.md の設定例
+ * 4. docs/config-samples/*.json のサンプル設定
+ * 5. README.md の機能説明（該当する場合）
+ */
+// ================================
+// 接続設定
+// ================================
+export const CONNECTION_SETTINGS = {
+    /** デフォルトホスト */
+    DEFAULT_HOST: 'localhost',
+    /** デフォルトポート */
+    DEFAULT_PORT: '50032',
+};
+// ================================
+// サンプルレート設定
+// 📄 docs/configuration-options.md: `synthesisRate`, `playbackRate`
+// 📄 docs/audio-system.md: サンプルレート分離の説明
+// ================================
+export const SAMPLE_RATES = {
+    /** 音声生成時のサンプルレート（効率重視） */
+    SYNTHESIS: 24000,
+    /** 再生時のサンプルレート（高品質） */
+    PLAYBACK: 48000,
+};
+// ================================
+// 音声フォーマット設定
+// ================================
+export const AUDIO_FORMAT = {
+    /** チャンネル数（モノラル） */
+    CHANNELS: 1,
+    /** ビット深度 */
+    BIT_DEPTH: 16,
+};
+// ================================
+// バッファサイズ設定
+// 📄 docs/configuration-options.md: `bufferSize`, `bufferSettings`
+// 📄 docs/installation.md: --buffer-size説明
+// ================================
+export const BUFFER_SIZES = {
+    /** デフォルトバッファサイズ（CLI安定性のため2048に増強） */
+    DEFAULT: 2048,
+    /** 最小バッファサイズ */
+    MIN: 256,
+    /** 最大バッファサイズ */
+    MAX: 8192,
+    // プリセット別設定
+    PRESETS: {
+        ULTRA_LOW: {
+            HIGH_WATER_MARK: 64,
+            LOW_WATER_MARK: 32,
+        },
+        BALANCED: {
+            HIGH_WATER_MARK: 512,
+            LOW_WATER_MARK: 256,
+        },
+        QUALITY: {
+            HIGH_WATER_MARK: 512,
+            LOW_WATER_MARK: 256,
+        },
+    },
+};
+// ================================
+// フィルター設定
+// 📄 docs/configuration-options.md: `processing`セクション
+// 📄 docs/audio-system.md: フィルター技術仕様
+// ================================
+export const FILTER_SETTINGS = {
+    /** ローパスフィルターのデフォルトカットオフ周波数 */
+    LOWPASS_CUTOFF: 24000,
+    /** ノイズリダクションのデフォルト状態 */
+    NOISE_REDUCTION_DEFAULT: false,
+    /** ローパスフィルターのデフォルト状態 */
+    LOWPASS_FILTER_DEFAULT: false,
+};
+// ================================
+// テキスト分割設定
+// 📄 docs/configuration-options.md: `splitMode`, `splitSettings`
+// 📄 docs/installation.md: パフォーマンス最適化の分割設定説明
+// ================================
+export const SPLIT_SETTINGS = {
+    DEFAULTS: {
+        SMALL_SIZE: 30,
+        MEDIUM_SIZE: 50,
+        LARGE_SIZE: 100,
+        OVERLAP_RATIO: 0.1,
+    },
+    PUNCTUATION: {
+        MAX_CHUNK_SIZE: 150, // 句読点分割時の最大文字数（フォールバック）
+        PREFER_SENTENCE: true, // 句点（。）を優先
+        ALLOW_COMMA_SPLIT: true, // 読点（、）での分割を許可
+        MIN_CHUNK_SIZE: 10, // 最小チャンクサイズ
+        OVERLAP_CHARS: 0, // 句読点分割ではオーバーラップなし
+    },
+    PRESETS: {
+        ULTRA_LOW: {
+            SMALL_SIZE: 20,
+            MEDIUM_SIZE: 30,
+            LARGE_SIZE: 50,
+            OVERLAP_RATIO: 0.05,
+        },
+        BALANCED: {
+            SMALL_SIZE: 30,
+            MEDIUM_SIZE: 50,
+            LARGE_SIZE: 100,
+            OVERLAP_RATIO: 0.1,
+        },
+        QUALITY: {
+            SMALL_SIZE: 40,
+            MEDIUM_SIZE: 70,
+            LARGE_SIZE: 150,
+            OVERLAP_RATIO: 0.15,
+        },
+    },
+};
+// ================================
+// パディング設定
+// ================================
+export const PADDING_SETTINGS = {
+    DEFAULTS: {
+        ENABLED: true,
+        PRE_PHONEME_LENGTH: 0.01, // 10ms
+        POST_PHONEME_LENGTH: 0.01, // 10ms
+        FIRST_CHUNK_ONLY: true,
+    },
+    PRESETS: {
+        ULTRA_LOW: {
+            ENABLED: false,
+            PRE_PHONEME_LENGTH: 0,
+            POST_PHONEME_LENGTH: 0,
+            FIRST_CHUNK_ONLY: true,
+        },
+        BALANCED: {
+            ENABLED: true,
+            PRE_PHONEME_LENGTH: 0.01,
+            POST_PHONEME_LENGTH: 0.01,
+            FIRST_CHUNK_ONLY: true,
+        },
+        QUALITY: {
+            ENABLED: true,
+            PRE_PHONEME_LENGTH: 0.02,
+            POST_PHONEME_LENGTH: 0.02,
+            FIRST_CHUNK_ONLY: false,
+        },
+    },
+};
+// ================================
+// クロスフェード設定
+// ================================
+export const CROSSFADE_SETTINGS = {
+    DEFAULTS: {
+        ENABLED: true,
+        SKIP_FIRST_CHUNK: true,
+        OVERLAP_SAMPLES: 24,
+    },
+    PRESETS: {
+        ULTRA_LOW: {
+            ENABLED: false,
+            SKIP_FIRST_CHUNK: true,
+            OVERLAP_SAMPLES: 0,
+        },
+        BALANCED: {
+            ENABLED: true,
+            SKIP_FIRST_CHUNK: true,
+            OVERLAP_SAMPLES: 24,
+        },
+        QUALITY: {
+            ENABLED: true,
+            SKIP_FIRST_CHUNK: false,
+            OVERLAP_SAMPLES: 48,
+        },
+    },
+};
+// ================================
+// 音声合成設定
+// 📄 docs/configuration-options.md: `voice`セクション
+// 📄 docs/installation.md: 基本設定例のrate値
+// ================================
+export const SYNTHESIS_SETTINGS = {
+    /** デフォルト話速（WPM） */
+    DEFAULT_RATE: 200,
+    /** デフォルト音量 */
+    DEFAULT_VOLUME: 1.0,
+    /** デフォルト音高 */
+    DEFAULT_PITCH: 0.0,
+    /** デフォルトイントネーション */
+    DEFAULT_INTONATION: 1.0,
+};
+// ================================
+// ストリーミング設定
+// ================================
+export const STREAM_SETTINGS = {
+    /** チャンク分割の基準文字数 */
+    CHUNK_SIZE_CHARS: 50,
+    /** チャンク間のオーバーラップ文字数 */
+    OVERLAP_CHARS: 5,
+    /** 音声バッファサイズ（並列処理数） */
+    BUFFER_SIZE: 3,
+    /** 音声出力バッファ時間（ms） */
+    AUDIO_BUFFER_MS: 100,
+    /** 無音パディング時間（ms） */
+    SILENCE_PADDING_MS: 50,
+    /** 先読みチャンク数 */
+    PRELOAD_CHUNKS: 2,
+};
+//# sourceMappingURL=constants.js.map