@sensiblestats/widget-react 0.35.0 → 0.36.0

package/dist/index.cjs

@@ -36,7 +36,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/StatsWidget.tsx
-var import_react22 = require("react");
+var import_react23 = require("react");
 var import_widget_sdk5 = require("@sensiblestats/widget-sdk");
 
 // src/kickoff.ts
@@ -207,6 +207,7 @@ function normalizeUi(cfg) {
     cta: cfg.cta,
     surface: cfg.surface,
     ink: cfg.ink,
+    pinIcon: cfg.pinIcon ?? "pin",
     position: cfg.position ?? "right",
     offset: { x: cfg.offset?.x ?? 20, y: cfg.offset?.y ?? 20 },
     radius: cfg.radius ?? 16,
@@ -1194,6 +1195,9 @@ function useLiveMonitor(opts) {
   };
 }
 
+// src/components/ChatFab.tsx
+var import_react5 = require("react");
+
 // src/components/BrandMark.tsx
 var import_react4 = require("react");
 
@@ -1246,23 +1250,39 @@ function BrandMark({ logoUrl, className }) {
 var import_jsx_runtime3 = require("react/jsx-runtime");
 function GreetingBubble({ text, onOpen, onDismiss, dismissLabel = "Dismiss" }) {
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { className: "ss-w-greeting", role: "note", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { type: "button", className: "ss-w-greeting-body", onClick: onOpen, children: text }),
+    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("button", { type: "button", className: "ss-w-greeting-body", onClick: onOpen, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("span", { className: "ss-w-greeting-dots", "aria-hidden": "true", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("i", {}),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("i", {}),
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("i", {})
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "ss-w-greeting-text", children: text })
+    ] }),
     onDismiss ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("button", { type: "button", className: "ss-w-greeting-x", "aria-label": dismissLabel, onClick: onDismiss, children: "\xD7" }) : null
   ] });
 }
 
 // src/components/ChatFab.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
