"use client"
/**
* Library **Folders** tree — shared outline primitives (`OutlineTree*`) so the rail
* matches `HubTreePanelView` and shadcn sidebar file-tree rhythm.
*
* Indent model: flat `OutlineTreeSub` lists (full width) + `--outline-tree-depth-step`
* (12px) on each row. Avoids compounding 24px sub-margins that crush deep labels.
*/
import * as React from "react"
import { Link } from "react-router"
import { Collapsible, CollapsibleTrigger } from "@/components/ui/collapsible"
import { Button } from "@/components/ui/button"
import { SidebarNavLabel } from "@/components/ui/sidebar-nav-label"
import {
DropdownMenu,
DropdownMenuContent,
DropdownMenuItem,
DropdownMenuSeparator,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
import { Tip } from "@/components/ui/tip"
import { cn } from "@/lib/utils"
import {
OutlineTreeCollapsibleContentRail,
OutlineTreeMenuItem,
OutlineTreeSub,
outlineTreeBranchDepthStyle,
} from "@/components/data-views/outline-tree-menu"
import type { LibraryFolder } from "@/lib/mock/library-folders"
import { LIBRARY_FOLDER_ICON_COLORS } from "@/lib/mock/library-folders"
import {
isLibraryNavActive,
libraryHubScopeHref,
type LibraryNavState,
} from "@/lib/library-nav"
/** Root rows align with All/My (`px-2` on the link only); nested rows add depth step. */
function libraryFolderRowIndentStyle(depth: number): React.CSSProperties | undefined {
if (depth <= 0) return undefined
return {
"--outline-tree-depth": depth,
paddingInlineStart: `calc(${depth} * var(--outline-tree-depth-step))`,
} as React.CSSProperties
}
export interface LibraryFolderPickFolderProps {
selectedFolderId: string
onSelect: (folderId: string) => void
/** When set, branches with no name/descendant match are hidden. */
searchQuery?: string
}
function libraryFolderMatchesSearch(
folder: LibraryFolder,
folders: LibraryFolder[],
query: string,
): boolean {
const needle = query.trim().toLowerCase()
if (!needle) return true
if (folder.name.toLowerCase().includes(needle)) return true
return folders.some(
f => f.parentId === folder.id && libraryFolderMatchesSearch(f, folders, query),
)
}
export interface LibraryFolderTreeBranchProps {
folder: LibraryFolder
folders: LibraryFolder[]
pathname: string
hubSearchParams: URLSearchParams
nav: LibraryNavState
canManageFolders: boolean
canManageAccess: boolean
onAddSubfolder: (parentId: string) => void
onCustomizeFolder: (folder: LibraryFolder) => void
onManageAccess: () => void
onDeleteFolder: (folder: LibraryFolder) => void
/** Nesting depth (0 = root folder under FOLDERS). */
depth?: number
/** Selection mode for folder pickers (e.g. new-question inspector). */
pickFolder?: LibraryFolderPickFolderProps
}
function FolderRowActionsMenu({
folder,
folderActive,
canManageAccess,
onAddSubfolder,
onCustomizeFolder,
onManageAccess,
onDeleteFolder,
overlay = false,
className,
}: {
folder: LibraryFolder
folderActive: boolean
canManageAccess: boolean
onAddSubfolder: (parentId: string) => void
onCustomizeFolder: (folder: LibraryFolder) => void
onManageAccess: () => void
onDeleteFolder: (folder: LibraryFolder) => void
overlay?: boolean
className?: string
}) {
return (
event.stopPropagation()}
>
{
window.setTimeout(() => onAddSubfolder(folder.id), 0)
}}
>
Add folder
{
window.setTimeout(() => onCustomizeFolder(folder), 0)
}}
>
Customize
{
window.setTimeout(() => onManageAccess(), 0)
}}
>
Manage access
{
window.setTimeout(() => onDeleteFolder(folder), 0)
}}
>
Delete
)
}
type FolderActionHandlers = Pick<
LibraryFolderTreeBranchProps,
"onAddSubfolder" | "onCustomizeFolder" | "onManageAccess" | "onDeleteFolder"
>
function sortedChildFolders(folders: LibraryFolder[], parentId: string): LibraryFolder[] {
return folders
.filter(f => f.parentId === parentId)
.sort((a, b) => a.name.localeCompare(b.name))
}
function isBranchHiddenBySearch(
folder: LibraryFolder,
folders: LibraryFolder[],
pickFolder: LibraryFolderPickFolderProps | undefined,
): boolean {
const query = pickFolder?.searchQuery
if (!query?.trim()) return false
return !libraryFolderMatchesSearch(folder, folders, query)
}
function folderRowClass(active: boolean): string {
return cn(
"group/row relative flex min-h-8 min-w-0 w-full items-start rounded-md transition-colors",
active
? "bg-sidebar-accent font-medium text-sidebar-accent-foreground ring-1 ring-inset ring-sidebar-border/80"
: "text-sidebar-foreground hover:bg-sidebar-accent/50",
)
}
function folderLabelClass(trailingPad: boolean, depth: number, active: boolean): string {
return cn(
"flex h-auto min-h-8 min-w-0 flex-1 items-start gap-1.5 py-1 text-left text-sm transition-colors",
trailingPad ? "pe-7" : "pe-0.5",
depth === 0 && "ps-2",
"rounded-sm focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-inset",
!active && "text-sidebar-foreground",
)
}
function FolderRowIcon({ folder }: { folder: LibraryFolder }) {
return (
)
}
function FolderExpandToggle({ folder, show }: { folder: LibraryFolder; show: boolean }) {
if (!show) return
return (
)
}
function FolderPickLabel(props: {
folder: LibraryFolder
pickFolder: LibraryFolderPickFolderProps
active: boolean
hasSubfolders: boolean
depth: number
}) {
const { folder, pickFolder, active } = props
return (
pickFolder.onSelect(folder.id)}
className={folderLabelClass(props.hasSubfolders, props.depth, active)}
>
{folder.name}
{active ? (
) : null}
)
}
function FolderLinkLabel(props: {
folder: LibraryFolder
href: string
active: boolean
trailingPad: boolean
depth: number
}) {
const { folder, active } = props
return (
{folder.name}
)
}
function FolderRowLabel(props: {
folder: LibraryFolder
pickFolder?: LibraryFolderPickFolderProps
href: string
active: boolean
hasSubfolders: boolean
canManageFolders: boolean
depth: number
}) {
const { folder, pickFolder } = props
return (
{pickFolder ? (
) : (
)}
)
}
function FolderRowTrailing(props: {
folder: LibraryFolder
folderActive: boolean
childCount: number
canManageFolders: boolean
canManageAccess: boolean
handlers: FolderActionHandlers
}) {
const { folder, folderActive, canManageFolders } = props
const hasSubfolders = props.childCount > 0
if (!hasSubfolders) {
if (!canManageFolders) return null
return (
)
}
return (
{props.childCount}
{canManageFolders ? (
) : null}
)
}
function LibraryFolderTreeBranchInner(props: LibraryFolderTreeBranchProps) {
const {
folder,
folders,
pathname,
hubSearchParams,
nav,
canManageFolders,
canManageAccess,
onAddSubfolder,
onCustomizeFolder,
onManageAccess,
onDeleteFolder,
depth = 0,
pickFolder,
} = props
const childFolders = React.useMemo(
() => sortedChildFolders(folders, folder.id),
[folders, folder.id],
)
if (isBranchHiddenBySearch(folder, folders, pickFolder)) return null
const hasSubfolders = childFolders.length > 0
const handlers: FolderActionHandlers = {
onAddSubfolder,
onCustomizeFolder,
onManageAccess,
onDeleteFolder,
}
const folderHref = libraryHubScopeHref(pathname, hubSearchParams, {
scope: "folder",
folderId: folder.id,
})
const folderActive = pickFolder
? pickFolder.selectedFolderId === folder.id
: isLibraryNavActive(pathname, nav, "folder", folder.id, folders)
return (
{hasSubfolders ? (
{childFolders.map(child => (
))}
) : null}
)
}
/**
* Memoized for the secondary panel: the tree re-renders on every navigation,
* hash change, or searchParams flip in `LibrarySecondaryNav`. Without memo,
* each level recurses through `Collapsible` + `Tip` + `DropdownMenu` per
* branch (an inactive subtree of ~10–20 folders is ~30+ Radix instances) and
* pegs frame budget on otherwise unrelated route changes.
*
* Memoization is safe with reference equality because the parent passes
* stable refs:
* - `folder`, `folders` — from `libraryFolderBridge?.folders ?? DEFAULT…`
* (state, not recomputed each render).
* - `pathname` — string from `useLocation()`.
* - `hubSearchParams` — react-router v7 `useSearchParams` memoizes
* via `useMemo` on `location.search` (see chunk-66UKHEGQ.js#L716).
* - `nav` — `useMemo` over `searchParams.toString()` in `LibrarySecondaryNav`.
* - `canManageFolders` / `canManageAccess` — booleans.
* - All four callbacks — wrapped in `useCallback` in `LibrarySecondaryNav`.
*
* Recursive children render `` (the exported
* memoized const), so memoization composes down the tree.
*/
export const LibraryFolderTreeBranch = React.memo(LibraryFolderTreeBranchInner)