ssml-builder-js 2.12.0 → 2.13.0

package/dist/index.mjs

@@ -15,7 +15,10 @@ import {
   validateAzureSsml,
   validateSsml,
   validateSsmlStructureIntegrity
-} from "./chunk-4BVNAUVR.mjs";
+} from "./chunk-25LOR4AJ.mjs";
+import {
+  validateAzureSsml as validateAzureSsml2
+} from "./chunk-CZ2F3TET.mjs";
 import {
   __privateAdd,
   __privateGet,
@@ -190,12 +193,23 @@ async function synthesizeSsml(ssml, config) {
         ...(bookmarks ?? []).map((bookmark) => bookmark.audioOffsetMs)
       );
       const durationMs = result.audioDuration ? ticksToMilliseconds(result.audioDuration) : eventDurationMs;
+      const requestId = result.resultId;
+      const addSourceMetadata = (event) => ({
+        ...event,
+        ...config.sourceTextRange ? { textRange: { ...config.sourceTextRange } } : {},
+        ...requestId ? { requestId } : {}
+      });
+      const sourceBoundaries = boundaries.map((boundary) => addSourceMetadata(boundary));
+      const sourceVisemes = visemes.map((viseme) => addSourceMetadata(viseme));
+      const sourceBookmarks = bookmarks.map((bookmark) => addSourceMetadata(bookmark));
       resolve({
         audioData: result.audioData,
         durationMs,
-        ...boundaries.length > 0 ? { boundaries, wordBoundary: boundaries, wordBoundaries: boundaries } : {},
-        ...visemes.length > 0 ? { visemes } : {},
-        ...bookmarks.length > 0 ? { bookmarks } : {}
+        ...config.sourceTextRange ? { textRange: { ...config.sourceTextRange } } : {},
+        ...requestId ? { requestId } : {},
+        ...sourceBoundaries.length > 0 ? { boundaries: sourceBoundaries, wordBoundary: sourceBoundaries, wordBoundaries: sourceBoundaries } : {},
+        ...sourceVisemes.length > 0 ? { visemes: sourceVisemes } : {},
+        ...sourceBookmarks.length > 0 ? { bookmarks: sourceBookmarks } : {}
       });
     };
     try {
@@ -215,10 +229,108 @@ async function synthesizeSsml(ssml, config) {
     }
   });
 }
+async function synthesizeSsmlChunks(chunks, config) {
+  const results = [];
+  const totalChunks = chunks.length;
+  for (const [index, chunk] of chunks.entries()) {
+    const input = typeof chunk === "string" ? { ssml: chunk } : chunk;
+    const result = await synthesizeSsml(input.ssml, {
+      ...config,
+      ...input.originalTextRange ? { sourceTextRange: input.originalTextRange } : {},
+      onProgress: void 0
+    });
+    results.push(result);
+    config.onProgress?.({
+      currentChunk: index + 1,
+      totalChunks,
+      percent: totalChunks === 0 ? 100 : Math.round((index + 1) / totalChunks * 100)
+    });
+  }
+  return mergeSynthesisResults(results);
+}
+function mergeSynthesisResults(results) {
+  const audioLength = results.reduce((total, result) => total + result.audioData.byteLength, 0);
+  const audioData = new Uint8Array(audioLength);
+  const boundaries = [];
+  const visemes = [];
+  const bookmarks = [];
+  let byteOffset = 0;
+  let durationOffset = 0;
+  for (const result of results) {
+    audioData.set(new Uint8Array(result.audioData), byteOffset);
+    byteOffset += result.audioData.byteLength;
+    const chunkBoundaries = result.boundaries && result.boundaries.length > 0 ? result.boundaries : result.wordBoundary ?? result.wordBoundaries ?? [];
+    for (const boundary of chunkBoundaries) {
+      const textRange = boundary.textRange ?? result.textRange;
+      const requestId = boundary.requestId ?? result.requestId;
+      boundaries.push({
+        ...boundary,
+        audioOffsetMs: boundary.audioOffsetMs + durationOffset,
+        ...textRange ? { textRange: { ...textRange } } : {},
+        ...requestId ? { requestId } : {}
+      });
+    }
+    for (const viseme of result.visemes ?? []) {
+      const textRange = viseme.textRange ?? result.textRange;
+      const requestId = viseme.requestId ?? result.requestId;
+      visemes.push({
+        ...viseme,
+        audioOffsetMs: viseme.audioOffsetMs + durationOffset,
+        ...textRange ? { textRange: { ...textRange } } : {},
+        ...requestId ? { requestId } : {}
+      });
+    }
+    for (const bookmark of result.bookmarks ?? []) {
+      const textRange = bookmark.textRange ?? result.textRange;
+      const requestId = bookmark.requestId ?? result.requestId;
+      bookmarks.push({
+        ...bookmark,
+        audioOffsetMs: bookmark.audioOffsetMs + durationOffset,
+        ...textRange ? { textRange: { ...textRange } } : {},
+        ...requestId ? { requestId } : {}
+      });
+    }
+    durationOffset += Math.max(0, result.durationMs);
+  }
+  return {
+    audioData: audioData.buffer,
+    durationMs: durationOffset,
+    ...boundaries.length > 0 ? { boundaries, wordBoundary: boundaries, wordBoundaries: boundaries } : {},
+    ...visemes.length > 0 ? { visemes } : {},
+    ...bookmarks.length > 0 ? { bookmarks } : {},
+    ...results.length === 1 && results[0]?.requestId ? { requestId: results[0].requestId } : {},
+    ...results.length === 1 && results[0]?.textRange ? { textRange: { ...results[0].textRange } } : {}
+  };
+}
 async function synthesizeSpeech(ssml, config) {
   return (await synthesizeSsml(ssml, config)).audioData;
 }
 
+// packages/azure-tts-client/src/safe.ts
+async function synthesizeSsmlSafe(client, ssml, options = {}) {
+  const validationOptions = options.validation ?? options;
+  const diagnostics = await Promise.resolve(validateAzureSsml2(ssml, validationOptions));
+  const errors = diagnostics.filter((diagnostic) => diagnostic.severity === "error");
+  if (errors.length > 0) {
+    return {
+      ok: false,
+      success: false,
+      status: "validation-error",
+      error: {
+        kind: "validation",
+        message: "SSML validation failed; the Azure Speech API was not called.",
+        diagnostics: errors
+      }
+    };
+  }
+  try {
+    return { ok: true, success: true, status: "success", value: await client.synthesizeSsml(ssml) };
+  } catch (error) {
+    const azureError = error instanceof AzureTtsError ? error : createSpeechSdkError(error);
+    return { ok: false, success: false, status: "azure-api-error", error: azureError };
+  }
+}
+
 // packages/azure-tts-client/src/client.ts
 var ENDPOINT_TEMPLATE = "https://{region}.tts.speech.microsoft.com/cognitiveservices/v1";
 var _options;
@@ -240,6 +352,22 @@ var AzureTtsClient = class {
     __privateGet(this, _options).logger?.debug?.("Using Azure TTS endpoint:", endpoint);
     return synthesizeSsml(ssml, { endpoint, region, subscriptionKey, outputFormat, signal, timeoutMs });
   }
+  async synthesizeChunks(chunks, options = {}) {
+    const { region, subscriptionKey, outputFormat, signal, timeoutMs } = __privateGet(this, _options);
+    const endpoint = __privateGet(this, _options).endpoint?.trim() || ENDPOINT_TEMPLATE.replace("{region}", region);
+    return synthesizeSsmlChunks(chunks, {
+      endpoint,
+      region,
+      subscriptionKey,
+      outputFormat,
+      signal,
+      timeoutMs,
+      onProgress: options.onProgress ?? __privateGet(this, _options).onProgress
+    });
+  }
+  async synthesizeSsmlSafe(ssml, options = {}) {
+    return synthesizeSsmlSafe(this, ssml, options);
+  }
 };
 _options = new WeakMap();
 
