import type { ScenarioModel } from '../model/scenario-model.js'; import { type SpeechEngine } from '../narration/kokoro.js'; import { type NarrationPart } from '../narration/narration-text.js'; /** Clips for components go here unless outputPath says otherwise */ export declare const NARRATION_FOLDER = "audio/narration"; export interface GenerateNarrationOptions { /** Components whose .text is narrated; each gets its own clip */ components?: string[]; /** Text to speak instead of the component's text (one component, or none with outputPath) */ text?: string; /** File to write, relative to the scenario folder; default audio/narration/.ogg */ outputPath?: string; voice?: string; speed?: number; part?: NarrationPart; pronunciations?: Record; /** * Set each component's audio= to its clip. By default only when audio= is empty or already * a narration clip, so a sound effect is not lost; true replaces it, false never assigns */ assign?: boolean; } export interface NarrationItem { component?: string; /** Relative to the scenario folder when inside it */ file?: string; duration?: number; bytes?: number; seconds?: number; spoken?: string; notes: string[]; /** The audio= value the clip replaced */ replacedAudio?: string; /** The audio= value that was kept because assign was not true */ keptAudio?: string; error?: string; } /** * Narrates components' dialog text (or free text) into OGG clips in the scenario folder and * points each component's audio= at its clip. Problems with one component are reported on * its item, so a batch still narrates the rest. */ export declare function generateNarration(model: ScenarioModel | null, opts: GenerateNarrationOptions, getEngine: () => Promise): Promise; //# sourceMappingURL=narration.d.ts.map