Manifold

"use client";

import { AnimatePresence, LayoutGroup, motion, useInView, type Transition, type Variants } from "motion/react";
import * as React from "react";

import { cn } from "@/lib/utils";
import { useReducedMotion } from "@/registry/default/hooks/use-reduced-motion/use-reduced-motion";
import { Detent } from "@/registry/default/navigation/detent/detent";
import { Conduit } from "@/registry/default/utility/conduit/conduit";

/* ---------------------------------------------------------------- types */

/** Badge shown on a card. The three built-ins get distinct styles; any other string renders neutral. */
export type ManifoldBadge = "Popular" | "New" | "Beta" | (string & {});

/** One integration in the directory. */
export interface ManifoldIntegration {
  /** Stable unique id — passed to `onConnect` / `onDisconnect` and `open(id)`. */
  id: string;
  /** Display name. */
  name: string;
  /** Category name; drives the category tabs. */
  category: string;
  /** One-line description shown on the card and in the sheet. */
  description: string;
  /** Longer copy for the detail sheet. Falls back to `description`. */
  about?: string;
  /** Card badges, e.g. `["Popular"]`, `["New"]`, `["Beta"]`. */
  badges?: ManifoldBadge[];
  /** Initial connected state (the block owns it afterwards; see `onConnectedChange`). */
  connected?: boolean;
  /** "What you can do" bullets in the detail sheet. */
  features?: string[];
  /** Permissions the integration requests, listed in the detail sheet. */
  permissions?: string[];
  /** Custom mark (e.g. your own SVG). Omit for a seeded geometric glyph. */
  mark?: React.ReactNode;
  /** Show this integration in the larger "Featured" hero row (first 3 used). */
  featured?: boolean;
}

/** Imperative verbs exposed through the `ref` prop. */
export interface ManifoldHandle {
  /** Replay the intro (header, featured row and grid cascade). */
  replay: () => void;
  /** Open the detail sheet for an integration id. */
  open: (id: string) => void;
  /** Close the detail sheet if open. */
  close: () => void;
}

export interface ManifoldProps extends Omit<React.ComponentPropsWithoutRef<"section">, "children" | "title"> {
  /** Integrations to list. @default 24 seeded fictional integrations in 6 categories */
  integrations?: ManifoldIntegration[];
  /** Category tab order. @default categories in order of first appearance */
  categories?: string[];
  /** Section eyebrow. @default "Integrations" */
  eyebrow?: React.ReactNode;
  /** Section headline (`<h2>`). @default "Plug into the tools you already use" */
  title?: React.ReactNode;
  /** Supporting copy under the headline. */
  subtitle?: React.ReactNode;
  /** Label for the catch-all tab. @default "All" */
  allLabel?: string;
  /** Show the larger "Featured" hero row (integrations with `featured: true`). Hidden while searching. @default true */
  showFeatured?: boolean;
  /** Your product's mark, shown on the left of the connection beam. @default a neutral seeded mark */
  appMark?: React.ReactNode;
  /** Your product's name, shown under `appMark`. @default "Your workspace" */
  appName?: string;
  /**
   * Called when Connect is pressed. Return a Promise to hold the beam in its
   * pending state — resolve to connect, reject to show the error inline.
   * @default a simulated 1.2s connection
   */
  onConnect?: (id: string) => void | Promise<unknown>;
  /** Called when Disconnect is pressed. Same Promise semantics as `onConnect`. */
  onDisconnect?: (id: string) => void | Promise<unknown>;
  /** Fires after a connect/disconnect settles successfully. */
  onConnectedChange?: (id: string, connected: boolean) => void;
  /** Fires when the detail sheet opens (`id`) or closes (`null`). */
  onOpenChange?: (id: string | null) => void;
  /** Href for the empty-state "Request an integration" link. @default "#" */
  requestHref?: string;
  /** Click handler for the "Request an integration" link (receives the current query). */
  onRequest?: (query: string) => void;
  /** Signature accent (hex) for glows, focus rings, the beam and the Connect button. @default "#f472b6" */
  accentColor?: string;
  /** Imperative handle (`replay()`, `open(id)`, `close()`). React 19 ref-as-prop. */
  ref?: React.Ref<ManifoldHandle>;
  /** Extra classes for the `<section>` root. */
  className?: string;
}

/* ---------------------------------------------------------------- sample data */

const DEFAULT_ACCENT = "#f472b6";