-function ChatFab({ label, greeting, popupText, logoUrl, onOpen, onDismissPopup, dismissLabel = "Dismiss" }) {
+function ChatFab({ label, greeting, popupText, logoUrl, onOpen, onDismissPopup, dismissLabel = "Dismiss", introAllowed = false, onIntroStart }) {
   const bubble = popupText ?? greeting;
-  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "ss-w-fab-wrap", children: [
+  const [intro, setIntro] = (0, import_react5.useState)(false);
+  const armedRef = (0, import_react5.useRef)(introAllowed);
+  (0, import_react5.useEffect)(() => {
+    if (armedRef.current && bubble) {
+      armedRef.current = false;
+      setIntro(true);
+      onIntroStart?.();
+    }
+  }, [bubble, onIntroStart]);
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: intro ? "ss-w-fab-wrap ss-w-intro" : "ss-w-fab-wrap", children: [
     bubble ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(GreetingBubble, { text: bubble, onOpen, onDismiss: popupText ? onDismissPopup : void 0, dismissLabel }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("button", { type: "button", className: "ss-w-fab", "aria-label": label, onClick: onOpen, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(BrandMark, { logoUrl, className: "ss-w-fab-mark" }) })
   ] });
 }
 
 // src/components/ChatPanel.tsx
-var import_react21 = require("react");
+var import_react22 = require("react");
 
 // src/components/ChatHeader.tsx
 var import_jsx_runtime5 = require("react/jsx-runtime");
@@ -1275,7 +1295,7 @@ function ChatHeader({ onClose, closeLabel = "Close chat", logoUrl, headerTitle }
 }
 
 // src/components/MessageList.tsx
-var import_react19 = require("react");
+var import_react20 = require("react");
 
 // src/components/Markdown.tsx
 var import_react_markdown = __toESM(require("react-markdown"), 1);
@@ -1293,7 +1313,7 @@ function Markdown({ text }) {
 }
 
 // src/components/EntityCardList.tsx
-var import_react5 = require("react");
+var import_react6 = require("react");
 var import_jsx_runtime7 = require("react/jsx-runtime");
 var MAX_VISIBLE = 3;
 var RECORD_RE = /^(\d+)-(\d+)-(\d+)$/;
@@ -1377,7 +1397,7 @@ function ScopeTabs({ scopes, active, onSelect }) {
   )) });
 }
 function EntityCardItem({ c }) {
-  const [active, setActive] = (0, import_react5.useState)(0);
+  const [active, setActive] = (0, import_react6.useState)(0);
   const hasBody = c.scopes.length > 0;
   if (!hasBody) {
     return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { className: "ss-w-ecard ss-w-ecard-bare", "data-kind": c.kind, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(CardHeader, { c, showScopeCrest: false }) });
@@ -1391,7 +1411,7 @@ function EntityCardItem({ c }) {
   ] });
 }
 function EntityCardList({ cards, disabled, showLessLabel = "Show less", showMoreLabel = (n) => `Show ${n} more` }) {
-  const [expanded, setExpanded] = (0, import_react5.useState)(false);
+  const [expanded, setExpanded] = (0, import_react6.useState)(false);
   if (cards.length === 0) return null;
   const visible = expanded ? cards : cards.slice(0, MAX_VISIBLE);
   const overflow = cards.length - MAX_VISIBLE;
@@ -1402,18 +1422,18 @@ function EntityCardList({ cards, disabled, showLessLabel = "Show less", showMore
 }
 
 // src/components/BettingInsightList.tsx
-var import_react10 = require("react");
+var import_react11 = require("react");
 
 // src/components/AddToSlipButton.tsx
-var import_react7 = require("react");
+var import_react8 = require("react");
 var import_widget_sdk4 = require("@sensiblestats/widget-sdk");
 
 // src/components/Toast.tsx
-var import_react6 = require("react");
+var import_react7 = require("react");
 var import_jsx_runtime8 = require("react/jsx-runtime");
 var DISMISS_MS = 4e3;
 function Toast({ toast, onDismiss }) {
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     if (!toast) return;
     const timer = setTimeout(onDismiss, DISMISS_MS);
     return () => clearTimeout(timer);
@@ -1431,10 +1451,10 @@ function withTimeout(value) {
   ]);
 }
 function SlipButton({ selection, shownOdds, marketName, slip, ui }) {
-  const [pending, setPending] = (0, import_react7.useState)(false);
-  const [settled, setSettled] = (0, import_react7.useState)(false);
-  const [toast, setToast] = (0, import_react7.useState)(null);
-  const dismiss = (0, import_react7.useCallback)(() => setToast(null), []);
+  const [pending, setPending] = (0, import_react8.useState)(false);
+  const [settled, setSettled] = (0, import_react8.useState)(false);
+  const [toast, setToast] = (0, import_react8.useState)(null);
+  const dismiss = (0, import_react8.useCallback)(() => setToast(null), []);
   const handler = slip.onAddToSlip;
   if (!ui || !handler || !selection) return null;
   const onClick = async () => {
@@ -1498,14 +1518,14 @@ function OddsMovementBadge({
 }
 
 // src/components/Crest.tsx
-var import_react8 = require("react");
+var import_react9 = require("react");
 var import_jsx_runtime11 = require("react/jsx-runtime");
 function initials2(name) {
   return (name ?? "").trim().slice(0, 1).toUpperCase() || "?";
 }
 function Crest2({ url, name, kind }) {
   const cls = kind === "comp" ? "ss-w-bi-comp-logo" : "ss-w-bi-crest";
-  const [failed, setFailed] = (0, import_react8.useState)(false);
+  const [failed, setFailed] = (0, import_react9.useState)(false);
   if (url && !failed) {
     return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("img", { className: cls, src: url, alt: "", "aria-hidden": "true", onError: () => setFailed(true) });
   }
@@ -1513,11 +1533,16 @@ function Crest2({ url, name, kind }) {
 }
 
 // src/components/PinToggle.tsx
-var import_react9 = require("react");
+var import_react10 = require("react");
 var import_jsx_runtime12 = require("react/jsx-runtime");
+var PIN_GLYPHS = {
+  pin: { viewBox: "0 0 24 24", strokeWidth: 1.4, transform: "scale(1.5)", d: "M9.5 1.5 14.5 6.5 13 8l-.5-.5-3 3 .3 2.2-1.4 1.4L5.6 11.3l-3.3 3.3-1-1 3.3-3.3L1.9 7.5l1.4-1.4 2.2.3 3-3L8 2.9z" },
+  star: { viewBox: "0 0 24 24", strokeWidth: 2, d: "M12 2.5l2.9 5.9 6.5.95-4.7 4.58 1.1 6.47L12 17.35 6.1 20.4l1.1-6.47L2.5 9.35l6.5-.95z" },
+  bookmark: { viewBox: "0 0 24 24", strokeWidth: 2, d: "M7 3h10a1.5 1.5 0 0 1 1.5 1.5V21l-6.5-3.6L5.5 21V4.5A1.5 1.5 0 0 1 7 3z" }
+};
 function PinToggle({ pin, monitor, ui }) {
-  const [toast, setToast] = (0, import_react9.useState)(null);
-  const dismiss = (0, import_react9.useCallback)(() => setToast(null), []);
+  const [toast, setToast] = (0, import_react10.useState)(null);
+  const dismiss = (0, import_react10.useCallback)(() => setToast(null), []);
   if (!monitor || !monitor.enabled) return null;
   const key = pinKey(pin);
   const pinned = monitor.isPinned(key);
@@ -1530,6 +1555,7 @@ function PinToggle({ pin, monitor, ui }) {
       setToast({ kind: "error", text: ui.marketLimitToast });
     }
   };
+  const glyph = PIN_GLYPHS[ui.pinIcon];
   return /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("div", { className: "ss-w-pin-wrap", children: [
     /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
       "button",
@@ -1537,10 +1563,22 @@ function PinToggle({ pin, monitor, ui }) {
         type: "button",
         className: "ss-w-pin",
         "data-on": pinned || void 0,
+        "data-icon": ui.pinIcon,
         "aria-pressed": pinned,
         "aria-label": pinned ? labels.unpin : labels.pin,
         onClick,
-        children: /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", children: /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("path", { fill: "currentColor", d: "M9.5 1.5 14.5 6.5 13 8l-.5-.5-3 3 .3 2.2-1.4 1.4L5.6 11.3l-3.3 3.3-1-1 3.3-3.3L1.9 7.5l1.4-1.4 2.2.3 3-3L8 2.9z" }) })
+        children: /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("svg", { viewBox: glyph.viewBox, "aria-hidden": "true", children: /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(
+          "path",
+          {
+            transform: glyph.transform,
+            d: glyph.d,
+            fill: pinned ? "currentColor" : "none",
+            stroke: pinned ? "none" : "currentColor",
+            strokeWidth: glyph.strokeWidth,
+            strokeLinejoin: "round",
+            strokeLinecap: "round"
+          }
+        ) })
       }
     ),
     /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(Toast, { toast, onDismiss: dismiss })
@@ -1556,7 +1594,7 @@ function StatRows({ stats }) {
   ] }, `${s.label}:${s.value}`)) });
 }
 function ScopedStats({ scopes }) {
-  const [active, setActive] = (0, import_react10.useState)(0);
+  const [active, setActive] = (0, import_react11.useState)(0);
   const current = scopes[active] ?? scopes[0] ?? { key: "", label: "", stats: [] };
   return /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("div", { className: "ss-w-bi-scoped", children: [
     /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("div", { className: "ss-w-bi-scopes", role: "group", children: scopes.map((s, i) => /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("button", { type: "button", className: "ss-w-bi-chip", "aria-pressed": i === active, onClick: () => setActive(i), children: s.label }, s.key)) }),
@@ -1567,7 +1605,7 @@ function hasStatsContent(it) {
   return !!it.scopes && it.scopes.length >= 2 || it.stats.length > 0;
 }
 function ReasonStrip({ it, ui }) {
-  const [open, setOpen] = (0, import_react10.useState)(false);
+  const [open, setOpen] = (0, import_react11.useState)(false);
   const hasScopes = !!it.scopes && it.scopes.length >= 2;
   const hasStats = hasStatsContent(it);
   const hasText = !!it.text;
@@ -1677,7 +1715,7 @@ function BettingInsightList({ insights, ui, slip, monitor }) {
 }
 
 // src/components/MarketOddsCardList.tsx
-var import_react11 = require("react");
+var import_react12 = require("react");
 var import_jsx_runtime14 = require("react/jsx-runtime");
 function OddsRow({ vm, row, ui, slip, inSlipIds }) {
   const selection = vm.addToSlipEnabled ? marketOddsRowToSlipSelection(vm, row, slip.conversationId) : null;
@@ -1694,7 +1732,7 @@ function OddsRow({ vm, row, ui, slip, inSlipIds }) {
   ] });
 }
 function MarketOddsCard({ vm, ui, slip, monitor, inSlipIds }) {
-  const [open, setOpen] = (0, import_react11.useState)(false);
+  const [open, setOpen] = (0, import_react12.useState)(false);
   const kickoff = vm.kickoffUtc && ui?.bettingKickoff ? ui.bettingKickoff(vm.kickoffUtc) : void 0;
   const hasNamedTeams = !!vm.homeTeamName && !!vm.awayTeamName;
   const showPin = !!monitor && vm.pinEnabled;
@@ -1987,7 +2025,7 @@ function FixtureCard({ card }) {
 }
 
 // src/components/dashboard/CountdownCard.tsx
-var import_react12 = require("react");
+var import_react13 = require("react");
 var import_jsx_runtime20 = require("react/jsx-runtime");
 var DAY_MS = 864e5;
 function remainingSegments(kickoffUnix, nowMs, withSeconds) {
@@ -2006,12 +2044,12 @@ function remainingSegments(kickoffUnix, nowMs, withSeconds) {
 function CountdownCard({ card }) {
   const { data } = card;
   const unitLabel = { d: data.daysUnit, h: data.hoursUnit, m: data.minutesUnit, s: data.secondsUnit };
-  const [nowMs, setNowMs] = (0, import_react12.useState)(() => Date.now());
-  const [reduced] = (0, import_react12.useState)(
+  const [nowMs, setNowMs] = (0, import_react13.useState)(() => Date.now());
+  const [reduced] = (0, import_react13.useState)(
     () => typeof window !== "undefined" && window.matchMedia("(prefers-reduced-motion: reduce)").matches
   );
   const withinDay = data.kickoffUnix * 1e3 - nowMs < DAY_MS;
-  (0, import_react12.useEffect)(() => {
+  (0, import_react13.useEffect)(() => {
     if (reduced) return;
     const id = window.setInterval(() => setNowMs(Date.now()), withinDay ? 1e3 : 6e4);
     return () => window.clearInterval(id);
@@ -2019,7 +2057,7 @@ function CountdownCard({ card }) {
   const segments = remainingSegments(data.kickoffUnix, nowMs, withinDay && !reduced);
   return /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: "ss-w-fandash-card ss-w-fandash-countdown", children: /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)("div", { className: "ss-w-fandash-countdown-top", children: [
     /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("span", { className: "ss-w-fandash-eyebrow", children: card.title ?? "Kick-off in" }),
-    segments ? /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("span", { className: "ss-w-fandash-countdown-clock", children: segments.map((s, i) => /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)(import_react12.Fragment, { children: [
+    segments ? /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("span", { className: "ss-w-fandash-countdown-clock", children: segments.map((s, i) => /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)(import_react13.Fragment, { children: [
       i > 0 ? /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("span", { className: "ss-w-fandash-countdown-colon", children: ":" }) : null,
       /* @__PURE__ */ (0, import_jsx_runtime20.jsxs)("span", { className: "ss-w-fandash-countdown-seg", children: [
         /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("span", { className: "ss-w-fandash-countdown-value", children: s.value }),
@@ -2030,7 +2068,7 @@ function CountdownCard({ card }) {
 }
 
 // src/components/dashboard/InjuriesCard.tsx
-var import_react13 = require("react");
+var import_react14 = require("react");
 var import_jsx_runtime21 = require("react/jsx-runtime");
 var SHOWN = 3;
 function ColHead({ name, crestUrl }) {
@@ -2053,7 +2091,7 @@ function InjuryList({ rows, emptyLabel, limit }) {
 }
 function InjuriesCard({ card, ui }) {
   const { data } = card;
-  const [expanded, setExpanded] = (0, import_react13.useState)(false);
+  const [expanded, setExpanded] = (0, import_react14.useState)(false);
   const hidden = Math.max(0, data.ours.length - SHOWN) + Math.max(0, data.theirs.length - SHOWN);
   const limit = expanded ? void 0 : SHOWN;
   const showMore = ui?.showMore ?? ((n) => `Show ${n} more`);
@@ -2157,7 +2195,7 @@ function LinksCard({ card }) {
 }
 
 // src/components/dashboard/PostMatchResultCard.tsx
-var import_react14 = require("react");
+var import_react15 = require("react");
 var import_jsx_runtime27 = require("react/jsx-runtime");
 function initials3(name) {
   return name.trim().slice(0, 3).toUpperCase();
@@ -2167,7 +2205,7 @@ function PostMatchCrest({
   name,
   side
 }) {
-  const [failed, setFailed] = (0, import_react14.useState)(false);
+  const [failed, setFailed] = (0, import_react15.useState)(false);
   const cls = `ss-w-fandash-postmatch-crest ss-w-fandash-postmatch-crest--${side}`;
   if (url && !failed) {
     return /* @__PURE__ */ (0, import_jsx_runtime27.jsx)("img", { className: cls, src: url, alt: "", "aria-hidden": "true", onError: () => setFailed(true) });
@@ -2366,10 +2404,10 @@ function RestingFormCard({ card }) {
 }
 
 // src/components/dashboard/LiveScoreCard.tsx
-var import_react16 = require("react");
+var import_react17 = require("react");
 
 // src/useLiveClock.ts
-var import_react15 = require("react");
+var import_react16 = require("react");
 var TICK_MS = 6e4;
 var MAX_LIVE_TICK_MINUTES = 15;
 function computeDisplayMinute(minute, clockRunning, receivedAtMs) {
@@ -2378,10 +2416,10 @@ function computeDisplayMinute(minute, clockRunning, receivedAtMs) {
   return minute + Math.min(Math.max(0, elapsedMinutes), MAX_LIVE_TICK_MINUTES);
 }
 function useLiveClock(minute, clockRunning, receivedAtMs) {
-  const [displayMinute, setDisplayMinute] = (0, import_react15.useState)(
+  const [displayMinute, setDisplayMinute] = (0, import_react16.useState)(
     () => computeDisplayMinute(minute, clockRunning, receivedAtMs)
   );
-  (0, import_react15.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     setDisplayMinute(computeDisplayMinute(minute, clockRunning, receivedAtMs));
     if (!clockRunning) return;
     const id = window.setInterval(() => {
@@ -2398,7 +2436,7 @@ function initials5(name) {
   return name.trim().slice(0, 3).toUpperCase();
 }
 function LiveCrest({ url, name, side }) {
-  const [failed, setFailed] = (0, import_react16.useState)(false);
+  const [failed, setFailed] = (0, import_react17.useState)(false);
   const cls = `ss-w-fandash-live-crest ss-w-fandash-live-crest--${side}`;
   if (url && !failed) {
     return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("img", { className: cls, src: url, alt: "", "aria-hidden": "true", onError: () => setFailed(true) });
@@ -2417,7 +2455,7 @@ function LiveScoreCard({
 }) {
   const { data } = card;
   const seedKey = `${data.minute}:${data.homeScore}:${data.awayScore}`;
-  const seedRef = (0, import_react16.useRef)(null);
+  const seedRef = (0, import_react17.useRef)(null);
   if (!seedRef.current || seedRef.current.key !== seedKey) {
     seedRef.current = { key: seedKey, receivedAtMs: Date.now() };
   }
@@ -2457,7 +2495,7 @@ function LiveScoreCard({
 }
 
 // src/components/dashboard/LiveTimelineCard.tsx
-var import_react17 = require("react");
+var import_react18 = require("react");
 var import_jsx_runtime37 = require("react/jsx-runtime");
 var SHOWN2 = 3;
 function EventIcon({ type }) {
@@ -2499,7 +2537,7 @@ function EventRow({ e }) {
   ] });
 }
 function LiveTimelineCard({ card, ui }) {
-  const [expanded, setExpanded] = (0, import_react17.useState)(false);
+  const [expanded, setExpanded] = (0, import_react18.useState)(false);
   const events = card.data.events;
   if (!events || events.length === 0) return null;
   const sorted = [...events].sort((a, b) => b.minute - a.minute);
@@ -2524,7 +2562,7 @@ function LiveTimelineCard({ card, ui }) {
 }
 
 // src/components/dashboard/MomentumWave.tsx
-var import_react18 = require("react");
+var import_react19 = require("react");
 var import_jsx_runtime38 = require("react/jsx-runtime");
 var WIDTH = 270;
 var HEIGHT = 56;
@@ -2548,7 +2586,7 @@ function MomentumWave({
 }) {
   if (points.length === 0) return null;
   const { area, line, lastLeftPct, lastTopPx } = buildPaths(points);
-  const clipId = (0, import_react18.useId)();
+  const clipId = (0, import_react19.useId)();
   const topClipId = `${clipId}-top`;
   const bottomClipId = `${clipId}-bottom`;
   const topClass = clubIsHome ? "ss-w-fandash-live-mom-home" : "ss-w-fandash-live-mom-away";
@@ -2739,11 +2777,11 @@ function turnAnchor(messages) {
 }
 function MessageList({ controller, ui, slip, onDashboardTap, monitor }) {
   const { state, send } = controller;
-  const listRef = (0, import_react19.useRef)(null);
-  const endRef = (0, import_react19.useRef)(null);
-  const pinnedRef = (0, import_react19.useRef)(true);
-  const anchoredTurnRef = (0, import_react19.useRef)(null);
-  (0, import_react19.useEffect)(() => {
+  const listRef = (0, import_react20.useRef)(null);
+  const endRef = (0, import_react20.useRef)(null);
+  const pinnedRef = (0, import_react20.useRef)(true);
+  const anchoredTurnRef = (0, import_react20.useRef)(null);
+  (0, import_react20.useEffect)(() => {
     const anchor = turnAnchor(state.messages);
     const list = listRef.current;
     if (anchor && anchor.turnId !== anchoredTurnRef.current) {
@@ -2799,10 +2837,10 @@ function MessageList({ controller, ui, slip, onDashboardTap, monitor }) {
 }
 
 // src/components/ChatInput.tsx
-var import_react20 = require("react");
+var import_react21 = require("react");
 var import_jsx_runtime44 = require("react/jsx-runtime");
 function ChatInput({ placeholder, streaming, onSend, onStop, stopLabel = "Stop response", sendLabel = "Send message" }) {
-  const [value, setValue] = (0, import_react20.useState)("");
+  const [value, setValue] = (0, import_react21.useState)("");
   const submit = () => {
     const t = value.trim();
     if (!t) return;
@@ -3049,8 +3087,8 @@ function OddsPanel({ monitor, ui, slip }) {
 var import_jsx_runtime48 = require("react/jsx-runtime");
 var FULLSCREEN_QUERY = "(max-width: 639px)";
 function useIsModal() {
-  const [modal, setModal] = (0, import_react21.useState)(false);
-  (0, import_react21.useEffect)(() => {
+  const [modal, setModal] = (0, import_react22.useState)(false);
+  (0, import_react22.useEffect)(() => {
     if (typeof window === "undefined" || typeof window.matchMedia !== "function") return;
     const mql = window.matchMedia(FULLSCREEN_QUERY);
     const sync = () => setModal(mql.matches);
@@ -3063,7 +3101,7 @@ function useIsModal() {
 function ChatPanel({ controller, ui, slip, onDashboardTap, monitor }) {
   const { state, close, stop, send } = controller;
   const isModal = useIsModal();
-  (0, import_react21.useEffect)(() => {
+  (0, import_react22.useEffect)(() => {
     const onKey = (e) => {
       if (e.key === "Escape") close();
     };
@@ -3074,7 +3112,7 @@ function ChatPanel({ controller, ui, slip, onDashboardTap, monitor }) {
     monitor?.setActiveTab("chat");
     send(text);
   };
-  (0, import_react21.useEffect)(() => {
+  (0, import_react22.useEffect)(() => {
     if (monitor && monitor.activeTab !== "chat" && state.isStreaming) monitor.markChatActivity();
   }, [monitor, state.isStreaming, state.messages.length]);
   return /* @__PURE__ */ (0, import_jsx_runtime48.jsxs)("div", { className: "ss-w-panel", role: "dialog", "aria-modal": isModal, "aria-label": ui.chatDialogLabel, children: [
@@ -3145,8 +3183,40 @@ var WIDGET_CSS = `.ss-w-root { all: revert; }
 .ss-w-fab { width: 56px; height: 56px; border: none; border-radius: 50%; background: var(--ss-w-nav); color: #fff; cursor: pointer; display: grid; place-items: center; box-shadow: 0 6px 20px rgba(0,0,0,.28); }
 .ss-w-fab-mark { width: 30px; height: 30px; display: block; object-fit: contain; }
 .ss-w-greeting { max-width: 240px; display: flex; align-items: flex-start; background: var(--ss-w-panel); color: var(--ss-w-ink); border: 1px solid var(--ss-w-line); border-radius: 12px; box-shadow: 0 4px 14px rgba(0,0,0,.14); }
-.ss-w-greeting-body { flex: 1; min-width: 0; text-align: left; background: none; border: none; color: inherit; font: inherit; cursor: pointer; padding: 9px 4px 9px 12px; }
+.ss-w-greeting-body { position: relative; flex: 1; min-width: 0; text-align: left; background: none; border: none; color: inherit; font: inherit; cursor: pointer; padding: 9px 4px 9px 12px; }
 .ss-w-greeting-x { flex: none; background: none; border: none; color: var(--ss-w-faint); cursor: pointer; font-size: 17px; line-height: 1; padding: 7px 9px 0 2px; }
+.ss-w-greeting-text { display: block; }
+/* Typing indicator: overlays the text area so bubble height stays put; hidden at
+   rest, revealed only during the one-shot intro (see prefers-reduced-motion block). */
+.ss-w-greeting-dots { position: absolute; top: 0; bottom: 0; left: 12px; display: flex; align-items: center; gap: 4px; opacity: 0; pointer-events: none; }
+.ss-w-greeting-dots i { width: 6px; height: 6px; border-radius: 50%; background: var(--ss-w-faint); display: block; }
+/* One-shot launcher attention intro: FAB nudges, then the greeting types in.
+   Gated behind no-preference so reduce-motion users get the greeting shown
+   statically (text visible, no nudge, no typing). ChatFab adds .ss-w-intro once
+   per page load; every animation runs a single time and settles at rest. */
+@media (prefers-reduced-motion: no-preference) {
+  .ss-w-intro .ss-w-fab { animation: ss-w-nudge .8s ease both; }
+  .ss-w-intro .ss-w-greeting { animation: ss-w-greet-in .45s cubic-bezier(.2,.8,.3,1.15) .8s both; }
+  .ss-w-intro .ss-w-greeting-text { animation: ss-w-greet-textin .4s ease 1.65s both; }
+  .ss-w-intro .ss-w-greeting-dots { animation: ss-w-greet-dots .95s ease .85s both; }
+  .ss-w-intro .ss-w-greeting-dots i { animation: ss-w-greet-dotbounce .5s ease .85s 2; }
+  .ss-w-intro .ss-w-greeting-dots i:nth-child(2) { animation-delay: 1s; }
+  .ss-w-intro .ss-w-greeting-dots i:nth-child(3) { animation-delay: 1.15s; }
+}
+@keyframes ss-w-nudge {
+  0%, 100% { transform: none; }
+  22% { transform: translateY(-9px) rotate(-9deg); }
+  44% { transform: translateY(0) rotate(7deg); }
+  64% { transform: translateY(-4px) rotate(-4deg); }
+  82% { transform: rotate(2deg); }
+}
+@keyframes ss-w-greet-in {
+  from { opacity: 0; transform: translateY(8px) scale(.92); }
+  to { opacity: 1; transform: none; }
+}
+@keyframes ss-w-greet-textin { from { opacity: 0; } to { opacity: 1; } }
+@keyframes ss-w-greet-dots { 0% { opacity: 0; } 14% { opacity: 1; } 78% { opacity: 1; } 100% { opacity: 0; } }
+@keyframes ss-w-greet-dotbounce { 0%, 100% { transform: translateY(0); } 50% { transform: translateY(-4px); } }
 
 /* panel */
 .ss-w-panel { position: fixed; bottom: calc(var(--ss-w-offset-y) + 72px); z-index: 2147483000; display: flex; flex-direction: column; width: min(460px, calc(100vw - 40px)); height: min(640px, calc(100vh - 120px)); background: var(--ss-w-panel); border: 1px solid var(--ss-w-line); border-radius: var(--ss-w-radius); overflow: hidden; box-shadow: 0 12px 40px rgba(0,0,0,.24); }
@@ -3878,16 +3948,20 @@ function injectStyles(root) {
 function StatsWidget(props) {
   const injectedClient = "client" in props ? props.client : void 0;
   const cfg = props.config;
-  const built = (0, import_react22.useMemo)(() => buildClient(props), [injectedClient, cfg?.operatorId, cfg?.publicKey, cfg?.baseUrl]);
-  const ui = (0, import_react22.useMemo)(() => normalizeUi(props.config ?? { operatorId: "", publicKey: "" }), [props.config]);
-  const rootRef = (0, import_react22.useRef)(null);
+  const built = (0, import_react23.useMemo)(() => buildClient(props), [injectedClient, cfg?.operatorId, cfg?.publicKey, cfg?.baseUrl]);
+  const ui = (0, import_react23.useMemo)(() => normalizeUi(props.config ?? { operatorId: "", publicKey: "" }), [props.config]);
+  const rootRef = (0, import_react23.useRef)(null);
+  const introDoneRef = (0, import_react23.useRef)(false);
+  const markIntroDone = (0, import_react23.useCallback)(() => {
+    introDoneRef.current = true;
+  }, []);
   const controller = useChatStream(built?.conversation ?? emptyConversation(), ui.starters, built ? ui.greetingMessage : void 0);
   const monitor = useLiveMonitor({
     getLiveMonitor: (pins) => built ? built.conversation.getLiveMonitor(pins) : Promise.resolve(null),
     storageKey: `ss-w-pins:${cfg?.operatorId ?? ""}:${cfg?.userContext?.operatorUserId ?? "anon"}`,
     isOpen: controller.state.isOpen
   });
-  const slip = (0, import_react22.useMemo)(
+  const slip = (0, import_react23.useMemo)(
     () => {
       const handler = props.config?.onAddToSlip;
       return {
@@ -3910,11 +3984,11 @@ function StatsWidget(props) {
     },
     [props.config?.onAddToSlip, controller.state.conversationId, built, monitor.markInSlip]
   );
-  const onDashboardTap = (0, import_react22.useMemo)(
+  const onDashboardTap = (0, import_react23.useMemo)(
     () => built ? createDashboardTapSignal((input) => built.conversation.sendSignal(input)) : void 0,
     [built]
   );
-  (0, import_react22.useEffect)(() => {
+  (0, import_react23.useEffect)(() => {
     if (!built || !ui.injectStyles) return;
     const node = rootRef.current?.getRootNode();
     if (node) injectStyles(node);
@@ -3930,7 +4004,9 @@ function StatsWidget(props) {
       logoUrl: ui.logoUrl,
       onOpen: controller.open,
       onDismissPopup: controller.dismissPopup,
-      dismissLabel: ui.dismissGreeting
+      dismissLabel: ui.dismissGreeting,
+      introAllowed: !introDoneRef.current,
+      onIntroStart: markIntroDone
     }
   ) });
 }