@@ -335,11 +463,14 @@ export {
   getBuiltInVoiceCatalogMetadata,
   isValidAzureAudioDuration,
   mapSsmlTextNodes,
+  mergeSynthesisResults,
   normalizeAzureLanguage,
   parseSsml,
   splitSsmlDocument,
   synthesizeSpeech,
   synthesizeSsml,
+  synthesizeSsmlChunks,
+  synthesizeSsmlSafe,
   validateAzureSsml,
   validateSsml,
   validateSsmlStructureIntegrity

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../packages/azure-tts-client/src/errors.ts","../packages/azure-tts-client/src/synthesis.ts","../packages/azure-tts-client/src/speechConfig.ts","../packages/azure-tts-client/src/outputFormats.ts","../packages/azure-tts-client/src/client.ts","../packages/azure-tts-client/src/voiceCatalog.ts"],"sourcesContent":["export class AzureTtsError extends Error {\n  readonly status: number;\n  readonly statusText: string;\n  readonly responseBody: string;\n  readonly requestId: string | null;\n\n  constructor(status: number, statusText: string, responseBody: string, requestId: string | null) {\n    super(`Azure TTS request failed: ${status} ${statusText}`);\n    this.name = \"AzureTtsError\";\n    this.status = status;\n    this.statusText = statusText;\n    this.responseBody = responseBody;\n    this.requestId = requestId;\n  }\n}\n\nexport class AzureTtsSdkError extends AzureTtsError {\n  readonly errorDetails: string;\n\n  constructor(errorDetails: string) {\n    super(0, \"Speech SDK\", errorDetails, null);\n    this.name = \"AzureTtsSdkError\";\n    this.message = `Azure TTS synthesis failed: ${errorDetails}`;\n    this.errorDetails = errorDetails;\n  }\n}\n\nexport function createSpeechSdkError(error: unknown): AzureTtsSdkError {\n  const message = error instanceof Error ? error.message : String(error);\n  return new AzureTtsSdkError(message);\n}\n","import * as SpeechSDK from \"microsoft-cognitiveservices-speech-sdk\";\nimport { createSpeechSdkError } from \"./errors.ts\";\nimport { createSpeechConfig } from \"./speechConfig.ts\";\nimport type { SsmlSynthesisResult, TtsConfig } from \"./types.ts\";\n\nfunction closeSpeechResources(speechConfig: SpeechSDK.SpeechConfig, synthesizer: SpeechSDK.SpeechSynthesizer): void {\n  try {\n    synthesizer.close();\n  } catch {}\n\n  try {\n    speechConfig.close();\n  } catch {}\n}\n\nconst ticksToMilliseconds = (ticks: number): number => Math.max(0, ticks) / 10_000;\n\nexport async function synthesizeSsml(ssml: string, config: TtsConfig): Promise<SsmlSynthesisResult> {\n  if (config.signal?.aborted) {\n    throw createSpeechSdkError(\"Speech synthesis was cancelled.\");\n  }\n\n  const speechConfig = createSpeechConfig(config);\n  const synthesizer = new SpeechSDK.SpeechSynthesizer(speechConfig, null);\n\n  return await new Promise<SsmlSynthesisResult>((resolve, reject) => {\n    let resourcesClosed = false;\n    let settled = false;\n    let timeout: ReturnType<typeof setTimeout> | undefined;\n    let abortHandler: (() => void) | undefined;\n    const cleanup = () => {\n      if (timeout) clearTimeout(timeout);\n      if (abortHandler) config.signal?.removeEventListener(\"abort\", abortHandler);\n    };\n    const closeResources = () => {\n      if (resourcesClosed) return;\n      resourcesClosed = true;\n      closeSpeechResources(speechConfig, synthesizer);\n    };\n    const rejectWithError = (error: unknown) => {\n      if (settled) return;\n      settled = true;\n      cleanup();\n      closeResources();\n      reject(createSpeechSdkError(error));\n    };\n\n    const boundaries: SsmlSynthesisResult[\"boundaries\"] = [];\n    const visemes: SsmlSynthesisResult[\"visemes\"] = [];\n    const bookmarks: SsmlSynthesisResult[\"bookmarks\"] = [];\n    synthesizer.wordBoundary = (_sender, event) => {\n      boundaries.push({\n        text: event.text,\n        audioOffsetMs: ticksToMilliseconds(event.audioOffset),\n        durationMs: ticksToMilliseconds(event.duration),\n      });\n    };\n    synthesizer.visemeReceived = (_sender, event) => {\n      visemes.push({ visemeId: event.visemeId, audioOffsetMs: ticksToMilliseconds(event.audioOffset) });\n    };\n    synthesizer.bookmarkReached = (_sender, event) => {\n      bookmarks.push({ name: event.text, audioOffsetMs: ticksToMilliseconds(event.audioOffset) });\n    };\n\n    const cb = (result: SpeechSDK.SpeechSynthesisResult) => {\n      if (settled) return;\n      const { reason, errorDetails } = result;\n      if (reason !== SpeechSDK.ResultReason.SynthesizingAudioCompleted) {\n        const err = errorDetails || `Speech synthesis failed with reason ${reason}.`;\n        rejectWithError(err);\n        return;\n      }\n      settled = true;\n      cleanup();\n      closeResources();\n      const eventDurationMs = Math.max(\n        0,\n        ...(boundaries ?? []).map((boundary) => boundary.audioOffsetMs + boundary.durationMs),\n        ...(visemes ?? []).map((viseme) => viseme.audioOffsetMs),\n        ...(bookmarks ?? []).map((bookmark) => bookmark.audioOffsetMs),\n      );\n      const durationMs = result.audioDuration ? ticksToMilliseconds(result.audioDuration) : eventDurationMs;\n      resolve({\n        audioData: result.audioData,\n        durationMs,\n        ...(boundaries.length > 0 ? { boundaries, wordBoundary: boundaries, wordBoundaries: boundaries } : {}),\n        ...(visemes.length > 0 ? { visemes } : {}),\n        ...(bookmarks.length > 0 ? { bookmarks } : {}),\n      });\n    };\n\n    try {\n      if (config.signal) {\n        abortHandler = () => rejectWithError(\"Speech synthesis was cancelled.\");\n        config.signal.addEventListener(\"abort\", abortHandler, { once: true });\n      }\n      if (config.timeoutMs !== undefined && config.timeoutMs > 0) {\n        timeout = setTimeout(\n          () => rejectWithError(`Speech synthesis timed out after ${config.timeoutMs} ms.`),\n          config.timeoutMs,\n        );\n      }\n      synthesizer.speakSsmlAsync(ssml, cb, rejectWithError);\n    } catch (error) {\n      rejectWithError(error);\n    }\n  });\n}\n\n/** Backward-compatible audio-only synthesis helper. */\nexport async function synthesizeSpeech(ssml: string, config: TtsConfig): Promise<ArrayBuffer> {\n  return (await synthesizeSsml(ssml, config)).audioData;\n}\n","import { SpeechConfig } from \"microsoft-cognitiveservices-speech-sdk\";\nimport { DEFAULT_OUTPUT_FORMAT, resolveOutputFormat } from \"./outputFormats.ts\";\nimport type { TtsConfig } from \"./types.ts\";\n\nexport function resolveEndpoint(config: TtsConfig): string {\n  const endpoint = config.endpoint?.trim() || \"https://{region}.tts.speech.microsoft.com/cognitiveservices/v1\";\n  return endpoint.replace(/\\{region\\}/g, encodeURIComponent(config.region));\n}\n\nexport function createSpeechConfig(config: TtsConfig): SpeechConfig {\n  const { outputFormat = DEFAULT_OUTPUT_FORMAT, subscriptionKey } = config;\n\n  const endpoint = new URL(resolveEndpoint(config));\n  const speechConfig = SpeechConfig.fromEndpoint(endpoint, subscriptionKey);\n  speechConfig.speechSynthesisOutputFormat = resolveOutputFormat(outputFormat);\n  return speechConfig;\n}\n","import * as SpeechSDK from \"microsoft-cognitiveservices-speech-sdk\";\n\nexport const DEFAULT_OUTPUT_FORMAT = \"audio-16khz-128kbitrate-mono-mp3\";\n\nconst OUTPUT_FORMATS: Record<string, SpeechSDK.SpeechSynthesisOutputFormat> = {\n  \"raw-8khz-8bit-mono-mulaw\": SpeechSDK.SpeechSynthesisOutputFormat.Raw8Khz8BitMonoMULaw,\n  \"riff-16khz-16kbps-mono-siren\": SpeechSDK.SpeechSynthesisOutputFormat.Riff16Khz16KbpsMonoSiren,\n  \"audio-16khz-16kbps-mono-siren\": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz16KbpsMonoSiren,\n  \"audio-16khz-32kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz32KBitRateMonoMp3,\n  \"audio-16khz-128kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz128KBitRateMonoMp3,\n  \"audio-16khz-64kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz64KBitRateMonoMp3,\n  \"audio-24khz-48kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz48KBitRateMonoMp3,\n  \"audio-24khz-96kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz96KBitRateMonoMp3,\n  \"audio-24khz-160kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz160KBitRateMonoMp3,\n  \"raw-16khz-16bit-mono-truesilk\": SpeechSDK.SpeechSynthesisOutputFormat.Raw16Khz16BitMonoTrueSilk,\n  \"riff-16khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff16Khz16BitMonoPcm,\n  \"riff-8khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff8Khz16BitMonoPcm,\n  \"riff-24khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff24Khz16BitMonoPcm,\n  \"riff-8khz-8bit-mono-mulaw\": SpeechSDK.SpeechSynthesisOutputFormat.Riff8Khz8BitMonoMULaw,\n  \"raw-16khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw16Khz16BitMonoPcm,\n  \"raw-24khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw24Khz16BitMonoPcm,\n  \"raw-8khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw8Khz16BitMonoPcm,\n  \"ogg-16khz-16bit-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Ogg16Khz16BitMonoOpus,\n  \"ogg-24khz-16bit-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Ogg24Khz16BitMonoOpus,\n  \"raw-48khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw48Khz16BitMonoPcm,\n  \"riff-48khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff48Khz16BitMonoPcm,\n  \"audio-48khz-96kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio48Khz96KBitRateMonoMp3,\n  \"audio-48khz-192kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio48Khz192KBitRateMonoMp3,\n  \"ogg-48khz-16bit-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Ogg48Khz16BitMonoOpus,\n  \"webm-16khz-16bit-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Webm16Khz16BitMonoOpus,\n  \"webm-24khz-16bit-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Webm24Khz16BitMonoOpus,\n  \"webm-24khz-16bit-24kbps-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Webm24Khz16Bit24KbpsMonoOpus,\n  \"raw-24khz-16bit-mono-truesilk\": SpeechSDK.SpeechSynthesisOutputFormat.Raw24Khz16BitMonoTrueSilk,\n  \"raw-8khz-8bit-mono-alaw\": SpeechSDK.SpeechSynthesisOutputFormat.Raw8Khz8BitMonoALaw,\n  \"riff-8khz-8bit-mono-alaw\": SpeechSDK.SpeechSynthesisOutputFormat.Riff8Khz8BitMonoALaw,\n  \"audio-16khz-16bit-32kbps-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz16Bit32KbpsMonoOpus,\n  \"audio-24khz-16bit-48kbps-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz16Bit48KbpsMonoOpus,\n  \"audio-24khz-16bit-24kbps-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz16Bit24KbpsMonoOpus,\n  \"raw-22050hz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw22050Hz16BitMonoPcm,\n  \"riff-22050hz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff22050Hz16BitMonoPcm,\n  \"raw-44100hz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw44100Hz16BitMonoPcm,\n  \"riff-44100hz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff44100Hz16BitMonoPcm,\n  \"amr-wb-16000hz\": SpeechSDK.SpeechSynthesisOutputFormat.AmrWb16000Hz,\n  \"g722-16khz-64kbps\": SpeechSDK.SpeechSynthesisOutputFormat.G72216Khz64Kbps,\n};\n\nexport function resolveOutputFormat(outputFormat: string): SpeechSDK.SpeechSynthesisOutputFormat {\n  const resolvedFormat = OUTPUT_FORMATS[outputFormat];\n  if (resolvedFormat === undefined) {\n    throw new Error(`Unsupported Azure Speech output format: ${outputFormat}`);\n  }\n\n  return resolvedFormat;\n}\n","import { synthesizeSpeech, synthesizeSsml } from \"./synthesis.ts\";\nimport type { AzureTtsClientOptions, SsmlSynthesisResult } from \"./types.ts\";\n\nconst ENDPOINT_TEMPLATE = \"https://{region}.tts.speech.microsoft.com/cognitiveservices/v1\";\n\nexport class AzureTtsClient {\n  readonly #options: AzureTtsClientOptions;\n\n  constructor(options: AzureTtsClientOptions) {\n    this.#options = options;\n  }\n\n  async synthesize(ssml: string): Promise<ArrayBuffer> {\n    const { region, subscriptionKey, outputFormat, signal, timeoutMs } = this.#options;\n    const endpoint = this.#options.endpoint?.trim() || ENDPOINT_TEMPLATE.replace(\"{region}\", region);\n    this.#options.logger?.debug?.(\"Using Azure TTS endpoint:\", endpoint);\n\n    const config = { endpoint, region, subscriptionKey, outputFormat, signal, timeoutMs };\n    return synthesizeSpeech(ssml, config);\n  }\n\n  async synthesizeSsml(ssml: string): Promise<SsmlSynthesisResult> {\n    const { region, subscriptionKey, outputFormat, signal, timeoutMs } = this.#options;\n    const endpoint = this.#options.endpoint?.trim() || ENDPOINT_TEMPLATE.replace(\"{region}\", region);\n    this.#options.logger?.debug?.(\"Using Azure TTS endpoint:\", endpoint);\n\n    return synthesizeSsml(ssml, { endpoint, region, subscriptionKey, outputFormat, signal, timeoutMs });\n  }\n}\n","const AZURE_VOICE_API_VERSION = \"2025-10-01\";\n\nexport interface FetchAzureVoiceCatalogOptions {\n  apiKey: string;\n  region: string | string[];\n}\n\nexport interface AzureVoiceCatalogVoice {\n  name: string;\n  locale: string;\n  secondaryLocales?: readonly string[];\n  styles?: readonly string[];\n  regions: readonly string[];\n  status?: \"ga\" | \"preview\" | \"deprecated\";\n}\n\nexport interface FetchedAzureVoiceCatalogMetadata {\n  voiceCount: number;\n  generatedAt: string;\n  apiVersion: string;\n  regions: readonly string[];\n}\n\nexport interface AzureVoiceCatalog {\n  voices: readonly AzureVoiceCatalogVoice[];\n  metadata: FetchedAzureVoiceCatalogMetadata;\n}\n\ninterface AzureVoiceApiRecord {\n  Locale?: unknown;\n  Name?: unknown;\n  SecondaryLocaleList?: unknown;\n  ShortName?: unknown;\n  Status?: unknown;\n  StyleList?: unknown;\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nfunction stringList(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return [...new Set(value.map(stringValue).filter((item): item is string => item !== undefined))];\n}\n\nfunction normalizeStatus(value: unknown): AzureVoiceCatalogVoice[\"status\"] {\n  const status = stringValue(value)?.toLowerCase();\n  if (status === \"preview\" || status === \"deprecated\" || status === \"ga\") return status;\n  return undefined;\n}\n\nfunction normalizeRegions(region: string | string[]): string[] {\n  const regions = Array.isArray(region) ? region : [region];\n  const result = [...new Set(regions.map((item) => item.trim()).filter(Boolean))];\n  if (result.length === 0) throw new TypeError(\"At least one Azure Speech region is required.\");\n  return result;\n}\n\nasync function fetchRegionVoices(region: string, apiKey: string): Promise<AzureVoiceApiRecord[]> {\n  const endpoint = `https://${encodeURIComponent(region)}.tts.speech.microsoft.com/cognitiveservices/voices/list`;\n  const response = await fetch(endpoint, {\n    headers: {\n      Accept: \"application/json\",\n      \"Ocp-Apim-Subscription-Key\": apiKey,\n    },\n  });\n  if (!response.ok) {\n    throw new Error(`Azure List Voices API request failed for region \"${region}\" with HTTP ${response.status}.`);\n  }\n  const payload: unknown = await response.json();\n  if (!Array.isArray(payload)) throw new Error(`Azure List Voices API returned an invalid response for \"${region}\".`);\n  return payload.filter((item): item is AzureVoiceApiRecord => Boolean(item && typeof item === \"object\"));\n}\n\n/** Fetches and deduplicates the current Azure Speech voice catalog for one or more regions. */\nexport async function fetchAzureVoiceCatalog(options: FetchAzureVoiceCatalogOptions): Promise<AzureVoiceCatalog> {\n  if (!options || typeof options.apiKey !== \"string\" || !options.apiKey.trim())\n    throw new TypeError(\"An Azure Speech API key is required.\");\n  const regions = normalizeRegions(options.region);\n  const payloads = await Promise.all(regions.map((region) => fetchRegionVoices(region, options.apiKey)));\n  const voices = new Map<string, AzureVoiceCatalogVoice>();\n\n  for (let regionIndex = 0; regionIndex < payloads.length; regionIndex += 1) {\n    const region = regions[regionIndex];\n    for (const record of payloads[regionIndex]) {\n      const name = stringValue(record.ShortName) ?? stringValue(record.Name);\n      const locale = stringValue(record.Locale);\n      if (!name || !locale) continue;\n      const key = name.toLowerCase();\n      const existing = voices.get(key);\n      const secondaryLocales = stringList(record.SecondaryLocaleList);\n      const styles = stringList(record.StyleList);\n      const status = normalizeStatus(record.Status);\n      const merged: AzureVoiceCatalogVoice = {\n        name: existing?.name ?? name,\n        locale: existing?.locale ?? locale,\n        regions: [...new Set([...(existing?.regions ?? []), region])],\n      };\n      const mergedSecondaryLocales = [...new Set([...(existing?.secondaryLocales ?? []), ...secondaryLocales])];\n      if (mergedSecondaryLocales.length > 0) merged.secondaryLocales = mergedSecondaryLocales;\n      const mergedStyles = [...new Set([...(existing?.styles ?? []), ...styles])];\n      if (mergedStyles.length > 0) merged.styles = mergedStyles;\n      if (status) merged.status = status;\n      else if (existing?.status) merged.status = existing.status;\n      voices.set(key, merged);\n    }\n  }\n\n  const sortedVoices = [...voices.values()].sort((first, second) => first.name.localeCompare(second.name));\n  return {\n    voices: sortedVoices,\n    metadata: {\n      voiceCount: sortedVoices.length,\n      generatedAt: new Date().toISOString(),\n      apiVersion: AZURE_VOICE_API_VERSION,\n      regions,\n    },\n  };\n}\n"],"mappings":"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","names":["SpeechSDK"]}
+{"version":3,"sources":["../packages/azure-tts-client/src/errors.ts","../packages/azure-tts-client/src/synthesis.ts","../packages/azure-tts-client/src/speechConfig.ts","../packages/azure-tts-client/src/outputFormats.ts","../packages/azure-tts-client/src/safe.ts","../packages/azure-tts-client/src/client.ts","../packages/azure-tts-client/src/voiceCatalog.ts"],"sourcesContent":["export class AzureTtsError extends Error {\n  readonly status: number;\n  readonly statusText: string;\n  readonly responseBody: string;\n  readonly requestId: string | null;\n\n  constructor(status: number, statusText: string, responseBody: string, requestId: string | null) {\n    super(`Azure TTS request failed: ${status} ${statusText}`);\n    this.name = \"AzureTtsError\";\n    this.status = status;\n    this.statusText = statusText;\n    this.responseBody = responseBody;\n    this.requestId = requestId;\n  }\n}\n\nexport class AzureTtsSdkError extends AzureTtsError {\n  readonly errorDetails: string;\n\n  constructor(errorDetails: string) {\n    super(0, \"Speech SDK\", errorDetails, null);\n    this.name = \"AzureTtsSdkError\";\n    this.message = `Azure TTS synthesis failed: ${errorDetails}`;\n    this.errorDetails = errorDetails;\n  }\n}\n\nexport function createSpeechSdkError(error: unknown): AzureTtsSdkError {\n  const message = error instanceof Error ? error.message : String(error);\n  return new AzureTtsSdkError(message);\n}\n","import * as SpeechSDK from \"microsoft-cognitiveservices-speech-sdk\";\nimport { createSpeechSdkError } from \"./errors.ts\";\nimport { createSpeechConfig } from \"./speechConfig.ts\";\nimport type { SsmlSynthesisChunk, SsmlSynthesisResult, TtsConfig } from \"./types.ts\";\n\nfunction closeSpeechResources(speechConfig: SpeechSDK.SpeechConfig, synthesizer: SpeechSDK.SpeechSynthesizer): void {\n  try {\n    synthesizer.close();\n  } catch {}\n\n  try {\n    speechConfig.close();\n  } catch {}\n}\n\nconst ticksToMilliseconds = (ticks: number): number => Math.max(0, ticks) / 10_000;\n\nexport async function synthesizeSsml(ssml: string, config: TtsConfig): Promise<SsmlSynthesisResult> {\n  if (config.signal?.aborted) {\n    throw createSpeechSdkError(\"Speech synthesis was cancelled.\");\n  }\n\n  const speechConfig = createSpeechConfig(config);\n  const synthesizer = new SpeechSDK.SpeechSynthesizer(speechConfig, null);\n\n  return await new Promise<SsmlSynthesisResult>((resolve, reject) => {\n    let resourcesClosed = false;\n    let settled = false;\n    let timeout: ReturnType<typeof setTimeout> | undefined;\n    let abortHandler: (() => void) | undefined;\n    const cleanup = () => {\n      if (timeout) clearTimeout(timeout);\n      if (abortHandler) config.signal?.removeEventListener(\"abort\", abortHandler);\n    };\n    const closeResources = () => {\n      if (resourcesClosed) return;\n      resourcesClosed = true;\n      closeSpeechResources(speechConfig, synthesizer);\n    };\n    const rejectWithError = (error: unknown) => {\n      if (settled) return;\n      settled = true;\n      cleanup();\n      closeResources();\n      reject(createSpeechSdkError(error));\n    };\n\n    const boundaries: SsmlSynthesisResult[\"boundaries\"] = [];\n    const visemes: SsmlSynthesisResult[\"visemes\"] = [];\n    const bookmarks: SsmlSynthesisResult[\"bookmarks\"] = [];\n    synthesizer.wordBoundary = (_sender, event) => {\n      boundaries.push({\n        text: event.text,\n        audioOffsetMs: ticksToMilliseconds(event.audioOffset),\n        durationMs: ticksToMilliseconds(event.duration),\n      });\n    };\n    synthesizer.visemeReceived = (_sender, event) => {\n      visemes.push({ visemeId: event.visemeId, audioOffsetMs: ticksToMilliseconds(event.audioOffset) });\n    };\n    synthesizer.bookmarkReached = (_sender, event) => {\n      bookmarks.push({ name: event.text, audioOffsetMs: ticksToMilliseconds(event.audioOffset) });\n    };\n\n    const cb = (result: SpeechSDK.SpeechSynthesisResult) => {\n      if (settled) return;\n      const { reason, errorDetails } = result;\n      if (reason !== SpeechSDK.ResultReason.SynthesizingAudioCompleted) {\n        const err = errorDetails || `Speech synthesis failed with reason ${reason}.`;\n        rejectWithError(err);\n        return;\n      }\n      settled = true;\n      cleanup();\n      closeResources();\n      const eventDurationMs = Math.max(\n        0,\n        ...(boundaries ?? []).map((boundary) => boundary.audioOffsetMs + boundary.durationMs),\n        ...(visemes ?? []).map((viseme) => viseme.audioOffsetMs),\n        ...(bookmarks ?? []).map((bookmark) => bookmark.audioOffsetMs),\n      );\n      const durationMs = result.audioDuration ? ticksToMilliseconds(result.audioDuration) : eventDurationMs;\n      const requestId = (result as SpeechSDK.SpeechSynthesisResult & { resultId?: string }).resultId;\n      const addSourceMetadata = <T extends { audioOffsetMs: number }>(event: T): T => ({\n        ...event,\n        ...(config.sourceTextRange ? { textRange: { ...config.sourceTextRange } } : {}),\n        ...(requestId ? { requestId } : {}),\n      });\n      const sourceBoundaries = boundaries.map((boundary) => addSourceMetadata(boundary));\n      const sourceVisemes = visemes.map((viseme) => addSourceMetadata(viseme));\n      const sourceBookmarks = bookmarks.map((bookmark) => addSourceMetadata(bookmark));\n      resolve({\n        audioData: result.audioData,\n        durationMs,\n        ...(config.sourceTextRange ? { textRange: { ...config.sourceTextRange } } : {}),\n        ...(requestId ? { requestId } : {}),\n        ...(sourceBoundaries.length > 0\n          ? { boundaries: sourceBoundaries, wordBoundary: sourceBoundaries, wordBoundaries: sourceBoundaries }\n          : {}),\n        ...(sourceVisemes.length > 0 ? { visemes: sourceVisemes } : {}),\n        ...(sourceBookmarks.length > 0 ? { bookmarks: sourceBookmarks } : {}),\n      });\n    };\n\n    try {\n      if (config.signal) {\n        abortHandler = () => rejectWithError(\"Speech synthesis was cancelled.\");\n        config.signal.addEventListener(\"abort\", abortHandler, { once: true });\n      }\n      if (config.timeoutMs !== undefined && config.timeoutMs > 0) {\n        timeout = setTimeout(\n          () => rejectWithError(`Speech synthesis timed out after ${config.timeoutMs} ms.`),\n          config.timeoutMs,\n        );\n      }\n      synthesizer.speakSsmlAsync(ssml, cb, rejectWithError);\n    } catch (error) {\n      rejectWithError(error);\n    }\n  });\n}\n\n/** Synthesizes chunks sequentially, annotates synchronization events, and merges the results. */\nexport async function synthesizeSsmlChunks(\n  chunks: readonly (SsmlSynthesisChunk | string)[],\n  config: TtsConfig,\n): Promise<SsmlSynthesisResult> {\n  const results: SsmlSynthesisResult[] = [];\n  const totalChunks = chunks.length;\n  for (const [index, chunk] of chunks.entries()) {\n    const input = typeof chunk === \"string\" ? { ssml: chunk } : chunk;\n    const result = await synthesizeSsml(input.ssml, {\n      ...config,\n      ...(input.originalTextRange ? { sourceTextRange: input.originalTextRange } : {}),\n      onProgress: undefined,\n    });\n    results.push(result);\n    config.onProgress?.({\n      currentChunk: index + 1,\n      totalChunks,\n      percent: totalChunks === 0 ? 100 : Math.round(((index + 1) / totalChunks) * 100),\n    });\n  }\n  return mergeSynthesisResults(results);\n}\n\n/** Concatenates audio buffers and shifts all synchronization events by prior chunk durations. */\nexport function mergeSynthesisResults(results: readonly SsmlSynthesisResult[]): SsmlSynthesisResult {\n  const audioLength = results.reduce((total, result) => total + result.audioData.byteLength, 0);\n  const audioData = new Uint8Array(audioLength);\n  const boundaries: NonNullable<SsmlSynthesisResult[\"boundaries\"]> = [];\n  const visemes: NonNullable<SsmlSynthesisResult[\"visemes\"]> = [];\n  const bookmarks: NonNullable<SsmlSynthesisResult[\"bookmarks\"]> = [];\n  let byteOffset = 0;\n  let durationOffset = 0;\n\n  for (const result of results) {\n    audioData.set(new Uint8Array(result.audioData), byteOffset);\n    byteOffset += result.audioData.byteLength;\n    const chunkBoundaries =\n      result.boundaries && result.boundaries.length > 0\n        ? result.boundaries\n        : (result.wordBoundary ?? result.wordBoundaries ?? []);\n    for (const boundary of chunkBoundaries) {\n      const textRange = boundary.textRange ?? result.textRange;\n      const requestId = boundary.requestId ?? result.requestId;\n      boundaries.push({\n        ...boundary,\n        audioOffsetMs: boundary.audioOffsetMs + durationOffset,\n        ...(textRange ? { textRange: { ...textRange } } : {}),\n        ...(requestId ? { requestId } : {}),\n      });\n    }\n    for (const viseme of result.visemes ?? []) {\n      const textRange = viseme.textRange ?? result.textRange;\n      const requestId = viseme.requestId ?? result.requestId;\n      visemes.push({\n        ...viseme,\n        audioOffsetMs: viseme.audioOffsetMs + durationOffset,\n        ...(textRange ? { textRange: { ...textRange } } : {}),\n        ...(requestId ? { requestId } : {}),\n      });\n    }\n    for (const bookmark of result.bookmarks ?? []) {\n      const textRange = bookmark.textRange ?? result.textRange;\n      const requestId = bookmark.requestId ?? result.requestId;\n      bookmarks.push({\n        ...bookmark,\n        audioOffsetMs: bookmark.audioOffsetMs + durationOffset,\n        ...(textRange ? { textRange: { ...textRange } } : {}),\n        ...(requestId ? { requestId } : {}),\n      });\n    }\n    durationOffset += Math.max(0, result.durationMs);\n  }\n\n  return {\n    audioData: audioData.buffer,\n    durationMs: durationOffset,\n    ...(boundaries.length > 0 ? { boundaries, wordBoundary: boundaries, wordBoundaries: boundaries } : {}),\n    ...(visemes.length > 0 ? { visemes } : {}),\n    ...(bookmarks.length > 0 ? { bookmarks } : {}),\n    ...(results.length === 1 && results[0]?.requestId ? { requestId: results[0].requestId } : {}),\n    ...(results.length === 1 && results[0]?.textRange ? { textRange: { ...results[0].textRange } } : {}),\n  };\n}\n\n/** Backward-compatible audio-only synthesis helper. */\nexport async function synthesizeSpeech(ssml: string, config: TtsConfig): Promise<ArrayBuffer> {\n  return (await synthesizeSsml(ssml, config)).audioData;\n}\n","import { SpeechConfig } from \"microsoft-cognitiveservices-speech-sdk\";\nimport { DEFAULT_OUTPUT_FORMAT, resolveOutputFormat } from \"./outputFormats.ts\";\nimport type { TtsConfig } from \"./types.ts\";\n\nexport function resolveEndpoint(config: TtsConfig): string {\n  const endpoint = config.endpoint?.trim() || \"https://{region}.tts.speech.microsoft.com/cognitiveservices/v1\";\n  return endpoint.replace(/\\{region\\}/g, encodeURIComponent(config.region));\n}\n\nexport function createSpeechConfig(config: TtsConfig): SpeechConfig {\n  const { outputFormat = DEFAULT_OUTPUT_FORMAT, subscriptionKey } = config;\n\n  const endpoint = new URL(resolveEndpoint(config));\n  const speechConfig = SpeechConfig.fromEndpoint(endpoint, subscriptionKey);\n  speechConfig.speechSynthesisOutputFormat = resolveOutputFormat(outputFormat);\n  return speechConfig;\n}\n","import * as SpeechSDK from \"microsoft-cognitiveservices-speech-sdk\";\n\nexport const DEFAULT_OUTPUT_FORMAT = \"audio-16khz-128kbitrate-mono-mp3\";\n\nconst OUTPUT_FORMATS: Record<string, SpeechSDK.SpeechSynthesisOutputFormat> = {\n  \"raw-8khz-8bit-mono-mulaw\": SpeechSDK.SpeechSynthesisOutputFormat.Raw8Khz8BitMonoMULaw,\n  \"riff-16khz-16kbps-mono-siren\": SpeechSDK.SpeechSynthesisOutputFormat.Riff16Khz16KbpsMonoSiren,\n  \"audio-16khz-16kbps-mono-siren\": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz16KbpsMonoSiren,\n  \"audio-16khz-32kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz32KBitRateMonoMp3,\n  \"audio-16khz-128kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz128KBitRateMonoMp3,\n  \"audio-16khz-64kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz64KBitRateMonoMp3,\n  \"audio-24khz-48kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz48KBitRateMonoMp3,\n  \"audio-24khz-96kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz96KBitRateMonoMp3,\n  \"audio-24khz-160kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz160KBitRateMonoMp3,\n  \"raw-16khz-16bit-mono-truesilk\": SpeechSDK.SpeechSynthesisOutputFormat.Raw16Khz16BitMonoTrueSilk,\n  \"riff-16khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff16Khz16BitMonoPcm,\n  \"riff-8khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff8Khz16BitMonoPcm,\n  \"riff-24khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff24Khz16BitMonoPcm,\n  \"riff-8khz-8bit-mono-mulaw\": SpeechSDK.SpeechSynthesisOutputFormat.Riff8Khz8BitMonoMULaw,\n  \"raw-16khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw16Khz16BitMonoPcm,\n  \"raw-24khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw24Khz16BitMonoPcm,\n  \"raw-8khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw8Khz16BitMonoPcm,\n  \"ogg-16khz-16bit-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Ogg16Khz16BitMonoOpus,\n  \"ogg-24khz-16bit-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Ogg24Khz16BitMonoOpus,\n  \"raw-48khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw48Khz16BitMonoPcm,\n  \"riff-48khz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff48Khz16BitMonoPcm,\n  \"audio-48khz-96kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio48Khz96KBitRateMonoMp3,\n  \"audio-48khz-192kbitrate-mono-mp3\": SpeechSDK.SpeechSynthesisOutputFormat.Audio48Khz192KBitRateMonoMp3,\n  \"ogg-48khz-16bit-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Ogg48Khz16BitMonoOpus,\n  \"webm-16khz-16bit-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Webm16Khz16BitMonoOpus,\n  \"webm-24khz-16bit-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Webm24Khz16BitMonoOpus,\n  \"webm-24khz-16bit-24kbps-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Webm24Khz16Bit24KbpsMonoOpus,\n  \"raw-24khz-16bit-mono-truesilk\": SpeechSDK.SpeechSynthesisOutputFormat.Raw24Khz16BitMonoTrueSilk,\n  \"raw-8khz-8bit-mono-alaw\": SpeechSDK.SpeechSynthesisOutputFormat.Raw8Khz8BitMonoALaw,\n  \"riff-8khz-8bit-mono-alaw\": SpeechSDK.SpeechSynthesisOutputFormat.Riff8Khz8BitMonoALaw,\n  \"audio-16khz-16bit-32kbps-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Audio16Khz16Bit32KbpsMonoOpus,\n  \"audio-24khz-16bit-48kbps-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz16Bit48KbpsMonoOpus,\n  \"audio-24khz-16bit-24kbps-mono-opus\": SpeechSDK.SpeechSynthesisOutputFormat.Audio24Khz16Bit24KbpsMonoOpus,\n  \"raw-22050hz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw22050Hz16BitMonoPcm,\n  \"riff-22050hz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff22050Hz16BitMonoPcm,\n  \"raw-44100hz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Raw44100Hz16BitMonoPcm,\n  \"riff-44100hz-16bit-mono-pcm\": SpeechSDK.SpeechSynthesisOutputFormat.Riff44100Hz16BitMonoPcm,\n  \"amr-wb-16000hz\": SpeechSDK.SpeechSynthesisOutputFormat.AmrWb16000Hz,\n  \"g722-16khz-64kbps\": SpeechSDK.SpeechSynthesisOutputFormat.G72216Khz64Kbps,\n};\n\nexport function resolveOutputFormat(outputFormat: string): SpeechSDK.SpeechSynthesisOutputFormat {\n  const resolvedFormat = OUTPUT_FORMATS[outputFormat];\n  if (resolvedFormat === undefined) {\n    throw new Error(`Unsupported Azure Speech output format: ${outputFormat}`);\n  }\n\n  return resolvedFormat;\n}\n","import { validateAzureSsml, type AzureValidationOptions, type SsmlDiagnostic } from \"@ssml-builder-js/ssml-core\";\nimport { AzureTtsError, createSpeechSdkError } from \"./errors.ts\";\nimport type { AzureTtsClient } from \"./client.ts\";\nimport type { SsmlSynthesisResult } from \"./types.ts\";\n\nexport interface SsmlValidationError {\n  readonly kind: \"validation\";\n  readonly message: string;\n  readonly diagnostics: readonly SsmlDiagnostic[];\n}\n\nexport type Result<T, E> =\n  | { readonly ok: true; readonly success: true; readonly status: \"success\"; readonly value: T }\n  | {\n      readonly ok: false;\n      readonly success: false;\n      readonly status: \"validation-error\" | \"azure-api-error\";\n      readonly error: E;\n    };\n\nexport type SynthesisResult<T, E> = Result<T, E>;\n\nexport type Success<T> = Extract<Result<T, never>, { readonly ok: true }>;\nexport type ValidationErrorResult = Extract<\n  Result<never, SsmlValidationError>,\n  { readonly status: \"validation-error\" }\n>;\nexport type AzureApiErrorResult = Extract<Result<never, AzureTtsError>, { readonly status: \"azure-api-error\" }>;\n\nexport type SsmlSynthesisSafeResult =\n  | Result<SsmlSynthesisResult, never>\n  | Result<never, SsmlValidationError>\n  | Result<never, AzureTtsError>;\n\nexport interface SynthesizeSsmlSafeOptions extends AzureValidationOptions {\n  /** Optional nested form for callers that want to keep validation settings grouped. */\n  validation?: AzureValidationOptions;\n}\n\ninterface SynthesisClient {\n  synthesizeSsml(ssml: string): Promise<SsmlSynthesisResult>;\n}\n\n/** Validates SSML before invoking Azure and converts validation/API failures to one result shape. */\nexport async function synthesizeSsmlSafe(\n  client: Pick<AzureTtsClient, \"synthesizeSsml\"> | SynthesisClient,\n  ssml: string,\n  options: SynthesizeSsmlSafeOptions = {},\n): Promise<SsmlSynthesisSafeResult> {\n  const validationOptions = options.validation ?? options;\n  const diagnostics = await Promise.resolve(validateAzureSsml(ssml, validationOptions));\n  const errors = diagnostics.filter((diagnostic) => diagnostic.severity === \"error\");\n  if (errors.length > 0) {\n    return {\n      ok: false,\n      success: false,\n      status: \"validation-error\",\n      error: {\n        kind: \"validation\",\n        message: \"SSML validation failed; the Azure Speech API was not called.\",\n        diagnostics: errors,\n      },\n    };\n  }\n\n  try {\n    return { ok: true, success: true, status: \"success\", value: await client.synthesizeSsml(ssml) };\n  } catch (error) {\n    const azureError = error instanceof AzureTtsError ? error : createSpeechSdkError(error);\n    return { ok: false, success: false, status: \"azure-api-error\", error: azureError };\n  }\n}\n","import { synthesizeSpeech, synthesizeSsml, synthesizeSsmlChunks } from \"./synthesis.ts\";\nimport { synthesizeSsmlSafe } from \"./safe.ts\";\nimport type { SynthesizeSsmlSafeOptions } from \"./safe.ts\";\nimport type {\n  AzureTtsClientOptions,\n  SsmlSynthesisChunk,\n  SsmlSynthesisResult,\n  SynthesizeChunksOptions,\n} from \"./types.ts\";\n\nconst ENDPOINT_TEMPLATE = \"https://{region}.tts.speech.microsoft.com/cognitiveservices/v1\";\n\nexport class AzureTtsClient {\n  readonly #options: AzureTtsClientOptions;\n\n  constructor(options: AzureTtsClientOptions) {\n    this.#options = options;\n  }\n\n  async synthesize(ssml: string): Promise<ArrayBuffer> {\n    const { region, subscriptionKey, outputFormat, signal, timeoutMs } = this.#options;\n    const endpoint = this.#options.endpoint?.trim() || ENDPOINT_TEMPLATE.replace(\"{region}\", region);\n    this.#options.logger?.debug?.(\"Using Azure TTS endpoint:\", endpoint);\n\n    const config = { endpoint, region, subscriptionKey, outputFormat, signal, timeoutMs };\n    return synthesizeSpeech(ssml, config);\n  }\n\n  async synthesizeSsml(ssml: string): Promise<SsmlSynthesisResult> {\n    const { region, subscriptionKey, outputFormat, signal, timeoutMs } = this.#options;\n    const endpoint = this.#options.endpoint?.trim() || ENDPOINT_TEMPLATE.replace(\"{region}\", region);\n    this.#options.logger?.debug?.(\"Using Azure TTS endpoint:\", endpoint);\n\n    return synthesizeSsml(ssml, { endpoint, region, subscriptionKey, outputFormat, signal, timeoutMs });\n  }\n\n  async synthesizeChunks(\n    chunks: readonly (SsmlSynthesisChunk | string)[],\n    options: SynthesizeChunksOptions = {},\n  ): Promise<SsmlSynthesisResult> {\n    const { region, subscriptionKey, outputFormat, signal, timeoutMs } = this.#options;\n    const endpoint = this.#options.endpoint?.trim() || ENDPOINT_TEMPLATE.replace(\"{region}\", region);\n    return synthesizeSsmlChunks(chunks, {\n      endpoint,\n      region,\n      subscriptionKey,\n      outputFormat,\n      signal,\n      timeoutMs,\n      onProgress: options.onProgress ?? this.#options.onProgress,\n    });\n  }\n\n  async synthesizeSsmlSafe(ssml: string, options: SynthesizeSsmlSafeOptions = {}) {\n    return synthesizeSsmlSafe(this, ssml, options);\n  }\n}\n","const AZURE_VOICE_API_VERSION = \"2025-10-01\";\n\nexport interface FetchAzureVoiceCatalogOptions {\n  apiKey: string;\n  region: string | string[];\n}\n\nexport interface AzureVoiceCatalogVoice {\n  name: string;\n  locale: string;\n  secondaryLocales?: readonly string[];\n  styles?: readonly string[];\n  regions: readonly string[];\n  status?: \"ga\" | \"preview\" | \"deprecated\";\n}\n\nexport interface FetchedAzureVoiceCatalogMetadata {\n  voiceCount: number;\n  generatedAt: string;\n  apiVersion: string;\n  regions: readonly string[];\n}\n\nexport interface AzureVoiceCatalog {\n  voices: readonly AzureVoiceCatalogVoice[];\n  metadata: FetchedAzureVoiceCatalogMetadata;\n}\n\ninterface AzureVoiceApiRecord {\n  Locale?: unknown;\n  Name?: unknown;\n  SecondaryLocaleList?: unknown;\n  ShortName?: unknown;\n  Status?: unknown;\n  StyleList?: unknown;\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nfunction stringList(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return [...new Set(value.map(stringValue).filter((item): item is string => item !== undefined))];\n}\n\nfunction normalizeStatus(value: unknown): AzureVoiceCatalogVoice[\"status\"] {\n  const status = stringValue(value)?.toLowerCase();\n  if (status === \"preview\" || status === \"deprecated\" || status === \"ga\") return status;\n  return undefined;\n}\n\nfunction normalizeRegions(region: string | string[]): string[] {\n  const regions = Array.isArray(region) ? region : [region];\n  const result = [...new Set(regions.map((item) => item.trim()).filter(Boolean))];\n  if (result.length === 0) throw new TypeError(\"At least one Azure Speech region is required.\");\n  return result;\n}\n\nasync function fetchRegionVoices(region: string, apiKey: string): Promise<AzureVoiceApiRecord[]> {\n  const endpoint = `https://${encodeURIComponent(region)}.tts.speech.microsoft.com/cognitiveservices/voices/list`;\n  const response = await fetch(endpoint, {\n    headers: {\n      Accept: \"application/json\",\n      \"Ocp-Apim-Subscription-Key\": apiKey,\n    },\n  });\n  if (!response.ok) {\n    throw new Error(`Azure List Voices API request failed for region \"${region}\" with HTTP ${response.status}.`);\n  }\n  const payload: unknown = await response.json();\n  if (!Array.isArray(payload)) throw new Error(`Azure List Voices API returned an invalid response for \"${region}\".`);\n  return payload.filter((item): item is AzureVoiceApiRecord => Boolean(item && typeof item === \"object\"));\n}\n\n/** Fetches and deduplicates the current Azure Speech voice catalog for one or more regions. */\nexport async function fetchAzureVoiceCatalog(options: FetchAzureVoiceCatalogOptions): Promise<AzureVoiceCatalog> {\n  if (!options || typeof options.apiKey !== \"string\" || !options.apiKey.trim())\n    throw new TypeError(\"An Azure Speech API key is required.\");\n  const regions = normalizeRegions(options.region);\n  const payloads = await Promise.all(regions.map((region) => fetchRegionVoices(region, options.apiKey)));\n  const voices = new Map<string, AzureVoiceCatalogVoice>();\n\n  for (let regionIndex = 0; regionIndex < payloads.length; regionIndex += 1) {\n    const region = regions[regionIndex];\n    for (const record of payloads[regionIndex]) {\n      const name = stringValue(record.ShortName) ?? stringValue(record.Name);\n      const locale = stringValue(record.Locale);\n      if (!name || !locale) continue;\n      const key = name.toLowerCase();\n      const existing = voices.get(key);\n      const secondaryLocales = stringList(record.SecondaryLocaleList);\n      const styles = stringList(record.StyleList);\n      const status = normalizeStatus(record.Status);\n      const merged: AzureVoiceCatalogVoice = {\n        name: existing?.name ?? name,\n        locale: existing?.locale ?? locale,\n        regions: [...new Set([...(existing?.regions ?? []), region])],\n      };\n      const mergedSecondaryLocales = [...new Set([...(existing?.secondaryLocales ?? []), ...secondaryLocales])];\n      if (mergedSecondaryLocales.length > 0) merged.secondaryLocales = mergedSecondaryLocales;\n      const mergedStyles = [...new Set([...(existing?.styles ?? []), ...styles])];\n      if (mergedStyles.length > 0) merged.styles = mergedStyles;\n      if (status) merged.status = status;\n      else if (existing?.status) merged.status = existing.status;\n      voices.set(key, merged);\n    }\n  }\n\n  const sortedVoices = [...voices.values()].sort((first, second) => first.name.localeCompare(second.name));\n  return {\n    voices: sortedVoices,\n    metadata: {\n      voiceCount: sortedVoices.length,\n      generatedAt: new Date().toISOString(),\n      apiVersion: AZURE_VOICE_API_VERSION,\n      regions,\n    },\n  };\n}\n"],"mappings":"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","names":["SpeechSDK","validateAzureSsml"]}

package/dist/react.d.mts

@@ -1,160 +1,8 @@
 import * as react from 'react';
-import { ReactNode, CSSProperties, ReactElement } from 'react';
+import { ReactNode, ReactElement, CSSProperties } from 'react';
+import { a as SsmlDocument, b as SsmlElement } from './index.d-Xbr6ZWnK.mjs';
 import { OnMount, Monaco } from '@monaco-editor/react';
 
-type SsmlAttributeValue = string | number;
-type SsmlAttributes = Record<string, SsmlAttributeValue>;
-interface SsmlText {
-    type: "text";
-    value: string;
-}
-type SsmlNode = string | SsmlText | SsmlElement;
-interface SsmlElementBase {
-    children?: SsmlNode[];
-    attributes?: SsmlAttributes;
-}
-interface VoiceElement extends SsmlElementBase {
-    type: "voice";
-    name?: string;
-    effect?: string;
-}
-interface ProsodyElement extends SsmlElementBase {
-    type: "prosody";
-    rate?: SsmlAttributeValue;
-    pitch?: SsmlAttributeValue;
-    volume?: SsmlAttributeValue;
-    contour?: string;
-    range?: SsmlAttributeValue;
-}
-interface BreakElement extends SsmlElementBase {
-    type: "break";
-    time?: SsmlAttributeValue;
-    strength?: string;
-}
-interface ExpressAsElement extends SsmlElementBase {
-    type: "express-as" | "expressAs" | "mstts:express-as";
-    style?: string;
-    styleDegree?: SsmlAttributeValue;
-    role?: string;
-}
-interface SayAsElement extends SsmlElementBase {
-    type: "say-as" | "sayAs";
-    interpretAs?: string;
-    format?: string;
-    detail?: string;
-}
-interface PhonemeElement extends SsmlElementBase {
-    type: "phoneme";
-    alphabet?: string;
-    ph?: string;
-}
-interface EmphasisElement extends SsmlElementBase {
-    type: "emphasis";
-    level?: string;
-}
-interface AudioElement extends SsmlElementBase {
-    type: "audio";
-    src?: string;
-    desc?: string;
-    clipBegin?: SsmlAttributeValue;
-    clipEnd?: SsmlAttributeValue;
-    speed?: SsmlAttributeValue;
-    repeatCount?: SsmlAttributeValue;
-    repeatDuration?: SsmlAttributeValue;
-    soundLevel?: SsmlAttributeValue;
-}
-interface SubElement extends SsmlElementBase {
-    type: "sub";
-    alias?: string;
-}
-interface LangElement extends SsmlElementBase {
-    type: "lang";
-    lang?: string;
-}
-interface MarkElement extends SsmlElementBase {
-    type: "mark";
-    name?: string;
-}
-interface BookmarkElement extends SsmlElementBase {
-    type: "bookmark";
-    mark?: string;
-}
-interface LexiconElement extends SsmlElementBase {
-    type: "lexicon";
-    uri?: string;
-}
-interface ParagraphElement extends SsmlElementBase {
-    type: "p";
-}
-interface SentenceElement extends SsmlElementBase {
-    type: "s";
-}
-interface WordElement extends SsmlElementBase {
-    type: "w";
-}
-interface MsttsSilenceElement extends SsmlElementBase {
-    type: "mstts:silence" | "silence";
-    typeValue?: string;
-    silenceType?: string;
-    value?: SsmlAttributeValue;
-}
-interface MsttsVisemeElement extends SsmlElementBase {
-    type: "mstts:viseme" | "viseme";
-    typeValue?: string;
-    visemeType?: string;
-}
-interface MsttsAudioDurationElement extends SsmlElementBase {
-    type: "mstts:audioduration";
-    value?: SsmlAttributeValue;
-}
-interface SsmlDialogNode extends SsmlElementBase {
-    type: "mstts:dialog";
-}
-interface SsmlTurnNode extends SsmlElementBase {
-    type: "mstts:turn";
-    voice?: string;
-    speaker?: string;
-}
-interface SsmlBackgroundAudioNode extends SsmlElementBase {
-    type: "mstts:backgroundaudio";
-    src?: string;
-    volume?: SsmlAttributeValue;
-    fadeIn?: SsmlAttributeValue;
-    fadeOut?: SsmlAttributeValue;
-    /** XML spelling aliases retained for ergonomic object construction. */
-    fadein?: SsmlAttributeValue;
-    fadeout?: SsmlAttributeValue;
-}
-interface MsttsTtsEmbeddingElement extends SsmlElementBase {
-    type: "mstts:ttsembedding";
-    speakerProfileId?: string;
-}
-interface MsttsEmbeddingElement extends SsmlElementBase {
-    type: "mstts:embedding";
-    id?: string;
-    speakerProfileId?: string;
-}
-interface MsttsVoiceConversionElement extends SsmlElementBase {
-    type: "mstts:voiceconversion";
-    url?: string;
-    profile?: string;
-    speakerProfileId?: string;
-}
-interface CustomElement extends SsmlElementBase {
-    type: "custom" | "element";
-    name: string;
-}
-type SsmlElement = VoiceElement | ProsodyElement | BreakElement | ExpressAsElement | SayAsElement | PhonemeElement | EmphasisElement | AudioElement | SubElement | LangElement | MarkElement | BookmarkElement | LexiconElement | ParagraphElement | SentenceElement | WordElement | MsttsSilenceElement | MsttsVisemeElement | MsttsAudioDurationElement | SsmlDialogNode | SsmlTurnNode | SsmlBackgroundAudioNode | MsttsTtsEmbeddingElement | MsttsEmbeddingElement | MsttsVoiceConversionElement | CustomElement;
-interface SsmlDocument {
-    type?: "speak";
-    version: string;
-    lang: string;
-    children?: SsmlNode[];
-    /** @deprecated Use children to represent the document body. */
-    content?: string;
-    attributes?: SsmlAttributes;
-}
-
 type SsmlEditorInsertionButton = "break" | "emphasis" | "rate" | "pitch" | "volume" | "emotion" | "say-as" | "phoneme" | "audio" | "sub" | "lang" | "mark" | "bookmark" | "mstts:silence" | "mstts:audioduration" | "mstts:viseme" | (string & {});
 type SsmlEditorButton = "help" | SsmlEditorInsertionButton | "undo" | "redo" | "clearAll" | "format" | "decorations" | (string & {});
 type SsmlEditorButtonVisibility = Readonly<Partial<Record<string, boolean>>>;
@@ -215,10 +63,56 @@ interface SsmlHoverLocale {
     noParameters: string;
     tags: Readonly<Record<string, SsmlHoverTagCopy>>;
 }
+interface SsmlElementLocaleCopy {
+    label: string;
+    description: string;
+    validationErrors: Readonly<Record<string, string>>;
+}
+/** Localized labels and validation copy for Azure extension elements. */
+declare const SSML_ELEMENT_COPY: Readonly<Record<SsmlEditorLocale, Readonly<Record<string, SsmlElementLocaleCopy>>>>;
 declare const EDITOR_COPY: Readonly<Record<SsmlEditorLocale, EditorCopy>>;
 declare const INLINE_BADGE_COPY: Readonly<Record<SsmlEditorLocale, InlineBadgeCopy>>;
 declare const SSML_HOVER_COPY: Readonly<Record<SsmlEditorLocale, SsmlHoverLocale>>;
 
+interface VisualVoiceCatalogEntry {
+    name: string;
+    locale: string;
+    region?: string;
+    styles?: readonly string[];
+    preview?: boolean;
+    status?: "ga" | "preview" | "deprecated";
+}
+interface VoiceSelectorRenderProps {
+    value: string;
+    voices: readonly VisualVoiceCatalogEntry[];
+    readOnly: boolean;
+    locale: SsmlEditorLocale;
+    onChange: (voice: string) => void;
+}
+interface VisualInspectorRenderProps {
+    document: SsmlDocument;
+    element: SsmlElement;
+    path: number[];
+    readOnly: boolean;
+    onChange: (document: SsmlDocument) => void;
+    locale: SsmlEditorLocale;
+}
+type VisualInspectorRenderer = (props: VisualInspectorRenderProps) => ReactNode;
+interface VisualSsmlEditorProps {
+    document: SsmlDocument;
+    readOnly?: boolean;
+    onChange?: (document: SsmlDocument) => void;
+    onPreviewSelection?: (ssml: string) => void;
+    locale?: SsmlEditorLocale;
+    customInspectors?: Readonly<Record<string, VisualInspectorRenderer>>;
+    renderVoiceSelector?: (props: VoiceSelectorRenderProps) => ReactNode;
+    voiceCatalog?: readonly VisualVoiceCatalogEntry[];
+    voiceLocale?: string;
+    voiceRegion?: string;
+    voiceStyle?: string;
+}
+declare function VisualSsmlEditor({ document, readOnly, onChange, onPreviewSelection, locale, customInspectors, renderVoiceSelector, voiceCatalog, voiceLocale, voiceRegion, voiceStyle, }: VisualSsmlEditorProps): ReactElement;
+
 type SsmlEditorInsertionMode = "insert" | "wrap";
 interface SsmlEditorInsertionOption {
     value: string;
@@ -391,6 +285,18 @@ interface SsmlEditorProps {
     customInsertions?: SsmlEditorCustomInsertionCollection;
     /** Adds insertion definitions without replacing built-in definitions. */
     additionalInsertions?: SsmlEditorCustomInsertionCollection;
+    /** Replaces the visual inspector for an element type or serialized tag name. */
+    customInspectors?: Readonly<Record<string, VisualInspectorRenderer>>;
+    /** Replaces the built-in voice catalog selector in visual mode. */
+    renderVoiceSelector?: (props: VoiceSelectorRenderProps) => ReactNode;
+    /** Voice metadata used by the visual selector. */
+    voiceCatalog?: readonly VisualVoiceCatalogEntry[];
+    /** Optional locale filter for the visual voice selector. */
+    voiceLocale?: string;
+    /** Optional region filter for the visual voice selector. */
+    voiceRegion?: string;
+    /** Optional style filter for the visual voice selector. */
+    voiceStyle?: string;
     /** Candidate style values shown by the built-in emotion insertion. */
     emotionStyles?: readonly string[];
     /** Class name applied to the editor container. */
@@ -419,14 +325,6 @@ interface SsmlEditorRef {
 }
 declare const SsmlEditor: react.ForwardRefExoticComponent<SsmlEditorProps & react.RefAttributes<SsmlEditorRef>>;
 
-interface VisualSsmlEditorProps {
-    document: SsmlDocument;
-    readOnly?: boolean;
-    onChange?: (document: SsmlDocument) => void;
-    onPreviewSelection?: (ssml: string) => void;
-}
-declare function VisualSsmlEditor({ document, readOnly, onChange, onPreviewSelection, }: VisualSsmlEditorProps): ReactElement;
-
 type MonacoEditor = Parameters<OnMount>[0];
 
 interface SsmlTagRange {
@@ -448,4 +346,4 @@ type SsmlCodeLensAction = {
 type SsmlCodeLensCallback = (action: SsmlCodeLensAction) => void;
 declare function registerSsmlCodeLens(monaco: Monaco, editor: MonacoEditor, onOpenPopover: SsmlCodeLensCallback): ReturnType<Monaco["languages"]["registerCodeLensProvider"]>;
 
-export { EDITOR_COPY, type EditorCopy, INLINE_BADGE_COPY, type InlineBadgeCopy, SSML_HOVER_COPY, SSML_INSERTIONS, type SelectionInfo, type SsmlCodeLensAction, type SsmlCodeLensCallback, SsmlEditor, type SsmlEditorButton, type SsmlEditorButtonVisibility, type SsmlEditorCustomInsertion, type SsmlEditorCustomInsertionCollection, type SsmlEditorCustomInsertionDefinition, type SsmlEditorEditMode, type SsmlEditorInsertionButton, type SsmlEditorInsertionDefinition, type SsmlEditorInsertionGroup, type SsmlEditorInsertionMode, type SsmlEditorInsertionOption, type SsmlEditorInsertionTemplate, type SsmlEditorLanguage, type SsmlEditorLineNumbers, type SsmlEditorLocale, type SsmlEditorLocalizedText, type SsmlEditorOptions, type SsmlEditorProps, type SsmlEditorRef, type SsmlEditorTheme, type SsmlEditorToolbarGroup, type SsmlEditorWordWrap, type SsmlHoverLocale, type SsmlHoverParameterCopy, type SsmlHoverTagCopy, type SsmlInsertionDefinition, type SsmlInsertionOption, type SsmlInsertionTemplate, type SsmlTagRange, VisualSsmlEditor, type VisualSsmlEditorProps, createSsmlEditorInsertionDefinition, registerSsmlCodeLens, updateTagAttribute };
+export { EDITOR_COPY, type EditorCopy, INLINE_BADGE_COPY, type InlineBadgeCopy, SSML_ELEMENT_COPY, SSML_HOVER_COPY, SSML_INSERTIONS, type SelectionInfo, type SsmlCodeLensAction, type SsmlCodeLensCallback, SsmlEditor, type SsmlEditorButton, type SsmlEditorButtonVisibility, type SsmlEditorCustomInsertion, type SsmlEditorCustomInsertionCollection, type SsmlEditorCustomInsertionDefinition, type SsmlEditorEditMode, type SsmlEditorInsertionButton, type SsmlEditorInsertionDefinition, type SsmlEditorInsertionGroup, type SsmlEditorInsertionMode, type SsmlEditorInsertionOption, type SsmlEditorInsertionTemplate, type SsmlEditorLanguage, type SsmlEditorLineNumbers, type SsmlEditorLocale, type SsmlEditorLocalizedText, type SsmlEditorOptions, type SsmlEditorProps, type SsmlEditorRef, type SsmlEditorTheme, type SsmlEditorToolbarGroup, type SsmlEditorWordWrap, type SsmlElementLocaleCopy, type SsmlHoverLocale, type SsmlHoverParameterCopy, type SsmlHoverTagCopy, type SsmlInsertionDefinition, type SsmlInsertionOption, type SsmlInsertionTemplate, type SsmlTagRange, type VisualInspectorRenderProps, type VisualInspectorRenderer, VisualSsmlEditor, type VisualSsmlEditorProps, type VisualVoiceCatalogEntry, type VoiceSelectorRenderProps, createSsmlEditorInsertionDefinition, registerSsmlCodeLens, updateTagAttribute };