{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "sidebar",
  "type": "registry:ui",
  "title": "Sidebar",
  "description": "Responsive app sidebar with collapse, mobile sheet, and keyboard toggle support.",
  "dependencies": [
    "@base-ui/react@^1.7.0",
    "class-variance-authority@^0.7.1",
    "lucide-react@^1.31.0"
  ],
  "registryDependencies": [
    "https://control-ui.dev/r/button.json",
    "https://control-ui.dev/r/core.json",
    "https://control-ui.dev/r/scroll-area.json",
    "https://control-ui.dev/r/sheet.json",
    "https://control-ui.dev/r/tooltip.json",
    "https://control-ui.dev/r/track-highlight.json"
  ],
  "files": [
    {
      "path": "src/registry/hooks/use-mobile.ts",
      "target": "@components/control-ui/hooks/use-mobile.ts",
      "type": "registry:hook",
      "content": "import { useSyncExternalStore } from \"react\";\n\nconst MOBILE_BREAKPOINT = 768;\n\n// module-scoped because useSyncExternalStore re-subscribes on identity change — per-call closure would rebuild listener every render\nconst viewportStores = new Map<number, { subscribe: (onChange: () => void) => () => void; getSnapshot: () => boolean }>();\n\nfunction viewportStore(breakpoint: number) {\n  const cached = viewportStores.get(breakpoint);\n  if (cached) return cached;\n\n  const mobileQuery = `(max-width: ${breakpoint - 1}px)`;\n  const store = {\n    subscribe(onChange: () => void) {\n      const query = window.matchMedia(mobileQuery);\n      query.addEventListener(\"change\", onChange);\n      return () => query.removeEventListener(\"change\", onChange);\n    },\n    getSnapshot: () => window.matchMedia(mobileQuery).matches,\n  };\n  viewportStores.set(breakpoint, store);\n  return store;\n}\n\nfunction getServerViewportSnapshot() {\n  return false;\n}\n\n/** True below `breakpoint` px (Tailwind `md` by default); pass another breakpoint to match layout that switches elsewhere. */\nexport function useIsMobile(breakpoint: number = MOBILE_BREAKPOINT) {\n  const store = viewportStore(breakpoint);\n  return useSyncExternalStore(store.subscribe, store.getSnapshot, getServerViewportSnapshot);\n}\n"
    },
    {
      "path": "src/registry/knob-contracts/sidebar-knobs.ts",
      "target": "@components/control-ui/knob-contracts/sidebar-knobs.ts",
      "type": "registry:component",
      "content": "// Generated from src/registry/sources/control-ui/recipes/sidebar.css by scripts/gen-knob-contracts.ts — run `bun run sync:knobs`.\nexport const sidebarKnobs = [\n  \"--cui-sidebar-rail-divider-background\",\n  \"--cui-sidebar-wrapper-background\",\n  \"--cui-sidebar-wrapper-background-image\",\n  \"--cui-sidebar-menu-button-radius\",\n  \"--cui-sidebar-inner-background\",\n  \"--cui-sidebar-inner-border-color\",\n  \"--cui-sidebar-inner-background-image\",\n  \"--cui-sidebar-inner-border-width\",\n  \"--cui-sidebar-inner-radius\",\n  \"--cui-sidebar-inner-shadow\",\n  \"--cui-sidebar-inset-background\",\n  \"--cui-sidebar-inset-background-image\",\n  \"--cui-sidebar-inset-shadow\",\n  \"--cui-sidebar-group-label-foreground\",\n  \"--cui-sidebar-menu-button-foreground\",\n  \"--cui-sidebar-menu-button-hover-background\",\n  \"--cui-sidebar-menu-button-hover-foreground\",\n  \"--cui-sidebar-menu-button-hover-shadow\",\n  \"--cui-sidebar-menu-button-active-background\",\n  \"--cui-sidebar-menu-button-active-foreground\",\n  \"--cui-sidebar-menu-button-active-shadow\",\n] as const;\nexport type SidebarKnobStyle = Partial<Record<(typeof sidebarKnobs)[number], string>>;\n"
    },
    {
      "path": "src/registry/sources/control-ui/recipes/sidebar.css",
      "target": "@components/control-ui/styles/recipes/sidebar.css",
      "type": "registry:file",
      "content": "@layer components {\n  :where([data-control-family=\"sidebar\"][data-slot=\"wrapper\"]) {\n    --cui-sidebar-wrapper-background: transparent;\n    --cui-sidebar-wrapper-background-image: none;\n    --cui-sidebar-inset-background: var(--background);\n    --cui-sidebar-inset-background-image: none;\n    --cui-sidebar-inset-shadow: var(--shadow-sm);\n    background-color: var(--cui-sidebar-wrapper-background);\n    background-image: var(--cui-sidebar-wrapper-background-image);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"wrapper\"]:has([data-control-family=\"sidebar\"][data-variant=\"inset\"])) {\n    --cui-sidebar-wrapper-background: var(--sidebar);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"root\"]) {\n    --cui-sidebar-inner-background: var(--sidebar);\n    --cui-sidebar-inner-background-image: none;\n    --cui-sidebar-inner-border-color: var(--sidebar-border);\n    --cui-sidebar-inner-border-width: 0px;\n    --cui-sidebar-inner-radius: 0px;\n    --cui-sidebar-inner-shadow: none;\n    --cui-sidebar-rail-divider-background: transparent;\n    --cui-sidebar-group-label-foreground: oklch(from var(--sidebar-foreground) l c h / 0.7);\n    --cui-sidebar-menu-button-radius: var(--radius-popup-item);\n    --cui-sidebar-menu-button-foreground: var(--sidebar-foreground);\n    --cui-sidebar-menu-button-hover-background: oklch(from var(--foreground) l c h / 0.06);\n    --cui-sidebar-menu-button-hover-foreground: var(--foreground);\n    --cui-sidebar-menu-button-hover-shadow: 0 0 transparent;\n    --cui-sidebar-menu-button-active-background: oklch(from var(--foreground) l c h / 0.08);\n    --cui-sidebar-menu-button-active-shadow: 0 0 transparent;\n    --cui-sidebar-menu-button-active-foreground: var(--foreground);\n    background-color: var(--sidebar);\n    color: var(--sidebar-foreground);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"gap\"]) {\n    background-color: transparent;\n    transition: width var(--duration-base) var(--ease-standard);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"container\"]) {\n    transition-property: inset-inline-start, inset-inline-end, width;\n    transition-duration: var(--duration-base);\n    transition-timing-function: var(--ease-standard);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"root\"][data-variant=\"sidebar\"][data-side=\"left\"] [data-slot=\"container\"]) {\n    border-inline-end: 1px solid var(--sidebar-border);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"root\"][data-variant=\"sidebar\"][data-side=\"right\"] [data-slot=\"container\"]) {\n    border-inline-start: 1px solid var(--sidebar-border);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"inner\"]) {\n    border: var(--cui-sidebar-inner-border-width) solid var(--cui-sidebar-inner-border-color);\n    border-radius: var(--cui-sidebar-inner-radius);\n    background-color: var(--cui-sidebar-inner-background);\n    background-image: var(--cui-sidebar-inner-background-image);\n    box-shadow: var(--cui-sidebar-inner-shadow);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"root\"][data-variant=\"floating\"]) {\n    --cui-sidebar-inner-border-width: 1px;\n    --cui-sidebar-inner-radius: var(--radius-panel);\n    --cui-sidebar-inner-shadow: var(--shadow-md);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"rail\"]) {\n    background-image: linear-gradient(var(--cui-sidebar-rail-divider-background), var(--cui-sidebar-rail-divider-background));\n    background-position: center;\n    background-repeat: no-repeat;\n    background-size: 2px 100%;\n    transition-property: --cui-sidebar-rail-divider-background, background-color, translate;\n    transition-duration: var(--duration-base);\n    transition-timing-function: var(--ease-standard);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-collapsible=\"offcanvas\"] [data-slot=\"rail\"]) {\n    background-position: right;\n  }\n\n  @media (hover: hover) {\n    :where([data-control-family=\"sidebar\"][data-slot=\"rail\"]:hover) {\n      --cui-sidebar-rail-divider-background: var(--sidebar-border);\n    }\n\n    :where([data-control-family=\"sidebar\"][data-collapsible=\"offcanvas\"] [data-slot=\"rail\"]:hover) {\n      background-color: var(--sidebar);\n    }\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"inset\"]) {\n    background-color: var(--cui-sidebar-inset-background);\n    background-image: var(--cui-sidebar-inset-background-image);\n    transition-property: margin, border-radius, box-shadow;\n    transition-duration: var(--duration-base);\n    transition-timing-function: var(--ease-standard);\n  }\n\n  @media (width >= 64rem) {\n    :where([data-control-family=\"sidebar\"][data-slot=\"root\"][data-variant=\"inset\"] ~ [data-control-family=\"sidebar\"][data-slot=\"inset\"]) {\n      margin: 0.5rem;\n      margin-inline-start: 0;\n      border-radius: var(--radius-xl);\n      box-shadow: var(--cui-sidebar-inset-shadow);\n    }\n\n    :where(\n        [data-control-family=\"sidebar\"][data-slot=\"root\"][data-variant=\"inset\"][data-state=\"collapsed\"]\n          ~ [data-control-family=\"sidebar\"][data-slot=\"inset\"]\n      ) {\n      margin-inline-start: 0.5rem;\n    }\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"group-label\"]) {\n    border-radius: var(--radius-md);\n    color: var(--cui-sidebar-group-label-foreground);\n    font-size: var(--text-caption);\n    font-weight: 500;\n    outline: none;\n    transition-property: margin, opacity;\n    transition-duration: var(--duration-base);\n    transition-timing-function: var(--ease-standard);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"menu-button\"]) {\n    border-radius: var(--cui-sidebar-menu-button-radius);\n    background-color: transparent;\n    color: var(--cui-sidebar-menu-button-foreground);\n    outline: none;\n    transition-property: width, height, padding, color, background-color, box-shadow;\n    transition-duration: var(--duration-base);\n    transition-timing-function: var(--ease-standard);\n  }\n\n  @media (hover: hover) {\n    :where([data-control-family=\"sidebar\"][data-slot=\"menu-button\"]:hover) {\n      background-color: var(--cui-sidebar-menu-button-hover-background);\n      color: var(--cui-sidebar-menu-button-hover-foreground);\n      box-shadow: var(--cui-sidebar-menu-button-hover-shadow);\n    }\n\n    :where([data-control-family=\"sidebar\"][data-slot=\"menu-button\"][data-state=\"open\"]:hover) {\n      background-color: var(--cui-sidebar-menu-button-active-background);\n      color: var(--cui-sidebar-menu-button-active-foreground);\n    }\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"menu-button\"]:active),\n  :where([data-control-family=\"sidebar\"][data-slot=\"menu-button\"][data-active]) {\n    background-color: var(--cui-sidebar-menu-button-active-background);\n    color: var(--cui-sidebar-menu-button-active-foreground);\n    box-shadow: var(--cui-sidebar-menu-button-active-shadow);\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"menu-button\"][data-active]) {\n    font-weight: 500;\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"menu-button\"][data-variant=\"outline\"]) {\n    background-color: var(--background);\n    box-shadow: 0 0 0 1px var(--sidebar-border);\n  }\n\n  @media (hover: hover) {\n    :where([data-control-family=\"sidebar\"][data-slot=\"menu-button\"][data-variant=\"outline\"]:hover) {\n      box-shadow: 0 0 0 1px oklch(from var(--foreground) l c h / 0.08);\n    }\n  }\n\n  :where(\n    [data-control-family=\"sidebar\"][data-indicator=\"slide\"]\n      [data-control-family=\"sidebar\"][data-slot=\"menu-button\"]:is(:hover, :active, [data-active], [data-popup-open])\n  ) {\n    background-color: transparent;\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"menu-button\"]:disabled),\n  :where([data-control-family=\"sidebar\"][data-slot=\"menu-button\"][aria-disabled=\"true\"]) {\n    opacity: 0.5;\n  }\n\n  :where([data-control-family=\"sidebar\"][data-slot=\"root\"][data-side=\"right\"] [data-control-family=\"sidebar\"][data-slot=\"gap\"]) {\n    rotate: 180deg;\n  }\n}\n\n@property --cui-sidebar-rail-divider-background {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-sidebar-wrapper-background {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-sidebar-wrapper-background-image {\n  syntax: \"*\";\n  inherits: true;\n}\n\n@property --cui-sidebar-menu-button-radius {\n  syntax: \"<length-percentage>\";\n  inherits: true;\n  initial-value: 0px;\n}\n\n@property --cui-sidebar-inner-background {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-sidebar-inner-border-color {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-sidebar-inner-background-image {\n  syntax: \"*\";\n  inherits: true;\n}\n\n@property --cui-sidebar-inner-border-width {\n  syntax: \"<length>\";\n  inherits: true;\n  initial-value: 0px;\n}\n\n@property --cui-sidebar-inner-radius {\n  syntax: \"<length-percentage>\";\n  inherits: true;\n  initial-value: 0px;\n}\n\n@property --cui-sidebar-inner-shadow {\n  syntax: \"*\";\n  inherits: true;\n}\n\n@property --cui-sidebar-inset-background {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-sidebar-inset-background-image {\n  syntax: \"*\";\n  inherits: true;\n}\n\n@property --cui-sidebar-inset-shadow {\n  syntax: \"*\";\n  inherits: true;\n}\n\n@property --cui-sidebar-group-label-foreground {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-sidebar-menu-button-foreground {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-sidebar-menu-button-hover-background {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-sidebar-menu-button-hover-foreground {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-sidebar-menu-button-hover-shadow {\n  syntax: \"*\";\n  inherits: true;\n}\n\n@property --cui-sidebar-menu-button-active-background {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-sidebar-menu-button-active-foreground {\n  syntax: \"<color>\";\n  inherits: true;\n  initial-value: transparent;\n}\n\n@property --cui-sidebar-menu-button-active-shadow {\n  syntax: \"*\";\n  inherits: true;\n}\n"
    },
    {
      "path": "src/registry/sources/control-ui/ui/sidebar.tsx",
      "target": "@components/control-ui/ui/sidebar.tsx",
      "type": "registry:ui",
      "content": "\"use client\";\n\nimport { useRender } from \"@base-ui/react/use-render\";\nimport { cva } from \"class-variance-authority\";\nimport { PanelLeftIcon } from \"lucide-react\";\nimport type { ComponentProps, CSSProperties, ReactNode } from \"react\";\nimport { createContext, lazy, Suspense, useContext, useEffect, useRef, useState } from \"react\";\nimport { type RenderProp, type SelectionIndicator, SIDEBAR_COOKIE_NAME } from \"@/components/control-ui/control-props\";\nimport { controlSize } from \"@/components/control-ui/control-variants\";\nimport { useIsMobile } from \"@/components/control-ui/hooks/use-mobile\";\nimport type { SidebarKnobStyle } from \"@/components/control-ui/knob-contracts/sidebar-knobs\";\nimport { cn } from \"@/components/control-ui/lib/cn\";\nimport { skinIndicator, skinSidebarLayout, skinSidebarWidth } from \"@/components/control-ui/skin\";\nimport { Button } from \"@/components/control-ui/ui/button\";\nimport { ScrollArea } from \"@/components/control-ui/ui/scroll-area\";\nimport { Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle } from \"@/components/control-ui/ui/sheet\";\nimport { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from \"@/components/control-ui/ui/tooltip\";\n\nexport const sidebarMenuButtonVariants = [\"default\", \"outline\"] as const;\n\nexport type SidebarMenuButtonVariant = (typeof sidebarMenuButtonVariants)[number];\n\nexport const sidebarMenuButtonSizes = [\"default\", \"sm\", \"lg\"] as const;\n\nexport type SidebarMenuButtonSize = (typeof sidebarMenuButtonSizes)[number];\n\nexport type SidebarRailProps = Omit<ComponentProps<\"button\">, \"style\"> & { style?: CSSProperties & SidebarKnobStyle };\n\nexport type SidebarInsetProps = Omit<ComponentProps<\"main\">, \"style\"> & { style?: CSSProperties & SidebarKnobStyle };\n\nexport type SidebarGroupLabelProps = Omit<ComponentProps<\"div\">, \"style\"> & { style?: CSSProperties & SidebarKnobStyle } & {\n  render?: RenderProp<ComponentProps<\"div\">>;\n};\n\nexport type SidebarMenuButtonProps = Omit<ComponentProps<\"button\">, \"style\"> & { style?: CSSProperties & SidebarKnobStyle } & {\n  render?: RenderProp<ComponentProps<\"button\">>;\n  isActive?: boolean;\n  tooltip?: ReactNode;\n  variant?: SidebarMenuButtonVariant;\n  size?: SidebarMenuButtonSize;\n};\n\n/*\n * shadcn's Sidebar contract ported onto Control UI: provider owns open/collapsed state behind cookie and Cmd/Ctrl-B.\n * wrapper/gap/container slots and the --sidebar-width var are kept verbatim from shadcn so external resize handles keep working.\n */\n\n// lazy because highlight drags in JS geometry engine; it is decorative, so null fallback is fine\nconst TrackHighlight = lazy(() =>\n  import(\"@/components/control-ui/extensions/track-highlight\").then((module) => ({ default: module.TrackHighlight })),\n);\n\nconst SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;\n/** Exported so blocks can set width through `style` and stay type-checked. */\nexport type SidebarStyle = CSSProperties &\n  SidebarKnobStyle & {\n    \"--sidebar-width\"?: string;\n    \"--sidebar-width-icon\"?: string;\n  };\n\ntype SidebarSurfaceStyle = CSSProperties & SidebarKnobStyle;\n\nconst SIDEBAR_WIDTH = \"16rem\";\nconst SIDEBAR_WIDTH_MOBILE = \"18rem\";\nconst SIDEBAR_WIDTH_ICON = \"3rem\";\nconst SIDEBAR_KEYBOARD_SHORTCUT = \"b\";\n// this breakpoint and every `lg:` in file must name same width, or viewport lands between them with neither sheet nor docked rail rendered\nconst SIDEBAR_MOBILE_BREAKPOINT = 1024;\nconst sidebarTriggerWidth = {\n  xs: \"w-[var(--control-h-xs)]\",\n  sm: \"w-[var(--control-h-sm)]\",\n  md: \"w-[var(--control-h-md)]\",\n  lg: \"w-[var(--control-h-lg)]\",\n} satisfies Record<NonNullable<ComponentProps<typeof Button>[\"size\"]>, string>;\n\ntype 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\nconst SidebarContext = createContext<SidebarContextProps | null>(null);\n\nexport function useSidebar() {\n  const context = useContext(SidebarContext);\n  if (!context) {\n    throw new Error(\"useSidebar must be used within a SidebarProvider.\");\n  }\n\n  return context;\n}\n\nexport type SidebarProviderProps = Omit<ComponentProps<\"div\">, \"style\"> & {\n  defaultOpen?: boolean;\n  open?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  style?: SidebarStyle;\n};\n\nexport function SidebarProvider({\n  defaultOpen = true,\n  open: openProp,\n  onOpenChange: setOpenProp,\n  ref,\n  className,\n  style,\n  children,\n  ...props\n}: SidebarProviderProps) {\n  const isMobile = useIsMobile(SIDEBAR_MOBILE_BREAKPOINT);\n  const [openMobile, setOpenMobile] = useState(false);\n\n  const [_open, _setOpen] = useState(defaultOpen);\n  const open = openProp ?? _open;\n  const setOpen = (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    // biome-ignore lint/suspicious/noDocumentCookie: Cookie Store API isn't cross-browser yet.\n    document.cookie = `${SIDEBAR_COOKIE_NAME}=${openState}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`;\n  };\n\n  const toggleSidebar = () => (isMobile ? setOpenMobile((prev) => !prev) : setOpen(!open));\n\n  const toggleRef = useRef(toggleSidebar);\n  useEffect(() => {\n    toggleRef.current = toggleSidebar;\n  });\n\n  useEffect(() => {\n    const handleKeyDown = (event: KeyboardEvent) => {\n      if (event.key === SIDEBAR_KEYBOARD_SHORTCUT && (event.metaKey || event.ctrlKey)) {\n        event.preventDefault();\n        toggleRef.current();\n      }\n    };\n\n    window.addEventListener(\"keydown\", handleKeyDown);\n    return () => window.removeEventListener(\"keydown\", handleKeyDown);\n  }, []);\n\n  const state = open ? \"expanded\" : \"collapsed\";\n\n  const contextValue: SidebarContextProps = { state, open, setOpen, isMobile, openMobile, setOpenMobile, toggleSidebar };\n\n  // caller's --sidebar-width → skin → shadcn default\n  const wrapperStyle: SidebarStyle = {\n    \"--sidebar-width\": skinSidebarWidth() ?? SIDEBAR_WIDTH,\n    \"--sidebar-width-icon\": SIDEBAR_WIDTH_ICON,\n    ...style,\n  };\n\n  return (\n    <SidebarContext.Provider value={contextValue}>\n      <TooltipProvider delay={0}>\n        <div\n          ref={ref}\n          data-control-ui=\"sidebar\"\n          data-control-family=\"sidebar\"\n          data-slot=\"wrapper\"\n          style={wrapperStyle}\n          className={cn(\"group/sidebar-wrapper flex min-h-svh w-full\", className)}\n          {...props}\n        >\n          {children}\n        </div>\n      </TooltipProvider>\n    </SidebarContext.Provider>\n  );\n}\n\nexport function Sidebar({\n  side = \"left\",\n  variant,\n  collapsible = \"offcanvas\",\n  ref,\n  className,\n  children,\n  style,\n  ...props\n}: Omit<ComponentProps<\"div\">, \"style\"> & {\n  side?: \"left\" | \"right\";\n  variant?: \"sidebar\" | \"floating\" | \"inset\";\n  collapsible?: \"offcanvas\" | \"icon\" | \"none\";\n  style?: SidebarSurfaceStyle;\n}) {\n  const { isMobile, state, openMobile, setOpenMobile } = useSidebar();\n  // variant prop → skin → docked; drives gap, padding, rounding, and shadow geometry no per-slot class can express\n  const resolvedVariant = variant ?? skinSidebarLayout() ?? \"sidebar\";\n\n  if (collapsible === \"none\") {\n    return (\n      <div\n        ref={ref}\n        data-control-ui=\"sidebar\"\n        data-control-family=\"sidebar\"\n        data-slot=\"root\"\n        data-surface=\"panel\"\n        className={cn(\"flex h-full w-(--sidebar-width) flex-col\", className)}\n        style={style}\n        {...props}\n      >\n        {children}\n      </div>\n    );\n  }\n\n  if (isMobile) {\n    const mobileSheetStyle: SidebarStyle & SidebarSurfaceStyle = {\n      \"--sidebar-width\": SIDEBAR_WIDTH_MOBILE,\n      ...style,\n    };\n\n    return (\n      <Sheet open={openMobile} onOpenChange={setOpenMobile}>\n        <SheetContent\n          ref={ref}\n          data-control-ui=\"sidebar\"\n          data-control-family=\"sidebar\"\n          data-slot=\"root\"\n          data-surface=\"panel\"\n          side={side}\n          className=\"w-(--sidebar-width) gap-0 p-0\"\n          style={mobileSheetStyle}\n        >\n          <SheetHeader className=\"sr-only\">\n            <SheetTitle>Sidebar</SheetTitle>\n            <SheetDescription>Displays the mobile sidebar.</SheetDescription>\n          </SheetHeader>\n          <div data-control-ui=\"sidebar\" data-control-family=\"sidebar\" data-slot=\"inner\" className=\"flex h-full w-full flex-col\">\n            {children}\n          </div>\n        </SheetContent>\n      </Sheet>\n    );\n  }\n\n  return (\n    <div\n      className=\"group peer hidden lg:block\"\n      data-control-ui=\"sidebar\"\n      data-control-family=\"sidebar\"\n      data-slot=\"root\"\n      data-surface=\"panel\"\n      data-state={state}\n      data-collapsible={state === \"collapsed\" ? collapsible : \"\"}\n      data-variant={resolvedVariant}\n      data-side={side}\n      style={style}\n    >\n      <div\n        data-control-ui=\"sidebar\"\n        data-control-family=\"sidebar\"\n        data-slot=\"gap\"\n        className={cn(\n          \"relative w-(--sidebar-width)\",\n          \"group-data-[collapsible=offcanvas]:w-0\",\n          resolvedVariant === \"floating\" || resolvedVariant === \"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      />\n      <div\n        ref={ref}\n        data-control-ui=\"sidebar\"\n        data-control-family=\"sidebar\"\n        data-slot=\"container\"\n        className={cn(\n          \"fixed inset-y-0 z-10 hidden h-svh w-(--sidebar-width) lg: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          resolvedVariant === \"floating\" || resolvedVariant === \"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)\",\n          className,\n        )}\n        {...props}\n      >\n        <div data-control-ui=\"sidebar\" data-control-family=\"sidebar\" data-slot=\"inner\" className=\"flex h-full w-full flex-col\">\n          {children}\n        </div>\n      </div>\n    </div>\n  );\n}\n\nexport function SidebarTrigger({ className, onClick, size = \"sm\", ...props }: ComponentProps<typeof Button>) {\n  const { toggleSidebar } = useSidebar();\n\n  return (\n    <Button\n      data-control-ui=\"sidebar\"\n      data-slot=\"trigger\"\n      variant=\"ghost\"\n      size={size}\n      className={cn(sidebarTriggerWidth[size], \"px-0\", className)}\n      onClick={(event) => {\n        onClick?.(event);\n        toggleSidebar();\n      }}\n      {...props}\n    >\n      <PanelLeftIcon className=\"size-4\" />\n      <span className=\"sr-only\">Toggle Sidebar</span>\n    </Button>\n  );\n}\n\nexport function SidebarRail({ className, ...props }: SidebarRailProps) {\n  const { toggleSidebar } = useSidebar();\n\n  return (\n    <button\n      type=\"button\"\n      data-control-ui=\"sidebar\"\n      data-control-family=\"sidebar\"\n      data-slot=\"rail\"\n      aria-label=\"Toggle Sidebar\"\n      tabIndex={-1}\n      onClick={toggleSidebar}\n      title=\"Toggle Sidebar\"\n      className={cn(\n        \"absolute inset-y-0 z-20 hidden w-4 -translate-x-1/2 group-data-[side=left]:-right-4 group-data-[side=right]:left-0 lg:flex\",\n        \"in-data-[side=left]:cursor-w-resize in-data-[side=right]:cursor-e-resize\",\n        \"[[data-side=left][data-state=collapsed]_&]:cursor-e-resize [[data-side=right][data-state=collapsed]_&]:cursor-w-resize\",\n        \"group-data-[collapsible=offcanvas]:translate-x-0\",\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nexport function SidebarInset({ className, ...props }: SidebarInsetProps) {\n  return (\n    <main\n      data-control-ui=\"sidebar\"\n      data-control-family=\"sidebar\"\n      data-slot=\"inset\"\n      className={cn(\n        \"relative flex w-full flex-1 flex-col\",\n        \"lg:peer-data-[variant=inset]:m-2 lg:peer-data-[variant=inset]:ml-0 lg:peer-data-[variant=inset]:peer-data-[state=collapsed]:ml-2\",\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nexport function SidebarHeader({ className, ...props }: ComponentProps<\"div\"> & { style?: CSSProperties & SidebarKnobStyle }) {\n  return (\n    <div\n      data-control-ui=\"sidebar\"\n      data-control-family=\"sidebar\"\n      data-slot=\"header\"\n      className={cn(\"flex flex-col gap-2 p-2\", className)}\n      {...props}\n    />\n  );\n}\n\nexport function SidebarFooter({ className, ...props }: ComponentProps<\"div\"> & { style?: CSSProperties & SidebarKnobStyle }) {\n  return (\n    <div\n      data-control-ui=\"sidebar\"\n      data-control-family=\"sidebar\"\n      data-slot=\"footer\"\n      className={cn(\"flex flex-col gap-2 p-2\", className)}\n      {...props}\n    />\n  );\n}\n\nexport function SidebarContent({ className, children, ...props }: ComponentProps<\"div\">) {\n  return (\n    <ScrollArea\n      data-control-ui=\"sidebar\"\n      data-slot=\"content\"\n      className={cn(\"min-h-0 flex-1 group-data-[collapsible=icon]:overflow-hidden\", className)}\n      lockAxis=\"x\"\n      {...props}\n    >\n      <div className=\"flex flex-col gap-2\">{children}</div>\n    </ScrollArea>\n  );\n}\n\nexport function SidebarGroup({ className, ...props }: ComponentProps<\"div\"> & { style?: CSSProperties & SidebarKnobStyle }) {\n  return (\n    <div\n      data-control-ui=\"sidebar\"\n      data-control-family=\"sidebar\"\n      data-slot=\"group\"\n      className={cn(\"relative flex w-full min-w-0 flex-col p-2\", className)}\n      {...props}\n    />\n  );\n}\n\nexport function SidebarGroupLabel({ className, render, children, ...props }: SidebarGroupLabelProps) {\n  return useRender({\n    defaultTagName: \"div\",\n    render,\n    props: {\n      ...props,\n      \"data-control-ui\": \"sidebar\",\n      \"data-control-family\": \"sidebar\",\n      \"data-slot\": \"group-label\",\n      className: cn(\n        \"flex h-[var(--control-h-sm)] shrink-0 items-center gap-2 px-2 [&>svg]:size-4 [&>svg]:shrink-0\",\n        \"group-data-[collapsible=icon]:-mt-[var(--control-h-sm)] group-data-[collapsible=icon]:opacity-0\",\n        className,\n      ),\n      children,\n    },\n  });\n}\n\nexport type SidebarSelectionIndicator = SelectionIndicator;\n\n// SidebarMenuButton drops its per-row background while pill is on; outside slide menu it defaults to \"none\".\nconst SidebarMenuContext = createContext<SidebarSelectionIndicator>(\"none\");\n\nexport function SidebarMenu({\n  className,\n  indicator,\n  children,\n  ...props\n}: ComponentProps<\"ul\"> & {\n  /**\n   * `slide` replaces per-row backgrounds with one pill that glides to hovered or active item.\n   * Defaults to ControlUiSkin.indicators.sidebar, else `none`.\n   */\n  indicator?: SidebarSelectionIndicator;\n} & { style?: CSSProperties & SidebarKnobStyle }) {\n  // prop → skin → off\n  const resolvedIndicator = indicator ?? skinIndicator(\"sidebar\") ?? \"none\";\n  const sliding = resolvedIndicator === \"slide\";\n\n  const list = (\n    <ul\n      data-control-ui=\"sidebar\"\n      data-control-family=\"sidebar\"\n      data-slot=\"menu\"\n      data-indicator={resolvedIndicator}\n      className={cn(\"flex w-full min-w-0 flex-col gap-1\", sliding ? undefined : className)}\n      {...props}\n    >\n      <SidebarMenuContext.Provider value={resolvedIndicator}>{children}</SidebarMenuContext.Provider>\n    </ul>\n  );\n\n  if (!sliding) return list;\n\n  // wrapped, never injected into the <ul>: pill must stay sibling of menu items\n  // paint routes through the --track-highlight-* knobs so skin re-values vars instead of fighting utilities\n  return (\n    <div\n      data-control-ui=\"sidebar\"\n      data-control-family=\"sidebar\"\n      data-slot=\"menu-track\"\n      data-indicator={resolvedIndicator}\n      className={cn(\"relative isolate\", className)}\n    >\n      <Suspense fallback={null}>\n        <TrackHighlight\n          itemSelector='[data-control-ui=\"sidebar\"][data-slot=\"menu-button\"]'\n          activeSelector='[data-control-ui=\"sidebar\"][data-slot=\"menu-button\"][data-active]'\n        />\n      </Suspense>\n      {list}\n    </div>\n  );\n}\n\nexport function SidebarMenuItem({ className, ...props }: ComponentProps<\"li\"> & { style?: CSSProperties & SidebarKnobStyle }) {\n  return (\n    <li\n      data-control-ui=\"sidebar\"\n      data-control-family=\"sidebar\"\n      data-slot=\"menu-item\"\n      className={cn(\"group/menu-item relative\", className)}\n      {...props}\n    />\n  );\n}\n\nconst sidebarMenuButtonVariantClasses = {\n  default: null,\n  outline: null,\n} satisfies Record<SidebarMenuButtonVariant, null>;\n\nconst sidebarMenuButtonSizeClasses = {\n  default: `${controlSize({ size: \"md\" })} group-data-[collapsible=icon]:size-[var(--control-h-md)]!`,\n  sm: `${controlSize({ size: \"sm\" })} group-data-[collapsible=icon]:size-[var(--control-h-sm)]!`,\n  lg: `${controlSize({ size: \"lg\" })} group-data-[collapsible=icon]:size-[var(--control-h-lg)]!`,\n} satisfies Record<SidebarMenuButtonSize, string>;\n\nconst sidebarMenuButtonClasses = cva(\n  \"peer/menu-button flex w-full items-center overflow-hidden group-data-[collapsible=icon]:px-0! disabled:pointer-events-none aria-disabled:pointer-events-none [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0\",\n  {\n    variants: {\n      variant: sidebarMenuButtonVariantClasses,\n      size: sidebarMenuButtonSizeClasses,\n    },\n    defaultVariants: { variant: \"default\", size: \"default\" },\n  },\n);\n\nexport function SidebarMenuButton({\n  render,\n  isActive = false,\n  variant = \"default\",\n  size = \"default\",\n  tooltip,\n  className,\n  children,\n  ...props\n}: SidebarMenuButtonProps) {\n  const { isMobile, state } = useSidebar();\n\n  const button = useRender({\n    defaultTagName: \"button\",\n    render,\n    props: {\n      ...props,\n      \"data-control-ui\": \"sidebar\",\n      \"data-control-family\": \"sidebar\",\n      \"data-slot\": \"menu-button\",\n      \"data-size\": size,\n      \"data-variant\": variant,\n      \"data-active\": isActive || undefined,\n      className: cn(sidebarMenuButtonClasses({ variant, size }), className),\n      children,\n    },\n  });\n\n  if (!tooltip) return button;\n\n  return (\n    <Tooltip>\n      <TooltipTrigger render={button} />\n      <TooltipContent side=\"right\" align=\"center\" hidden={state !== \"collapsed\" || isMobile}>\n        {tooltip}\n      </TooltipContent>\n    </Tooltip>\n  );\n}\n"
    }
  ],
  "css": {
    "@import \"../components/control-ui/styles/recipes/sidebar.css\"": {}
  },
  "meta": {}
}