{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "faq",
  "type": "registry:block",
  "title": "FAQ",
  "description": "A searchable FAQ with topic tabs and live counts, matches marked in place, answers that open on a smooth measured height, and a copy-link button on every question that deep-links straight to it.",
  "categories": [
    "block",
    "Content"
  ],
  "dependencies": [
    "@base-ui/react",
    "lucide-react",
    "motion"
  ],
  "registryDependencies": [
    "utils",
    "https://coss.com/ui/r/button.json"
  ],
  "files": [
    {
      "path": "registry/devl/faq.tsx",
      "type": "registry:component",
      "content": "\"use client\";\n\nimport { Accordion as AccordionPrimitive } from \"@base-ui/react/accordion\";\nimport { CheckIcon, LinkIcon, PlusIcon, SearchIcon, XIcon } from \"lucide-react\";\nimport { AnimatePresence, motion, MotionConfig, useReducedMotion } from \"motion/react\";\nimport { type ReactNode, useEffect, useId, useMemo, useRef, useState } from \"react\";\nimport { Button } from \"@/components/ui/button\";\nimport { cn } from \"@/lib/utils\";\n\nfunction useReducedMotionSafe() {\n  const prefers = useReducedMotion();\n  const [mounted, setMounted] = useState(false);\n  useEffect(() => setMounted(true), []);\n  return mounted && Boolean(prefers);\n}\n\nexport interface FaqItem {\n  id: string;\n  question: string;\n  answer: string;\n  category: string;\n}\n\nexport interface FaqProps {\n  eyebrow?: string;\n  title?: ReactNode;\n  description?: ReactNode;\n  items: FaqItem[];\n  categories?: string[];\n  contact?: { title: string; text: string; label: string; href: string };\n  className?: string;\n}\n\nconst ease = [0.23, 1, 0.32, 1] as const;\nconst ALL = \"All\";\n\nfunction escape(s: string) {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nfunction Marked({ text, query }: { text: string; query: string }) {\n  const q = query.trim();\n  if (!q) return <>{text}</>;\n  const parts = text.split(new RegExp(`(${escape(q)})`, \"gi\"));\n  return (\n    <>\n      {parts.map((part, i) =>\n        part.toLowerCase() === q.toLowerCase() ? (\n          // biome-ignore lint/suspicious/noArrayIndexKey: stable split\n          <mark className=\"rounded-[calc(var(--radius)*0.3)] bg-warning/25 px-px text-foreground [box-decoration-break:clone]\" key={i}>\n            {part}\n          </mark>\n        ) : (\n          // biome-ignore lint/suspicious/noArrayIndexKey: stable split\n          <span key={i}>{part}</span>\n        ),\n      )}\n    </>\n  );\n}\n\nfunction CopyLink({ id, question, variant }: { id: string; question: string; variant: \"gutter\" | \"inline\" }) {\n  const [copied, setCopied] = useState(false);\n  const timer = useRef<number | undefined>(undefined);\n  useEffect(() => () => window.clearTimeout(timer.current), []);\n  const copy = async () => {\n    const url = `${window.location.origin}${window.location.pathname}${window.location.search}#faq-${id}`;\n    try {\n      await navigator.clipboard.writeText(url);\n    } catch {\n    }\n    window.history.replaceState(null, \"\", `#faq-${id}`);\n    setCopied(true);\n    window.clearTimeout(timer.current);\n    timer.current = window.setTimeout(() => setCopied(false), 1600);\n  };\n  const icon = (\n    <AnimatePresence initial={false} mode=\"popLayout\">\n      <motion.span\n        animate={{ opacity: 1, scale: 1, filter: \"blur(0px)\" }}\n        exit={{ opacity: 0, scale: 0.6, filter: \"blur(2px)\" }}\n        initial={{ opacity: 0, scale: 0.6, filter: \"blur(2px)\" }}\n        key={copied ? \"y\" : \"n\"}\n        transition={{ duration: 0.16, ease }}\n      >\n        {copied ? <CheckIcon className=\"size-3.5 text-success-foreground\" /> : <LinkIcon className=\"size-3.5\" />}\n      </motion.span>\n    </AnimatePresence>\n  );\n\n  if (variant === \"inline\") {\n    return (\n      <button\n        className=\"inline-flex h-7 cursor-pointer items-center gap-1.5 rounded-md px-2 text-muted-foreground text-xs outline-none transition-[background-color,color,translate,scale,rotate] duration-150 ease-out -ms-2 hover:bg-accent hover:text-foreground focus-visible:ring-2 focus-visible:ring-ring active:scale-[0.97]\"\n        onClick={copy}\n        type=\"button\"\n      >\n        {icon}\n        <span aria-live=\"polite\">{copied ? \"Link copied\" : \"Copy link\"}</span>\n      </button>\n    );\n  }\n\n  return (\n    <button\n      aria-label={copied ? \"Link copied\" : `Copy link to “${question}”`}\n      className={cn(\n        \"absolute top-[1.1rem] -left-10 hidden size-8 cursor-pointer items-center justify-center rounded-lg text-muted-foreground opacity-0 outline-none transition-[opacity,background-color,color,translate,scale,rotate] duration-150 ease-out hover:bg-accent hover:text-foreground focus-visible:opacity-100 focus-visible:ring-2 focus-visible:ring-ring active:scale-[0.94] group-hover/item:opacity-100 xl:flex\",\n        copied && \"opacity-100\",\n      )}\n      onClick={copy}\n      tabIndex={-1}\n      type=\"button\"\n    >\n      {icon}\n    </button>\n  );\n}\n\nexport function Faq({\n  eyebrow = \"FAQ\",\n  title = \"Questions, answered\",\n  description,\n  items,\n  categories: categoriesProp,\n  contact,\n  className,\n}: FaqProps) {\n  const reduce = useReducedMotionSafe();\n  const searchId = useId();\n  const pillId = useId();\n  const categories = useMemo(\n    () => [ALL, ...(categoriesProp ?? Array.from(new Set(items.map((i) => i.category))))],\n    [categoriesProp, items],\n  );\n  const [category, setCategory] = useState(ALL);\n  const [query, setQuery] = useState(\"\");\n  const [open, setOpen] = useState<string[]>([]);\n  const listRef = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    const match = window.location.hash.match(/^#faq-(.+)$/);\n    if (!match) return;\n    const id = decodeURIComponent(match[1]);\n    if (!items.some((i) => i.id === id)) return;\n    setOpen([id]);\n    requestAnimationFrame(() =>\n      listRef.current?.querySelector(`[data-faq=\"${CSS.escape(id)}\"]`)?.scrollIntoView({ block: \"center\", behavior: reduce ? \"auto\" : \"smooth\" }),\n    );\n  }, [items, reduce]);\n\n  const q = query.trim().toLowerCase();\n  const visible = items.filter(\n    (i) =>\n      (category === ALL || i.category === category) &&\n      (!q || i.question.toLowerCase().includes(q) || i.answer.toLowerCase().includes(q)),\n  );\n  const counts = (c: string) =>\n    items.filter((i) => (c === ALL || i.category === c) && (!q || `${i.question} ${i.answer}`.toLowerCase().includes(q))).length;\n\n  return (\n    <MotionConfig reducedMotion=\"user\">\n      <section className={cn(\"mx-auto w-full max-w-[1100px]\", className)}>\n        <div className=\"grid gap-10 lg:grid-cols-[minmax(0,0.8fr)_minmax(0,1.4fr)] lg:gap-16\">\n          <div className=\"min-w-0 lg:sticky lg:top-8 lg:self-start\">\n            {eyebrow && <p className=\"font-medium text-muted-foreground text-xs uppercase tracking-widest\">{eyebrow}</p>}\n            <h2 className=\"mt-2 text-balance font-heading font-semibold text-3xl tracking-tight sm:text-4xl\">{title}</h2>\n            {description && <p className=\"mt-3 text-pretty text-muted-foreground text-sm leading-relaxed\">{description}</p>}\n\n            <div className=\"relative mt-7\">\n              <label className=\"sr-only\" htmlFor={searchId}>\n                Search questions\n              </label>\n              <SearchIcon className=\"pointer-events-none absolute top-1/2 left-3 size-4 -translate-y-1/2 text-muted-foreground\" />\n              <input\n                className=\"h-10 w-full rounded-lg border bg-background ps-9 pe-9 text-base shadow-xs/5 outline-none transition-[border-color,box-shadow] duration-150 placeholder:text-muted-foreground/70 focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/24 sm:h-9 sm:text-sm dark:bg-input/32 [&::-webkit-search-cancel-button]:appearance-none\"\n                id={searchId}\n                onChange={(e) => setQuery(e.target.value)}\n                onKeyDown={(e) => e.key === \"Escape\" && setQuery(\"\")}\n                placeholder=\"Search questions\"\n                type=\"search\"\n                value={query}\n              />\n              {query && (\n                <button\n                  aria-label=\"Clear search\"\n                  className=\"absolute top-1/2 right-1.5 flex size-7 -translate-y-1/2 cursor-pointer items-center justify-center rounded-md text-muted-foreground outline-none hover:bg-accent hover:text-foreground focus-visible:ring-2 focus-visible:ring-ring\"\n                  onClick={() => setQuery(\"\")}\n                  type=\"button\"\n                >\n                  <XIcon className=\"size-3.5\" />\n                </button>\n              )}\n            </div>\n\n            <div\n              aria-label=\"Categories\"\n              className=\"-mx-4 mt-4 flex gap-1 overflow-x-auto px-4 [scrollbar-width:none] lg:mx-0 lg:mt-5 lg:flex-col lg:overflow-visible lg:px-0\"\n              role=\"group\"\n            >\n              {categories.map((c) => {\n                const on = c === category;\n                const n = counts(c);\n                return (\n                  <button\n                    aria-pressed={on}\n                    className={cn(\n                      \"relative flex h-8 shrink-0 cursor-pointer items-center justify-between gap-3 rounded-full px-3 text-sm outline-none transition-colors duration-150 focus-visible:ring-2 focus-visible:ring-ring lg:h-9 lg:rounded-lg\",\n                      on ? \"text-foreground\" : \"text-muted-foreground hover:text-foreground\",\n                      n === 0 && !on && \"opacity-50\",\n                    )}\n                    key={c}\n                    onClick={() => setCategory(c)}\n                    type=\"button\"\n                  >\n                    {on && (\n                      <motion.span\n                        className=\"absolute inset-0 rounded-full bg-accent lg:rounded-lg\"\n                        layoutId={pillId}\n                        transition={reduce ? { duration: 0 } : { type: \"spring\", stiffness: 500, damping: 40 }}\n                      />\n                    )}\n                    <span className=\"relative font-medium\">{c}</span>\n                    <span className=\"relative font-mono text-muted-foreground text-xs tabular-nums\">{n}</span>\n                  </button>\n                );\n              })}\n            </div>\n\n            {contact && (\n              <div className=\"mt-8 hidden rounded-2xl border bg-card p-5 shadow-xs/5 lg:block\">\n                <p className=\"font-medium text-sm\">{contact.title}</p>\n                <p className=\"mt-1 text-muted-foreground text-sm leading-relaxed\">{contact.text}</p>\n                <Button\n                  className=\"mt-4 transition-[box-shadow,translate,scale,rotate] duration-150 ease-out active:scale-[0.97]\"\n                  render={<a href={contact.href} />}\n                  size=\"sm\"\n                  variant=\"outline\"\n                >\n                  {contact.label}\n                </Button>\n              </div>\n            )}\n          </div>\n\n          <div className=\"min-w-0\" ref={listRef}>\n            <AccordionPrimitive.Root\n              className={cn(category !== ALL && \"border-t\")}\n              multiple={false}\n              onValueChange={(v) => setOpen(v as string[])}\n              value={open}\n            >\n              <AnimatePresence initial={false} mode=\"popLayout\">\n                {visible.map((item, index) => (\n                  <motion.div\n                    animate={{ opacity: 1 }}\n                    data-faq={item.id}\n                    exit={{ opacity: 0 }}\n                    id={`faq-${item.id}`}\n                    initial={{ opacity: 0 }}\n                    key={item.id}\n                    layout=\"position\"\n                    transition={{ duration: 0.2, ease }}\n                  >\n                    {category === ALL && visible[index - 1]?.category !== item.category && (\n                      <p\n                        className={cn(\n                          \"border-b pb-3 font-medium text-[0.6875rem] text-muted-foreground uppercase tracking-wider\",\n                          index > 0 && \"pt-10\",\n                        )}\n                      >\n                        {item.category}\n                      </p>\n                    )}\n                    <AccordionPrimitive.Item className=\"group/item relative scroll-mt-24 border-b\" value={item.id}>\n                      <AccordionPrimitive.Header className=\"flex items-start gap-2\">\n                        <AccordionPrimitive.Trigger className=\"group/trigger flex flex-1 cursor-pointer items-start gap-4 rounded-md py-5 text-left outline-none focus-visible:ring-2 focus-visible:ring-ring\">\n                          <span className=\"flex-1\">\n                            <span className=\"block text-pretty font-medium text-[0.9375rem] leading-snug\">\n                              <Marked query={query} text={item.question} />\n                            </span>\n                          </span>\n                          <span className=\"flex size-6 shrink-0 items-center justify-center self-center rounded-full border bg-background text-muted-foreground transition-[translate,scale,rotate,background-color,color] duration-200 ease-out group-hover/trigger:text-foreground group-data-[panel-open]/trigger:rotate-45 group-data-[panel-open]/trigger:bg-primary group-data-[panel-open]/trigger:text-primary-foreground group-data-[panel-open]/trigger:border-primary\">\n                            <PlusIcon className=\"size-3.5\" />\n                          </span>\n                        </AccordionPrimitive.Trigger>\n                        <CopyLink id={item.id} question={item.question} variant=\"gutter\" />\n                      </AccordionPrimitive.Header>\n                      <AccordionPrimitive.Panel className=\"h-(--accordion-panel-height) overflow-hidden transition-[height,opacity] duration-250 ease-[cubic-bezier(0.23,1,0.32,1)] data-ending-style:h-0 data-starting-style:h-0 data-ending-style:opacity-0 data-starting-style:opacity-0 motion-reduce:transition-none\">\n                        <div className=\"pe-10 pb-5\">\n                          <p className=\"max-w-prose whitespace-pre-line text-pretty text-muted-foreground text-sm leading-relaxed\">\n                            <Marked query={query} text={item.answer} />\n                          </p>\n                          <div className=\"mt-3\">\n                            <CopyLink id={item.id} question={item.question} variant=\"inline\" />\n                          </div>\n                        </div>\n                      </AccordionPrimitive.Panel>\n                    </AccordionPrimitive.Item>\n                  </motion.div>\n                ))}\n              </AnimatePresence>\n            </AccordionPrimitive.Root>\n\n            <AnimatePresence initial={false}>\n              {visible.length === 0 && (\n                <motion.div\n                  animate={{ opacity: 1, y: 0 }}\n                  className=\"flex flex-col items-center rounded-2xl border border-dashed px-6 py-12 text-center\"\n                  exit={{ opacity: 0 }}\n                  initial={{ opacity: 0, y: 6 }}\n                  transition={{ duration: 0.2, ease }}\n                >\n                  <span className=\"flex size-10 items-center justify-center rounded-full bg-muted text-muted-foreground\">\n                    <SearchIcon className=\"size-4\" />\n                  </span>\n                  <p className=\"mt-4 font-medium text-sm\">\n                    Nothing for “{query.trim()}”{category !== ALL && ` in ${category}`}\n                  </p>\n                  <p className=\"mt-1 max-w-xs text-muted-foreground text-sm\">\n                    Try a different word, or ask us directly. A human replies within a few hours.\n                  </p>\n                  <div className=\"mt-5 flex gap-2\">\n                    <Button onClick={() => { setQuery(\"\"); setCategory(ALL); }} size=\"sm\" variant=\"outline\">\n                      Clear search\n                    </Button>\n                    {contact && (\n                      <Button render={<a href={contact.href} />} size=\"sm\">\n                        {contact.label}\n                      </Button>\n                    )}\n                  </div>\n                </motion.div>\n              )}\n            </AnimatePresence>\n\n            {contact && (\n              <p className=\"mt-6 text-muted-foreground text-sm lg:hidden\">\n                {contact.title}{\" \"}\n                <a className=\"font-medium text-foreground underline underline-offset-4\" href={contact.href}>\n                  {contact.label}\n                </a>\n              </p>\n            )}\n          </div>\n        </div>\n      </section>\n    </MotionConfig>\n  );\n}\n"
    }
  ]
}