const DEFAULT_INTEGRATIONS: ManifoldIntegration[] = [
  // Communication
  { id: "parlance", name: "Parlance", category: "Communication", description: "Post updates and alerts into team channels.", badges: ["Popular"], connected: true, featured: true,
    about: "Route project activity into the channels where your team already talks. Pick which events post where, and reply to threads without leaving the conversation.",
    features: ["Post new issues and status changes to any channel", "Unfurl links into rich previews", "Create tasks from a message with one shortcut"],
    permissions: ["Read channel names", "Post messages as the app", "Read messages that mention the app"] },
  { id: "beacon-mail", name: "Beacon Mail", category: "Communication", description: "Turn inbound email into tracked conversations.",
    features: ["Forward any inbox to a shared queue", "Thread replies back to the sender", "Auto-tag by sender domain"],
    permissions: ["Read forwarded messages", "Send email on your behalf"] },
  { id: "hallway", name: "Hallway", category: "Communication", description: "Start a video huddle from any record.", badges: ["New"],
    features: ["One-click huddles from a task or doc", "Attach recordings to the record", "Live captions and notes"],
    permissions: ["Create meetings", "Read your calendar availability"] },
  { id: "murmur", name: "Murmur", category: "Communication", description: "Text-message alerts for urgent incidents.",
    features: ["Page on-call by SMS", "Acknowledge by replying", "Quiet hours per person"],
    permissions: ["Send SMS to verified numbers", "Read on-call schedules"] },
  // Developer
  { id: "forgeline", name: "Forgeline", category: "Developer", description: "Link commits and pull requests to work items.", badges: ["Popular"], featured: true,
    about: "Every branch, commit and review shows up next to the work it belongs to. Merges move items forward automatically, so the board stays honest without anyone updating it.",
    features: ["Link branches and pull requests automatically", "Move items when a review merges", "Show build status on every card"],
    permissions: ["Read repository metadata", "Read pull requests and commits", "Create webhooks"] },
  { id: "faultline", name: "Faultline", category: "Developer", description: "Open issues from production errors in one click.",
    features: ["Create an issue from any error group", "Attach stack traces and breadcrumbs", "Resolve errors when the issue closes"],
    permissions: ["Read error groups", "Update error status"] },
  { id: "dockhand", name: "Dockhand CI", category: "Developer", description: "Pipeline status and deploys on every item.", badges: ["Beta"],
    features: ["See pipeline runs on linked items", "Trigger deploys from a release", "Fail-fast alerts on main"],
    permissions: ["Read pipelines", "Trigger deploy jobs"] },
  { id: "toggleworks", name: "Toggleworks", category: "Developer", description: "Tie feature flags to the work that ships them.",
    features: ["Attach flags to items", "Roll out by percentage from the release view", "Audit every toggle"],
    permissions: ["Read flags and environments", "Change rollout percentages"] },
  // Analytics
  { id: "pulsegraph", name: "Pulsegraph", category: "Analytics", description: "Product metrics beside the features that move them.", badges: ["Popular"], featured: true,
    about: "Pin live charts to roadmap items and see whether what you shipped actually moved the number. Funnels, retention and custom events, refreshed every five minutes.",
    features: ["Embed live charts on any item", "Alert when a metric crosses a threshold", "Compare cohorts before and after a release"],
    permissions: ["Read dashboards and saved charts", "Read event definitions"] },
  { id: "cohort-lab", name: "Cohort Lab", category: "Analytics", description: "Retention cohorts and experiment readouts.",
    features: ["Sync experiment results to items", "Weekly retention digests", "Segment by plan or region"],
    permissions: ["Read experiments", "Read cohort definitions"] },
  { id: "lantern", name: "Lantern Metrics", category: "Analytics", description: "Web vitals and uptime for every page.", badges: ["New"],
    features: ["Track page speed per release", "Uptime checks every minute", "Regression alerts on deploy"],
    permissions: ["Read site monitors", "Read performance reports"] },
  { id: "tidewater", name: "Tidewater", category: "Analytics", description: "Sync records to your data warehouse nightly.",
    features: ["Nightly or hourly table sync", "Schema changes handled automatically", "Backfill any date range"],
    permissions: ["Read all workspace records", "Write to a configured warehouse"] },
  // Storage
  { id: "driftwood", name: "Driftwood Drive", category: "Storage", description: "Attach files and folders that stay in sync.", badges: ["Popular"], connected: true,
    features: ["Attach live files to any record", "Preview documents inline", "Keep permissions in step"],
    permissions: ["Read files you pick", "Create share links"] },
  { id: "vaultbox", name: "Vaultbox", category: "Storage", description: "Encrypted storage for sensitive attachments.",
    features: ["Client-side encryption", "Expiring access links", "Full access audit log"],
    permissions: ["Store encrypted files", "Read access logs"] },
  { id: "archivist", name: "Archivist", category: "Storage", description: "Automatic, versioned backups of every record.",
    features: ["Hourly incremental snapshots", "Point-in-time restore", "Export to open formats"],
    permissions: ["Read all workspace records", "Write backup archives"] },
  { id: "strata", name: "Strata DB", category: "Storage", description: "Query records with plain SQL.", badges: ["Beta"],
    features: ["Read-only SQL over your workspace", "Saved queries as views", "Schedule CSV exports"],
    permissions: ["Read all workspace records"] },
  // Payments
  { id: "coinage", name: "Coinage", category: "Payments", description: "See customer plan and revenue on every account.",
    features: ["Show MRR beside each account", "Flag failed payments", "Link invoices to support tickets"],
    permissions: ["Read customers and subscriptions", "Read invoices"] },
  { id: "remit", name: "Remit", category: "Payments", description: "Pay contractors when milestones close.", badges: ["New"],
    features: ["Release payouts from a closed milestone", "Multi-currency payouts", "Approval chains"],
    permissions: ["Create payouts", "Read payee details"] },
  { id: "settle", name: "Settle", category: "Payments", description: "Reconcile payouts against your ledger.",
    features: ["Match deposits to invoices", "Flag mismatches daily", "Month-end close checklist"],
    permissions: ["Read bank transactions", "Read invoices"] },
  { id: "tillpoint", name: "Tillpoint", category: "Payments", description: "In-person sales synced to customer records.",
    features: ["Attach receipts to customers", "Daily sales summary", "Refunds from the record"],
    permissions: ["Read sales", "Issue refunds"] },
  // Automation
  { id: "relay-flows", name: "Relay Flows", category: "Automation", description: "Build multi-step automations without code.", badges: ["Popular"],
    features: ["Trigger on any record change", "Branch on conditions", "Run on a schedule"],
    permissions: ["Read and write workspace records", "Create webhooks"] },
  { id: "timekeep", name: "Timekeep", category: "Automation", description: "Recurring tasks and reminders on a schedule.",
    features: ["Cron-style recurring items", "Snooze and remind", "Holiday-aware calendars"],
    permissions: ["Create items", "Read your calendar"] },
  { id: "switchyard", name: "Switchyard", category: "Automation", description: "Route requests to the right team automatically.", badges: ["Beta"],
    features: ["Rules by keyword, customer or priority", "Round-robin assignment", "Escalate on SLA breach"],
    permissions: ["Read incoming requests", "Assign items"] },
  { id: "hookline", name: "Hookline", category: "Automation", description: "Send signed webhooks for any event.",
    features: ["Signed payloads with retries", "Replay any delivery", "Per-endpoint event filters"],
    permissions: ["Read workspace events", "Send outbound requests"] },
];

/* ---------------------------------------------------------------- helpers */

/** FNV-1a string hash → 32-bit seed. */
function hashString(s: string): number {
  let h = 0x811c9dc5;
  for (let i = 0; i < s.length; i++) {
    h ^= s.charCodeAt(i);
    h = Math.imul(h, 0x01000193);
  }
  return h >>> 0;
}

/** Black or white text, whichever reads against the accent fill. */
function readableOn(hex: string): string {
  const m = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(hex.trim());
  if (!m) return "#0a0a0a";
  let s = m[1];
  if (s.length === 3) s = s.replace(/./g, (c) => c + c);
  const n = parseInt(s, 16);
  const lum = 0.2126 * ((n >> 16) & 255) + 0.7152 * ((n >> 8) & 255) + 0.0722 * (n & 255);
  return lum > 140 ? "#0a0a0a" : "#ffffff";
}

const slug = (s: string) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-");
const ALL = "__all";

const EASE: [number, number, number, number] = [0.22, 1, 0.36, 1];
const SPRING: Transition = { type: "spring", stiffness: 380, damping: 34, mass: 0.8 };
const SHEET_SPRING: Transition = { type: "spring", stiffness: 420, damping: 40, mass: 0.9 };
const FADE: Transition = { duration: 0.2, ease: "easeOut" };

/* ---------------------------------------------------------------- glyphs */

/** Seeded geometric app mark — a white figure on a hued rounded square. Never a real logo. */
function SeededMark({ seed, size = 40, className }: { seed: string; size?: number; className?: string }) {
  const h = hashString(seed);
  const hue = h % 360;
  const shape = (h >>> 9) % 10;
  const rot = ((h >>> 13) % 4) * 90;
  const tilt = ((h >>> 17) % 2) * 20;
  const W = "#ffffff";
  let figure: React.ReactNode;
  switch (shape) {
    case 0:
      figure = (
        <>
          <circle cx="12" cy="12" r="6.2" fill="none" stroke={W} strokeWidth="2.4" />
          <circle cx="12" cy="12" r="2.1" fill={W} />
        </>
      );
      break;
    case 1:
      figure = (
        <>
          <circle cx="9.2" cy="12" r="5.2" fill={W} fillOpacity="0.95" />
          <circle cx="14.8" cy="12" r="5.2" fill={W} fillOpacity="0.5" />
        </>
      );
      break;
    case 2:
      figure = <path d="M12 4.8 19.4 18H4.6Z" fill={W} strokeLinejoin="round" stroke={W} strokeWidth="1.2" />;
      break;
    case 3:
      figure = (
        <>
          <rect x="6.5" y="6.5" width="11" height="11" rx="2" fill="none" stroke={W} strokeWidth="2.2" transform="rotate(45 12 12)" />
          <rect x="10.2" y="10.2" width="3.6" height="3.6" rx="0.8" fill={W} transform="rotate(45 12 12)" />
        </>
      );
      break;
    case 4:
      figure = (
        <>
          <rect x="5" y="13" width="3.4" height="6" rx="1.2" fill={W} fillOpacity="0.6" />
          <rect x="10.3" y="9" width="3.4" height="10" rx="1.2" fill={W} fillOpacity="0.8" />
          <rect x="15.6" y="5" width="3.4" height="14" rx="1.2" fill={W} />
        </>
      );
      break;
    case 5:
      figure = (
        <>
          <path d="M5.5 18.5A13 13 0 0 1 18.5 5.5" fill="none" stroke={W} strokeWidth="2.4" strokeLinecap="round" />
          <path d="M5.5 18.5A7 7 0 0 1 12.5 11.5" fill="none" stroke={W} strokeWidth="2.4" strokeLinecap="round" strokeOpacity="0.65" />
          <circle cx="5.8" cy="18.2" r="1.6" fill={W} />
        </>
      );
      break;
    case 6:
      figure = (
        <>
          <path d="M12 4.5 18.5 8.25v7.5L12 19.5l-6.5-3.75v-7.5Z" fill="none" stroke={W} strokeWidth="2.1" strokeLinejoin="round" />
          <path d="M12 9.2 14.4 10.6v2.8L12 14.8l-2.4-1.4v-2.8Z" fill={W} />
        </>
      );
      break;
    case 7:
      figure = (
        <>
          <rect x="5.5" y="5.5" width="5.6" height="5.6" rx="2.8" fill={W} />
          <rect x="12.9" y="5.5" width="5.6" height="5.6" rx="1.4" fill={W} fillOpacity="0.55" />
          <rect x="5.5" y="12.9" width="5.6" height="5.6" rx="1.4" fill={W} fillOpacity="0.55" />
          <rect x="12.9" y="12.9" width="5.6" height="5.6" rx="1.4" fill={W} fillOpacity="0.8" />
        </>
      );
      break;
    case 8:
      figure = (
        <>
          <path d="m6.5 7 5 5-5 5" fill="none" stroke={W} strokeWidth="2.4" strokeLinecap="round" strokeLinejoin="round" />
          <path d="m12.5 7 5 5-5 5" fill="none" stroke={W} strokeWidth="2.4" strokeLinecap="round" strokeLinejoin="round" strokeOpacity="0.55" />
        </>
      );
      break;
    default:
      figure = (
        <>
          <path d="M5 13a7 7 0 0 1 14 0Z" fill={W} />
          <rect x="5" y="15.4" width="14" height="2.6" rx="1.3" fill={W} fillOpacity="0.6" />
        </>
      );
  }
  return (
    <span
      aria-hidden
      className={cn("relative inline-flex shrink-0 items-center justify-center overflow-hidden", className)}
      style={{
        width: size,
        height: size,
        borderRadius: size * 0.28,
        backgroundImage: `linear-gradient(${140 + tilt}deg, hsl(${hue} 62% 58%), hsl(${(hue + 28) % 360} 58% 36%))`,
        boxShadow: "inset 0 1px 0 rgba(255,255,255,0.28), inset 0 -1px 0 rgba(0,0,0,0.25), 0 1px 2px rgba(0,0,0,0.5)",
      }}
    >
      <svg viewBox="0 0 24 24" width={size * 0.58} height={size * 0.58} style={{ transform: `rotate(${rot}deg)` }}>
        {figure}
      </svg>
    </span>
  );
}

