ssml-builder-js 2.13.0 → 2.14.0

package/dist/elements.mjs

@@ -33,12 +33,12 @@ import {
   registerSsmlCompletionProvider,
   resolveExpressAsStyles,
   updateEditableText
-} from "./chunk-LCTE26LS.mjs";
+} from "./chunk-UZSCXPC5.mjs";
 import {
   buildSsml,
   parseSsml,
   validateAzureSsml
-} from "./chunk-CZ2F3TET.mjs";
+} from "./chunk-QFIBPCO4.mjs";
 import "./chunk-6S5ODO6A.mjs";
 
 // packages/ssml-editor-react/src/ssmlInsertions.ts

package/dist/{index.d-Xbr6ZWnK.d.mts → index.d-CUXRwSw0.d.mts}

@@ -151,6 +151,11 @@ interface SsmlDocument {
     attributes?: SsmlAttributes;
 }
 
+interface SsmlTextRange {
+    start: number;
+    end: number;
+}
+
 type SsmlDiagnosticSeverity = "error" | "warning" | "info";
 type SsmlDiagnosticSource = "ssml-static-validator";
 type AzureDiagnosticCode = "azure-unknown-voice" | "azure-unsupported-style" | "azure-locale-mismatch" | "azure-unsupported-tag-for-voice" | "azure-unsupported-model-for-voice" | "azure-preview-voice" | "azure-deprecated-voice" | "azure-preview-tag" | "azure-deprecated-tag";
