@ssml-builder-js/ssml-editor-react 2.14.0 → 2.15.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @ssml-builder-js/ssml-editor-react
 
+## 2.15.0
+
+### Minor Changes
+
+- Add strict audio merge formats, discriminated synthesis errors, per-event source mappings, abortable URL validation, external audio muxers, and live Visual Editor voice capability warnings.
+
+### Patch Changes
+
+- Updated dependencies
+  - @ssml-builder-js/ssml-core@2.15.0
+
 ## 2.14.0
 
 ### Minor Changes

package/dist/index.d.mts

@@ -82,6 +82,7 @@ interface VisualVoiceCatalogEntry {
     styles?: readonly string[];
     supportedTags?: readonly string[];
     unsupportedTags?: readonly string[];
+    models?: readonly string[];
     preview?: boolean;
     status?: "ga" | "preview" | "deprecated";
 }
@@ -114,8 +115,12 @@ interface VisualSsmlEditorProps {
     voiceLocale?: string;
     voiceRegion?: string;
     voiceStyle?: string;
+    /** Selected Azure voice model used for live capability validation. */
+    voiceModel?: string;
+    /** Alias for voiceModel. */
+    model?: string;
 }
-declare function VisualSsmlEditor({ document, readOnly, onChange, onPreviewSelection, locale, customInspectors, renderVoiceSelector, voiceCatalog, voiceLocale, voiceRegion, voiceStyle, }: VisualSsmlEditorProps): ReactElement;
+declare function VisualSsmlEditor({ document, readOnly, onChange, onPreviewSelection, locale, customInspectors, renderVoiceSelector, voiceCatalog, voiceLocale, voiceRegion, voiceStyle, voiceModel, model, }: VisualSsmlEditorProps): ReactElement;
 
 type SsmlEditorInsertionMode = "insert" | "wrap";
 interface SsmlEditorInsertionOption {
@@ -301,6 +306,10 @@ interface SsmlEditorProps {
     voiceRegion?: string;
     /** Optional style filter for the visual voice selector. */
     voiceStyle?: string;
+    /** Selected Azure voice model used for live capability validation. */
+    voiceModel?: string;
+    /** Alias for voiceModel. */
+    model?: string;
     /** Candidate style values shown by the built-in emotion insertion. */
     emotionStyles?: readonly string[];
     /** Class name applied to the editor container. */

package/dist/index.d.ts

@@ -82,6 +82,7 @@ interface VisualVoiceCatalogEntry {
     styles?: readonly string[];
     supportedTags?: readonly string[];
     unsupportedTags?: readonly string[];
+    models?: readonly string[];
     preview?: boolean;
     status?: "ga" | "preview" | "deprecated";
 }
@@ -114,8 +115,12 @@ interface VisualSsmlEditorProps {
     voiceLocale?: string;
     voiceRegion?: string;
     voiceStyle?: string;
+    /** Selected Azure voice model used for live capability validation. */
+    voiceModel?: string;
+    /** Alias for voiceModel. */
+    model?: string;
 }
-declare function VisualSsmlEditor({ document, readOnly, onChange, onPreviewSelection, locale, customInspectors, renderVoiceSelector, voiceCatalog, voiceLocale, voiceRegion, voiceStyle, }: VisualSsmlEditorProps): ReactElement;
+declare function VisualSsmlEditor({ document, readOnly, onChange, onPreviewSelection, locale, customInspectors, renderVoiceSelector, voiceCatalog, voiceLocale, voiceRegion, voiceStyle, voiceModel, model, }: VisualSsmlEditorProps): ReactElement;
 
 type SsmlEditorInsertionMode = "insert" | "wrap";
 interface SsmlEditorInsertionOption {
@@ -301,6 +306,10 @@ interface SsmlEditorProps {
     voiceRegion?: string;
     /** Optional style filter for the visual voice selector. */
     voiceStyle?: string;
+    /** Selected Azure voice model used for live capability validation. */
+    voiceModel?: string;
+    /** Alias for voiceModel. */
+    model?: string;
     /** Candidate style values shown by the built-in emotion insertion. */
     emotionStyles?: readonly string[];
     /** Class name applied to the editor container. */

package/dist/index.js

@@ -5074,6 +5074,40 @@ function VoiceCapabilityMatrix({
     ] })
   ] });
 }
