ssml-builder-js 2.14.0 → 2.15.0

package/README.md

@@ -240,7 +240,7 @@ const diagnostics = validateAzureSsml(ssml, {
 });
 ```
 
-`audio`、`mstts:backgroundaudio`、`lexicon`、`mstts:voiceconversion` の URL は `urlValidator`（または `customUrlValidator`）へ渡せます。Promise を返す検証関数で DNS 解決後のプライベート IP 遮断などを実装できます。
+`audio`、`mstts:backgroundaudio`、`lexicon`、`mstts:voiceconversion` の URL は `urlValidator`（または `customUrlValidator`）へ渡せます。コールバックは `(url, context, signal)` を受け取り、Promise を返す検証関数で DNS 解決後のプライベート IP 遮断などを実装できます。検証キャッシュはタグ・属性・URL ごとに分離されます。
 
 `maxXmlDepth` は `<speak>` を深さ 1 として XML の過剰なネストを検出します。長文は `splitSsmlDocument` で `<p>`／`<s>` と親の `voice`、`prosody` コンテキストを保ったまま分割できます。
 
@@ -342,6 +342,7 @@ export function App() {
 - `customInsertions` / `additionalInsertions`: カスタム SSML 挿入定義。`customInsertions` は同じ ID の標準定義を置き換え、`additionalInsertions` は標準定義へ追加します
 - `customInspectors`: Visual Editor のタグ名ごとに Inspector を差し替えるレンダラー
 - `renderVoiceSelector`: 音声セレクターのカスタムレンダラー。`voiceCatalog` と `voiceLocale`、`voiceRegion`、`voiceStyle` で候補を絞り込めます。プレビュー音声にはバッジ情報も渡されます
+- `voiceModel`（または `model`）: 選択中の Azure 音声モデル。音声カタログの対応モデル、SSML タグ、スタイル、ロケールとの不整合を Visual Editor にリアルタイム表示します
 - `className` / `style`: エディター全体のクラス名とインラインスタイル
 - `toolbarClassName` / `toolbarStyle`: ツールバーのクラス名とインラインスタイル
 - `displayClassName` / `displayStyle`: 本文表示エリアのクラス名とインラインスタイル
@@ -708,7 +709,7 @@ const diagnostics = validateAzureSsml(ssml, {
 });
 ```
 
-URLs in `audio`, `mstts:backgroundaudio`, `lexicon`, and `mstts:voiceconversion` can be passed to `urlValidator` (or `customUrlValidator`). The callback may be asynchronous, making it suitable for host-side DNS/private-IP and SSRF policy checks.
+URLs in `audio`, `mstts:backgroundaudio`, `lexicon`, and `mstts:voiceconversion` can be passed to `urlValidator` (or `customUrlValidator`). The callback receives `(url, context, signal)` and may be asynchronous, making it suitable for host-side DNS/private-IP and SSRF policy checks. Validation cache entries are isolated by tag, attribute, and URL.
 
 The catalog is represented by `AzureVoiceDefinition` with `name`, `locale`, optional `secondaryLocales`, `styles`, `supportedTags`, `unsupportedTags`, `models`, `regions`, and `status`. Pass `voiceDefinitions` (or `voiceCatalog`) to supplement or override the built-in catalog with an external definition. A tag that violates `supportedTags` or `unsupportedTags` produces `azure-unsupported-tag-for-voice` with error severity. `customVoiceStyleMap` remains supported for backward compatibility and overrides styles for the named voice. Diagnostics distinguish an unregistered voice (`azure-unknown-voice`, controlled by `unknownVoicePolicy`), an unsupported style on a registered voice (`azure-unsupported-style`), and a locale mismatch (`azure-locale-mismatch`). The `<mstts:audioduration value="10s"/>` element accepts positive `ms` or `s` values and `hh:mm:ss[.fff]` clock values.
 
