Skip to content
Python
19.3 KB
Raw Blame
import { useEffect, useRef, useState } from "react";
import { useTranslation, getI18n } from "react-i18next";
import type { SlackWorkspace } from "../../api";

// Module-level t for the mock-screenshot copy below — the scene helpers are
// plain functions, so they can't call the useTranslation hook themselves.
const tr = (k: string, opts?: Record<string, unknown>) => getI18n().getFixedT(null, "translation")(k, opts);

// UX-027: the post-connect "how mentions reach you" card. A tabbed carousel of
// animated split-scenes — Slack on the left (pinned to light-Slack colors, so it
// reads as a screenshot of Slack), OpenWorker on the right (app tokens). Tabs
// auto-advance through one full tour, then idle on a loop of the current scene;
// clicking a tab takes over. The chevron collapses the carousel to the status
// line — collapsed IS the seen-state (stored locally, survives restarts).
// "Listen to a channel" is deliberately absent: owner wants that scene reworked
// before it ships (UX-027 rev 4).

const KEY = "ocw.slack.howitworks.collapsed";
const DUR = 8000; // per-scene loop, ms
const TABS = ["slack.hiw_tab_mention", "slack.hiw_tab_threads", "slack.hiw_tab_teammates"];
const CAPTIONS = [
  "slack.hiw_cap_mention",
  "slack.hiw_cap_threads",
  "slack.hiw_cap_teammates",
];

function readCollapsed(): boolean {
  try { return localStorage.getItem(KEY) === "1"; } catch { return false; }
}

export function SlackHowItWorks({ workspaces }: { workspaces: SlackWorkspace[] }) {
  const { t } = useTranslation();
  const [collapsed, setCollapsed] = useState(readCollapsed);
  const [tab, setTab] = useState(0);
  const [cycle, setCycle] = useState(0); // bump = remount the scene = restart its animations
  const tourRef = useRef(TABS.length); // auto-advances left in the one-time story tour

  useEffect(() => {
    if (collapsed) return;
    const t = window.setTimeout(() => {
      if (tourRef.current > 1) {
        tourRef.current -= 1;
        setTab((x) => (x + 1) % TABS.length);
      } else {
        tourRef.current = 0;
        setCycle((c) => c + 1); // keep looping the current scene quietly
      }
    }, DUR);
    return () => window.clearTimeout(t);
  }, [tab, cycle, collapsed]);

  const jump = (i: number) => {
    tourRef.current = 0; // a click takes over: no more auto-advance
    setTab(i);
    setCycle((c) => c + 1);
  };
  const toggle = () => {
    const v = !collapsed;
    setCollapsed(v);
    try { localStorage.setItem(KEY, v ? "1" : "0"); } catch { /* best effort */ }
  };

  // Personalize when the install pre-added the connecting user (setup.py):
  // their workspace names the status line; the scenes call them by first name.
  const mine = workspaces.find(
    (w) => w.installer_user_id && w.allowed_users.includes(w.installer_user_id)
  );
  const ws = mine ?? workspaces[0];
  const meName =
    (mine &&
      (mine.installer_name ||
        mine.allowed_user_names?.[mine.installer_user_id ?? ""])) ||
    t("slack.hiw_you");
  const meFirst = meName.split(/\s+/)[0];
  const meInitial = (meName[0] || "Y").toUpperCase();

  return (
    // Rev 7 (owner): BORDERLESS — a proper section title + quiet status line;
    // the only boxes on screen are the two mini-windows, which own their frames.
    <div className="mb-5" data-testid="slack-howitworks">
      <div className="flex items-baseline gap-2.5">
        <h3 className="text-ui font-semibold tracking-tight">
          {t("slack.hiw_title")}
        </h3>
        <button
          className="ml-auto shrink-0 inline-flex items-center gap-1.5 text-meta text-muted hover:text-ink"
          data-testid="hiw-collapse"
          title={collapsed ? t("slack.hiw_show") : t("slack.hiw_collapse")}
          onClick={toggle}
        >
          {collapsed ? t("slack.hiw_how_it_works") : t("slack.hiw_hide")}
          <span
            className="text-[9px] transition-transform"
            style={collapsed ? { transform: "rotate(-90deg)" } : undefined}
          >
            ▼
          </span>
        </button>
      </div>
      <div className="text-meta text-muted mt-0.5">
        <span className="text-ok font-bold">✓ </span>
        {(ws?.account || t("slack.hiw_workspace")) + " " + t("slack.hiw_connected")}
        {mine
          ? " " + t("slack.hiw_on_people_list")
          : " " + t("slack.hiw_how_mentions")}
      </div>

      {!collapsed && (
        <div className="mt-3">
          <div className="flex gap-1 border-b border-line mb-3">
            {TABS.map((tb, i) => (
              <button
                key={tb}
                className={"hiw-tab" + (i === tab ? " on" : "")}
                data-testid={`hiw-tab-${i}`}
                style={{ "--hiw-dur": `${DUR}ms` } as React.CSSProperties}
                onClick={() => jump(i)}
              >
                {t(tb)}
                <span className="hiw-prog"><i /></span>
              </button>
            ))}
          </div>

          <div className="hiw-scene hiw-play" key={`${tab}:${cycle}`} data-testid="hiw-scene">
            {tab === 0 && <SceneMention meFirst={meFirst} meInitial={meInitial} />}
            {tab === 1 && <SceneThread meFirst={meFirst} meInitial={meInitial} />}
            {tab === 2 && <SceneTeammates />}
          </div>
          <div className="mt-2.5 text-meta text-muted" data-testid="hiw-caption">
            {t(CAPTIONS[tab])}
          </div>
        </div>
      )}
    </div>
  );
}