@@ -183,6 +188,13 @@ interface AzureValidationOptions {
     urlValidator?: AzureUrlValidator;
     /** Alias for urlValidator retained for applications that use the longer name. */
     customUrlValidator?: AzureUrlValidator;
+    /** Controls deduplication, caching, cancellation, and concurrency for URL checks. */
+    urlValidation?: AzureUrlValidationRunnerOptions;
+    /** Flat aliases retained for callers that prefer not to nest URL runner options. */
+    urlValidatorConcurrency?: number;
+    urlValidatorTimeoutMs?: number;
+    urlValidatorSignal?: AbortSignal;
+    urlValidatorCache?: Map<string, AzureUrlValidationResult>;
     languageAliases?: Record<string, string | readonly string[]>;
     maxLength?: number;
     /** Maximum XML element nesting depth, counting `<speak>` as depth 1. */
@@ -210,5 +222,11 @@ type AzureUrlValidator = (url: string, context: {
     tag: string;
     attribute: string;
 }) => AzureUrlValidationResult | Promise<AzureUrlValidationResult>;
+interface AzureUrlValidationRunnerOptions {
+    concurrency?: number;
+    cache?: Map<string, AzureUrlValidationResult>;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
 
-export type { AzureValidationOptions as A, SsmlDiagnostic as S, SsmlDocument as a, SsmlElement as b };
+export type { AzureValidationOptions as A, SsmlTextRange as S, SsmlDiagnostic as a, SsmlDocument as b, SsmlElement as c };

package/dist/{index.d-Xbr6ZWnK.d.ts → index.d-CUXRwSw0.d.ts}

@@ -151,6 +151,11 @@ interface SsmlDocument {
     attributes?: SsmlAttributes;
 }
 
+interface SsmlTextRange {
+    start: number;
+    end: number;
+}
+
 type SsmlDiagnosticSeverity = "error" | "warning" | "info";
 type SsmlDiagnosticSource = "ssml-static-validator";
 type AzureDiagnosticCode = "azure-unknown-voice" | "azure-unsupported-style" | "azure-locale-mismatch" | "azure-unsupported-tag-for-voice" | "azure-unsupported-model-for-voice" | "azure-preview-voice" | "azure-deprecated-voice" | "azure-preview-tag" | "azure-deprecated-tag";
@@ -183,6 +188,13 @@ interface AzureValidationOptions {
     urlValidator?: AzureUrlValidator;
     /** Alias for urlValidator retained for applications that use the longer name. */
     customUrlValidator?: AzureUrlValidator;
+    /** Controls deduplication, caching, cancellation, and concurrency for URL checks. */
+    urlValidation?: AzureUrlValidationRunnerOptions;
+    /** Flat aliases retained for callers that prefer not to nest URL runner options. */
+    urlValidatorConcurrency?: number;
+    urlValidatorTimeoutMs?: number;
+    urlValidatorSignal?: AbortSignal;
+    urlValidatorCache?: Map<string, AzureUrlValidationResult>;
     languageAliases?: Record<string, string | readonly string[]>;
     maxLength?: number;
     /** Maximum XML element nesting depth, counting `<speak>` as depth 1. */
@@ -210,5 +222,11 @@ type AzureUrlValidator = (url: string, context: {
     tag: string;
     attribute: string;
 }) => AzureUrlValidationResult | Promise<AzureUrlValidationResult>;
+interface AzureUrlValidationRunnerOptions {
+    concurrency?: number;
+    cache?: Map<string, AzureUrlValidationResult>;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
 
-export type { AzureValidationOptions as A, SsmlDiagnostic as S, SsmlDocument as a, SsmlElement as b };
+export type { AzureValidationOptions as A, SsmlTextRange as S, SsmlDiagnostic as a, SsmlDocument as b, SsmlElement as c };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-export { AudioElement, AzureDiagnosticCode, AzureLanguageNormalizationOptions, AzureSsmlValidationOptions, AzureUrlValidationResult, AzureUrlValidator, AzureValidationOptions, AzureVoiceCatalogMetadata, AzureVoiceDefinition, AzureVoiceMetadata, BookmarkElement, BreakElement, BuildPartialSsmlOptions, CustomElement, 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, SsmlStructureIntegrityResult, SsmlStructureMismatch, SsmlText, SsmlTextNodeContext, SsmlTextRange, SsmlTtsEmbeddingNode, SsmlTurnNode, SsmlValidationError, SsmlVoiceConversionNode, SsmlVoiceElement, SubElement, VoiceElement, WordElement, areAzureLanguagesEquivalent, buildPartialSsml, buildSsml, extractSsmlText, extractSsmlTranslatableText, fromPlainTextToSsml, getAzureVoiceCatalogMetadata, getBuiltInVoiceCatalogMetadata, isValidAzureAudioDuration, mapSsmlTextNodes, normalizeAzureLanguage, parseSsml, splitSsmlDocument, validateAzureSsml, validateSsml, validateSsmlStructureIntegrity } from './core.mjs';
-import { S as SsmlDiagnostic, A as AzureValidationOptions } from './index.d-Xbr6ZWnK.mjs';
+export { AudioElement, AzureDiagnosticCode, AzureLanguageNormalizationOptions, AzureSsmlValidationOptions, AzureUrlValidationResult, AzureUrlValidationRunnerOptions, AzureUrlValidator, AzureValidationOptions, AzureVoiceCatalogMetadata, AzureVoiceDefinition, AzureVoiceMetadata, BookmarkElement, BreakElement, BuildPartialSsmlOptions, CustomElement, 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, SsmlStructureIntegrityResult, SsmlStructureMismatch, SsmlText, SsmlTextNodeContext, SsmlTextRange, SsmlTtsEmbeddingNode, SsmlTurnNode, SsmlValidationError, SsmlVoiceConversionNode, SsmlVoiceElement, SubElement, VoiceElement, WordElement, areAzureLanguagesEquivalent, buildPartialSsml, buildSsml, createAzureUrlValidatorRunner, extractSsmlText, extractSsmlTranslatableText, fromPlainTextToSsml, getAzureVoiceCatalogMetadata, getBuiltInVoiceCatalogMetadata, isValidAzureAudioDuration, mapSsmlTextNodes, normalizeAzureLanguage, parseSsml, splitSsmlDocument, validateAzureSsml, validateSsml, validateSsmlStructureIntegrity } from './core.mjs';
+import { S as SsmlTextRange, a as SsmlDiagnostic, A as AzureValidationOptions } from './index.d-CUXRwSw0.mjs';
 
 interface TtsConfig {
     signal?: AbortSignal;
@@ -13,13 +13,13 @@ interface TtsConfig {
         start: number;
         end: number;
     };
-    /** Reports completion of a chunk when using synthesizeSsmlChunks. */
-    onProgress?: (event: {
-        currentChunk: number;
-        totalChunks: number;
-        percent: number;
-    }) => void;
+    /** Reports chunk lifecycle events when using chunk synthesis. */
+    onProgress?: (event: SynthesisProgressEvent) => void;
+    /** Metadata used to map synchronization events back to the source document. */
+    chunkIndex?: number;
+    sourceNodePath?: string[];
 }
+type SynthesisChunkStatus = "pending" | "synthesizing" | "success" | "failed";
 interface SsmlSynthesisBoundary {
     text: string;
     audioOffsetMs: number;
@@ -28,6 +28,14 @@ interface SsmlSynthesisBoundary {
         start: number;
         end: number;
     };
+    /** Chunk that produced this event. */
+    chunkIndex?: number;
+    /** Path of the source SSML node, when available. */
+    sourceNodePath?: string[];
+    /** Original text range represented by this event. */
+    originalTextRange?: SsmlTextRange;
+    /** Audio offset within the originating chunk before merge. */
+    chunkAudioOffsetMs?: number;
     requestId?: string;
 }
 interface SsmlSynthesisViseme {
@@ -37,6 +45,10 @@ interface SsmlSynthesisViseme {
         start: number;
         end: number;
     };
+    chunkIndex?: number;
+    sourceNodePath?: string[];
+    originalTextRange?: SsmlTextRange;
+    chunkAudioOffsetMs?: number;
     requestId?: string;
 }
 interface SsmlSynthesisBookmark {
@@ -46,6 +58,10 @@ interface SsmlSynthesisBookmark {
         start: number;
         end: number;
     };
+    chunkIndex?: number;
+    sourceNodePath?: string[];
+    originalTextRange?: SsmlTextRange;
+    chunkAudioOffsetMs?: number;
     requestId?: string;
 }
 /** Audio and Azure Speech synchronization events emitted for one SSML request. */
@@ -73,14 +89,21 @@ interface SsmlSynthesisChunk {
         start: number;
         end: number;
     };
+    sourceNodePath?: string[];
 }
 interface SynthesizeChunksOptions {
     onProgress?: (event: SynthesisProgressEvent) => void;
 }
 interface SynthesisProgressEvent {
+    /** 1-based completed chunk count retained for backward compatibility. */
     currentChunk: number;
     totalChunks: number;
     percent: number;
+    chunkIndex: number;
+    originalTextRange?: SsmlTextRange;
+    status: SynthesisChunkStatus;
+    durationMs: number;
+    error?: unknown;
 }
 interface AzureTtsLogger {
     debug?: (...args: unknown[]) => void;
@@ -110,12 +133,23 @@ declare class AzureTtsSdkError extends AzureTtsError {
     readonly errorDetails: string;
     constructor(errorDetails: string);
 }
+/** Thrown when audio buffers require container re-multiplexing before they can be merged. */
+declare class UnsupportedMergeFormatError extends Error {
+    readonly format: string;
+    constructor(format: string);
+}
 
 interface SsmlValidationError {
     readonly kind: "validation";
     readonly message: string;
     readonly diagnostics: readonly SsmlDiagnostic[];
 }
+declare class ChunkValidationError extends Error {
+    readonly kind: "chunk-validation";
+    readonly chunkIndex: number;
+    readonly diagnostics: readonly SsmlDiagnostic[];
+    constructor(chunkIndex: number, diagnostics: readonly SsmlDiagnostic[]);
+}
 type Result<T, E> = {
     readonly ok: true;
     readonly success: true;
@@ -142,11 +176,22 @@ interface SynthesizeSsmlSafeOptions extends AzureValidationOptions {
     /** Optional nested form for callers that want to keep validation settings grouped. */
     validation?: AzureValidationOptions;
 }
+interface SynthesizeSsmlChunksSafeOptions extends AzureValidationOptions {
+    validation?: AzureValidationOptions;
+    outputFormat?: string;
+    onProgress?: (event: SynthesisProgressEvent) => void;
+}
+type SsmlSynthesisChunksSafeResult = Result<SsmlSynthesisResult, never> | Result<never, ChunkValidationError> | Result<never, AzureTtsError>;
 interface SynthesisClient {
     synthesizeSsml(ssml: string): Promise<SsmlSynthesisResult>;
+    synthesizeChunks?(chunks: readonly (SsmlSynthesisChunk | string)[], options?: {
+        onProgress?: (event: SynthesisProgressEvent) => void;
+    }): Promise<SsmlSynthesisResult>;
 }
 /** Validates SSML before invoking Azure and converts validation/API failures to one result shape. */
 declare function synthesizeSsmlSafe(client: Pick<AzureTtsClient, "synthesizeSsml"> | SynthesisClient, ssml: string, options?: SynthesizeSsmlSafeOptions): Promise<SsmlSynthesisSafeResult>;
+/** Validates every chunk before synthesis and returns a chunk-addressable result. */
+declare function synthesizeSsmlChunksSafe(client: Pick<AzureTtsClient, "synthesizeSsml" | "synthesizeChunks"> | SynthesisClient, chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeSsmlChunksSafeOptions): Promise<SsmlSynthesisChunksSafeResult>;
 
 declare class AzureTtsClient {
     #private;
@@ -155,13 +200,21 @@ declare class AzureTtsClient {
     synthesizeSsml(ssml: string): Promise<SsmlSynthesisResult>;
     synthesizeChunks(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeChunksOptions): Promise<SsmlSynthesisResult>;
     synthesizeSsmlSafe(ssml: string, options?: SynthesizeSsmlSafeOptions): Promise<SsmlSynthesisSafeResult>;
+    synthesizeChunksSafe(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeSsmlChunksSafeOptions): Promise<SsmlSynthesisChunksSafeResult>;
+    synthesizeSsmlChunksSafe(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeSsmlChunksSafeOptions): Promise<SsmlSynthesisChunksSafeResult>;
 }
 
+type MergeAudioFormat = "wav" | "mp3" | "raw";
+/** Returns whether the named output format can be safely concatenated without re-multiplexing. */
+declare function resolveMergeAudioFormat(format: string): MergeAudioFormat | undefined;
+declare function canMergeAudioFormat(format: string): boolean;
+/** Merges audio buffers while preserving the invariants of supported containers. */
+declare function mergeAudioBuffers(buffers: readonly ArrayBuffer[], format: string): ArrayBuffer;
 declare function synthesizeSsml(ssml: string, config: TtsConfig): Promise<SsmlSynthesisResult>;
 /** Synthesizes chunks sequentially, annotates synchronization events, and merges the results. */
 declare function synthesizeSsmlChunks(chunks: readonly (SsmlSynthesisChunk | string)[], config: TtsConfig): Promise<SsmlSynthesisResult>;
 /** Concatenates audio buffers and shifts all synchronization events by prior chunk durations. */
-declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[]): SsmlSynthesisResult;
+declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[], format?: string): SsmlSynthesisResult;
 /** Backward-compatible audio-only synthesis helper. */
 declare function synthesizeSpeech(ssml: string, config: TtsConfig): Promise<ArrayBuffer>;
 
@@ -174,6 +227,9 @@ interface AzureVoiceCatalogVoice {
     locale: string;
     secondaryLocales?: readonly string[];
     styles?: readonly string[];
+    supportedTags?: readonly string[];
+    unsupportedTags?: readonly string[];
+    models?: readonly string[];
     regions: readonly string[];
     status?: "ga" | "preview" | "deprecated";
 }
@@ -190,4 +246,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 { type AzureApiErrorResult, type SsmlValidationError as AzureSsmlValidationError, AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, AzureTtsSdkError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type Result, type SsmlSynthesisBookmark, type SsmlSynthesisBoundary, type SsmlSynthesisChunk, type SsmlSynthesisResult, type SsmlSynthesisSafeResult, type SsmlSynthesisViseme, type Success, type SynthesisProgressEvent, type SynthesisResult, type SynthesizeChunksOptions, type SynthesizeSsmlSafeOptions, type TtsConfig, type ValidationErrorResult, fetchAzureVoiceCatalog, mergeSynthesisResults, synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks, synthesizeSsmlSafe };
+export { type AzureApiErrorResult, type SsmlValidationError as AzureSsmlValidationError, AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, AzureTtsSdkError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, ChunkValidationError, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type MergeAudioFormat, type Result, type SsmlSynthesisBookmark, type SsmlSynthesisBoundary, type SsmlSynthesisChunk, type SsmlSynthesisChunksSafeResult, type SsmlSynthesisResult, type SsmlSynthesisSafeResult, type SsmlSynthesisViseme, type Success, type SynthesisChunkStatus, type SynthesisProgressEvent, type SynthesisResult, type SynthesizeChunksOptions, type SynthesizeSsmlChunksSafeOptions, type SynthesizeSsmlSafeOptions, type TtsConfig, UnsupportedMergeFormatError, type ValidationErrorResult, canMergeAudioFormat, fetchAzureVoiceCatalog, mergeAudioBuffers, mergeSynthesisResults, resolveMergeAudioFormat, synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks, synthesizeSsmlChunksSafe, synthesizeSsmlSafe };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { AudioElement, AzureDiagnosticCode, AzureLanguageNormalizationOptions, AzureSsmlValidationOptions, AzureUrlValidationResult, AzureUrlValidator, AzureValidationOptions, AzureVoiceCatalogMetadata, AzureVoiceDefinition, AzureVoiceMetadata, BookmarkElement, BreakElement, BuildPartialSsmlOptions, CustomElement, 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, SsmlStructureIntegrityResult, SsmlStructureMismatch, SsmlText, SsmlTextNodeContext, SsmlTextRange, SsmlTtsEmbeddingNode, SsmlTurnNode, SsmlValidationError, SsmlVoiceConversionNode, SsmlVoiceElement, SubElement, VoiceElement, WordElement, areAzureLanguagesEquivalent, buildPartialSsml, buildSsml, extractSsmlText, extractSsmlTranslatableText, fromPlainTextToSsml, getAzureVoiceCatalogMetadata, getBuiltInVoiceCatalogMetadata, isValidAzureAudioDuration, mapSsmlTextNodes, normalizeAzureLanguage, parseSsml, splitSsmlDocument, validateAzureSsml, validateSsml, validateSsmlStructureIntegrity } from './core.js';
-import { S as SsmlDiagnostic, A as AzureValidationOptions } from './index.d-Xbr6ZWnK.js';
+export { AudioElement, AzureDiagnosticCode, AzureLanguageNormalizationOptions, AzureSsmlValidationOptions, AzureUrlValidationResult, AzureUrlValidationRunnerOptions, AzureUrlValidator, AzureValidationOptions, AzureVoiceCatalogMetadata, AzureVoiceDefinition, AzureVoiceMetadata, BookmarkElement, BreakElement, BuildPartialSsmlOptions, CustomElement, 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, SsmlStructureIntegrityResult, SsmlStructureMismatch, SsmlText, SsmlTextNodeContext, SsmlTextRange, SsmlTtsEmbeddingNode, SsmlTurnNode, SsmlValidationError, SsmlVoiceConversionNode, SsmlVoiceElement, SubElement, VoiceElement, WordElement, areAzureLanguagesEquivalent, buildPartialSsml, buildSsml, createAzureUrlValidatorRunner, extractSsmlText, extractSsmlTranslatableText, fromPlainTextToSsml, getAzureVoiceCatalogMetadata, getBuiltInVoiceCatalogMetadata, isValidAzureAudioDuration, mapSsmlTextNodes, normalizeAzureLanguage, parseSsml, splitSsmlDocument, validateAzureSsml, validateSsml, validateSsmlStructureIntegrity } from './core.js';
+import { S as SsmlTextRange, a as SsmlDiagnostic, A as AzureValidationOptions } from './index.d-CUXRwSw0.js';
 
 interface TtsConfig {
     signal?: AbortSignal;
@@ -13,13 +13,13 @@ interface TtsConfig {
         start: number;
         end: number;
     };
-    /** Reports completion of a chunk when using synthesizeSsmlChunks. */
-    onProgress?: (event: {
-        currentChunk: number;
-        totalChunks: number;
-        percent: number;
-    }) => void;
+    /** Reports chunk lifecycle events when using chunk synthesis. */
+    onProgress?: (event: SynthesisProgressEvent) => void;
+    /** Metadata used to map synchronization events back to the source document. */
+    chunkIndex?: number;
+    sourceNodePath?: string[];
 }
+type SynthesisChunkStatus = "pending" | "synthesizing" | "success" | "failed";
 interface SsmlSynthesisBoundary {
     text: string;
     audioOffsetMs: number;
@@ -28,6 +28,14 @@ interface SsmlSynthesisBoundary {
         start: number;
         end: number;
     };
+    /** Chunk that produced this event. */
+    chunkIndex?: number;
+    /** Path of the source SSML node, when available. */
+    sourceNodePath?: string[];
+    /** Original text range represented by this event. */
+    originalTextRange?: SsmlTextRange;
+    /** Audio offset within the originating chunk before merge. */
+    chunkAudioOffsetMs?: number;
     requestId?: string;
 }
 interface SsmlSynthesisViseme {
@@ -37,6 +45,10 @@ interface SsmlSynthesisViseme {
         start: number;
         end: number;
     };
+    chunkIndex?: number;
+    sourceNodePath?: string[];
+    originalTextRange?: SsmlTextRange;
+    chunkAudioOffsetMs?: number;
     requestId?: string;
 }
 interface SsmlSynthesisBookmark {
@@ -46,6 +58,10 @@ interface SsmlSynthesisBookmark {
         start: number;
         end: number;
     };
+    chunkIndex?: number;
+    sourceNodePath?: string[];
+    originalTextRange?: SsmlTextRange;
+    chunkAudioOffsetMs?: number;
     requestId?: string;
 }
 /** Audio and Azure Speech synchronization events emitted for one SSML request. */
@@ -73,14 +89,21 @@ interface SsmlSynthesisChunk {
         start: number;
         end: number;
     };
+    sourceNodePath?: string[];
 }
 interface SynthesizeChunksOptions {
     onProgress?: (event: SynthesisProgressEvent) => void;
 }
 interface SynthesisProgressEvent {
+    /** 1-based completed chunk count retained for backward compatibility. */
     currentChunk: number;
     totalChunks: number;
     percent: number;
+    chunkIndex: number;
+    originalTextRange?: SsmlTextRange;
+    status: SynthesisChunkStatus;
+    durationMs: number;
+    error?: unknown;
 }
 interface AzureTtsLogger {
     debug?: (...args: unknown[]) => void;
@@ -110,12 +133,23 @@ declare class AzureTtsSdkError extends AzureTtsError {
     readonly errorDetails: string;
     constructor(errorDetails: string);
 }
+/** Thrown when audio buffers require container re-multiplexing before they can be merged. */
+declare class UnsupportedMergeFormatError extends Error {
+    readonly format: string;
+    constructor(format: string);
+}
 
 interface SsmlValidationError {
     readonly kind: "validation";
     readonly message: string;
     readonly diagnostics: readonly SsmlDiagnostic[];
 }
+declare class ChunkValidationError extends Error {
+    readonly kind: "chunk-validation";
+    readonly chunkIndex: number;
+    readonly diagnostics: readonly SsmlDiagnostic[];
+    constructor(chunkIndex: number, diagnostics: readonly SsmlDiagnostic[]);
+}
 type Result<T, E> = {
     readonly ok: true;
     readonly success: true;
@@ -142,11 +176,22 @@ interface SynthesizeSsmlSafeOptions extends AzureValidationOptions {
     /** Optional nested form for callers that want to keep validation settings grouped. */
     validation?: AzureValidationOptions;
 }
+interface SynthesizeSsmlChunksSafeOptions extends AzureValidationOptions {
+    validation?: AzureValidationOptions;
+    outputFormat?: string;
+    onProgress?: (event: SynthesisProgressEvent) => void;
+}
+type SsmlSynthesisChunksSafeResult = Result<SsmlSynthesisResult, never> | Result<never, ChunkValidationError> | Result<never, AzureTtsError>;
 interface SynthesisClient {
     synthesizeSsml(ssml: string): Promise<SsmlSynthesisResult>;
+    synthesizeChunks?(chunks: readonly (SsmlSynthesisChunk | string)[], options?: {
+        onProgress?: (event: SynthesisProgressEvent) => void;
+    }): Promise<SsmlSynthesisResult>;
 }
 /** Validates SSML before invoking Azure and converts validation/API failures to one result shape. */
 declare function synthesizeSsmlSafe(client: Pick<AzureTtsClient, "synthesizeSsml"> | SynthesisClient, ssml: string, options?: SynthesizeSsmlSafeOptions): Promise<SsmlSynthesisSafeResult>;
+/** Validates every chunk before synthesis and returns a chunk-addressable result. */
+declare function synthesizeSsmlChunksSafe(client: Pick<AzureTtsClient, "synthesizeSsml" | "synthesizeChunks"> | SynthesisClient, chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeSsmlChunksSafeOptions): Promise<SsmlSynthesisChunksSafeResult>;
 
 declare class AzureTtsClient {
     #private;
@@ -155,13 +200,21 @@ declare class AzureTtsClient {
     synthesizeSsml(ssml: string): Promise<SsmlSynthesisResult>;
     synthesizeChunks(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeChunksOptions): Promise<SsmlSynthesisResult>;
     synthesizeSsmlSafe(ssml: string, options?: SynthesizeSsmlSafeOptions): Promise<SsmlSynthesisSafeResult>;
+    synthesizeChunksSafe(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeSsmlChunksSafeOptions): Promise<SsmlSynthesisChunksSafeResult>;
+    synthesizeSsmlChunksSafe(chunks: readonly (SsmlSynthesisChunk | string)[], options?: SynthesizeSsmlChunksSafeOptions): Promise<SsmlSynthesisChunksSafeResult>;
 }
 
+type MergeAudioFormat = "wav" | "mp3" | "raw";
+/** Returns whether the named output format can be safely concatenated without re-multiplexing. */
+declare function resolveMergeAudioFormat(format: string): MergeAudioFormat | undefined;
+declare function canMergeAudioFormat(format: string): boolean;
+/** Merges audio buffers while preserving the invariants of supported containers. */
+declare function mergeAudioBuffers(buffers: readonly ArrayBuffer[], format: string): ArrayBuffer;
 declare function synthesizeSsml(ssml: string, config: TtsConfig): Promise<SsmlSynthesisResult>;
 /** Synthesizes chunks sequentially, annotates synchronization events, and merges the results. */
 declare function synthesizeSsmlChunks(chunks: readonly (SsmlSynthesisChunk | string)[], config: TtsConfig): Promise<SsmlSynthesisResult>;
 /** Concatenates audio buffers and shifts all synchronization events by prior chunk durations. */
-declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[]): SsmlSynthesisResult;
+declare function mergeSynthesisResults(results: readonly SsmlSynthesisResult[], format?: string): SsmlSynthesisResult;
 /** Backward-compatible audio-only synthesis helper. */
 declare function synthesizeSpeech(ssml: string, config: TtsConfig): Promise<ArrayBuffer>;
 
@@ -174,6 +227,9 @@ interface AzureVoiceCatalogVoice {
     locale: string;
     secondaryLocales?: readonly string[];
     styles?: readonly string[];
+    supportedTags?: readonly string[];
+    unsupportedTags?: readonly string[];
+    models?: readonly string[];
     regions: readonly string[];
     status?: "ga" | "preview" | "deprecated";
 }
@@ -190,4 +246,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 { type AzureApiErrorResult, type SsmlValidationError as AzureSsmlValidationError, AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, AzureTtsSdkError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type Result, type SsmlSynthesisBookmark, type SsmlSynthesisBoundary, type SsmlSynthesisChunk, type SsmlSynthesisResult, type SsmlSynthesisSafeResult, type SsmlSynthesisViseme, type Success, type SynthesisProgressEvent, type SynthesisResult, type SynthesizeChunksOptions, type SynthesizeSsmlSafeOptions, type TtsConfig, type ValidationErrorResult, fetchAzureVoiceCatalog, mergeSynthesisResults, synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks, synthesizeSsmlSafe };
+export { type AzureApiErrorResult, type SsmlValidationError as AzureSsmlValidationError, AzureTtsClient, type AzureTtsClientOptions, AzureTtsError, type AzureTtsLogger, AzureTtsSdkError, type AzureVoiceCatalog, type AzureVoiceCatalogVoice, ChunkValidationError, type FetchAzureVoiceCatalogOptions, type FetchedAzureVoiceCatalogMetadata, type MergeAudioFormat, type Result, type SsmlSynthesisBookmark, type SsmlSynthesisBoundary, type SsmlSynthesisChunk, type SsmlSynthesisChunksSafeResult, type SsmlSynthesisResult, type SsmlSynthesisSafeResult, type SsmlSynthesisViseme, type Success, type SynthesisChunkStatus, type SynthesisProgressEvent, type SynthesisResult, type SynthesizeChunksOptions, type SynthesizeSsmlChunksSafeOptions, type SynthesizeSsmlSafeOptions, type TtsConfig, UnsupportedMergeFormatError, type ValidationErrorResult, canMergeAudioFormat, fetchAzureVoiceCatalog, mergeAudioBuffers, mergeSynthesisResults, resolveMergeAudioFormat, synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks, synthesizeSsmlChunksSafe, synthesizeSsmlSafe };