@@ -834,6 +835,7 @@ export function App() {
 - `customInsertions` / `additionalInsertions`: Custom SSML insertion definitions. `customInsertions` replaces a built-in definition with the same ID, while `additionalInsertions` adds definitions to the built-ins
 - `customInspectors`: Custom renderers keyed by element type or serialized tag name for the Visual Editor
 - `renderVoiceSelector`: Custom voice selector renderer. Supply `voiceCatalog` and optional `voiceLocale`, `voiceRegion`, or `voiceStyle` filters; preview status is included in each voice entry
+- `voiceModel` (or `model`): Selected Azure voice model. The Visual Editor reports live mismatches between the catalog's supported models, SSML tags, styles, and locale
 - `className` / `style`: A class name and inline styles for the editor container
 - `toolbarClassName` / `toolbarStyle`: A class name and inline styles for the toolbar
 - `displayClassName` / `displayStyle`: A class name and inline styles for the text display area
@@ -911,13 +913,13 @@ result.bookmarks; // { name, audioOffsetMs }[]
 
 長文を分割して合成する場合は `synthesizeSsmlChunks` または `AzureTtsClient.synthesizeChunks` を使います。音声バイナリを連結し、`boundaries`、`visemes`、`bookmarks` のオフセットを累積 `durationMs` 分だけ補正します。`synthesizeSsmlSafe(client, ssml, { validation })` は検証エラー時に Azure API を呼び出さず、`status: "validation-error"` / `"azure-api-error"` / `"success"` の結果を返します。
 
-v2.14.0 では `synthesizeSsmlChunksSafe(client, chunks, options)` が全チャンクを事前検証し、エラー時に `ChunkValidationError.chunkIndex` を返します。`onProgress` には `chunkIndex`、`originalTextRange`、`status`、`durationMs`、`error` が含まれます。`mergeAudioBuffers(buffers, format)` は PCM WAV のヘッダーを再構築し、MP3 の ID3 タグを除去して結合します。Ogg/WebM など安全に連結できない形式は `UnsupportedMergeFormatError` になります。同期イベントには `chunkIndex`、`sourceNodePath`、`originalTextRange`、`chunkAudioOffsetMs` が付与されます。
+v2.15.0 では `synthesizeSsmlChunksSafe(client, chunks, options)` が全チャンクを事前検証し、`outputFormat`、`signal`、`timeoutMs`、`sourceNodePath` を各合成へ伝播します。`mergeAudioBuffers(buffers, { format })` と `mergeSynthesisResults(results, { format })` は形式指定を必須とし、結合結果には `mimeType` が含まれます。Ogg/WebM などは `customMerger` で外部 Muxer に委譲できます。エラーは `validation-error`、`azure-api-error`、`merge-error`、`unsupported-format-error`、`cancelled`、`timeout` の判別可能な `kind` を持ちます。同期イベントは個別の `sourceNodePath` と `originalTextRange` にマッピングされ、URL 検証コールバックには `AbortSignal` が渡されます。
 
 `validateAzureSsml` の `urlValidation` オプションは URL の重複排除、キャッシュ、`concurrency`、`signal`、`timeoutMs` を制御します。
 
 For long documents, use `synthesizeSsmlChunks` or `AzureTtsClient.synthesizeChunks`; `onProgress` reports completed chunks while audio and synchronization offsets are merged. `synthesizeSsmlSafe(client, ssml, { validation })` validates before synthesis and returns a discriminated result without calling Azure when static validation fails.
 
-In v2.14.0, `synthesizeSsmlChunksSafe(client, chunks, options)` validates every chunk before contacting Azure and returns a `ChunkValidationError` with its `chunkIndex` when validation fails. `onProgress` events include `chunkIndex`, `originalTextRange`, `status`, `durationMs`, and `error`. `mergeAudioBuffers(buffers, format)` rebuilds PCM WAV headers and strips ID3 tags from MP3 streams; formats such as Ogg and WebM throw `UnsupportedMergeFormatError` because they require re-multiplexing. Synchronization events retain `chunkIndex`, `sourceNodePath`, `originalTextRange`, and `chunkAudioOffsetMs`.
+In v2.15.0, `synthesizeSsmlChunksSafe(client, chunks, options)` validates every chunk before contacting Azure and propagates `outputFormat`, `signal`, `timeoutMs`, and `sourceNodePath` to each synthesis. `mergeAudioBuffers(buffers, { format })` and `mergeSynthesisResults(results, { format })` require an explicit format and merged results expose `mimeType`. Ogg and WebM can be delegated to an external Muxer through `customMerger`. Errors have discriminated `kind` values: `validation-error`, `azure-api-error`, `merge-error`, `unsupported-format-error`, `cancelled`, and `timeout`. Synchronization events receive individual `sourceNodePath` and `originalTextRange` mappings, and URL validators receive an `AbortSignal`.
 
 The `urlValidation` option of `validateAzureSsml` provides URL deduplication, in-memory caching, bounded `concurrency`, `signal`, and `timeoutMs` controls.
 

package/dist/{chunk-UZSCXPC5.mjs → chunk-BDY2Q2JL.mjs}

@@ -1,7 +1,7 @@
 import {
   buildSsml,
   parseSsml
-} from "./chunk-QFIBPCO4.mjs";
+} from "./chunk-WXFLUCLR.mjs";
 import {
   __export
 } from "./chunk-6S5ODO6A.mjs";
