{
  "name": "sidebar",
  "type": "registry:ui",
  "title": "Sidebar",
  "description": "Application navigation composition built from Siteplane UI primitives.",
  "registryDependencies": [
    "@siteplane/base",
    "@siteplane/button",
    "@siteplane/input",
    "@siteplane/scroll-area",
    "@siteplane/separator",
    "@siteplane/sheet",
    "@siteplane/skeleton",
    "@siteplane/tooltip"
  ],
  "dependencies": [
    "@base-ui/react@1.5.0",
    "class-variance-authority@0.7.1",
    "lucide-react@1.18.0"
  ],
  "files": [
    {
      "path": "src/components/ui/sidebar.tsx",
      "type": "registry:ui",
      "content": "\"use client\";\n\nimport { mergeProps } from \"@base-ui/react/merge-props\";\nimport { useRender } from \"@base-ui/react/use-render\";\nimport { cva, type VariantProps } from \"class-variance-authority\";\nimport { PanelLeftIcon } from \"lucide-react\";\nimport * as React from \"react\";\nimport { useMediaQuery } from \"@/hooks/use-media-query\";\nimport { cn } from \"@/lib/utils\";\nimport { Button } from \"@/components/ui/button\";\nimport { useResolvedControlSize } from \"@/components/ui/siteplane-provider\";\nimport { Input } from \"@/components/ui/input\";\nimport { ScrollArea } from \"@/components/ui/scroll-area\";\nimport { Separator } from \"@/components/ui/separator\";\nimport {\n  Sheet,\n  SheetDescription,\n  SheetHeader,\n  SheetPopup,\n  SheetTitle,\n} from \"@/components/ui/sheet\";\nimport { Skeleton } from \"@/components/ui/skeleton\";\nimport {\n  Tooltip,\n  TooltipPopup,\n  TooltipProvider,\n  TooltipTrigger,\n} from \"@/components/ui/tooltip\";\n\nconst SIDEBAR_COOKIE_NAME: string = \"sidebar_state\";\nconst SIDEBAR_COOKIE_MAX_AGE: number = 60 * 60 * 24 * 7;\nconst SIDEBAR_WIDTH: string = \"16rem\";\nconst SIDEBAR_WIDTH_MIN: string = \"12rem\";\nconst SIDEBAR_WIDTH_MAX: string = \"24rem\";\nconst SIDEBAR_WIDTH_MOBILE: string = \"18rem\";\nconst SIDEBAR_WIDTH_ICON: string = \"3rem\";\nconst SIDEBAR_KEYBOARD_SHORTCUT: string = \"b\";\n\nexport const sidebarMenuPopupWidthClassName = \"w-56\";\n\nconst sidebarMenuButtonVariants = cva(\n  \"peer/menu-button flex w-full cursor-pointer items-center gap-2 overflow-hidden rounded-lg p-2 text-left text-sm outline-none ring-sidebar-ring transition-[width,height,padding] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 active:bg-sidebar-accent active:text-sidebar-accent-foreground disabled:pointer-events-none disabled:opacity-64 group-has-data-[sidebar=menu-action]/menu-item:pe-8 aria-disabled:pointer-events-none aria-disabled:opacity-64 data-[active=true]:bg-sidebar-accent data-[active=true]:font-medium data-[active=true]:text-sidebar-accent-foreground data-[state=open]:hover:bg-sidebar-accent data-[state=open]:hover:text-sidebar-accent-foreground group-data-[collapsible=icon]:size-8! group-data-[collapsible=icon]:justify-center group-data-[collapsible=icon]:p-2! group-data-[collapsible=icon]:[&>*:not(:first-child)]:hidden group-data-[collapsible=icon]:[&>span:first-child]:hidden group-data-[collapsible=icon]:[&>span]:hidden [&>span:last-child]:truncate [&>svg:not([class*='size-'])]:size-4 [&>svg]:shrink-0\",\n  {\n    defaultVariants: {\n      size: \"default\",\n      variant: \"default\",\n    },\n    variants: {\n      size: {\n        default: \"h-8 text-sm\",\n        lg: \"h-10 text-sm group-data-[collapsible=icon]:p-0!\",\n        sm: \"h-7 text-xs\",\n        xl: \"h-12 text-sm group-data-[collapsible=icon]:p-0!\",\n      },\n      variant: {\n        default: \"hover:bg-sidebar-accent hover:text-sidebar-accent-foreground\",\n        outline:\n          \"bg-background shadow-[0_0_0_1px_var(--sidebar-border)] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground hover:shadow-[0_0_0_1px_var(--sidebar-accent)]\",\n      },\n    },\n  },\n);\n\nexport type SidebarContextProps = {\n  state: \"expanded\" | \"collapsed\";\n  open: boolean;\n  setOpen: (open: boolean) => void;\n  openMobile: boolean;\n  setOpenMobile: (open: boolean) => void;\n  isMobile: boolean;\n  toggleSidebar: () => void;\n};\n\nexport const SidebarContext: React.Context<SidebarContextProps | null> =\n  React.createContext<SidebarContextProps | null>(null);\n\nexport function useSidebar(): SidebarContextProps {\n  const context = React.useContext(SidebarContext);\n  if (!context) {\n    throw new Error(\"useSidebar must be used within a SidebarProvider.\");\n  }\n\n  return context;\n}\n\nfunction getSidebarLengthInPixels(\n  element: HTMLElement,\n  name: string,\n  fallback: number,\n): number {\n  const value = getComputedStyle(element).getPropertyValue(name).trim();\n  const parsedValue = Number.parseFloat(value);\n\n  if (!Number.isFinite(parsedValue)) {\n    return fallback;\n  }\n\n  if (value.endsWith(\"rem\")) {\n    const rootFontSize = Number.parseFloat(\n      getComputedStyle(document.documentElement).fontSize,\n    );\n\n    return parsedValue * (Number.isFinite(rootFontSize) ? rootFontSize : 16);\n  }\n\n  return parsedValue;\n}\n\nfunction getInheritedSidebarMenuButtonSize(\n  size: VariantProps<typeof sidebarMenuButtonVariants>[\"size\"],\n): VariantProps<typeof sidebarMenuButtonVariants>[\"size\"] {\n  if (size === \"xl\") {\n    return \"lg\";\n  }\n\n  if (size === \"lg\") {\n    return \"default\";\n  }\n\n  return size;\n}\n\nexport function SidebarProvider({\n  defaultOpen = true,\n  open: openProp,\n  onOpenChange: setOpenProp,\n  className,\n  style,\n  children,\n  ...props\n}: React.ComponentProps<\"div\"> & {\n  defaultOpen?: boolean;\n  open?: boolean;\n  onOpenChange?: (open: boolean) => void;\n}): React.ReactElement {\n  const isMobile = useMediaQuery(\"max-md\");\n  const [openMobile, setOpenMobile] = React.useState(false);\n\n  // This is the internal state of the sidebar.\n  // We use openProp and setOpenProp for control from outside the component.\n  const [_open, _setOpen] = React.useState(defaultOpen);\n  const open = openProp ?? _open;\n  const setOpen = React.useCallback(\n    async (value: boolean | ((value: boolean) => boolean)) => {\n      const openState = typeof value === \"function\" ? value(open) : value;\n      if (setOpenProp) {\n        setOpenProp(openState);\n      } else {\n        _setOpen(openState);\n      }\n\n      // This sets the cookie to keep the sidebar state.\n      await cookieStore.set({\n        expires: Date.now() + SIDEBAR_COOKIE_MAX_AGE * 1000,\n        name: SIDEBAR_COOKIE_NAME,\n        path: \"/\",\n        value: String(openState),\n      });\n    },\n    [setOpenProp, open],\n  );\n\n  // Helper to toggle the sidebar.\n  const toggleSidebar = React.useCallback(() => {\n    return isMobile ? setOpenMobile((open) => !open) : setOpen((open) => !open);\n  }, [isMobile, setOpen]);\n\n  // Adds a keyboard shortcut to toggle the sidebar.\n  React.useEffect(() => {\n    const handleKeyDown = (event: KeyboardEvent): void => {\n      if (\n        event.key === SIDEBAR_KEYBOARD_SHORTCUT &&\n        (event.metaKey || event.ctrlKey)\n      ) {\n        event.preventDefault();\n        toggleSidebar();\n      }\n    };\n\n    window.addEventListener(\"keydown\", handleKeyDown);\n    return () => window.removeEventListener(\"keydown\", handleKeyDown);\n  }, [toggleSidebar]);\n\n  // We add a state so that we can do data-state=\"expanded\" or \"collapsed\".\n  // This makes it easier to style the sidebar with Tailwind classes.\n  const state = open ? \"expanded\" : \"collapsed\";\n\n  const contextValue = React.useMemo<SidebarContextProps>(\n    () => ({\n      isMobile,\n      open,\n      openMobile,\n      setOpen,\n      setOpenMobile,\n      state,\n      toggleSidebar,\n    }),\n    [state, open, setOpen, isMobile, openMobile, toggleSidebar],\n  );\n\n  return (\n    <SidebarContext.Provider value={contextValue}>\n      <div\n        className={cn(\n          \"group/sidebar-wrapper flex min-h-svh w-full has-data-[variant=inset]:bg-sidebar\",\n          className,\n        )}\n        data-slot=\"sidebar-wrapper\"\n        style={\n          {\n            \"--sidebar-width\": SIDEBAR_WIDTH,\n            \"--sidebar-width-min\": SIDEBAR_WIDTH_MIN,\n            \"--sidebar-width-max\": SIDEBAR_WIDTH_MAX,\n            \"--sidebar-width-icon\": SIDEBAR_WIDTH_ICON,\n            ...style,\n          } as React.CSSProperties\n        }\n        {...props}\n      >\n        <TooltipProvider delay={0}>{children}</TooltipProvider>\n      </div>\n    </SidebarContext.Provider>\n  );\n}\n\nexport function Sidebar({\n  side = \"left\",\n  variant = \"sidebar\",\n  collapsible = \"offcanvas\",\n  className,\n  children,\n  ...props\n}: React.ComponentProps<\"div\"> & {\n  side?: \"left\" | \"right\";\n  variant?: \"sidebar\" | \"floating\" | \"inset\";\n  collapsible?: \"offcanvas\" | \"icon\" | \"none\";\n}): React.ReactElement {\n  const { isMobile, state, openMobile, setOpenMobile } = useSidebar();\n\n  if (collapsible === \"none\") {\n    return (\n      <div\n        className={cn(\n          \"flex h-full w-(--sidebar-width) flex-col bg-sidebar text-sidebar-foreground\",\n          className,\n        )}\n        data-slot=\"sidebar\"\n        {...props}\n      >\n        {children}\n      </div>\n    );\n  }\n\n  if (isMobile) {\n    return (\n      <Sheet onOpenChange={setOpenMobile} open={openMobile} {...props}>\n        <SheetPopup\n          className=\"w-(--sidebar-width) bg-sidebar p-0 text-sidebar-foreground [&>button]:hidden\"\n          data-mobile=\"true\"\n          data-sidebar=\"sidebar\"\n          data-slot=\"sidebar\"\n          side={side}\n          style={\n            {\n              \"--sidebar-width\": SIDEBAR_WIDTH_MOBILE,\n            } as React.CSSProperties\n          }\n        >\n          <SheetHeader className=\"sr-only\">\n            <SheetTitle>Sidebar</SheetTitle>\n            <SheetDescription>Displays the mobile sidebar.</SheetDescription>\n          </SheetHeader>\n          <div className=\"flex h-full w-full flex-col\">{children}</div>\n        </SheetPopup>\n      </Sheet>\n    );\n  }\n\n  return (\n    <div\n      className=\"group peer hidden text-sidebar-foreground md:block\"\n      data-collapsible={state === \"collapsed\" ? collapsible : \"\"}\n      data-side={side}\n      data-slot=\"sidebar\"\n      data-state={state}\n      data-variant={variant}\n    >\n      {/* This is what handles the sidebar gap on desktop */}\n      <div\n        className={cn(\n          \"relative w-(--sidebar-width) bg-transparent transition-[width] duration-(--motion-duration-base) ease-linear\",\n          \"group-data-[collapsible=offcanvas]:w-0\",\n          \"group-data-[side=right]:rotate-180\",\n          variant === \"floating\" || variant === \"inset\"\n            ? \"group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4)))]\"\n            : \"group-data-[collapsible=icon]:w-(--sidebar-width-icon)\",\n        )}\n        data-slot=\"sidebar-gap\"\n      />\n      <div\n        className={cn(\n          \"fixed inset-y-0 z-10 hidden h-svh w-(--sidebar-width) transition-[left,right,width] duration-(--motion-duration-base) ease-linear md:flex\",\n          side === \"left\"\n            ? \"left-0 group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)]\"\n            : \"right-0 group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)]\",\n          // Adjust the padding for floating and inset variants.\n          variant === \"floating\" || variant === \"inset\"\n            ? \"p-2 group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4))+2px)]\"\n            : \"group-data-[collapsible=icon]:w-(--sidebar-width-icon) group-data-[side=left]:border-r group-data-[side=right]:border-l\",\n          className,\n        )}\n        data-slot=\"sidebar-container\"\n        {...props}\n      >\n        <div\n          className=\"flex h-full w-full flex-col bg-sidebar group-data-[variant=floating]:rounded-lg group-data-[variant=floating]:border group-data-[variant=floating]:border-sidebar-border group-data-[variant=floating]:shadow-sm/5\"\n          data-sidebar=\"sidebar\"\n          data-slot=\"sidebar-inner\"\n        >\n          {children}\n        </div>\n      </div>\n    </div>\n  );\n}\n\nexport function SidebarTrigger({\n  className,\n  onClick,\n  ...props\n}: React.ComponentProps<typeof Button>): React.ReactElement {\n  const { toggleSidebar } = useSidebar();\n\n  return (\n    <Button\n      className={cn(\"size-7\", className)}\n      data-sidebar=\"trigger\"\n      data-slot=\"sidebar-trigger\"\n      onClick={(event: React.MouseEvent<HTMLButtonElement>) => {\n        onClick?.(event);\n        toggleSidebar();\n      }}\n      size=\"icon\"\n      variant=\"ghost\"\n      {...props}\n    >\n      <PanelLeftIcon />\n      <span className=\"sr-only\">Toggle Sidebar</span>\n    </Button>\n  );\n}\n\nexport function SidebarRail({\n  className,\n  resizable = false,\n  ...props\n}: React.ComponentProps<\"button\"> & {\n  resizable?: boolean;\n}): React.ReactElement {\n  const { state, toggleSidebar } = useSidebar();\n  const didDragRef = React.useRef(false);\n\n  function handlePointerDown(event: React.PointerEvent<HTMLButtonElement>): void {\n    if (event.button !== 0 || !resizable || state !== \"expanded\") {\n      return;\n    }\n\n    const sidebar = event.currentTarget.closest<HTMLElement>(\n      '[data-slot=\"sidebar\"]',\n    );\n    const sidebarContainer = sidebar?.querySelector<HTMLElement>(\n      '[data-slot=\"sidebar-container\"]',\n    );\n    const sidebarWrapper = event.currentTarget.closest<HTMLElement>(\n      '[data-slot=\"sidebar-wrapper\"]',\n    );\n\n    if (!sidebar || !sidebarContainer || !sidebarWrapper) {\n      return;\n    }\n\n    const wrapper = sidebarWrapper;\n    const side = sidebar.dataset.side ?? \"left\";\n    const startX = event.clientX;\n    const startWidth = sidebarContainer.getBoundingClientRect().width;\n    const minWidth = getSidebarLengthInPixels(\n      wrapper,\n      \"--sidebar-width-min\",\n      192,\n    );\n    const maxWidth = getSidebarLengthInPixels(\n      wrapper,\n      \"--sidebar-width-max\",\n      384,\n    );\n    const previousCursor = document.body.style.cursor;\n    const previousUserSelect = document.body.style.userSelect;\n\n    didDragRef.current = false;\n    document.body.style.cursor = \"col-resize\";\n    document.body.style.userSelect = \"none\";\n\n    function handlePointerMove(moveEvent: PointerEvent): void {\n      const delta =\n        side === \"right\" ? startX - moveEvent.clientX : moveEvent.clientX - startX;\n\n      if (Math.abs(delta) > 3) {\n        didDragRef.current = true;\n      }\n\n      const nextWidth = Math.min(\n        maxWidth,\n        Math.max(minWidth, startWidth + delta),\n      );\n\n      wrapper.style.setProperty(\n        \"--sidebar-width\",\n        `${Math.round(nextWidth)}px`,\n      );\n    }\n\n    function handlePointerUp(): void {\n      document.body.style.cursor = previousCursor;\n      document.body.style.userSelect = previousUserSelect;\n      window.removeEventListener(\"pointermove\", handlePointerMove);\n      window.removeEventListener(\"pointerup\", handlePointerUp);\n    }\n\n    window.addEventListener(\"pointermove\", handlePointerMove);\n    window.addEventListener(\"pointerup\", handlePointerUp, { once: true });\n  }\n\n  return (\n    <button\n      aria-label=\"Toggle Sidebar\"\n      className={cn(\n        \"absolute inset-y-0 z-20 hidden w-4 -translate-x-1/2 transition-all ease-linear before:absolute before:top-1/2 before:left-1/2 before:h-10 before:w-1 before:-translate-x-1/2 before:-translate-y-1/2 before:rounded-full before:bg-transparent after:absolute after:inset-y-0 after:left-1/2 after:w-[2px] hover:before:bg-sidebar-border hover:after:bg-sidebar-border group-data-[side=left]:-right-4 group-data-[side=right]:left-0 sm:flex\",\n        resizable\n          ? \"in-data-[side=left]:cursor-w-resize in-data-[side=right]:cursor-e-resize [[data-side=left][data-state=collapsed]_&]:cursor-e-resize [[data-side=right][data-state=collapsed]_&]:cursor-w-resize\"\n          : \"cursor-pointer\",\n        \"group-data-[collapsible=offcanvas]:translate-x-0 hover:group-data-[collapsible=offcanvas]:bg-sidebar group-data-[collapsible=offcanvas]:after:left-full\",\n        \"[[data-side=left][data-collapsible=offcanvas]_&]:-right-2\",\n        \"[[data-side=right][data-collapsible=offcanvas]_&]:-left-2\",\n        className,\n      )}\n      data-sidebar=\"rail\"\n      data-slot=\"sidebar-rail\"\n      onClick={(event) => {\n        if (didDragRef.current) {\n          event.preventDefault();\n          didDragRef.current = false;\n          return;\n        }\n\n        toggleSidebar();\n      }}\n      onPointerDown={handlePointerDown}\n      tabIndex={-1}\n      title={resizable ? \"Resize or toggle Sidebar\" : \"Toggle Sidebar\"}\n      type=\"button\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarInset({\n  className,\n  ...props\n}: React.ComponentProps<\"main\">): React.ReactElement {\n  return (\n    <main\n      className={cn(\n        \"relative flex w-full flex-1 flex-col bg-background\",\n        \"md:peer-data-[variant=inset]:peer-data-[state=collapsed]:ms-2 md:peer-data-[variant=inset]:m-2 md:peer-data-[variant=inset]:ms-0 md:peer-data-[variant=inset]:rounded-xl md:peer-data-[variant=inset]:shadow-sm/5\",\n        className,\n      )}\n      data-slot=\"sidebar-inset\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarInput({\n  className,\n  ...props\n}: React.ComponentProps<typeof Input>): React.ReactElement {\n  return (\n    <Input\n      className={cn(\"h-8 w-full bg-background shadow-none\", className)}\n      data-sidebar=\"input\"\n      data-slot=\"sidebar-input\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarHeader({\n  className,\n  ...props\n}: React.ComponentProps<\"div\">): React.ReactElement {\n  return (\n    <div\n      className={cn(\"flex flex-col gap-2 p-2\", className)}\n      data-sidebar=\"header\"\n      data-slot=\"sidebar-header\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarFooter({\n  className,\n  ...props\n}: React.ComponentProps<\"div\">): React.ReactElement {\n  return (\n    <div\n      className={cn(\"flex flex-col gap-2 p-2\", className)}\n      data-sidebar=\"footer\"\n      data-slot=\"sidebar-footer\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarSeparator({\n  className,\n  ...props\n}: React.ComponentProps<typeof Separator>): React.ReactElement {\n  return (\n    <Separator\n      className={cn(\"mx-2 w-auto bg-sidebar-border\", className)}\n      data-sidebar=\"separator\"\n      data-slot=\"sidebar-separator\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarContent({\n  className,\n  ...props\n}: React.ComponentProps<\"div\">): React.ReactElement {\n  return (\n    <ScrollArea className=\"min-h-0 flex-1\" fill scrollFade>\n      <div\n        className={cn(\n          \"flex h-full flex-col gap-2 group-data-[collapsible=icon]:overflow-hidden\",\n          className,\n        )}\n        data-sidebar=\"content\"\n        data-slot=\"sidebar-content\"\n        {...props}\n      />\n    </ScrollArea>\n  );\n}\n\nexport function SidebarGroup({\n  className,\n  ...props\n}: React.ComponentProps<\"div\">): React.ReactElement {\n  return (\n    <div\n      className={cn(\"relative flex w-full min-w-0 flex-col p-2\", className)}\n      data-sidebar=\"group\"\n      data-slot=\"sidebar-group\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarGroupLabel({\n  className,\n  render,\n  ...props\n}: useRender.ComponentProps<\"div\">): React.ReactElement {\n  const defaultProps = {\n    className: cn(\n      \"flex h-8 shrink-0 items-center rounded-lg px-2 font-medium text-sidebar-foreground text-xs outline-none ring-sidebar-ring transition-[margin,opacity] duration-(--motion-duration-base) ease-linear focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0\",\n      \"group-data-[collapsible=icon]:-mt-8 group-data-[collapsible=icon]:opacity-0\",\n      className,\n    ),\n    \"data-sidebar\": \"group-label\",\n    \"data-slot\": \"sidebar-group-label\",\n  };\n\n  return useRender({\n    defaultTagName: \"div\",\n    props: mergeProps(defaultProps, props),\n    render,\n  });\n}\n\nexport function SidebarGroupAction({\n  className,\n  render,\n  ...props\n}: useRender.ComponentProps<\"button\">): React.ReactElement {\n  const defaultProps = {\n    className: cn(\n      \"absolute top-3.5 right-3 flex aspect-square w-5 items-center justify-center rounded-lg p-0 text-sidebar-foreground outline-none ring-sidebar-ring transition-transform hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 [&>svg:not([class*='size-'])]:size-4 [&>svg]:shrink-0\",\n      // Increases the hit area of the button on mobile.\n      \"after:absolute after:-inset-2 md:after:hidden\",\n      \"group-data-[collapsible=icon]:hidden\",\n      className,\n    ),\n    \"data-sidebar\": \"group-action\",\n    \"data-slot\": \"sidebar-group-action\",\n  };\n\n  return useRender({\n    defaultTagName: \"button\",\n    props: mergeProps(defaultProps, props),\n    render,\n  });\n}\n\nexport function SidebarGroupContent({\n  className,\n  ...props\n}: React.ComponentProps<\"div\">): React.ReactElement {\n  return (\n    <div\n      className={cn(\"w-full text-sm\", className)}\n      data-sidebar=\"group-content\"\n      data-slot=\"sidebar-group-content\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarMenu({\n  className,\n  ...props\n}: React.ComponentProps<\"ul\">): React.ReactElement {\n  return (\n    <ul\n      className={cn(\"flex w-full min-w-0 flex-col gap-1\", className)}\n      data-sidebar=\"menu\"\n      data-slot=\"sidebar-menu\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarMenuItem({\n  className,\n  ...props\n}: React.ComponentProps<\"li\">): React.ReactElement {\n  return (\n    <li\n      className={cn(\"group/menu-item relative\", className)}\n      data-sidebar=\"menu-item\"\n      data-slot=\"sidebar-menu-item\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarMenuButton({\n  isActive = false,\n  variant = \"default\",\n  size,\n  tooltip,\n  className,\n  render,\n  ...props\n}: useRender.ComponentProps<\"button\"> & {\n  isActive?: boolean;\n  tooltip?: string | React.ComponentProps<typeof TooltipPopup>;\n} & VariantProps<typeof sidebarMenuButtonVariants>): React.ReactElement {\n  const { isMobile, state } = useSidebar();\n  const inheritedSize = useResolvedControlSize(size);\n  const resolvedSize = size ?? getInheritedSidebarMenuButtonSize(inheritedSize);\n\n  const defaultProps = {\n    className: cn(sidebarMenuButtonVariants({ size: resolvedSize, variant }), className),\n    \"data-active\": isActive,\n    \"data-sidebar\": \"menu-button\",\n    \"data-size\": resolvedSize,\n    \"data-slot\": \"sidebar-menu-button\",\n  };\n\n  const buttonProps = mergeProps<\"button\">(defaultProps, props);\n\n  const buttonElement = useRender({\n    defaultTagName: \"button\",\n    props: buttonProps,\n    render,\n  });\n\n  if (!tooltip) {\n    return buttonElement;\n  }\n\n  if (typeof tooltip === \"string\") {\n    tooltip = {\n      children: tooltip,\n    };\n  }\n\n  return (\n    <Tooltip>\n      <TooltipTrigger\n        delay={0}\n        render={buttonElement as React.ReactElement<Record<string, unknown>>}\n      />\n      <TooltipPopup\n        align=\"center\"\n        hidden={state !== \"collapsed\" || isMobile}\n        side=\"right\"\n        {...tooltip}\n      />\n    </Tooltip>\n  );\n}\n\nexport function SidebarMenuAction({\n  className,\n  showOnHover = false,\n  render,\n  ...props\n}: useRender.ComponentProps<\"button\"> & {\n  showOnHover?: boolean;\n}): React.ReactElement {\n  const defaultProps = {\n    className: cn(\n      \"absolute top-1.5 right-1 flex aspect-square w-5 items-center justify-center rounded-lg p-0 text-sidebar-foreground outline-none ring-sidebar-ring transition-transform hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 peer-hover/menu-button:text-sidebar-accent-foreground [&>svg:not([class*='size-'])]:size-4 [&>svg]:shrink-0\",\n      // Increases the hit area of the button on mobile.\n      \"after:absolute after:-inset-2 md:after:hidden\",\n      \"peer-data-[size=sm]/menu-button:top-1\",\n      \"peer-data-[size=default]/menu-button:top-1.5\",\n      \"peer-data-[size=lg]/menu-button:top-2.5\",\n      \"peer-data-[size=xl]/menu-button:top-4\",\n      \"group-data-[collapsible=icon]:hidden\",\n      showOnHover &&\n        \"group-focus-within/menu-item:opacity-100 group-hover/menu-item:opacity-100 data-[state=open]:opacity-100 peer-data-[active=true]/menu-button:text-sidebar-accent-foreground md:opacity-0\",\n      className,\n    ),\n    \"data-sidebar\": \"menu-action\",\n    \"data-slot\": \"sidebar-menu-action\",\n  };\n\n  return useRender({\n    defaultTagName: \"button\",\n    props: mergeProps<\"button\">(defaultProps, props),\n    render,\n  });\n}\n\nexport function SidebarMenuBadge({\n  className,\n  ...props\n}: React.ComponentProps<\"div\">): React.ReactElement {\n  return (\n    <div\n      className={cn(\n        \"pointer-events-none absolute right-1 flex h-5 min-w-5 select-none items-center justify-center rounded-lg px-1 font-medium text-sidebar-foreground text-xs tabular-nums\",\n        \"peer-hover/menu-button:text-sidebar-accent-foreground peer-data-[active=true]/menu-button:text-sidebar-accent-foreground\",\n        \"peer-data-[size=sm]/menu-button:top-1\",\n        \"peer-data-[size=default]/menu-button:top-1.5\",\n        \"peer-data-[size=lg]/menu-button:top-2.5\",\n        \"peer-data-[size=xl]/menu-button:top-4\",\n        \"group-data-[collapsible=icon]:hidden\",\n        className,\n      )}\n      data-sidebar=\"menu-badge\"\n      data-slot=\"sidebar-menu-badge\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarMenuSkeleton({\n  className,\n  showIcon = false,\n  width = \"72%\",\n  ...props\n}: React.ComponentProps<\"div\"> & {\n  showIcon?: boolean;\n  width?: string;\n}): React.ReactElement {\n  return (\n    <div\n      className={cn(\"flex h-8 items-center gap-2 rounded-lg px-2\", className)}\n      data-sidebar=\"menu-skeleton\"\n      data-slot=\"sidebar-menu-skeleton\"\n      {...props}\n    >\n      {showIcon && (\n        <Skeleton\n          className=\"size-4 rounded-lg\"\n          data-sidebar=\"menu-skeleton-icon\"\n        />\n      )}\n      <Skeleton\n        className=\"h-4 max-w-(--skeleton-width) flex-1\"\n        data-sidebar=\"menu-skeleton-text\"\n        style={\n          {\n            \"--skeleton-width\": width,\n          } as React.CSSProperties\n        }\n      />\n    </div>\n  );\n}\n\nexport function SidebarMenuSub({\n  className,\n  ...props\n}: React.ComponentProps<\"ul\">): React.ReactElement {\n  return (\n    <ul\n      className={cn(\n        \"mx-3.5 flex min-w-0 translate-x-px flex-col gap-1 border-sidebar-border border-l px-2.5 py-0.5\",\n        \"group-data-[collapsible=icon]:hidden\",\n        className,\n      )}\n      data-sidebar=\"menu-sub\"\n      data-slot=\"sidebar-menu-sub\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarMenuSubItem({\n  className,\n  ...props\n}: React.ComponentProps<\"li\">): React.ReactElement {\n  return (\n    <li\n      className={cn(\"group/menu-sub-item relative\", className)}\n      data-sidebar=\"menu-sub-item\"\n      data-slot=\"sidebar-menu-sub-item\"\n      {...props}\n    />\n  );\n}\n\nexport function SidebarMenuSubButton({\n  size = \"md\",\n  isActive = false,\n  className,\n  render,\n  ...props\n}: useRender.ComponentProps<\"a\"> & {\n  size?: \"sm\" | \"md\";\n  isActive?: boolean;\n}): React.ReactElement {\n  const defaultProps = {\n    className: cn(\n      \"flex h-8 min-w-0 -translate-x-px cursor-pointer items-center gap-2 overflow-hidden rounded-lg px-2 text-sidebar-foreground outline-none ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 active:bg-sidebar-accent active:text-sidebar-accent-foreground disabled:pointer-events-none disabled:opacity-64 aria-disabled:pointer-events-none aria-disabled:opacity-64 sm:h-7 [&>span:last-child]:truncate [&>svg:not([class*='size-'])]:size-4 [&>svg]:shrink-0 [&>svg]:text-sidebar-accent-foreground\",\n      \"data-[active=true]:bg-sidebar-accent data-[active=true]:text-sidebar-accent-foreground\",\n      size === \"sm\" && \"text-xs\",\n      size === \"md\" && \"text-sm\",\n      \"group-data-[collapsible=icon]:hidden\",\n      className,\n    ),\n    \"data-active\": isActive,\n    \"data-sidebar\": \"menu-sub-button\",\n    \"data-size\": size,\n    \"data-slot\": \"sidebar-menu-sub-button\",\n  };\n\n  return useRender({\n    defaultTagName: \"a\",\n    props: mergeProps<\"a\">(defaultProps, props),\n    render,\n  });\n}\n"
    }
  ],
  "categories": [
    "patterns"
  ],
  "docs": "# Sidebar\n\n> Siteplane UI release `0.1.1`.\n\n## Public Purpose\n\nSidebar demonstrates persistent, collapsible application navigation composed from the native Sidebar primitives. It collapses to an icon rail on desktop and becomes an off-canvas drawer on mobile.\n\nUse Dashboard Shell instead when the page also needs a guaranteed app-header height, divider alignment and content-scroll contract.\n\n## Import\n\n```tsx\nimport {\n  Sidebar,\n  SidebarContent,\n  SidebarFooter,\n  SidebarGroup,\n  SidebarGroupLabel,\n  SidebarHeader,\n  SidebarInset,\n  SidebarMenu,\n  SidebarMenuButton,\n  SidebarMenuItem,\n  SidebarProvider,\n  SidebarTrigger,\n} from \"@/components/ui/sidebar\";\n```\n\n## Public API\n\n- Compose the persistent layout with `SidebarProvider`, `Sidebar` and `SidebarInset`.\n- Use the native content, group and menu slots for navigation. Keep KPI and report cards in the main content region.\n- Render menu labels inside child elements such as `<span>` and provide `tooltip` when using `collapsible=\"icon\"`.\n- `SidebarRail` can opt into native resize behavior through `resizable`; do not add a second drag implementation.\n- Local menu-button sizes override the provider; inherited control size is intentionally damped for navigation density.\n\n## Public Motion\n\n- Desktop collapse animates the native Sidebar width and can be triggered through `SidebarTrigger`, the rail or Cmd/Ctrl+B.\n- Mobile off-canvas behavior, nested Collapsible navigation and Menu popups keep their native motion and reduced-motion support.\n- Do not add parallax or a content-wide backdrop layer.\n\n## Public Accessibility\n\n- Persistent navigation needs clear labels and an active state that is not conveyed by color alone.\n- Collapsed icon navigation must preserve labels through the native Sidebar tooltip contract.\n- Keep the native trigger, rail, keyboard shortcut and mobile dismissal behavior instead of replacing them with custom click targets.\n\n## Public Agent Guidance\n\n- Keep Sidebar as persistent navigation, not a general card or embedded overlay.\n- Reuse native collapse, mobile drawer, tooltip and optional resize behavior.\n- Use Dashboard Shell when sidebar and app-header alignment are part of the requirement.\n\n## Public Links\n\n- [Documentation and preview](https://ui.siteplane.io/docs/patterns/sidebar)\n\n- [Registry source](https://ui.siteplane.io/r/sidebar.json)\n",
  "meta": {
    "siteplane:agentContractVersion": 1,
    "siteplane:docs": "https://ui.siteplane.io/docs/patterns/sidebar",
    "siteplane:releaseVersion": "0.1.1",
    "siteplane:sourceOwned": true
  },
  "devDependencies": []
}