/** Default "your app" mark: neutral plate with an accent figure. */
function DefaultAppMark({ size, accent }: { size: number; accent: string }) {
  return (
    <span
      aria-hidden
      className="inline-flex shrink-0 items-center justify-center border border-white/10 bg-neutral-900"
      style={{
        width: size,
        height: size,
        borderRadius: size * 0.28,
        boxShadow: "inset 0 1px 0 rgba(255,255,255,0.08), 0 1px 2px rgba(0,0,0,0.5)",
      }}
    >
      <svg viewBox="0 0 24 24" width={size * 0.56} height={size * 0.56} fill="none">
        <rect x="4" y="4" width="16" height="16" rx="5" stroke={accent} strokeWidth="2.2" />
        <rect x="9" y="9" width="6" height="6" rx="2" fill={accent} />
      </svg>
    </span>
  );
}

function MarkFor({ item, size, className }: { item: ManifoldIntegration; size: number; className?: string }) {
  if (item.mark) {
    return (
      <span
        aria-hidden
        className={cn("inline-flex shrink-0 items-center justify-center overflow-hidden", className)}
        style={{ width: size, height: size, borderRadius: size * 0.28 }}
      >
        {item.mark}
      </span>
    );
  }
  return <SeededMark seed={item.id} size={size} className={className} />;
}

function SearchGlyph({ className }: { className?: string }) {
  return (
    <svg aria-hidden viewBox="0 0 24 24" className={className} fill="none">
      <circle cx="11" cy="11" r="6.5" stroke="currentColor" strokeWidth="1.8" />
      <path d="m16 16 4 4" stroke="currentColor" strokeWidth="1.8" strokeLinecap="round" />
    </svg>
  );
}

function CheckGlyph({ className }: { className?: string }) {
  return (
    <svg aria-hidden viewBox="0 0 24 24" className={className} fill="none">
      <path d="M5 12.5l4.5 4.5L19 7.5" stroke="currentColor" strokeWidth="2.2" strokeLinecap="round" strokeLinejoin="round" />
    </svg>
  );
}

function CloseGlyph({ className }: { className?: string }) {
  return (
    <svg aria-hidden viewBox="0 0 24 24" className={className} fill="none">
      <path d="M6.5 6.5l11 11M17.5 6.5l-11 11" stroke="currentColor" strokeWidth="1.8" strokeLinecap="round" />
    </svg>
  );
}

function KeyGlyph({ className }: { className?: string }) {
  return (
    <svg aria-hidden viewBox="0 0 24 24" className={className} fill="none">
      <rect x="5" y="10.5" width="14" height="9" rx="2.2" stroke="currentColor" strokeWidth="1.7" />
      <path d="M8.5 10.5V8a3.5 3.5 0 0 1 7 0v2.5" stroke="currentColor" strokeWidth="1.7" />
    </svg>
  );
}

function Spinner({ className }: { className?: string }) {
  return (
    <svg aria-hidden viewBox="0 0 24 24" className={cn("motion-safe:animate-spin", className)} fill="none">
      <circle cx="12" cy="12" r="9" stroke="currentColor" strokeOpacity="0.25" strokeWidth="3" />
      <path d="M21 12a9 9 0 0 0-9-9" stroke="currentColor" strokeWidth="3" strokeLinecap="round" />
    </svg>
  );
}

/* ---------------------------------------------------------------- pieces */

function Badge({ label }: { label: ManifoldBadge }) {
  const popular = label === "Popular";
  const beta = label === "Beta";
  return (
    <span
      className={cn(
        "inline-flex h-5 items-center rounded-full px-2 text-[10.5px] font-medium tracking-wide whitespace-nowrap",
        popular && "text-[color:var(--mf-accent)]",
        label === "New" && "bg-white/[0.08] text-white/80",
        beta && "border border-dashed border-white/20 text-white/55",
        !popular && !beta && label !== "New" && "bg-white/[0.06] text-white/60"
      )}
      style={popular ? { backgroundColor: "color-mix(in srgb, var(--mf-accent) 14%, transparent)" } : undefined}
    >
      {label}
    </span>
  );
}

function ConnectedChip({ reducedMotion }: { reducedMotion: boolean }) {
  return (
    <motion.span
      initial={reducedMotion ? { opacity: 0 } : { opacity: 0, scale: 0.85 }}
      animate={{ opacity: 1, scale: 1 }}
      exit={{ opacity: 0, scale: reducedMotion ? 1 : 0.85 }}
      transition={reducedMotion ? FADE : SPRING}
      className="inline-flex h-5 items-center gap-1.5 rounded-full border border-white/10 bg-white/[0.04] px-2 text-[10.5px] font-medium text-white/80"
    >
      <span className="size-1.5 rounded-full bg-[color:var(--mf-accent)] shadow-[0_0_6px_var(--mf-accent)]" />
      Connected
    </motion.span>
  );
}

/** Cursor-follow accent glow: a lit border ring + a soft inner wash, both keyed to --mx/--my. */
function CardGlow() {
  return (
    <>
      <span
        aria-hidden
        className="pointer-events-none absolute inset-0 rounded-[inherit] opacity-0 transition-opacity duration-300 group-hover/card:opacity-100 group-focus-visible/card:opacity-100"
        style={{
          background:
            "radial-gradient(260px circle at var(--mx, 50%) var(--my, 0%), color-mix(in srgb, var(--mf-accent) 9%, transparent), transparent 70%)",
        }}
      />
      <span
        aria-hidden
        className="pointer-events-none absolute inset-0 rounded-[inherit] p-px opacity-0 transition-opacity duration-300 group-hover/card:opacity-100 group-focus-visible/card:opacity-100"
        style={{
          background: "radial-gradient(180px circle at var(--mx, 50%) var(--my, 0%), var(--mf-accent), transparent 70%)",
          WebkitMask: "linear-gradient(#000 0 0) content-box, linear-gradient(#000 0 0)",
          WebkitMaskComposite: "xor",
          mask: "linear-gradient(#000 0 0) content-box, linear-gradient(#000 0 0)",
          maskComposite: "exclude",
        }}
      />
    </>
  );
}

