{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "radix-accordion",
  "title": "Radix Accordion",
  "description": "An animated accordion component built on Radix UI with spring physics, height collapse mask gradient, blur transitions, and gliding layoutId focus ring.",
  "dependencies": [
    "radix-ui",
    "motion",
    "lucide-react",
    "class-variance-authority"
  ],
  "registryDependencies": ["utils", "@soralabs/hooks-use-controlled-state"],
  "files": [
    {
      "path": "registry/ui/radix/accordion/index.tsx",
      "content": "\"use client\";\n\nimport { useControlledState } from \"@/hooks/use-controlled-state\";\nimport { cn } from \"@/lib/utils\";\nimport { cva } from \"class-variance-authority\";\nimport type { VariantProps } from \"class-variance-authority\";\nimport { ChevronDownIcon } from \"lucide-react\";\nimport {\n  AnimatePresence,\n  MotionConfig,\n  motion,\n  useReducedMotion,\n} from \"motion/react\";\nimport type { Transition } from \"motion/react\";\nimport { Accordion as AccordionPrimitive } from \"radix-ui\";\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useId,\n  useMemo,\n  useState,\n} from \"react\";\nimport type { ComponentProps, ReactNode } from \"react\";\n\ntype AccordionItemValue = string | number;\n\ninterface AccordionContextValue {\n  disableAnimation: boolean;\n  disabled: boolean;\n  focusRingClassName?: string;\n  focusRingLayoutId: string;\n  multiple: boolean;\n  openValues: AccordionItemValue[];\n  setOpenValues: (values: AccordionItemValue[]) => void;\n  showFocusRing: boolean;\n  transition: Transition;\n  variant?: \"default\" | \"bordered\" | \"separated\" | \"ghost\";\n}\n\nconst AccordionContext = createContext<AccordionContextValue | null>(null);\n\nfunction useAccordionContext() {\n  const context = useContext(AccordionContext);\n  if (!context) {\n    throw new Error(\n      \"Accordion compound components must be used within an <Accordion>.\"\n    );\n  }\n  return context;\n}\n\ninterface AccordionItemContextValue {\n  disabled: boolean;\n  isFocused: boolean;\n  isOpen: boolean;\n  setIsFocused: (isFocused: boolean) => void;\n  value: AccordionItemValue;\n}\n\nconst AccordionItemContext = createContext<AccordionItemContextValue | null>(\n  null\n);\n\nfunction useAccordionItemContext() {\n  const context = useContext(AccordionItemContext);\n  if (!context) {\n    throw new Error(\n      \"AccordionItem subcomponents must be used within an <AccordionItem>.\"\n    );\n  }\n  return context;\n}\n\nconst accordionVariants = cva(\"flex w-full flex-col\", {\n  variants: {\n    variant: {\n      default: \"\",\n      bordered: \"border-border bg-card/40 rounded-xl border p-2 shadow-xs\",\n      separated: \"gap-2.5\",\n      ghost: \"\",\n    },\n  },\n  defaultVariants: {\n    variant: \"default\",\n  },\n});\n\nconst accordionItemVariants = cva(\"relative transition-colors\", {\n  variants: {\n    variant: {\n      default: \"border-border border-b not-last:border-b\",\n      bordered:\n        \"border-border/70 border-b px-3 not-last:border-b last:border-b-0\",\n      separated: \"border-border bg-card/60 rounded-xl border px-4 shadow-xs\",\n      ghost: \"hover:bg-muted/50 rounded-lg px-3\",\n    },\n  },\n  defaultVariants: {\n    variant: \"default\",\n  },\n});\n\nconst accordionTriggerVariants = cva(\n  \"group/accordion-trigger relative flex flex-1 items-center justify-between py-4 text-left text-sm font-medium transition-all outline-none select-none hover:underline focus-visible:outline-none disabled:pointer-events-none disabled:opacity-50\",\n  {\n    variants: {\n      variant: {\n        default: \"\",\n        bordered: \"py-3.5\",\n        separated: \"py-3.5\",\n        ghost: \"py-3\",\n      },\n    },\n    defaultVariants: {\n      variant: \"default\",\n    },\n  }\n);\n\nconst DEFAULT_SPRING_TRANSITION: Transition = {\n  type: \"spring\",\n  bounce: 0.2,\n  visualDuration: 0.4,\n};\n\nfunction normalizeValues(\n  val?: AccordionItemValue | AccordionItemValue[]\n): AccordionItemValue[] | undefined {\n  if (val === undefined) {\n    return;\n  }\n  if (Array.isArray(val)) {\n    return val;\n  }\n  return [val];\n}\n\ninterface AccordionProps\n  extends\n    Omit<\n      ComponentProps<typeof AccordionPrimitive.Root>,\n      \"value\" | \"defaultValue\" | \"onValueChange\" | \"type\"\n    >,\n    VariantProps<typeof accordionVariants> {\n  /**\n   * The initial expanded value(s) for uncontrolled mode.\n   */\n  defaultValue?: AccordionItemValue | AccordionItemValue[];\n  /**\n   * Whether to disable all motion physics and animations.\n   * @default false\n   */\n  disableAnimation?: boolean;\n  /**\n   * Additional CSS classes for the animated focus ring.\n   */\n  focusRingClassName?: string;\n  /**\n   * Custom layoutId for the focus ring shared layout animation.\n   */\n  focusRingLayoutId?: string;\n  /**\n   * Whether multiple accordion items can be open simultaneously.\n   * @default false\n   */\n  multiple?: boolean;\n  /**\n   * Event handler called when an accordion item expands or collapses.\n   */\n  onValueChange?: (value: AccordionItemValue[]) => void;\n  /**\n   * Whether to render the gliding animated focus ring on keyboard focus.\n   * @default true\n   */\n  showFocusRing?: boolean;\n  /**\n   * Spring transition physics configuration for layout animations.\n   * @default { type: \"spring\", bounce: 0.2, visualDuration: 0.4 }\n   */\n  transition?: Transition;\n  /**\n   * The controlled value of the item(s) that should be expanded.\n   */\n  value?: AccordionItemValue | AccordionItemValue[];\n}\n\n/**\n * Animated Accordion component built on Radix UI with Motion spring physics,\n * blur/mask transitions, gliding layoutId focus ring, and full shadcn/ui customizability.\n */\nfunction Accordion({\n  className,\n  variant = \"default\",\n  value: controlledValueProp,\n  defaultValue: defaultValueProp,\n  onValueChange,\n  multiple = false,\n  disabled = false,\n  disableAnimation = false,\n  transition = DEFAULT_SPRING_TRANSITION,\n  showFocusRing = true,\n  focusRingClassName,\n  focusRingLayoutId: customFocusRingLayoutId,\n  children,\n  ...props\n}: AccordionProps) {\n  const generatedLayoutId = useId();\n  const focusRingLayoutId =\n    customFocusRingLayoutId ?? `accordion-focus-${generatedLayoutId}`;\n\n  const normalizedDefaultValue = useMemo(\n    () => normalizeValues(defaultValueProp) ?? [],\n    [defaultValueProp]\n  );\n  const normalizedControlledValue = useMemo(\n    () => normalizeValues(controlledValueProp),\n    [controlledValueProp]\n  );\n\n  const [openValues, setOpenValues] = useControlledState<AccordionItemValue[]>({\n    defaultValue: normalizedDefaultValue,\n    onChange: onValueChange,\n    value: normalizedControlledValue,\n  });\n\n  const handleMultipleChange = useCallback(\n    (nextValues: string[]) => {\n      setOpenValues(nextValues);\n    },\n    [setOpenValues]\n  );\n\n  const handleSingleChange = useCallback(\n    (nextValue: string) => {\n      setOpenValues(nextValue ? [nextValue] : []);\n    },\n    [setOpenValues]\n  );\n\n  const contextValue = useMemo(\n    () => ({\n      openValues,\n      setOpenValues,\n      multiple: Boolean(multiple),\n      disabled: Boolean(disabled),\n      disableAnimation: Boolean(disableAnimation),\n      transition,\n      showFocusRing: Boolean(showFocusRing),\n      focusRingClassName,\n      focusRingLayoutId,\n      variant: variant ?? \"default\",\n    }),\n    [\n      openValues,\n      setOpenValues,\n      multiple,\n      disabled,\n      disableAnimation,\n      transition,\n      showFocusRing,\n      focusRingClassName,\n      focusRingLayoutId,\n      variant,\n    ]\n  );\n\n  const rootElement = multiple ? (\n    <AccordionPrimitive.Root\n      className={cn(accordionVariants({ variant, className }))}\n      data-slot=\"accordion\"\n      disabled={disabled}\n      onValueChange={handleMultipleChange}\n      type=\"multiple\"\n      value={openValues.map(String)}\n      {...props}\n    >\n      {children}\n    </AccordionPrimitive.Root>\n  ) : (\n    <AccordionPrimitive.Root\n      className={cn(accordionVariants({ variant, className }))}\n      collapsible\n      data-slot=\"accordion\"\n      disabled={disabled}\n      onValueChange={handleSingleChange}\n      type=\"single\"\n      value={\n        openValues[0] === null || openValues[0] === undefined\n          ? \"\"\n          : String(openValues[0])\n      }\n      {...props}\n    >\n      {children}\n    </AccordionPrimitive.Root>\n  );\n\n  return (\n    <AccordionContext.Provider value={contextValue}>\n      <MotionConfig\n        transition={disableAnimation ? { duration: 0 } : transition}\n      >\n        {rootElement}\n      </MotionConfig>\n    </AccordionContext.Provider>\n  );\n}\n\ninterface AccordionItemProps extends Omit<\n  ComponentProps<typeof AccordionPrimitive.Item>,\n  \"value\"\n> {\n  /**\n   * Additional CSS classes for the item container.\n   */\n  className?: string;\n  /**\n   * Unique value identifying this item.\n   */\n  value: AccordionItemValue;\n}\n\n/**\n * Individual expandable item within an Accordion.\n */\nfunction AccordionItem({\n  className,\n  value,\n  disabled = false,\n  children,\n  ...props\n}: AccordionItemProps) {\n  const { openValues, disabled: rootDisabled, variant } = useAccordionContext();\n  const [isFocused, setIsFocused] = useState(false);\n  const isOpen = openValues.some((v) => String(v) === String(value));\n  const isItemDisabled = disabled || rootDisabled;\n\n  const itemContextValue = useMemo(\n    () => ({\n      value,\n      isOpen,\n      isFocused,\n      setIsFocused,\n      disabled: isItemDisabled,\n    }),\n    [value, isOpen, isFocused, isItemDisabled]\n  );\n\n  return (\n    <AccordionItemContext.Provider value={itemContextValue}>\n      <AccordionPrimitive.Item\n        className={cn(accordionItemVariants({ variant, className }))}\n        data-slot=\"accordion-item\"\n        data-state={isOpen ? \"open\" : \"closed\"}\n        disabled={isItemDisabled}\n        value={String(value)}\n        {...props}\n      >\n        {children}\n      </AccordionPrimitive.Item>\n    </AccordionItemContext.Provider>\n  );\n}\n\ntype AccordionHeaderProps = ComponentProps<typeof AccordionPrimitive.Header>;\n\n/**\n * Accessible header container wrapping the accordion trigger button.\n */\nfunction AccordionHeader({\n  className,\n  children,\n  ...props\n}: AccordionHeaderProps) {\n  return (\n    <AccordionPrimitive.Header\n      className={cn(\"flex\", className)}\n      data-slot=\"accordion-header\"\n      {...props}\n    >\n      {children}\n    </AccordionPrimitive.Header>\n  );\n}\n\ninterface AccordionTriggerProps extends ComponentProps<\n  typeof AccordionPrimitive.Trigger\n> {\n  /**\n   * Custom chevron or trailing icon element.\n   */\n  chevron?: ReactNode;\n  /**\n   * Additional CSS class name for the chevron icon.\n   */\n  chevronClassName?: string;\n  /**\n   * Additional CSS class name for the animated focus ring.\n   */\n  focusRingClassName?: string;\n  /**\n   * Whether to hide the rotating chevron indicator.\n   * @default false\n   */\n  hideChevron?: boolean;\n  /**\n   * Whether to display the focus ring on this trigger.\n   * Inherits from root Accordion if not specified.\n   */\n  showFocusRing?: boolean;\n}\n\n/**\n * Interactive button that expands or collapses the accordion panel.\n * Features Motion gliding focus ring, pressed spring tap, and smooth chevron rotation.\n */\nfunction AccordionTrigger({\n  className,\n  children,\n  chevron,\n  chevronClassName,\n  hideChevron = false,\n  focusRingClassName: triggerFocusRingClassName,\n  showFocusRing: triggerShowFocusRing,\n  asChild,\n  onFocus,\n  onBlur,\n  ...props\n}: AccordionTriggerProps) {\n  const {\n    showFocusRing: rootShowFocusRing,\n    focusRingClassName: rootFocusRingClassName,\n    focusRingLayoutId,\n    disableAnimation,\n    transition,\n    variant,\n  } = useAccordionContext();\n  const { isOpen, isFocused, setIsFocused, disabled } =\n    useAccordionItemContext();\n  const prefersReducedMotion = useReducedMotion();\n  const shouldAnimate = !(disableAnimation || prefersReducedMotion);\n\n  const displayFocusRing = triggerShowFocusRing ?? rootShowFocusRing;\n  const mergedFocusRingClassName =\n    triggerFocusRingClassName ?? rootFocusRingClassName;\n\n  const handleFocus = useCallback(\n    (\n      event: Parameters<\n        NonNullable<\n          ComponentProps<typeof AccordionPrimitive.Trigger>[\"onFocus\"]\n        >\n      >[0]\n    ) => {\n      onFocus?.(event);\n      if (event.target.matches(\":focus-visible\")) {\n        setIsFocused(true);\n      }\n    },\n    [onFocus, setIsFocused]\n  );\n\n  const handleBlur = useCallback(\n    (\n      event: Parameters<\n        NonNullable<ComponentProps<typeof AccordionPrimitive.Trigger>[\"onBlur\"]>\n      >[0]\n    ) => {\n      onBlur?.(event);\n      setIsFocused(false);\n    },\n    [onBlur, setIsFocused]\n  );\n\n  if (asChild) {\n    return (\n      <AccordionHeader>\n        <AccordionPrimitive.Trigger\n          asChild\n          className={cn(accordionTriggerVariants({ variant, className }))}\n          data-slot=\"accordion-trigger\"\n          data-state={isOpen ? \"open\" : \"closed\"}\n          disabled={disabled}\n          onBlur={handleBlur}\n          onFocus={handleFocus}\n          {...props}\n        >\n          {children}\n        </AccordionPrimitive.Trigger>\n      </AccordionHeader>\n    );\n  }\n\n  return (\n    <AccordionHeader>\n      <AccordionPrimitive.Trigger\n        asChild\n        className={cn(accordionTriggerVariants({ variant, className }))}\n        data-slot=\"accordion-trigger\"\n        data-state={isOpen ? \"open\" : \"closed\"}\n        disabled={disabled}\n        onBlur={handleBlur}\n        onFocus={handleFocus}\n        {...props}\n      >\n        <motion.button\n          type=\"button\"\n          variants={shouldAnimate ? { pressed: { scale: 0.99 } } : undefined}\n          whileTap={shouldAnimate ? \"pressed\" : undefined}\n        >\n          <span className=\"relative z-10\">{children}</span>\n\n          {!hideChevron && (\n            <span className=\"relative z-10 flex shrink-0 items-center\">\n              {chevron ?? (\n                <motion.div\n                  animate={{ rotate: isOpen ? 180 : 0 }}\n                  className=\"pointer-events-none shrink-0\"\n                  style={{ willChange: \"transform\" }}\n                  transition={shouldAnimate ? transition : { duration: 0 }}\n                >\n                  <ChevronDownIcon\n                    className={cn(\n                      \"text-muted-foreground group-hover/accordion-trigger:text-foreground size-4 transition-colors\",\n                      chevronClassName\n                    )}\n                    data-slot=\"accordion-trigger-icon\"\n                  />\n                </motion.div>\n              )}\n            </span>\n          )}\n\n          {displayFocusRing && isFocused && shouldAnimate && (\n            <motion.div\n              className={cn(\n                \"bg-accent/60 ring-ring/50 pointer-events-none absolute -inset-1 z-0 rounded-lg ring-2\",\n                mergedFocusRingClassName\n              )}\n              data-slot=\"accordion-focus-ring\"\n              layoutId={focusRingLayoutId}\n              transition={{ type: \"spring\", visualDuration: 0.2, bounce: 0.2 }}\n              variants={{ pressed: { scale: 0.98 } }}\n            />\n          )}\n        </motion.button>\n      </AccordionPrimitive.Trigger>\n    </AccordionHeader>\n  );\n}\n\nconst contentVariants = {\n  open: {\n    height: \"auto\",\n    maskImage: \"linear-gradient(to bottom, black 100%, transparent 100%)\",\n  },\n  closed: {\n    height: 0,\n    maskImage: \"linear-gradient(to bottom, black 50%, transparent 100%)\",\n  },\n};\n\nconst innerVariants = {\n  open: {\n    filter: \"blur(0px)\",\n    opacity: 1,\n  },\n  closed: {\n    filter: \"blur(2px)\",\n    opacity: 0,\n  },\n};\n\nconst staticContentVariants = {\n  open: { height: \"auto\" },\n  closed: { height: 0 },\n};\n\nconst staticInnerVariants = {\n  open: { opacity: 1, filter: \"none\" },\n  closed: { opacity: 0, filter: \"none\" },\n};\n\ninterface AccordionContentProps extends ComponentProps<\n  typeof AccordionPrimitive.Content\n> {\n  /**\n   * Additional CSS classes for the inner wrapper element.\n   */\n  innerClassName?: string;\n}\n\n/**\n * Collapsible panel containing the accordion content.\n * Features Motion height collapse, gradient mask fading, and blur transitions.\n */\nfunction AccordionContent({\n  className,\n  innerClassName,\n  children,\n  ...props\n}: AccordionContentProps) {\n  const { disableAnimation, transition } = useAccordionContext();\n  const { isOpen } = useAccordionItemContext();\n  const prefersReducedMotion = useReducedMotion();\n  const shouldAnimate = !(disableAnimation || prefersReducedMotion);\n\n  return (\n    <AccordionPrimitive.Content\n      className={cn(\"overflow-hidden text-sm\", className)}\n      data-slot=\"accordion-content\"\n      data-state={isOpen ? \"open\" : \"closed\"}\n      forceMount\n      {...props}\n    >\n      <AnimatePresence initial={false}>\n        {isOpen && (\n          <motion.div\n            animate=\"open\"\n            className=\"overflow-hidden\"\n            exit=\"closed\"\n            initial=\"closed\"\n            key=\"accordion-panel-content\"\n            transition={shouldAnimate ? transition : { duration: 0 }}\n            variants={shouldAnimate ? contentVariants : staticContentVariants}\n          >\n            <motion.div\n              animate=\"open\"\n              exit=\"closed\"\n              initial=\"closed\"\n              transition={shouldAnimate ? transition : { duration: 0 }}\n              variants={shouldAnimate ? innerVariants : staticInnerVariants}\n            >\n              <div\n                className={cn(\n                  \"text-muted-foreground [&_a]:hover:text-foreground pt-0 pb-4 text-sm leading-relaxed [&_a]:underline [&_a]:underline-offset-3 [&_p:not(:last-child)]:mb-4\",\n                  innerClassName\n                )}\n              >\n                {children}\n              </div>\n            </motion.div>\n          </motion.div>\n        )}\n      </AnimatePresence>\n    </AccordionPrimitive.Content>\n  );\n}\n\nexport type {\n  AccordionContentProps,\n  AccordionHeaderProps,\n  AccordionItemProps,\n  AccordionProps,\n  AccordionTriggerProps,\n};\nexport {\n  Accordion,\n  Accordion as RadixAccordion,\n  Accordion as default,\n  AccordionContent,\n  AccordionHeader,\n  AccordionItem,\n  AccordionTrigger,\n  accordionItemVariants,\n  accordionTriggerVariants,\n  accordionVariants,\n  useAccordionContext,\n  useAccordionItemContext,\n};\n",
      "type": "registry:ui",
      "target": "components/sora-ui/radix/accordion.tsx"
    }
  ],
  "meta": {
    "agentMetadata": {
      "intent": "Expand and collapse related content sections inline.",
      "role": "disclosure",
      "a11yConstraints": [
        "Keep each trigger keyboard accessible and associated with its panel."
      ],
      "motionEngine": "Motion layout-height morphing with spring chevron transitions.",
      "compositionRules": [
        "Use one AccordionItem per independently discoverable section."
      ],
      "compositionRecipes": ["Use radix/accordion for FAQ sections."]
    },
    "demoProps": {
      "Accordion": {
        "variant": {
          "value": "default",
          "options": {
            "Default": "default",
            "Bordered": "bordered",
            "Separated": "separated",
            "Ghost": "ghost"
          }
        },
        "multiple": {
          "value": false
        },
        "showFocusRing": {
          "value": true
        },
        "disableAnimation": {
          "value": false
        }
      }
    }
  },
  "type": "registry:ui"
}