+function diagnosticMatchesElement(diagnostic, element) {
+  const name = elementLabel(element).toLowerCase().replace("expressas", "mstts:express-as");
+  if (diagnostic.code === "azure-unsupported-style") return name === "mstts:express-as" || name === "express-as";
+  if (diagnostic.code === "azure-unsupported-tag-for-voice") {
+    return diagnostic.message.toLowerCase().includes(`<${name}>`) || diagnostic.message.toLowerCase().includes(`<${name.replace("mstts:", "")}>`);
+  }
+  if (diagnostic.code === "azure-locale-mismatch" || diagnostic.code === "azure-unsupported-model-for-voice")
+    return name === "voice" || name === "mstts:turn";
+  return false;
+}
+function elementWarnings(diagnostics, element) {
+  return diagnostics.filter((diagnostic) => diagnosticMatchesElement(diagnostic, element));
+}
+function fieldWarnings(diagnostics, element, field) {
+  return elementWarnings(diagnostics, element).filter((diagnostic) => {
+    if (diagnostic.code === "azure-unsupported-style") return field.key === "style";
+    return field.key === "name" || field.key === "voice";
+  });
+}
+function WarningBadge({ messages }) {
+  if (messages.length === 0) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+    "span",
+    {
+      role: "status",
+      "aria-label": messages.map((message) => message.message).join(" "),
+      title: messages.map((message) => message.message).join(" "),
+      "data-ssml-warning-badge": "",
+      "data-testid": "ssml-editor-warning-badge",
+      className: "ssml-editor-warning-badge",
+      children: "\u26A0"
+    }
+  );
+}
 function DefaultVoiceSelector({
   value,
   voices,
@@ -5114,7 +5148,8 @@ function VisualElementInspector({
   voiceCatalog,
   voiceLocale,
   voiceRegion,
-  voiceStyle
+  voiceStyle,
+  diagnostics
 }) {
   if (customInspector) {
     return /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(import_jsx_runtime6.Fragment, { children: customInspector({ document: document2, element, path, readOnly, onChange: commit, locale }) });
@@ -5126,7 +5161,11 @@ function VisualElementInspector({
   );
   const renderSelector = renderVoiceSelector ?? DefaultVoiceSelector;
   return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("fieldset", { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("legend", { children: `<${elementLabel(element)}>` }),
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("legend", { children: [
+      `<${elementLabel(element)}>`,
+      " ",
+      /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(WarningBadge, { messages: elementWarnings(diagnostics, element) })
+    ] }),
     fields.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("p", { children: "This element is preserved in the visual tree. Edit its attributes in Code mode." }) : fields.map((field) => {
       const value = element[field.key];
       const inputValue = value === void 0 ? "" : String(value);
@@ -5166,6 +5205,7 @@ function VisualElementInspector({
           url: "\u97F3\u58F0\u5909\u63DB URL",
           profile: "\u30D7\u30ED\u30D5\u30A1\u30A4\u30EB"
         }[field.key] ?? field.label : field.label,
+        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(WarningBadge, { messages: fieldWarnings(diagnostics, element, field) }),
         field.key === "name" && elementLabel(element) === "voice" && voiceCatalog ? renderSelector({
           value: inputValue,
           voices: availableVoices,
@@ -5246,20 +5286,25 @@ function TreeNode({
   node,
   path,
   selectedPath,
-  onSelect
+  onSelect,
+  getWarnings
 }) {
   if (!isElement(node)) return null;
   const name = elementLabel(node);
   const isSelected = selectedPath?.join(".") === path.join(".");
   return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("li", { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("button", { type: "button", "aria-current": isSelected ? "true" : void 0, onClick: () => onSelect(path), children: `<${name}>` }),
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("button", { type: "button", "aria-current": isSelected ? "true" : void 0, onClick: () => onSelect(path), children: [
+      `<${name}>`,
+      /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(WarningBadge, { messages: getWarnings(node) })
+    ] }),
     (node.children ?? []).length > 0 && /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("ul", { children: node.children?.map((child, index) => /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
       TreeNode,
       {
         node: child,
         path: [...path, index],
         selectedPath,
-        onSelect
+        onSelect,
+        getWarnings
       },
       `${path.join(".")}/${isElement(child) ? elementLabel(child) : JSON.stringify(child)}`
     )) })
@@ -5276,7 +5321,9 @@ function VisualSsmlEditor({
   voiceCatalog,
   voiceLocale,
   voiceRegion,
-  voiceStyle
+  voiceStyle,
+  voiceModel,
+  model
 }) {
   const [selectedPath, setSelectedPath] = (0, import_react3.useState)(null);
   const [selection, setSelection] = (0, import_react3.useState)({ start: 0, end: 0 });
@@ -5284,7 +5331,27 @@ function VisualSsmlEditor({
   const selectedLeaf = textLeaves.find((leaf) => leaf.path.join(".") === selectedPath?.join(".")) ?? textLeaves[0];
   const selectedElement = selectedPath ? getNodeAtPath(document2.children ?? [], selectedPath) : void 0;
   const selectedCustomInspector = selectedElement && isElement(selectedElement) ? customInspectors?.[elementLabel(selectedElement)] ?? customInspectors?.[selectedElement.type] : void 0;
-  const diagnostics = (0, import_react3.useMemo)(() => (0, import_ssml_core4.validateAzureSsml)((0, import_ssml_core4.buildSsml)(document2)), [document2]);
+  const validationOptions = (0, import_react3.useMemo)(
+    () => ({
+      model: voiceModel ?? model,
+      customVoiceDefinitions: voiceCatalog?.map((voice) => ({
+        name: voice.name,
+        locale: voice.locale,
+        regions: voice.regions ?? (voice.region ? [voice.region] : void 0),
+        styles: voice.styles,
+        supportedTags: voice.supportedTags,
+        unsupportedTags: voice.unsupportedTags,
+        models: voice.models,
+        status: voice.status ?? (voice.preview ? "preview" : "ga")
+      }))
+    }),
+    [model, voiceCatalog, voiceModel]
+  );
+  const diagnostics = (0, import_react3.useMemo)(
+    () => (0, import_ssml_core4.validateAzureSsml)((0, import_ssml_core4.buildSsml)(document2), validationOptions),
+    [document2, validationOptions]
+  );
+  const getWarnings = (element) => elementWarnings(diagnostics, element);
   const commit = (nextDocument) => onChange?.(nextDocument);
   const applyWrapper = (tag, attributes) => {
     if (readOnly || !selectedLeaf) return;
@@ -5313,7 +5380,8 @@ function VisualSsmlEditor({
             node,
             path: [index],
             selectedPath,
-            onSelect: setSelectedPath
+            onSelect: setSelectedPath,
+            getWarnings
           },
           isElement(node) ? elementLabel(node) : JSON.stringify(node)
         )) })
@@ -5341,6 +5409,7 @@ function VisualSsmlEditor({
         /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("legend", { children: localizedElementLabel(selectedElement, locale) }),
         /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("label", { htmlFor: "ssml-visual-turn-voice", children: [
           locale === "ja" ? "\u97F3\u58F0" : "Voice",
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(WarningBadge, { messages: elementWarnings(diagnostics, selectedElement) }),
           voiceCatalog ? (renderVoiceSelector ?? DefaultVoiceSelector)({
             value: selectedElement.voice ?? "",
             voices: filteredVoices(voiceCatalog, voiceLocale, voiceRegion, voiceStyle),
@@ -5446,7 +5515,8 @@ function VisualSsmlEditor({
           voiceCatalog,
           voiceLocale,
           voiceRegion,
-          voiceStyle
+          voiceStyle,
+          diagnostics
         }
       ) : selectedLeaf ? /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(import_jsx_runtime6.Fragment, { children: [
         /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("label", { children: [
@@ -6091,6 +6161,8 @@ var SsmlEditor = (0, import_react4.forwardRef)(function SsmlEditor2({
   voiceLocale,
   voiceRegion,
   voiceStyle,
+  voiceModel,
+  model,
   emotionStyles,
   className,
   style,
@@ -6539,7 +6611,9 @@ var SsmlEditor = (0, import_react4.forwardRef)(function SsmlEditor2({
               voiceCatalog,
               voiceLocale,
               voiceRegion,
-              voiceStyle
+              voiceStyle,
+              voiceModel,
+              model
             }
           ) }) : /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: { ...editorStyles.editor, minHeight: editorMinHeight }, children: [
             /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(