@repraze/kernelkit 0.0.0-stage → 0.1.0-alpha.1

package/src/components/sidebar.tsx

@@ -0,0 +1,722 @@
+"use client";
+
+import {mergeProps} from "@base-ui/react/merge-props";
+import {useRender} from "@base-ui/react/use-render";
+import {Button} from "@repraze/kernelkit/components/button";
+import {Input} from "@repraze/kernelkit/components/input";
+import {ScrollArea} from "@repraze/kernelkit/components/scroll-area";
+import {Separator} from "@repraze/kernelkit/components/separator";
+import {Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle} from "@repraze/kernelkit/components/sheet";
+import {Skeleton} from "@repraze/kernelkit/components/skeleton";
+import {Tooltip, TooltipContent, TooltipTrigger} from "@repraze/kernelkit/components/tooltip";
+import {useIsMobile} from "@repraze/kernelkit/hooks/use-mobile";
+import {focusRing} from "@repraze/kernelkit/lib/recipes";
+import {cva, type VariantProps} from "class-variance-authority";
+import {cn} from "cn";
+import {PanelLeftIcon} from "lucide-react";
+import * as React from "react";
+
+const SIDEBAR_COOKIE_NAME = "sidebar_state";
+const SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;
+const SIDEBAR_WIDTH = "16rem";
+const SIDEBAR_WIDTH_MOBILE = "18rem";
+const SIDEBAR_WIDTH_ICON = "3rem";
+const SIDEBAR_KEYBOARD_SHORTCUT = "b";
+
+type SidebarContextProps = {
+    state: "expanded" | "collapsed";
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    openMobile: boolean;
+    setOpenMobile: (open: boolean) => void;
+    isMobile: boolean;
+    toggleSidebar: () => void;
+};
+
+const SidebarContext = React.createContext<SidebarContextProps | null>(null);
+
+function useSidebar() {
+    const context = React.useContext(SidebarContext);
+    if (!context) {
+        throw new Error("useSidebar must be used within a SidebarProvider.");
+    }
+
+    return context;
+}
+
+function SidebarProvider({
+    defaultOpen = true,
+    open: openProp,
+    onOpenChange: setOpenProp,
+    keyboardShortcut = true,
+    className,
+    style,
+    children,
+    ...props
+}: React.ComponentProps<"div"> & {
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Registers the built-in Ctrl/Cmd+B toggle on `window`. Set to `false` when the host app needs to
+     * gate the shortcut (e.g. yield Ctrl+B to a rich-text editor) and re-introduce it itself.
+     */
+    keyboardShortcut?: boolean;
+}) {
+    const isMobile = useIsMobile();
+    const [openMobile, setOpenMobile] = React.useState(false);
+
+    // This is the internal state of the sidebar.
+    // We use openProp and setOpenProp for control from outside the component.
+    const [_open, _setOpen] = React.useState(defaultOpen);
+    const open = openProp ?? _open;
+    const setOpen = React.useCallback(
+        (value: boolean | ((value: boolean) => boolean)) => {
+            const openState = typeof value === "function" ? value(open) : value;
+            if (setOpenProp) {
+                setOpenProp(openState);
+            } else {
+                _setOpen(openState);
+            }
+
+            // This sets the cookie to keep the sidebar state.
+            document.cookie = `${SIDEBAR_COOKIE_NAME}=${openState}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`;
+        },
+        [setOpenProp, open],
+    );
+
+    // Helper to toggle the sidebar.
+    const toggleSidebar = React.useCallback(() => {
+        return isMobile ? setOpenMobile((open) => !open) : setOpen((open) => !open);
+    }, [isMobile, setOpen, setOpenMobile]);
+
+    // Adds a keyboard shortcut to toggle the sidebar. Opt out with `keyboardShortcut={false}`.
+    React.useEffect(() => {
+        if (!keyboardShortcut) {
+            return;
+        }
+        const handleKeyDown = (event: KeyboardEvent) => {
+            if (event.key === SIDEBAR_KEYBOARD_SHORTCUT && (event.metaKey || event.ctrlKey)) {
+                event.preventDefault();
+                toggleSidebar();
+            }
+        };
+
+        window.addEventListener("keydown", handleKeyDown);
+        return () => window.removeEventListener("keydown", handleKeyDown);
+    }, [keyboardShortcut, toggleSidebar]);
+
+    // We add a state so that we can do data-state="expanded" or "collapsed".
+    // This makes it easier to style the sidebar with Tailwind classes.
+    const state = open ? "expanded" : "collapsed";
+
+    const contextValue = React.useMemo<SidebarContextProps>(
+        () => ({
+            state,
+            open,
+            setOpen,
+            isMobile,
+            openMobile,
+            setOpenMobile,
+            toggleSidebar,
+        }),
+        [state, open, setOpen, isMobile, openMobile, setOpenMobile, toggleSidebar],
+    );
+
+    return (
+        <SidebarContext.Provider value={contextValue}>
+            <div
+                data-slot="sidebar-wrapper"
+                style={
+                    {
+                        "--sidebar-width": SIDEBAR_WIDTH,
+                        "--sidebar-width-icon": SIDEBAR_WIDTH_ICON,
+                        ...style,
+                    } as React.CSSProperties
+                }
+                className={cn(
+                    "group/sidebar-wrapper flex min-h-svh w-full has-data-[variant=inset]:bg-sidebar",
+                    className,
+                )}
+                {...props}
+            >
+                {children}
+            </div>
+        </SidebarContext.Provider>
+    );
+}
+
+function Sidebar({
+    side = "left",
+    variant = "sidebar",
+    collapsible = "offcanvas",
+    className,
+    children,
+    dir,
+    ...props
+}: React.ComponentProps<"div"> & {
+    side?: "left" | "right";
+    variant?: "sidebar" | "floating" | "inset";
+    collapsible?: "offcanvas" | "icon" | "none";
+}) {
+    const {isMobile, state, openMobile, setOpenMobile} = useSidebar();
+
+    if (collapsible === "none") {
+        return (
+            <div
+                data-slot="sidebar"
+                className={cn("flex h-full w-(--sidebar-width) flex-col bg-sidebar text-sidebar-foreground", className)}
+                {...props}
+            >
+                {children}
+            </div>
+        );
+    }
+
+    if (isMobile) {
+        return (
+            <Sheet open={openMobile} onOpenChange={setOpenMobile} {...props}>
+                <SheetContent
+                    dir={dir}
+                    data-sidebar="sidebar"
+                    data-slot="sidebar"
+                    data-mobile="true"
+                    className="w-(--sidebar-width) bg-sidebar p-0 text-sidebar-foreground [&>button]:hidden"
+                    style={
+                        {
+                            "--sidebar-width": SIDEBAR_WIDTH_MOBILE,
+                        } as React.CSSProperties
+                    }
+                    side={side}
+                >
+                    <SheetHeader className="sr-only">
+                        <SheetTitle>Sidebar</SheetTitle>
+                        <SheetDescription>Displays the mobile sidebar.</SheetDescription>
+                    </SheetHeader>
+                    <div className="flex h-full w-full flex-col">{children}</div>
+                </SheetContent>
+            </Sheet>
+        );
+    }
+
+    return (
+        <div
+            className="group peer hidden text-sidebar-foreground md:block"
+            data-state={state}
+            data-collapsible={state === "collapsed" ? collapsible : ""}
+            data-variant={variant}
+            data-side={side}
+            data-slot="sidebar"
+        >
+            {/* This is what handles the sidebar gap on desktop */}
+            <div
+                data-slot="sidebar-gap"
+                className={cn(
+                    "relative w-(--sidebar-width) bg-transparent transition-[width] duration-200 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)+(--spacing(4)))]"
+                        : "group-data-[collapsible=icon]:w-(--sidebar-width-icon)",
+                )}
+            />
+            <div
+                data-slot="sidebar-container"
+                data-side={side}
+                className={cn(
+                    "fixed inset-y-0 z-10 hidden h-svh w-(--sidebar-width) transition-[left,right,width] duration-200 ease-linear data-[side=left]:left-0 data-[side=left]:group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)] data-[side=right]:right-0 data-[side=right]:group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)] md:flex",
+                    // Adjust the padding for floating and inset variants.
+                    variant === "floating" || variant === "inset"
+                        ? "p-2 group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4))+2px)]"
+                        : "group-data-[collapsible=icon]:w-(--sidebar-width-icon) group-data-[side=left]:border-r group-data-[side=right]:border-l",
+                    className,
+                )}
+                {...props}
+            >
+                <div
+                    data-sidebar="sidebar"
+                    data-slot="sidebar-inner"
+                    className="flex size-full flex-col bg-sidebar group-data-[variant=floating]:rounded-xl group-data-[variant=floating]:border group-data-[variant=floating]:border-sidebar-border group-data-[variant=floating]:shadow-sm group-data-[variant=floating]:shadow-(color:--shadow-color)"
+                >
+                    {children}
+                </div>
+            </div>
+        </div>
+    );
+}
+
+function SidebarTrigger({className, onClick, ...props}: React.ComponentProps<typeof Button>) {
+    const {toggleSidebar} = useSidebar();
+
+    return (
+        <Button
+            data-sidebar="trigger"
+            data-slot="sidebar-trigger"
+            variant="ghost"
+            size="icon-sm"
+            className={cn(className)}
+            onClick={(event) => {
+                onClick?.(event);
+                toggleSidebar();
+            }}
+            {...props}
+        >
+            <PanelLeftIcon />
+            <span className="sr-only">Toggle Sidebar</span>
+        </Button>
+    );
+}
+
+function SidebarRail({className, ...props}: React.ComponentProps<"button">) {
+    const {toggleSidebar} = useSidebar();
+
+    return (
+        <button
+            data-sidebar="rail"
+            data-slot="sidebar-rail"
+            aria-label="Toggle Sidebar"
+            tabIndex={-1}
+            onClick={toggleSidebar}
+            title="Toggle Sidebar"
+            className={cn(
+                "absolute inset-y-0 z-20 hidden w-4 transition-[transform,background-color] ease-linear motion-reduce:transition-none group-data-[side=left]:-right-4 group-data-[side=right]:left-0 after:absolute after:inset-y-0 after:start-1/2 after:w-[2px] hover:after:bg-sidebar-border sm:flex ltr:-translate-x-1/2 rtl:-translate-x-1/2",
+                "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",
+                "group-data-[collapsible=offcanvas]:translate-x-0 group-data-[collapsible=offcanvas]:after:left-full hover:group-data-[collapsible=offcanvas]:bg-sidebar",
+                "[[data-side=left][data-collapsible=offcanvas]_&]:-right-2",
+                "[[data-side=right][data-collapsible=offcanvas]_&]:-left-2",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+function SidebarInset({className, render, ...props}: useRender.ComponentProps<"main"> & React.ComponentProps<"main">) {
+    return useRender({
+        defaultTagName: "main",
+        props: mergeProps<"main">(
+            {
+                className: cn(
+                    "relative flex w-full min-w-0 flex-1 flex-col bg-background md:peer-data-[variant=inset]:m-2 md:peer-data-[variant=inset]:ml-0 md:peer-data-[variant=inset]:rounded-xl md:peer-data-[variant=inset]:border md:peer-data-[variant=inset]:border-sidebar-border md:peer-data-[variant=inset]:shadow-sm md:peer-data-[variant=inset]:shadow-(color:--shadow-color) md:peer-data-[variant=inset]:peer-data-[state=collapsed]:ml-2",
+                    className,
+                ),
+            },
+            props,
+        ),
+        render,
+        state: {
+            slot: "sidebar-inset",
+        },
+    });
+}
+
+function SidebarInput({className, ...props}: React.ComponentProps<typeof Input>) {
+    return (
+        <Input
+            data-slot="sidebar-input"
+            data-sidebar="input"
+            className={cn("h-8 w-full bg-background shadow-none", className)}
+            {...props}
+        />
+    );
+}
+
+function SidebarHeader({className, ...props}: React.ComponentProps<"div">) {
+    return (
+        <div
+            data-slot="sidebar-header"
+            data-sidebar="header"
+            className={cn("flex flex-col gap-2 p-2", className)}
+            {...props}
+        />
+    );
+}
+
+function SidebarFooter({className, ...props}: React.ComponentProps<"div">) {
+    return (
+        <div
+            data-slot="sidebar-footer"
+            data-sidebar="footer"
+            className={cn("flex flex-col gap-2 p-2", className)}
+            {...props}
+        />
+    );
+}
+
+function SidebarSeparator({className, ...props}: React.ComponentProps<typeof Separator>) {
+    return (
+        <Separator
+            data-slot="sidebar-separator"
+            data-sidebar="separator"
+            className={cn("mx-2 w-auto bg-sidebar-border", className)}
+            {...props}
+        />
+    );
+}
+
+/** Scrolls with ScrollArea (themed thumb, edge fade) instead of native overflow. */
+function SidebarContent({
+    className,
+    children,
+    viewportRef,
+    ...props
+}: React.ComponentProps<"div"> & {viewportRef?: React.Ref<HTMLDivElement>}) {
+    return (
+        <ScrollArea
+            fade
+            viewportRef={viewportRef}
+            className="min-h-0 flex-1 group-data-[collapsible=icon]:overflow-hidden"
+            data-slot="sidebar-content"
+            data-sidebar="content"
+        >
+            <div className={cn("flex min-w-0 flex-col gap-0", className)} {...props}>
+                {children}
+            </div>
+        </ScrollArea>
+    );
+}
+
+function SidebarGroup({className, ...props}: React.ComponentProps<"div">) {
+    return (
+        <div
+            data-slot="sidebar-group"
+            data-sidebar="group"
+            className={cn("relative flex w-full min-w-0 flex-col p-2", className)}
+            {...props}
+        />
+    );
+}
+
+function SidebarGroupLabel({
+    className,
+    render,
+    ...props
+}: useRender.ComponentProps<"div"> & React.ComponentProps<"div">) {
+    return useRender({
+        defaultTagName: "div",
+        props: mergeProps<"div">(
+            {
+                className: cn(
+                    "flex h-8 shrink-0 items-center gap-2 rounded-md px-2 text-xs font-medium text-muted-foreground outline-hidden transition-[margin,opacity] duration-200 ease-linear group-data-[collapsible=icon]:-mt-8 group-data-[collapsible=icon]:opacity-0 focus-visible:ring-3 focus-visible:ring-ring/50 motion-reduce:transition-none [&>svg]:size-4 [&>svg]:shrink-0",
+                    className,
+                ),
+            },
+            props,
+        ),
+        render,
+        state: {
+            slot: "sidebar-group-label",
+            sidebar: "group-label",
+        },
+    });
+}
+
+function SidebarGroupAction({
+    className,
+    render,
+    ...props
+}: useRender.ComponentProps<"button"> & React.ComponentProps<"button">) {
+    return useRender({
+        defaultTagName: "button",
+        props: mergeProps<"button">(
+            {
+                className: cn(
+                    "absolute top-3.5 right-3 flex aspect-square w-5 items-center justify-center rounded-md p-0 text-muted-foreground outline-hidden transition-[color,background-color,box-shadow] group-data-[collapsible=icon]:hidden after:absolute after:-inset-2 hover:bg-hover hover:text-sidebar-foreground focus-visible:ring-3 focus-visible:ring-ring/50 md:after:hidden [&>svg]:size-4 [&>svg]:shrink-0",
+                    className,
+                ),
+            },
+            props,
+        ),
+        render,
+        state: {
+            slot: "sidebar-group-action",
+            sidebar: "group-action",
+        },
+    });
+}
+
+function SidebarGroupContent({className, ...props}: React.ComponentProps<"div">) {
+    return (
+        <div
+            data-slot="sidebar-group-content"
+            data-sidebar="group-content"
+            className={cn("w-full text-sm", className)}
+            {...props}
+        />
+    );
+}
+
+function SidebarMenu({className, ...props}: React.ComponentProps<"ul">) {
+    return (
+        <ul
+            data-slot="sidebar-menu"
+            data-sidebar="menu"
+            className={cn("flex w-full min-w-0 flex-col gap-1", className)}
+            {...props}
+        />
+    );
+}
+
+function SidebarMenuItem({className, ...props}: React.ComponentProps<"li">) {
+    return (
+        <li
+            data-slot="sidebar-menu-item"
+            data-sidebar="menu-item"
+            className={cn("group/menu-item relative", className)}
+            {...props}
+        />
+    );
+}
+
+/**
+ * Sidebar row. Hover is the `bg-hover` wash; the current item (`isActive`) gets the accent tint, medium
+ * weight and a primary icon, so it reads without relying on surface shade (GUIDELINES §6).
+ */
+const sidebarMenuButtonVariants = cva(
+    [
+        "peer/menu-button group/menu-button flex w-full items-center gap-2 overflow-hidden rounded-md whitespace-nowrap p-2 text-left text-sm text-sidebar-foreground outline-hidden",
+        "transition-[width,height,padding,color,background-color,box-shadow] duration-100 motion-reduce:transition-none",
+        "group-has-data-[sidebar=menu-action]/menu-item:pr-8 group-data-[collapsible=icon]:size-8! group-data-[collapsible=icon]:p-2!",
+        focusRing,
+        "hover:bg-hover data-popup-open:bg-hover",
+        "disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50",
+        // current row (GUIDELINES §7c): accent tint, foreground text, 2px accent indicator on the left edge
+        "relative after:pointer-events-none after:absolute after:top-1.5 after:bottom-1.5 after:left-0 after:w-0.5 after:rounded-pill after:bg-primary-text after:opacity-0 data-active:after:opacity-100",
+        "data-active:bg-primary-tint data-active:font-medium data-active:text-foreground data-active:[&_svg:not([class*='text-'])]:text-primary-text",
+        "[&_svg]:size-4 [&_svg]:shrink-0 [&_svg:not([class*='text-'])]:text-muted-foreground [&>span:last-child]:truncate",
+    ],
+    {
+        variants: {
+            variant: {
+                default: "",
+                outline: "bg-background shadow-[0_0_0_1px_var(--sidebar-border)] hover:bg-hover",
+            },
+            size: {
+                default: "h-8 text-sm",
+                sm: "h-7 text-xs",
+                lg: "h-12 text-sm group-data-[collapsible=icon]:p-0!",
+            },
+        },
+        defaultVariants: {
+            variant: "default",
+            size: "default",
+        },
+    },
+);
+
+function SidebarMenuButton({
+    render,
+    isActive = false,
+    variant = "default",
+    size = "default",
+    tooltip,
+    className,
+    ...props
+}: useRender.ComponentProps<"button"> &
+    React.ComponentProps<"button"> & {
+        isActive?: boolean;
+        tooltip?: string | React.ComponentProps<typeof TooltipContent>;
+    } & VariantProps<typeof sidebarMenuButtonVariants>) {
+    // Works without a SidebarProvider too (an in-page nav styled like the sidebar): expanded, desktop.
+    const {isMobile, state} = React.useContext(SidebarContext) ?? {isMobile: false, state: "expanded"};
+    const comp = useRender({
+        defaultTagName: "button",
+        props: mergeProps<"button">(
+            {
+                className: cn(sidebarMenuButtonVariants({variant, size}), className),
+            },
+            props,
+        ),
+        render: !tooltip ? render : <TooltipTrigger render={render} />,
+        state: {
+            slot: "sidebar-menu-button",
+            sidebar: "menu-button",
+            size,
+            active: isActive,
+        },
+    });
+
+    if (!tooltip) {
+        return comp;
+    }
+
+    if (typeof tooltip === "string") {
+        tooltip = {
+            children: tooltip,
+        };
+    }
+
+    return (
+        <Tooltip>
+            {comp}
+            <TooltipContent side="right" align="center" hidden={state !== "collapsed" || isMobile} {...tooltip} />
+        </Tooltip>
+    );
+}
+
+function SidebarMenuAction({
+    className,
+    render,
+    showOnHover = false,
+    ...props
+}: useRender.ComponentProps<"button"> &
+    React.ComponentProps<"button"> & {
+        showOnHover?: boolean;
+    }) {
+    return useRender({
+        defaultTagName: "button",
+        props: mergeProps<"button">(
+            {
+                className: cn(
+                    "absolute top-1.5 right-1 flex aspect-square w-5 items-center justify-center rounded-md p-0 text-muted-foreground outline-hidden transition-[color,background-color,box-shadow,opacity] group-data-[collapsible=icon]:hidden peer-hover/menu-button:text-sidebar-foreground peer-data-[size=default]/menu-button:top-1.5 peer-data-[size=lg]/menu-button:top-2.5 peer-data-[size=sm]/menu-button:top-1 after:absolute after:-inset-2 hover:bg-hover hover:text-sidebar-foreground focus-visible:ring-3 focus-visible:ring-ring/50 aria-expanded:bg-hover md:after:hidden [&>svg]:size-4 [&>svg]:shrink-0",
+                    showOnHover &&
+                        "group-focus-within/menu-item:opacity-100 group-hover/menu-item:opacity-100 peer-data-active/menu-button:text-sidebar-accent-foreground aria-expanded:opacity-100 md:opacity-0",
+                    className,
+                ),
+            },
+            props,
+        ),
+        render,
+        state: {
+            slot: "sidebar-menu-action",
+            sidebar: "menu-action",
+        },
+    });
+}
+
+function SidebarMenuBadge({className, ...props}: React.ComponentProps<"div">) {
+    return (
+        <div
+            data-slot="sidebar-menu-badge"
+            data-sidebar="menu-badge"
+            className={cn(
+                "pointer-events-none absolute right-1 flex h-5 min-w-5 items-center justify-center rounded-sm px-1 font-mono text-xs font-medium text-muted-foreground tabular-nums select-none group-data-[collapsible=icon]:hidden peer-hover/menu-button:text-sidebar-accent-foreground peer-data-[size=default]/menu-button:top-1.5 peer-data-[size=lg]/menu-button:top-2.5 peer-data-[size=sm]/menu-button:top-1 peer-data-active/menu-button:text-sidebar-accent-foreground",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+function SidebarMenuSkeleton({
+    className,
+    showIcon = false,
+    ...props
+}: React.ComponentProps<"div"> & {
+    showIcon?: boolean;
+}) {
+    // Random width between 50 to 90%.
+    const [width] = React.useState(() => {
+        return `${Math.floor(Math.random() * 40) + 50}%`;
+    });
+
+    return (
+        <div
+            data-slot="sidebar-menu-skeleton"
+            data-sidebar="menu-skeleton"
+            className={cn("flex h-8 items-center gap-2 rounded-md px-2", className)}
+            {...props}
+        >
+            {showIcon && <Skeleton className="size-4 rounded-md" data-sidebar="menu-skeleton-icon" />}
+            <Skeleton
+                className="h-4 max-w-(--skeleton-width) flex-1"
+                data-sidebar="menu-skeleton-text"
+                style={
+                    {
+                        "--skeleton-width": width,
+                    } as React.CSSProperties
+                }
+            />
+        </div>
+    );
+}
+
+function SidebarMenuSub({className, ...props}: React.ComponentProps<"ul">) {
+    return (
+        <ul
+            data-slot="sidebar-menu-sub"
+            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}
+        />
+    );
+}
+
+function SidebarMenuSubItem({className, ...props}: React.ComponentProps<"li">) {
+    return (
+        <li
+            data-slot="sidebar-menu-sub-item"
+            data-sidebar="menu-sub-item"
+            className={cn(
+                "group/menu-sub-item relative",
+                // current sub-row: the 2px accent indicator sits on the tree line (like Toc)
+                "after:pointer-events-none after:absolute after:inset-y-0 after:-left-[calc(0.625rem+1.5px)] after:w-0.5 after:bg-primary-text after:opacity-0 has-[>[data-active]]:after:opacity-100",
+                className,
+            )}
+            {...props}
+        />
+    );
+}
+
+function SidebarMenuSubButton({
+    render,
+    size = "md",
+    isActive = false,
+    className,
+    ...props
+}: useRender.ComponentProps<"a"> &
+    React.ComponentProps<"a"> & {
+        size?: "sm" | "md";
+        isActive?: boolean;
+    }) {
+    return useRender({
+        defaultTagName: "a",
+        props: mergeProps<"a">(
+            {
+                className: cn(
+                    "flex h-7 min-w-0 -translate-x-px items-center gap-2 overflow-hidden rounded-md px-2 whitespace-nowrap text-muted-foreground outline-hidden transition-[color,background-color,box-shadow] duration-100 group-data-[collapsible=icon]:hidden hover:bg-hover hover:text-sidebar-foreground focus-visible:ring-3 focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 data-[size=md]:text-sm data-[size=sm]:text-xs data-active:bg-primary-tint data-active:font-medium data-active:text-foreground motion-reduce:transition-none [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0 [&>svg]:text-muted-foreground data-active:[&>svg]:text-primary-text",
+                    className,
+                ),
+            },
+            props,
+        ),
+        render,
+        state: {
+            slot: "sidebar-menu-sub-button",
+            sidebar: "menu-sub-button",
+            size,
+            active: isActive,
+        },
+    });
+}
+
+export {
+    Sidebar,
+    SidebarContent,
+    SidebarFooter,
+    SidebarGroup,
+    SidebarGroupAction,
+    SidebarGroupContent,
+    SidebarGroupLabel,
+    SidebarHeader,
+    SidebarInput,
+    SidebarInset,
+    SidebarMenu,
+    SidebarMenuAction,
+    SidebarMenuBadge,
+    SidebarMenuButton,
+    SidebarMenuItem,
+    SidebarMenuSkeleton,
+    SidebarMenuSub,
+    SidebarMenuSubButton,
+    SidebarMenuSubItem,
+    SidebarProvider,
+    SidebarRail,
+    SidebarSeparator,
+    SidebarTrigger,
+    useSidebar,
+};