@@ -3112,4 +3112,4 @@ export {
   findSsmlHoverTarget,
   formatSsmlHover
 };
-//# sourceMappingURL=chunk-UZSCXPC5.mjs.map
+//# sourceMappingURL=chunk-BDY2Q2JL.mjs.map

package/dist/{chunk-AQ55MOPU.mjs → chunk-FXUM45ZY.mjs}

@@ -931,6 +931,236 @@ function buildPartialSsml(textOrOptions, context) {
   return serializePartialSsml(textOrOptions.text, textOrOptions);
 }
 
+// packages/ssml-core/src/textNodes.ts
+function decodeXmlText(value) {
+  return value.replace(/&(?:amp|apos|gt|lt|quot);|&#(?:x[\da-f]+|\d+);/gi, (entity) => {
+    if (entity === "&") return "&";
+    if (entity === "'") return "'";
+    if (entity === ">") return ">";
+    if (entity === "&lt;") return "<";
+    if (entity === "&quot;") return '"';
+    const hexadecimal = entity.toLowerCase().startsWith("&#x");
+    const digits = entity.slice(hexadecimal ? 3 : 2, -1);
+    return String.fromCodePoint(Number.parseInt(digits, hexadecimal ? 16 : 10));
+  });
+}
+function encodeXmlText(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function decodeXmlAttribute(value) {
+  return decodeXmlText(value);
+}
+function findTagEnd(source, start) {
+  let quote = "";
+  for (let index = start; index < source.length; index += 1) {
+    const character = source[index];
+    if (quote) {
+      if (character === quote) quote = "";
+    } else if (character === '"' || character === "'") {
+      quote = character;
+    } else if (character === ">") {
+      return index;
+    }
+  }
+  return source.length - 1;
+}
+function readTagName(tag) {
+  const match = /^<\s*([A-Za-z_][A-Za-z0-9_.:-]*)/.exec(tag);
+  return match?.[1];
+}
+function readTagAttributes(tag, name) {
+  const attributes = {};
+  const nameStart = tag.indexOf(name);
+  const attributeSource = tag.slice(nameStart + name.length, tag.length - 1).replace(/\/\s*$/, "");
+  const attributePattern = /([A-Za-z_][A-Za-z0-9_.:-]*)\s*=\s*(["'])([\s\S]*?)\2/g;
+  for (const match of attributeSource.matchAll(attributePattern)) {
+    attributes[match[1].toLowerCase()] = decodeXmlAttribute(match[3]);
+  }
+  return attributes;
+}
+function collectTextNodes(source) {
+  const nodes = [];
+  const elements = [];
+  let index = 0;
+  const addText = (start, end, rawText, sourceStart = start, sourceEnd = end) => {
+    if (!rawText) return;
+    const path = elements.map((element) => element.name);
+    const parent = elements[elements.length - 1];
+    nodes.push({
+      context: {
+        ancestorTags: path.slice(0, -1),
+        parentAttributes: { ...parent?.attributes ?? {} },
+        parentTag: parent?.name ?? "",
+        path
+      },
+      decodedText: decodeXmlText(rawText),
+      end,
+      sourceEnd,
+      sourceStart,
+      start
+    });
+  };
+  while (index < source.length) {
+    if (source[index] !== "<") {
+      const nextTag = source.indexOf("<", index);
+      const end2 = nextTag === -1 ? source.length : nextTag;
+      addText(index, end2, source.slice(index, end2));
+      index = end2;
+      continue;
+    }
+    if (source.startsWith("<!--", index)) {
+      const end2 = source.indexOf("-->", index + 4);
+      index = end2 === -1 ? source.length : end2 + 3;
+      continue;
+    }
+    if (source.startsWith("<![CDATA[", index)) {
+      const contentStart = index + 9;
+      const end2 = source.indexOf("]]>", contentStart);
+      const contentEnd = end2 === -1 ? source.length : end2;
+      addText(
+        contentStart,
+        contentEnd,
+        source.slice(contentStart, contentEnd),
+        index,
+        end2 === -1 ? source.length : end2 + 3
+      );
+      index = end2 === -1 ? source.length : end2 + 3;
+      continue;
+    }
+    if (source.startsWith("<?", index)) {
+      const end2 = source.indexOf("?>", index + 2);
+      index = end2 === -1 ? source.length : end2 + 2;
+      continue;
+    }
+    if (source.startsWith("</", index)) {
+      const end2 = findTagEnd(source, index + 2);
+      elements.pop();
+      index = end2 + 1;
+      continue;
+    }
+    const end = findTagEnd(source, index + 1);
+    const tag = source.slice(index, end + 1);
+    const name = readTagName(tag);
+    if (name && !/\/\s*>$/.test(tag)) elements.push({ attributes: readTagAttributes(tag, name), name });
+    index = end + 1;
+  }
+  return nodes;
+}
+function collectSourceMap(source) {
+  const segments = [];
+  const markers = [];
+  const elements = [];
+  let textOffset = 0;
+  let index = 0;
+  const textParts = [];
+  const addText = (value) => {
+    if (!value) return;
+    const parent = elements[elements.length - 1];
+    if (parent) parent.nextChildIndex += 1;
+    const sourceNodePath = parent?.path ?? ["speak"];
+    const start = textOffset;
+    textOffset += value.length;
+    textParts.push(value);
+    segments.push({ text: value, range: { start, end: textOffset }, sourceNodePath: [...sourceNodePath] });
+  };
+  while (index < source.length) {
+    if (source[index] !== "<") {
+      const end2 = source.indexOf("<", index);
+      const textEnd = end2 === -1 ? source.length : end2;
+      addText(decodeXmlText(source.slice(index, textEnd)));
+      index = textEnd;
+      continue;
+    }
+    if (source.startsWith("<!--", index)) {
+      const end2 = source.indexOf("-->", index + 4);
+      index = end2 === -1 ? source.length : end2 + 3;
+      continue;
+    }
+    if (source.startsWith("<![CDATA[", index)) {
+      const contentStart = index + 9;
+      const end2 = source.indexOf("]]>", contentStart);
+      const contentEnd = end2 === -1 ? source.length : end2;
+      addText(source.slice(contentStart, contentEnd));
+      index = end2 === -1 ? source.length : end2 + 3;
+      continue;
+    }
+    if (source.startsWith("<?", index)) {
+      const end2 = source.indexOf("?>", index + 2);
+      index = end2 === -1 ? source.length : end2 + 2;
+      continue;
+    }
+    const end = findTagEnd(source, index + 1);
+    const rawTag = source.slice(index, end + 1);
+    if (rawTag.startsWith("</")) {
+      elements.pop();
+      index = end + 1;
+      continue;
+    }
+    const name = readTagName(rawTag);
+    if (!name) {
+      index = end + 1;
+      continue;
+    }
+    const parent = elements[elements.length - 1];
+    const childIndex = parent?.nextChildIndex ?? 0;
+    if (parent) parent.nextChildIndex += 1;
+    const path = parent ? [...parent.path, `${name}[${childIndex}]`] : [name];
+    const attributes = readTagAttributes(rawTag, name);
+    const normalizedName = name.toLowerCase();
+    if (normalizedName === "mark" || normalizedName === "bookmark") {
+      const markerName = attributes[normalizedName === "mark" ? "name" : "mark"];
+      if (markerName) {
+        markers.push({
+          kind: normalizedName,
+          name: markerName,
+          originalTextRange: { start: textOffset, end: textOffset },
+          sourceNodePath: [...path]
+        });
+      }
+    }
+    if (!/\/\s*>$/.test(rawTag)) elements.push({ name, path, nextChildIndex: 0 });
+    index = end + 1;
+  }
+  return { text: textParts.join(""), segments, markers };
+}
+function getSsmlSourceMap(ssml) {
+  parseSsml(ssml);
+  return collectSourceMap(ssml);
+}
+function extractSsmlText(ssml) {
+  parseSsml(ssml);
+  return collectTextNodes(ssml).map((node) => node.decodedText);
+}
+async function mapSsmlTextNodes(ssml, transform, options = {}) {
+  parseSsml(ssml);
+  const nodes = collectTextNodes(ssml);
+  const skipTags = new Set((options.skipTags ?? ["phoneme", "say-as", "sub"]).map((tag) => tag.toLowerCase()));
+  const replacements = await Promise.all(
+    nodes.map(async (node) => {
+      const context = {
+        ancestorTags: [...node.context.ancestorTags],
+        parentAttributes: { ...node.context.parentAttributes },
+        parentTag: node.context.parentTag,
+        path: [...node.context.path]
+      };
+      const shouldTransform = !skipTags.has(context.parentTag.toLowerCase()) && (options.filter?.(context) ?? true);
+      if (!shouldTransform) return ssml.slice(node.sourceStart, node.sourceEnd);
+      const transformed = await transform(node.decodedText, context);
+      if (typeof transformed !== "string") {
+        throw new TypeError("SSML text node transform must return a string");
+      }
+      return transformed === node.decodedText ? ssml.slice(node.sourceStart, node.sourceEnd) : encodeXmlText(transformed);
+    })
+  );
+  let result = "";
+  let cursor = 0;
+  nodes.forEach((node, nodeIndex) => {
+    result += ssml.slice(cursor, node.sourceStart) + replacements[nodeIndex];
+    cursor = node.sourceEnd;
+  });
+  return result + ssml.slice(cursor);
+}
+
 // packages/ssml-core/src/split.ts
 var DEFAULT_MAX_LENGTH = 1e4;
 function cloneElement(element, children) {
@@ -1062,7 +1292,7 @@ function findSourceNodePath(nodes, targetOffset) {
   });
   return foundPath ?? firstPath;
 }
-function createChunk(document, nodes, chunkIndex, textStart, backgroundAudio, replicateBackgroundAudio) {
+function createChunk(document, nodes, chunkIndex, textStart, backgroundAudio, replicateBackgroundAudio, sourceMap, includeEndMarkers) {
   const chunkNodes = backgroundAudio && (replicateBackgroundAudio || chunkIndex === 0) ? [backgroundAudio, ...nodes] : nodes;
   const text = nodes.map(textFromNode).join("");
   const marks = [];
@@ -1078,7 +1308,23 @@ function createChunk(document, nodes, chunkIndex, textStart, backgroundAudio, re
     hasBackgroundAudio: chunkNodes.some(
       (node) => typeof node !== "string" && node.type !== "text" && node.type === "mstts:backgroundaudio"
     ),
-    sourceNodePath: findSourceNodePath(document.children ?? [], textStart)
+    sourceNodePath: findSourceNodePath(document.children ?? [], textStart),
+    sourceTextSegments: sourceMap.segments.filter(({ range }) => range.end > textStart && range.start < textStart + text.length).map((segment) => {
+      const start = Math.max(segment.range.start, textStart);
+      const end = Math.min(segment.range.end, textStart + text.length);
+      return {
+        text: segment.text.slice(start - segment.range.start, end - segment.range.start),
+        range: { start, end },
+        sourceNodePath: [...segment.sourceNodePath]
+      };
+    }),
+    sourceMarkers: sourceMap.markers.filter(
+      ({ originalTextRange }) => originalTextRange.start >= textStart && (originalTextRange.start < textStart + text.length || includeEndMarkers && originalTextRange.start === textStart + text.length)
+    ).map((marker) => ({
+      ...marker,
+      originalTextRange: { ...marker.originalTextRange },
+      sourceNodePath: [...marker.sourceNodePath]
+    }))
   };
 }
 function splitSsmlDocument(ssml, maxLength = DEFAULT_MAX_LENGTH, options = {}) {
@@ -1088,11 +1334,12 @@ function splitSsmlDocument(ssml, maxLength = DEFAULT_MAX_LENGTH, options = {}) {
     throw new RangeError("maxLength must be a positive integer");
   }
   const document = parseSsml(ssml);
+  const sourceMap = getSsmlSourceMap(ssml);
   const backgroundAudio = (document.children ?? []).find(
     (node) => typeof node !== "string" && node.type !== "text" && node.type === "mstts:backgroundaudio"
   );
   if (ssml.length <= resolvedMaxLength) {
-    return [createChunk(document, document.children ?? [], 0, 0, backgroundAudio, true)];
+    return [createChunk(document, document.children ?? [], 0, 0, backgroundAudio, true, sourceMap, true)];
   }
   const contentChildren = (document.children ?? []).filter((node) => node !== backgroundAudio);
   const plainDocumentLength = documentWithChildren(document, []).length;
@@ -1116,7 +1363,16 @@ function splitSsmlDocument(ssml, maxLength = DEFAULT_MAX_LENGTH, options = {}) {
   }
   if (group.length > 0) chunks.push(group);
   if (chunks.length === 0) {
-    const result = createChunk(document, [], 0, 0, backgroundAudio, resolvedOptions.replicateBackgroundAudio ?? false);
+    const result = createChunk(
+      document,
+      [],
+      0,
+      0,
+      backgroundAudio,
+      resolvedOptions.replicateBackgroundAudio ?? false,
+      sourceMap,
+      true
+    );
     if (result.ssml.length > resolvedMaxLength) {
       throw new RangeError("maxLength is too small to contain the SSML document wrapper");
     }
@@ -1130,7 +1386,9 @@ function splitSsmlDocument(ssml, maxLength = DEFAULT_MAX_LENGTH, options = {}) {
       chunkIndex,
       textStart,
       backgroundAudio,
-      resolvedOptions.replicateBackgroundAudio ?? false
+      resolvedOptions.replicateBackgroundAudio ?? false,
+      sourceMap,
+      chunkIndex === chunks.length - 1
     );
     textStart = result.originalTextRange.end;
     return result;
@@ -1153,155 +1411,6 @@ function validateSsml(xmlString) {
   }
 }
 
-// packages/ssml-core/src/textNodes.ts
-function decodeXmlText(value) {
-  return value.replace(/&(?:amp|apos|gt|lt|quot);|&#(?:x[\da-f]+|\d+);/gi, (entity) => {
-    if (entity === "&amp;") return "&";
-    if (entity === "&apos;") return "'";
-    if (entity === "&gt;") return ">";
-    if (entity === "&lt;") return "<";
-    if (entity === "&quot;") return '"';
-    const hexadecimal = entity.toLowerCase().startsWith("&#x");
-    const digits = entity.slice(hexadecimal ? 3 : 2, -1);
-    return String.fromCodePoint(Number.parseInt(digits, hexadecimal ? 16 : 10));
-  });
-}
-function encodeXmlText(value) {
-  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
-function decodeXmlAttribute(value) {
-  return decodeXmlText(value);
-}
-function findTagEnd(source, start) {
-  let quote = "";
-  for (let index = start; index < source.length; index += 1) {
-    const character = source[index];
-    if (quote) {
-      if (character === quote) quote = "";
-    } else if (character === '"' || character === "'") {
-      quote = character;
-    } else if (character === ">") {
-      return index;
-    }
-  }
-  return source.length - 1;
-}
-function readTagName(tag) {
-  const match = /^<\s*([A-Za-z_][A-Za-z0-9_.:-]*)/.exec(tag);
-  return match?.[1];
-}
-function readTagAttributes(tag, name) {
-  const attributes = {};
-  const nameStart = tag.indexOf(name);
-  const attributeSource = tag.slice(nameStart + name.length, tag.length - 1).replace(/\/\s*$/, "");
-  const attributePattern = /([A-Za-z_][A-Za-z0-9_.:-]*)\s*=\s*(["'])([\s\S]*?)\2/g;
-  for (const match of attributeSource.matchAll(attributePattern)) {
-    attributes[match[1].toLowerCase()] = decodeXmlAttribute(match[3]);
-  }
-  return attributes;
-}
-function collectTextNodes(source) {
-  const nodes = [];
-  const elements = [];
-  let index = 0;
-  const addText = (start, end, rawText, sourceStart = start, sourceEnd = end) => {
-    if (!rawText) return;
-    const path = elements.map((element) => element.name);
-    const parent = elements[elements.length - 1];
-    nodes.push({
-      context: {
-        ancestorTags: path.slice(0, -1),
-        parentAttributes: { ...parent?.attributes ?? {} },
-        parentTag: parent?.name ?? "",
-        path
-      },
-      decodedText: decodeXmlText(rawText),
-      end,
-      sourceEnd,
-      sourceStart,
-      start
-    });
-  };
-  while (index < source.length) {
-    if (source[index] !== "<") {
-      const nextTag = source.indexOf("<", index);
-      const end2 = nextTag === -1 ? source.length : nextTag;
-      addText(index, end2, source.slice(index, end2));
-      index = end2;
-      continue;
-    }
-    if (source.startsWith("<!--", index)) {
-      const end2 = source.indexOf("-->", index + 4);
-      index = end2 === -1 ? source.length : end2 + 3;
-      continue;
-    }
-    if (source.startsWith("<![CDATA[", index)) {
-      const contentStart = index + 9;
-      const end2 = source.indexOf("]]>", contentStart);
-      const contentEnd = end2 === -1 ? source.length : end2;
-      addText(
-        contentStart,
-        contentEnd,
-        source.slice(contentStart, contentEnd),
-        index,
-        end2 === -1 ? source.length : end2 + 3
-      );
-      index = end2 === -1 ? source.length : end2 + 3;
-      continue;
-    }
-    if (source.startsWith("<?", index)) {
-      const end2 = source.indexOf("?>", index + 2);
-      index = end2 === -1 ? source.length : end2 + 2;
-      continue;
-    }
-    if (source.startsWith("</", index)) {
-      const end2 = findTagEnd(source, index + 2);
-      elements.pop();
-      index = end2 + 1;
-      continue;
-    }
-    const end = findTagEnd(source, index + 1);
-    const tag = source.slice(index, end + 1);
-    const name = readTagName(tag);
-    if (name && !/\/\s*>$/.test(tag)) elements.push({ attributes: readTagAttributes(tag, name), name });
-    index = end + 1;
-  }
-  return nodes;
-}
-function extractSsmlText(ssml) {
-  parseSsml(ssml);
-  return collectTextNodes(ssml).map((node) => node.decodedText);
-}
-async function mapSsmlTextNodes(ssml, transform, options = {}) {
-  parseSsml(ssml);
-  const nodes = collectTextNodes(ssml);
-  const skipTags = new Set((options.skipTags ?? ["phoneme", "say-as", "sub"]).map((tag) => tag.toLowerCase()));
-  const replacements = await Promise.all(
-    nodes.map(async (node) => {
-      const context = {
-        ancestorTags: [...node.context.ancestorTags],
-        parentAttributes: { ...node.context.parentAttributes },
-        parentTag: node.context.parentTag,
-        path: [...node.context.path]
-      };
-      const shouldTransform = !skipTags.has(context.parentTag.toLowerCase()) && (options.filter?.(context) ?? true);
-      if (!shouldTransform) return ssml.slice(node.sourceStart, node.sourceEnd);
-      const transformed = await transform(node.decodedText, context);
-      if (typeof transformed !== "string") {
-        throw new TypeError("SSML text node transform must return a string");
-      }
-      return transformed === node.decodedText ? ssml.slice(node.sourceStart, node.sourceEnd) : encodeXmlText(transformed);
-    })
-  );
-  let result = "";
-  let cursor = 0;
-  nodes.forEach((node, nodeIndex) => {
-    result += ssml.slice(cursor, node.sourceStart) + replacements[nodeIndex];
-    cursor = node.sourceEnd;
-  });
-  return result + ssml.slice(cursor);
-}
-
 // packages/ssml-core/src/migration.ts
 var DEFAULT_TRANSLATION_SKIP_TAGS = ["phoneme", "say-as", "sayAs", "sub"];
 function elementName2(element) {
@@ -1722,34 +1831,51 @@ function createAzureUrlValidatorRunner(validator, options = {}) {
   const inFlight = /* @__PURE__ */ new Map();
   const waiters = [];
   let active = 0;
-  const acquire = async () => {
+  const configuredSignal = options.signal ?? new AbortController().signal;
+  const acquire = async (signal) => {
+    if (signal.aborted) throw new Error("URL validation was aborted.");
     if (active < concurrency) {
       active += 1;
       return;
     }
-    await new Promise((resolve) => waiters.push(resolve));
+    await new Promise((resolve, reject) => {
+      let waiter;
+      const abortHandler = () => {
+        const index = waiters.indexOf(waiter);
+        if (index >= 0) waiters.splice(index, 1);
+        signal.removeEventListener("abort", abortHandler);
+        reject(new Error("URL validation was aborted."));
+      };
+      signal.addEventListener("abort", abortHandler, { once: true });
+      waiter = () => {
+        signal.removeEventListener("abort", abortHandler);
+        resolve();
+      };
+      waiters.push(waiter);
+    });
     active += 1;
   };
   const release = () => {
     active -= 1;
     waiters.shift()?.();
   };
-  const check = async (url, context) => {
-    if (options.signal?.aborted) throw new Error("URL validation was aborted.");
-    const cached = cache.get(url);
+  const check = async (url, context, signal = configuredSignal) => {
+    if (signal.aborted) throw new Error("URL validation was aborted.");
+    const key = `${context.tag}:${context.attribute}:${url}`;
+    const cached = cache.get(key);
     if (cached !== void 0) return cached;
-    const existing = inFlight.get(url);
+    const existing = inFlight.get(key);
     if (existing) return existing;
     const promise = (async () => {
-      await acquire();
+      await acquire(signal);
       try {
-        if (options.signal?.aborted) throw new Error("URL validation was aborted.");
-        const validation = Promise.resolve(validator(url, context));
+        if (signal.aborted) throw new Error("URL validation was aborted.");
+        const validation = Promise.resolve(validator(url, context, signal));
         let timer;
         let abortHandler;
         const cancellation = new Promise((_resolve, reject) => {
           abortHandler = () => reject(new Error("URL validation was aborted."));
-          options.signal?.addEventListener("abort", abortHandler, { once: true });
+          signal.addEventListener("abort", abortHandler, { once: true });
           if (options.timeoutMs !== void 0 && options.timeoutMs > 0) {
             timer = setTimeout(
               () => reject(new Error(`URL validation timed out after ${options.timeoutMs} ms.`)),
@@ -1759,24 +1885,24 @@ function createAzureUrlValidatorRunner(validator, options = {}) {
         });
         try {
           const result = await (timer || abortHandler ? Promise.race([validation, cancellation]) : validation);
-          cache.set(url, result);
+          cache.set(key, result);
           return result;
         } finally {
           if (timer) clearTimeout(timer);
-          if (abortHandler) options.signal?.removeEventListener("abort", abortHandler);
+          if (abortHandler) signal.removeEventListener("abort", abortHandler);
         }
       } finally {
         release();
       }
     })();
-    inFlight.set(url, promise);
+    inFlight.set(key, promise);
     try {
       return await promise;
     } finally {
-      inFlight.delete(url);
+      inFlight.delete(key);
     }
   };
-  return (url, context) => check(url, context);
+  return (url, context, signal) => check(url, context, signal ?? configuredSignal);
 }
 var ALLOWED_BREAK_STRENGTHS = /* @__PURE__ */ new Set(["none", "x-weak", "weak", "medium", "strong", "x-strong"]);
 var ALLOWED_SAY_AS = /* @__PURE__ */ new Set([
@@ -2432,6 +2558,7 @@ function validateAzureSsml(ssml, options = {}) {
     ...options.urlValidatorSignal ? { signal: options.urlValidatorSignal } : {},
     ...options.urlValidatorCache ? { cache: options.urlValidatorCache } : {}
   });
+  const validationSignal = options.urlValidatorSignal ?? options.urlValidation?.signal ?? new AbortController().signal;
   let tokens;
   try {
     tokens = tokenizeElements(ssml);
@@ -2441,7 +2568,11 @@ function validateAzureSsml(ssml, options = {}) {
   const checks = tokens.flatMap(
     (token) => urlAttributes(token).map(async ({ attribute, value }) => {
       try {
-        const result = await boundedValidator(value, { tag: token.name, attribute });
+        const result = await boundedValidator(
+          value,
+          { tag: token.name, attribute, ...options.sourceNodePath ? { sourceNodePath: options.sourceNodePath } : {} },
+          validationSignal
+        );
         const valid = typeof result === "boolean" ? result : result.valid;
         if (!valid) {
           const reason = typeof result === "boolean" ? void 0 : result.reason;
@@ -2487,10 +2618,11 @@ export {
   buildSsml,
   parseSsml,
   buildPartialSsml,
-  splitSsmlDocument,
-  validateSsml,
+  getSsmlSourceMap,
   extractSsmlText,
   mapSsmlTextNodes,
+  splitSsmlDocument,
+  validateSsml,
   extractSsmlTranslatableText,
   fromPlainTextToSsml,
   validateSsmlStructureIntegrity,
@@ -2502,4 +2634,4 @@ export {
   getAzureVoiceCatalogMetadata,
   getBuiltInVoiceCatalogMetadata
 };
-//# sourceMappingURL=chunk-AQ55MOPU.mjs.map
+//# sourceMappingURL=chunk-FXUM45ZY.mjs.map