@lumiastream/ui 0.2.8-alpha.27 → 0.2.8-alpha.29

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" },
@@ -3272,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}}}`;
   });
 }
@@ -3328,8 +3388,8 @@ function listenerToLumiaVariable(listener, provider = "twitch") {
     // 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",
@@ -3484,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 };
@@ -3530,9 +3597,10 @@ function mapSeTextCssToModuleCss(widget, defaults = {}) {
     background: defaults.background ?? "transparent"
   };
 }
-function buildUnit(widget, lumiaType, moduleExtras, ctx) {
+var READOUT_AUTO_FALLBACK_SIZE = { width: 400, height: 50 };
+function buildUnit(widget, lumiaType, moduleExtras, ctx, sizeOverride) {
   const id = nanoid();
-  const defaults = LUMIA_DEFAULT_SIZES[lumiaType] ?? { width: 400, height: 400 };
+  const defaults = sizeOverride ?? LUMIA_DEFAULT_SIZES[lumiaType] ?? { width: 400, height: 400 };
   const bounds = seCssToBounds(widget.css, defaults, ctx?.canvas);
   const layer = {
     id,
@@ -3586,7 +3654,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: {
@@ -3643,22 +3711,32 @@ 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" },
-    css: {
-      fontSize: seCss["font-size"] ?? 28,
-      textAlign: seCss["text-align"] ?? "center",
-      fontFamily: seCss["font-family"] ?? "Roboto",
-      fontWeight: seCss["font-weight"] ?? "bold",
-      color: seCss["color"] ?? "#ffffff",
-      textShadow: seCss["text-shadow"] ?? "rgb(0, 0, 0) 1px 1px 1px",
-      lineHeight: seCss["line-height"] ?? 1,
-      background: "transparent",
-      ...seExtraTextCss(seCss, widget.text?.scrolling)
-    }
-  }, ctx);
+  return buildUnit(
+    widget,
+    "text",
+    {
+      content: { value, highlightColor: "inherit" },
+      css: {
+        fontSize: seCss["font-size"] ?? 28,
+        textAlign: seCss["text-align"] ?? "center",
+        fontFamily: seCss["font-family"] ?? "Roboto",
+        fontWeight: seCss["font-weight"] ?? "bold",
+        color: seCss["color"] ?? "#ffffff",
+        textShadow: seCss["text-shadow"] ?? "rgb(0, 0, 0) 1px 1px 1px",
+        lineHeight: seCss["line-height"] ?? 1,
+        background: "transparent",
+        ...seExtraTextCss(seCss, widget.text?.scrolling)
+      }
+    },
+    ctx,
+    // SE readouts ship `width:auto; height:auto`. Override the generic
+    // `text` 600×200 fallback with a single-line-friendly size so the
+    // imported layer doesn't render as a half-canvas rectangle when the
+    // rendered content is one line of 24px text.
+    READOUT_AUTO_FALLBACK_SIZE
+  );
 }
 
 // src/se-import/mappers/provider-alerts.ts
@@ -3898,7 +3976,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);
@@ -4034,7 +4112,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
@@ -4637,7 +4716,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);
@@ -4709,7 +4788,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() : "",
@@ -4852,28 +4931,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", {
-    // Carry SE text styling so the leaderboard list keeps the streamer's
+  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,
@@ -5019,6 +5117,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: {
@@ -5418,15 +5557,16 @@ function dispatch(widget, ctx) {
     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" },
@@ -157,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}}}`;
   });
 }
@@ -213,8 +273,8 @@ function listenerToLumiaVariable(listener, provider = "twitch") {
     // 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",
@@ -369,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 };
@@ -415,9 +482,10 @@ function mapSeTextCssToModuleCss(widget, defaults = {}) {
     background: defaults.background ?? "transparent"
   };
 }
-function buildUnit(widget, lumiaType, moduleExtras, ctx) {
+var READOUT_AUTO_FALLBACK_SIZE = { width: 400, height: 50 };
+function buildUnit(widget, lumiaType, moduleExtras, ctx, sizeOverride) {
   const id = nanoid();
-  const defaults = LUMIA_DEFAULT_SIZES[lumiaType] ?? { width: 400, height: 400 };
+  const defaults = sizeOverride ?? LUMIA_DEFAULT_SIZES[lumiaType] ?? { width: 400, height: 400 };
   const bounds = seCssToBounds(widget.css, defaults, ctx?.canvas);
   const layer = {
     id,
@@ -471,7 +539,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: {
@@ -528,22 +596,32 @@ 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" },
-    css: {
-      fontSize: seCss["font-size"] ?? 28,
-      textAlign: seCss["text-align"] ?? "center",
-      fontFamily: seCss["font-family"] ?? "Roboto",
-      fontWeight: seCss["font-weight"] ?? "bold",
-      color: seCss["color"] ?? "#ffffff",
-      textShadow: seCss["text-shadow"] ?? "rgb(0, 0, 0) 1px 1px 1px",
-      lineHeight: seCss["line-height"] ?? 1,
-      background: "transparent",
-      ...seExtraTextCss(seCss, widget.text?.scrolling)
-    }
-  }, ctx);
+  return buildUnit(
+    widget,
+    "text",
+    {
+      content: { value, highlightColor: "inherit" },
+      css: {
+        fontSize: seCss["font-size"] ?? 28,
+        textAlign: seCss["text-align"] ?? "center",
+        fontFamily: seCss["font-family"] ?? "Roboto",
+        fontWeight: seCss["font-weight"] ?? "bold",
+        color: seCss["color"] ?? "#ffffff",
+        textShadow: seCss["text-shadow"] ?? "rgb(0, 0, 0) 1px 1px 1px",
+        lineHeight: seCss["line-height"] ?? 1,
+        background: "transparent",
+        ...seExtraTextCss(seCss, widget.text?.scrolling)
+      }
+    },
+    ctx,
+    // SE readouts ship `width:auto; height:auto`. Override the generic
+    // `text` 600×200 fallback with a single-line-friendly size so the
+    // imported layer doesn't render as a half-canvas rectangle when the
+    // rendered content is one line of 24px text.
+    READOUT_AUTO_FALLBACK_SIZE
+  );
 }
 
 // src/se-import/mappers/provider-alerts.ts
@@ -783,7 +861,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);
@@ -919,7 +997,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
@@ -1522,7 +1601,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);
@@ -1594,7 +1673,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() : "",
@@ -1737,28 +1816,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", {
-    // Carry SE text styling so the leaderboard list keeps the streamer's
+  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,
@@ -1904,6 +2002,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: {
@@ -2303,15 +2442,16 @@ function dispatch(widget, ctx) {
     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.27",
+	"version": "0.2.8-alpha.29",
 	"author": "Lumia Stream",
 	"license": "ISC",
 	"description": "Lumia UI Kit",