/* ---- shared miniature furniture ---- */

// The scenes deliberately play in a FICTIONAL workspace ("Lumina Labs") — a real
// account name here (or anything resembling our own product) reads as confusing
// or fake in an educational animation; the card's status line above keeps the
// user's real workspace name.
const WS_NAME = "Lumina Labs";

/* Post-it notes (rev 7, owner-approved): the concept in five hand-written words,
   slapped onto the scene at its beat; they fade out near the end of each loop so
   they read as annotation, never as UI. */
function Sticky({
  d: delay, r, pos, children,
}: {
  d: string; r?: boolean; pos: React.CSSProperties; children: React.ReactNode;
}) {
  return (
    <div
      className={"hiw-sticky hiw-k" + (r ? " r" : "")}
      style={{ "--d": delay, ...pos } as React.CSSProperties}
    >
      {children}
    </div>
  );
}

const ThreadsIcon = () => (
  <svg className="hiw-ic" viewBox="0 0 24 24" aria-hidden="true">
    <path d="M21 11.5a8.5 8.5 0 1 1-4.7-7.6L21 3l-.9 4.7a8.5 8.5 0 0 1 .9 3.8z" />
    <path d="M8 10h8M8 14h5" />
  </svg>
);
const SendIcon = () => (
  <svg className="hiw-ic" viewBox="0 0 24 24" aria-hidden="true">
    <path d="M22 2 11 13" />
    <path d="M22 2l-7 20-4-9-9-4 20-7z" />
  </svg>
);

function SlackRail({ active }: { active: string }) {
  return (
    <div className="hiw-slrail">
      <div className="hiw-ws">{WS_NAME} ▾</div>
      <div className="hiw-slnav"><ThreadsIcon /> {tr("slack.hiw_threads")}</div>
      <div className="hiw-slnav"><SendIcon /> {tr("slack.hiw_drafts")}</div>
      <div className="hiw-sect">{tr("slack.hiw_channels")}</div>
      <div className={"hiw-ch" + (active === "general" ? " on" : "")}># general</div>
      <div className={"hiw-ch" + (active === "launch-room" ? " on" : "")}># launch-room</div>
      <div className="hiw-sect">{tr("slack.hiw_direct_messages")}</div>
      <div className="hiw-slnav"><span className="hiw-pres" />Priya N</div>
      <div className="hiw-slnav"><span className="hiw-pres" />Emma W</div>
      <div className="hiw-sect">{tr("slack.hiw_agents_apps")}</div>
      <div className="hiw-slnav"><span className="hiw-appav">OW</span>OpenWorker</div>
    </div>
  );
}

function SlackWin({ children }: { children: React.ReactNode }) {
  return (
    <div className="hiw-win hiw-sl">
      <div className="hiw-sltop">
        <span className="hiw-dots"><i /><i /><i /></span>
        <span className="hiw-slsearch">⌕ {tr("slack.hiw_search_desc")}</span>
      </div>
      <div className="hiw-slbody">{children}</div>
    </div>
  );
}