function trackPointer(e: React.PointerEvent<HTMLElement>) {
  const el = e.currentTarget;
  const r = el.getBoundingClientRect();
  el.style.setProperty("--mx", `${e.clientX - r.left}px`);
  el.style.setProperty("--my", `${e.clientY - r.top}px`);
}

function resetPointer(e: React.FocusEvent<HTMLElement>) {
  // Keyboard focus lights the top edge.
  e.currentTarget.style.setProperty("--mx", "50%");
  e.currentTarget.style.setProperty("--my", "0%");
}

const cardVariants: Variants = {
  hidden: { opacity: 0, y: 12 },
  shown: (delay: number) => ({ opacity: 1, y: 0, transition: { ...SPRING, delay } }),
};

interface CardProps {
  item: ManifoldIntegration;
  connected: boolean;
  delay: number;
  show: boolean;
  enter: boolean;
  layoutId: string;
  reducedMotion: boolean;
  onOpen: (id: string, el: HTMLElement) => void;
  registerRef: (id: string, el: HTMLElement | null) => void;
}

function IntegrationCard({ item, connected, delay, show, enter, layoutId, reducedMotion, onOpen, registerRef }: CardProps) {
  return (
    <motion.li
      layoutId={reducedMotion ? undefined : layoutId}
      layout={!reducedMotion}
      custom={delay}
      variants={cardVariants}
      initial={reducedMotion || !enter ? false : "hidden"}
      animate={show ? "shown" : "hidden"}
      exit={{ opacity: 0, scale: reducedMotion ? 1 : 0.96, transition: { duration: 0.16 } }}
      transition={reducedMotion ? FADE : SPRING}
      className="min-w-0"
    >
      <button
        type="button"
        ref={(el) => registerRef(item.id, el)}
        aria-haspopup="dialog"
        onClick={(e) => onOpen(item.id, e.currentTarget)}
        onPointerMove={trackPointer}
        onFocus={resetPointer}
        className={cn(
          "group/card relative flex h-full w-full flex-col gap-3 rounded-xl border border-white/[0.08] bg-white/[0.02] p-4 text-left",
          "transition-colors duration-200 hover:bg-white/[0.035]",
          "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--mf-accent)] focus-visible:ring-offset-2 focus-visible:ring-offset-neutral-950"
        )}
      >
        <CardGlow />
        <span className="relative flex items-start gap-3">
          <MarkFor item={item} size={40} />
          <span className="flex min-w-0 flex-1 flex-col">
            <span className="truncate text-[14px] font-semibold tracking-[-0.01em] text-white">{item.name}</span>
            <span className="truncate text-[12px] text-white/45">{item.category}</span>
          </span>
          {item.badges?.length ? (
            <span className="flex shrink-0 gap-1">
              {item.badges.slice(0, 2).map((b) => (
                <Badge key={b} label={b} />
              ))}
            </span>
          ) : null}
        </span>
        <span className="relative line-clamp-2 text-[13px] leading-relaxed text-white/60">{item.description}</span>
        <span className="relative mt-auto flex h-5 items-center justify-between">
          <AnimatePresence initial={false} mode="popLayout">
            {connected ? (
              <ConnectedChip key="on" reducedMotion={reducedMotion} />
            ) : (
              <motion.span
                key="off"
                initial={{ opacity: 0 }}
                animate={{ opacity: 1 }}
                exit={{ opacity: 0 }}
                transition={FADE}
                className="text-[12px] text-white/35"
              >
                Not connected
              </motion.span>
            )}
          </AnimatePresence>
          <span className="inline-flex items-center gap-1 text-[12px] font-medium text-white/40 transition-colors group-hover/card:text-white/85 group-focus-visible/card:text-white/85">
            Details
            <span aria-hidden className="transition-transform duration-200 motion-safe:group-hover/card:translate-x-0.5">
              →
            </span>
          </span>
        </span>
      </button>
    </motion.li>
  );
}

function FeaturedCard({
  item,
  connected,
  delay,
  show,
  reducedMotion,
  onOpen,
  registerRef,
}: Omit<CardProps, "enter" | "layoutId">) {
  const hue = hashString(item.id) % 360;
  return (
    <motion.li
      custom={delay}
      variants={cardVariants}
      initial={reducedMotion ? false : "hidden"}
      animate={show ? "shown" : "hidden"}
      className="w-[78%] shrink-0 snap-start @2xl:w-auto"
    >
      <button
        type="button"
        ref={(el) => registerRef(`featured:${item.id}`, el)}
        aria-haspopup="dialog"
        onClick={(e) => onOpen(item.id, e.currentTarget)}
        onPointerMove={trackPointer}
        onFocus={resetPointer}
        className={cn(
          "group/card relative flex h-full w-full flex-col gap-4 overflow-hidden rounded-2xl border border-white/[0.08] bg-neutral-900/60 p-5 text-left",
          "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--mf-accent)] focus-visible:ring-offset-2 focus-visible:ring-offset-neutral-950"
        )}
      >
        {/* Mark-hued aurora so each featured card has its own temperature. */}
        <span
          aria-hidden
          className="pointer-events-none absolute inset-x-0 top-0 h-28 opacity-70"
          style={{
            background: `radial-gradient(70% 100% at 18% 0%, hsl(${hue} 70% 55% / 0.22), transparent 70%)`,
          }}
        />
        <span aria-hidden className="pointer-events-none absolute inset-x-5 top-0 h-px bg-gradient-to-r from-transparent via-white/20 to-transparent" />
        <CardGlow />
        <span className="relative flex items-start justify-between gap-3">
          <MarkFor item={item} size={48} />
          <span className="text-[10.5px] font-medium tracking-[0.14em] text-white/40 uppercase">Featured</span>
        </span>
        <span className="relative flex flex-col gap-1.5">
          <span className="text-[16px] font-semibold tracking-[-0.015em] text-white">{item.name}</span>
          <span className="line-clamp-2 text-[13px] leading-relaxed text-white/60">{item.description}</span>
        </span>
        <span className="relative mt-auto flex h-5 items-center justify-between gap-2">
          <AnimatePresence initial={false} mode="popLayout">
            {connected ? (
              <ConnectedChip key="on" reducedMotion={reducedMotion} />
            ) : (
              <motion.span key="off" initial={{ opacity: 0 }} animate={{ opacity: 1 }} exit={{ opacity: 0 }} transition={FADE} className="text-[12px] text-white/40">
                {item.category}
              </motion.span>
            )}
          </AnimatePresence>
          <span className="inline-flex items-center gap-1 text-[12px] font-medium text-white/55 transition-colors group-hover/card:text-white group-focus-visible/card:text-white">
            {connected ? "Manage" : "Connect"}
            <span aria-hidden className="transition-transform duration-200 motion-safe:group-hover/card:translate-x-0.5">
              →
            </span>
          </span>
        </span>
      </button>
    </motion.li>
  );
}

/* ---------------------------------------------------------------- sheet */

type Status = "idle" | "connecting" | "disconnecting";

interface SheetProps {
  item: ManifoldIntegration;
  connected: boolean;
  status: Status;
  error: string | null;
  accent: string;
  appMark: React.ReactNode;
  appName: string;
  reducedMotion: boolean;
  onClose: () => void;
  onConnect: () => void;
  onDisconnect: () => void;
}

