ssml-builder-js 2.16.0 → 2.17.0

package/dist/elements.mjs

@@ -33,12 +33,12 @@ import {
   registerSsmlCompletionProvider,
   resolveExpressAsStyles,
   updateEditableText
-} from "./chunk-F2EMU3HM.mjs";
+} from "./chunk-SLZ7PE6W.mjs";
 import {
   buildSsml,
   parseSsml,
   validateAzureSsml
-} from "./chunk-HI74FTKY.mjs";
+} from "./chunk-5AZWURHW.mjs";
 import "./chunk-6S5ODO6A.mjs";
 
 // packages/ssml-editor-react/src/ssmlInsertions.ts

package/dist/{index.d-DR5Qz43p.d.mts → index.d-tpKoP1jl.d.mts}

@@ -264,4 +264,15 @@ interface AzureUrlValidationRunnerOptions {
     timeoutMs?: number;
 }
 
-export type { AzureValidationOptions as A, SsmlTextRange as S, SsmlSourceTextSegment as a, SsmlSourceMarker as b, SsmlDiagnostic as c, SsmlDocument as d, SsmlElement as e };
+interface AzureVoiceCatalogMetadata {
+    apiVersion: string;
+    generatedAt: string;
+    regions: readonly string[];
+    voiceCount: number;
+    /** When the bundled snapshot should be refreshed. */
+    expiresAt?: string;
+    /** Region-specific catalog differences, when known. */
+    regionDiffs?: Readonly<Record<string, readonly string[]>>;
+}
+
+export type { AzureValidationOptions as A, SsmlTextRange as S, SsmlSourceTextSegment as a, SsmlSourceMarker as b, SsmlDiagnostic as c, SsmlDocument as d, SsmlElement as e, AzureVoiceCatalogMetadata as f };

package/dist/{index.d-DR5Qz43p.d.ts → index.d-tpKoP1jl.d.ts}

@@ -264,4 +264,15 @@ interface AzureUrlValidationRunnerOptions {
     timeoutMs?: number;
 }
 
-export type { AzureValidationOptions as A, SsmlTextRange as S, SsmlSourceTextSegment as a, SsmlSourceMarker as b, SsmlDiagnostic as c, SsmlDocument as d, SsmlElement as e };
+interface AzureVoiceCatalogMetadata {
+    apiVersion: string;
+    generatedAt: string;
+    regions: readonly string[];
+    voiceCount: number;
+    /** When the bundled snapshot should be refreshed. */
+    expiresAt?: string;
+    /** Region-specific catalog differences, when known. */
+    regionDiffs?: Readonly<Record<string, readonly string[]>>;
+}
+
+export type { AzureValidationOptions as A, SsmlTextRange as S, SsmlSourceTextSegment as a, SsmlSourceMarker as b, SsmlDiagnostic as c, SsmlDocument as d, SsmlElement as e, AzureVoiceCatalogMetadata as f };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 export { AudioElement, AzureDiagnosticCode, AzureLanguageNormalizationOptions, AzureSsmlValidationOptions, AzureUrlValidationResult, AzureUrlValidationRunnerOptions, AzureUrlValidator, AzureValidationOptions, AzureVoiceCatalogMetadata, AzureVoiceDefinition, AzureVoiceMetadata, BookmarkElement, BreakElement, BuildPartialSsmlOptions, CustomElement, Diagnostic, EmphasisElement, ExpressAsElement, ExtractSsmlTranslatableTextOptions, FromPlainTextToSsmlOptions, LangElement, LexiconElement, MapSsmlTextNodesOptions, MarkElement, MsttsAudioDurationElement, MsttsEmbeddingElement, MsttsSilenceElement, MsttsTtsEmbeddingElement, MsttsVisemeElement, MsttsVoiceConversionElement, NamedElement, ParagraphElement, PhonemeElement, ProsodyElement, SayAsElement, SentenceElement, SplitSsmlOptions, SsmlAttributeValue, SsmlAttributes, SsmlBackgroundAudioNode, SsmlBreakElement, SsmlChunk, SsmlChunkContext, SsmlDiagnostic, SsmlDiagnosticSeverity, SsmlDiagnosticSource, SsmlDialogNode, SsmlDocument, SsmlElement, SsmlElementBase, SsmlEmbeddingNode, SsmlExpressAsElement, SsmlNode, SsmlPartialContext, SsmlPartialProsody, SsmlPartialVoice, SsmlPhonemeElement, SsmlProsodyElement, SsmlSayAsElement, SsmlSourceMap, SsmlSourceMarker, SsmlSourceTextSegment, SsmlStructureIntegrityResult, SsmlStructureMismatch, SsmlText, SsmlTextNodeContext, SsmlTextRange, SsmlTtsEmbeddingNode, SsmlTurnNode, SsmlValidationError, SsmlVoiceConversionNode, SsmlVoiceElement, SubElement, VoiceElement, WordElement, areAzureLanguagesEquivalent, buildPartialSsml, buildSsml, createAzureUrlValidatorRunner, extractSsmlText, extractSsmlTranslatableText, fromPlainTextToSsml, getAzureVoiceCatalogMetadata, getBuiltInVoiceCatalogMetadata, getSsmlSourceMap, isValidAzureAudioDuration, mapSsmlTextNodes, normalizeAzureLanguage, parseSsml, splitSsmlDocument, validateAzureSsml, validateAzureSsmlChunks, validateSsml, validateSsmlStructureIntegrity } from './core.mjs';
-import { S as SsmlTextRange, a as SsmlSourceTextSegment, b as SsmlSourceMarker, c as SsmlDiagnostic, A as AzureValidationOptions } from './index.d-DR5Qz43p.mjs';
+import { S as SsmlTextRange, a as SsmlSourceTextSegment, b as SsmlSourceMarker, c as SsmlDiagnostic, A as AzureValidationOptions } from './index.d-tpKoP1jl.mjs';
 import * as SpeechSDK from 'microsoft-cognitiveservices-speech-sdk';
 
 declare const DEFAULT_OUTPUT_FORMAT = "audio-16khz-128kbitrate-mono-mp3";
