{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "base-context-menu",
  "title": "Base Context Menu",
  "description": "An accessible context menu built on Base UI with smooth Motion spring scale and submenu slide animations.",
  "dependencies": ["@base-ui/react", "motion", "lucide-react"],
  "registryDependencies": ["utils", "@soralabs/hooks-use-controlled-state"],
  "files": [
    {
      "path": "registry/ui/base/context-menu/index.tsx",
      "content": "\"use client\";\n\nimport { ContextMenu as ContextMenuPrimitive } from \"@base-ui/react/context-menu\";\nimport { useDirection } from \"@base-ui/react/direction-provider\";\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 { 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\ntype ContextMenuProps = ComponentProps<typeof ContextMenuPrimitive.Root>;\n\n/**\n * Root container for the Context Menu component powered by Base 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: (nextOpen: boolean) => {\n      onOpenChange?.(nextOpen, undefined as never);\n    },\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, eventDetails) => {\n          setOpen(nextOpen);\n          onOpenChange?.(nextOpen, eventDetails);\n        }}\n        open={open}\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\n  extends\n    ComponentProps<typeof ContextMenuPrimitive.Popup>,\n    Pick<\n      ComponentProps<typeof ContextMenuPrimitive.Positioner>,\n      | \"align\"\n      | \"alignOffset\"\n      | \"anchor\"\n      | \"arrowPadding\"\n      | \"collisionAvoidance\"\n      | \"collisionBoundary\"\n      | \"collisionPadding\"\n      | \"positionMethod\"\n      | \"side\"\n      | \"sideOffset\"\n      | \"sticky\"\n    > {\n  /**\n   * Whether to disable Motion spring physics and animations.\n   * @default false\n   */\n  disableAnimation?: boolean;\n  /**\n   * Additional CSS classes for the positioner container.\n   */\n  positionerClassName?: string;\n}\n\n/**\n * Context menu popup container with smooth Motion spring scale and opacity entrance/exit animations.\n */\nfunction ContextMenuContent({\n  className,\n  positionerClassName,\n  align = \"start\",\n  alignOffset = 4,\n  side = \"right\",\n  sideOffset = 0,\n  anchor,\n  arrowPadding,\n  collisionAvoidance,\n  collisionBoundary,\n  collisionPadding = 8,\n  positionMethod,\n  sticky,\n  disableAnimation = false,\n  children,\n  render,\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 keepMounted>\n          <ContextMenuPrimitive.Positioner\n            align={align}\n            alignOffset={alignOffset}\n            anchor={anchor}\n            arrowPadding={arrowPadding}\n            className={cn(\"isolate z-50 outline-none\", positionerClassName)}\n            collisionAvoidance={collisionAvoidance}\n            collisionBoundary={collisionBoundary}\n            collisionPadding={collisionPadding}\n            data-slot=\"context-menu-positioner\"\n            positionMethod={positionMethod}\n            side={side}\n            sideOffset={sideOffset}\n            sticky={sticky}\n          >\n            <ContextMenuPrimitive.Popup\n              className={cn(\n                \"border-border bg-popover/95 text-popover-foreground ring-foreground/5 z-50 max-h-(--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              data-slot=\"context-menu-content\"\n              render={\n                render ?? (\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\n                        ? { opacity: 0, scale: 0.9 }\n                        : { 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                )\n              }\n              {...props}\n            >\n              {children}\n            </ContextMenuPrimitive.Popup>\n          </ContextMenuPrimitive.Positioner>\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.GroupLabel\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 */\nfunction ContextMenuLabel({\n  className,\n  inset,\n  ...props\n}: ContextMenuLabelProps) {\n  return (\n    <ContextMenuPrimitive.GroupLabel\n      className={cn(\n        \"text-muted-foreground px-2 py-1.5 text-xs font-semibold data-inset:ps-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 data-[variant=destructive]:text-destructive data-[variant=destructive]:focus:bg-destructive/10 data-[variant=destructive]:focus:text-destructive dark:data-[variant=destructive]:focus:bg-destructive/20 focus:*:[svg]:text-accent-foreground data-[variant=destructive]:*:[svg]:text-destructive 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:ps-8 [&_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<\n  typeof ContextMenuPrimitive.SubmenuRoot\n>;\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: (nextOpen: boolean) => {\n      onOpenChange?.(nextOpen, undefined as never);\n    },\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.SubmenuRoot\n        data-slot=\"context-menu-sub\"\n        onOpenChange={(nextOpen, eventDetails) => {\n          setOpen(nextOpen);\n          onOpenChange?.(nextOpen, eventDetails);\n        }}\n        open={open}\n        {...props}\n      >\n        {children}\n      </ContextMenuPrimitive.SubmenuRoot>\n    </ContextMenuSubContext.Provider>\n  );\n}\n\ninterface ContextMenuSubTriggerProps extends ComponentProps<\n  typeof ContextMenuPrimitive.SubmenuTrigger\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.SubmenuTrigger\n      className={cn(\n        \"focus:bg-accent focus:text-accent-foreground data-open:bg-accent data-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:ps-8 [&_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.SubmenuTrigger>\n  );\n}\n\ninterface ContextMenuSubContentProps\n  extends\n    ComponentProps<typeof ContextMenuPrimitive.Popup>,\n    Pick<\n      ComponentProps<typeof ContextMenuPrimitive.Positioner>,\n      | \"align\"\n      | \"alignOffset\"\n      | \"anchor\"\n      | \"arrowPadding\"\n      | \"collisionAvoidance\"\n      | \"collisionBoundary\"\n      | \"collisionPadding\"\n      | \"positionMethod\"\n      | \"side\"\n      | \"sideOffset\"\n      | \"sticky\"\n    > {\n  /**\n   * Whether to disable Motion spring physics and animations.\n   * @default false\n   */\n  disableAnimation?: boolean;\n  /**\n   * Additional CSS classes for the positioner container.\n   */\n  positionerClassName?: string;\n}\n\n/**\n * Submenu popup content with smooth Motion spring slide entrance and exit animations.\n */\nfunction ContextMenuSubContent({\n  className,\n  positionerClassName,\n  align = \"start\",\n  alignOffset = -4,\n  side = \"inline-end\",\n  sideOffset = 0,\n  anchor,\n  arrowPadding,\n  collisionAvoidance,\n  collisionBoundary,\n  collisionPadding = 8,\n  positionMethod,\n  sticky,\n  disableAnimation = false,\n  children,\n  render,\n  style,\n  ...props\n}: ContextMenuSubContentProps) {\n  const context = useContextMenuSubContext();\n  const 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 keepMounted>\n          <ContextMenuPrimitive.Positioner\n            align={align}\n            alignOffset={alignOffset}\n            anchor={anchor}\n            arrowPadding={arrowPadding}\n            className={cn(\"isolate z-50 outline-none\", positionerClassName)}\n            collisionAvoidance={collisionAvoidance}\n            collisionBoundary={collisionBoundary}\n            collisionPadding={collisionPadding}\n            data-slot=\"context-menu-sub-positioner\"\n            positionMethod={positionMethod}\n            side={side}\n            sideOffset={sideOffset}\n            sticky={sticky}\n          >\n            <ContextMenuPrimitive.Popup\n              className={cn(\n                \"border-border bg-popover/95 text-popover-foreground ring-foreground/5 z-50 max-h-(--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              data-slot=\"context-menu-sub-content\"\n              render={\n                render ?? (\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\n                        ? { opacity: 0, x: slideOffset }\n                        : { 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                )\n              }\n              {...props}\n            >\n              {children}\n            </ContextMenuPrimitive.Popup>\n          </ContextMenuPrimitive.Positioner>\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 relative flex cursor-default items-center gap-2 rounded-md py-1.5 ps-8 pe-2 text-sm outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 data-inset:ps-8 [&_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 start-2 flex size-3.5 items-center justify-center\">\n        <ContextMenuPrimitive.CheckboxItemIndicator>\n          <CheckIcon className=\"size-4\" />\n        </ContextMenuPrimitive.CheckboxItemIndicator>\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 relative flex cursor-default items-center gap-2 rounded-md py-1.5 ps-8 pe-2 text-sm outline-hidden select-none data-disabled:pointer-events-none data-disabled:opacity-50 data-inset:ps-8 [&_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 start-2 flex size-3.5 items-center justify-center\">\n        <ContextMenuPrimitive.RadioItemIndicator>\n          <CheckIcon className=\"size-4\" />\n        </ContextMenuPrimitive.RadioItemIndicator>\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 ms-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};\nexport {\n  ContextMenu,\n  ContextMenu as BaseContextMenu,\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  useContextMenuContext,\n  useContextMenuSubContext,\n};\n",
      "type": "registry:ui",
      "target": "components/sora-ui/base/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 base/alert-dialog for destructive actions."
      ]
    }
  },
  "type": "registry:ui"
}
