{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "radix-context-menu",
  "title": "Radix Context Menu",
  "description": "An accessible context menu built on Radix UI with smooth Motion spring scale and submenu slide animations.",
  "dependencies": ["radix-ui", "motion", "lucide-react"],
  "registryDependencies": ["utils", "@soralabs/hooks-use-controlled-state"],
  "files": [
    {
      "path": "registry/ui/radix/context-menu/index.tsx",
      "content": "\"use client\";\n\nimport { useControlledState } from \"@/hooks/use-controlled-state\";\nimport { cn } from \"@/lib/utils\";\nimport { CheckIcon, ChevronRightIcon } from \"lucide-react\";\nimport { AnimatePresence, motion, useReducedMotion } from \"motion/react\";\nimport { ContextMenu as ContextMenuPrimitive, Direction } from \"radix-ui\";\nimport { createContext, useContext, useMemo } from \"react\";\nimport type { ComponentProps } from \"react\";\n\ninterface ContextMenuContextValue {\n  open: boolean;\n  setOpen: (open: boolean) => void;\n}\n\nconst ContextMenuContext = createContext<ContextMenuContextValue | null>(null);\n\nfunction useContextMenuContext() {\n  return useContext(ContextMenuContext);\n}\n\ninterface ContextMenuSubContextValue {\n  open: boolean;\n  setOpen: (open: boolean) => void;\n}\n\nconst ContextMenuSubContext = createContext<ContextMenuSubContextValue | null>(\n  null\n);\n\nfunction useContextMenuSubContext() {\n  return useContext(ContextMenuSubContext);\n}\n\ninterface ContextMenuProps extends ComponentProps<\n  typeof ContextMenuPrimitive.Root\n> {\n  /**\n   * The default open state when uncontrolled.\n   * @default false\n   */\n  defaultOpen?: boolean;\n  /**\n   * The controlled open state of the context menu.\n   */\n  open?: boolean;\n}\n\n/**\n * Root container for the Context Menu component powered by Radix UI and Motion.\n */\nfunction ContextMenu({\n  open: controlledOpen,\n  defaultOpen = false,\n  onOpenChange,\n  children,\n  ...props\n}: ContextMenuProps) {\n  const [open, setOpen] = useControlledState({\n    defaultValue: defaultOpen,\n    onChange: onOpenChange,\n    value: controlledOpen,\n  });\n\n  const contextValue = useMemo(\n    () => ({ open: Boolean(open), setOpen }),\n    [open, setOpen]\n  );\n\n  return (\n    <ContextMenuContext.Provider value={contextValue}>\n      <ContextMenuPrimitive.Root\n        data-slot=\"context-menu\"\n        onOpenChange={(nextOpen) => {\n          setOpen(nextOpen);\n        }}\n        {...props}\n      >\n        {children}\n      </ContextMenuPrimitive.Root>\n    </ContextMenuContext.Provider>\n  );\n}\n\ntype ContextMenuPortalProps = ComponentProps<\n  typeof ContextMenuPrimitive.Portal\n>;\n\n/**\n * Portals the context menu content into the document body.\n */\nfunction ContextMenuPortal({ ...props }: ContextMenuPortalProps) {\n  return (\n    <ContextMenuPrimitive.Portal data-slot=\"context-menu-portal\" {...props} />\n  );\n}\n\ntype ContextMenuTriggerProps = ComponentProps<\n  typeof ContextMenuPrimitive.Trigger\n>;\n\n/**\n * The target element that opens the context menu on right click or long press.\n */\nfunction ContextMenuTrigger({ className, ...props }: ContextMenuTriggerProps) {\n  return (\n    <ContextMenuPrimitive.Trigger\n      className={cn(\"select-none\", className)}\n      data-slot=\"context-menu-trigger\"\n      {...props}\n    />\n  );\n}\n\ninterface ContextMenuContentProps extends ComponentProps<\n  typeof ContextMenuPrimitive.Content\n> {\n  /**\n   * Whether to disable Motion spring physics and animations.\n   * @default false\n   */\n  disableAnimation?: boolean;\n}\n\n/**\n * Context menu popup container with smooth Motion spring scale and opacity entrance/exit animations.\n */\nfunction ContextMenuContent({\n  className,\n  alignOffset = 4,\n  collisionPadding = 8,\n  disableAnimation = false,\n  children,\n  asChild: _asChild,\n  style,\n  ...props\n}: ContextMenuContentProps) {\n  const context = useContextMenuContext();\n  const prefersReducedMotion = useReducedMotion();\n  const isOpen = context ? context.open : true;\n  const shouldAnimate = !(disableAnimation || prefersReducedMotion);\n\n  return (\n    <AnimatePresence>\n      {isOpen && (\n        <ContextMenuPrimitive.Portal forceMount>\n          <ContextMenuPrimitive.Content\n            alignOffset={alignOffset}\n            asChild\n            className={cn(\n              \"border-border bg-popover/95 text-popover-foreground ring-foreground/5 z-50 max-h-(--radix-context-menu-content-available-height) min-w-44 overflow-x-hidden overflow-y-auto rounded-xl border p-1 shadow-xl ring-1 backdrop-blur-md outline-none\",\n              className\n            )}\n            collisionPadding={collisionPadding}\n            data-slot=\"context-menu-content\"\n            forceMount\n            {...props}\n          >\n            <motion.div\n              animate={{ opacity: 1, scale: 1 }}\n              exit={\n                shouldAnimate\n                  ? {\n                      opacity: 0,\n                      scale: 0.9,\n                      transition: {\n                        duration: 0.1,\n                      },\n                    }\n                  : { opacity: 0 }\n              }\n              initial={\n                shouldAnimate ? { opacity: 0, scale: 0.9 } : { opacity: 0 }\n              }\n              style={{ originX: 0, originY: 0, ...style }}\n              transition={\n                shouldAnimate\n                  ? {\n                      type: \"spring\",\n                      stiffness: 400,\n                      damping: 20,\n                      opacity: { duration: 0.2 },\n                    }\n                  : { duration: 0 }\n              }\n            >\n              {children}\n            </motion.div>\n          </ContextMenuPrimitive.Content>\n        </ContextMenuPrimitive.Portal>\n      )}\n    </AnimatePresence>\n  );\n}\n\ntype ContextMenuGroupProps = ComponentProps<typeof ContextMenuPrimitive.Group>;\n\n/**\n * Groups related context menu items together.\n */\nfunction ContextMenuGroup({ ...props }: ContextMenuGroupProps) {\n  return (\n    <ContextMenuPrimitive.Group data-slot=\"context-menu-group\" {...props} />\n  );\n}\n\ninterface ContextMenuLabelProps extends ComponentProps<\n  typeof ContextMenuPrimitive.Label\n> {\n  /**\n   * Whether to indent the label for alignment with checkable items.\n   * @default false\n   */\n  inset?: boolean;\n}\n\n/**\n * Section label for a group of context menu items.\n * Must be used inside `<ContextMenuGroup>` or `<ContextMenuRadioGroup>`.\n */\nfunction ContextMenuLabel({\n  className,\n  inset,\n  ...props\n}: ContextMenuLabelProps) {\n  return (\n    <ContextMenuPrimitive.Label\n      className={cn(\n        \"text-muted-foreground px-2 py-1.5 text-xs font-semibold data-inset:pl-8\",\n        className\n      )}\n      data-inset={inset}\n      data-slot=\"context-menu-label\"\n      {...props}\n    />\n  );\n}\n\ninterface ContextMenuItemProps extends ComponentProps<\n  typeof ContextMenuPrimitive.Item\n> {\n  /**\n   * Whether to indent the item for alignment with checkable items.\n   * @default false\n   */\n  inset?: boolean;\n  /**\n   * Visual style variant of the item.\n   * @default \"default\"\n   */\n  variant?: \"default\" | \"destructive\";\n}\n\n/**\n * An actionable item within the context menu.\n */\nfunction ContextMenuItem({\n  className,\n  inset,\n  variant = \"default\",\n  ...props\n}: ContextMenuItemProps) {\n  return (\n    <ContextMenuPrimitive.Item\n      className={cn(\n        \"group/context-menu-item focus:bg-accent focus:text-accent-foreground not-data-[variant=destructive]:focus:**:text-accent-foreground data-[variant=destructive]:data-highlighted:bg-destructive/10 data-[variant=destructive]:data-highlighted:text-destructive data-highlighted:bg-accent data-[variant=destructive]:text-destructive data-highlighted:text-accent-foreground data-[variant=destructive]:focus:bg-destructive/10 data-[variant=destructive]:focus:text-destructive not-data-[variant=destructive]:data-highlighted:**:text-accent-foreground dark:data-[variant=destructive]:data-highlighted:bg-destructive/20 dark:data-[variant=destructive]:focus:bg-destructive/20 focus:*:[svg]:text-accent-foreground data-[variant=destructive]:*:[svg]:text-destructive data-highlighted:*:[svg]:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-md px-2 py-1.5 text-sm outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 data-inset:pl-8 rtl:data-inset:pr-8 rtl:data-inset:pl-2 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4\",\n        className\n      )}\n      data-inset={inset}\n      data-slot=\"context-menu-item\"\n      data-variant={variant}\n      {...props}\n    />\n  );\n}\n\ntype ContextMenuSubProps = ComponentProps<typeof ContextMenuPrimitive.Sub>;\n\n/**\n * Submenu root container managing nested submenu state.\n */\nfunction ContextMenuSub({\n  open: controlledOpen,\n  defaultOpen = false,\n  onOpenChange,\n  children,\n  ...props\n}: ContextMenuSubProps) {\n  const [open, setOpen] = useControlledState({\n    defaultValue: defaultOpen,\n    onChange: onOpenChange,\n    value: controlledOpen,\n  });\n\n  const contextValue = useMemo(\n    () => ({ open: Boolean(open), setOpen }),\n    [open, setOpen]\n  );\n\n  return (\n    <ContextMenuSubContext.Provider value={contextValue}>\n      <ContextMenuPrimitive.Sub\n        data-slot=\"context-menu-sub\"\n        onOpenChange={(nextOpen) => {\n          setOpen(nextOpen);\n        }}\n        open={open}\n        {...props}\n      >\n        {children}\n      </ContextMenuPrimitive.Sub>\n    </ContextMenuSubContext.Provider>\n  );\n}\n\ninterface ContextMenuSubTriggerProps extends ComponentProps<\n  typeof ContextMenuPrimitive.SubTrigger\n> {\n  /**\n   * Whether to indent the item for alignment with checkable items.\n   * @default false\n   */\n  inset?: boolean;\n}\n\n/**\n * Interactive menu item that reveals a submenu on hover or click.\n */\nfunction ContextMenuSubTrigger({\n  className,\n  inset,\n  children,\n  ...props\n}: ContextMenuSubTriggerProps) {\n  return (\n    <ContextMenuPrimitive.SubTrigger\n      className={cn(\n        \"focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-highlighted:bg-accent data-open:bg-accent data-popup-open:bg-accent data-[state=open]:text-accent-foreground data-highlighted:text-accent-foreground data-open:text-accent-foreground data-popup-open:text-accent-foreground flex cursor-default items-center gap-2 rounded-md px-2 py-1.5 text-sm outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 data-inset:pl-8 rtl:data-inset:pr-8 rtl:data-inset:pl-2 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4\",\n        className\n      )}\n      data-inset={inset}\n      data-slot=\"context-menu-sub-trigger\"\n      {...props}\n    >\n      {children}\n      <ChevronRightIcon className=\"text-muted-foreground ms-auto size-4 rtl:rotate-180\" />\n    </ContextMenuPrimitive.SubTrigger>\n  );\n}\n\ninterface ContextMenuSubContentProps extends ComponentProps<\n  typeof ContextMenuPrimitive.SubContent\n> {\n  /**\n   * Whether to disable Motion transitions and animations.\n   * @default false\n   */\n  disableAnimation?: boolean;\n}\n\n/**\n * Submenu popup content with smooth Motion spring slide entrance and exit animations.\n */\nfunction ContextMenuSubContent({\n  className,\n  alignOffset = -4,\n  sideOffset = 0,\n  collisionPadding = 8,\n  disableAnimation = false,\n  children,\n  asChild: _asChild,\n  style,\n  ...props\n}: ContextMenuSubContentProps) {\n  const context = useContextMenuSubContext();\n  const direction = Direction.useDirection();\n  const prefersReducedMotion = useReducedMotion();\n  const isOpen = context ? context.open : true;\n  const shouldAnimate = !(disableAnimation || prefersReducedMotion);\n  const slideOffset = direction === \"rtl\" ? 10 : -10;\n\n  return (\n    <AnimatePresence>\n      {isOpen && (\n        <ContextMenuPrimitive.Portal forceMount>\n          <ContextMenuPrimitive.SubContent\n            alignOffset={alignOffset}\n            asChild\n            className={cn(\n              \"border-border bg-popover/95 text-popover-foreground ring-foreground/5 z-50 max-h-(--radix-context-menu-content-available-height) min-w-40 overflow-x-hidden overflow-y-auto rounded-xl border p-1 shadow-2xl ring-1 backdrop-blur-md outline-none\",\n              className\n            )}\n            collisionPadding={collisionPadding}\n            data-slot=\"context-menu-sub-content\"\n            forceMount\n            sideOffset={sideOffset}\n            {...props}\n          >\n            <motion.div\n              animate={{ opacity: 1, x: 0 }}\n              exit={\n                shouldAnimate\n                  ? {\n                      opacity: 0,\n                      x: slideOffset,\n                      transition: {\n                        duration: 0.1,\n                      },\n                    }\n                  : { opacity: 0 }\n              }\n              initial={\n                shouldAnimate ? { opacity: 0, x: slideOffset } : { opacity: 0 }\n              }\n              style={{ ...style }}\n              transition={\n                shouldAnimate\n                  ? {\n                      type: \"spring\",\n                      stiffness: 400,\n                      damping: 20,\n                      opacity: { duration: 0.2 },\n                    }\n                  : { duration: 0 }\n              }\n            >\n              {children}\n            </motion.div>\n          </ContextMenuPrimitive.SubContent>\n        </ContextMenuPrimitive.Portal>\n      )}\n    </AnimatePresence>\n  );\n}\n\ninterface ContextMenuCheckboxItemProps extends ComponentProps<\n  typeof ContextMenuPrimitive.CheckboxItem\n> {\n  /**\n   * Whether to indent the item for alignment.\n   * @default false\n   */\n  inset?: boolean;\n}\n\n/**\n * An actionable context menu item with a checkbox toggle state.\n */\nfunction ContextMenuCheckboxItem({\n  className,\n  children,\n  checked,\n  inset,\n  ...props\n}: ContextMenuCheckboxItemProps) {\n  return (\n    <ContextMenuPrimitive.CheckboxItem\n      checked={checked}\n      className={cn(\n        \"focus:bg-accent focus:text-accent-foreground data-highlighted:bg-accent data-highlighted:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-md py-1.5 pr-2 pl-8 text-sm outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 data-inset:pl-8 rtl:pr-8 rtl:pl-2 rtl:data-inset:pr-8 rtl:data-inset:pl-2 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4\",\n        className\n      )}\n      data-inset={inset}\n      data-slot=\"context-menu-checkbox-item\"\n      {...props}\n    >\n      <span className=\"pointer-events-none absolute left-2 flex size-3.5 items-center justify-center rtl:right-2 rtl:left-auto\">\n        <ContextMenuPrimitive.ItemIndicator>\n          <CheckIcon className=\"size-4\" />\n        </ContextMenuPrimitive.ItemIndicator>\n      </span>\n      {children}\n    </ContextMenuPrimitive.CheckboxItem>\n  );\n}\n\ntype ContextMenuRadioGroupProps = ComponentProps<\n  typeof ContextMenuPrimitive.RadioGroup\n>;\n\n/**\n * Radio group container for mutually exclusive context menu selections.\n */\nfunction ContextMenuRadioGroup({ ...props }: ContextMenuRadioGroupProps) {\n  return (\n    <ContextMenuPrimitive.RadioGroup\n      data-slot=\"context-menu-radio-group\"\n      {...props}\n    />\n  );\n}\n\ninterface ContextMenuRadioItemProps extends ComponentProps<\n  typeof ContextMenuPrimitive.RadioItem\n> {\n  /**\n   * Whether to indent the item for alignment.\n   * @default false\n   */\n  inset?: boolean;\n}\n\n/**\n * A selectable radio option within a ContextMenuRadioGroup.\n */\nfunction ContextMenuRadioItem({\n  className,\n  children,\n  inset,\n  ...props\n}: ContextMenuRadioItemProps) {\n  return (\n    <ContextMenuPrimitive.RadioItem\n      className={cn(\n        \"focus:bg-accent focus:text-accent-foreground data-highlighted:bg-accent data-highlighted:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-md py-1.5 pr-2 pl-8 text-sm outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 data-inset:pl-8 rtl:pr-8 rtl:pl-2 rtl:data-inset:pr-8 rtl:data-inset:pl-2 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4\",\n        className\n      )}\n      data-inset={inset}\n      data-slot=\"context-menu-radio-item\"\n      {...props}\n    >\n      <span className=\"pointer-events-none absolute left-2 flex size-3.5 items-center justify-center rtl:right-2 rtl:left-auto\">\n        <ContextMenuPrimitive.ItemIndicator>\n          <CheckIcon className=\"size-4\" />\n        </ContextMenuPrimitive.ItemIndicator>\n      </span>\n      {children}\n    </ContextMenuPrimitive.RadioItem>\n  );\n}\n\ntype ContextMenuSeparatorProps = ComponentProps<\n  typeof ContextMenuPrimitive.Separator\n>;\n\n/**\n * Divider separating groups of context menu items.\n */\nfunction ContextMenuSeparator({\n  className,\n  ...props\n}: ContextMenuSeparatorProps) {\n  return (\n    <ContextMenuPrimitive.Separator\n      className={cn(\"bg-border -mx-1 my-1 h-px\", className)}\n      data-slot=\"context-menu-separator\"\n      {...props}\n    />\n  );\n}\n\ntype ContextMenuShortcutProps = ComponentProps<\"span\">;\n\n/**\n * Renders keyboard shortcut combination hints aligned to the right.\n */\nfunction ContextMenuShortcut({\n  className,\n  ...props\n}: ContextMenuShortcutProps) {\n  return (\n    <span\n      className={cn(\n        \"text-muted-foreground group-focus/context-menu-item:text-accent-foreground ml-auto text-xs tracking-widest\",\n        className\n      )}\n      data-slot=\"context-menu-shortcut\"\n      {...props}\n    />\n  );\n}\n\nexport type {\n  ContextMenuCheckboxItemProps,\n  ContextMenuContentProps,\n  ContextMenuGroupProps,\n  ContextMenuItemProps,\n  ContextMenuLabelProps,\n  ContextMenuPortalProps,\n  ContextMenuProps,\n  ContextMenuRadioGroupProps,\n  ContextMenuRadioItemProps,\n  ContextMenuSeparatorProps,\n  ContextMenuShortcutProps,\n  ContextMenuSubContentProps,\n  ContextMenuSubProps,\n  ContextMenuSubTriggerProps,\n  ContextMenuTriggerProps,\n};\n\nconst { DirectionProvider } = Direction;\n\nexport {\n  ContextMenu,\n  ContextMenu as RadixContextMenu,\n  ContextMenu as default,\n  ContextMenuCheckboxItem,\n  ContextMenuContent,\n  ContextMenuGroup,\n  ContextMenuItem,\n  ContextMenuLabel,\n  ContextMenuPortal,\n  ContextMenuRadioGroup,\n  ContextMenuRadioItem,\n  ContextMenuSeparator,\n  ContextMenuShortcut,\n  ContextMenuSub,\n  ContextMenuSubContent,\n  ContextMenuSubTrigger,\n  ContextMenuTrigger,\n  DirectionProvider,\n  useContextMenuContext,\n  useContextMenuSubContext,\n};\n",
      "type": "registry:ui",
      "target": "components/sora-ui/radix/context-menu.tsx"
    }
  ],
  "meta": {
    "agentMetadata": {
      "intent": "Offer contextual actions for a target using pointer or long-press interaction.",
      "role": "context-menu",
      "a11yConstraints": [
        "Keep essential actions available through a non-contextual path."
      ],
      "motionEngine": "Motion scale and opacity presence with directional submenu transitions.",
      "compositionRules": [
        "Use ContextMenuTrigger around the contextual target."
      ],
      "compositionRecipes": [
        "Compose with radix/alert-dialog for destructive actions."
      ]
    }
  },
  "type": "registry:ui"
}
