@lumiastream/ui 0.2.9 → 0.3.0

package/dist/index.js

@@ -3129,7 +3129,13 @@ var SE_TO_LUMIA_PLACEHOLDER = {
   item: "firstItem.name",
   count: "amount",
   total: "total",
-  gifts: "giftAmount"
+  gifts: "giftAmount",
+  // Platform-agnostic streamer identity — SE exposes `{streamer}` in static
+  // widgets and alert bodies. Lumia has no event-scoped equivalent (it's not
+  // tied to an alert payload), so we route it at the *global* template
+  // variable `{{streamer}}` populated by VariablesManager.refreshStreamerVariable
+  // (Twitch → Kick → YouTube → Facebook → TikTok fallback chain).
+  streamer: "streamer"
 };
 var TWITCH_CONTEXTS = {
   "follower-latest": { name: "twitch_last_follower", username: "twitch_last_follower" },
@@ -4252,6 +4258,63 @@ import {
   LumiaEventListTypes,
   LumiaMapAlertTypeToEventListType
 } from "@lumiastream/lumia-types";
+
+// src/se-import/mappers/module-defaults.ts
+var CHATBOX_DEFAULT_CONTENT_FIELDS = {
+  type: "lumia",
+  src: "",
+  userLevels: [1, 2, 3, 4, 5, 6, 7, 8, 9],
+  permanent: true,
+  maxItemsToShow: 20,
+  removeAfter: 3e4,
+  animations: {
+    enterAnimation: "fadeIn",
+    exitAnimation: "fadeOut",
+    enterAnimationDuration: 1e3,
+    exitAnimationDuration: 1e3,
+    enterAnimationDelay: 0,
+    exitAnimationDelay: 0
+  },
+  ignoredList: [],
+  background: "transparent",
+  theme: "simple",
+  chatboxStreamingSite: {
+    twitch: { message: "", icon: "", themeConfig: { primaryColor: "#915dff", showUsernameColors: true } },
+    youtube: { message: "", icon: "", themeConfig: { primaryColor: "#ff0000", usePlatformColor: false } },
+    facebook: { message: "", icon: "", themeConfig: { primaryColor: "#4267B2", usePlatformColor: false } },
+    tiktok: { message: "", icon: "", themeConfig: { primaryColor: "#ff0050", usePlatformColor: false } },
+    kick: { message: "", icon: "", themeConfig: { primaryColor: "#3AD305", usePlatformColor: false } },
+    discord: { message: "", icon: "", themeConfig: { primaryColor: "#7289da", usePlatformColor: false } }
+  },
+  borderRadius: "10px",
+  bgOpacity: 0.4,
+  ignoredStreamingSites: [],
+  horizontal: false,
+  reverseFlow: false,
+  showBadges: true,
+  showSiteIcon: false,
+  showEmotes: true,
+  showAvatar: false,
+  showTimestamp: false,
+  hideAlerts: false,
+  hyperClickableLinks: true,
+  clickableChatterProfiles: false,
+  previewMediaInChat: true,
+  previewMediaUserLevels: ["streamer", "moderators", "vips", "tier3", "tier2", "subscribers", "regular", "follower", "anyone"],
+  breakLine: true,
+  fadeOutAfterDelay: false,
+  fadeOutDelayTime: 5,
+  useAnimatedEmotes: true,
+  sites: ["twitch", "kick", "youtube", "facebook", "discord", "ffz", "seventv", "bttv"],
+  border: "solid 1px transparent",
+  itemGap: 8
+};
+var CHATBOX_DEFAULT_MODULE = {
+  version: 7,
+  content: CHATBOX_DEFAULT_CONTENT_FIELDS
+};
+
+// src/se-import/mappers/misc.ts
 function mapChatboxTheme(seTheme) {
   const t = (seTheme ?? "").toString().toLowerCase();
   if (!t || t === "default") return "simple";
@@ -4311,6 +4374,8 @@ function paddingShorthand(message) {
   return `${px(t)} ${px(r)} ${px(b)} ${px(l)}`;
 }
 function mapChatbox(widget, ctx) {
+  const chatboxDefaults = CHATBOX_DEFAULT_MODULE.content;
+  const chatboxVersion = CHATBOX_DEFAULT_MODULE.version;
   const v = widget.variables ?? {};
   const textCss = widget.text?.css ?? {};
   const messageCss = textCss.message ?? {};
@@ -4345,59 +4410,58 @@ function mapChatbox(widget, ctx) {
     widget,
     "chatbox",
     {
+      // Stamp the module version from the authoritative defaults so
+      // Overlay-UI's per-module Settings.tsx migration check
+      // (`module?.version !== currentVersion`) treats this import as
+      // already-current. Without this, every freshly-imported chatbox
+      // would trip the migration toast on first open even though the
+      // content is already complete.
+      version: chatboxVersion,
       // Visual styling (font / color / padding etc) lives on module.css, not
       // content. Lumia's TextStyle settings panel + the chatbox renderer both
       // read from here.
       css: moduleCss,
       content: {
+        // `chatboxDefaults` resolves host-injected first (preferred), then
+        // the local snapshot — see the top of this function. Spreading it
+        // here guarantees every field the chatbox renderer expects is
+        // present (`type`, `sites`, `useAnimatedEmotes`, etc.); the
+        // SE-specific override block below wins for the opinions that
+        // differ from a fresh-add.
+        ...chatboxDefaults,
+        // ─── SE-specific overrides ────────────────────────────────────────
+        // The fresh-Lumia defaults assume the streamer is creating a new
+        // chatbox; SE-imported ones have opinions that differ. Override
+        // only those.
         theme: mapChatboxTheme(v.theme),
         fadeOutAfterDelay: fadeOutSeconds > 0,
         fadeOutDelayTime: fadeOutSeconds,
-        // Defaults Lumia's chatbox renderer + UI expect on every module.
-        // Without these the chatbox silently dropped messages (the
-        // `ignoredStreamingSites` truthy gate), rendered in the wrong
-        // theme (no theme → blank list), or showed missing controls in
-        // settings. `ignoredList` carries SE's per-user ignore list across.
         ignoredList: Array.isArray(v.ignored) ? v.ignored : [],
-        ignoredStreamingSites: [],
-        horizontal: false,
-        reverseFlow: false,
-        hideAlerts: false,
-        hideAlertMessage: false,
+        // SE chat widgets default to showing avatars + site icons + tight
+        // line wrapping; Lumia's fresh default is the opposite.
         showAvatar: true,
-        showBadges: true,
-        showEmotes: true,
         showSiteIcon: true,
-        showTimestamp: false,
         breakLine: false,
-        hyperClickableLinks: true,
         clickableChatterProfiles: true,
-        previewMediaInChat: true,
-        maxItemsToShow: 20,
-        removeAfter: 3e4,
-        itemGap: 8,
-        borderRadius: "10px",
-        bgOpacity: 0.4,
-        animations: {
-          enterAnimation: "fadeIn",
-          exitAnimation: "fadeOut",
-          enterAnimationDuration: 1e3,
-          exitAnimationDuration: 1e3,
-          enterAnimationDelay: 0,
-          exitAnimationDelay: 0
-        },
+        hideAlertMessage: false,
         // Carry the SE message-level font override and the streamer's
         // accent color across so the imported chatbox looks right at
         // first paint. Background lives on `module.css.background`
         // above — `content.background` was a dead write the renderer
         // never read.
         ...messageFontFamily ? { messageFontFamily } : {},
+        // Twitch primary color override — deep-merge into the full
+        // chatboxStreamingSite map from the default (otherwise we'd
+        // clobber the youtube/kick/facebook/tiktok/discord entries the
+        // chatbox renderer reads for per-platform theming).
         ...accentColor ? {
           chatboxStreamingSite: {
+            ...chatboxDefaults.chatboxStreamingSite,
             twitch: {
+              ...chatboxDefaults.chatboxStreamingSite.twitch,
               themeConfig: {
-                primaryColor: accentColor,
-                showUsernameColors: true
+                ...chatboxDefaults.chatboxStreamingSite.twitch.themeConfig,
+                primaryColor: accentColor
               }
             }
           }
@@ -8472,7 +8536,11 @@ function SEImportWizard({
       );
       mirrorAbortRef.current?.abort();
       onClose();
-      if (lastUuid) onComplete({ overlayId: lastUuid });
+      if (importsToSave.length === 1 && lastUuid) {
+        onComplete({ overlayId: lastUuid });
+      } else if (importsToSave.length > 1) {
+        onComplete({});
+      }
     } catch (error) {
       notify.error(`Import failed: ${extractErrorMessage(error)}`);
     } finally {

package/dist/se-import.d.ts

@@ -342,7 +342,7 @@ interface SEImportBindings {
         uuid: string;
     }>;
     onComplete: (result: {
-        overlayId: string;
+        overlayId?: string;
     }) => void;
     onOverlayImported?: (result: {
         overlayId: string;

package/dist/se-import.js

@@ -14,7 +14,13 @@ var SE_TO_LUMIA_PLACEHOLDER = {
   item: "firstItem.name",
   count: "amount",
   total: "total",
-  gifts: "giftAmount"
+  gifts: "giftAmount",
+  // Platform-agnostic streamer identity — SE exposes `{streamer}` in static
+  // widgets and alert bodies. Lumia has no event-scoped equivalent (it's not
+  // tied to an alert payload), so we route it at the *global* template
+  // variable `{{streamer}}` populated by VariablesManager.refreshStreamerVariable
+  // (Twitch → Kick → YouTube → Facebook → TikTok fallback chain).
+  streamer: "streamer"
 };
 var TWITCH_CONTEXTS = {
   "follower-latest": { name: "twitch_last_follower", username: "twitch_last_follower" },
@@ -1137,6 +1143,63 @@ import {
   LumiaEventListTypes,
   LumiaMapAlertTypeToEventListType
 } from "@lumiastream/lumia-types";
+
+// src/se-import/mappers/module-defaults.ts
+var CHATBOX_DEFAULT_CONTENT_FIELDS = {
+  type: "lumia",
+  src: "",
+  userLevels: [1, 2, 3, 4, 5, 6, 7, 8, 9],
+  permanent: true,
+  maxItemsToShow: 20,
+  removeAfter: 3e4,
+  animations: {
+    enterAnimation: "fadeIn",
+    exitAnimation: "fadeOut",
+    enterAnimationDuration: 1e3,
+    exitAnimationDuration: 1e3,
+    enterAnimationDelay: 0,
+    exitAnimationDelay: 0
+  },
+  ignoredList: [],
+  background: "transparent",
+  theme: "simple",
+  chatboxStreamingSite: {
+    twitch: { message: "", icon: "", themeConfig: { primaryColor: "#915dff", showUsernameColors: true } },
+    youtube: { message: "", icon: "", themeConfig: { primaryColor: "#ff0000", usePlatformColor: false } },
+    facebook: { message: "", icon: "", themeConfig: { primaryColor: "#4267B2", usePlatformColor: false } },
+    tiktok: { message: "", icon: "", themeConfig: { primaryColor: "#ff0050", usePlatformColor: false } },
+    kick: { message: "", icon: "", themeConfig: { primaryColor: "#3AD305", usePlatformColor: false } },
+    discord: { message: "", icon: "", themeConfig: { primaryColor: "#7289da", usePlatformColor: false } }
+  },
+  borderRadius: "10px",
+  bgOpacity: 0.4,
+  ignoredStreamingSites: [],
+  horizontal: false,
+  reverseFlow: false,
+  showBadges: true,
+  showSiteIcon: false,
+  showEmotes: true,
+  showAvatar: false,
+  showTimestamp: false,
+  hideAlerts: false,
+  hyperClickableLinks: true,
+  clickableChatterProfiles: false,
+  previewMediaInChat: true,
+  previewMediaUserLevels: ["streamer", "moderators", "vips", "tier3", "tier2", "subscribers", "regular", "follower", "anyone"],
+  breakLine: true,
+  fadeOutAfterDelay: false,
+  fadeOutDelayTime: 5,
+  useAnimatedEmotes: true,
+  sites: ["twitch", "kick", "youtube", "facebook", "discord", "ffz", "seventv", "bttv"],
+  border: "solid 1px transparent",
+  itemGap: 8
+};
+var CHATBOX_DEFAULT_MODULE = {
+  version: 7,
+  content: CHATBOX_DEFAULT_CONTENT_FIELDS
+};
+
+// src/se-import/mappers/misc.ts
 function mapChatboxTheme(seTheme) {
   const t = (seTheme ?? "").toString().toLowerCase();
   if (!t || t === "default") return "simple";
@@ -1196,6 +1259,8 @@ function paddingShorthand(message) {
   return `${px(t)} ${px(r)} ${px(b)} ${px(l)}`;
 }
 function mapChatbox(widget, ctx) {
+  const chatboxDefaults = CHATBOX_DEFAULT_MODULE.content;
+  const chatboxVersion = CHATBOX_DEFAULT_MODULE.version;
   const v = widget.variables ?? {};
   const textCss = widget.text?.css ?? {};
   const messageCss = textCss.message ?? {};
@@ -1230,59 +1295,58 @@ function mapChatbox(widget, ctx) {
     widget,
     "chatbox",
     {
+      // Stamp the module version from the authoritative defaults so
+      // Overlay-UI's per-module Settings.tsx migration check
+      // (`module?.version !== currentVersion`) treats this import as
+      // already-current. Without this, every freshly-imported chatbox
+      // would trip the migration toast on first open even though the
+      // content is already complete.
+      version: chatboxVersion,
       // Visual styling (font / color / padding etc) lives on module.css, not
       // content. Lumia's TextStyle settings panel + the chatbox renderer both
       // read from here.
       css: moduleCss,
       content: {
+        // `chatboxDefaults` resolves host-injected first (preferred), then
+        // the local snapshot — see the top of this function. Spreading it
+        // here guarantees every field the chatbox renderer expects is
+        // present (`type`, `sites`, `useAnimatedEmotes`, etc.); the
+        // SE-specific override block below wins for the opinions that
+        // differ from a fresh-add.
+        ...chatboxDefaults,
+        // ─── SE-specific overrides ────────────────────────────────────────
+        // The fresh-Lumia defaults assume the streamer is creating a new
+        // chatbox; SE-imported ones have opinions that differ. Override
+        // only those.
         theme: mapChatboxTheme(v.theme),
         fadeOutAfterDelay: fadeOutSeconds > 0,
         fadeOutDelayTime: fadeOutSeconds,
-        // Defaults Lumia's chatbox renderer + UI expect on every module.
-        // Without these the chatbox silently dropped messages (the
-        // `ignoredStreamingSites` truthy gate), rendered in the wrong
-        // theme (no theme → blank list), or showed missing controls in
-        // settings. `ignoredList` carries SE's per-user ignore list across.
         ignoredList: Array.isArray(v.ignored) ? v.ignored : [],
-        ignoredStreamingSites: [],
-        horizontal: false,
-        reverseFlow: false,
-        hideAlerts: false,
-        hideAlertMessage: false,
+        // SE chat widgets default to showing avatars + site icons + tight
+        // line wrapping; Lumia's fresh default is the opposite.
         showAvatar: true,
-        showBadges: true,
-        showEmotes: true,
         showSiteIcon: true,
-        showTimestamp: false,
         breakLine: false,
-        hyperClickableLinks: true,
         clickableChatterProfiles: true,
-        previewMediaInChat: true,
-        maxItemsToShow: 20,
-        removeAfter: 3e4,
-        itemGap: 8,
-        borderRadius: "10px",
-        bgOpacity: 0.4,
-        animations: {
-          enterAnimation: "fadeIn",
-          exitAnimation: "fadeOut",
-          enterAnimationDuration: 1e3,
-          exitAnimationDuration: 1e3,
-          enterAnimationDelay: 0,
-          exitAnimationDelay: 0
-        },
+        hideAlertMessage: false,
         // Carry the SE message-level font override and the streamer's
         // accent color across so the imported chatbox looks right at
         // first paint. Background lives on `module.css.background`
         // above — `content.background` was a dead write the renderer
         // never read.
         ...messageFontFamily ? { messageFontFamily } : {},
+        // Twitch primary color override — deep-merge into the full
+        // chatboxStreamingSite map from the default (otherwise we'd
+        // clobber the youtube/kick/facebook/tiktok/discord entries the
+        // chatbox renderer reads for per-platform theming).
         ...accentColor ? {
           chatboxStreamingSite: {
+            ...chatboxDefaults.chatboxStreamingSite,
             twitch: {
+              ...chatboxDefaults.chatboxStreamingSite.twitch,
               themeConfig: {
-                primaryColor: accentColor,
-                showUsernameColors: true
+                ...chatboxDefaults.chatboxStreamingSite.twitch.themeConfig,
+                primaryColor: accentColor
               }
             }
           }
@@ -7342,7 +7406,11 @@ function SEImportWizard({
       );
       mirrorAbortRef.current?.abort();
       onClose();
-      if (lastUuid) onComplete({ overlayId: lastUuid });
+      if (importsToSave.length === 1 && lastUuid) {
+        onComplete({ overlayId: lastUuid });
+      } else if (importsToSave.length > 1) {
+        onComplete({});
+      }
     } catch (error) {
       notify.error(`Import failed: ${extractErrorMessage(error)}`);
     } finally {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@lumiastream/ui",
-	"version": "0.2.9",
+	"version": "0.3.0",
 	"author": "Lumia Stream",
 	"license": "ISC",
 	"description": "Lumia UI Kit",
@@ -91,7 +91,8 @@
 		"test:watch": "vitest",
 		"release": "changeset && changeset tag && npm run build && npm publish",
 		"prepublishOnly": "npm run build",
-		"postpublish": "npm cache clean --force && node ./scripts/postpublish-install.mjs"
+		"postpublish": "npm cache clean --force && node ./scripts/postpublish-install.mjs",
+		"check-module-defaults": "tsx scripts/check-module-defaults.ts"
 	},
 	"peerDependencies": {
 		"@codemirror/autocomplete": "^6.0.0",
@@ -121,12 +122,13 @@
 		"sass-embedded": "^1.99.0",
 		"storybook": "^10.2.17",
 		"tsup": "^8.5.1",
+		"tsx": "^4.22.3",
 		"typescript": "^5.9.3",
 		"vite": "^8.0.8",
 		"vitest": "^4.1.6"
 	},
 	"dependencies": {
-		"@lumiastream/lumia-translations": "1.15.8",
+		"@lumiastream/lumia-translations": "1.15.9",
 		"@lumiastream/lumia-types": "^3.3.7-alpha.2",
 		"classnames": "^2.5.1",
 		"globals": "^17.4.0",