function Sheet({ item, connected, status, error, accent, appMark, appName, reducedMotion, onClose, onConnect, onDisconnect }: SheetProps) {
  const overlayRef = React.useRef<HTMLDivElement>(null);
  const dialogRef = React.useRef<HTMLDivElement>(null);
  const beamRef = React.useRef<HTMLDivElement>(null);
  const fromRef = React.useRef<HTMLDivElement>(null);
  const toRef = React.useRef<HTMLDivElement>(null);
  const [mode, setMode] = React.useState<"side" | "bottom" | null>(null);
  const titleId = React.useId();
  const descId = React.useId();

  // The sheet is position: fixed — its containing block is the viewport, or the
  // nearest transformed / `contain: paint` ancestor. Pick side vs bottom from
  // that box's width before first paint.
  React.useLayoutEffect(() => {
    const el = overlayRef.current;
    if (!el) return;
    const measure = () => setMode(el.getBoundingClientRect().width >= 640 ? "side" : "bottom");
    measure();
    const ro = new ResizeObserver(measure);
    ro.observe(el);
    return () => ro.disconnect();
  }, []);

  React.useEffect(() => {
    if (mode) dialogRef.current?.focus({ preventScroll: true });
  }, [mode]);

  const onKeyDown = (e: React.KeyboardEvent<HTMLDivElement>) => {
    if (e.key === "Escape") {
      e.stopPropagation();
      onClose();
      return;
    }
    if (e.key !== "Tab" || !dialogRef.current) return;
    const nodes = Array.from(
      dialogRef.current.querySelectorAll<HTMLElement>('button:not([disabled]), a[href], input, [tabindex]:not([tabindex="-1"])')
    );
    if (!nodes.length) return;
    const first = nodes[0];
    const last = nodes[nodes.length - 1];
    const active = document.activeElement;
    if (e.shiftKey && (active === first || active === dialogRef.current)) {
      e.preventDefault();
      last.focus();
    } else if (!e.shiftKey && active === last) {
      e.preventDefault();
      first.focus();
    }
  };

  const busy = status !== "idle";
  const beamLive = status === "connecting" || connected;
  const ink = readableOn(accent);
  const features = item.features ?? [];
  const permissions = item.permissions ?? [];
  const side = mode === "side";
  const hidden = side ? { x: "100%" } : { y: "100%" };

  const stateLabel =
    status === "connecting" ? "Connecting…" : status === "disconnecting" ? "Disconnecting…" : connected ? "Connected" : "Not connected";

  return (
    <motion.div
      ref={overlayRef}
      className="fixed inset-0 z-50"
      initial={{ opacity: 1 }}
      animate={{ opacity: 1 }}
      exit={{ opacity: 1, transition: { duration: reducedMotion ? 0.2 : 0.32 } }}
    >
      <motion.div
        aria-hidden
        className="absolute inset-0 bg-black/60 backdrop-blur-[2px]"
        initial={{ opacity: 0 }}
        animate={{ opacity: 1 }}
        exit={{ opacity: 0 }}
        transition={{ duration: 0.24, ease: "easeOut" }}
        onClick={onClose}
      />
      {mode ? (
        <motion.div
          ref={dialogRef}
          role="dialog"
          aria-modal="true"
          aria-labelledby={titleId}
          aria-describedby={descId}
          tabIndex={-1}
          onKeyDown={onKeyDown}
          initial={reducedMotion ? { opacity: 0 } : hidden}
          animate={reducedMotion ? { opacity: 1 } : { x: 0, y: 0 }}
          exit={reducedMotion ? { opacity: 0 } : hidden}
          transition={reducedMotion ? FADE : SHEET_SPRING}
          className={cn(
            "absolute flex flex-col overflow-hidden border-white/[0.08] bg-neutral-950 text-white shadow-[0_0_60px_rgba(0,0,0,0.6)] outline-none",
            side
              ? "inset-y-2 right-2 w-[min(440px,calc(100%-1rem))] rounded-2xl border"
              : "inset-x-0 bottom-0 max-h-[90%] rounded-t-2xl border-t"
          )}
        >
          {!side ? <div aria-hidden className="mx-auto mt-2 h-1 w-10 shrink-0 rounded-full bg-white/15" /> : null}

          <div className="min-h-0 flex-1 overflow-y-auto overscroll-contain">
            {/* Beam header: your app ↔ integration. */}
            <div className="relative border-b border-white/[0.06] px-5 pt-5 pb-6">
              <div
                aria-hidden
                className="pointer-events-none absolute inset-0"
                style={{
                  background: `radial-gradient(60% 90% at 50% 40%, color-mix(in srgb, ${accent} ${beamLive ? 14 : 6}%, transparent), transparent 75%)`,
                  transition: "background 400ms ease",
                }}
              />
              <div className="relative flex items-center justify-between">
                <span className="text-[11px] font-medium tracking-[0.14em] text-white/40 uppercase">Integration</span>
                <button
                  type="button"
                  onClick={onClose}
                  aria-label="Close"
                  className="-mr-1.5 inline-flex size-8 items-center justify-center rounded-lg text-white/55 transition-colors hover:bg-white/[0.06] hover:text-white focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--mf-accent)]"
                >
                  <CloseGlyph className="size-4" />
                </button>
              </div>

              <div ref={beamRef} className="relative mx-auto mt-4 flex max-w-[320px] items-start justify-between">
                {/* Static channel between the marks; the conduit pours light along it while live. */}
                <span
                  aria-hidden
                  className="absolute top-7 right-16 left-16 h-px"
                  style={{
                    backgroundImage: connected
                      ? `linear-gradient(90deg, color-mix(in srgb, ${accent} 55%, transparent), color-mix(in srgb, ${accent} 55%, transparent))`
                      : "repeating-linear-gradient(90deg, rgba(255,255,255,0.22) 0 4px, transparent 4px 8px)",
                  }}
                />
                {beamLive ? (
                  <Conduit
                    key={status === "connecting" ? "pending" : "live"}
                    containerRef={beamRef}
                    fromRef={fromRef}
                    toRef={toRef}
                    pathOpacity={0}
                    pathWidth={2}
                    duration={status === "connecting" ? 1.1 : 2.8}
                    slugColors={["#ffffff", accent, accent]}
                    glowOnReceive={status === "connecting"}
                    className="z-0"
                  />
                ) : null}
                <div className="relative z-10 flex w-24 flex-col items-center gap-2">
                  <div ref={fromRef} className="rounded-2xl">
                    {appMark}
                  </div>
                  <span className="max-w-full truncate text-[12px] text-white/55">{appName}</span>
                </div>
                <motion.span
                  key={stateLabel}
                  initial={reducedMotion ? { opacity: 0 } : { opacity: 0, y: 4 }}
                  animate={{ opacity: 1, y: 0 }}
                  transition={FADE}
                  className={cn(
                    "absolute top-[64px] left-1/2 -translate-x-1/2 rounded-full border px-2 py-0.5 text-[10.5px] font-medium whitespace-nowrap",
                    connected && status === "idle"
                      ? "border-[color:var(--mf-accent)]/40 text-[color:var(--mf-accent)]"
                      : "border-white/10 bg-neutral-950 text-white/55"
                  )}
                  style={connected && status === "idle" ? { backgroundColor: `color-mix(in srgb, ${accent} 10%, #0a0a0a)` } : undefined}
                >
                  {stateLabel}
                </motion.span>
                <div className="relative z-10 flex w-24 flex-col items-center gap-2">
                  <div
                    ref={toRef}
                    className="rounded-2xl transition-shadow duration-500"
                    style={{
                      boxShadow: connected
                        ? `0 0 0 1px color-mix(in srgb, ${accent} 60%, transparent), 0 0 24px -4px ${accent}`
                        : "0 0 0 1px rgba(255,255,255,0)",
                    }}
                  >
                    <MarkFor item={item} size={56} />
                  </div>
                  <span className="max-w-full truncate text-[12px] text-white/55">{item.name}</span>
                </div>
              </div>
            </div>

            <div className="flex flex-col gap-6 px-5 py-5">
              <div className="flex flex-col gap-2">
                <div className="flex flex-wrap items-center gap-2">
                  <h3 id={titleId} className="text-[18px] font-semibold tracking-[-0.015em] text-white">
                    Connect {item.name}
                  </h3>
                  {item.badges?.map((b) => (
                    <Badge key={b} label={b} />
                  ))}
                </div>
                <p className="text-[12px] text-white/40">{item.category}</p>
                <p id={descId} className="text-[13.5px] leading-relaxed text-pretty text-white/65">
                  {item.about ?? item.description}
                </p>
              </div>

              {features.length ? (
                <div className="flex flex-col gap-2.5">
                  <h4 className="text-[11px] font-medium tracking-[0.14em] text-white/40 uppercase">What you can do</h4>
                  <ul className="flex flex-col gap-2">
                    {features.map((f) => (
                      <li key={f} className="flex items-start gap-2.5 text-[13.5px] leading-snug text-white/80">
                        <span
                          className="mt-px inline-flex size-[18px] shrink-0 items-center justify-center rounded-full"
                          style={{ backgroundColor: `color-mix(in srgb, ${accent} 16%, transparent)`, color: accent }}
                        >
                          <CheckGlyph className="size-3" />
                        </span>
                        {f}
                      </li>
                    ))}
                  </ul>
                </div>
              ) : null}

              {permissions.length ? (
                <div className="flex flex-col gap-2.5">
                  <h4 className="text-[11px] font-medium tracking-[0.14em] text-white/40 uppercase">Permissions requested</h4>
                  <ul className="divide-y divide-white/[0.06] rounded-xl border border-white/[0.08] bg-white/[0.02]">
                    {permissions.map((p) => (
                      <li key={p} className="flex items-center gap-2.5 px-3 py-2.5 text-[13px] text-white/70">
                        <KeyGlyph className="size-3.5 shrink-0 text-white/40" />
                        {p}
                      </li>
                    ))}
                  </ul>
                </div>
              ) : null}
            </div>
          </div>

          {/* Action footer */}
          <div className="flex shrink-0 flex-col gap-2 border-t border-white/[0.06] bg-neutral-950 px-5 py-4">
            <AnimatePresence initial={false}>
              {error ? (
                <motion.p
                  role="alert"
                  initial={{ opacity: 0, height: 0 }}
                  animate={{ opacity: 1, height: "auto" }}
                  exit={{ opacity: 0, height: 0 }}
                  transition={FADE}
                  className="text-[12.5px] text-rose-300"
                >
                  {error}
                </motion.p>
              ) : null}
            </AnimatePresence>
            <div className="flex items-center gap-2">
              <motion.button
                type="button"
                layout={!reducedMotion}
                transition={SPRING}
                onClick={connected ? undefined : onConnect}
                disabled={busy}
                aria-disabled={connected || busy}
                className={cn(
                  "relative inline-flex h-10 flex-1 items-center justify-center gap-2 rounded-[10px] px-4 text-[13.5px] font-semibold",
                  "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--mf-accent)] focus-visible:ring-offset-2 focus-visible:ring-offset-neutral-950",
                  connected ? "cursor-default border border-white/10" : "transition-[filter] hover:brightness-110",
                  busy && !connected && "cursor-wait"
                )}
                style={
                  connected
                    ? { backgroundColor: "rgba(255,255,255,0.04)", color: "#ffffff", boxShadow: "0 0 0 0 transparent" }
                    : { backgroundColor: accent, color: ink, boxShadow: `0 6px 24px -10px ${accent}` }
                }
              >
                {status === "connecting" ? (
                  <>
                    <Spinner className="size-4" />
                    Connecting…
                  </>
                ) : connected ? (
                  <>
                    <CheckGlyph className="size-4 text-[color:var(--mf-accent)]" />
                    Connected
                  </>
                ) : (
                  <>Connect {item.name}</>
                )}
              </motion.button>
              <AnimatePresence initial={false} mode="popLayout">
                {connected ? (
                  <motion.button
                    key="disconnect"
                    type="button"
                    initial={{ opacity: 0, x: reducedMotion ? 0 : 8 }}
                    animate={{ opacity: 1, x: 0 }}
                    exit={{ opacity: 0, x: reducedMotion ? 0 : 8 }}
                    transition={reducedMotion ? FADE : SPRING}
                    onClick={onDisconnect}
                    disabled={busy}
                    className="inline-flex h-10 items-center gap-2 rounded-[10px] px-3.5 text-[13px] font-medium text-white/60 transition-colors hover:bg-white/[0.06] hover:text-white focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--mf-accent)] disabled:cursor-wait"
                  >
                    {status === "disconnecting" ? <Spinner className="size-3.5" /> : null}
                    Disconnect
                  </motion.button>
                ) : null}
              </AnimatePresence>
            </div>
          </div>
        </motion.div>
      ) : null}
    </motion.div>
  );
}