@@ -50,6 +50,7 @@ declare function resolveMimeType(outputFormat: string): string;
 interface TtsConfig {
     signal?: AbortSignal;
     timeoutMs?: number;
+    timeouts?: SynthesisTimeouts;
     endpoint?: string;
     subscriptionKey: string;
     region: string;
@@ -69,6 +70,12 @@ interface TtsConfig {
     sourceMarkers?: SsmlSourceMarker[];
     concurrency?: number;
     retryOptions?: RetryOptions;
+    cancelOnFailure?: boolean;
+    resumeChunks?: readonly SynthesizedChunk[];
+    resumeChunkIndices?: readonly number[];
+    customMerger?: CustomAudioMerger;
+    outputMimeType?: string;
+    postMergeValidator?: PostMergeValidator;
 }
 type MappingStatus = "exact" | "fallback" | "unmapped";
 interface AudioSpecification {
@@ -78,12 +85,22 @@ interface AudioSpecification {
     sampleRate: number;
     channels: number;
     bitrate?: number;
+    bitDepth?: number;
+    container?: string;
+    isVbr?: boolean;
     isCompressed: boolean;
 }
+interface SynthesisTimeouts {
+    urlValidationMs?: number;
+    perChunkMs?: number;
+    chunkWithRetriesMs?: number;
+    totalJobMs?: number;
+}
 interface RetryOptions {
     maxRetries: number;
     initialDelayMs: number;
     maxDelayMs: number;
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
 }
 type SynthesisChunkStatus = "pending" | "synthesizing" | "success" | "failed";
 interface SsmlSynthesisBoundary {
@@ -173,10 +190,37 @@ interface SynthesizeChunksOptions {
     outputFormat?: AzureTtsOutputFormat | string;
     signal?: AbortSignal;
     timeoutMs?: number;
+    timeouts?: SynthesisTimeouts;
     sourceNodePath?: string[];
     concurrency?: number;
     retryOptions?: RetryOptions;
+    cancelOnFailure?: boolean;
+    resumeChunks?: readonly SynthesizedChunk[];
+    resumeChunkIndices?: readonly number[];
+    customMerger?: CustomAudioMerger;
+    outputMimeType?: string;
+    postMergeValidator?: PostMergeValidator;
+}
+interface CustomMergerContext {
+    format: string;
+    outputMimeType: string;
+    inputSpecs: readonly AudioSpecification[];
+    signal: AbortSignal;
+}
+type CustomAudioMerger = (buffers: ArrayBuffer[], context: CustomMergerContext) => Promise<ArrayBuffer> | ArrayBuffer;
+type PostMergeValidator = (result: MergedSynthesisResult, context: CustomMergerContext) => boolean | undefined | Promise<boolean | undefined>;
+interface SynthesizedChunk extends SsmlSynthesisResult {
+    chunkIndex: number;
+}
+interface PartialChunkSynthesisResult {
+    synthesizedChunks: readonly SynthesizedChunk[];
+    completedChunks: readonly SynthesizedChunk[];
+    pendingChunkIndices: readonly number[];
+    failedChunkIndices: readonly number[];
+    totalChunks: number;
 }
+/** Alias for applications that use the shorter result name. */
+type PartialSynthesisResult = PartialChunkSynthesisResult;
 interface SynthesisProgressEvent {
     /** 1-based completed chunk count retained for backward compatibility. */
     currentChunk: number;
@@ -200,6 +244,7 @@ interface AzureTtsLogger {
 interface AzureTtsClientOptions {
     signal?: AbortSignal;
     timeoutMs?: number;
+    timeouts?: SynthesisTimeouts;
     subscriptionKey: string;
     region: string;
     endpoint?: string;
@@ -217,8 +262,11 @@ declare class AzureTtsError extends Error {
     readonly statusText: string;
     readonly responseBody: string;
     readonly requestId: string | null;
-    constructor(status: number, statusText: string, responseBody: string, requestId: string | null);
+    readonly retryAfterMs?: number;
+    constructor(status: number, statusText: string, responseBody: string, requestId: string | null, responseHeaders?: Headers | Readonly<Record<string, string>>);
 }
+/** Reads Retry-After from an error-like value, returning milliseconds when present. */
+declare function getRetryAfterDelayMs(error: unknown): number | undefined;
 declare class AzureTtsSdkError extends AzureTtsError {
     readonly errorDetails: string;
     constructor(errorDetails: string);
@@ -262,6 +310,17 @@ declare class ChunkValidationError extends Error {
     readonly diagnostics: readonly SsmlDiagnostic[];
     constructor(chunkIndex: number, diagnostics: readonly SsmlDiagnostic[]);
 }
+interface ChunkDiagnostics {
+    readonly chunkIndex: number;
+    readonly diagnostics: readonly SsmlDiagnostic[];
+}
+declare class BatchChunkValidationError extends ChunkValidationError {
+    readonly chunkDiagnostics: readonly ChunkDiagnostics[];
+    readonly totalErrorCount: number;
+    readonly errorCount: number;
+    readonly totalErrors: number;
+    constructor(chunkDiagnostics: readonly ChunkDiagnostics[]);
+}
 type Result<T, E> = {
     readonly ok: true;
     readonly success: true;
@@ -274,11 +333,13 @@ type Result<T, E> = {
     readonly success: false;
     readonly status: Kind;
     readonly error: E;
+    readonly partialResult?: PartialChunkSynthesisResult;
 } : {
     readonly ok: false;
     readonly success: false;
     readonly status: SynthesisErrorKind;
     readonly error: E;
+    readonly partialResult?: PartialChunkSynthesisResult;
 });
 type SynthesisResult<T, E> = Result<T, E>;
 type Success<T> = Extract<Result<T, never>, {
@@ -295,18 +356,26 @@ interface SynthesizeSsmlSafeOptions extends AzureValidationOptions {
     /** Optional nested form for callers that want to keep validation settings grouped. */
     validation?: AzureValidationOptions;
     signal?: AbortSignal;
+    timeouts?: SynthesisTimeouts;
 }
 interface SynthesizeSsmlChunksSafeOptions extends AzureValidationOptions {
     validation?: AzureValidationOptions;
     outputFormat?: string;
     signal?: AbortSignal;
     timeoutMs?: number;
+    timeouts?: SynthesisTimeouts;
     sourceNodePath?: string[];
     onProgress?: (event: SynthesisProgressEvent) => void;
     concurrency?: number;
     retryOptions?: RetryOptions;
+    cancelOnFailure?: boolean;
+    resumeChunks?: readonly SynthesizedChunk[];
+    resumeChunkIndices?: readonly number[];
+    customMerger?: CustomAudioMerger;
+    outputMimeType?: string;
+    postMergeValidator?: PostMergeValidator;
 }
-type SsmlSynthesisChunksSafeResult = Result<SsmlSynthesisResult, never> | Result<never, ChunkValidationError> | Result<never, SsmlSynthesisError | ChunkValidationError>;
+type SsmlSynthesisChunksSafeResult = Result<SsmlSynthesisResult, never> | Result<never, ChunkValidationError> | Result<never, BatchChunkValidationError> | Result<never, SsmlSynthesisError | ChunkValidationError>;
 interface SynthesisClient {
     synthesizeSsml(ssml: string, options?: Partial<SynthesizeChunksOptions>): Promise<SsmlSynthesisResult>;
     synthesizeChunks?(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeChunksOptions): Promise<SsmlSynthesisResult>;
@@ -334,14 +403,9 @@ interface MergeAudioOptions {
     outputMimeType?: string;
 }
 type InputAudioSpecs = AudioSpecification[];
-interface CustomMergerContext {
-    format: string;
-    outputMimeType: string;
-    inputSpecs: InputAudioSpecs;
-    signal: AbortSignal;
-}
 interface MergeSynthesisOptions extends MergeAudioOptions {
-    customMerger?: (buffers: ArrayBuffer[], context: CustomMergerContext) => Promise<ArrayBuffer> | ArrayBuffer;
+    customMerger?: CustomAudioMerger;
+    postMergeValidator?: PostMergeValidator;
 }
 type AsyncMergeSynthesisOptions = MergeSynthesisOptions & {
     customMerger: NonNullable<MergeSynthesisOptions["customMerger"]>;
@@ -357,6 +421,7 @@ declare function synthesizeSsml(ssml: string, config: TtsConfig): Promise<SsmlSy
 /** Synthesizes chunks with bounded concurrency, retries transient failures, and merges in chunk order. */
 declare function synthesizeSsmlChunks(chunks: readonly (SsmlSynthesisChunk | string)[], config: TtsConfig): Promise<SsmlSynthesisResult>;
 declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[], options: AsyncMergeSynthesisOptions): Promise<MergedSynthesisResult>;
+declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[], options: MergeSynthesisOptions): MergedSynthesisResult | Promise<MergedSynthesisResult>;
 declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[], options: MergeAudioOptions): MergedSynthesisResult;
 /** Backward-compatible audio-only synthesis helper. */
 declare function synthesizeSpeech(ssml: string, config: TtsConfig): Promise<ArrayBuffer>;
@@ -381,6 +446,8 @@ interface FetchedAzureVoiceCatalogMetadata {
     generatedAt: string;
     apiVersion: string;
     regions: readonly string[];
+    expiresAt?: string;
+    regionDiffs?: Readonly<Record<string, readonly string[]>>;
 }
 interface AzureVoiceCatalog {
     voices: readonly AzureVoiceCatalogVoice[];
@@ -389,4 +456,4 @@ interface AzureVoiceCatalog {
 /** Fetches and deduplicates the current Azure Speech voice catalog for one or more regions. */
 declare function fetchAzureVoiceCatalog(options: FetchAzureVoiceCatalogOptions): Promise<AzureVoiceCatalog>;
 
-export { AudioFormatMismatchError, type AudioSpecification, type AzureApiErrorResult, type SsmlValidationError as AzureSsmlValidationError, AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, type AzureTtsOutputFormat, AzureTtsSdkError, type AzureTtsSynthesisError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, ChunkValidationError, type CustomMergerContext, DEFAULT_OUTPUT_FORMAT, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type InputAudioSpecs, type MappingStatus, type MergeAudioFormat, type MergeAudioOptions, MergeError, type MergeSynthesisOptions, type MergedSynthesisResult, type Result, type RetryOptions, type SsmlSynthesisBookmark, type SsmlSynthesisBoundary, type SsmlSynthesisChunk, type SsmlSynthesisChunksSafeResult, type SsmlSynthesisError, type SsmlSynthesisResult, type SsmlSynthesisSafeResult, type SsmlSynthesisViseme, type Success, SynthesisCancelledError, type SynthesisChunkStatus, type SynthesisErrorKind, type SynthesisProgressEvent, type SynthesisResult, SynthesisTimeoutError, type SynthesizeChunksOptions, type SynthesizeSsmlChunksSafeOptions, type SynthesizeSsmlSafeOptions, type TtsConfig, UnsupportedMergeFormatError, type ValidationErrorResult, canMergeAudioFormat, fetchAzureVoiceCatalog, inspectAudioSpecification, mergeAudioBuffers, mergeSynthesisResults, resolveMergeAudioFormat, resolveMimeType, synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks, synthesizeSsmlChunksSafe, synthesizeSsmlSafe };
+export { AudioFormatMismatchError, type AudioSpecification, type AzureApiErrorResult, type SsmlValidationError as AzureSsmlValidationError, AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, type AzureTtsOutputFormat, AzureTtsSdkError, type AzureTtsSynthesisError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, BatchChunkValidationError, type ChunkDiagnostics, ChunkValidationError, type CustomAudioMerger, type CustomMergerContext, DEFAULT_OUTPUT_FORMAT, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type InputAudioSpecs, type MappingStatus, type MergeAudioFormat, type MergeAudioOptions, MergeError, type MergeSynthesisOptions, type MergedSynthesisResult, type PartialChunkSynthesisResult, type PartialSynthesisResult, type PostMergeValidator, type Result, type RetryOptions, type SsmlSynthesisBookmark, type SsmlSynthesisBoundary, type SsmlSynthesisChunk, type SsmlSynthesisChunksSafeResult, type SsmlSynthesisError, type SsmlSynthesisResult, type SsmlSynthesisSafeResult, type SsmlSynthesisViseme, type Success, SynthesisCancelledError, type SynthesisChunkStatus, type SynthesisErrorKind, type SynthesisProgressEvent, type SynthesisResult, SynthesisTimeoutError, type SynthesisTimeouts, type SynthesizeChunksOptions, type SynthesizeSsmlChunksSafeOptions, type SynthesizeSsmlSafeOptions, type SynthesizedChunk, type TtsConfig, UnsupportedMergeFormatError, type ValidationErrorResult, canMergeAudioFormat, fetchAzureVoiceCatalog, getRetryAfterDelayMs, inspectAudioSpecification, mergeAudioBuffers, mergeSynthesisResults, resolveMergeAudioFormat, resolveMimeType, synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks, synthesizeSsmlChunksSafe, synthesizeSsmlSafe };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { AudioElement, AzureDiagnosticCode, AzureLanguageNormalizationOptions, AzureSsmlValidationOptions, AzureUrlValidationResult, AzureUrlValidationRunnerOptions, AzureUrlValidator, AzureValidationOptions, AzureVoiceCatalogMetadata, AzureVoiceDefinition, AzureVoiceMetadata, BookmarkElement, BreakElement, BuildPartialSsmlOptions, CustomElement, Diagnostic, EmphasisElement, ExpressAsElement, ExtractSsmlTranslatableTextOptions, FromPlainTextToSsmlOptions, LangElement, LexiconElement, MapSsmlTextNodesOptions, MarkElement, MsttsAudioDurationElement, MsttsEmbeddingElement, MsttsSilenceElement, MsttsTtsEmbeddingElement, MsttsVisemeElement, MsttsVoiceConversionElement, NamedElement, ParagraphElement, PhonemeElement, ProsodyElement, SayAsElement, SentenceElement, SplitSsmlOptions, SsmlAttributeValue, SsmlAttributes, SsmlBackgroundAudioNode, SsmlBreakElement, SsmlChunk, SsmlChunkContext, SsmlDiagnostic, SsmlDiagnosticSeverity, SsmlDiagnosticSource, SsmlDialogNode, SsmlDocument, SsmlElement, SsmlElementBase, SsmlEmbeddingNode, SsmlExpressAsElement, SsmlNode, SsmlPartialContext, SsmlPartialProsody, SsmlPartialVoice, SsmlPhonemeElement, SsmlProsodyElement, SsmlSayAsElement, SsmlSourceMap, SsmlSourceMarker, SsmlSourceTextSegment, SsmlStructureIntegrityResult, SsmlStructureMismatch, SsmlText, SsmlTextNodeContext, SsmlTextRange, SsmlTtsEmbeddingNode, SsmlTurnNode, SsmlValidationError, SsmlVoiceConversionNode, SsmlVoiceElement, SubElement, VoiceElement, WordElement, areAzureLanguagesEquivalent, buildPartialSsml, buildSsml, createAzureUrlValidatorRunner, extractSsmlText, extractSsmlTranslatableText, fromPlainTextToSsml, getAzureVoiceCatalogMetadata, getBuiltInVoiceCatalogMetadata, getSsmlSourceMap, isValidAzureAudioDuration, mapSsmlTextNodes, normalizeAzureLanguage, parseSsml, splitSsmlDocument, validateAzureSsml, validateAzureSsmlChunks, validateSsml, validateSsmlStructureIntegrity } from './core.js';
-import { S as SsmlTextRange, a as SsmlSourceTextSegment, b as SsmlSourceMarker, c as SsmlDiagnostic, A as AzureValidationOptions } from './index.d-DR5Qz43p.js';
+import { S as SsmlTextRange, a as SsmlSourceTextSegment, b as SsmlSourceMarker, c as SsmlDiagnostic, A as AzureValidationOptions } from './index.d-tpKoP1jl.js';
 import * as SpeechSDK from 'microsoft-cognitiveservices-speech-sdk';
 
 declare const DEFAULT_OUTPUT_FORMAT = "audio-16khz-128kbitrate-mono-mp3";
@@ -50,6 +50,7 @@ declare function resolveMimeType(outputFormat: string): string;
 interface TtsConfig {
     signal?: AbortSignal;
     timeoutMs?: number;
+    timeouts?: SynthesisTimeouts;
     endpoint?: string;
     subscriptionKey: string;
     region: string;
@@ -69,6 +70,12 @@ interface TtsConfig {
     sourceMarkers?: SsmlSourceMarker[];
     concurrency?: number;
     retryOptions?: RetryOptions;
+    cancelOnFailure?: boolean;
+    resumeChunks?: readonly SynthesizedChunk[];
+    resumeChunkIndices?: readonly number[];
+    customMerger?: CustomAudioMerger;
+    outputMimeType?: string;
+    postMergeValidator?: PostMergeValidator;
 }
 type MappingStatus = "exact" | "fallback" | "unmapped";
 interface AudioSpecification {
@@ -78,12 +85,22 @@ interface AudioSpecification {
     sampleRate: number;
     channels: number;
     bitrate?: number;
+    bitDepth?: number;
+    container?: string;
+    isVbr?: boolean;
     isCompressed: boolean;
 }
+interface SynthesisTimeouts {
+    urlValidationMs?: number;
+    perChunkMs?: number;
+    chunkWithRetriesMs?: number;
+    totalJobMs?: number;
+}
 interface RetryOptions {
     maxRetries: number;
     initialDelayMs: number;
     maxDelayMs: number;
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
 }
 type SynthesisChunkStatus = "pending" | "synthesizing" | "success" | "failed";
 interface SsmlSynthesisBoundary {
@@ -173,10 +190,37 @@ interface SynthesizeChunksOptions {
     outputFormat?: AzureTtsOutputFormat | string;
     signal?: AbortSignal;
     timeoutMs?: number;
+    timeouts?: SynthesisTimeouts;
     sourceNodePath?: string[];
     concurrency?: number;
     retryOptions?: RetryOptions;
+    cancelOnFailure?: boolean;
+    resumeChunks?: readonly SynthesizedChunk[];
+    resumeChunkIndices?: readonly number[];
+    customMerger?: CustomAudioMerger;
+    outputMimeType?: string;
+    postMergeValidator?: PostMergeValidator;
+}
+interface CustomMergerContext {
+    format: string;
+    outputMimeType: string;
+    inputSpecs: readonly AudioSpecification[];
+    signal: AbortSignal;
+}
+type CustomAudioMerger = (buffers: ArrayBuffer[], context: CustomMergerContext) => Promise<ArrayBuffer> | ArrayBuffer;
+type PostMergeValidator = (result: MergedSynthesisResult, context: CustomMergerContext) => boolean | undefined | Promise<boolean | undefined>;
+interface SynthesizedChunk extends SsmlSynthesisResult {
+    chunkIndex: number;
+}
+interface PartialChunkSynthesisResult {
+    synthesizedChunks: readonly SynthesizedChunk[];
+    completedChunks: readonly SynthesizedChunk[];
+    pendingChunkIndices: readonly number[];
+    failedChunkIndices: readonly number[];
+    totalChunks: number;
 }
+/** Alias for applications that use the shorter result name. */
+type PartialSynthesisResult = PartialChunkSynthesisResult;
 interface SynthesisProgressEvent {
     /** 1-based completed chunk count retained for backward compatibility. */
     currentChunk: number;
@@ -200,6 +244,7 @@ interface AzureTtsLogger {
 interface AzureTtsClientOptions {
     signal?: AbortSignal;
     timeoutMs?: number;
+    timeouts?: SynthesisTimeouts;
     subscriptionKey: string;
     region: string;
     endpoint?: string;
@@ -217,8 +262,11 @@ declare class AzureTtsError extends Error {
     readonly statusText: string;
     readonly responseBody: string;
     readonly requestId: string | null;
-    constructor(status: number, statusText: string, responseBody: string, requestId: string | null);
+    readonly retryAfterMs?: number;
+    constructor(status: number, statusText: string, responseBody: string, requestId: string | null, responseHeaders?: Headers | Readonly<Record<string, string>>);
 }
+/** Reads Retry-After from an error-like value, returning milliseconds when present. */
+declare function getRetryAfterDelayMs(error: unknown): number | undefined;
 declare class AzureTtsSdkError extends AzureTtsError {
     readonly errorDetails: string;
     constructor(errorDetails: string);
@@ -262,6 +310,17 @@ declare class ChunkValidationError extends Error {
     readonly diagnostics: readonly SsmlDiagnostic[];
     constructor(chunkIndex: number, diagnostics: readonly SsmlDiagnostic[]);
 }
+interface ChunkDiagnostics {
+    readonly chunkIndex: number;
+    readonly diagnostics: readonly SsmlDiagnostic[];
+}
+declare class BatchChunkValidationError extends ChunkValidationError {
+    readonly chunkDiagnostics: readonly ChunkDiagnostics[];
+    readonly totalErrorCount: number;
+    readonly errorCount: number;
+    readonly totalErrors: number;
+    constructor(chunkDiagnostics: readonly ChunkDiagnostics[]);
+}
 type Result<T, E> = {
     readonly ok: true;
     readonly success: true;
@@ -274,11 +333,13 @@ type Result<T, E> = {
     readonly success: false;
     readonly status: Kind;
     readonly error: E;
+    readonly partialResult?: PartialChunkSynthesisResult;
 } : {
     readonly ok: false;
     readonly success: false;
     readonly status: SynthesisErrorKind;
     readonly error: E;
+    readonly partialResult?: PartialChunkSynthesisResult;
 });
 type SynthesisResult<T, E> = Result<T, E>;
 type Success<T> = Extract<Result<T, never>, {
@@ -295,18 +356,26 @@ interface SynthesizeSsmlSafeOptions extends AzureValidationOptions {
     /** Optional nested form for callers that want to keep validation settings grouped. */
     validation?: AzureValidationOptions;
     signal?: AbortSignal;
+    timeouts?: SynthesisTimeouts;
 }
 interface SynthesizeSsmlChunksSafeOptions extends AzureValidationOptions {
     validation?: AzureValidationOptions;
     outputFormat?: string;
     signal?: AbortSignal;
     timeoutMs?: number;
+    timeouts?: SynthesisTimeouts;
     sourceNodePath?: string[];
     onProgress?: (event: SynthesisProgressEvent) => void;
     concurrency?: number;
     retryOptions?: RetryOptions;
+    cancelOnFailure?: boolean;
+    resumeChunks?: readonly SynthesizedChunk[];
+    resumeChunkIndices?: readonly number[];
+    customMerger?: CustomAudioMerger;
+    outputMimeType?: string;
+    postMergeValidator?: PostMergeValidator;
 }
-type SsmlSynthesisChunksSafeResult = Result<SsmlSynthesisResult, never> | Result<never, ChunkValidationError> | Result<never, SsmlSynthesisError | ChunkValidationError>;
+type SsmlSynthesisChunksSafeResult = Result<SsmlSynthesisResult, never> | Result<never, ChunkValidationError> | Result<never, BatchChunkValidationError> | Result<never, SsmlSynthesisError | ChunkValidationError>;
 interface SynthesisClient {
     synthesizeSsml(ssml: string, options?: Partial<SynthesizeChunksOptions>): Promise<SsmlSynthesisResult>;
     synthesizeChunks?(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeChunksOptions): Promise<SsmlSynthesisResult>;
@@ -334,14 +403,9 @@ interface MergeAudioOptions {
     outputMimeType?: string;
 }
 type InputAudioSpecs = AudioSpecification[];
-interface CustomMergerContext {
-    format: string;
-    outputMimeType: string;
-    inputSpecs: InputAudioSpecs;
-    signal: AbortSignal;
-}
 interface MergeSynthesisOptions extends MergeAudioOptions {
-    customMerger?: (buffers: ArrayBuffer[], context: CustomMergerContext) => Promise<ArrayBuffer> | ArrayBuffer;
+    customMerger?: CustomAudioMerger;
+    postMergeValidator?: PostMergeValidator;
 }
 type AsyncMergeSynthesisOptions = MergeSynthesisOptions & {
     customMerger: NonNullable<MergeSynthesisOptions["customMerger"]>;
@@ -357,6 +421,7 @@ declare function synthesizeSsml(ssml: string, config: TtsConfig): Promise<SsmlSy
 /** Synthesizes chunks with bounded concurrency, retries transient failures, and merges in chunk order. */
 declare function synthesizeSsmlChunks(chunks: readonly (SsmlSynthesisChunk | string)[], config: TtsConfig): Promise<SsmlSynthesisResult>;
 declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[], options: AsyncMergeSynthesisOptions): Promise<MergedSynthesisResult>;
+declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[], options: MergeSynthesisOptions): MergedSynthesisResult | Promise<MergedSynthesisResult>;
 declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[], options: MergeAudioOptions): MergedSynthesisResult;
 /** Backward-compatible audio-only synthesis helper. */
 declare function synthesizeSpeech(ssml: string, config: TtsConfig): Promise<ArrayBuffer>;
@@ -381,6 +446,8 @@ interface FetchedAzureVoiceCatalogMetadata {
     generatedAt: string;
     apiVersion: string;
     regions: readonly string[];
+    expiresAt?: string;
+    regionDiffs?: Readonly<Record<string, readonly string[]>>;
 }
 interface AzureVoiceCatalog {
     voices: readonly AzureVoiceCatalogVoice[];
@@ -389,4 +456,4 @@ interface AzureVoiceCatalog {
 /** Fetches and deduplicates the current Azure Speech voice catalog for one or more regions. */
 declare function fetchAzureVoiceCatalog(options: FetchAzureVoiceCatalogOptions): Promise<AzureVoiceCatalog>;
 
-export { AudioFormatMismatchError, type AudioSpecification, type AzureApiErrorResult, type SsmlValidationError as AzureSsmlValidationError, AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, type AzureTtsOutputFormat, AzureTtsSdkError, type AzureTtsSynthesisError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, ChunkValidationError, type CustomMergerContext, DEFAULT_OUTPUT_FORMAT, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type InputAudioSpecs, type MappingStatus, type MergeAudioFormat, type MergeAudioOptions, MergeError, type MergeSynthesisOptions, type MergedSynthesisResult, type Result, type RetryOptions, type SsmlSynthesisBookmark, type SsmlSynthesisBoundary, type SsmlSynthesisChunk, type SsmlSynthesisChunksSafeResult, type SsmlSynthesisError, type SsmlSynthesisResult, type SsmlSynthesisSafeResult, type SsmlSynthesisViseme, type Success, SynthesisCancelledError, type SynthesisChunkStatus, type SynthesisErrorKind, type SynthesisProgressEvent, type SynthesisResult, SynthesisTimeoutError, type SynthesizeChunksOptions, type SynthesizeSsmlChunksSafeOptions, type SynthesizeSsmlSafeOptions, type TtsConfig, UnsupportedMergeFormatError, type ValidationErrorResult, canMergeAudioFormat, fetchAzureVoiceCatalog, inspectAudioSpecification, mergeAudioBuffers, mergeSynthesisResults, resolveMergeAudioFormat, resolveMimeType, synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks, synthesizeSsmlChunksSafe, synthesizeSsmlSafe };
+export { AudioFormatMismatchError, type AudioSpecification, type AzureApiErrorResult, type SsmlValidationError as AzureSsmlValidationError, AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, type AzureTtsOutputFormat, AzureTtsSdkError, type AzureTtsSynthesisError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, BatchChunkValidationError, type ChunkDiagnostics, ChunkValidationError, type CustomAudioMerger, type CustomMergerContext, DEFAULT_OUTPUT_FORMAT, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type InputAudioSpecs, type MappingStatus, type MergeAudioFormat, type MergeAudioOptions, MergeError, type MergeSynthesisOptions, type MergedSynthesisResult, type PartialChunkSynthesisResult, type PartialSynthesisResult, type PostMergeValidator, type Result, type RetryOptions, type SsmlSynthesisBookmark, type SsmlSynthesisBoundary, type SsmlSynthesisChunk, type SsmlSynthesisChunksSafeResult, type SsmlSynthesisError, type SsmlSynthesisResult, type SsmlSynthesisSafeResult, type SsmlSynthesisViseme, type Success, SynthesisCancelledError, type SynthesisChunkStatus, type SynthesisErrorKind, type SynthesisProgressEvent, type SynthesisResult, SynthesisTimeoutError, type SynthesisTimeouts, type SynthesizeChunksOptions, type SynthesizeSsmlChunksSafeOptions, type SynthesizeSsmlSafeOptions, type SynthesizedChunk, type TtsConfig, UnsupportedMergeFormatError, type ValidationErrorResult, canMergeAudioFormat, fetchAzureVoiceCatalog, getRetryAfterDelayMs, inspectAudioSpecification, mergeAudioBuffers, mergeSynthesisResults, resolveMergeAudioFormat, resolveMimeType, synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks, synthesizeSsmlChunksSafe, synthesizeSsmlSafe };