@thewhatmatters/wmds 0.2.0 → 0.4.0

package/docs/patterns/sites-pitchkit-insights-and-kit--shareable-pitch-kit.tsx

@@ -1,608 +0,0 @@
-// @thewhatmatters/wmds@0.2.0 · Pattern — shareable PitchKit
-// Storybook: Sites/PitchKit/Insights and kit → Pattern — shareable PitchKit (?path=/story/sites-pitchkit-insights-and-kit--shareable-pitch-kit)
-// Show code — copy verbatim and keep this header; upgrades find pasted patterns by it.
-
-import { useLayoutEffect, useRef, useState, type CSSProperties } from "react";
-import {
-  Avatar,
-  Badge,
-  Button,
-  Card,
-  Chart,
-  Chip,
-  Stat,
-  TextLink,
-  cardSubtitleClasses,
-  cardTitleClasses,
-  chartSeriesConfigFromKeys,
-  type ChartCartesianPoint,
-  type ChartRankedBarItem,
-} from "@thewhatmatters/wmds";
-
-const reachConfig = chartSeriesConfigFromKeys([
-  { key: "typical", label: "Typical reach" },
-  { key: "reach", label: "Daily reach" },
-]);
-
-const compactNumber = new Intl.NumberFormat("en", {
-  notation: "compact",
-  maximumFractionDigits: 1,
-});
-
-
-
-export interface PitchKitCreatorIdentity {
-  displayName?: string;
-  /** Without the @ — shown as @handle, shared as /k/[handle]. */
-  handle: string;
-  profilePictureUrl?: string;
-  followersCount?: number;
-  professionalAccount?: "Business" | "Creator";
-  connected?: boolean;
-  lastSyncedLabel?: string;
-}
-
-function CreatorIdentityStrip({
-  identity,
-  nameAs = "h1",
-  showProfessionalChip = false,
-}: {
-  identity: PitchKitCreatorIdentity;
-  nameAs?: "h1" | "p";
-  showProfessionalChip?: boolean;
-}) {
-  const NameTag = nameAs;
-  const avatarName = identity.displayName ?? identity.handle;
-  const handleLabel = `@${identity.handle}`;
-  const followerLabel =
-    identity.followersCount == null
-      ? null
-      : `${compactNumber.format(identity.followersCount)} followers`;
-  const meta = [handleLabel, followerLabel].filter(Boolean).join(" · ");
-  const showTitleRow =
-    identity.displayName != null ||
-    (showProfessionalChip && identity.professionalAccount != null);
-
-  return (
-    <div className="flex flex-wrap items-center gap-4">
-      <Avatar
-        name={avatarName}
-        src={identity.profilePictureUrl}
-        size="lg"
-      />
-      <div className="flex min-w-0 flex-col gap-1">
-        {showTitleRow ? (
-          <div className="flex flex-wrap items-center gap-2">
-            {identity.displayName != null ? (
-              <NameTag className="type-heading-2 text-fg">
-                {identity.displayName}
-              </NameTag>
-            ) : null}
-            {showProfessionalChip && identity.professionalAccount != null ? (
-              <Chip readOnly size="sm">
-                {identity.professionalAccount}
-              </Chip>
-            ) : null}
-          </div>
-        ) : null}
-        <p className="type-body text-fg text-muted">{meta}</p>
-      </div>
-    </div>
-  );
-}
-
-
-export interface PitchKitPost {
-  id: string;
-  publishedAt: string;
-  imageUrl: string;
-  imageAlt: string;
-  saves: number;
-  reach: number;
-  likes: number;
-  comments: number;
-}
-
-export interface PitchKitContact {
-  email: string;
-  websiteHref: string;
-  websiteLabel: string;
-  location: string;
-}
-
-/** "insufficient" when the 30-day reach series cannot be plotted. */
-export type PitchKitReachState = "resolved" | "insufficient";
-
-export interface PitchKitPageData {
-  identity: PitchKitCreatorIdentity;
-  intro: string;
-  posts: PitchKitPost[];
-  contact: PitchKitContact;
-  brands: PitchKitPastBrand[];
-  countries: ChartRankedBarItem[];
-  reachData: ChartCartesianPoint[];
-}
-
-interface ShareablePitchKitProps extends PitchKitPageData {
-  reachState?: PitchKitReachState;
-  /** Unsigned visitors who are not the kit owner only. */
-  showCreateBand?: boolean;
-}
-
-function pitchKitIntroIsEmpty(intro: string) {
-  return intro.trim().length === 0;
-}
-
-function PublicIntro({ intro }: { intro: string }) {
-  if (pitchKitIntroIsEmpty(intro)) return null;
-  return <p className="type-body text-fg text-fg">{intro}</p>;
-}
-
-export interface PitchKitPastBrand {
-  id: string;
-  name: string;
-  /** Curated mark key — missing or unknown keys use a letter Avatar. */
-  logo_key?: string;
-  result_label?: string;
-}
-
-const PITCHKIT_BRAND_RESULT_MAX = 24;
-const PITCHKIT_BRAND_LOGO_LETTER = "letter";
-
-const pitchKitBrandLogoKeys = [
-  "nike", "adidas", "apple", "google", "meta", "amazon", "spotify", "netflix",
-  "sephora", "glossier", "nordstrom", "target", "walmart", "starbucks",
-  "coca-cola", "pepsi", "samsung", "microsoft", "adobe", "shopify",
-  "uber", "airbnb", "disney", "lululemon", "reebok", "puma",
-  "dior", "chanel", "bmw", "ford", "chase", "visa",
-];
-
-const pastBrandLogoKeySet = new Set(pitchKitBrandLogoKeys);
-
-function resolvePastBrandLogoKey(logoKey: string | null | undefined) {
-  if (logoKey == null || logoKey === "" || logoKey === PITCHKIT_BRAND_LOGO_LETTER) {
-    return undefined;
-  }
-  return pastBrandLogoKeySet.has(logoKey) ? logoKey : undefined;
-}
-
-function pastBrandLogoMonogram(logoKey: string) {
-  const parts = logoKey.split("-");
-  if (parts.length > 1) {
-    return parts.map((part) => part.charAt(0).toUpperCase()).join("").slice(0, 2);
-  }
-  return logoKey.slice(0, 1).toUpperCase();
-}
-
-function normalizePastBrandResult(value: string | null | undefined) {
-  const trimmed = value?.trim() ?? "";
-  if (trimmed.length === 0) return undefined;
-  return trimmed.slice(0, PITCHKIT_BRAND_RESULT_MAX);
-}
-
-function BrandMark({ name, logoKey }: { name: string; logoKey?: string }) {
-  const resolved = resolvePastBrandLogoKey(logoKey);
-  if (resolved == null) {
-    return <Avatar name={name} size="sm" />;
-  }
-
-  return (
-    <span className="flex size-6 shrink-0 items-center justify-center rounded-full bg-fg type-supporting text-muted font-medium uppercase leading-none text-bg" role="img" aria-label={name}>
-      <span aria-hidden>{pastBrandLogoMonogram(resolved)}</span>
-    </span>
-  );
-}
-
-function BrandResultChip({ label }: { label?: string }) {
-  const result = normalizePastBrandResult(label);
-  if (result == null) return null;
-  return <Chip readOnly size="sm">{result}</Chip>;
-}
-
-function BrandLockup({ brand }: { brand: PitchKitPastBrand }) {
-  return (
-    <div className="flex min-w-0 items-center gap-3">
-      <BrandMark name={brand.name} logoKey={brand.logo_key} />
-      <h3 className="type-label text-fg">{brand.name}</h3>
-      <BrandResultChip label={brand.result_label} />
-    </div>
-  );
-}
-
-function PastBrandCard({ brand, className }: { brand: PitchKitPastBrand; className: string }) {
-  return (
-    <Card variant="outlined" shape="rounded" className={className}>
-      <Card.Header start={<BrandLockup brand={brand} />} />
-    </Card>
-  );
-}
-
-function PastBrandsRail({ brands }: { brands: readonly PitchKitPastBrand[] }) {
-  const hostRef = useRef<HTMLDivElement>(null);
-  const measureRef = useRef<HTMLUListElement>(null);
-  const [overflows, setOverflows] = useState(false);
-  const [reduceMotion, setReduceMotion] = useState(false);
-
-  useLayoutEffect(() => {
-    const media = window.matchMedia("(prefers-reduced-motion: reduce)");
-    const updateMotion = () => setReduceMotion(media.matches);
-    updateMotion();
-    media.addEventListener("change", updateMotion);
-    return () => media.removeEventListener("change", updateMotion);
-  }, []);
-
-  useLayoutEffect(() => {
-    const host = hostRef.current;
-    const measure = measureRef.current;
-    if (host == null || measure == null) return;
-
-    const update = () => {
-      setOverflows(measure.scrollWidth > host.clientWidth + 1);
-    };
-    update();
-    const observer = new ResizeObserver(update);
-    observer.observe(host);
-    observer.observe(measure);
-    return () => observer.disconnect();
-  }, [brands]);
-
-  const duration = Math.max(16, brands.length * 4);
-  const showMarquee = overflows && !reduceMotion;
-
-  return (
-    <div
-      ref={hostRef}
-      className="relative col-span-full min-w-0"
-      data-overflow={showMarquee ? "true" : "false"}
-    >
-      <ul ref={measureRef} className="pointer-events-none invisible absolute flex w-max items-center gap-3" aria-hidden>
-        {brands.map((brand) => (
-          <li key={`${brand.id}-measure`}>
-            <PastBrandCard brand={brand} className="w-max max-w-full shrink-0" />
-          </li>
-        ))}
-      </ul>
-      {reduceMotion ? (
-        <ul className="flex min-w-0 flex-wrap items-center gap-3" aria-label="Past brands">
-          {brands.map((brand) => (
-            <li key={brand.id}>
-              <PastBrandCard brand={brand} className="w-max max-w-full shrink-0" />
-            </li>
-          ))}
-        </ul>
-      ) : showMarquee ? (
-        <>
-          <ul className="sr-only" aria-label="Past brands">
-            {brands.map((brand) => {
-              const result = normalizePastBrandResult(brand.result_label);
-              return (
-                <li key={brand.id}>
-                  {result == null ? brand.name : `${brand.name}, ${result}`}
-                </li>
-              );
-            })}
-          </ul>
-          <div className="group overflow-hidden" aria-hidden>
-            <div
-              className="marquee-track flex w-max items-center"
-              style={{ "--marquee-duration": `${duration}s` } as CSSProperties}
-            >
-              <ul className="flex min-w-0 items-center gap-3">
-                {brands.map((brand) => (
-                  <li key={`${brand.id}-loop-a`}>
-                    <PastBrandCard brand={brand} className="w-max max-w-full shrink-0" />
-                  </li>
-                ))}
-              </ul>
-              <ul className="flex min-w-0 items-center gap-3">
-                {brands.map((brand) => (
-                  <li key={`${brand.id}-loop-b`}>
-                    <PastBrandCard brand={brand} className="w-max max-w-full shrink-0" />
-                  </li>
-                ))}
-              </ul>
-            </div>
-          </div>
-        </>
-      ) : (
-        <ul className="flex min-w-0 items-center gap-3" aria-label="Past brands">
-          {brands.map((brand) => (
-            <li key={brand.id}>
-              <PastBrandCard brand={brand} className="w-max max-w-full shrink-0" />
-            </li>
-          ))}
-        </ul>
-      )}
-    </div>
-  );
-}
-
-export function PublicPastBrands({ brands }: { brands: readonly PitchKitPastBrand[] }) {
-  if (brands.length === 0) return null;
-
-  return (
-    <section className="band min-w-0 gap-y-4">
-      <div className="col-span-full flex flex-wrap items-end justify-between gap-3">
-        <h2 className={cardTitleClasses}>Past brands</h2>
-      </div>
-      <PastBrandsRail brands={brands} />
-    </section>
-  );
-}
-
-
-function PublicCreatePitchkitBand() {
-  return (
-    <Card
-      variant="outlined"
-      shape="rounded"
-      bodyTerminal
-      className="col-span-full"
-    >
-      <Card.Header
-        start={<h2 className={cardTitleClasses}>Create your Pitchkit</h2>}
-      />
-      <Card.Body>
-        <div className="flex min-w-0 flex-col gap-4 px-3.5 py-[16px]">
-          <p className="type-body text-fg text-muted">
-            Turn your Instagram into a shareable media kit.
-          </p>
-          <div className="flex flex-wrap items-center gap-3">
-            <Button role="primary">Continue with Instagram</Button>
-          </div>
-        </div>
-      </Card.Body>
-    </Card>
-  );
-}
-
-function PublicReachCard({
-  reachState,
-  reachData,
-}: {
-  reachState: PitchKitReachState;
-  reachData: ChartCartesianPoint[];
-}) {
-  return (
-    <Card
-      variant="outlined"
-      shape="rounded"
-      bodyTerminal
-      className="col-span-full min-w-0 lg:col-span-6"
-    >
-      <Card.Header
-        start={
-          <>
-            <h2 className={cardTitleClasses}>Reach over 30 days</h2>
-            <p className={cardSubtitleClasses}>
-              Typical performance with unusual spikes left visible.
-            </p>
-          </>
-        }
-        end={
-          <Badge variant="neutral" emphasis="muted" size="sm">
-            Graph data
-          </Badge>
-        }
-      />
-      <Card.Body>
-        {reachState === "insufficient" ? (
-          <div
-            className="flex min-w-0 flex-col gap-4 bg-body px-3.5 py-4 rounded-[var(--radius-card-body)] items-center justify-center text-center"
-            style={{ minHeight: 220 }}
-          >
-            <div className="flex max-w-lg flex-col gap-2 items-center text-center">
-              <Badge variant="neutral" emphasis="muted">No data</Badge>
-              <h3 className="type-heading-2 text-fg">No reach data yet</h3>
-              <p className="type-body text-fg text-muted">
-                Connect more Instagram activity to plot the last 30 days.
-              </p>
-            </div>
-          </div>
-        ) : (
-          <div className="flex min-w-0 flex-col gap-4 bg-body px-3.5 py-4 rounded-[var(--radius-card-body)]">
-            <Chart.Cartesian
-              data={reachData}
-              config={reachConfig}
-              periodKind="month"
-              minHeight={220}
-              aria-label="Daily and typical Instagram reach over the last 30 days"
-            />
-            <Chart.Legend config={reachConfig} />
-          </div>
-        )}
-      </Card.Body>
-    </Card>
-  );
-}
-
-function PublicCountries({ countries }: { countries: ChartRankedBarItem[] }) {
-  const topCountries = countries.slice(0, 3);
-  if (topCountries.length === 0) return null;
-
-  return (
-    <Card
-      variant="outlined"
-      shape="rounded"
-      bodyTerminal
-      className="col-span-full min-w-0 lg:col-span-6"
-    >
-      <Card.Header
-        start={
-          <>
-            <h2 className={cardTitleClasses}>Top countries</h2>
-            <p className={cardSubtitleClasses}>
-              Top 3 from Instagram Insights.
-            </p>
-          </>
-        }
-      />
-      <Card.Body>
-        <div className="flex min-w-0 flex-col gap-4 bg-body px-3.5 py-4 rounded-[var(--radius-card-body)]">
-          <Chart.RankedBars
-            aria-label="Audience by country"
-            items={topCountries}
-            animate="initial"
-          />
-        </div>
-      </Card.Body>
-    </Card>
-  );
-}
-
-function ShareablePitchKit({
-  identity,
-  intro,
-  posts,
-  contact,
-  brands,
-  countries,
-  reachData,
-  reachState = "resolved",
-  showCreateBand = true,
-}: ShareablePitchKitProps) {
-  const engagementRate = reachState === "resolved" ? "5.8%" : null;
-  const typicalReach = reachState === "resolved" ? "9.3K" : "—";
-
-  return (
-    <>
-      <section className="col-span-full border-b border-border pb-6">
-        <div className="flex min-w-0 flex-col gap-3">
-          <CreatorIdentityStrip
-            identity={identity}
-            nameAs="h1"
-            showProfessionalChip
-          />
-          <PublicIntro intro={intro} />
-        </div>
-      </section>
-
-      <div
-        role="group"
-        aria-label="Instagram performance summary"
-        className="band gap-y-4"
-      >
-        <Stat className="col-span-2 md:col-span-4 lg:col-span-3" label="Followers" value="84.2K" />
-        {engagementRate != null ? (
-          <Stat className="col-span-2 md:col-span-4 lg:col-span-3" label="Engagement rate" value={engagementRate} />
-        ) : null}
-        <Stat className="col-span-2 md:col-span-4 lg:col-span-3" label="Typical reach" value={typicalReach} />
-        <Stat className="col-span-2 md:col-span-4 lg:col-span-3" label="Typical saves" value="6.1K" />
-      </div>
-
-      <div className="band min-w-0 gap-y-6 [align-items:stretch]">
-        <PublicReachCard reachState={reachState} reachData={reachData} />
-        <PublicCountries countries={countries} />
-      </div>
-
-      <section className="band min-w-0 gap-y-4">
-        <div className="col-span-full flex flex-wrap items-end justify-between gap-3">
-          <div>
-            <h2 className={cardTitleClasses}>Selected posts</h2>
-            <p className="type-body text-fg text-muted">
-              Proof from the current Instagram set.
-            </p>
-          </div>
-        </div>
-        <div className="band col-span-full min-w-0 gap-y-4">
-          {posts.map((post) => (
-            <Card key={post.id} variant="outlined" shape="rounded" className="col-span-full min-w-0 md:col-span-4 lg:col-span-4">
-              <Card.Body>
-                <img
-                  className="aspect-[4/3] w-full bg-body object-cover rounded-[var(--radius-card-body)]"
-                  src={post.imageUrl}
-                  alt={post.imageAlt}
-                />
-              </Card.Body>
-              <Card.Footer>
-                <div className="grid w-full grid-cols-2 gap-3">
-                  {[
-                    ["Likes", post.likes],
-                    ["Comments", post.comments],
-                  ].map(([label, value]) => (
-                    <span key={label} className="flex min-w-0 flex-col gap-1">
-                      <span className="type-supporting font-medium uppercase tracking-wider text-muted text-muted">{label}</span>
-                      <span className="font-mono text-sm tabular-nums text-fg">
-                        {compactNumber.format(value as number)}
-                      </span>
-                    </span>
-                  ))}
-                </div>
-              </Card.Footer>
-            </Card>
-          ))}
-        </div>
-      </section>
-
-      <section className="band min-w-0 gap-y-4">
-        <div className="col-span-full flex flex-wrap items-end justify-between gap-3">
-          <div>
-            <h2 className={cardTitleClasses}>Contact</h2>
-            <p className="type-body text-fg text-muted">
-              Creator-entered details for brand outreach.
-            </p>
-          </div>
-        </div>
-        <Card variant="outlined" padding="md" shape="rounded" className="col-span-full">
-          <div className="flex flex-col gap-3">
-            <div className="flex flex-col gap-1 sm:flex-row sm:items-center sm:justify-between sm:gap-3">
-              <span className="type-supporting font-medium uppercase tracking-wider text-muted text-muted">Email</span>
-              <TextLink href={`mailto:${contact.email}`}>{contact.email}</TextLink>
-            </div>
-            <div className="flex flex-col gap-1 sm:flex-row sm:items-center sm:justify-between sm:gap-3">
-              <span className="type-supporting font-medium uppercase tracking-wider text-muted text-muted">Website</span>
-              <TextLink href={contact.websiteHref} external>{contact.websiteLabel}</TextLink>
-            </div>
-            <div className="flex flex-col gap-1 sm:flex-row sm:items-center sm:justify-between sm:gap-3">
-              <span className="type-supporting font-medium uppercase tracking-wider text-muted text-muted">Location</span>
-              <span className="type-body text-fg text-muted">{contact.location}</span>
-            </div>
-          </div>
-        </Card>
-      </section>
-
-      <PublicPastBrands brands={brands} />
-
-      {showCreateBand ? <PublicCreatePitchkitBand /> : null}
-    </>
-  );
-}
-
-
-export function ShareablePitchKitPage({
-  identity,
-  intro,
-  posts,
-  contact,
-  brands,
-  countries,
-  reachData,
-  reachState = "resolved",
-  showCreateBand = true,
-}: ShareablePitchKitProps) {
-  return (
-    <main className="grid-page min-h-screen bg-body [--grid-column-gap:8px] [--grid-max:1140px] [padding-bottom:44px]">
-      <div className="band pb-4">
-        <header className="col-span-full grid grid-cols-[1fr_auto_1fr] items-center gap-3">
-          <span className="type-heading-4 text-fg text-fg">PitchKit</span>
-        </header>
-      </div>
-
-      <div className="band pt-6 sm:pt-8">
-        <div className="band min-w-0 gap-y-6 sm:gap-y-8">
-          <ShareablePitchKit
-            identity={identity}
-            intro={intro}
-            posts={posts}
-            contact={contact}
-            brands={brands}
-            countries={countries}
-            reachData={reachData}
-            reachState={reachState}
-            showCreateBand={showCreateBand}
-          />
-        </div>
-      </div>
-    </main>
-  );
-}