@lumiastream/ui 0.2.8-alpha.26 → 0.2.8-alpha.28

package/dist/index.js

@@ -3133,31 +3133,86 @@ var SE_TO_LUMIA_PLACEHOLDER = {
 };
 var TWITCH_CONTEXTS = {
   "follower-latest": { name: "twitch_last_follower", username: "twitch_last_follower" },
+  // Three SE listeners with genuinely distinct semantics — preserve the
+  // distinction in the variable mapping so a widget configured for "Latest
+  // new subscriber" doesn't render the latest *resub* (and vice versa).
+  // `subscriber-latest` is the umbrella (anyone subscribing); the other two
+  // are subtype-specific. The dedicated TWITCH_LAST_{NEW_SUBSCRIBER,
+  // RESUBSCRIBER} variables are written by the Twitch event pipeline on
+  // the matching sub.type event.
   "subscriber-latest": { name: "twitch_last_subscriber", username: "twitch_last_subscriber" },
-  "subscriber-new-latest": { name: "twitch_last_subscriber", username: "twitch_last_subscriber" },
-  "subscriber-resub-latest": { name: "twitch_last_subscriber", username: "twitch_last_subscriber" },
-  "subscriber-gifted-latest": { name: "twitch_last_gifter", username: "twitch_last_gifter", amount: "twitch_last_gifter_amount", count: "twitch_last_gifter_amount" },
+  "subscriber-new-latest": { name: "twitch_last_new_subscriber", username: "twitch_last_new_subscriber" },
+  "subscriber-resub-latest": { name: "twitch_last_resubscriber", username: "twitch_last_resubscriber" },
+  // `subscriber-gifted-latest`: SE uses `{sender}` for the giver and `{name}` for
+  // the recipient (e.g. "{sender} gifted to {name}"). The two roles must point
+  // at distinct Lumia variables — collapsing both onto `twitch_last_gifter`
+  // rendered "Mr.Beast gifted to Mr.Beast" while the actual recipient was
+  // nowhere. `sender` keeps the gifter; `name` / `username` switch to the
+  // dedicated recipient variable `twitch_last_gifted`. Amount stays on the
+  // gifter (it's the count of subs in that drop, owned by the gifter).
+  "subscriber-gifted-latest": { name: "twitch_last_gifted", username: "twitch_last_gifted", sender: "twitch_last_gifter", amount: "twitch_last_gifter_amount", count: "twitch_last_gifter_amount" },
   "subscriber-alltime-gifter": { name: "twitch_alltime_top_gifter", username: "twitch_alltime_top_gifter", amount: "twitch_alltime_top_gifter_amount", count: "twitch_alltime_top_gifter_amount" },
   "cheer-latest": { name: "twitch_last_bit", username: "twitch_last_bit", amount: "twitch_last_bit_amount", count: "twitch_last_bit_amount" },
   "tip-latest": { name: "latest_donator", username: "latest_donator", amount: "latest_donator_amount", count: "latest_donator_amount", currency: "latest_donator_currency_symbol" },
   latest_donator: { name: "latest_donator", username: "latest_donator", amount: "latest_donator_amount", count: "latest_donator_amount", currency: "latest_donator_currency_symbol" },
   "raid-latest": { name: "twitch_last_raider", username: "twitch_last_raider", amount: "twitch_last_raid_amount", count: "twitch_last_raid_amount" },
-  // Session counters: count/amount = the running session count.
+  // Period counters: count/amount = the running counter for that window.
+  // SE lets the streamer pick session / week / month / total on the same widget
+  // type; the chosen period lands in `widget.listener` (e.g. `cheer-week`).
+  // Each entry below mirrors a row in the Lumia variables table — the previous
+  // table only carried session+total and broke any widget configured for
+  // week/month because `{amount}` fell through to the unscoped placeholder
+  // and rendered blank.
   "follower-session": { amount: "twitch_session_follower_count", count: "twitch_session_follower_count" },
-  "subscriber-session": { amount: "twitch_session_subscribers_count", count: "twitch_session_subscribers_count" },
-  "cheer-session": { amount: "twitch_session_bits_count", count: "twitch_session_bits_count" },
-  "tip-session": { amount: "session_donation_amount", count: "session_donation_count", currency: "session_donation_amount_currency_symbol" },
-  // Totals (all-time): count/amount = total counter.
+  "follower-week": { amount: "twitch_week_follower_count", count: "twitch_week_follower_count" },
+  "follower-month": { amount: "twitch_month_follower_count", count: "twitch_month_follower_count" },
   "follower-total": { amount: "twitch_total_follower_count", count: "twitch_total_follower_count" },
+  "subscriber-session": { amount: "twitch_session_subscribers_count", count: "twitch_session_subscribers_count" },
+  "subscriber-week": { amount: "twitch_week_subscriber_count", count: "twitch_week_subscriber_count" },
+  "subscriber-month": { amount: "twitch_month_subscriber_count", count: "twitch_month_subscriber_count" },
   "subscriber-total": { amount: "twitch_total_subscriber_count", count: "twitch_total_subscriber_count" },
+  "subscriber-new-session": { amount: "twitch_session_new_subscribers_count", count: "twitch_session_new_subscribers_count" },
+  "subscriber-resub-session": { amount: "twitch_session_resub_subscribers_count", count: "twitch_session_resub_subscribers_count" },
+  "subscriber-gifted-session": { amount: "twitch_session_gifted_subscribers_count", count: "twitch_session_gifted_subscribers_count" },
+  "cheer-session": { amount: "twitch_session_bits_count", count: "twitch_session_bits_count" },
+  "cheer-week": { amount: "twitch_week_bits_count", count: "twitch_week_bits_count" },
+  "cheer-month": { amount: "twitch_month_bits_count", count: "twitch_month_bits_count" },
   "cheer-total": { amount: "twitch_total_bits_count", count: "twitch_total_bits_count" },
+  "tip-session": { amount: "session_donation_amount", count: "session_donation_count", currency: "session_donation_amount_currency_symbol" },
+  "tip-week": { amount: "week_donation_amount", count: "week_donation_count", currency: "week_donation_amount_currency_symbol" },
+  "tip-month": { amount: "month_donation_amount", count: "month_donation_count", currency: "month_donation_amount_currency_symbol" },
   "tip-total": { amount: "total_donation_amount", count: "total_donation_amount", currency: "total_donation_amount_currency_symbol" },
   "tip-count": { amount: "donation_count", count: "donation_count" },
-  // Top cheer / cheerer / donator session readouts.
-  "cheer-session-top-donation": { amount: "twitch_session_top_cheer_amount", count: "twitch_session_top_cheer_amount" },
+  // Top cheer / cheerer / donator readouts — per period. SE's `se-widget-top-*`
+  // widgets encode the chosen period (session / weekly / monthly / alltime) in
+  // the widget's `listener` field. Without these entries the user's `{amount}`
+  // / `{name}` template tokens fall through to the unscoped placeholder map
+  // (`{{amount}}` only resolves inside alert variations) and render blank.
+  //
+  // `*-top-donation` and `*-top-donator` are paired: SE nominally treats them
+  // as "top single event" vs "top cumulative contributor", but the data
+  // rendered for both lives in the same Lumia variable pair (`*_top_donator`
+  // / `*_top_donator_amount`, `twitch_*_top_cheerer` / `..._amount`). SE
+  // widgets routinely use `{name}` against the `-donation` listener to mean
+  // "the user who made the top donation", so the two rows below carry the
+  // same name/username mapping — anything else falls through to the unscoped
+  // `{{username}}` and renders blank.
+  "cheer-session-top-donation": { name: "twitch_session_top_cheerer", username: "twitch_session_top_cheerer", amount: "twitch_session_top_cheer_amount", count: "twitch_session_top_cheer_amount" },
   "cheer-session-top-donator": { name: "twitch_session_top_cheerer", username: "twitch_session_top_cheerer", amount: "twitch_session_top_cheerer_amount", count: "twitch_session_top_cheerer_amount" },
-  "tip-session-top-donation": { amount: "session_top_donator_amount", count: "session_top_donator_amount", currency: "session_top_donator_currency_symbol" },
+  "cheer-weekly-top-donation": { name: "twitch_week_top_cheerer", username: "twitch_week_top_cheerer", amount: "twitch_week_top_cheerer_amount", count: "twitch_week_top_cheerer_amount" },
+  "cheer-weekly-top-donator": { name: "twitch_week_top_cheerer", username: "twitch_week_top_cheerer", amount: "twitch_week_top_cheerer_amount", count: "twitch_week_top_cheerer_amount" },
+  "cheer-monthly-top-donation": { name: "twitch_month_top_cheerer", username: "twitch_month_top_cheerer", amount: "twitch_month_top_cheerer_amount", count: "twitch_month_top_cheerer_amount" },
+  "cheer-monthly-top-donator": { name: "twitch_month_top_cheerer", username: "twitch_month_top_cheerer", amount: "twitch_month_top_cheerer_amount", count: "twitch_month_top_cheerer_amount" },
+  "cheer-alltime-top-donation": { name: "twitch_alltime_top_cheerer", username: "twitch_alltime_top_cheerer", amount: "twitch_alltime_top_cheerer_amount", count: "twitch_alltime_top_cheerer_amount" },
+  "cheer-alltime-top-donator": { name: "twitch_alltime_top_cheerer", username: "twitch_alltime_top_cheerer", amount: "twitch_alltime_top_cheerer_amount", count: "twitch_alltime_top_cheerer_amount" },
+  "tip-session-top-donation": { name: "session_top_donator", username: "session_top_donator", amount: "session_top_donator_amount", count: "session_top_donator_amount", currency: "session_top_donator_currency_symbol" },
   "tip-session-top-donator": { name: "session_top_donator", username: "session_top_donator", amount: "session_top_donator_amount", count: "session_top_donator_amount", currency: "session_top_donator_currency_symbol" },
+  "tip-weekly-top-donation": { name: "week_top_donator", username: "week_top_donator", amount: "week_top_donator_amount", count: "week_top_donator_amount", currency: "week_top_donator_currency_symbol" },
+  "tip-weekly-top-donator": { name: "week_top_donator", username: "week_top_donator", amount: "week_top_donator_amount", count: "week_top_donator_amount", currency: "week_top_donator_currency_symbol" },
+  "tip-monthly-top-donation": { name: "month_top_donator", username: "month_top_donator", amount: "month_top_donator_amount", count: "month_top_donator_amount", currency: "month_top_donator_currency_symbol" },
+  "tip-monthly-top-donator": { name: "month_top_donator", username: "month_top_donator", amount: "month_top_donator_amount", count: "month_top_donator_amount", currency: "month_top_donator_currency_symbol" },
+  "tip-alltime-top-donation": { name: "top_donator", username: "top_donator", amount: "top_donator_amount", count: "top_donator_amount", currency: "top_donator_currency_symbol" },
+  "tip-alltime-top-donator": { name: "top_donator", username: "top_donator", amount: "top_donator_amount", count: "top_donator_amount", currency: "top_donator_currency_symbol" },
   // Botcounter — SE uses `{wins}` for the running chat count; the dispatcher's
   // fallbackVar for `se-widget-botcounter` is `twitch_session_chat_count`, so
   // when the listener arg lands as that var name we treat it as the wins source.
@@ -3194,7 +3249,11 @@ var KICK_CONTEXTS = {
   "subscriber-latest": { name: "kick_last_subscriber", username: "kick_last_subscriber" },
   "subscriber-new-latest": { name: "kick_last_subscriber", username: "kick_last_subscriber" },
   "subscriber-resub-latest": { name: "kick_last_subscriber", username: "kick_last_subscriber" },
-  "subscriber-gifted-latest": { name: "kick_last_gifter", username: "kick_last_gifter", amount: "kick_last_gifter_amount", count: "kick_last_gifter_amount" },
+  // Mirror the Twitch split: `{sender}` = giver, `{name}` = recipient.
+  // `kick_last_gifted` was added alongside this mapping; see twitch context
+  // above for the rationale (without the split, SE's "{sender} gifted to
+  // {name}" renders the gifter on both sides).
+  "subscriber-gifted-latest": { name: "kick_last_gifted", username: "kick_last_gifted", sender: "kick_last_gifter", amount: "kick_last_gifter_amount", count: "kick_last_gifter_amount" },
   "cheer-latest": { name: "kick_last_kicks", username: "kick_last_kicks", amount: "kick_last_kicks_amount", count: "kick_last_kicks_amount" },
   "raid-latest": { name: "kick_last_host", username: "kick_last_host", amount: "kick_last_host_amount", count: "kick_last_host_amount" },
   "follower-session": { amount: "kick_session_follower_count", count: "kick_session_follower_count" },
@@ -3226,9 +3285,17 @@ var YOUTUBE_CONTEXTS = {
   "subscriber-week": { amount: "youtube_week_member_count", count: "youtube_week_member_count" },
   "subscriber-month": { amount: "youtube_month_member_count", count: "youtube_month_member_count" }
 };
+var RECENT_TO_LATEST_LISTENER = {
+  "follower-recent": "follower-latest",
+  "subscriber-recent": "subscriber-latest",
+  "cheer-recent": "cheer-latest",
+  "tip-recent": "tip-latest",
+  "raid-recent": "raid-latest"
+};
 function listenerPlaceholderContext(listener, provider = "twitch") {
+  const resolved = RECENT_TO_LATEST_LISTENER[listener] ?? listener;
   const platformTable = provider === "kick" ? KICK_CONTEXTS : provider === "youtube" ? YOUTUBE_CONTEXTS : null;
-  return platformTable?.[listener] ?? TWITCH_CONTEXTS[listener] ?? {};
+  return platformTable?.[resolved] ?? TWITCH_CONTEXTS[resolved] ?? {};
 }
 var SE_WIDGET_TYPE_LABELS = {
   "subscriber-latest": "Latest subscriber",
@@ -3264,12 +3331,13 @@ function defaultLabelForSEWidget(widget) {
   const tail = words.slice(1).join(" ");
   return tail ? `${head} ${tail}` : head;
 }
-function translateSeText(input, listener, passthrough, provider) {
+function translateSeText(input, listener, passthrough, provider, options) {
   if (!input) return "";
   const ctx = listener ? listenerPlaceholderContext(listener, provider) : {};
+  const useAlertFallback = (options?.context ?? "alert") === "alert";
   return input.replace(/\{([a-zA-Z][a-zA-Z0-9_.]*)\}/g, (_match, raw) => {
     if (passthrough?.has(raw)) return `{{${raw}}}`;
-    const mapped = ctx[raw] ?? SE_TO_LUMIA_PLACEHOLDER[raw] ?? raw;
+    const mapped = ctx[raw] ?? (useAlertFallback ? SE_TO_LUMIA_PLACEHOLDER[raw] : void 0) ?? raw;
     return `{{${mapped}}}`;
   });
 }
@@ -3313,14 +3381,15 @@ var YOUTUBE_LISTENER_VARS = {
 };
 function listenerToLumiaVariable(listener, provider = "twitch") {
   if (typeof listener !== "string" || !listener) return "username";
-  if (provider === "kick" && KICK_LISTENER_VARS[listener]) return KICK_LISTENER_VARS[listener];
-  if (provider === "youtube" && YOUTUBE_LISTENER_VARS[listener]) return YOUTUBE_LISTENER_VARS[listener];
+  const resolvedListener = RECENT_TO_LATEST_LISTENER[listener] ?? listener;
+  if (provider === "kick" && KICK_LISTENER_VARS[resolvedListener]) return KICK_LISTENER_VARS[resolvedListener];
+  if (provider === "youtube" && YOUTUBE_LISTENER_VARS[resolvedListener]) return YOUTUBE_LISTENER_VARS[resolvedListener];
   const m = {
     // Latest events
     "follower-latest": "twitch_last_follower",
     "subscriber-latest": "twitch_last_subscriber",
-    "subscriber-new-latest": "twitch_last_subscriber",
-    "subscriber-resub-latest": "twitch_last_subscriber",
+    "subscriber-new-latest": "twitch_last_new_subscriber",
+    "subscriber-resub-latest": "twitch_last_resubscriber",
     "subscriber-gifted-latest": "twitch_last_gifter",
     "subscriber-alltime-gifter": "twitch_alltime_top_gifter",
     "tip-latest": "latest_donator",
@@ -3371,7 +3440,7 @@ function listenerToLumiaVariable(listener, provider = "twitch") {
     "cheer-alltime-top-donation": "twitch_alltime_top_cheerer_amount",
     "cheer-alltime-top-donator": "twitch_alltime_top_cheerer"
   };
-  return m[listener] ?? listener.replace(/-/g, "_");
+  return m[resolvedListener] ?? resolvedListener.replace(/-/g, "_");
 }
 function seCssToBounds(css, defaults = { width: 600, height: 200 }, canvas) {
   let widthIsAuto = false;
@@ -3475,9 +3544,16 @@ var LUMIA_DEFAULT_SIZES = {
   // just the card if they want SE's exact footprint.
   songrequest: { width: 480, height: 380 }
 };
-function translateVariationCondition(seType, seCondition, requirement) {
+function translateVariationCondition(seType, seCondition, requirement, seEventType) {
   if (seType === "gift") return { conditionType: "IS_GIFT", condition: 1 };
   if (seType === "communityGift") return { conditionType: "GIFT_SUB_GREATER", condition: requirement ?? 0 };
+  const isSubscriberEvent = seEventType === "subscriber";
+  if (isSubscriberEvent && seCondition === "ATLEAST" && requirement != null) {
+    return { conditionType: "SUBSCRIBED_MONTHS_GREATER", condition: requirement };
+  }
+  if (isSubscriberEvent && seCondition === "EXACT" && requirement != null) {
+    return { conditionType: "SUBSCRIBED_MONTHS_EQUAL", condition: requirement };
+  }
   if (seCondition === "EXACT" && requirement != null) return { conditionType: "EQUAL_NUMBER", condition: requirement };
   if (seCondition === "ATLEAST" && requirement != null) {
     return { conditionType: "GREATER_NUMBER", condition: requirement };
@@ -3577,7 +3653,7 @@ function seExtraTextCss(seCss, scrolling) {
   return extra;
 }
 function mapText(widget, ctx) {
-  const value = translateSeText(widget.text?.value ?? "");
+  const value = translateSeText(widget.text?.value ?? "", null, void 0, ctx?.provider, { context: "static" });
   const seCss = widget.text?.css ?? {};
   return buildUnit(widget, "text", {
     content: {
@@ -3634,7 +3710,7 @@ function mapReadout(widget, fallbackVar, ctx) {
   const variable = listenerToLumiaVariable(listener, ctx?.provider);
   const userTemplate = widget.text?.value ?? "";
   const inheritsText = userTemplate.trim().length > 0 && /\{[a-zA-Z]/.test(userTemplate);
-  const value = inheritsText ? translateSeText(userTemplate, listener, void 0, ctx?.provider) : `{{${variable}}}`;
+  const value = inheritsText ? translateSeText(userTemplate, listener, void 0, ctx?.provider, { context: "static" }) : `{{${variable}}}`;
   const seCss = widget.text?.css ?? {};
   return buildUnit(widget, "text", {
     content: { value, highlightColor: "inherit" },
@@ -3889,7 +3965,7 @@ function buildAlertEvent(seEvent, seEventType) {
   };
 }
 function buildAlertVariation(v, seEventType, parentSettings) {
-  const translated = translateVariationCondition(v.type ?? null, v.condition ?? null, v.requirement ?? null);
+  const translated = translateVariationCondition(v.type ?? null, v.condition ?? null, v.requirement ?? null, seEventType);
   if (!translated) return null;
   const { variations: _parentVariations, ...parentInheritable } = parentSettings ?? {};
   const mergedSettings = deepMergeSeSettings(parentSettings ? parentInheritable : void 0, v.settings);
@@ -4025,7 +4101,8 @@ function mapGoal(widget, ctx) {
       // live `current` floating at the percentage position. See
       // components/Modules/Views/Goal/types.ts:GoalTypes.SLIM.
       type: "slim",
-      label: translateSeText(v.title ?? "Goal"),
+      // Static label rendered above the goal bar — not an alert context.
+      label: translateSeText(v.title ?? "Goal", null, void 0, void 0, { context: "static" }),
       subLabel: "",
       // The Goal module renders this template literal with {{current}} + {{goal}} substituted.
       // Charity goals track donation amounts — prefix `$` so the rendered bar reads
@@ -4342,6 +4419,9 @@ function mapEventList(widget, ctx) {
   const filters = computeListenerFilters(widget.listeners, widget.listener);
   const maxItems = v.visibleEvents ?? v.visibleItems ?? 5;
   return buildUnit(widget, "eventlist", {
+    // SE event-list widgets style per-event lines via widget.text.css; the
+    // Lumia eventlist reads font/size/color from module.css.
+    css: mapSeTextCssToModuleCss(widget, { fontSize: 18 }),
     content: {
       theme: v.theme ?? "simple",
       direction: v.direction ?? "top",
@@ -4625,7 +4705,7 @@ function mapTimer(widget, ctx) {
   const v = widget.variables ?? {};
   const textValue = typeof widget.text?.value === "string" ? widget.text.value : void 0;
   const TIMER_PASSTHROUGH = /* @__PURE__ */ new Set(["days", "hours", "minutes", "seconds"]);
-  const mapTemplate = (template) => translateSeText(template, null, TIMER_PASSTHROUGH);
+  const mapTemplate = (template) => translateSeText(template, null, TIMER_PASSTHROUGH, void 0, { context: "static" });
   const absoluteDate = v.date ?? v.endsAt ?? v.endDate;
   const target = absoluteDate ? Date.parse(absoluteDate) : NaN;
   const hasValidAbsoluteDate = Number.isFinite(target);
@@ -4697,7 +4777,7 @@ function mapTimer(widget, ctx) {
       endAnimation: "",
       hideAfter: 0,
       highlightColor: "inherit",
-      messageAfterCountdown: translateSeText(v.messageAfterCountdown ?? ""),
+      messageAfterCountdown: translateSeText(v.messageAfterCountdown ?? "", null, void 0, void 0, { context: "static" }),
       changeMessageAfter: !!v.changeMessageAfterCountdown,
       countDate: hasValidAbsoluteDate && (!!v.exactTime || !!v.datePicker || !!absoluteDate),
       date: hasValidAbsoluteDate ? new Date(target).toISOString() : "",
@@ -4775,14 +4855,10 @@ function mapMediaShare(widget, ctx) {
       // `durationSeconds + grace`).
       importMeta: buildImportMeta(widget, { timeLeft: v.timeLeft === true })
     },
-    css: {
-      fontFamily: "Roboto",
-      fontWeight: "bold",
-      color: "#ffffff",
-      textShadow: "rgb(0, 0, 0) 1px 1px 1px",
-      background: "transparent",
-      fontSize: 18
-    }
+    // Lumia songrequest renders the queue list as styled text; pull SE's
+    // widget.text.css so font/size/color carry across (defaults match the
+    // previous hardcoded fallbacks for this widget specifically).
+    css: mapSeTextCssToModuleCss(widget, { fontSize: 18 })
   }, ctx);
 }
 function mapKappagen(widget, ctx) {
@@ -4844,25 +4920,47 @@ function mapKappagen(widget, ctx) {
     ctx
   );
 }
-function mapLeaderboardFromVariables(widget, currency, ctx) {
+var TOP_LIST_SORT_BY = {
+  tips: "higherDonations",
+  cheers: "higherBits",
+  gifts: "higherGifts"
+};
+var TOP_LIST_TITLE = {
+  tips: "Top Tippers",
+  cheers: "Top Cheerers",
+  gifts: "Top Gifters"
+};
+function mapViewerProfilesLeaderboard(widget, currency, ctx) {
   const v = widget.variables ?? {};
   const count = v.limit ?? v.visibleItems ?? 10;
-  const window = v.period === "weekly" ? "week" : v.period === "monthly" ? "month" : "alltime";
-  const title = currency === "tips" ? "Top Tippers" : currency === "cheers" ? "Top Cheerers" : "Top Gifters";
-  return buildUnit(widget, "loyaltyleaderboard", {
+  return buildUnit(widget, "viewerprofiles", {
+    // Carry SE text styling so the leaderboard keeps the streamer's
+    // chosen font / size / color.
+    css: mapSeTextCssToModuleCss(widget, { fontSize: 18 }),
     content: {
-      source: "variables",
-      currency,
-      window,
+      sortBy: TOP_LIST_SORT_BY[currency],
       count,
-      title,
+      title: TOP_LIST_TITLE[currency],
       showTitle: true,
-      showHeader: false,
-      showCurrentPoints: false,
-      showAllTimePoints: true,
+      showAvatar: true,
+      showPlatform: true,
+      // Hide noisy columns that aren't relevant for a single-metric
+      // top-X list — the streamer picked "top by gifts/tips/cheers"
+      // for a reason. They can re-enable in Settings if they want.
+      showCommands: false,
+      showAlerts: false,
+      showBits: currency === "cheers",
+      showLastSeen: false,
+      showTopActivity: false,
+      showAchievements: false,
+      showAchievementProgress: false,
+      refreshIntervalSeconds: 30,
       itemGap: 8,
+      autoScroll: false,
       // Source-side knobs that don't map cleanly survive under the
-      // generic importMeta envelope so the user can re-introspect.
+      // generic importMeta envelope so the user can re-introspect later.
+      // `period` is interesting because viewerprofiles doesn't yet have
+      // a windowed mode — if/when it does, we can promote this.
       importMeta: buildImportMeta(widget, {
         period: v.period,
         offset: v.offset,
@@ -4876,6 +4974,8 @@ function mapGiveaway(widget, ctx) {
   const primary = v.colors?.primary ?? "#393853";
   const accent = v.colors?.accent ?? "#FF4076";
   return buildUnit(widget, "raffle", {
+    // Raffle renders entrants/winner text via module.css.
+    css: mapSeTextCssToModuleCss(widget),
     content: {
       version: 1,
       type: "basic",
@@ -4960,6 +5060,9 @@ function isHypetrainCustomWidget(widget) {
 function mapHypetrain(widget, ctx) {
   const v = widget.variables ?? {};
   return buildUnit(widget, "hypetrain", {
+    // Hypetrain renders level / progress / contributor text — carry SE
+    // styling so an imported hype-train widget keeps its font + accent.
+    css: mapSeTextCssToModuleCss(widget),
     content: {
       // Twitch-native is the right default — SE hype-train widgets always
       // reflected the Twitch native train. Users can flip to 'synthetic'
@@ -5003,6 +5106,47 @@ function mapHypetrain(widget, ctx) {
     }
   }, ctx);
 }
+function mapEmoteWall(widget, ctx) {
+  const v = widget.variables ?? {};
+  const imageSize = typeof v.emoteSize === "number" ? v.emoteSize : typeof v.size === "number" ? v.size : 40;
+  const maxItemsToShow = typeof v.maxEmotes === "number" && v.maxEmotes > 0 ? v.maxEmotes : typeof v.maxItems === "number" && v.maxItems > 0 ? v.maxItems : 40;
+  const duration = typeof v.duration === "number" && v.duration > 0 ? v.duration : typeof v.decay === "number" && v.decay > 0 ? v.decay : typeof v.decayTime === "number" && v.decayTime > 0 ? v.decayTime : 5;
+  const sites = [];
+  if (v.enableTwitch !== false && v.twitch !== false) sites.push("twitch");
+  if (v.enableBttv !== false && v.bttv !== false) sites.push("bttv");
+  if (v.enableFfz !== false && v.ffz !== false) sites.push("ffz");
+  if (v.enable7tv !== false && v.sevenTv !== false) sites.push("seventv");
+  const animationType = v.direction === "up" ? "rise" : v.direction === "down" ? "fall" : v.direction === "left" || v.direction === "right" ? "slide" : "random";
+  return buildUnit(widget, "emotebox", {
+    content: {
+      version: 1,
+      type: animationType,
+      imageSize,
+      animationTime: duration,
+      duration,
+      maxItemsToShow,
+      delay: typeof v.delay === "number" ? v.delay : 0,
+      sites,
+      background: "transparent",
+      theme: "dark",
+      userLevels: [1, 2, 3, 4, 5, 6, 7, 8, 9],
+      ignoredList: [],
+      excludedAnimations: [],
+      // Emote-wall is chat-driven, not alert-driven — leave alert toggles
+      // off so the widget doesn't double-fire on subscribe/follower events.
+      alertOn: false,
+      alertTriggers: [],
+      alertEmotes: [],
+      alertNumberEmotes: 30,
+      useAnimatedEmotes: true,
+      importMeta: buildImportMeta(widget, {
+        fullscreen: !!v.fullscreen,
+        direction: v.direction
+      })
+    },
+    css: { background: "transparent" }
+  }, ctx);
+}
 function mapUnsupportedAsText(widget, ctx) {
   return buildUnit(widget, "text", {
     content: {
@@ -5352,6 +5496,23 @@ var GOAL_TYPES = /* @__PURE__ */ new Set([
   "se-widget-merch-goal"
 ]);
 var EVENTLIST_TYPES = /* @__PURE__ */ new Set(["se-widget-event-list", "se-widget-follower-recent", "se-widget-subscriber-recent", "se-widget-cheer-recent", "se-widget-tip-recent"]);
+var SCROLLING_RECENT_TYPES = /* @__PURE__ */ new Set([
+  "se-widget-follower-recent",
+  "se-widget-subscriber-recent",
+  "se-widget-cheer-recent",
+  "se-widget-tip-recent"
+]);
+var RECENT_TO_LATEST_FALLBACK_VAR = {
+  "se-widget-follower-recent": "twitch_last_follower",
+  "se-widget-subscriber-recent": "twitch_last_subscriber",
+  "se-widget-cheer-recent": "twitch_last_bit",
+  "se-widget-tip-recent": "latest_donator"
+};
+function isScrollingRecentWidget(widget) {
+  if (!SCROLLING_RECENT_TYPES.has(widget.type)) return false;
+  const scrolling = widget.text?.scrolling;
+  return !!(scrolling && typeof scrolling === "object" && scrolling.enabled === true);
+}
 function dispatch(widget, ctx) {
   const t = widget.type;
   console.log("[SE-IMPORT] dispatch widget", {
@@ -5380,16 +5541,21 @@ function dispatch(widget, ctx) {
   if (t === "se-widget-donor-drive-alert") return { unit: mapSingleAlert(widget, "donordrive-donation", ctx), status: "direct", lumiaType: "alert" };
   if (t === "se-widget-extralife-alert") return { unit: mapSingleAlert(widget, "extralife-donation", ctx), status: "direct", lumiaType: "alert" };
   if (t === "se-widget-tiltify-alert") return { unit: mapSingleAlert(widget, "tiltify-campaignDonation", ctx), status: "direct", lumiaType: "alert" };
+  if (isScrollingRecentWidget(widget)) {
+    const fallbackVar = RECENT_TO_LATEST_FALLBACK_VAR[t] ?? "username";
+    return { unit: mapReadout(widget, fallbackVar, ctx), status: "direct", lumiaType: "text" };
+  }
   if (EVENTLIST_TYPES.has(t)) return { unit: mapEventList(widget, ctx), status: "direct", lumiaType: "eventlist" };
-  if (t === "se-widget-top-tippers-list") return { unit: mapLeaderboardFromVariables(widget, "tips", ctx), status: "direct", lumiaType: "loyaltyleaderboard" };
-  if (t === "se-widget-top-cheerers-list") return { unit: mapLeaderboardFromVariables(widget, "cheers", ctx), status: "direct", lumiaType: "loyaltyleaderboard" };
-  if (t === "se-widget-top-gifters-list") return { unit: mapLeaderboardFromVariables(widget, "gifts", ctx), status: "direct", lumiaType: "loyaltyleaderboard" };
+  if (t === "se-widget-top-tippers-list") return { unit: mapViewerProfilesLeaderboard(widget, "tips", ctx), status: "direct", lumiaType: "viewerprofiles" };
+  if (t === "se-widget-top-cheerers-list") return { unit: mapViewerProfilesLeaderboard(widget, "cheers", ctx), status: "direct", lumiaType: "viewerprofiles" };
+  if (t === "se-widget-top-gifters-list") return { unit: mapViewerProfilesLeaderboard(widget, "gifts", ctx), status: "direct", lumiaType: "viewerprofiles" };
   if (t === "se-widget-credit-roll") return { unit: mapCredits(widget, ctx), status: "partial", lumiaType: "credits" };
   if (t === "se-widget-twitch-chat") return { unit: mapChatbox(widget, ctx), status: "partial", lumiaType: "chatbox" };
   if (t === "se-widget-image-rotator" || t === "se-widget-merch-products-rotator") return { unit: mapSlideshow(widget, ctx), status: t === "se-widget-merch-products-rotator" ? "partial" : "direct", lumiaType: "slideshow" };
   if (t === "se-widget-countdown") return { unit: mapTimer(widget, ctx), status: "partial", lumiaType: "timer" };
   if (t === "se-widget-current-song") return { unit: mapNowPlaying(widget, ctx), status: "partial", lumiaType: "nowplaying" };
   if (t === "se-widget-kappagen") return { unit: mapKappagen(widget, ctx), status: "partial", lumiaType: "emotealert" };
+  if (t === "se-widget-emote-wall") return { unit: mapEmoteWall(widget, ctx), status: "partial", lumiaType: "emotebox" };
   if (t === "se-widget-giveaway") return { unit: mapGiveaway(widget, ctx), status: "direct", lumiaType: "raffle" };
   if (t === "se-widget-media-share") return { unit: mapMediaShare(widget, ctx), status: "partial", lumiaType: "songrequest" };
   if (t === "se-widget-hype-cup") return { unit: mapHypeCup(widget, ctx), status: "partial", lumiaType: "tipjar" };

package/dist/se-import.js

@@ -18,31 +18,86 @@ var SE_TO_LUMIA_PLACEHOLDER = {
 };
 var TWITCH_CONTEXTS = {
   "follower-latest": { name: "twitch_last_follower", username: "twitch_last_follower" },
+  // Three SE listeners with genuinely distinct semantics — preserve the
+  // distinction in the variable mapping so a widget configured for "Latest
+  // new subscriber" doesn't render the latest *resub* (and vice versa).
+  // `subscriber-latest` is the umbrella (anyone subscribing); the other two
+  // are subtype-specific. The dedicated TWITCH_LAST_{NEW_SUBSCRIBER,
+  // RESUBSCRIBER} variables are written by the Twitch event pipeline on
+  // the matching sub.type event.
   "subscriber-latest": { name: "twitch_last_subscriber", username: "twitch_last_subscriber" },
-  "subscriber-new-latest": { name: "twitch_last_subscriber", username: "twitch_last_subscriber" },
-  "subscriber-resub-latest": { name: "twitch_last_subscriber", username: "twitch_last_subscriber" },
-  "subscriber-gifted-latest": { name: "twitch_last_gifter", username: "twitch_last_gifter", amount: "twitch_last_gifter_amount", count: "twitch_last_gifter_amount" },
+  "subscriber-new-latest": { name: "twitch_last_new_subscriber", username: "twitch_last_new_subscriber" },
+  "subscriber-resub-latest": { name: "twitch_last_resubscriber", username: "twitch_last_resubscriber" },
+  // `subscriber-gifted-latest`: SE uses `{sender}` for the giver and `{name}` for
+  // the recipient (e.g. "{sender} gifted to {name}"). The two roles must point
+  // at distinct Lumia variables — collapsing both onto `twitch_last_gifter`
+  // rendered "Mr.Beast gifted to Mr.Beast" while the actual recipient was
+  // nowhere. `sender` keeps the gifter; `name` / `username` switch to the
+  // dedicated recipient variable `twitch_last_gifted`. Amount stays on the
+  // gifter (it's the count of subs in that drop, owned by the gifter).
+  "subscriber-gifted-latest": { name: "twitch_last_gifted", username: "twitch_last_gifted", sender: "twitch_last_gifter", amount: "twitch_last_gifter_amount", count: "twitch_last_gifter_amount" },
   "subscriber-alltime-gifter": { name: "twitch_alltime_top_gifter", username: "twitch_alltime_top_gifter", amount: "twitch_alltime_top_gifter_amount", count: "twitch_alltime_top_gifter_amount" },
   "cheer-latest": { name: "twitch_last_bit", username: "twitch_last_bit", amount: "twitch_last_bit_amount", count: "twitch_last_bit_amount" },
   "tip-latest": { name: "latest_donator", username: "latest_donator", amount: "latest_donator_amount", count: "latest_donator_amount", currency: "latest_donator_currency_symbol" },
   latest_donator: { name: "latest_donator", username: "latest_donator", amount: "latest_donator_amount", count: "latest_donator_amount", currency: "latest_donator_currency_symbol" },
   "raid-latest": { name: "twitch_last_raider", username: "twitch_last_raider", amount: "twitch_last_raid_amount", count: "twitch_last_raid_amount" },
-  // Session counters: count/amount = the running session count.
+  // Period counters: count/amount = the running counter for that window.
+  // SE lets the streamer pick session / week / month / total on the same widget
+  // type; the chosen period lands in `widget.listener` (e.g. `cheer-week`).
+  // Each entry below mirrors a row in the Lumia variables table — the previous
+  // table only carried session+total and broke any widget configured for
+  // week/month because `{amount}` fell through to the unscoped placeholder
+  // and rendered blank.
   "follower-session": { amount: "twitch_session_follower_count", count: "twitch_session_follower_count" },
-  "subscriber-session": { amount: "twitch_session_subscribers_count", count: "twitch_session_subscribers_count" },
-  "cheer-session": { amount: "twitch_session_bits_count", count: "twitch_session_bits_count" },
-  "tip-session": { amount: "session_donation_amount", count: "session_donation_count", currency: "session_donation_amount_currency_symbol" },
-  // Totals (all-time): count/amount = total counter.
+  "follower-week": { amount: "twitch_week_follower_count", count: "twitch_week_follower_count" },
+  "follower-month": { amount: "twitch_month_follower_count", count: "twitch_month_follower_count" },
   "follower-total": { amount: "twitch_total_follower_count", count: "twitch_total_follower_count" },
+  "subscriber-session": { amount: "twitch_session_subscribers_count", count: "twitch_session_subscribers_count" },
+  "subscriber-week": { amount: "twitch_week_subscriber_count", count: "twitch_week_subscriber_count" },
+  "subscriber-month": { amount: "twitch_month_subscriber_count", count: "twitch_month_subscriber_count" },
   "subscriber-total": { amount: "twitch_total_subscriber_count", count: "twitch_total_subscriber_count" },
+  "subscriber-new-session": { amount: "twitch_session_new_subscribers_count", count: "twitch_session_new_subscribers_count" },
+  "subscriber-resub-session": { amount: "twitch_session_resub_subscribers_count", count: "twitch_session_resub_subscribers_count" },
+  "subscriber-gifted-session": { amount: "twitch_session_gifted_subscribers_count", count: "twitch_session_gifted_subscribers_count" },
+  "cheer-session": { amount: "twitch_session_bits_count", count: "twitch_session_bits_count" },
+  "cheer-week": { amount: "twitch_week_bits_count", count: "twitch_week_bits_count" },
+  "cheer-month": { amount: "twitch_month_bits_count", count: "twitch_month_bits_count" },
   "cheer-total": { amount: "twitch_total_bits_count", count: "twitch_total_bits_count" },
+  "tip-session": { amount: "session_donation_amount", count: "session_donation_count", currency: "session_donation_amount_currency_symbol" },
+  "tip-week": { amount: "week_donation_amount", count: "week_donation_count", currency: "week_donation_amount_currency_symbol" },
+  "tip-month": { amount: "month_donation_amount", count: "month_donation_count", currency: "month_donation_amount_currency_symbol" },
   "tip-total": { amount: "total_donation_amount", count: "total_donation_amount", currency: "total_donation_amount_currency_symbol" },
   "tip-count": { amount: "donation_count", count: "donation_count" },
-  // Top cheer / cheerer / donator session readouts.
-  "cheer-session-top-donation": { amount: "twitch_session_top_cheer_amount", count: "twitch_session_top_cheer_amount" },
+  // Top cheer / cheerer / donator readouts — per period. SE's `se-widget-top-*`
+  // widgets encode the chosen period (session / weekly / monthly / alltime) in
+  // the widget's `listener` field. Without these entries the user's `{amount}`
+  // / `{name}` template tokens fall through to the unscoped placeholder map
+  // (`{{amount}}` only resolves inside alert variations) and render blank.
+  //
+  // `*-top-donation` and `*-top-donator` are paired: SE nominally treats them
+  // as "top single event" vs "top cumulative contributor", but the data
+  // rendered for both lives in the same Lumia variable pair (`*_top_donator`
+  // / `*_top_donator_amount`, `twitch_*_top_cheerer` / `..._amount`). SE
+  // widgets routinely use `{name}` against the `-donation` listener to mean
+  // "the user who made the top donation", so the two rows below carry the
+  // same name/username mapping — anything else falls through to the unscoped
+  // `{{username}}` and renders blank.
+  "cheer-session-top-donation": { name: "twitch_session_top_cheerer", username: "twitch_session_top_cheerer", amount: "twitch_session_top_cheer_amount", count: "twitch_session_top_cheer_amount" },
   "cheer-session-top-donator": { name: "twitch_session_top_cheerer", username: "twitch_session_top_cheerer", amount: "twitch_session_top_cheerer_amount", count: "twitch_session_top_cheerer_amount" },
-  "tip-session-top-donation": { amount: "session_top_donator_amount", count: "session_top_donator_amount", currency: "session_top_donator_currency_symbol" },
+  "cheer-weekly-top-donation": { name: "twitch_week_top_cheerer", username: "twitch_week_top_cheerer", amount: "twitch_week_top_cheerer_amount", count: "twitch_week_top_cheerer_amount" },
+  "cheer-weekly-top-donator": { name: "twitch_week_top_cheerer", username: "twitch_week_top_cheerer", amount: "twitch_week_top_cheerer_amount", count: "twitch_week_top_cheerer_amount" },
+  "cheer-monthly-top-donation": { name: "twitch_month_top_cheerer", username: "twitch_month_top_cheerer", amount: "twitch_month_top_cheerer_amount", count: "twitch_month_top_cheerer_amount" },
+  "cheer-monthly-top-donator": { name: "twitch_month_top_cheerer", username: "twitch_month_top_cheerer", amount: "twitch_month_top_cheerer_amount", count: "twitch_month_top_cheerer_amount" },
+  "cheer-alltime-top-donation": { name: "twitch_alltime_top_cheerer", username: "twitch_alltime_top_cheerer", amount: "twitch_alltime_top_cheerer_amount", count: "twitch_alltime_top_cheerer_amount" },
+  "cheer-alltime-top-donator": { name: "twitch_alltime_top_cheerer", username: "twitch_alltime_top_cheerer", amount: "twitch_alltime_top_cheerer_amount", count: "twitch_alltime_top_cheerer_amount" },
+  "tip-session-top-donation": { name: "session_top_donator", username: "session_top_donator", amount: "session_top_donator_amount", count: "session_top_donator_amount", currency: "session_top_donator_currency_symbol" },
   "tip-session-top-donator": { name: "session_top_donator", username: "session_top_donator", amount: "session_top_donator_amount", count: "session_top_donator_amount", currency: "session_top_donator_currency_symbol" },
+  "tip-weekly-top-donation": { name: "week_top_donator", username: "week_top_donator", amount: "week_top_donator_amount", count: "week_top_donator_amount", currency: "week_top_donator_currency_symbol" },
+  "tip-weekly-top-donator": { name: "week_top_donator", username: "week_top_donator", amount: "week_top_donator_amount", count: "week_top_donator_amount", currency: "week_top_donator_currency_symbol" },
+  "tip-monthly-top-donation": { name: "month_top_donator", username: "month_top_donator", amount: "month_top_donator_amount", count: "month_top_donator_amount", currency: "month_top_donator_currency_symbol" },
+  "tip-monthly-top-donator": { name: "month_top_donator", username: "month_top_donator", amount: "month_top_donator_amount", count: "month_top_donator_amount", currency: "month_top_donator_currency_symbol" },
+  "tip-alltime-top-donation": { name: "top_donator", username: "top_donator", amount: "top_donator_amount", count: "top_donator_amount", currency: "top_donator_currency_symbol" },
+  "tip-alltime-top-donator": { name: "top_donator", username: "top_donator", amount: "top_donator_amount", count: "top_donator_amount", currency: "top_donator_currency_symbol" },
   // Botcounter — SE uses `{wins}` for the running chat count; the dispatcher's
   // fallbackVar for `se-widget-botcounter` is `twitch_session_chat_count`, so
   // when the listener arg lands as that var name we treat it as the wins source.
@@ -79,7 +134,11 @@ var KICK_CONTEXTS = {
   "subscriber-latest": { name: "kick_last_subscriber", username: "kick_last_subscriber" },
   "subscriber-new-latest": { name: "kick_last_subscriber", username: "kick_last_subscriber" },
   "subscriber-resub-latest": { name: "kick_last_subscriber", username: "kick_last_subscriber" },
-  "subscriber-gifted-latest": { name: "kick_last_gifter", username: "kick_last_gifter", amount: "kick_last_gifter_amount", count: "kick_last_gifter_amount" },
+  // Mirror the Twitch split: `{sender}` = giver, `{name}` = recipient.
+  // `kick_last_gifted` was added alongside this mapping; see twitch context
+  // above for the rationale (without the split, SE's "{sender} gifted to
+  // {name}" renders the gifter on both sides).
+  "subscriber-gifted-latest": { name: "kick_last_gifted", username: "kick_last_gifted", sender: "kick_last_gifter", amount: "kick_last_gifter_amount", count: "kick_last_gifter_amount" },
   "cheer-latest": { name: "kick_last_kicks", username: "kick_last_kicks", amount: "kick_last_kicks_amount", count: "kick_last_kicks_amount" },
   "raid-latest": { name: "kick_last_host", username: "kick_last_host", amount: "kick_last_host_amount", count: "kick_last_host_amount" },
   "follower-session": { amount: "kick_session_follower_count", count: "kick_session_follower_count" },
@@ -111,9 +170,17 @@ var YOUTUBE_CONTEXTS = {
   "subscriber-week": { amount: "youtube_week_member_count", count: "youtube_week_member_count" },
   "subscriber-month": { amount: "youtube_month_member_count", count: "youtube_month_member_count" }
 };
+var RECENT_TO_LATEST_LISTENER = {
+  "follower-recent": "follower-latest",
+  "subscriber-recent": "subscriber-latest",
+  "cheer-recent": "cheer-latest",
+  "tip-recent": "tip-latest",
+  "raid-recent": "raid-latest"
+};
 function listenerPlaceholderContext(listener, provider = "twitch") {
+  const resolved = RECENT_TO_LATEST_LISTENER[listener] ?? listener;
   const platformTable = provider === "kick" ? KICK_CONTEXTS : provider === "youtube" ? YOUTUBE_CONTEXTS : null;
-  return platformTable?.[listener] ?? TWITCH_CONTEXTS[listener] ?? {};
+  return platformTable?.[resolved] ?? TWITCH_CONTEXTS[resolved] ?? {};
 }
 var SE_WIDGET_TYPE_LABELS = {
   "subscriber-latest": "Latest subscriber",
@@ -149,12 +216,13 @@ function defaultLabelForSEWidget(widget) {
   const tail = words.slice(1).join(" ");
   return tail ? `${head} ${tail}` : head;
 }
-function translateSeText(input, listener, passthrough, provider) {
+function translateSeText(input, listener, passthrough, provider, options) {
   if (!input) return "";
   const ctx = listener ? listenerPlaceholderContext(listener, provider) : {};
+  const useAlertFallback = (options?.context ?? "alert") === "alert";
   return input.replace(/\{([a-zA-Z][a-zA-Z0-9_.]*)\}/g, (_match, raw) => {
     if (passthrough?.has(raw)) return `{{${raw}}}`;
-    const mapped = ctx[raw] ?? SE_TO_LUMIA_PLACEHOLDER[raw] ?? raw;
+    const mapped = ctx[raw] ?? (useAlertFallback ? SE_TO_LUMIA_PLACEHOLDER[raw] : void 0) ?? raw;
     return `{{${mapped}}}`;
   });
 }
@@ -198,14 +266,15 @@ var YOUTUBE_LISTENER_VARS = {
 };
 function listenerToLumiaVariable(listener, provider = "twitch") {
   if (typeof listener !== "string" || !listener) return "username";
-  if (provider === "kick" && KICK_LISTENER_VARS[listener]) return KICK_LISTENER_VARS[listener];
-  if (provider === "youtube" && YOUTUBE_LISTENER_VARS[listener]) return YOUTUBE_LISTENER_VARS[listener];
+  const resolvedListener = RECENT_TO_LATEST_LISTENER[listener] ?? listener;
+  if (provider === "kick" && KICK_LISTENER_VARS[resolvedListener]) return KICK_LISTENER_VARS[resolvedListener];
+  if (provider === "youtube" && YOUTUBE_LISTENER_VARS[resolvedListener]) return YOUTUBE_LISTENER_VARS[resolvedListener];
   const m = {
     // Latest events
     "follower-latest": "twitch_last_follower",
     "subscriber-latest": "twitch_last_subscriber",
-    "subscriber-new-latest": "twitch_last_subscriber",
-    "subscriber-resub-latest": "twitch_last_subscriber",
+    "subscriber-new-latest": "twitch_last_new_subscriber",
+    "subscriber-resub-latest": "twitch_last_resubscriber",
     "subscriber-gifted-latest": "twitch_last_gifter",
     "subscriber-alltime-gifter": "twitch_alltime_top_gifter",
     "tip-latest": "latest_donator",
@@ -256,7 +325,7 @@ function listenerToLumiaVariable(listener, provider = "twitch") {
     "cheer-alltime-top-donation": "twitch_alltime_top_cheerer_amount",
     "cheer-alltime-top-donator": "twitch_alltime_top_cheerer"
   };
-  return m[listener] ?? listener.replace(/-/g, "_");
+  return m[resolvedListener] ?? resolvedListener.replace(/-/g, "_");
 }
 function seCssToBounds(css, defaults = { width: 600, height: 200 }, canvas) {
   let widthIsAuto = false;
@@ -360,9 +429,16 @@ var LUMIA_DEFAULT_SIZES = {
   // just the card if they want SE's exact footprint.
   songrequest: { width: 480, height: 380 }
 };
-function translateVariationCondition(seType, seCondition, requirement) {
+function translateVariationCondition(seType, seCondition, requirement, seEventType) {
   if (seType === "gift") return { conditionType: "IS_GIFT", condition: 1 };
   if (seType === "communityGift") return { conditionType: "GIFT_SUB_GREATER", condition: requirement ?? 0 };
+  const isSubscriberEvent = seEventType === "subscriber";
+  if (isSubscriberEvent && seCondition === "ATLEAST" && requirement != null) {
+    return { conditionType: "SUBSCRIBED_MONTHS_GREATER", condition: requirement };
+  }
+  if (isSubscriberEvent && seCondition === "EXACT" && requirement != null) {
+    return { conditionType: "SUBSCRIBED_MONTHS_EQUAL", condition: requirement };
+  }
   if (seCondition === "EXACT" && requirement != null) return { conditionType: "EQUAL_NUMBER", condition: requirement };
   if (seCondition === "ATLEAST" && requirement != null) {
     return { conditionType: "GREATER_NUMBER", condition: requirement };
@@ -462,7 +538,7 @@ function seExtraTextCss(seCss, scrolling) {
   return extra;
 }
 function mapText(widget, ctx) {
-  const value = translateSeText(widget.text?.value ?? "");
+  const value = translateSeText(widget.text?.value ?? "", null, void 0, ctx?.provider, { context: "static" });
   const seCss = widget.text?.css ?? {};
   return buildUnit(widget, "text", {
     content: {
@@ -519,7 +595,7 @@ function mapReadout(widget, fallbackVar, ctx) {
   const variable = listenerToLumiaVariable(listener, ctx?.provider);
   const userTemplate = widget.text?.value ?? "";
   const inheritsText = userTemplate.trim().length > 0 && /\{[a-zA-Z]/.test(userTemplate);
-  const value = inheritsText ? translateSeText(userTemplate, listener, void 0, ctx?.provider) : `{{${variable}}}`;
+  const value = inheritsText ? translateSeText(userTemplate, listener, void 0, ctx?.provider, { context: "static" }) : `{{${variable}}}`;
   const seCss = widget.text?.css ?? {};
   return buildUnit(widget, "text", {
     content: { value, highlightColor: "inherit" },
@@ -774,7 +850,7 @@ function buildAlertEvent(seEvent, seEventType) {
   };
 }
 function buildAlertVariation(v, seEventType, parentSettings) {
-  const translated = translateVariationCondition(v.type ?? null, v.condition ?? null, v.requirement ?? null);
+  const translated = translateVariationCondition(v.type ?? null, v.condition ?? null, v.requirement ?? null, seEventType);
   if (!translated) return null;
   const { variations: _parentVariations, ...parentInheritable } = parentSettings ?? {};
   const mergedSettings = deepMergeSeSettings(parentSettings ? parentInheritable : void 0, v.settings);
@@ -910,7 +986,8 @@ function mapGoal(widget, ctx) {
       // live `current` floating at the percentage position. See
       // components/Modules/Views/Goal/types.ts:GoalTypes.SLIM.
       type: "slim",
-      label: translateSeText(v.title ?? "Goal"),
+      // Static label rendered above the goal bar — not an alert context.
+      label: translateSeText(v.title ?? "Goal", null, void 0, void 0, { context: "static" }),
       subLabel: "",
       // The Goal module renders this template literal with {{current}} + {{goal}} substituted.
       // Charity goals track donation amounts — prefix `$` so the rendered bar reads
@@ -1227,6 +1304,9 @@ function mapEventList(widget, ctx) {
   const filters = computeListenerFilters(widget.listeners, widget.listener);
   const maxItems = v.visibleEvents ?? v.visibleItems ?? 5;
   return buildUnit(widget, "eventlist", {
+    // SE event-list widgets style per-event lines via widget.text.css; the
+    // Lumia eventlist reads font/size/color from module.css.
+    css: mapSeTextCssToModuleCss(widget, { fontSize: 18 }),
     content: {
       theme: v.theme ?? "simple",
       direction: v.direction ?? "top",
@@ -1510,7 +1590,7 @@ function mapTimer(widget, ctx) {
   const v = widget.variables ?? {};
   const textValue = typeof widget.text?.value === "string" ? widget.text.value : void 0;
   const TIMER_PASSTHROUGH = /* @__PURE__ */ new Set(["days", "hours", "minutes", "seconds"]);
-  const mapTemplate = (template) => translateSeText(template, null, TIMER_PASSTHROUGH);
+  const mapTemplate = (template) => translateSeText(template, null, TIMER_PASSTHROUGH, void 0, { context: "static" });
   const absoluteDate = v.date ?? v.endsAt ?? v.endDate;
   const target = absoluteDate ? Date.parse(absoluteDate) : NaN;
   const hasValidAbsoluteDate = Number.isFinite(target);
@@ -1582,7 +1662,7 @@ function mapTimer(widget, ctx) {
       endAnimation: "",
       hideAfter: 0,
       highlightColor: "inherit",
-      messageAfterCountdown: translateSeText(v.messageAfterCountdown ?? ""),
+      messageAfterCountdown: translateSeText(v.messageAfterCountdown ?? "", null, void 0, void 0, { context: "static" }),
       changeMessageAfter: !!v.changeMessageAfterCountdown,
       countDate: hasValidAbsoluteDate && (!!v.exactTime || !!v.datePicker || !!absoluteDate),
       date: hasValidAbsoluteDate ? new Date(target).toISOString() : "",
@@ -1660,14 +1740,10 @@ function mapMediaShare(widget, ctx) {
       // `durationSeconds + grace`).
       importMeta: buildImportMeta(widget, { timeLeft: v.timeLeft === true })
     },
-    css: {
-      fontFamily: "Roboto",
-      fontWeight: "bold",
-      color: "#ffffff",
-      textShadow: "rgb(0, 0, 0) 1px 1px 1px",
-      background: "transparent",
-      fontSize: 18
-    }
+    // Lumia songrequest renders the queue list as styled text; pull SE's
+    // widget.text.css so font/size/color carry across (defaults match the
+    // previous hardcoded fallbacks for this widget specifically).
+    css: mapSeTextCssToModuleCss(widget, { fontSize: 18 })
   }, ctx);
 }
 function mapKappagen(widget, ctx) {
@@ -1729,25 +1805,47 @@ function mapKappagen(widget, ctx) {
     ctx
   );
 }
-function mapLeaderboardFromVariables(widget, currency, ctx) {
+var TOP_LIST_SORT_BY = {
+  tips: "higherDonations",
+  cheers: "higherBits",
+  gifts: "higherGifts"
+};
+var TOP_LIST_TITLE = {
+  tips: "Top Tippers",
+  cheers: "Top Cheerers",
+  gifts: "Top Gifters"
+};
+function mapViewerProfilesLeaderboard(widget, currency, ctx) {
   const v = widget.variables ?? {};
   const count = v.limit ?? v.visibleItems ?? 10;
-  const window = v.period === "weekly" ? "week" : v.period === "monthly" ? "month" : "alltime";
-  const title = currency === "tips" ? "Top Tippers" : currency === "cheers" ? "Top Cheerers" : "Top Gifters";
-  return buildUnit(widget, "loyaltyleaderboard", {
+  return buildUnit(widget, "viewerprofiles", {
+    // Carry SE text styling so the leaderboard keeps the streamer's
+    // chosen font / size / color.
+    css: mapSeTextCssToModuleCss(widget, { fontSize: 18 }),
     content: {
-      source: "variables",
-      currency,
-      window,
+      sortBy: TOP_LIST_SORT_BY[currency],
       count,
-      title,
+      title: TOP_LIST_TITLE[currency],
       showTitle: true,
-      showHeader: false,
-      showCurrentPoints: false,
-      showAllTimePoints: true,
+      showAvatar: true,
+      showPlatform: true,
+      // Hide noisy columns that aren't relevant for a single-metric
+      // top-X list — the streamer picked "top by gifts/tips/cheers"
+      // for a reason. They can re-enable in Settings if they want.
+      showCommands: false,
+      showAlerts: false,
+      showBits: currency === "cheers",
+      showLastSeen: false,
+      showTopActivity: false,
+      showAchievements: false,
+      showAchievementProgress: false,
+      refreshIntervalSeconds: 30,
       itemGap: 8,
+      autoScroll: false,
       // Source-side knobs that don't map cleanly survive under the
-      // generic importMeta envelope so the user can re-introspect.
+      // generic importMeta envelope so the user can re-introspect later.
+      // `period` is interesting because viewerprofiles doesn't yet have
+      // a windowed mode — if/when it does, we can promote this.
       importMeta: buildImportMeta(widget, {
         period: v.period,
         offset: v.offset,
@@ -1761,6 +1859,8 @@ function mapGiveaway(widget, ctx) {
   const primary = v.colors?.primary ?? "#393853";
   const accent = v.colors?.accent ?? "#FF4076";
   return buildUnit(widget, "raffle", {
+    // Raffle renders entrants/winner text via module.css.
+    css: mapSeTextCssToModuleCss(widget),
     content: {
       version: 1,
       type: "basic",
@@ -1845,6 +1945,9 @@ function isHypetrainCustomWidget(widget) {
 function mapHypetrain(widget, ctx) {
   const v = widget.variables ?? {};
   return buildUnit(widget, "hypetrain", {
+    // Hypetrain renders level / progress / contributor text — carry SE
+    // styling so an imported hype-train widget keeps its font + accent.
+    css: mapSeTextCssToModuleCss(widget),
     content: {
       // Twitch-native is the right default — SE hype-train widgets always
       // reflected the Twitch native train. Users can flip to 'synthetic'
@@ -1888,6 +1991,47 @@ function mapHypetrain(widget, ctx) {
     }
   }, ctx);
 }
+function mapEmoteWall(widget, ctx) {
+  const v = widget.variables ?? {};
+  const imageSize = typeof v.emoteSize === "number" ? v.emoteSize : typeof v.size === "number" ? v.size : 40;
+  const maxItemsToShow = typeof v.maxEmotes === "number" && v.maxEmotes > 0 ? v.maxEmotes : typeof v.maxItems === "number" && v.maxItems > 0 ? v.maxItems : 40;
+  const duration = typeof v.duration === "number" && v.duration > 0 ? v.duration : typeof v.decay === "number" && v.decay > 0 ? v.decay : typeof v.decayTime === "number" && v.decayTime > 0 ? v.decayTime : 5;
+  const sites = [];
+  if (v.enableTwitch !== false && v.twitch !== false) sites.push("twitch");
+  if (v.enableBttv !== false && v.bttv !== false) sites.push("bttv");
+  if (v.enableFfz !== false && v.ffz !== false) sites.push("ffz");
+  if (v.enable7tv !== false && v.sevenTv !== false) sites.push("seventv");
+  const animationType = v.direction === "up" ? "rise" : v.direction === "down" ? "fall" : v.direction === "left" || v.direction === "right" ? "slide" : "random";
+  return buildUnit(widget, "emotebox", {
+    content: {
+      version: 1,
+      type: animationType,
+      imageSize,
+      animationTime: duration,
+      duration,
+      maxItemsToShow,
+      delay: typeof v.delay === "number" ? v.delay : 0,
+      sites,
+      background: "transparent",
+      theme: "dark",
+      userLevels: [1, 2, 3, 4, 5, 6, 7, 8, 9],
+      ignoredList: [],
+      excludedAnimations: [],
+      // Emote-wall is chat-driven, not alert-driven — leave alert toggles
+      // off so the widget doesn't double-fire on subscribe/follower events.
+      alertOn: false,
+      alertTriggers: [],
+      alertEmotes: [],
+      alertNumberEmotes: 30,
+      useAnimatedEmotes: true,
+      importMeta: buildImportMeta(widget, {
+        fullscreen: !!v.fullscreen,
+        direction: v.direction
+      })
+    },
+    css: { background: "transparent" }
+  }, ctx);
+}
 function mapUnsupportedAsText(widget, ctx) {
   return buildUnit(widget, "text", {
     content: {
@@ -2237,6 +2381,23 @@ var GOAL_TYPES = /* @__PURE__ */ new Set([
   "se-widget-merch-goal"
 ]);
 var EVENTLIST_TYPES = /* @__PURE__ */ new Set(["se-widget-event-list", "se-widget-follower-recent", "se-widget-subscriber-recent", "se-widget-cheer-recent", "se-widget-tip-recent"]);
+var SCROLLING_RECENT_TYPES = /* @__PURE__ */ new Set([
+  "se-widget-follower-recent",
+  "se-widget-subscriber-recent",
+  "se-widget-cheer-recent",
+  "se-widget-tip-recent"
+]);
+var RECENT_TO_LATEST_FALLBACK_VAR = {
+  "se-widget-follower-recent": "twitch_last_follower",
+  "se-widget-subscriber-recent": "twitch_last_subscriber",
+  "se-widget-cheer-recent": "twitch_last_bit",
+  "se-widget-tip-recent": "latest_donator"
+};
+function isScrollingRecentWidget(widget) {
+  if (!SCROLLING_RECENT_TYPES.has(widget.type)) return false;
+  const scrolling = widget.text?.scrolling;
+  return !!(scrolling && typeof scrolling === "object" && scrolling.enabled === true);
+}
 function dispatch(widget, ctx) {
   const t = widget.type;
   console.log("[SE-IMPORT] dispatch widget", {
@@ -2265,16 +2426,21 @@ function dispatch(widget, ctx) {
   if (t === "se-widget-donor-drive-alert") return { unit: mapSingleAlert(widget, "donordrive-donation", ctx), status: "direct", lumiaType: "alert" };
   if (t === "se-widget-extralife-alert") return { unit: mapSingleAlert(widget, "extralife-donation", ctx), status: "direct", lumiaType: "alert" };
   if (t === "se-widget-tiltify-alert") return { unit: mapSingleAlert(widget, "tiltify-campaignDonation", ctx), status: "direct", lumiaType: "alert" };
+  if (isScrollingRecentWidget(widget)) {
+    const fallbackVar = RECENT_TO_LATEST_FALLBACK_VAR[t] ?? "username";
+    return { unit: mapReadout(widget, fallbackVar, ctx), status: "direct", lumiaType: "text" };
+  }
   if (EVENTLIST_TYPES.has(t)) return { unit: mapEventList(widget, ctx), status: "direct", lumiaType: "eventlist" };
-  if (t === "se-widget-top-tippers-list") return { unit: mapLeaderboardFromVariables(widget, "tips", ctx), status: "direct", lumiaType: "loyaltyleaderboard" };
-  if (t === "se-widget-top-cheerers-list") return { unit: mapLeaderboardFromVariables(widget, "cheers", ctx), status: "direct", lumiaType: "loyaltyleaderboard" };
-  if (t === "se-widget-top-gifters-list") return { unit: mapLeaderboardFromVariables(widget, "gifts", ctx), status: "direct", lumiaType: "loyaltyleaderboard" };
+  if (t === "se-widget-top-tippers-list") return { unit: mapViewerProfilesLeaderboard(widget, "tips", ctx), status: "direct", lumiaType: "viewerprofiles" };
+  if (t === "se-widget-top-cheerers-list") return { unit: mapViewerProfilesLeaderboard(widget, "cheers", ctx), status: "direct", lumiaType: "viewerprofiles" };
+  if (t === "se-widget-top-gifters-list") return { unit: mapViewerProfilesLeaderboard(widget, "gifts", ctx), status: "direct", lumiaType: "viewerprofiles" };
   if (t === "se-widget-credit-roll") return { unit: mapCredits(widget, ctx), status: "partial", lumiaType: "credits" };
   if (t === "se-widget-twitch-chat") return { unit: mapChatbox(widget, ctx), status: "partial", lumiaType: "chatbox" };
   if (t === "se-widget-image-rotator" || t === "se-widget-merch-products-rotator") return { unit: mapSlideshow(widget, ctx), status: t === "se-widget-merch-products-rotator" ? "partial" : "direct", lumiaType: "slideshow" };
   if (t === "se-widget-countdown") return { unit: mapTimer(widget, ctx), status: "partial", lumiaType: "timer" };
   if (t === "se-widget-current-song") return { unit: mapNowPlaying(widget, ctx), status: "partial", lumiaType: "nowplaying" };
   if (t === "se-widget-kappagen") return { unit: mapKappagen(widget, ctx), status: "partial", lumiaType: "emotealert" };
+  if (t === "se-widget-emote-wall") return { unit: mapEmoteWall(widget, ctx), status: "partial", lumiaType: "emotebox" };
   if (t === "se-widget-giveaway") return { unit: mapGiveaway(widget, ctx), status: "direct", lumiaType: "raffle" };
   if (t === "se-widget-media-share") return { unit: mapMediaShare(widget, ctx), status: "partial", lumiaType: "songrequest" };
   if (t === "se-widget-hype-cup") return { unit: mapHypeCup(widget, ctx), status: "partial", lumiaType: "tipjar" };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@lumiastream/ui",
-	"version": "0.2.8-alpha.26",
+	"version": "0.2.8-alpha.28",
 	"author": "Lumia Stream",
 	"license": "ISC",
 	"description": "Lumia UI Kit",