@omniloy/sofia-sdk 1.0.11 → 1.0.12

package/dist/react/index.es.js

@@ -5145,7 +5145,7 @@ const {
   create: create$1,
 } = axios;
 
-const version$2 = "1.0.11";
+const version$2 = "1.0.12";
 
 const handleApiError$1 = async (error) => {
   return Promise.reject(error);
@@ -5903,6 +5903,11 @@ const ar = {
   "Generation failed": "فشل الإنشاء",
   "Could not generate {category}. Please try again.": "تعذّر إنشاء {category}. يرجى المحاولة مرة أخرى.",
   "The new note is waiting for this review — apply or cancel to continue.": "الملاحظة الجديدة في انتظار هذه المراجعة — طبّق أو ألغِ للمتابعة.",
+  " +{count} more": " +{count} أخرى",
+  "{count} mandatory fields missing in this group": "{count, plural, zero {# حقل إلزامي ناقص} one {# حقل إلزامي ناقص} two {حقلان إلزاميان ناقصان} few {# حقول إلزامية ناقصة} many {# حقلاً إلزامياً ناقصاً} other {# حقل إلزامي ناقص}} في هذه المجموعة",
+  "{group} · row {row}": "{group} · الصف {row}",
+  "{group} · row {row} · {field}": "{group} · الصف {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, zero {# صف يحتاج} one {# صف يحتاج} two {صفّان يحتاجان} few {# صفوف تحتاج} many {# صفاً يحتاج} other {# صف يحتاج}} إلى تحديد النوع في هذه المجموعة",
 };
 
 const Add$b = "Afegir";
@@ -6273,6 +6278,11 @@ const ca = {
   "Generation failed": "La generació ha fallat",
   "Could not generate {category}. Please try again.": "No s'ha pogut generar {category}. Torna-ho a provar.",
   "The new note is waiting for this review — apply or cancel to continue.": "La nova nota està esperant aquesta revisió: aplica o cancel·la per continuar.",
+  " +{count} more": " +{count} més",
+  "{count} mandatory fields missing in this group": "{count, plural, one {Falta # camp obligatori} other {Falten # camps obligatoris}} en aquest grup",
+  "{group} · row {row}": "{group} · fila {row}",
+  "{group} · row {row} · {field}": "{group} · fila {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# fila necessita} other {# files necessiten}} que se seleccioni un tipus en aquest grup",
 };
 
 const Add$a = "Afegir";
@@ -6643,6 +6653,11 @@ const ca_valencia = {
   "Generation failed": "La generació ha fallat",
   "Could not generate {category}. Please try again.": "No s'ha pogut generar {category}. Torna-ho a provar.",
   "The new note is waiting for this review — apply or cancel to continue.": "La nova nota està esperant aquesta revisió: aplica o cancel·la per continuar.",
+  " +{count} more": " +{count} més",
+  "{count} mandatory fields missing in this group": "{count, plural, one {Falta # camp obligatori} other {Falten # camps obligatoris}} en este grup",
+  "{group} · row {row}": "{group} · fila {row}",
+  "{group} · row {row} · {field}": "{group} · fila {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# fila necessita} other {# files necessiten}} que se seleccione un tipus en este grup",
 };
 
 const Add$9 = "Přidat";
@@ -7013,6 +7028,11 @@ const cs = {
   "Generation failed": "Generování se nezdařilo",
   "Could not generate {category}. Please try again.": "Nepodařilo se vygenerovat {category}. Zkuste to znovu.",
   "The new note is waiting for this review — apply or cancel to continue.": "Nová poznámka čeká na tuto kontrolu — potvrďte ji, nebo ji zrušte, aby mohla pokračovat.",
+  " +{count} more": " +{count} dalších",
+  "{count} mandatory fields missing in this group": "{count, plural, one {Chybí # povinné pole} few {Chybí # povinná pole} other {Chybí # povinných polí}} v této skupině",
+  "{group} · row {row}": "{group} · řádek {row}",
+  "{group} · row {row} · {field}": "{group} · řádek {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {U # řádku} few {U # řádků} other {U # řádků}} v této skupině je třeba vybrat typ",
 };
 
 const Add$8 = "Add";
@@ -7383,6 +7403,11 @@ const en_GB = {
   "Generation failed": "Generation failed",
   "Could not generate {category}. Please try again.": "Could not generate {category}. Please try again.",
   "The new note is waiting for this review — apply or cancel to continue.": "The new note is waiting for this review — apply or cancel to continue.",
+  " +{count} more": " +{count} more",
+  "{count} mandatory fields missing in this group": "{count, plural, one {# mandatory field missing} other {# mandatory fields missing}} in this group",
+  "{group} · row {row}": "{group} · row {row}",
+  "{group} · row {row} · {field}": "{group} · row {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# row needs} other {# rows need}} a type selected in this group",
 };
 
 const Add$7 = "Add";
@@ -7754,6 +7779,11 @@ const en_US = {
   "Generation failed": "Generation failed",
   "Could not generate {category}. Please try again.": "Could not generate {category}. Please try again.",
   "The new note is waiting for this review — apply or cancel to continue.": "The new note is waiting for this review — apply or cancel to continue.",
+  " +{count} more": " +{count} more",
+  "{count} mandatory fields missing in this group": "{count, plural, one {# mandatory field missing} other {# mandatory fields missing}} in this group",
+  "{group} · row {row}": "{group} · row {row}",
+  "{group} · row {row} · {field}": "{group} · row {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# row needs} other {# rows need}} a type selected in this group",
 };
 
 const Add$6 = "Añadir";
@@ -8137,6 +8167,11 @@ const es = {
   "{name} has expressly refused the use of AI, so recording and report generation are unavailable in this consultation.": "{name} ha rechazado expresamente el uso de IA, así que no se puede grabar ni generar informes en esta consulta.",
   "{name} expressly refused the use of AI on {date}, so recording and report generation are unavailable in this consultation.": "{name} rechazó expresamente el uso de IA el {date}, así que no se puede grabar ni generar informes en esta consulta.",
   "this patient": "este paciente",
+  " +{count} more": " +{count} más",
+  "{count} mandatory fields missing in this group": "{count, plural, one {Falta # campo obligatorio} other {Faltan # campos obligatorios}} en este grupo",
+  "{group} · row {row}": "{group} · fila {row}",
+  "{group} · row {row} · {field}": "{group} · fila {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# fila necesita} other {# filas necesitan}} que se seleccione un tipo en este grupo",
 };
 
 const Add$5 = "Ajouter";
@@ -8507,6 +8542,11 @@ const fr = {
   "Generation failed": "Échec de la génération",
   "Could not generate {category}. Please try again.": "Impossible de générer {category}. Veuillez réessayer.",
   "The new note is waiting for this review — apply or cancel to continue.": "La nouvelle note attend cette révision : appliquez ou annulez pour continuer.",
+  " +{count} more": " +{count} de plus",
+  "{count} mandatory fields missing in this group": "{count, plural, one {# champ obligatoire manquant} other {# champs obligatoires manquants}} dans ce groupe",
+  "{group} · row {row}": "{group} · ligne {row}",
+  "{group} · row {row} · {field}": "{group} · ligne {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# ligne nécessite} other {# lignes nécessitent}} la sélection d'un type dans ce groupe",
 };
 
 const Add$4 = "जोड़ें";
@@ -8856,6 +8896,11 @@ const hi = {
   "Generation failed": "जनरेशन विफल रहा",
   "Could not generate {category}. Please try again.": "{category} जनरेट नहीं किया जा सका। कृपया पुनः प्रयास करें।",
   "The new note is waiting for this review — apply or cancel to continue.": "नई नोट इस समीक्षा की प्रतीक्षा कर रही है — जारी रखने के लिए लागू करें या रद्द करें।",
+  " +{count} more": " +{count} और",
+  "{count} mandatory fields missing in this group": "इस समूह में {count, plural, one {# अनिवार्य फ़ील्ड खाली है} other {# अनिवार्य फ़ील्ड खाली हैं}}",
+  "{group} · row {row}": "{group} · पंक्ति {row}",
+  "{group} · row {row} · {field}": "{group} · पंक्ति {row} · {field}",
+  "{count} rows need a type selected in this group": "इस समूह में {count, plural, one {# पंक्ति के लिए} other {# पंक्तियों के लिए}} प्रकार चुनना आवश्यक है",
 };
 
 const Add$3 = "Tambahkan";
@@ -9204,6 +9249,11 @@ const id = {
   "Generation failed": "Pembuatan gagal",
   "Could not generate {category}. Please try again.": "Tidak dapat membuat {category}. Silakan coba lagi.",
   "The new note is waiting for this review — apply or cancel to continue.": "Catatan baru menunggu tinjauan ini — terapkan atau batalkan untuk melanjutkan.",
+  " +{count} more": " +{count} lainnya",
+  "{count} mandatory fields missing in this group": "{count, plural, other {# bidang wajib belum diisi}} di grup ini",
+  "{group} · row {row}": "{group} · baris {row}",
+  "{group} · row {row} · {field}": "{group} · baris {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, other {# baris perlu dipilih jenisnya}} di grup ini",
 };
 
 const Add$2 = "ਸ਼ਾਮਲ ਕਰੋ";
@@ -9574,6 +9624,11 @@ const pa = {
   "Generation failed": "ਜਨਰੇਸ਼ਨ ਅਸਫਲ ਰਹੀ",
   "Could not generate {category}. Please try again.": "{category} ਜਨਰੇਟ ਨਹੀਂ ਕੀਤਾ ਜਾ ਸਕਿਆ। ਕਿਰਪਾ ਕਰਕੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ।",
   "The new note is waiting for this review — apply or cancel to continue.": "ਨਵਾਂ ਨੋਟ ਇਸ ਸਮੀਖਿਆ ਦੀ ਉਡੀਕ ਕਰ ਰਿਹਾ ਹੈ — ਜਾਰੀ ਰੱਖਣ ਲਈ ਲਾਗੂ ਕਰੋ ਜਾਂ ਰੱਦ ਕਰੋ।",
+  " +{count} more": " +{count} ਹੋਰ",
+  "{count} mandatory fields missing in this group": "ਇਸ ਸਮੂਹ ਵਿੱਚ {count, plural, one {# ਲਾਜ਼ਮੀ ਖੇਤਰ ਖਾਲੀ ਹੈ} other {# ਲਾਜ਼ਮੀ ਖੇਤਰ ਖਾਲੀ ਹਨ}}",
+  "{group} · row {row}": "{group} · ਕਤਾਰ {row}",
+  "{group} · row {row} · {field}": "{group} · ਕਤਾਰ {row} · {field}",
+  "{count} rows need a type selected in this group": "ਇਸ ਸਮੂਹ ਵਿੱਚ {count, plural, one {# ਕਤਾਰ ਲਈ} other {# ਕਤਾਰਾਂ ਲਈ}} ਕਿਸਮ ਚੁਣਨੀ ਲਾਜ਼ਮੀ ਹੈ",
 };
 
 const Add$1 = "Lägg till";
@@ -9944,6 +9999,11 @@ const sv = {
   "Generation failed": "Genereringen misslyckades",
   "Could not generate {category}. Please try again.": "Det gick inte att generera {category}. Försök igen.",
   "The new note is waiting for this review — apply or cancel to continue.": "Den nya anteckningen väntar på den här granskningen — tillämpa eller avbryt för att fortsätta.",
+  " +{count} more": " +{count} till",
+  "{count} mandatory fields missing in this group": "{count, plural, one {# obligatoriskt fält saknas} other {# obligatoriska fält saknas}} i den här gruppen",
+  "{group} · row {row}": "{group} · rad {row}",
+  "{group} · row {row} · {field}": "{group} · rad {row} · {field}",
+  "{count} rows need a type selected in this group": "{count, plural, one {# rad behöver} other {# rader behöver}} en vald typ i den här gruppen",
 };
 
 const Add = "شامل کریں";
@@ -10315,6 +10375,11 @@ const ur = {
   "Generation failed": "تخلیق ناکام ہو گئی",
   "Could not generate {category}. Please try again.": "{category} تیار نہیں کیا جا سکا۔ براہ کرم دوبارہ کوشش کریں۔",
   "The new note is waiting for this review — apply or cancel to continue.": "نیا نوٹ اس جائزے کا منتظر ہے — جاری رکھنے کے لیے لاگو کریں یا منسوخ کریں۔",
+  " +{count} more": " +{count} مزید",
+  "{count} mandatory fields missing in this group": "اس گروپ میں {count, plural, one {# لازمی خانہ خالی ہے} other {# لازمی خانے خالی ہیں}}",
+  "{group} · row {row}": "{group} · قطار {row}",
+  "{group} · row {row} · {field}": "{group} · قطار {row} · {field}",
+  "{count} rows need a type selected in this group": "اس گروپ میں {count, plural, one {# قطار کے لیے} other {# قطاروں کے لیے}} قسم منتخب کرنا ضروری ہے",
 };
 
 var LanguageCode = /* @__PURE__ */ ((LanguageCode2) => {
@@ -11078,19 +11143,177 @@ const useVadCoverage = () => {
   };
 };
 
-const FAMILIES = [
+const KNOWN_SDK_EVENT_NAMES = [
+  "recording.started",
+  "recording.stopped",
+  "recording.audio_lost",
+  "recording.microphone_disconnected",
+  "recording.heartbeat",
+  "activity.interaction",
+  "activity.typing",
+  "report.generation_started",
+  "report.settled",
+  "lifecycle.ready",
+  "lifecycle.closed"
+];
+const SDK_EVENT_FAMILIES = [
   "recording",
   "activity",
   "report",
   "lifecycle"
 ];
+const FAMILIES = SDK_EVENT_FAMILIES;
 const familyOf = (name) => {
   const prefix = name.split(".")[0];
   return FAMILIES.includes(prefix) ? prefix : "lifecycle";
 };
 
-const compileSubscription = (patterns) => {
-  if (!patterns || patterns.length === 0) return () => false;
+const KNOWN_NAMES = new Set(KNOWN_SDK_EVENT_NAMES);
+const KNOWN_FAMILIES = new Set(SDK_EVENT_FAMILIES);
+const distance = (a, b) => {
+  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  for (let i = 1; i <= a.length; i++) {
+    let corner = prev[0];
+    prev[0] = i;
+    for (let j = 1; j <= b.length; j++) {
+      const next = Math.min(
+        prev[j] + 1,
+        prev[j - 1] + 1,
+        corner + (a[i - 1] === b[j - 1] ? 0 : 1)
+      );
+      corner = prev[j];
+      prev[j] = next;
+    }
+  }
+  return prev[b.length];
+};
+const describeEntry = (entry) => {
+  try {
+    return JSON.stringify(entry) ?? `<${typeof entry}>`;
+  } catch {
+    return `<unserializable ${typeof entry}>`;
+  }
+};
+const suggest = (value, candidates) => {
+  let best = null;
+  let bestScore = Infinity;
+  for (const candidate of candidates) {
+    const score = distance(value, candidate);
+    if (score < bestScore) {
+      bestScore = score;
+      best = candidate;
+    }
+  }
+  return best !== null && bestScore <= Math.max(3, best.length / 3) ? ` Did you mean "${best}"?` : "";
+};
+const REJECTED_KEY_CHARS = 40;
+const scanSubscriptions = (input) => {
+  if (input === void 0 || input === null) {
+    return { patterns: [], rejected: [], unusable: false, key: "" };
+  }
+  const raw = typeof input === "string" ? [input] : input;
+  if (!Array.isArray(raw)) {
+    return {
+      patterns: [],
+      rejected: [],
+      unusable: true,
+      key: `!${typeof input}`
+    };
+  }
+  const patterns = [];
+  const rejected = [];
+  for (const entry of raw) {
+    if (typeof entry !== "string") {
+      rejected.push(entry);
+      continue;
+    }
+    const pattern = entry.trim();
+    if (pattern === "" || patterns.includes(pattern)) continue;
+    patterns.push(pattern);
+  }
+  const key = JSON.stringify(patterns) + (rejected.length > 0 ? `!${rejected.map((entry) => describeEntry(entry).slice(0, REJECTED_KEY_CHARS)).join(",")}` : "");
+  return { patterns, rejected, unusable: false, key };
+};
+const normalizeSubscriptions = (input) => {
+  const { patterns, rejected, unusable, key } = scanSubscriptions(input);
+  const problems = [];
+  const warnings = [];
+  if (unusable) {
+    problems.push(
+      `eventSubscriptions must be an array of strings, received ${typeof input}. No events will be delivered.`
+    );
+    return { patterns, key, problems, warnings };
+  }
+  for (const entry of rejected) {
+    problems.push(
+      `eventSubscriptions entry ${describeEntry(entry)} is not a string and was ignored.`
+    );
+  }
+  for (const pattern of patterns) {
+    if (pattern === "*" || KNOWN_NAMES.has(pattern)) continue;
+    if (pattern.endsWith(".*")) {
+      const family = pattern.slice(0, -2);
+      if (!KNOWN_FAMILIES.has(family)) {
+        const hint2 = suggest(family, KNOWN_FAMILIES);
+        (hint2 ? problems : warnings).push(
+          `"${pattern}" is not a known event family.${hint2}`
+        );
+      }
+      continue;
+    }
+    const hint = suggest(pattern, KNOWN_NAMES);
+    (hint ? problems : warnings).push(
+      `"${pattern}" is not an event this SDK version emits.${hint}`
+    );
+  }
+  const present = input !== void 0 && input !== null;
+  if (present && patterns.length === 0 && problems.length === 0) {
+    problems.push(
+      'eventSubscriptions is empty, so onEvent will never fire. Pass e.g. ["recording.*", "activity.*"] or ["*"].'
+    );
+  }
+  return { patterns, key, problems, warnings };
+};
+const reported = /* @__PURE__ */ new Set();
+const VALID_VALUES = `Valid values are "*", a family wildcard (${SDK_EVENT_FAMILIES.map((f) => `"${f}.*"`).join(", ")}), or an exact name (${KNOWN_SDK_EVENT_NAMES.join(", ")}).`;
+const reportOnce = (level, signature, message) => {
+  if (reported.has(signature)) return;
+  reported.add(signature);
+  if (level === "error") logger.configError(message);
+  else logger.warn(message);
+};
+const reportSubscriptionProblems = ({
+  key,
+  problems,
+  warnings
+}) => {
+  if (problems.length > 0) {
+    reportOnce(
+      "error",
+      `error:${key}:${problems.join("|")}`,
+      `[Sofia SDK] eventSubscriptions: ${problems.join(" ")} ${VALID_VALUES}`
+    );
+  }
+  if (warnings.length > 0) {
+    reportOnce(
+      "warn",
+      `warn:${key}:${warnings.join("|")}`,
+      `[Sofia SDK] eventSubscriptions: ${warnings.join(" ")} ${VALID_VALUES}`
+    );
+  }
+};
+const reportHandlerWithoutSubscriptions = () => {
+  reportOnce(
+    "error",
+    "onEvent:no-subscriptions",
+    "[Sofia SDK] onEvent: onEvent was provided without eventSubscriptions, so no events will be delivered. " + VALID_VALUES
+  );
+};
+const compileSubscription = (input) => {
+  const normalized = normalizeSubscriptions(input);
+  reportSubscriptionProblems(normalized);
+  const { patterns } = normalized;
+  if (patterns.length === 0) return () => false;
   if (patterns.includes("*")) return () => true;
   const exact = /* @__PURE__ */ new Set();
   const families = /* @__PURE__ */ new Set();
@@ -11105,7 +11328,7 @@ const compileSubscription = (patterns) => {
     return dot > 0 && families.has(name.slice(0, dot));
   };
 };
-const subscriptionKey = (patterns) => patterns ? patterns.join("|") : "";
+const subscriptionKey = (input) => scanSubscriptions(input).key;
 
 const QUEUE_CAP = 200;
 let handler = null;
@@ -22871,18 +23094,22 @@ const useReportPreviewState = ({
     }),
     [entries, selectedKeys, selectedRows, filledScalarGaps]
   );
-  const blockingMandatoryCount = React__default.useMemo(() => {
-    let count = 0;
+  const blockingGaps = React__default.useMemo(() => {
+    const out = [];
     for (const g of scalarGaps) {
       if (!g.mandatory) continue;
       const filled = filledScalarGaps.get(g.key);
-      if (isEmptyValue(filled)) count++;
+      if (isEmptyValue(filled)) {
+        out.push({ scope: "field", key: g.key, label: g.descriptor.label });
+      }
     }
     for (const e of entries) {
       if (!selectedKeys.has(e.key)) continue;
       if (e.descriptor.kind !== "array-of-objects" && e.descriptor.mandatory) {
         const v = edits.has(e.key) ? edits.get(e.key) : e.value;
-        if (isEmptyValue(v)) count++;
+        if (isEmptyValue(v)) {
+          out.push({ scope: "field", key: e.key, label: e.descriptor.label });
+        }
       }
       if (e.descriptor.kind !== "array-of-objects") continue;
       const rows = e.value ?? [];
@@ -22890,16 +23117,32 @@ const useReportPreviewState = ({
         if (!selectedRows.has(`${e.key}#${idx}`)) return;
         const row = mergeRowEdits(e.key, idx, rawRow, edits);
         if (e.descriptor.discriminator && !pickBranch(e.descriptor, row)) {
-          count++;
+          out.push({
+            scope: "row",
+            key: e.key,
+            groupLabel: e.descriptor.label,
+            rowIndex: idx,
+            label: null,
+            fieldKey: e.descriptor.discriminator.propertyName
+          });
           return;
         }
-        const mandatoryItemKeys = effectiveItemFields(e.descriptor, row).filter((f) => f.mandatory).map((f) => f.key);
-        for (const mk of mandatoryItemKeys) {
-          if (isEmptyValue(row[mk])) count++;
+        for (const f of effectiveItemFields(e.descriptor, row)) {
+          if (!f.mandatory) continue;
+          if (isEmptyValue(row[f.key])) {
+            out.push({
+              scope: "row",
+              key: e.key,
+              groupLabel: e.descriptor.label,
+              rowIndex: idx,
+              label: f.label,
+              fieldKey: f.key
+            });
+          }
         }
       });
     }
-    return count;
+    return out;
   }, [
     entries,
     scalarGaps,
@@ -22908,9 +23151,11 @@ const useReportPreviewState = ({
     edits,
     filledScalarGaps
   ]);
+  const blockingMandatoryCount = blockingGaps.length;
   return {
     entries,
     scalarGaps,
+    blockingGaps,
     rowGaps,
     selectedKeys,
     selectedRows,
@@ -23634,13 +23879,41 @@ const InsertionPreviewModal = ({
               ]
             }
           ),
-          (state.scalarGaps.length > 0 || state.blockingMandatoryCount > 0) && /* @__PURE__ */ jsx$2("p", { className: "omniscribe_insertion-preview__sub", children: state.blockingMandatoryCount > 0 ? /* @__PURE__ */ jsx$2("strong", { className: "omniscribe_insertion-preview__sub--blocking", children: formatMessage(
-            {
-              id: "{count} mandatory fields must be filled before applying",
-              defaultMessage: "{count, plural, one {# mandatory field} other {# mandatory fields}} must be filled before applying"
-            },
-            { count: state.blockingMandatoryCount }
-          ) }) : formatMessage(
+          (state.scalarGaps.length > 0 || state.blockingMandatoryCount > 0) && /* @__PURE__ */ jsx$2("p", { className: "omniscribe_insertion-preview__sub", children: state.blockingMandatoryCount > 0 ? /* @__PURE__ */ jsxs("strong", { className: "omniscribe_insertion-preview__sub--blocking", children: [
+            formatMessage(
+              {
+                id: "{count} mandatory fields must be filled before applying",
+                defaultMessage: "{count, plural, one {# mandatory field} other {# mandatory fields}} must be filled before applying"
+              },
+              { count: state.blockingMandatoryCount }
+            ),
+            ": ",
+            state.blockingGaps.slice(0, BLOCKING_GAPS_SHOWN).map(
+              (g) => g.scope === "field" ? g.label : g.label === null ? formatMessage(
+                {
+                  id: "{group} · row {row}",
+                  defaultMessage: "{group} · row {row}"
+                },
+                { group: g.groupLabel, row: g.rowIndex + 1 }
+              ) : formatMessage(
+                {
+                  id: "{group} · row {row} · {field}",
+                  defaultMessage: "{group} · row {row} · {field}"
+                },
+                {
+                  group: g.groupLabel,
+                  row: g.rowIndex + 1,
+                  field: g.label
+                }
+              )
+            ).join(", "),
+            state.blockingGaps.length > BLOCKING_GAPS_SHOWN && formatMessage(
+              { id: " +{count} more", defaultMessage: " +{count} more" },
+              {
+                count: state.blockingGaps.length - BLOCKING_GAPS_SHOWN
+              }
+            )
+          ] }) : formatMessage(
             {
               id: "{count} fields need your attention",
               defaultMessage: "{count, plural, one {# field needs} other {# fields need}} your attention"
@@ -23826,14 +24099,44 @@ const EntrySection = ({
   classNames
 }) => {
   const { formatMessage } = useIntl();
-  const hasMandatoryRowGap = React.useMemo(() => {
-    const gaps = state.rowGaps.get(entry.key);
-    return !!gaps?.some((g) => g.mandatoryMissingKeys.length > 0);
-  }, [state.rowGaps, entry.key]);
+  const blockingRows = React.useMemo(
+    () => state.blockingGaps.filter((g) => g.scope === "row" && g.key === entry.key),
+    [state.blockingGaps, entry.key]
+  );
+  const hasMandatoryRowGap = blockingRows.length > 0;
+  const missingFieldCount = blockingRows.filter(
+    (g) => g.scope === "row" && g.label !== null
+  ).length;
+  const untypedRowCount = blockingRows.length - missingFieldCount;
+  const groupGapSummary = [
+    missingFieldCount > 0 && formatMessage(
+      {
+        id: "{count} mandatory fields missing in this group",
+        defaultMessage: "{count, plural, one {# mandatory field missing} other {# mandatory fields missing}} in this group"
+      },
+      { count: missingFieldCount }
+    ),
+    untypedRowCount > 0 && formatMessage(
+      {
+        id: "{count} rows need a type selected in this group",
+        defaultMessage: "{count, plural, one {# row needs} other {# rows need}} a type selected in this group"
+      },
+      { count: untypedRowCount }
+    )
+  ].filter(Boolean).join(" · ");
   const [expanded, setExpanded] = React.useState(hasMandatoryRowGap);
   React.useEffect(() => {
     if (hasMandatoryRowGap) setExpanded(true);
   }, [hasMandatoryRowGap]);
+  const missingKeysOfRow = (idx) => {
+    const keys = new Set(
+      state.rowGaps.get(entry.key)?.find((g) => g.index === idx)?.missingKeys
+    );
+    for (const g of blockingRows) {
+      if (g.scope === "row" && g.rowIndex === idx) keys.add(g.fieldKey);
+    }
+    return [...keys];
+  };
   if (entry.descriptor.kind === "array-of-objects") {
     const rows = entry.value;
     return /* @__PURE__ */ jsxs(
@@ -23859,7 +24162,23 @@ const EntrySection = ({
               /* @__PURE__ */ jsx$2("div", { className: "omniscribe_insertion-preview__row-body", children: /* @__PURE__ */ jsxs("div", { className: "omniscribe_insertion-preview__row-label", children: [
                 entry.descriptor.label,
                 " · ",
-                rows.length
+                rows.length,
+                hasMandatoryRowGap && // `role="img"` + `aria-label`: a `title` alone is not exposed
+                // reliably, so a screen reader announced only "star 1".
+                /* @__PURE__ */ jsxs(
+                  "span",
+                  {
+                    className: "omniscribe_insertion-preview__group-count--gap",
+                    role: "img",
+                    title: groupGapSummary,
+                    "aria-label": groupGapSummary,
+                    children: [
+                      " ",
+                      "★ ",
+                      blockingRows.length
+                    ]
+                  }
+                )
               ] }) })
             ] }),
             /* @__PURE__ */ jsx$2(
@@ -23880,7 +24199,7 @@ const EntrySection = ({
               row,
               descriptor: entry.descriptor,
               state,
-              missingKeys: state.rowGaps.get(entry.key)?.find((g) => g.index === idx)?.missingKeys ?? [],
+              missingKeys: missingKeysOfRow(idx),
               classNames
             },
             idx
@@ -24046,6 +24365,7 @@ const RowItem = ({
     }
   );
 };
+const BLOCKING_GAPS_SHOWN = 3;
 const ScalarGapRow = ({
   descriptor,
   value,
@@ -156953,6 +157273,7 @@ const useBrowserCapabilityCheck = () => {
   }, []);
 };
 
+const MISSING_SUBSCRIPTIONS_GRACE_MS = 1e3;
 const BrowserCapabilityProbe = () => {
   useBrowserCapabilityCheck();
   return null;
@@ -157053,13 +157374,15 @@ const Omniscribe = ({
     if (!hasEventHandler) return;
     return SdkEventBus.setHandler((event) => onEventRef.current?.(event));
   }, [hasEventHandler]);
+  const hasSubscriptionsProp = eventSubscriptions !== void 0 && eventSubscriptions !== null;
   React.useEffect(() => {
-    if (hasEventHandler && !eventSubscriptions?.length) {
-      logger.warn(
-        '[Sofia SDK] onEvent was provided without eventSubscriptions, so no events will be delivered. Pass e.g. ["recording.*", "activity.*"].'
-      );
-    }
-  }, [hasEventHandler, eventSubscriptions]);
+    if (!hasEventHandler || hasSubscriptionsProp) return;
+    const timer = setTimeout(
+      reportHandlerWithoutSubscriptions,
+      MISSING_SUBSCRIPTIONS_GRACE_MS
+    );
+    return () => clearTimeout(timer);
+  }, [hasEventHandler, hasSubscriptionsProp]);
   React.useEffect(() => {
     if (apikey && apikey.trim() !== "") {
       setEncryptionSeed(apikey);