/* Slack's two-row message box: formatting toolbar, then + / placeholder / send. */
function SlackComposer({ placeholder }: { placeholder: string }) {
  return (
    <div className="hiw-slcomposer">
      <div className="hiw-slctools">
        <b>B</b><i>I</i><u>U</u><s>S</s><span>⛓</span><span>≔</span><span>≡</span><span>{"</>"}</span>
      </div>
      <div className="hiw-slcrow">
        <span className="hiw-plus">+</span> {placeholder}
        <span className="hiw-send">➤</span>
      </div>
    </div>
  );
}

function SlackDate({ label }: { label: string }) {
  return (
    <div className="hiw-sldate">
      <span>{label} ▾</span>
    </div>
  );
}

function OwWin({ children }: { children: React.ReactNode }) {
  return (
    <div className="hiw-win hiw-ow">
      <div className="hiw-owtop">
        <span className="hiw-dots"><i /><i /><i /></span> OpenWorker
      </div>
      <div className="hiw-owbody">{children}</div>
    </div>
  );
}

function OwRail({ hot, hotSub, glow }: { hot?: string; hotSub?: string; glow?: boolean }) {
  return (
    <div className="hiw-owrail">
      <div className="hiw-brand">OpenWorker</div>
      <div className="hiw-newbtn">+ {tr("slack.hiw_new_session")}</div>
      <div className="hiw-ownav">⌕ {tr("slack.hiw_search")}</div>
      <div className="hiw-ownav">◷ {tr("slack.hiw_automations")}</div>
      <div className="hiw-sect">{tr("slack.hiw_recent")}</div>
      {hot && (
        <div
          className={"hiw-sess hot" + (glow ? " hiw-glow hiw-k" : " hiw-stay")}
          style={glow ? ({ "--d": "2.5s", "--g": "2.9s" } as React.CSSProperties) : undefined}
        >
          <b>{hot}</b>
          {hotSub}
        </div>
      )}
      <div className="hiw-sess"><b>{tr("slack.hiw_jira_linear")}</b>{tr("slack.hiw_coworker")}</div>
    </div>
  );
}

const d = (delay: string, extra?: Record<string, string>) =>
  ({ "--d": delay, ...extra } as React.CSSProperties);

function Msg({
  av, avBg, name, ts, app, children, delay, extra,
}: {
  av: string; avBg: string; name: string; ts: string; app?: boolean;
  children: React.ReactNode; delay?: string; extra?: React.ReactNode;
}) {
  return (
    <div className={"hiw-slm" + (delay ? " hiw-k" : "")} style={delay ? d(delay) : undefined}>
      <span className="hiw-sav" style={{ background: avBg }}>{av}</span>
      <span className="min-w-0">
        <span className="hiw-nm">{name}{app && <span className="hiw-appb">APP</span>}</span>
        <span className="hiw-ts">{ts}</span>
        <br />
        <span>{children}</span>
        {extra}
      </span>
    </div>
  );
}