/* ---------------------------------------------------------------- main */

/**
 * Manifold — an integrations directory section. A header with a live count
 * and search, an optional "Featured" hero row, and Detent category tabs over
 * a card grid that re-flows with layout springs as you search or filter
 * (with an empty state + "Request an integration" link). Each card carries a
 * seeded geometric mark (never a real logo), badges, and a connected chip;
 * hovering or focusing lights its border with a cursor-follow accent glow.
 * Clicking opens a detail sheet (side sheet on wide containers, bottom sheet
 * on narrow ones; dialog semantics, focus trap, Escape) whose header joins
 * your app mark and the integration's mark with a Conduit beam — Connect
 * fires async `onConnect`, the beam carries light while pending, then the
 * button morphs to "Connected" with a Disconnect ghost and the grid card gains
 * its chip. Reduced motion: final layout, crossfades only.
 *
 * The sheet is `position: fixed`: it covers the viewport, or the nearest
 * ancestor with `transform` / `contain: paint` if you want it confined.
 */
export function Manifold({
  integrations = DEFAULT_INTEGRATIONS,
  categories,
  eyebrow = "Integrations",
  title = "Plug into the tools you already use",
  subtitle = "Connect your stack in a click. Every integration is maintained by us, scoped to the permissions it needs, and can be switched off any time.",
  allLabel = "All",
  showFeatured = true,
  appMark,
  appName = "Your workspace",
  onConnect,
  onDisconnect,
  onConnectedChange,
  onOpenChange,
  requestHref = "#",
  onRequest,
  accentColor = DEFAULT_ACCENT,
  ref,
  className,
  style,
  ...props
}: ManifoldProps) {
  const reducedMotion = useReducedMotion();
  const uid = React.useId().replace(/[:]/g, "");
  const headingId = `${uid}-heading`;
  const [replayKey, setReplayKey] = React.useState(0);
  const [query, setQuery] = React.useState("");
  const [tab, setTab] = React.useState(ALL);
  const [openId, setOpenId] = React.useState<string | null>(null);
  const [announcement, setAnnouncement] = React.useState("");

  // Connected state is owned here, seeded from props (re-seeded when the list changes).
  const seedConnected = React.useCallback(
    (list: ManifoldIntegration[]) => Object.fromEntries(list.map((i) => [i.id, Boolean(i.connected)])),
    []
  );
  const [connectedMap, setConnectedMap] = React.useState<Record<string, boolean>>(() => seedConnected(integrations));
  const [seededFrom, setSeededFrom] = React.useState(integrations);
  if (seededFrom !== integrations) {
    setSeededFrom(integrations);
    setConnectedMap(seedConnected(integrations));
  }
  const [statusMap, setStatusMap] = React.useState<Record<string, Status>>({});
  const [errorMap, setErrorMap] = React.useState<Record<string, string | null>>({});

  const triggerRefs = React.useRef(new Map<string, HTMLElement>());
  const returnFocus = React.useRef<HTMLElement | null>(null);
  const searchRef = React.useRef<HTMLInputElement>(null);

  const cats = React.useMemo(() => {
    if (categories?.length) return categories;
    const seen: string[] = [];
    for (const i of integrations) if (!seen.includes(i.category)) seen.push(i.category);
    return seen;
  }, [categories, integrations]);

  const q = query.trim().toLowerCase();
  const matchesQuery = React.useCallback(
    (i: ManifoldIntegration) =>
      !q || i.name.toLowerCase().includes(q) || i.description.toLowerCase().includes(q) || i.category.toLowerCase().includes(q),
    [q]
  );
  const searched = React.useMemo(() => integrations.filter(matchesQuery), [integrations, matchesQuery]);
  const activeCategory = tab === ALL ? null : (cats.find((c) => slug(c) === tab) ?? null);
  const visible = React.useMemo(
    () => (activeCategory ? searched.filter((i) => i.category === activeCategory) : searched),
    [searched, activeCategory]
  );
  const featured = React.useMemo(() => integrations.filter((i) => i.featured).slice(0, 3), [integrations]);
  const featuredOn = showFeatured && featured.length > 0;
  const featuredShown = featuredOn && !q;

  // Announce result counts after the user filters (not on mount).
  const firstFilter = React.useRef(true);
  React.useEffect(() => {
    if (firstFilter.current) {
      firstFilter.current = false;
      return;
    }
    const t = window.setTimeout(() => {
      const n = visible.length;
      setAnnouncement(
        `${n} ${n === 1 ? "integration" : "integrations"}${activeCategory ? ` in ${activeCategory}` : ""}${q ? ` matching “${query.trim()}”` : ""}.`
      );
    }, 350);
    return () => window.clearTimeout(t);
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, [visible.length, activeCategory, q]);

  const openSheet = React.useCallback(
    (id: string, from?: HTMLElement | null) => {
      if (!integrations.some((i) => i.id === id)) return;
      returnFocus.current =
        from ?? triggerRefs.current.get(id) ?? (typeof document !== "undefined" ? (document.activeElement as HTMLElement | null) : null);
      setErrorMap((m) => ({ ...m, [id]: null }));
      setOpenId(id);
      onOpenChange?.(id);
    },
    [integrations, onOpenChange]
  );

  const closeSheet = React.useCallback(() => {
    setOpenId((cur) => {
      if (cur !== null) onOpenChange?.(null);
      return null;
    });
  }, [onOpenChange]);

  React.useImperativeHandle(
    ref,
    () => ({
      replay: () => {
        setOpenId(null);
        setReplayKey((k) => k + 1);
      },
      open: (id: string) => openSheet(id),
      close: closeSheet,
    }),
    [openSheet, closeSheet]
  );

  const runAction = async (id: string, kind: "connect" | "disconnect") => {
    const item = integrations.find((i) => i.id === id);
    if (!item) return;
    setStatusMap((m) => ({ ...m, [id]: kind === "connect" ? "connecting" : "disconnecting" }));
    setErrorMap((m) => ({ ...m, [id]: null }));
    try {
      if (kind === "connect") {
        if (onConnect) await onConnect(id);
        else await new Promise((r) => window.setTimeout(r, 1200));
      } else if (onDisconnect) {
        await onDisconnect(id);
      } else {
        await new Promise((r) => window.setTimeout(r, 500));
      }
      const next = kind === "connect";
      setConnectedMap((m) => ({ ...m, [id]: next }));
      setAnnouncement(`${item.name} ${next ? "connected" : "disconnected"}.`);
      onConnectedChange?.(id, next);
    } catch (err) {
      const msg =
        err instanceof Error && err.message
          ? err.message
          : kind === "connect"
            ? `Couldn't connect ${item.name}. Try again.`
            : `Couldn't disconnect ${item.name}. Try again.`;
      setErrorMap((m) => ({ ...m, [id]: msg }));
      setAnnouncement(msg);
    } finally {
      setStatusMap((m) => ({ ...m, [id]: "idle" }));
    }
  };

  const registerRef = React.useCallback((id: string, el: HTMLElement | null) => {
    if (el) triggerRefs.current.set(id, el);
    else triggerRefs.current.delete(id);
  }, []);

  const openItem = openId ? (integrations.find((i) => i.id === openId) ?? null) : null;

  return (
    <section
      data-crucible="manifold"
      aria-labelledby={headingId}
      className={cn("@container relative isolate w-full overflow-hidden bg-neutral-950 text-white", className)}
      style={{ ["--mf-accent" as string]: accentColor, ...style }}
      {...props}
    >
      <div aria-hidden className="pointer-events-none absolute inset-x-0 top-0 -z-10 h-[30rem]">
        <div className="absolute inset-x-0 top-0 h-px bg-gradient-to-r from-transparent via-white/12 to-transparent" />
        <div
          className="absolute inset-0"
          style={{
            background: `radial-gradient(55% 70% at 85% 0%, color-mix(in srgb, ${accentColor} 9%, transparent), transparent 70%)`,
          }}
        />
      </div>

      <Body
        key={replayKey}
        uid={uid}
        headingId={headingId}
        reducedMotion={reducedMotion}
        eyebrow={eyebrow}
        title={title}
        subtitle={subtitle}
        total={integrations.length}
        query={query}
        setQuery={setQuery}
        searchRef={searchRef}
        cats={cats}
        tab={tab}
        setTab={setTab}
        allLabel={allLabel}
        searched={searched}
        visible={visible}
        featured={featured}
        featuredOn={featuredOn}
        featuredShown={featuredShown}
        connectedMap={connectedMap}
        onOpen={openSheet}
        registerRef={registerRef}
        requestHref={requestHref}
        onRequest={onRequest}
      />

      <p role="status" aria-live="polite" className="sr-only">
        {announcement}
      </p>

      <AnimatePresence
        onExitComplete={() => {
          const el = returnFocus.current;
          returnFocus.current = null;
          if (el && el.isConnected) el.focus({ preventScroll: true });
        }}
      >
        {openItem ? (
          <Sheet
            key={openItem.id}
            item={openItem}
            connected={Boolean(connectedMap[openItem.id])}
            status={statusMap[openItem.id] ?? "idle"}
            error={errorMap[openItem.id] ?? null}
            accent={accentColor}
            appMark={appMark ?? <DefaultAppMark size={56} accent={accentColor} />}
            appName={appName}
            reducedMotion={reducedMotion}
            onClose={closeSheet}
            onConnect={() => runAction(openItem.id, "connect")}
            onDisconnect={() => runAction(openItem.id, "disconnect")}
          />
        ) : null}
      </AnimatePresence>
    </section>
  );
}

/* ---------------------------------------------------------------- body */

interface BodyProps {
  uid: string;
  headingId: string;
  reducedMotion: boolean;
  eyebrow: React.ReactNode;
  title: React.ReactNode;
  subtitle: React.ReactNode;
  total: number;
  query: string;
  setQuery: (q: string) => void;
  searchRef: React.RefObject<HTMLInputElement | null>;
  cats: string[];
  tab: string;
  setTab: (t: string) => void;
  allLabel: string;
  searched: ManifoldIntegration[];
  visible: ManifoldIntegration[];
  featured: ManifoldIntegration[];
  featuredOn: boolean;
  featuredShown: boolean;
  connectedMap: Record<string, boolean>;
  onOpen: (id: string, el: HTMLElement) => void;
  registerRef: (id: string, el: HTMLElement | null) => void;
  requestHref: string;
  onRequest?: (query: string) => void;
}

function Body({
  uid,
  headingId,
  reducedMotion,
  eyebrow,
  title,
  subtitle,
  total,
  query,
  setQuery,
  searchRef,
  cats,
  tab,
  setTab,
  allLabel,
  searched,
  visible,
  featured,
  featuredOn,
  featuredShown,
  connectedMap,
  onOpen,
  registerRef,
  requestHref,
  onRequest,
}: BodyProps) {
  const headRef = React.useRef<HTMLDivElement>(null);
  const gridRef = React.useRef<HTMLDivElement>(null);
  const headInView = useInView(headRef, { once: true, amount: 0.2 });
  const gridInView = useInView(gridRef, { once: true, amount: 0.05 });
  // Never stuck invisible: if an in-view trigger never fires (print, odd
  // scroll parents), reveal anyway after a beat.
  const [fallback, setFallback] = React.useState(false);
  React.useEffect(() => {
    const t = window.setTimeout(() => setFallback(true), 2400);
    return () => window.clearTimeout(t);
  }, []);
  const hShow = reducedMotion || headInView || fallback;
  const gShow = reducedMotion || gridInView || fallback;

  // Cascade window: during the intro the grid staggers in; afterwards only
  // newly-entering cards fade in place while the rest re-flow.
  const [intro, setIntro] = React.useState(true);
  React.useEffect(() => {
    if (!gShow) return;
    const t = window.setTimeout(() => setIntro(false), 950);
    return () => window.clearTimeout(t);
  }, [gShow]);

  const rise = (delay: number) =>
    reducedMotion
      ? { initial: false as const, animate: { opacity: 1, y: 0 } }
      : {
          initial: { opacity: 0, y: 10 },
          animate: hShow ? { opacity: 1, y: 0 } : { opacity: 0, y: 10 },
          transition: { duration: 0.5, ease: EASE, delay },
        };

  const countIn = (cat: string | null) => (cat ? searched.filter((i) => i.category === cat).length : searched.length);
  const tabLabel = (name: string, n: number) => (
    <span className="flex items-center gap-1.5">
      {name}
      <span className={cn("text-[11px] tabular-nums", n === 0 ? "text-white/25" : "text-white/40")}>{n}</span>
    </span>
  );

  const gridId = `${uid}-grid`;
  const grid =
    visible.length > 0 ? (
      <ul id={gridId} className="grid grid-cols-1 gap-3 @lg:grid-cols-2 @4xl:grid-cols-3">
        <AnimatePresence initial={false} mode="popLayout">
          {visible.map((item, i) => (
            <IntegrationCard
              key={item.id}
              item={item}
              connected={Boolean(connectedMap[item.id])}
              delay={intro ? 0.18 + Math.min(i, 10) * 0.03 : 0}
              show={gShow}
              enter={intro}
              layoutId={`${uid}-card-${item.id}`}
              reducedMotion={reducedMotion}
              onOpen={onOpen}
              registerRef={registerRef}
            />
          ))}
        </AnimatePresence>
      </ul>
    ) : (
      <motion.div
        initial={{ opacity: 0 }}
        animate={{ opacity: 1 }}
        transition={FADE}
        className="flex flex-col items-center gap-3 rounded-2xl border border-dashed border-white/[0.1] px-6 py-14 text-center"
      >
        <span className="inline-flex size-11 items-center justify-center rounded-xl border border-white/10 bg-white/[0.03] text-white/45">
          <SearchGlyph className="size-5" />
        </span>
        <p className="text-[14px] font-medium text-white">
          {query.trim() ? <>No integrations match “{query.trim()}”</> : "Nothing in this category yet"}
        </p>
        <p className="max-w-xs text-[13px] leading-relaxed text-white/50">
          Can&apos;t find what you need? Tell us which tool to support next.
        </p>
        <div className="mt-1 flex flex-wrap items-center justify-center gap-2">
          {query ? (
            <button
              type="button"
              onClick={() => {
                setQuery("");
                searchRef.current?.focus();
              }}
              className="h-9 rounded-[10px] border border-white/10 px-3.5 text-[13px] text-white/75 transition-colors hover:bg-white/[0.05] hover:text-white focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--mf-accent)]"
            >
              Clear search
            </button>
          ) : null}
          <a
            href={requestHref}
            onClick={(e) => {
              if (onRequest) {
                e.preventDefault();
                onRequest(query.trim());
              }
            }}
            className="group/req inline-flex h-9 items-center gap-1 rounded-[10px] px-3.5 text-[13px] font-medium text-[color:var(--mf-accent)] transition-colors hover:bg-white/[0.04] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--mf-accent)]"
          >
            Request an integration
            <span aria-hidden className="transition-transform motion-safe:group-hover/req:translate-x-0.5">
              →
            </span>
          </a>
        </div>
      </motion.div>
    );

  return (
    <div className="mx-auto flex w-full max-w-6xl flex-col gap-8 px-5 py-10 @3xl:gap-10 @3xl:px-10 @3xl:py-14">
      {/* Header + search */}
      <div ref={headRef} className="flex flex-col gap-6 @3xl:flex-row @3xl:items-end @3xl:justify-between">
        <div className="flex max-w-xl flex-col gap-3">
          <motion.div {...rise(0)} className="flex items-center gap-2.5">
            <span className="text-[12px] font-medium tracking-[0.14em] text-[color:var(--mf-accent)] uppercase">{eyebrow}</span>
            <span className="h-3 w-px bg-white/15" />
            <span className="text-[12px] text-white/50 tabular-nums">{total} integrations</span>
          </motion.div>
          <motion.h2
            {...rise(0.05)}
            id={headingId}
            className="text-[26px] leading-[1.15] font-semibold tracking-[-0.025em] text-balance text-white @3xl:text-[34px]"
          >
            {title}
          </motion.h2>
          {subtitle ? (
            <motion.p {...rise(0.1)} className="text-[14px] leading-relaxed text-pretty text-white/55">
              {subtitle}
            </motion.p>
          ) : null}
        </div>
        <motion.div {...rise(0.14)} className="relative w-full shrink-0 @3xl:w-72">
          <SearchGlyph className="pointer-events-none absolute top-1/2 left-3 size-4 -translate-y-1/2 text-white/35" />
          <input
            ref={searchRef}
            type="search"
            value={query}
            onChange={(e) => setQuery(e.target.value)}
            onKeyDown={(e) => {
              if (e.key === "Escape" && query) {
                e.preventDefault();
                setQuery("");
              }
            }}
            placeholder="Search integrations"
            aria-label="Search integrations"
            aria-controls={gridId}
            className={cn(
              "h-10 w-full rounded-[10px] border border-white/[0.08] bg-white/[0.03] pr-9 pl-9 text-[13.5px] text-white placeholder:text-white/35",
              "transition-colors outline-none hover:border-white/15 focus:border-[color:var(--mf-accent)]/60 focus:bg-white/[0.04]",
              "focus-visible:ring-2 focus-visible:ring-[color:var(--mf-accent)]/35",
              "[&::-webkit-search-cancel-button]:appearance-none"
            )}
          />
          {query ? (
            <button
              type="button"
              aria-label="Clear search"
              onClick={() => {
                setQuery("");
                searchRef.current?.focus();
              }}
              className="absolute top-1/2 right-1.5 inline-flex size-7 -translate-y-1/2 items-center justify-center rounded-md text-white/45 transition-colors hover:bg-white/[0.06] hover:text-white focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--mf-accent)]"
            >
              <CloseGlyph className="size-3.5" />
            </button>
          ) : null}
        </motion.div>
      </div>

      {/* Featured hero row — collapses while searching. */}
      {featuredOn ? (
        <AnimatePresence initial={false}>
          {featuredShown ? (
            <motion.div
              key="featured"
              initial={{ opacity: 0, height: 0 }}
              animate={{ opacity: 1, height: "auto" }}
              exit={{ opacity: 0, height: 0 }}
              transition={reducedMotion ? FADE : { duration: 0.32, ease: EASE }}
              className="-mx-5 overflow-hidden @3xl:mx-0"
            >
              <h3 className="sr-only">Featured integrations</h3>
              <ul className="flex snap-x snap-mandatory scroll-px-5 gap-3 overflow-x-auto px-5 pb-1 [scrollbar-width:none] @2xl:grid @2xl:grid-cols-3 @2xl:overflow-visible @3xl:px-0">
                {featured.map((item, i) => (
                  <FeaturedCard
                    key={item.id}
                    item={item}
                    connected={Boolean(connectedMap[item.id])}
                    delay={0.12 + i * 0.06}
                    show={hShow}
                    reducedMotion={reducedMotion}
                    onOpen={onOpen}
                    registerRef={registerRef}
                  />
                ))}
              </ul>
            </motion.div>
          ) : null}
        </AnimatePresence>
      ) : null}

      {/* Category tabs + grid */}
      <div ref={gridRef}>
        <LayoutGroup id={`${uid}-grid`}>
          <Detent
            label="Filter integrations by category"
            value={tab}
            onValueChange={setTab}
            className="gap-5"
            listClassName="max-w-full overflow-x-auto [scrollbar-width:none]"
            panelClassName="focus-visible:ring-[color:var(--mf-accent)]/50"
            items={[
              { value: ALL, label: tabLabel(allLabel, countIn(null)), content: tab === ALL ? grid : null },
              ...cats.map((c) => ({
                value: slug(c),
                label: tabLabel(c, countIn(c)),
                content: tab === slug(c) ? grid : null,
              })),
            ]}
          />
        </LayoutGroup>
      </div>
    </div>
  );
}