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

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @ssml-builder-js/ssml-editor-react
 
+## 2.14.0
+
+### Minor Changes
+
+- Add safe container-aware audio merging, preflight-validated SSML chunk synthesis with structured progress events, source mapping metadata, controlled URL validation, and voice capability details in the Visual Editor.
+
+### Patch Changes
+
+- Updated dependencies
+  - @ssml-builder-js/ssml-core@2.14.0
+
 ## 2.13.0
 
 ### Minor Changes

package/dist/index.d.mts

@@ -78,13 +78,17 @@ interface VisualVoiceCatalogEntry {
     name: string;
     locale: string;
     region?: string;
+    regions?: readonly string[];
     styles?: readonly string[];
+    supportedTags?: readonly string[];
+    unsupportedTags?: readonly string[];
     preview?: boolean;
     status?: "ga" | "preview" | "deprecated";
 }
 interface VoiceSelectorRenderProps {
     value: string;
     voices: readonly VisualVoiceCatalogEntry[];
+    selectedVoice?: VisualVoiceCatalogEntry;
     readOnly: boolean;
     locale: SsmlEditorLocale;
     onChange: (voice: string) => void;

package/dist/index.d.ts

@@ -78,13 +78,17 @@ interface VisualVoiceCatalogEntry {
     name: string;
     locale: string;
     region?: string;
+    regions?: readonly string[];
     styles?: readonly string[];
+    supportedTags?: readonly string[];
+    unsupportedTags?: readonly string[];
     preview?: boolean;
     status?: "ga" | "preview" | "deprecated";
 }
 interface VoiceSelectorRenderProps {
     value: string;
     voices: readonly VisualVoiceCatalogEntry[];
+    selectedVoice?: VisualVoiceCatalogEntry;
     readOnly: boolean;
     locale: SsmlEditorLocale;
     onChange: (voice: string) => void;

package/dist/index.js

@@ -5035,28 +5035,72 @@ function localizedElementLabel(element, locale) {
 function filteredVoices(voiceCatalog, locale, region, style) {
   return (voiceCatalog ?? []).filter((voice) => {
     if (locale && voice.locale.toLowerCase() !== locale.toLowerCase()) return false;
-    if (region && voice.region && voice.region.toLowerCase() !== region.toLowerCase()) return false;
+    const regions = [voice.region, ...voice.regions ?? []].filter(
+      (candidate) => Boolean(candidate)
+    );
+    if (region && regions.length > 0 && !regions.some((candidate) => candidate.toLowerCase() === region.toLowerCase()))
+      return false;
     if (style && !voice.styles?.some((candidate) => candidate.toLowerCase() === style.toLowerCase())) return false;
     return true;
   });
 }
-function DefaultVoiceSelector({ value, voices, readOnly, locale, onChange }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
-    "select",
-    {
-      "aria-label": locale === "ja" ? "\u97F3\u58F0" : "Voice",
-      value,
-      disabled: readOnly,
-      onChange: (event) => onChange(event.target.value),
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("option", { value: "", children: locale === "ja" ? "\u97F3\u58F0\u3092\u9078\u629E" : "Select a voice" }),
-        voices.map((voice) => /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("option", { value: voice.name, children: [
-          voice.name,
-          voice.preview || voice.status === "preview" ? " (preview)" : ""
-        ] }, voice.name))
-      ]
-    }
-  );
+function VoiceCapabilityMatrix({
+  voice,
+  locale
+}) {
+  const status = voice.status ?? (voice.preview ? "preview" : void 0);
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { className: "ssml-editor-voice-capabilities", "data-voice-capabilities": "", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { children: [
+      locale === "ja" ? "\u30B9\u30C6\u30FC\u30BF\u30B9" : "Status",
+      ": ",
+      status?.toUpperCase() ?? (locale === "ja" ? "GA" : "GA"),
+      status === "preview" || status === "deprecated" ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("span", { role: "status", "aria-label": status, className: "ssml-editor-voice-warning-badge", children: status === "preview" ? "\u26A0 Preview" : "\u26A0 Deprecated" }) : null
+    ] }),
+    (voice.regions?.length || voice.region) && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { children: [
+      locale === "ja" ? "\u30EA\u30FC\u30B8\u30E7\u30F3" : "Regions",
+      ":",
+      " ",
+      [...voice.regions ?? [], ...voice.region ? [voice.region] : []].filter((region, index, all) => all.indexOf(region) === index).join(", ")
+    ] }),
+    voice.supportedTags && voice.supportedTags.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { children: [
+      locale === "ja" ? "\u5BFE\u5FDC\u30BF\u30B0" : "Supported tags",
+      ": ",
+      voice.supportedTags.join(", ")
+    ] }),
+    voice.unsupportedTags && voice.unsupportedTags.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { className: "ssml-editor-voice-unsupported", children: [
+      locale === "ja" ? "\u975E\u5BFE\u5FDC\u30BF\u30B0" : "Unsupported tags",
+      ": ",
+      voice.unsupportedTags.join(", ")
+    ] })
+  ] });
+}
+function DefaultVoiceSelector({
+  value,
+  voices,
+  selectedVoice,
+  readOnly,
+  locale,
+  onChange
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(import_jsx_runtime6.Fragment, { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(
+      "select",
+      {
+        "aria-label": locale === "ja" ? "\u97F3\u58F0" : "Voice",
+        value,
+        disabled: readOnly,
+        onChange: (event) => onChange(event.target.value),
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("option", { value: "", children: locale === "ja" ? "\u97F3\u58F0\u3092\u9078\u629E" : "Select a voice" }),
+          voices.map((voice) => /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("option", { value: voice.name, children: [
+            voice.name,
+            voice.preview || voice.status === "preview" ? " (preview)" : ""
+          ] }, voice.name))
+        ]
+      }
+    ),
+    selectedVoice ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(VoiceCapabilityMatrix, { voice: selectedVoice, locale }) : null
+  ] });
 }
 function VisualElementInspector({
   document: document2,
@@ -5077,6 +5121,9 @@ function VisualElementInspector({
   }
   const fields = getElementFields(element);
   const availableVoices = filteredVoices(voiceCatalog, voiceLocale, voiceRegion, voiceStyle);
+  const selectedVoice = voiceCatalog?.find(
+    (voice) => voice.name === (element.type === "voice" ? element.name : void 0)
+  );
   const renderSelector = renderVoiceSelector ?? DefaultVoiceSelector;
   return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("fieldset", { children: [
     /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("legend", { children: `<${elementLabel(element)}>` }),
@@ -5122,6 +5169,7 @@ function VisualElementInspector({
         field.key === "name" && elementLabel(element) === "voice" && voiceCatalog ? renderSelector({
           value: inputValue,
           voices: availableVoices,
+          selectedVoice,
           readOnly,
           locale,
           onChange: (value2) => commit(updateOptionalElementProperty(document2, path, field.key, value2))
@@ -5296,6 +5344,7 @@ function VisualSsmlEditor({
           voiceCatalog ? (renderVoiceSelector ?? DefaultVoiceSelector)({
             value: selectedElement.voice ?? "",
             voices: filteredVoices(voiceCatalog, voiceLocale, voiceRegion, voiceStyle),
+            selectedVoice: voiceCatalog?.find((voice) => voice.name === selectedElement.voice),
             readOnly,
             locale,
             onChange: (value) => commit(updateOptionalElementProperty(document2, selectedPath ?? [], "voice", value))