/* ---- scene 1: mention in a channel → new session, reply via thread panel ---- */
function SceneMention({ meFirst, meInitial }: { meFirst: string; meInitial: string }) {
  return (
    <>
      <span className="hiw-spark" style={d("1.9s")} />
      <Sticky d="3.1s" pos={{ left: "51%", top: "8%" }}>{tr("slack.hiw_mention_new")} →</Sticky>
      <Sticky d="5.8s" r pos={{ left: "27%", bottom: "5%" }}>{tr("slack.hiw_answer_thread")} ↑</Sticky>
      <SlackWin>
        <SlackRail active="launch-room" />
        <div className="hiw-slmain">
          <div className="hiw-slhead"># launch-room <span className="hiw-sub">· 24 {tr("slack.hiw_members")}</span></div>
          <div className="hiw-slmsgs">
            <SlackDate label={tr("slack.hiw_today")} />
            <Msg av="P" avBg="#7c6cd0" name="Priya N" ts="6:31 PM">
              {tr("slack.hiw_msg_signups")}
            </Msg>
            <Msg
              av={meInitial} avBg="#3b82c4" name={meFirst} ts="6:33 PM" delay=".8s"
              extra={
                <span className="hiw-replybar hiw-k" style={d("4.6s")}>
                  <span className="hiw-sav2">OW</span> {tr("slack.hiw_1reply")}
                  <span className="hiw-later">{tr("slack.hiw_today_at")} 6:34 PM</span>
                </span>
              }
            >
              <span className="hiw-men">@OpenWorker</span> {tr("slack.hiw_summarize")}
            </Msg>
          </div>
          <SlackComposer placeholder={tr("slack.hiw_msg_launch")} />
          <div className="hiw-slthread hiw-k" style={d("5.1s")}>
            <div className="hiw-th">{tr("slack.hiw_thread")} <span className="hiw-sub"># launch-room</span><span className="hiw-x">✕</span></div>
            <div className="hiw-tmsgs">
              <Msg av={meInitial} avBg="#3b82c4" name={meFirst} ts="6:33 PM">
                <span className="hiw-men">@OpenWorker</span> {tr("slack.hiw_summarize")}
              </Msg>
              <div className="hiw-cnt">{tr("slack.hiw_1reply")}</div>
              <Msg av="OW" avBg="#4a154b" name="OpenWorker" app ts="6:34 PM">
                {tr("slack.hiw_msg_traction")}
              </Msg>
            </div>
            <div className="hiw-treply">{tr("slack.hiw_reply")}</div>
          </div>
        </div>
      </SlackWin>
      <OwWin>
        <OwRail hot={tr("slack.hiw_summarize_room")} hotSub={tr("slack.hiw_via_slack_now")} glow />
        <div className="hiw-owmain">
          <div className="hiw-owtitle hiw-k" style={d("2.6s")}>
            Summarize #launch-room <span className="hiw-via">via Slack</span>
          </div>
          <div className="hiw-owchat">
            <div className="hiw-bub user hiw-k" style={d("2.8s")}>@OpenWorker {tr("slack.hiw_summarize")}</div>
            <div className="hiw-bub agent hiw-k" style={d("3.6s")}>
              {tr("slack.hiw_reading_thread")} <i>({tr("slack.hiw_replying_slack")})</i>
            </div>
          </div>
          <div className="hiw-owcomposer">{tr("slack.hiw_msg_kp")}</div>
        </div>
      </OwWin>
    </>
  );
}

/* ---- scene 2: mention INSIDE the open thread panel → the same session ---- */
function SceneThread({ meFirst, meInitial }: { meFirst: string; meInitial: string }) {
  return (
    <>
      <span className="hiw-spark" style={d("1.9s")} />
      <Sticky d="3.2s" r pos={{ left: "52%", top: "10%" }}>{tr("slack.hiw_thread_same")} →</Sticky>
      <SlackWin>
        <SlackRail active="launch-room" />
        <div className="hiw-slmain">
          <div className="hiw-slhead"># launch-room <span className="hiw-sub">· 24 {tr("slack.hiw_members")}</span></div>
          <div className="hiw-slmsgs">
            <SlackDate label={tr("slack.hiw_today")} />
            <Msg av="P" avBg="#7c6cd0" name="Priya N" ts="6:31 PM">
              {tr("slack.hiw_msg_signups")}
            </Msg>
            <Msg
              av={meInitial} avBg="#3b82c4" name={meFirst} ts="6:33 PM"
              extra={
                <span className="hiw-replybar">
                  <span className="hiw-sav2">OW</span> {tr("slack.hiw_2replies")}
                  <span className="hiw-later">{tr("slack.hiw_today_at")} 6:36 PM</span>
                </span>
              }
            >
              <span className="hiw-men">@OpenWorker</span> {tr("slack.hiw_summarize")}
            </Msg>
          </div>
          <SlackComposer placeholder={tr("slack.hiw_msg_launch")} />
          {/* thread panel open from the start — the new mentions play INSIDE it */}
          <div className="hiw-slthread">
            <div className="hiw-th">{tr("slack.hiw_thread")} <span className="hiw-sub"># launch-room</span><span className="hiw-x">✕</span></div>
            <div className="hiw-tmsgs">
              <Msg av={meInitial} avBg="#3b82c4" name={meFirst} ts="6:33 PM">
                <span className="hiw-men">@OpenWorker</span> {tr("slack.hiw_summarize")}
              </Msg>
              <div className="hiw-cnt">{tr("slack.hiw_2replies")}</div>
              <Msg av="OW" avBg="#4a154b" name="OpenWorker" app ts="6:34 PM">
                {tr("slack.hiw_msg_traction")}
              </Msg>
              <Msg av="P" avBg="#7c6cd0" name="Priya N" ts="6:36 PM" delay=".8s">
                <span className="hiw-men">@OpenWorker</span> {tr("slack.hiw_break_country")}
              </Msg>
              <Msg av="OW" avBg="#4a154b" name="OpenWorker" app ts="6:36 PM" delay="4.8s">
                {tr("slack.hiw_top_countries")}
              </Msg>
            </div>
            <div className="hiw-treply">{tr("slack.hiw_reply")}</div>
          </div>
        </div>
      </SlackWin>
      <OwWin>
        <div className="hiw-owrail">
          <div className="hiw-brand">OpenWorker</div>
          <div className="hiw-newbtn">+ {tr("slack.hiw_new_session")}</div>
          <div className="hiw-ownav">⌕ {tr("slack.hiw_search")}</div>
          <div className="hiw-ownav">◷ {tr("slack.hiw_automations")}</div>
          <div className="hiw-sect">{tr("slack.hiw_recent")}</div>
          <div className="hiw-sess hot hiw-stay hiw-glow" style={{ "--g": "2.4s" } as React.CSSProperties}>
            <b>{tr("slack.hiw_summarize_room")}</b>{tr("slack.hiw_via_slack")}
          </div>
          <div className="hiw-sess"><b>{tr("slack.hiw_jira_linear")}</b>{tr("slack.hiw_coworker")}</div>
        </div>
        <div className="hiw-owmain">
          <div className="hiw-owtitle">
            {tr("slack.hiw_summarize_room")} <span className="hiw-via">{tr("slack.hiw_via_slack_same")}</span>
          </div>
          <div className="hiw-owchat">
            <div className="hiw-bub agent hiw-stay">{tr("slack.hiw_signups_referrer")}</div>
            <div className="hiw-bub user hiw-k" style={d("2.6s")}>{tr("slack.hiw_break_country")}</div>
            <div className="hiw-bub agent hiw-k" style={d("3.8s")}>
              {tr("slack.hiw_top_countries_full")}
            </div>
          </div>
          <div className="hiw-owcomposer">{tr("slack.hiw_msg_kp")}</div>
        </div>
      </OwWin>
    </>
  );
}

