@lumiastream/ui 0.6.0 → 0.6.2

package/dist/index.js

@@ -4865,6 +4865,65 @@ var RESERVED_FIELD_KEYS = /* @__PURE__ */ new Set([
   "widgetAuthor",
   "widgetDuration"
 ]);
+var SE_LISTENER_TO_LUMIA_EVENTS = {
+  message: ["chat"],
+  "tip-latest": ["alert", "alert.trigger"],
+  "merch-latest": ["alert", "alert.trigger"],
+  "subscriber-latest": ["alert", "alert.trigger"],
+  "subscriber-resub-latest": ["alert", "alert.trigger"],
+  "subscriber-gifted-latest": ["alert", "alert.trigger"],
+  "subscriber-bomb-latest": ["alert", "alert.trigger"],
+  "follower-latest": ["alert", "alert.trigger"],
+  "cheer-latest": ["alert", "alert.trigger"],
+  "raid-latest": ["alert", "alert.trigger"],
+  "host-latest": ["alert", "alert.trigger"],
+  "redemption-latest": ["alert", "alert.trigger"],
+  "hypetrain-start": ["alert", "alert.trigger"],
+  "hypetrain-level-progress": ["alert", "alert.trigger"],
+  "hypetrain-end": ["alert", "alert.trigger"],
+  "sponsor-latest": ["alert", "alert.trigger"],
+  "member-latest": ["alert", "alert.trigger"],
+  "superchat-latest": ["alert", "alert.trigger"],
+  "kappagen-launched": ["alert", "alert.trigger"]
+};
+function listenersToLumiaEvents(listeners, listener) {
+  const keys = /* @__PURE__ */ new Set();
+  if (Array.isArray(listeners)) {
+    for (const k of listeners) if (typeof k === "string") keys.add(k);
+  } else if (listeners && typeof listeners === "object") {
+    for (const [k, v] of Object.entries(listeners)) if (v) keys.add(k);
+  }
+  if (typeof listener === "string" && listener) keys.add(listener);
+  const out = /* @__PURE__ */ new Set();
+  for (const k of keys) {
+    const mapped = SE_LISTENER_TO_LUMIA_EVENTS[k];
+    if (mapped) for (const e of mapped) out.add(e);
+  }
+  return [...out];
+}
+var SE_FIRST_PARTY_SCRIPT_RX = /^(?:https?:)?\/\/(?:[^/]+\.)?(?:streamelements\.com|lumiastream\.com)\//i;
+var EXTERNAL_SCRIPT_SRC_RX = /<script\b[^>]*\bsrc\s*=\s*["']([^"']+)["']/gi;
+var CHAT_COMMAND_VALUE_RX = /^\s*!\S+/;
+function hasExternalScriptLoader(html, js) {
+  const haystack = `${html ?? ""}
+${js ?? ""}`;
+  EXTERNAL_SCRIPT_SRC_RX.lastIndex = 0;
+  for (const m of haystack.matchAll(EXTERNAL_SCRIPT_SRC_RX)) {
+    const src = m[1]?.trim();
+    if (!src) continue;
+    if (src.startsWith("/") && !src.startsWith("//")) continue;
+    if (SE_FIRST_PARTY_SCRIPT_RX.test(src)) continue;
+    return true;
+  }
+  return false;
+}
+function hasChatCommandFieldValue(fieldData) {
+  if (!fieldData) return false;
+  for (const v of Object.values(fieldData)) {
+    if (typeof v === "string" && CHAT_COMMAND_VALUE_RX.test(v)) return true;
+  }
+  return false;
+}
 function translateConfigs(sourceFields) {
   if (!sourceFields) return [];
   return Object.entries(sourceFields).filter(([key]) => !RESERVED_FIELD_KEYS.has(key)).map(([key, f]) => {
@@ -4913,6 +4972,19 @@ function mapCustom(widget, ctx) {
   const fieldData = parse(v.fieldData) ?? v.fieldData;
   const widgetProvider = widget.provider;
   const provider = widgetProvider === "kick" || widgetProvider === "youtube" || widgetProvider === "twitch" ? widgetProvider : ctx?.provider ?? "twitch";
+  const eventsList = listenersToLumiaEvents(
+    widget.listeners,
+    widget.listener
+  );
+  const externalLoader = hasExternalScriptLoader(v.html, v.js);
+  const wantsChat = externalLoader || hasChatCommandFieldValue(fieldData);
+  if (externalLoader) {
+    if (!eventsList.includes("alert")) eventsList.push("alert");
+    if (!eventsList.includes("alert.trigger")) eventsList.push("alert.trigger");
+  }
+  if (wantsChat && !eventsList.includes("chat")) eventsList.push("chat");
+  const data = { ...fieldData ?? {} };
+  if (eventsList.length > 0) data.events = eventsList;
   return buildUnit(
     widget,
     "custom",
@@ -4928,7 +5000,7 @@ function mapCustom(widget, ctx) {
         css: v.css ?? "",
         js: v.js ?? "",
         configs: translateConfigs(fields),
-        data: fieldData ?? {},
+        data,
         flavor: "streamelements",
         // Native field on the Custom module content. The compatibility
         // shim in Embed.tsx reads this to pick the right listener-name
@@ -7038,7 +7110,7 @@ async function mirrorOneAsset(url, upload, signal, proxyAssetFetch) {
   const blob = await fetchAssetBlob(url, signal, proxyAssetFetch);
   if (signal?.aborted) throw new DOMException("Aborted", "AbortError");
   if (blob.size > MAX_MIRROR_ASSET_BYTES) {
-    throw new Error(`Asset is ${(blob.size / (1024 * 1024)).toFixed(1)} MB \u2014 over the ${MAX_MIRROR_ASSET_BYTES / (1024 * 1024)} MB import cap.`);
+    throw new Error(`Asset is ${(blob.size / (1024 * 1024)).toFixed(1)} MB, over the ${MAX_MIRROR_ASSET_BYTES / (1024 * 1024)} MB import cap.`);
   }
   const filename = filenameFromURL(url);
   const type = blob.type || guessMime(filename);
@@ -7060,7 +7132,7 @@ async function fetchAssetBlob(url, signal, proxyAssetFetch) {
     if (!res.ok) throw new Error(`Source returned HTTP ${res.status}`);
     const declared = Number(res.headers.get("content-length"));
     if (Number.isFinite(declared) && declared > MAX_MIRROR_ASSET_BYTES) {
-      throw new Error(`Asset is ${(declared / (1024 * 1024)).toFixed(1)} MB \u2014 over the ${MAX_MIRROR_ASSET_BYTES / (1024 * 1024)} MB import cap.`);
+      throw new Error(`Asset is ${(declared / (1024 * 1024)).toFixed(1)} MB, over the ${MAX_MIRROR_ASSET_BYTES / (1024 * 1024)} MB import cap.`);
     }
     return res.blob();
   }
@@ -7300,7 +7372,7 @@ function decodeJwtPayload(jwt) {
   }
   const claims = parsed;
   if (typeof claims.channel !== "string" || typeof claims.authToken !== "string") {
-    throw new SEAuthError("invalid-jwt", "Token payload is missing the 'channel' or 'authToken' claim \u2014 not a StreamElements account token.");
+    throw new SEAuthError("invalid-jwt", "Token payload is missing the 'channel' or 'authToken' claim. not a StreamElements account token.");
   }
   if (typeof claims.exp === "number" && claims.exp * 1e3 < Date.now()) {
     throw new SEAuthError("expired", "This StreamElements token has expired. Generate a new one on the SE Account page.");
@@ -7309,7 +7381,7 @@ function decodeJwtPayload(jwt) {
 }
 var SEClient = class _SEClient {
   // `jwt` is held alongside the decoded claims so the client can switch auth
-  // modes without re-parsing. Defaults to `bearer-jwt` — confirmed against
+  // modes without re-parsing. Defaults to `bearer-jwt`. confirmed against
   // the user's diagnostic 2026-05-16: every endpoint the existing 5 helpers
   // hit (users/current, channels/me, overlays, bot/commands, plus
   // sessions/loyalty/bits leaderboard transitively) returns 200, AND
@@ -7397,7 +7469,7 @@ var SEClient = class _SEClient {
       let detail = "";
       try {
         const body = await res.json();
-        if (body?.message) detail = ` \u2014 ${body.message}`;
+        if (body?.message) detail = ` - ${body.message}`;
       } catch {
       }
       throw new Error(`StreamElements API returned HTTP ${res.status}${detail}`);
@@ -7439,7 +7511,7 @@ async function fetchElementWidgetInstancePublic(channelId, widgetInstanceId, pub
     let detail = "";
     try {
       const body = JSON.parse(await result.errorBody());
-      if (body?.message) detail = ` \u2014 ${body.message}`;
+      if (body?.message) detail = ` - ${body.message}`;
     } catch {
     }
     const reason = result.status === 401 || result.status === 403 ? "StreamElements rejected the widget share token. The share link may have been revoked or made private." : result.status === 404 ? "Element widget not found. Double-check the share URL." : `HTTP ${result.status}`;
@@ -8447,15 +8519,15 @@ var PLACEHOLDER_WIDGET_TYPES = /* @__PURE__ */ new Set([
   "streamlabels"
 ]);
 var PLACEHOLDER_REASONS = {
-  donation_ticker: "No native Lumia equivalent yet \u2014 imported as a placeholder text layer.",
-  stream_boss: "Lumia has a native streamboss module \u2014 set it up directly rather than importing the SL config.",
-  credits: "Lumia has a native credits module \u2014 set it up directly rather than importing the SL config.",
-  spin_wheel: "Lumia has a native spinwheel module \u2014 set it up directly rather than importing the SL config.",
-  emote_wall: "Lumia has a native emotebox module \u2014 set it up directly rather than importing the SL config.",
-  sub_train: "No native Lumia equivalent yet \u2014 imported as a placeholder text layer.",
+  donation_ticker: "No native Lumia equivalent yet. imported as a placeholder text layer.",
+  stream_boss: "Lumia has a native streamboss module. set it up directly rather than importing the SL config.",
+  credits: "Lumia has a native credits module. set it up directly rather than importing the SL config.",
+  spin_wheel: "Lumia has a native spinwheel module. set it up directly rather than importing the SL config.",
+  emote_wall: "Lumia has a native emotebox module. set it up directly rather than importing the SL config.",
+  sub_train: "No native Lumia equivalent yet. imported as a placeholder text layer.",
   streamlabels: "Use Lumia template variables (e.g. {{twitch_last_follower}}) inside a Text module instead of importing the SL streamlabels config."
 };
-var CUSTOM_HTML_REVIEW_REASON = "The Streamlabs widget used custom HTML/CSS/JS that Lumia cannot host. The native Lumia module is the right starting point \u2014 recreate the styling there. The original SL settings are stashed under module.content.importMeta for reference.";
+var CUSTOM_HTML_REVIEW_REASON = "The Streamlabs widget used custom HTML/CSS/JS that Lumia cannot host. The native Lumia module is the right starting point. recreate the styling there. The original SL settings are stashed under module.content.importMeta for reference.";
 function stampImportMeta(module, widgetType, role, extra = {}) {
   stampImportMetaMerge(module, {
     source: "streamlabs",
@@ -8613,7 +8685,7 @@ function importStreamlabsWidget(response, widgetType, options = {}) {
     });
     reviewItems.push({
       moduleId: placeholder.module.id,
-      // SL doesn't have a single "widget" object the way SE does — we
+      // SL doesn't have a single "widget" object the way SE does. we
       // stash the settings snapshot here so the review step can show
       // the raw config the user imported. Cast through unknown because
       // ReviewItem is currently typed against SEWidget; widening the
@@ -8631,7 +8703,7 @@ function importStreamlabsWidget(response, widgetType, options = {}) {
     layers.push(placeholder.layer);
     modules[placeholder.layer.id] = placeholder.module;
     coverage.notes.push(
-      `Unknown Streamlabs widget type "${widgetType}" \u2014 imported as a placeholder.`
+      `Unknown Streamlabs widget type "${widgetType}". imported as a placeholder.`
     );
     coverage.mappings.push({
       seType: `streamlabs:${widgetType}`,
@@ -9044,7 +9116,7 @@ function StepHeader({
   ] });
 }
 var JWT_FEATURES = [
-  "All your overlays \u2014 pick one, many, or all",
+  "All your overlays: pick one, many, or all",
   "Live counters (follower / sub / tip / bits goals)",
   "Chat bot commands",
   "Loyalty points + watch time",
@@ -9198,7 +9270,7 @@ function StepModePicker({
                   }
                 )
               ] }),
-              caveat: "Requires pasting your StreamElements JWT. Stored only in memory \u2014 never sent to Lumia.",
+              caveat: "Requires pasting your StreamElements JWT. Stored only in memory. Never sent to Lumia.",
               onClick: onChooseJwt
             }
           )
@@ -9223,7 +9295,7 @@ function StepConnect({
       {
         number: 1,
         title: "Connect your StreamElements account",
-        subtitle: "Paste your StreamElements JWT to import overlays, live counters, chat commands, loyalty points, watch time, and recent events. The token is read in your browser only \u2014 Lumia never sends it to our servers."
+        subtitle: "Paste your StreamElements JWT to import overlays, live counters, chat commands, loyalty points, watch time, and recent events. The token is read in your browser only. Lumia never sends it to our servers."
       }
     ),
     /* @__PURE__ */ jsx14(
@@ -11872,15 +11944,15 @@ function importElementOverlay(response, options = {}) {
 // src/se-import/index.ts
 var IMPORT_META_KEY2 = "importMeta";
 var REVIEW_REASONS = {
-  "se-widget-bit-boss": "No native Lumia equivalent \u2014 bit boss fight bar with HP/damage states.",
+  "se-widget-bit-boss": "No native Lumia equivalent. bit boss fight bar with HP/damage states.",
   // `se-widget-hype-cup` intentionally omitted — it now routes to the native
   // `tipjar` module (see dispatcher.ts) and lands with `partial` status, so it
   // never reaches the placeholder-reason fallback. If a future feature flag
   // disables tipjar auto-import, add an entry to FLAG_OFF_REASONS instead.
-  "se-widget-media-share": "No native Lumia equivalent \u2014 viewer-submitted media player.",
-  "se-widget-contest": "No native Lumia equivalent \u2014 SE-specific contest widget.",
-  "se-widget-giveaway": "No native Lumia equivalent \u2014 SE giveaway service.",
-  "se-widget-botcounter": "No native Lumia equivalent \u2014 chatter/message counter.",
+  "se-widget-media-share": "No native Lumia equivalent. viewer-submitted media player.",
+  "se-widget-contest": "No native Lumia equivalent. SE-specific contest widget.",
+  "se-widget-giveaway": "No native Lumia equivalent. SE giveaway service.",
+  "se-widget-botcounter": "No native Lumia equivalent. chatter/message counter.",
   "se-widget-top-cheerers-list": 'Lumia loyaltyleaderboard needs a "source" extension before it can render cheer rankings.',
   "se-widget-top-gifters-list": 'Lumia loyaltyleaderboard needs a "source" extension before it can render gifter rankings.',
   "se-widget-top-tippers-list": 'Lumia loyaltyleaderboard needs a "source" extension before it can render tipper rankings.',
@@ -11890,7 +11962,7 @@ var REVIEW_REASONS = {
   // so we can't pre-populate the slideshow items. The streamer adds their
   // product images by hand in the slideshow editor. Status = 'partial' (see
   // dispatcher.ts), so this string surfaces in the review step.
-  "se-widget-merch-products-rotator": "Imported as an empty slideshow. Lumia doesn't fetch your Fourthwall product catalog yet, so add your product images manually in the slideshow editor \u2014 the layer is pre-positioned and styled to match your SE widget."
+  "se-widget-merch-products-rotator": "Imported as an empty slideshow. Lumia doesn't fetch your Fourthwall product catalog yet, so add your product images manually in the slideshow editor. the layer is pre-positioned and styled to match your SE widget."
   // Seasonal widgets (snow / halloween / halloween-2019 / xmas / valentine / easter
   // / world-cup) intentionally omitted — they route directly to image/slideshow/
   // video modules now (see dispatcher.ts SEASONAL_IMAGE_TYPES), so they always
@@ -11898,7 +11970,7 @@ var REVIEW_REASONS = {
 };
 function reasonFor(seType, status, flaggedOff) {
   if (flaggedOff && FLAG_OFF_REASONS[seType]) return FLAG_OFF_REASONS[seType];
-  return REVIEW_REASONS[seType] ?? (status === "template" ? "Imported as a generic template stub." : "No native mapping yet \u2014 imported as a labelled text placeholder.");
+  return REVIEW_REASONS[seType] ?? (status === "template" ? "Imported as a generic template stub." : "No native mapping yet. imported as a labelled text placeholder.");
 }
 function buildSEBootstrapDescription(overlayId, sourceUrl) {
   const head = overlayId ? `Imported from StreamElements overlay ${overlayId}` : "Imported from StreamElements";
@@ -11928,7 +12000,7 @@ async function fetchSEBootstrap({
 }) {
   if (!apikey) {
     throw new Error(
-      "Missing access token. Use the public preview URL (Overlay menu \u2192 Get URL \u2192 Public link) \u2014 editor URLs do not include a token."
+      "Missing access token. Use the public preview URL (Overlay menu \u2192 Get URL \u2192 Public link). editor URLs do not include a token."
     );
   }
   const result = await fetchWithProxyFallback(buildBootstrapUrl(overlayId), {
@@ -11939,7 +12011,7 @@ async function fetchSEBootstrap({
     let detail = "";
     try {
       const body = JSON.parse(await result.errorBody());
-      detail = body?.message ? ` \u2014 ${body.message}` : "";
+      detail = body?.message ? `. ${body.message}` : "";
     } catch {
     }
     const reason = result.status === 401 || result.status === 403 ? "StreamElements rejected the URL token. The preview link may have been revoked." : result.status === 404 ? "Overlay not found. Double-check the URL." : `HTTP ${result.status}`;
@@ -12081,17 +12153,17 @@ function importSEBootstrap(bootstrap, options = {}) {
   }
   if (coverage.mappings.some((m) => m.status === "placeholder")) {
     coverage.notes.push(
-      "Some widgets imported as placeholder text layers \u2014 see SE/05-widget-to-module-mapping.md for status."
+      "Some widgets imported as placeholder text layers. see SE/05-widget-to-module-mapping.md for status."
     );
   }
   if (coverage.mappings.some((m) => m.seType === "se-widget-merch-goal")) {
     coverage.notes.push(
-      "Merch-goal widgets imported as generic goals \u2014 see SE/03-missing-variables.md \xA78 for the missing data source."
+      "Merch-goal widgets imported as generic goals. see SE/03-missing-variables.md \xA78 for the missing data source."
     );
   }
   if (coverage.mappings.some((m) => m.seType === "se-widget-custom-event-list")) {
     coverage.notes.push(
-      "\u26A0 Custom widgets are experimental \u2014 they run under the SE compatibility shim (Embed.tsx) which handles most SE APIs but may not cover every edge case. Verify each custom layer renders correctly in the editor."
+      "\u26A0 Custom widgets are experimental. they run under the SE compatibility shim (Embed.tsx) which handles most SE APIs but may not cover every edge case. Verify each custom layer renders correctly in the editor."
     );
   }
   const overlay = {
@@ -12236,7 +12308,7 @@ function buildAIPromptForSEWidget(widget, canvas) {
   const fullVariables = JSON.stringify(variables, null, 2);
   const truncated = fullVariables.length > VARIABLES_BUDGET;
   const variablesJson = truncated ? `${fullVariables.slice(0, VARIABLES_BUDGET)}
-\u2026[truncated \u2014 ${fullVariables.length - VARIABLES_BUDGET} more bytes elided]` : fullVariables;
+\u2026[truncated. ${fullVariables.length - VARIABLES_BUDGET} more bytes elided]` : fullVariables;
   return [
     "Recreate a StreamElements overlay widget as a Lumia Stream custom overlay (HTML + CSS + JS).",
     "",
@@ -12244,14 +12316,14 @@ function buildAIPromptForSEWidget(widget, canvas) {
     listener ? `Primary event listener: ${listener}` : "",
     listeners ? `Subscribes to events: ${listeners.join(", ")}` : "",
     `Canvas: ${landing.width} \xD7 ${landing.height}`,
-    truncated ? "Note: the widget config below is truncated \u2014 focus on visible/structural fields and ignore tail content you cannot see." : "",
+    truncated ? "Note: the widget config below is truncated. focus on visible/structural fields and ignore tail content you cannot see." : "",
     "",
     "Widget configuration (JSON):",
     "```json",
     variablesJson,
     "```",
     "",
-    "Constraints \u2014 your output must run inside a Lumia Custom Overlay sandboxed iframe:",
+    "Constraints. your output must run inside a Lumia Custom Overlay sandboxed iframe:",
     '- Use `window.Overlay.on("alert", handler)` / `window.Overlay.on("chat", handler)` to receive Lumia events.',
     "- Lumia template variables use double-brace syntax: {{username}}, {{amount}}, {{message}}, {{currency}}.",
     "- The `window.DATA` object holds user-configurable values (mirrors your `configs`).",

package/dist/se-import.d.ts

@@ -183,7 +183,7 @@ declare function fetchWithProxyFallback(url: string, options?: FetchWithProxyOpt
 
 /**
  * Distinct importable CDN URLs referenced anywhere inside the overlay's
- * settings. Covers both StreamElements and Streamlabs source hosts — see
+ * settings. Covers both StreamElements and Streamlabs source hosts, see
  * IMPORTABLE_CDN_REGEX above for the full host list.
  *
  * Name kept as `findSEAssetURLs` for back-compat with existing callers; the
@@ -211,7 +211,7 @@ interface AssetMirrorProgress {
  *
  * The host call site is responsible for retries and progress reporting;
  * this function is intentionally single-shot. Pass `signal` (AbortSignal)
- * to abort the source-side `fetch` when the modal closes mid-mirror — the
+ * to abort the source-side `fetch` when the modal closes mid-mirror, the
  * upload itself is consumer-defined and the caller decides whether/how to
  * short-circuit it. The proxy path doesn't take a signal because the
  * host-provided fetch shape varies.

package/dist/se-import.js

@@ -1785,6 +1785,65 @@ var RESERVED_FIELD_KEYS = /* @__PURE__ */ new Set([
   "widgetAuthor",
   "widgetDuration"
 ]);
+var SE_LISTENER_TO_LUMIA_EVENTS = {
+  message: ["chat"],
+  "tip-latest": ["alert", "alert.trigger"],
+  "merch-latest": ["alert", "alert.trigger"],
+  "subscriber-latest": ["alert", "alert.trigger"],
+  "subscriber-resub-latest": ["alert", "alert.trigger"],
+  "subscriber-gifted-latest": ["alert", "alert.trigger"],
+  "subscriber-bomb-latest": ["alert", "alert.trigger"],
+  "follower-latest": ["alert", "alert.trigger"],
+  "cheer-latest": ["alert", "alert.trigger"],
+  "raid-latest": ["alert", "alert.trigger"],
+  "host-latest": ["alert", "alert.trigger"],
+  "redemption-latest": ["alert", "alert.trigger"],
+  "hypetrain-start": ["alert", "alert.trigger"],
+  "hypetrain-level-progress": ["alert", "alert.trigger"],
+  "hypetrain-end": ["alert", "alert.trigger"],
+  "sponsor-latest": ["alert", "alert.trigger"],
+  "member-latest": ["alert", "alert.trigger"],
+  "superchat-latest": ["alert", "alert.trigger"],
+  "kappagen-launched": ["alert", "alert.trigger"]
+};
+function listenersToLumiaEvents(listeners, listener) {
+  const keys = /* @__PURE__ */ new Set();
+  if (Array.isArray(listeners)) {
+    for (const k of listeners) if (typeof k === "string") keys.add(k);
+  } else if (listeners && typeof listeners === "object") {
+    for (const [k, v] of Object.entries(listeners)) if (v) keys.add(k);
+  }
+  if (typeof listener === "string" && listener) keys.add(listener);
+  const out = /* @__PURE__ */ new Set();
+  for (const k of keys) {
+    const mapped = SE_LISTENER_TO_LUMIA_EVENTS[k];
+    if (mapped) for (const e of mapped) out.add(e);
+  }
+  return [...out];
+}
+var SE_FIRST_PARTY_SCRIPT_RX = /^(?:https?:)?\/\/(?:[^/]+\.)?(?:streamelements\.com|lumiastream\.com)\//i;
+var EXTERNAL_SCRIPT_SRC_RX = /<script\b[^>]*\bsrc\s*=\s*["']([^"']+)["']/gi;
+var CHAT_COMMAND_VALUE_RX = /^\s*!\S+/;
+function hasExternalScriptLoader(html, js) {
+  const haystack = `${html ?? ""}
+${js ?? ""}`;
+  EXTERNAL_SCRIPT_SRC_RX.lastIndex = 0;
+  for (const m of haystack.matchAll(EXTERNAL_SCRIPT_SRC_RX)) {
+    const src = m[1]?.trim();
+    if (!src) continue;
+    if (src.startsWith("/") && !src.startsWith("//")) continue;
+    if (SE_FIRST_PARTY_SCRIPT_RX.test(src)) continue;
+    return true;
+  }
+  return false;
+}
+function hasChatCommandFieldValue(fieldData) {
+  if (!fieldData) return false;
+  for (const v of Object.values(fieldData)) {
+    if (typeof v === "string" && CHAT_COMMAND_VALUE_RX.test(v)) return true;
+  }
+  return false;
+}
 function translateConfigs(sourceFields) {
   if (!sourceFields) return [];
   return Object.entries(sourceFields).filter(([key]) => !RESERVED_FIELD_KEYS.has(key)).map(([key, f]) => {
@@ -1833,6 +1892,19 @@ function mapCustom(widget, ctx) {
   const fieldData = parse(v.fieldData) ?? v.fieldData;
   const widgetProvider = widget.provider;
   const provider = widgetProvider === "kick" || widgetProvider === "youtube" || widgetProvider === "twitch" ? widgetProvider : ctx?.provider ?? "twitch";
+  const eventsList = listenersToLumiaEvents(
+    widget.listeners,
+    widget.listener
+  );
+  const externalLoader = hasExternalScriptLoader(v.html, v.js);
+  const wantsChat = externalLoader || hasChatCommandFieldValue(fieldData);
+  if (externalLoader) {
+    if (!eventsList.includes("alert")) eventsList.push("alert");
+    if (!eventsList.includes("alert.trigger")) eventsList.push("alert.trigger");
+  }
+  if (wantsChat && !eventsList.includes("chat")) eventsList.push("chat");
+  const data = { ...fieldData ?? {} };
+  if (eventsList.length > 0) data.events = eventsList;
   return buildUnit(
     widget,
     "custom",
@@ -1848,7 +1920,7 @@ function mapCustom(widget, ctx) {
         css: v.css ?? "",
         js: v.js ?? "",
         configs: translateConfigs(fields),
-        data: fieldData ?? {},
+        data,
         flavor: "streamelements",
         // Native field on the Custom module content. The compatibility
         // shim in Embed.tsx reads this to pick the right listener-name
@@ -3958,7 +4030,7 @@ async function mirrorOneAsset(url, upload, signal, proxyAssetFetch) {
   const blob = await fetchAssetBlob(url, signal, proxyAssetFetch);
   if (signal?.aborted) throw new DOMException("Aborted", "AbortError");
   if (blob.size > MAX_MIRROR_ASSET_BYTES) {
-    throw new Error(`Asset is ${(blob.size / (1024 * 1024)).toFixed(1)} MB \u2014 over the ${MAX_MIRROR_ASSET_BYTES / (1024 * 1024)} MB import cap.`);
+    throw new Error(`Asset is ${(blob.size / (1024 * 1024)).toFixed(1)} MB, over the ${MAX_MIRROR_ASSET_BYTES / (1024 * 1024)} MB import cap.`);
   }
   const filename = filenameFromURL(url);
   const type = blob.type || guessMime(filename);
@@ -3980,7 +4052,7 @@ async function fetchAssetBlob(url, signal, proxyAssetFetch) {
     if (!res.ok) throw new Error(`Source returned HTTP ${res.status}`);
     const declared = Number(res.headers.get("content-length"));
     if (Number.isFinite(declared) && declared > MAX_MIRROR_ASSET_BYTES) {
-      throw new Error(`Asset is ${(declared / (1024 * 1024)).toFixed(1)} MB \u2014 over the ${MAX_MIRROR_ASSET_BYTES / (1024 * 1024)} MB import cap.`);
+      throw new Error(`Asset is ${(declared / (1024 * 1024)).toFixed(1)} MB, over the ${MAX_MIRROR_ASSET_BYTES / (1024 * 1024)} MB import cap.`);
     }
     return res.blob();
   }
@@ -4220,7 +4292,7 @@ function decodeJwtPayload(jwt) {
   }
   const claims = parsed;
   if (typeof claims.channel !== "string" || typeof claims.authToken !== "string") {
-    throw new SEAuthError("invalid-jwt", "Token payload is missing the 'channel' or 'authToken' claim \u2014 not a StreamElements account token.");
+    throw new SEAuthError("invalid-jwt", "Token payload is missing the 'channel' or 'authToken' claim. not a StreamElements account token.");
   }
   if (typeof claims.exp === "number" && claims.exp * 1e3 < Date.now()) {
     throw new SEAuthError("expired", "This StreamElements token has expired. Generate a new one on the SE Account page.");
@@ -4229,7 +4301,7 @@ function decodeJwtPayload(jwt) {
 }
 var SEClient = class _SEClient {
   // `jwt` is held alongside the decoded claims so the client can switch auth
-  // modes without re-parsing. Defaults to `bearer-jwt` — confirmed against
+  // modes without re-parsing. Defaults to `bearer-jwt`. confirmed against
   // the user's diagnostic 2026-05-16: every endpoint the existing 5 helpers
   // hit (users/current, channels/me, overlays, bot/commands, plus
   // sessions/loyalty/bits leaderboard transitively) returns 200, AND
@@ -4317,7 +4389,7 @@ var SEClient = class _SEClient {
       let detail = "";
       try {
         const body = await res.json();
-        if (body?.message) detail = ` \u2014 ${body.message}`;
+        if (body?.message) detail = ` - ${body.message}`;
       } catch {
       }
       throw new Error(`StreamElements API returned HTTP ${res.status}${detail}`);
@@ -4359,7 +4431,7 @@ async function fetchElementWidgetInstancePublic(channelId, widgetInstanceId, pub
     let detail = "";
     try {
       const body = JSON.parse(await result.errorBody());
-      if (body?.message) detail = ` \u2014 ${body.message}`;
+      if (body?.message) detail = ` - ${body.message}`;
     } catch {
     }
     const reason = result.status === 401 || result.status === 403 ? "StreamElements rejected the widget share token. The share link may have been revoked or made private." : result.status === 404 ? "Element widget not found. Double-check the share URL." : `HTTP ${result.status}`;
@@ -7301,15 +7373,15 @@ var PLACEHOLDER_WIDGET_TYPES = /* @__PURE__ */ new Set([
   "streamlabels"
 ]);
 var PLACEHOLDER_REASONS = {
-  donation_ticker: "No native Lumia equivalent yet \u2014 imported as a placeholder text layer.",
-  stream_boss: "Lumia has a native streamboss module \u2014 set it up directly rather than importing the SL config.",
-  credits: "Lumia has a native credits module \u2014 set it up directly rather than importing the SL config.",
-  spin_wheel: "Lumia has a native spinwheel module \u2014 set it up directly rather than importing the SL config.",
-  emote_wall: "Lumia has a native emotebox module \u2014 set it up directly rather than importing the SL config.",
-  sub_train: "No native Lumia equivalent yet \u2014 imported as a placeholder text layer.",
+  donation_ticker: "No native Lumia equivalent yet. imported as a placeholder text layer.",
+  stream_boss: "Lumia has a native streamboss module. set it up directly rather than importing the SL config.",
+  credits: "Lumia has a native credits module. set it up directly rather than importing the SL config.",
+  spin_wheel: "Lumia has a native spinwheel module. set it up directly rather than importing the SL config.",
+  emote_wall: "Lumia has a native emotebox module. set it up directly rather than importing the SL config.",
+  sub_train: "No native Lumia equivalent yet. imported as a placeholder text layer.",
   streamlabels: "Use Lumia template variables (e.g. {{twitch_last_follower}}) inside a Text module instead of importing the SL streamlabels config."
 };
-var CUSTOM_HTML_REVIEW_REASON = "The Streamlabs widget used custom HTML/CSS/JS that Lumia cannot host. The native Lumia module is the right starting point \u2014 recreate the styling there. The original SL settings are stashed under module.content.importMeta for reference.";
+var CUSTOM_HTML_REVIEW_REASON = "The Streamlabs widget used custom HTML/CSS/JS that Lumia cannot host. The native Lumia module is the right starting point. recreate the styling there. The original SL settings are stashed under module.content.importMeta for reference.";
 function stampImportMeta(module, widgetType, role, extra = {}) {
   stampImportMetaMerge(module, {
     source: "streamlabs",
@@ -7467,7 +7539,7 @@ function importStreamlabsWidget(response, widgetType, options = {}) {
     });
     reviewItems.push({
       moduleId: placeholder.module.id,
-      // SL doesn't have a single "widget" object the way SE does — we
+      // SL doesn't have a single "widget" object the way SE does. we
       // stash the settings snapshot here so the review step can show
       // the raw config the user imported. Cast through unknown because
       // ReviewItem is currently typed against SEWidget; widening the
@@ -7485,7 +7557,7 @@ function importStreamlabsWidget(response, widgetType, options = {}) {
     layers.push(placeholder.layer);
     modules[placeholder.layer.id] = placeholder.module;
     coverage.notes.push(
-      `Unknown Streamlabs widget type "${widgetType}" \u2014 imported as a placeholder.`
+      `Unknown Streamlabs widget type "${widgetType}". imported as a placeholder.`
     );
     coverage.mappings.push({
       seType: `streamlabs:${widgetType}`,
@@ -7920,7 +7992,7 @@ function StepHeader({
   ] });
 }
 var JWT_FEATURES = [
-  "All your overlays \u2014 pick one, many, or all",
+  "All your overlays: pick one, many, or all",
   "Live counters (follower / sub / tip / bits goals)",
   "Chat bot commands",
   "Loyalty points + watch time",
@@ -8074,7 +8146,7 @@ function StepModePicker({
                   }
                 )
               ] }),
-              caveat: "Requires pasting your StreamElements JWT. Stored only in memory \u2014 never sent to Lumia.",
+              caveat: "Requires pasting your StreamElements JWT. Stored only in memory. Never sent to Lumia.",
               onClick: onChooseJwt
             }
           )
@@ -8099,7 +8171,7 @@ function StepConnect({
       {
         number: 1,
         title: "Connect your StreamElements account",
-        subtitle: "Paste your StreamElements JWT to import overlays, live counters, chat commands, loyalty points, watch time, and recent events. The token is read in your browser only \u2014 Lumia never sends it to our servers."
+        subtitle: "Paste your StreamElements JWT to import overlays, live counters, chat commands, loyalty points, watch time, and recent events. The token is read in your browser only. Lumia never sends it to our servers."
       }
     ),
     /* @__PURE__ */ jsx14(
@@ -10748,15 +10820,15 @@ function importElementOverlay(response, options = {}) {
 // src/se-import/index.ts
 var IMPORT_META_KEY2 = "importMeta";
 var REVIEW_REASONS = {
-  "se-widget-bit-boss": "No native Lumia equivalent \u2014 bit boss fight bar with HP/damage states.",
+  "se-widget-bit-boss": "No native Lumia equivalent. bit boss fight bar with HP/damage states.",
   // `se-widget-hype-cup` intentionally omitted — it now routes to the native
   // `tipjar` module (see dispatcher.ts) and lands with `partial` status, so it
   // never reaches the placeholder-reason fallback. If a future feature flag
   // disables tipjar auto-import, add an entry to FLAG_OFF_REASONS instead.
-  "se-widget-media-share": "No native Lumia equivalent \u2014 viewer-submitted media player.",
-  "se-widget-contest": "No native Lumia equivalent \u2014 SE-specific contest widget.",
-  "se-widget-giveaway": "No native Lumia equivalent \u2014 SE giveaway service.",
-  "se-widget-botcounter": "No native Lumia equivalent \u2014 chatter/message counter.",
+  "se-widget-media-share": "No native Lumia equivalent. viewer-submitted media player.",
+  "se-widget-contest": "No native Lumia equivalent. SE-specific contest widget.",
+  "se-widget-giveaway": "No native Lumia equivalent. SE giveaway service.",
+  "se-widget-botcounter": "No native Lumia equivalent. chatter/message counter.",
   "se-widget-top-cheerers-list": 'Lumia loyaltyleaderboard needs a "source" extension before it can render cheer rankings.',
   "se-widget-top-gifters-list": 'Lumia loyaltyleaderboard needs a "source" extension before it can render gifter rankings.',
   "se-widget-top-tippers-list": 'Lumia loyaltyleaderboard needs a "source" extension before it can render tipper rankings.',
@@ -10766,7 +10838,7 @@ var REVIEW_REASONS = {
   // so we can't pre-populate the slideshow items. The streamer adds their
   // product images by hand in the slideshow editor. Status = 'partial' (see
   // dispatcher.ts), so this string surfaces in the review step.
-  "se-widget-merch-products-rotator": "Imported as an empty slideshow. Lumia doesn't fetch your Fourthwall product catalog yet, so add your product images manually in the slideshow editor \u2014 the layer is pre-positioned and styled to match your SE widget."
+  "se-widget-merch-products-rotator": "Imported as an empty slideshow. Lumia doesn't fetch your Fourthwall product catalog yet, so add your product images manually in the slideshow editor. the layer is pre-positioned and styled to match your SE widget."
   // Seasonal widgets (snow / halloween / halloween-2019 / xmas / valentine / easter
   // / world-cup) intentionally omitted — they route directly to image/slideshow/
   // video modules now (see dispatcher.ts SEASONAL_IMAGE_TYPES), so they always
@@ -10774,7 +10846,7 @@ var REVIEW_REASONS = {
 };
 function reasonFor(seType, status, flaggedOff) {
   if (flaggedOff && FLAG_OFF_REASONS[seType]) return FLAG_OFF_REASONS[seType];
-  return REVIEW_REASONS[seType] ?? (status === "template" ? "Imported as a generic template stub." : "No native mapping yet \u2014 imported as a labelled text placeholder.");
+  return REVIEW_REASONS[seType] ?? (status === "template" ? "Imported as a generic template stub." : "No native mapping yet. imported as a labelled text placeholder.");
 }
 function buildSEBootstrapDescription(overlayId, sourceUrl) {
   const head = overlayId ? `Imported from StreamElements overlay ${overlayId}` : "Imported from StreamElements";
@@ -10804,7 +10876,7 @@ async function fetchSEBootstrap({
 }) {
   if (!apikey) {
     throw new Error(
-      "Missing access token. Use the public preview URL (Overlay menu \u2192 Get URL \u2192 Public link) \u2014 editor URLs do not include a token."
+      "Missing access token. Use the public preview URL (Overlay menu \u2192 Get URL \u2192 Public link). editor URLs do not include a token."
     );
   }
   const result = await fetchWithProxyFallback(buildBootstrapUrl(overlayId), {
@@ -10815,7 +10887,7 @@ async function fetchSEBootstrap({
     let detail = "";
     try {
       const body = JSON.parse(await result.errorBody());
-      detail = body?.message ? ` \u2014 ${body.message}` : "";
+      detail = body?.message ? `. ${body.message}` : "";
     } catch {
     }
     const reason = result.status === 401 || result.status === 403 ? "StreamElements rejected the URL token. The preview link may have been revoked." : result.status === 404 ? "Overlay not found. Double-check the URL." : `HTTP ${result.status}`;
@@ -10957,17 +11029,17 @@ function importSEBootstrap(bootstrap, options = {}) {
   }
   if (coverage.mappings.some((m) => m.status === "placeholder")) {
     coverage.notes.push(
-      "Some widgets imported as placeholder text layers \u2014 see SE/05-widget-to-module-mapping.md for status."
+      "Some widgets imported as placeholder text layers. see SE/05-widget-to-module-mapping.md for status."
     );
   }
   if (coverage.mappings.some((m) => m.seType === "se-widget-merch-goal")) {
     coverage.notes.push(
-      "Merch-goal widgets imported as generic goals \u2014 see SE/03-missing-variables.md \xA78 for the missing data source."
+      "Merch-goal widgets imported as generic goals. see SE/03-missing-variables.md \xA78 for the missing data source."
     );
   }
   if (coverage.mappings.some((m) => m.seType === "se-widget-custom-event-list")) {
     coverage.notes.push(
-      "\u26A0 Custom widgets are experimental \u2014 they run under the SE compatibility shim (Embed.tsx) which handles most SE APIs but may not cover every edge case. Verify each custom layer renders correctly in the editor."
+      "\u26A0 Custom widgets are experimental. they run under the SE compatibility shim (Embed.tsx) which handles most SE APIs but may not cover every edge case. Verify each custom layer renders correctly in the editor."
     );
   }
   const overlay = {
@@ -11112,7 +11184,7 @@ function buildAIPromptForSEWidget(widget, canvas) {
   const fullVariables = JSON.stringify(variables, null, 2);
   const truncated = fullVariables.length > VARIABLES_BUDGET;
   const variablesJson = truncated ? `${fullVariables.slice(0, VARIABLES_BUDGET)}
-\u2026[truncated \u2014 ${fullVariables.length - VARIABLES_BUDGET} more bytes elided]` : fullVariables;
+\u2026[truncated. ${fullVariables.length - VARIABLES_BUDGET} more bytes elided]` : fullVariables;
   return [
     "Recreate a StreamElements overlay widget as a Lumia Stream custom overlay (HTML + CSS + JS).",
     "",
@@ -11120,14 +11192,14 @@ function buildAIPromptForSEWidget(widget, canvas) {
     listener ? `Primary event listener: ${listener}` : "",
     listeners ? `Subscribes to events: ${listeners.join(", ")}` : "",
     `Canvas: ${landing.width} \xD7 ${landing.height}`,
-    truncated ? "Note: the widget config below is truncated \u2014 focus on visible/structural fields and ignore tail content you cannot see." : "",
+    truncated ? "Note: the widget config below is truncated. focus on visible/structural fields and ignore tail content you cannot see." : "",
     "",
     "Widget configuration (JSON):",
     "```json",
     variablesJson,
     "```",
     "",
-    "Constraints \u2014 your output must run inside a Lumia Custom Overlay sandboxed iframe:",
+    "Constraints. your output must run inside a Lumia Custom Overlay sandboxed iframe:",
     '- Use `window.Overlay.on("alert", handler)` / `window.Overlay.on("chat", handler)` to receive Lumia events.',
     "- Lumia template variables use double-brace syntax: {{username}}, {{amount}}, {{message}}, {{currency}}.",
     "- The `window.DATA` object holds user-configurable values (mirrors your `configs`).",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumiastream/ui",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "author": "Lumia Stream",
   "license": "ISC",
   "description": "Lumia UI Kit",
@@ -128,7 +128,7 @@
     "vitest": "^4.1.6"
   },
   "dependencies": {
-    "@lumiastream/lumia-translations": "1.16.0",
+    "@lumiastream/lumia-translations": "1.16.1",
     "@lumiastream/lumia-types": "^3.3.7-alpha.2",
     "classnames": "^2.5.1",
     "globals": "^17.4.0",