@srcroot/ui 0.0.54 → 0.0.56

package/src/registry/ui/sidebar.tsx

@@ -1,628 +1,628 @@
-"use client"
-
-import * as React from "react"
-import { LuPanelLeft } from "react-icons/lu";
-import { cva, type VariantProps } from "class-variance-authority"
-
-import { cn } from "@/lib/utils"
-import { Button } from "@/components/ui/button"
-import { Slot } from "@/components/ui/slot"
-import { Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle } from "@/components/ui/sheet"
-
-
-
-const SidebarContext = React.createContext<{
-    state: "expanded" | "collapsed"
-    open: boolean
-    setOpen: (open: boolean) => void
-    openMobile: boolean
-    setOpenMobile: (open: boolean) => void
-    isMobile: boolean
-    toggleSidebar: () => void
-} | null>(null)
-
-function useSidebar() {
-    const context = React.useContext(SidebarContext)
-    if (!context) {
-        throw new Error("useSidebar must be used within a SidebarProvider")
-    }
-    return context
-}
-
-const SidebarProvider = React.forwardRef<
-    HTMLDivElement,
-    React.HTMLAttributes<HTMLDivElement> & {
-        defaultOpen?: boolean
-        open?: boolean
-        onOpenChange?: (open: boolean) => void
-    }
->(({ className, style, children, defaultOpen = true, open: openProp, onOpenChange: setOpenProp, ...props }, ref) => {
-    const [isMobile, setIsMobile] = React.useState(false)
-    const [openMobile, setOpenMobile] = React.useState(false)
-
-    // Using internal state for "expanded/collapsed" on desktop
-    const [_open, _setOpen] = React.useState(defaultOpen)
-    const open = openProp ?? _open
-    const setOpen = React.useCallback(
-        (value: boolean | ((value: boolean) => boolean)) => {
-            if (setOpenProp) {
-                return setOpenProp(typeof value === "function" ? value(open) : value)
-            }
-            _setOpen(value)
-        },
-        [setOpenProp, open]
-    )
-
-
-    // Collapsible state helper
-    const state = open ? "expanded" : "collapsed"
-
-    const toggleSidebar = React.useCallback(() => {
-        return isMobile ? setOpenMobile((open) => !open) : setOpen((open) => !open)
-    }, [isMobile, setOpen, setOpenMobile])
-
-
-    React.useEffect(() => {
-        const checkMobile = () => {
-            setIsMobile(window.innerWidth < 768) // md breakpoint
-        }
-        checkMobile()
-        window.addEventListener("resize", checkMobile)
-        return () => window.removeEventListener("resize", checkMobile)
-    }, [])
-
-    return (
-        <SidebarContext.Provider
-            value={{
-                state,
-                open,
-                setOpen,
-                isMobile,
-                openMobile,
-                setOpenMobile,
-                toggleSidebar,
-            }}
-        >
-            <div
-                style={
-                    {
-                        ...style,
-                    } as React.CSSProperties
-                }
-                ref={ref}
-                className={cn(
-                    "group/sidebar-wrapper flex min-h-screen w-full has-[[data-variant=inset]]:bg-sidebar",
-                    className
-                )}
-                {...props}
-            >
-                {children}
-            </div>
-        </SidebarContext.Provider>
-    )
-})
-SidebarProvider.displayName = "SidebarProvider"
-
-
-/**
- * Sidebar component for application layout
- * 
- * @example
- * <SidebarProvider>
- *   <Sidebar>
- *     <SidebarHeader />
- *     <SidebarContent>
- *       <SidebarGroup />
- *       <SidebarMenu />
- *     </SidebarContent>
- *     <SidebarFooter />
- *   </Sidebar>
- *   <SidebarInset>
- *     <main>Content</main>
- *   </SidebarInset>
- * </SidebarProvider>
- */
-const Sidebar = React.forwardRef<
-    HTMLDivElement,
-    React.HTMLAttributes<HTMLDivElement> & {
-        side?: "left" | "right"
-        variant?: "sidebar" | "floating" | "inset"
-        collapsible?: "offcanvas" | "icon" | "none"
-    }
->(
-    (
-        {
-            side = "left",
-            variant = "sidebar",
-            collapsible = "offcanvas",
-            className,
-            children,
-            ...props
-        },
-        ref
-    ) => {
-        const { isMobile, state, openMobile, setOpenMobile } = useSidebar()
-
-        if (collapsible === "none") {
-            return (
-                <div
-                    className={cn(
-                        "flex h-full w-[var(--sidebar-width)] flex-col bg-sidebar text-sidebar-foreground",
-                        className
-                    )}
-                    ref={ref}
-                    {...props}
-                >
-                    {children}
-                </div>
-            )
-        }
-
-        if (isMobile) {
-            return (
-                <Sheet open={openMobile} onOpenChange={setOpenMobile} {...props}>
-                    <SheetContent
-                        data-sidebar="sidebar"
-                        data-mobile="true"
-                        className="w-[var(--sidebar-width)] bg-sidebar p-0 text-sidebar-foreground [&>button]:hidden"
-                        style={
-                            {
-                                "--sidebar-width": "var(--sidebar-width-mobile)",
-                            } as React.CSSProperties
-                        }
-                        side={side}
-                    >
-                        {/* Hidden Headers for Accessibility */}
-                        <div className="sr-only">
-                            <SheetHeader>
-                                <SheetTitle>Menu</SheetTitle>
-                                <SheetDescription>Navigation Menu</SheetDescription>
-                            </SheetHeader>
-                        </div>
-                        <div className="flex h-full w-full flex-col">{children}</div>
-                    </SheetContent>
-                </Sheet>
-            )
-        }
-
-        return (
-            <div
-                ref={ref}
-                className={cn(
-                    "group peer md:block text-sidebar-foreground",
-                    className
-                )}
-                data-state={state}
-                data-collapsible={state === "collapsed" ? collapsible : ""}
-                data-variant={variant}
-                data-side={side}
-            >
-                {/* Visual Gap for Sidebar (Fixed placeholder) */}
-                <div
-                    className={cn(
-                        "duration-200 relative h-svh w-[var(--sidebar-width)] bg-transparent transition-[width] ease-linear",
-                        "group-data-[collapsible=offcanvas]:w-0",
-                        "group-data-[side=right]:rotate-180",
-                        variant === "floating" || variant === "inset"
-                            ? "group-data-[collapsible=icon]:!w-[calc(var(--sidebar-width-icon)_+_theme(spacing.4))]"
-                            : "group-data-[collapsible=icon]:!w-[var(--sidebar-width-icon)]"
-                    )}
-                />
-
-                {/* Actual Fixed Sidebar */}
-                <div
-                    className={cn(
-                        "duration-200 fixed inset-y-0 z-10 h-svh w-[var(--sidebar-width)] transition-[left,right,width] ease-linear md:flex",
-                        side === "left"
-                            ? "left-0 group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)]"
-                            : "right-0 group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)]",
-                        // Adjustments for floating/inset
-                        variant === "floating" || variant === "inset"
-                            ? "p-2 group-data-[collapsible=icon]:!w-[calc(var(--sidebar-width-icon)_+_theme(spacing.4)_+_2px)]"
-                            : "group-data-[collapsible=icon]:!w-[var(--sidebar-width-icon)] group-data-[side=left]:border-r group-data-[side=right]:border-l",
-                        className
-                    )}
-                    {...props}
-                >
-                    <div
-                        data-sidebar="sidebar"
-                        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]:shadow"
-                    >
-                        {children}
-                    </div>
-                </div>
-            </div>
-        )
-    }
-)
-Sidebar.displayName = "Sidebar"
-
-const SidebarTrigger = React.forwardRef<
-    HTMLButtonElement,
-    React.ButtonHTMLAttributes<HTMLButtonElement>
->(({ className, onClick, ...props }, ref) => {
-    const { toggleSidebar } = useSidebar()
-
-    return (
-        <Button
-            ref={ref}
-            data-sidebar="trigger"
-            variant="ghost"
-            size="icon"
-            className={cn("h-7 w-7", className)}
-            onClick={(event: React.MouseEvent<HTMLButtonElement>) => {
-                onClick?.(event)
-                toggleSidebar()
-            }}
-            {...props}
-        >
-            <LuPanelLeft />
-            <span className="sr-only">Toggle Sidebar</span>
-        </Button>
-    )
-})
-SidebarTrigger.displayName = "SidebarTrigger"
-
-const SidebarRail = React.forwardRef<
-    HTMLButtonElement,
-    React.ButtonHTMLAttributes<HTMLButtonElement>
->(({ className, ...props }, ref) => {
-    const { toggleSidebar } = useSidebar()
-
-    return (
-        <button
-            ref={ref}
-            data-sidebar="rail"
-            aria-label="Toggle Sidebar"
-            tabIndex={-1}
-            onClick={toggleSidebar}
-            title="Toggle Sidebar"
-            className={cn(
-                "absolute inset-y-0 z-20 hidden w-4 -translate-x-1/2 transition-all ease-linear after:absolute after:inset-y-0 after:left-1/2 after:w-[2px] hover:after:bg-sidebar-border group-data-[side=left]:-right-4 group-data-[side=right]:left-0 sm:flex",
-                "[[data-side=left]_&]:cursor-w-resize [[data-side=right]_&]:cursor-e-resize",
-                "[[data-side=left][data-state=collapsed]_&]:cursor-e-resize [[data-side=right][data-state=collapsed]_&]:cursor-w-resize",
-                "group-data-[collapsible=offcanvas]:hover:bg-sidebar",
-                "group-data-[collapsible=icon]:w-2 group-data-[collapsible=icon]:group-data-[side=left]:-right-3 group-data-[collapsible=icon]:group-data-[side=right]:left-0",
-                className
-            )}
-            {...props}
-        />
-    )
-})
-SidebarRail.displayName = "SidebarRail"
-
-const SidebarInset = React.forwardRef<
-    HTMLDivElement,
-    React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => {
-    return (
-        <main
-            ref={ref}
-            className={cn(
-                "relative flex min-h-svh flex-1 flex-col bg-background",
-                // Width calculation based on sidebar state
-                "w-full md:w-[calc(100%-var(--sidebar-width))]",
-                "md:peer-data-[state=collapsed]:w-[calc(100%-var(--sidebar-width-icon))]",
-                "md:peer-data-[collapsible=offcanvas]:peer-data-[state=collapsed]:w-full",
-                // Transition for smooth resize
-                "transition-[width] duration-200 ease-linear",
-                // Inset variant styles
-                "peer-data-[variant=inset]:min-h-[calc(100svh-theme(spacing.4))] md:peer-data-[variant=inset]:m-2 md:peer-data-[state=collapsed]:peer-data-[variant=inset]:ml-2 md:peer-data-[variant=inset]:ml-0 md:peer-data-[variant=inset]:rounded-xl md:peer-data-[variant=inset]:shadow",
-                className
-            )}
-            {...props}
-        />
-    )
-})
-SidebarInset.displayName = "SidebarInset"
-
-const SidebarHeader = React.forwardRef<
-    HTMLDivElement,
-    React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => (
-    <div
-        ref={ref}
-        data-sidebar="header"
-        className={cn("flex flex-col gap-2 p-2", className)}
-        {...props}
-    />
-))
-SidebarHeader.displayName = "SidebarHeader"
-
-const SidebarFooter = React.forwardRef<
-    HTMLDivElement,
-    React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => (
-    <div
-        ref={ref}
-        data-sidebar="footer"
-        className={cn("flex flex-col gap-2 p-2", className)}
-        {...props}
-    />
-))
-SidebarFooter.displayName = "SidebarFooter"
-
-const SidebarContent = React.forwardRef<
-    HTMLDivElement,
-    React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => (
-    <div
-        ref={ref}
-        data-sidebar="content"
-        className={cn(
-            "flex min-h-0 flex-1 flex-col gap-2 overflow-auto group-data-[collapsible=icon]:overflow-hidden",
-            className
-        )}
-        {...props}
-    />
-))
-SidebarContent.displayName = "SidebarContent"
-
-const SidebarGroup = React.forwardRef<
-    HTMLDivElement,
-    React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => (
-    <div
-        ref={ref}
-        data-sidebar="group"
-        className={cn("relative flex w-full min-w-0 flex-col p-2", className)}
-        {...props}
-    />
-))
-SidebarGroup.displayName = "SidebarGroup"
-
-const SidebarGroupLabel = React.forwardRef<
-    HTMLDivElement,
-    React.HTMLAttributes<HTMLDivElement> & { asChild?: boolean }
->(({ className, asChild = false, ...props }, ref) => {
-    const Comp = asChild ? Slot : "div"
-
-    return (
-        <Comp
-            ref={ref}
-            data-sidebar="group-label"
-            className={cn(
-                "duration-200 flex h-8 shrink-0 items-center rounded-md px-2 text-xs font-medium text-sidebar-foreground/70 outline-none ring-sidebar-ring transition-[margin,opa] ease-linear focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0",
-                "group-data-[collapsible=icon]:-mt-8 group-data-[collapsible=icon]:opacity-0",
-                className
-            )}
-            {...props}
-        />
-    )
-})
-SidebarGroupLabel.displayName = "SidebarGroupLabel"
-
-const SidebarGroupContent = React.forwardRef<
-    HTMLDivElement,
-    React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => (
-    <div
-        ref={ref}
-        data-sidebar="group-content"
-        className={cn("w-full text-sm", className)}
-        {...props}
-    />
-))
-SidebarGroupContent.displayName = "SidebarGroupContent"
-
-const SidebarMenu = React.forwardRef<
-    HTMLUListElement,
-    React.HTMLAttributes<HTMLUListElement>
->(({ className, ...props }, ref) => (
-    <ul
-        ref={ref}
-        data-sidebar="menu"
-        className={cn("flex w-full min-w-0 flex-col gap-1", className)}
-        {...props}
-    />
-))
-SidebarMenu.displayName = "SidebarMenu"
-
-const SidebarMenuItem = React.forwardRef<
-    HTMLLIElement,
-    React.LiHTMLAttributes<HTMLLIElement>
->(({ className, ...props }, ref) => (
-    <li
-        ref={ref}
-        data-sidebar="menu-item"
-        className={cn("group/menu-item relative", className)}
-        {...props}
-    />
-))
-SidebarMenuItem.displayName = "SidebarMenuItem"
-
-const SidebarMenuButton = React.forwardRef<
-    HTMLButtonElement,
-    React.ButtonHTMLAttributes<HTMLButtonElement> & {
-        asChild?: boolean
-        isActive?: boolean
-        tooltip?: string | React.ComponentProps<any>
-        variant?: "default" | "ghost" | "outline" | "secondary" | "destructive" | "link" | null | undefined
-        size?: "default" | "sm" | "lg" | "icon" | null | undefined
-    }
->(
-    (
-        {
-            asChild = false,
-            isActive = false,
-            variant = "default",
-            size = "default",
-            tooltip,
-            className,
-            ...props
-        },
-        ref
-    ) => {
-        const { isMobile, state, setOpen } = useSidebar()
-
-        const buttonClass = cn(
-            "cursor-pointer peer/menu-button flex w-full items-center gap-2 overflow-hidden rounded-md 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-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0",
-            "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]:!p-2 [&>span:last-child]:group-data-[collapsible=icon]:hidden",
-            className
-        )
-
-        // If tooltip is needed, we should implement it. For now, ignoring complexity of tooltip.
-
-        const handleClick = (e: React.MouseEvent<HTMLButtonElement>) => {
-            props.onClick?.(e)
-            if (!isMobile && state === "collapsed") {
-                setOpen(true)
-            }
-        }
-
-        const Comp = asChild ? Slot : "button"
-
-        return (
-            <Comp
-                ref={ref}
-                data-sidebar="menu-button"
-                data-size={size}
-                data-active={isActive}
-                className={buttonClass}
-                onClick={handleClick}
-                {...props}
-            />
-        )
-    }
-)
-SidebarMenuButton.displayName = "SidebarMenuButton"
-
-const SidebarMenuAction = React.forwardRef<
-    HTMLButtonElement,
-    React.ButtonHTMLAttributes<HTMLButtonElement> & { asChild?: boolean; showOnHover?: boolean }
->(({ className, asChild = false, showOnHover = false, ...props }, ref) => {
-    const Comp = asChild ? Slot : "button"
-
-    return (
-        <Comp
-            ref={ref}
-            data-sidebar="menu-action"
-            className={cn(
-                "absolute right-1 top-1.5 flex aspect-square w-5 items-center justify-center rounded-md 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]:size-4 [&>svg]:shrink-0",
-                // Increases the hit area of the button on mobile.
-                "after:absolute after:-inset-2 after:md:hidden",
-                "peer-data-[size=sm]/menu-button:top-1",
-                "peer-data-[size=default]/menu-button:top-1.5",
-                "peer-data-[size=lg]/menu-button:top-2.5",
-                "group-data-[collapsible=icon]:hidden",
-                showOnHover &&
-                "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",
-                className
-            )}
-            {...props}
-        />
-    )
-})
-SidebarMenuAction.displayName = "SidebarMenuAction"
-
-const SidebarMenuSub = React.forwardRef<
-    HTMLUListElement,
-    React.HTMLAttributes<HTMLUListElement>
->(({ className, ...props }, ref) => (
-    <ul
-        ref={ref}
-        data-sidebar="menu-sub"
-        className={cn(
-            "mx-3.5 flex min-w-0 translate-x-px flex-col gap-1 border-l border-sidebar-border px-2.5 py-0.5",
-            "group-data-[collapsible=icon]:hidden",
-            className
-        )}
-        {...props}
-    />
-))
-SidebarMenuSub.displayName = "SidebarMenuSub"
-
-const SidebarMenuSubItem = React.forwardRef<
-    HTMLLIElement,
-    React.LiHTMLAttributes<HTMLLIElement>
->(({ ...props }, ref) => <li ref={ref} {...props} />)
-SidebarMenuSubItem.displayName = "SidebarMenuSubItem"
-
-const SidebarMenuSubButton = React.forwardRef<
-    HTMLAnchorElement,
-    React.AnchorHTMLAttributes<HTMLAnchorElement> & {
-        asChild?: boolean
-        size?: "sm" | "md"
-        isActive?: boolean
-    }
->(({ asChild = false, size = "md", isActive, className, ...props }, ref) => {
-    const Comp = asChild ? Slot : "a"
-
-    return (
-        <Comp
-            ref={ref}
-            data-sidebar="menu-sub-button"
-            data-size={size}
-            data-active={isActive}
-            className={cn(
-                "flex h-7 min-w-0 -translate-x-px items-center gap-2 overflow-hidden rounded-md 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-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0 group-data-[collapsible=icon]:hidden",
-                size === "sm" && "text-xs",
-                size === "md" && "text-sm",
-                "data-[active=true]:bg-sidebar-accent data-[active=true]:text-sidebar-accent-foreground",
-                className
-            )}
-            {...props}
-        />
-    )
-})
-SidebarMenuSubButton.displayName = "SidebarMenuSubButton"
-
-const SidebarInput = React.forwardRef<
-    HTMLInputElement,
-    React.InputHTMLAttributes<HTMLInputElement>
->(({ className, ...props }, ref) => {
-    return (
-        <input
-            ref={ref}
-            data-sidebar="input"
-            className={cn(
-                "flex h-8 w-full bg-background rounded-md px-3 text-sm shadow-sm transition-colors file:border-0 file:bg-transparent file:text-sm file:font-medium placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50 group-data-[collapsible=icon]:w-0 group-data-[collapsible=icon]:p-0 group-data-[collapsible=icon]:border-0 group-data-[collapsible=icon]:hidden",
-                className
-            )}
-            {...props}
-        />
-    )
-})
-SidebarInput.displayName = "SidebarInput"
-
-
-const SidebarSeparator = React.forwardRef<
-    HTMLDivElement,
-    React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => {
-    return (
-        <div
-            ref={ref}
-            data-sidebar="separator"
-            className={cn("mx-2 w-auto bg-sidebar-border h-px", className)}
-            {...props}
-        />
-    )
-})
-SidebarSeparator.displayName = "SidebarSeparator"
-
-export {
-    Sidebar,
-    SidebarContent,
-    SidebarFooter,
-    SidebarGroup,
-    SidebarGroupContent,
-    SidebarGroupLabel,
-    SidebarHeader,
-    SidebarInput,
-    SidebarInset,
-    SidebarMenu,
-    SidebarMenuAction,
-    SidebarMenuButton,
-    SidebarMenuItem,
-    SidebarMenuSub,
-    SidebarMenuSubButton,
-    SidebarMenuSubItem,
-    SidebarProvider,
-    SidebarRail,
-    SidebarSeparator,
-    SidebarTrigger,
-    useSidebar,
-}
+"use client"
+
+import * as React from "react"
+import { LuPanelLeft } from "react-icons/lu";
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@/lib/utils"
+import { Button } from "@/components/ui/button"
+import { Slot } from "@/components/ui/slot"
+import { Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle } from "@/components/ui/sheet"
+
+
+
+const SidebarContext = React.createContext<{
+    state: "expanded" | "collapsed"
+    open: boolean
+    setOpen: (open: boolean) => void
+    openMobile: boolean
+    setOpenMobile: (open: boolean) => void
+    isMobile: boolean
+    toggleSidebar: () => void
+} | null>(null)
+
+function useSidebar() {
+    const context = React.useContext(SidebarContext)
+    if (!context) {
+        throw new Error("useSidebar must be used within a SidebarProvider")
+    }
+    return context
+}
+
+const SidebarProvider = React.forwardRef<
+    HTMLDivElement,
+    React.HTMLAttributes<HTMLDivElement> & {
+        defaultOpen?: boolean
+        open?: boolean
+        onOpenChange?: (open: boolean) => void
+    }
+>(({ className, style, children, defaultOpen = true, open: openProp, onOpenChange: setOpenProp, ...props }, ref) => {
+    const [isMobile, setIsMobile] = React.useState(false)
+    const [openMobile, setOpenMobile] = React.useState(false)
+
+    // Using internal state for "expanded/collapsed" on desktop
+    const [_open, _setOpen] = React.useState(defaultOpen)
+    const open = openProp ?? _open
+    const setOpen = React.useCallback(
+        (value: boolean | ((value: boolean) => boolean)) => {
+            if (setOpenProp) {
+                return setOpenProp(typeof value === "function" ? value(open) : value)
+            }
+            _setOpen(value)
+        },
+        [setOpenProp, open]
+    )
+
+
+    // Collapsible state helper
+    const state = open ? "expanded" : "collapsed"
+
+    const toggleSidebar = React.useCallback(() => {
+        return isMobile ? setOpenMobile((open) => !open) : setOpen((open) => !open)
+    }, [isMobile, setOpen, setOpenMobile])
+
+
+    React.useEffect(() => {
+        const checkMobile = () => {
+            setIsMobile(window.innerWidth < 768) // md breakpoint
+        }
+        checkMobile()
+        window.addEventListener("resize", checkMobile)
+        return () => window.removeEventListener("resize", checkMobile)
+    }, [])
+
+    return (
+        <SidebarContext.Provider
+            value={{
+                state,
+                open,
+                setOpen,
+                isMobile,
+                openMobile,
+                setOpenMobile,
+                toggleSidebar,
+            }}
+        >
+            <div
+                style={
+                    {
+                        ...style,
+                    } as React.CSSProperties
+                }
+                ref={ref}
+                className={cn(
+                    "group/sidebar-wrapper flex min-h-screen w-full has-[[data-variant=inset]]:bg-sidebar",
+                    className
+                )}
+                {...props}
+            >
+                {children}
+            </div>
+        </SidebarContext.Provider>
+    )
+})
+SidebarProvider.displayName = "SidebarProvider"
+
+
+/**
+ * Sidebar component for application layout
+ * 
+ * @example
+ * <SidebarProvider>
+ *   <Sidebar>
+ *     <SidebarHeader />
+ *     <SidebarContent>
+ *       <SidebarGroup />
+ *       <SidebarMenu />
+ *     </SidebarContent>
+ *     <SidebarFooter />
+ *   </Sidebar>
+ *   <SidebarInset>
+ *     <main>Content</main>
+ *   </SidebarInset>
+ * </SidebarProvider>
+ */
+const Sidebar = React.forwardRef<
+    HTMLDivElement,
+    React.HTMLAttributes<HTMLDivElement> & {
+        side?: "left" | "right"
+        variant?: "sidebar" | "floating" | "inset"
+        collapsible?: "offcanvas" | "icon" | "none"
+    }
+>(
+    (
+        {
+            side = "left",
+            variant = "sidebar",
+            collapsible = "offcanvas",
+            className,
+            children,
+            ...props
+        },
+        ref
+    ) => {
+        const { isMobile, state, openMobile, setOpenMobile } = useSidebar()
+
+        if (collapsible === "none") {
+            return (
+                <div
+                    className={cn(
+                        "flex h-full w-[var(--sidebar-width)] flex-col bg-sidebar text-sidebar-foreground",
+                        className
+                    )}
+                    ref={ref}
+                    {...props}
+                >
+                    {children}
+                </div>
+            )
+        }
+
+        if (isMobile) {
+            return (
+                <Sheet open={openMobile} onOpenChange={setOpenMobile} {...props}>
+                    <SheetContent
+                        data-sidebar="sidebar"
+                        data-mobile="true"
+                        className="w-[var(--sidebar-width)] bg-sidebar p-0 text-sidebar-foreground [&>button]:hidden"
+                        style={
+                            {
+                                "--sidebar-width": "var(--sidebar-width-mobile)",
+                            } as React.CSSProperties
+                        }
+                        side={side}
+                    >
+                        {/* Hidden Headers for Accessibility */}
+                        <div className="sr-only">
+                            <SheetHeader>
+                                <SheetTitle>Menu</SheetTitle>
+                                <SheetDescription>Navigation Menu</SheetDescription>
+                            </SheetHeader>
+                        </div>
+                        <div className="flex h-full w-full flex-col">{children}</div>
+                    </SheetContent>
+                </Sheet>
+            )
+        }
+
+        return (
+            <div
+                ref={ref}
+                className={cn(
+                    "group peer md:block text-sidebar-foreground",
+                    className
+                )}
+                data-state={state}
+                data-collapsible={state === "collapsed" ? collapsible : ""}
+                data-variant={variant}
+                data-side={side}
+            >
+                {/* Visual Gap for Sidebar (Fixed placeholder) */}
+                <div
+                    className={cn(
+                        "duration-200 relative h-svh w-[var(--sidebar-width)] bg-transparent transition-[width] ease-linear",
+                        "group-data-[collapsible=offcanvas]:w-0",
+                        "group-data-[side=right]:rotate-180",
+                        variant === "floating" || variant === "inset"
+                            ? "group-data-[collapsible=icon]:!w-[calc(var(--sidebar-width-icon)_+_theme(spacing.4))]"
+                            : "group-data-[collapsible=icon]:!w-[var(--sidebar-width-icon)]"
+                    )}
+                />
+
+                {/* Actual Fixed Sidebar */}
+                <div
+                    className={cn(
+                        "duration-200 fixed inset-y-0 z-10 h-svh w-[var(--sidebar-width)] transition-[left,right,width] ease-linear md:flex",
+                        side === "left"
+                            ? "left-0 group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)]"
+                            : "right-0 group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)]",
+                        // Adjustments for floating/inset
+                        variant === "floating" || variant === "inset"
+                            ? "p-2 group-data-[collapsible=icon]:!w-[calc(var(--sidebar-width-icon)_+_theme(spacing.4)_+_2px)]"
+                            : "group-data-[collapsible=icon]:!w-[var(--sidebar-width-icon)] group-data-[side=left]:border-r group-data-[side=right]:border-l",
+                        className
+                    )}
+                    {...props}
+                >
+                    <div
+                        data-sidebar="sidebar"
+                        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]:shadow"
+                    >
+                        {children}
+                    </div>
+                </div>
+            </div>
+        )
+    }
+)
+Sidebar.displayName = "Sidebar"
+
+const SidebarTrigger = React.forwardRef<
+    HTMLButtonElement,
+    React.ButtonHTMLAttributes<HTMLButtonElement>
+>(({ className, onClick, ...props }, ref) => {
+    const { toggleSidebar } = useSidebar()
+
+    return (
+        <Button
+            ref={ref}
+            data-sidebar="trigger"
+            variant="ghost"
+            size="icon"
+            className={cn("h-7 w-7", className)}
+            onClick={(event: React.MouseEvent<HTMLButtonElement>) => {
+                onClick?.(event)
+                toggleSidebar()
+            }}
+            {...props}
+        >
+            <LuPanelLeft />
+            <span className="sr-only">Toggle Sidebar</span>
+        </Button>
+    )
+})
+SidebarTrigger.displayName = "SidebarTrigger"
+
+const SidebarRail = React.forwardRef<
+    HTMLButtonElement,
+    React.ButtonHTMLAttributes<HTMLButtonElement>
+>(({ className, ...props }, ref) => {
+    const { toggleSidebar } = useSidebar()
+
+    return (
+        <button
+            ref={ref}
+            data-sidebar="rail"
+            aria-label="Toggle Sidebar"
+            tabIndex={-1}
+            onClick={toggleSidebar}
+            title="Toggle Sidebar"
+            className={cn(
+                "absolute inset-y-0 z-20 hidden w-4 -translate-x-1/2 transition-all ease-linear after:absolute after:inset-y-0 after:left-1/2 after:w-[2px] hover:after:bg-sidebar-border group-data-[side=left]:-right-4 group-data-[side=right]:left-0 sm:flex",
+                "[[data-side=left]_&]:cursor-w-resize [[data-side=right]_&]:cursor-e-resize",
+                "[[data-side=left][data-state=collapsed]_&]:cursor-e-resize [[data-side=right][data-state=collapsed]_&]:cursor-w-resize",
+                "group-data-[collapsible=offcanvas]:hover:bg-sidebar",
+                "group-data-[collapsible=icon]:w-2 group-data-[collapsible=icon]:group-data-[side=left]:-right-3 group-data-[collapsible=icon]:group-data-[side=right]:left-0",
+                className
+            )}
+            {...props}
+        />
+    )
+})
+SidebarRail.displayName = "SidebarRail"
+
+const SidebarInset = React.forwardRef<
+    HTMLDivElement,
+    React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => {
+    return (
+        <main
+            ref={ref}
+            className={cn(
+                "relative flex min-h-svh flex-1 flex-col bg-background",
+                // Width calculation based on sidebar state
+                "w-full md:w-[calc(100%-var(--sidebar-width))]",
+                "md:peer-data-[state=collapsed]:w-[calc(100%-var(--sidebar-width-icon))]",
+                "md:peer-data-[collapsible=offcanvas]:peer-data-[state=collapsed]:w-full",
+                // Transition for smooth resize
+                "transition-[width] duration-200 ease-linear",
+                // Inset variant styles
+                "peer-data-[variant=inset]:min-h-[calc(100svh-theme(spacing.4))] md:peer-data-[variant=inset]:m-2 md:peer-data-[state=collapsed]:peer-data-[variant=inset]:ml-2 md:peer-data-[variant=inset]:ml-0 md:peer-data-[variant=inset]:rounded-xl md:peer-data-[variant=inset]:shadow",
+                className
+            )}
+            {...props}
+        />
+    )
+})
+SidebarInset.displayName = "SidebarInset"
+
+const SidebarHeader = React.forwardRef<
+    HTMLDivElement,
+    React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+    <div
+        ref={ref}
+        data-sidebar="header"
+        className={cn("flex flex-col gap-2 p-2", className)}
+        {...props}
+    />
+))
+SidebarHeader.displayName = "SidebarHeader"
+
+const SidebarFooter = React.forwardRef<
+    HTMLDivElement,
+    React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+    <div
+        ref={ref}
+        data-sidebar="footer"
+        className={cn("flex flex-col gap-2 p-2", className)}
+        {...props}
+    />
+))
+SidebarFooter.displayName = "SidebarFooter"
+
+const SidebarContent = React.forwardRef<
+    HTMLDivElement,
+    React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+    <div
+        ref={ref}
+        data-sidebar="content"
+        className={cn(
+            "flex min-h-0 flex-1 flex-col gap-2 overflow-auto group-data-[collapsible=icon]:overflow-hidden",
+            className
+        )}
+        {...props}
+    />
+))
+SidebarContent.displayName = "SidebarContent"
+
+const SidebarGroup = React.forwardRef<
+    HTMLDivElement,
+    React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+    <div
+        ref={ref}
+        data-sidebar="group"
+        className={cn("relative flex w-full min-w-0 flex-col p-2", className)}
+        {...props}
+    />
+))
+SidebarGroup.displayName = "SidebarGroup"
+
+const SidebarGroupLabel = React.forwardRef<
+    HTMLDivElement,
+    React.HTMLAttributes<HTMLDivElement> & { asChild?: boolean }
+>(({ className, asChild = false, ...props }, ref) => {
+    const Comp = asChild ? Slot : "div"
+
+    return (
+        <Comp
+            ref={ref}
+            data-sidebar="group-label"
+            className={cn(
+                "duration-200 flex h-8 shrink-0 items-center rounded-md px-2 text-xs font-medium text-sidebar-foreground/70 outline-none ring-sidebar-ring transition-[margin,opa] ease-linear focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0",
+                "group-data-[collapsible=icon]:-mt-8 group-data-[collapsible=icon]:opacity-0",
+                className
+            )}
+            {...props}
+        />
+    )
+})
+SidebarGroupLabel.displayName = "SidebarGroupLabel"
+
+const SidebarGroupContent = React.forwardRef<
+    HTMLDivElement,
+    React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+    <div
+        ref={ref}
+        data-sidebar="group-content"
+        className={cn("w-full text-sm", className)}
+        {...props}
+    />
+))
+SidebarGroupContent.displayName = "SidebarGroupContent"
+
+const SidebarMenu = React.forwardRef<
+    HTMLUListElement,
+    React.HTMLAttributes<HTMLUListElement>
+>(({ className, ...props }, ref) => (
+    <ul
+        ref={ref}
+        data-sidebar="menu"
+        className={cn("flex w-full min-w-0 flex-col gap-1", className)}
+        {...props}
+    />
+))
+SidebarMenu.displayName = "SidebarMenu"
+
+const SidebarMenuItem = React.forwardRef<
+    HTMLLIElement,
+    React.LiHTMLAttributes<HTMLLIElement>
+>(({ className, ...props }, ref) => (
+    <li
+        ref={ref}
+        data-sidebar="menu-item"
+        className={cn("group/menu-item relative", className)}
+        {...props}
+    />
+))
+SidebarMenuItem.displayName = "SidebarMenuItem"
+
+const SidebarMenuButton = React.forwardRef<
+    HTMLButtonElement,
+    React.ButtonHTMLAttributes<HTMLButtonElement> & {
+        asChild?: boolean
+        isActive?: boolean
+        tooltip?: string | React.ComponentProps<any>
+        variant?: "default" | "ghost" | "outline" | "secondary" | "destructive" | "link" | null | undefined
+        size?: "default" | "sm" | "lg" | "icon" | null | undefined
+    }
+>(
+    (
+        {
+            asChild = false,
+            isActive = false,
+            variant = "default",
+            size = "default",
+            tooltip,
+            className,
+            ...props
+        },
+        ref
+    ) => {
+        const { isMobile, state, setOpen } = useSidebar()
+
+        const buttonClass = cn(
+            "cursor-pointer peer/menu-button flex w-full items-center gap-2 overflow-hidden rounded-md 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-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0",
+            "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]:!p-2 [&>span:last-child]:group-data-[collapsible=icon]:hidden",
+            className
+        )
+
+        // If tooltip is needed, we should implement it. For now, ignoring complexity of tooltip.
+
+        const handleClick = (e: React.MouseEvent<HTMLButtonElement>) => {
+            props.onClick?.(e)
+            if (!isMobile && state === "collapsed") {
+                setOpen(true)
+            }
+        }
+
+        const Comp = asChild ? Slot : "button"
+
+        return (
+            <Comp
+                ref={ref}
+                data-sidebar="menu-button"
+                data-size={size}
+                data-active={isActive}
+                className={buttonClass}
+                onClick={handleClick}
+                {...props}
+            />
+        )
+    }
+)
+SidebarMenuButton.displayName = "SidebarMenuButton"
+
+const SidebarMenuAction = React.forwardRef<
+    HTMLButtonElement,
+    React.ButtonHTMLAttributes<HTMLButtonElement> & { asChild?: boolean; showOnHover?: boolean }
+>(({ className, asChild = false, showOnHover = false, ...props }, ref) => {
+    const Comp = asChild ? Slot : "button"
+
+    return (
+        <Comp
+            ref={ref}
+            data-sidebar="menu-action"
+            className={cn(
+                "absolute right-1 top-1.5 flex aspect-square w-5 items-center justify-center rounded-md 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]:size-4 [&>svg]:shrink-0",
+                // Increases the hit area of the button on mobile.
+                "after:absolute after:-inset-2 after:md:hidden",
+                "peer-data-[size=sm]/menu-button:top-1",
+                "peer-data-[size=default]/menu-button:top-1.5",
+                "peer-data-[size=lg]/menu-button:top-2.5",
+                "group-data-[collapsible=icon]:hidden",
+                showOnHover &&
+                "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",
+                className
+            )}
+            {...props}
+        />
+    )
+})
+SidebarMenuAction.displayName = "SidebarMenuAction"
+
+const SidebarMenuSub = React.forwardRef<
+    HTMLUListElement,
+    React.HTMLAttributes<HTMLUListElement>
+>(({ className, ...props }, ref) => (
+    <ul
+        ref={ref}
+        data-sidebar="menu-sub"
+        className={cn(
+            "mx-3.5 flex min-w-0 translate-x-px flex-col gap-1 border-l border-sidebar-border px-2.5 py-0.5",
+            "group-data-[collapsible=icon]:hidden",
+            className
+        )}
+        {...props}
+    />
+))
+SidebarMenuSub.displayName = "SidebarMenuSub"
+
+const SidebarMenuSubItem = React.forwardRef<
+    HTMLLIElement,
+    React.LiHTMLAttributes<HTMLLIElement>
+>(({ ...props }, ref) => <li ref={ref} {...props} />)
+SidebarMenuSubItem.displayName = "SidebarMenuSubItem"
+
+const SidebarMenuSubButton = React.forwardRef<
+    HTMLAnchorElement,
+    React.AnchorHTMLAttributes<HTMLAnchorElement> & {
+        asChild?: boolean
+        size?: "sm" | "md"
+        isActive?: boolean
+    }
+>(({ asChild = false, size = "md", isActive, className, ...props }, ref) => {
+    const Comp = asChild ? Slot : "a"
+
+    return (
+        <Comp
+            ref={ref}
+            data-sidebar="menu-sub-button"
+            data-size={size}
+            data-active={isActive}
+            className={cn(
+                "flex h-7 min-w-0 -translate-x-px items-center gap-2 overflow-hidden rounded-md 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-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0 group-data-[collapsible=icon]:hidden",
+                size === "sm" && "text-xs",
+                size === "md" && "text-sm",
+                "data-[active=true]:bg-sidebar-accent data-[active=true]:text-sidebar-accent-foreground",
+                className
+            )}
+            {...props}
+        />
+    )
+})
+SidebarMenuSubButton.displayName = "SidebarMenuSubButton"
+
+const SidebarInput = React.forwardRef<
+    HTMLInputElement,
+    React.InputHTMLAttributes<HTMLInputElement>
+>(({ className, ...props }, ref) => {
+    return (
+        <input
+            ref={ref}
+            data-sidebar="input"
+            className={cn(
+                "flex h-8 w-full bg-background rounded-md px-3 text-sm shadow-sm transition-colors file:border-0 file:bg-transparent file:text-sm file:font-medium placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50 group-data-[collapsible=icon]:w-0 group-data-[collapsible=icon]:p-0 group-data-[collapsible=icon]:border-0 group-data-[collapsible=icon]:hidden",
+                className
+            )}
+            {...props}
+        />
+    )
+})
+SidebarInput.displayName = "SidebarInput"
+
+
+const SidebarSeparator = React.forwardRef<
+    HTMLDivElement,
+    React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => {
+    return (
+        <div
+            ref={ref}
+            data-sidebar="separator"
+            className={cn("mx-2 w-auto bg-sidebar-border h-px", className)}
+            {...props}
+        />
+    )
+})
+SidebarSeparator.displayName = "SidebarSeparator"
+
+export {
+    Sidebar,
+    SidebarContent,
+    SidebarFooter,
+    SidebarGroup,
+    SidebarGroupContent,
+    SidebarGroupLabel,
+    SidebarHeader,
+    SidebarInput,
+    SidebarInset,
+    SidebarMenu,
+    SidebarMenuAction,
+    SidebarMenuButton,
+    SidebarMenuItem,
+    SidebarMenuSub,
+    SidebarMenuSubButton,
+    SidebarMenuSubItem,
+    SidebarProvider,
+    SidebarRail,
+    SidebarSeparator,
+    SidebarTrigger,
+    useSidebar,
+}