/* ---- scene 3: a teammate's first mention waits for your OK ---- */
function SceneTeammates() {
  return (
    <>
      <span className="hiw-spark" style={d("1.9s")} />
      <Sticky d="3.4s" pos={{ left: "53%", bottom: "10%" }}>{tr("slack.hiw_first_senders")}</Sticky>
      <SlackWin>
        <SlackRail active="launch-room" />
        <div className="hiw-slmain">
          <div className="hiw-slhead"># launch-room <span className="hiw-sub">· 24 {tr("slack.hiw_members")}</span></div>
          <div className="hiw-slmsgs">
            <SlackDate label={tr("slack.hiw_today")} />
            <Msg
              av="P" avBg="#7c6cd0" name="Priya N" ts="6:41 PM" delay=".7s"
              extra={
                <span className="hiw-replybar hiw-k" style={d("5.6s")}>
                  <span className="hiw-sav2">OW</span> {tr("slack.hiw_1reply")}
                  <span className="hiw-later">{tr("slack.hiw_after_allow")}</span>
                </span>
              }
            >
              <span className="hiw-men">@OpenWorker</span> {tr("slack.hiw_pull_numbers")}
            </Msg>
          </div>
          <SlackComposer placeholder={tr("slack.hiw_msg_launch")} />
        </div>
      </SlackWin>
      <OwWin>
        <OwRail hot={tr("slack.hiw_summarize_room")} hotSub={tr("slack.hiw_via_slack")} />
        <div className="hiw-owmain">
          <div className="hiw-owtitle">Slack — {WS_NAME}</div>
          <div className="hiw-waitrow hiw-k hiw-glow" style={d("2s", { "--g": "2.5s" })}>
            <span className="min-w-0"><b>Priya N</b> {tr("slack.hiw_is_waiting")}</span>
            <span className="hiw-allowbtn ml-auto">{tr("slack.hiw_allow_deliver")}</span>
          </div>
          <div className="hiw-waitcap hiw-k" style={d("3.4s")}>
            {tr("slack.hiw_each_teammate_prefix")} <b>{tr("slack.hiw_first")}</b> {tr("slack.hiw_each_teammate_suffix")}
          </div>
        </div>
      </OwWin>
    </>
  );
}