{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "sidebar-03",
  "title": "工作区树侧栏",
  "description": "图标轨与工作区树双栏侧栏，支持树键盘导航、模块切换、筛选和移动端抽屉。",
  "dependencies": [
    "lucide-react"
  ],
  "registryDependencies": [
    "sidebar",
    "button",
    "tooltip",
    "dropdown-menu",
    "breadcrumb",
    "separator",
    "https://yiui.dev/r/grid-layout.json"
  ],
  "files": [
    {
      "path": "src/registry/blocks/sidebar-03/nav-data.ts",
      "content": "import {\n  InboxIcon,\n  UsersIcon,\n  MessageSquareIcon,\n  FolderIcon,\n  WorkflowIcon,\n  LayoutListIcon,\n} from \"lucide-react\"\nimport type { Sidebar03Module, Sidebar03Usage } from \"./types\"\nconst DEFAULT_MODULES: Sidebar03Module[] = [\n  {\n    id: \"customers\",\n    label: \"客户\",\n    icon: UsersIcon,\n    tree: [\n      {\n        id: \"workspace\",\n        label: \"客户工作区\",\n        status: \"active\",\n        children: [\n          {\n            id: \"views\",\n            label: \"客户视图\",\n            icon: FolderIcon,\n            children: [\n              {\n                id: \"all\",\n                label: \"全部客户\",\n                href: \"/customers/all\",\n                icon: LayoutListIcon,\n                badge: 128,\n              },\n              {\n                id: \"follow\",\n                label: \"待跟进\",\n                href: \"/customers/follow\",\n                badge: 12,\n              },\n              {\n                id: \"deals\",\n                label: \"合作洽谈\",\n                href: \"/customers/deals\",\n                badge: 8,\n              },\n            ],\n          },\n          {\n            id: \"contacts\",\n            label: \"联系人\",\n            href: \"/customers/contacts\",\n            badge: 64,\n          },\n        ],\n      },\n      {\n        id: \"growth\",\n        label: \"增长项目\",\n        status: \"paused\",\n        children: [\n          { id: \"research\", label: \"客户调研\", href: \"/growth/research\" },\n        ],\n      },\n      {\n        id: \"archive\",\n        label: \"往期合作\",\n        status: \"archived\",\n        children: [{ id: \"past\", label: \"历史记录\", href: \"/archive/past\" }],\n      },\n    ],\n  },\n  ...[\n    {\n      id: \"inbox\",\n      label: \"收件箱\",\n      icon: InboxIcon,\n      names: [\"待处理\", \"已完成\"],\n    },\n    {\n      id: \"messages\",\n      label: \"消息\",\n      icon: MessageSquareIcon,\n      names: [\"团队讨论\", \"项目通知\"],\n    },\n    {\n      id: \"files\",\n      label: \"文件\",\n      icon: FolderIcon,\n      names: [\"设计文档\", \"项目资料\"],\n    },\n    {\n      id: \"automation\",\n      label: \"自动化\",\n      icon: WorkflowIcon,\n      names: [\"客户分配\", \"每周汇总\"],\n    },\n  ].map(({ id, label, icon, names }): Sidebar03Module => ({\n    id,\n    label,\n    icon,\n    tree: [\n      {\n        id: `${id}-project`,\n        label: `${label}工作区`,\n        status: \"active\",\n        children: names.map((name, i) => ({\n          id: `${id}-${i}`,\n          label: name,\n          href: `/${id}/${i}`,\n          badge: i + 2,\n        })),\n      },\n    ],\n  })),\n]\nconst DEFAULT_USAGE: Sidebar03Usage = {\n  label: \"存储空间\",\n  used: 9.2,\n  total: 10,\n  unit: \"GB\",\n  href: \"/upgrade\",\n}\nexport { DEFAULT_MODULES, DEFAULT_USAGE }\n",
      "type": "registry:component",
      "target": "@components/sidebar-03/nav-data.ts"
    },
    {
      "path": "src/registry/blocks/sidebar-03/page.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\n\nimport { useState } from \"react\"\n\nimport {\n  Breadcrumb,\n  BreadcrumbItem,\n  BreadcrumbList,\n  BreadcrumbPage,\n  BreadcrumbSeparator,\n} from \"@/components/ui/breadcrumb\"\nimport { Separator } from \"@/components/ui/separator\"\nimport {\n  SidebarInset,\n  SidebarProvider,\n  SidebarTrigger,\n} from \"@/components/ui/sidebar\"\nimport { Sidebar03 } from \"@/components/sidebar-03/sidebar-03\"\nimport { DEFAULT_MODULES } from \"@/components/sidebar-03/nav-data\"\nimport { findPath } from \"@/components/sidebar-03/tree\"\nimport {\n  GridContainer,\n  GridSection,\n  GridSeparator,\n} from \"@/components/ui/grid-layout/grid-layout\"\n\n/** 主区的占位内容：真实项目里换成各页面自己的内容。 */\nconst SUMMARY = [\n  { label: \"本周活跃成员\", value: \"128\" },\n  { label: \"已完成任务\", value: \"342\" },\n  { label: \"待处理评论\", value: \"17\" },\n]\nconst RECENT = [\n  \"苏晓宁 更新了「官网改版」的设计稿\",\n  \"周明远 在「增长实验」里新增了 2 个对照组\",\n  \"陈知夏 完成了 5 个任务\",\n  \"韩若溪 邀请了新成员加入团队\",\n]\nexport default function Sidebar03Page() {\n  const [activeItemId, setActiveItemId] = useState(\"all\")\n  const [moduleId, setModuleId] = useState(\"customers\")\n  const currentModule = DEFAULT_MODULES.find((item) => item.id === moduleId)\n  const path = findPath(currentModule?.tree ?? [], activeItemId)\n  const current = path.at(-1)\n  const team = { name: \"客户协作空间\" }\n  return (\n    <SidebarProvider defaultOpen>\n      <Sidebar03\n        moduleId={moduleId}\n        onModuleChange={setModuleId}\n        activeNodeId={activeItemId}\n        navigation={{\n          intercept: true,\n          onNavigate: ({ nodeId }) => {\n            if (nodeId) setActiveItemId(nodeId)\n          },\n        }}\n      />\n      <SidebarInset>\n        <header className=\"sticky top-0 z-10 flex h-14 shrink-0 items-center gap-2 border-b border-edge bg-background px-4\">\n          <SidebarTrigger className=\"-ml-1\" aria-label=\"切换侧栏\" />\n          <Separator\n            orientation=\"vertical\"\n            className=\"mr-1 data-vertical:h-4 data-vertical:self-center\"\n          />\n          <Breadcrumb>\n            <BreadcrumbList>\n              <BreadcrumbItem className=\"hidden sm:inline-flex\">\n                {currentModule?.label}\n              </BreadcrumbItem>\n              {path.map((node, index) => {\n                const last = index === path.length - 1\n                // 窄屏只留最后一级，避免面包屑挤满顶栏\n                const hide = last ? undefined : \"hidden sm:inline-flex\"\n                return (\n                  <React.Fragment key={node.id}>\n                    <BreadcrumbSeparator className=\"hidden sm:block\" />\n                    <BreadcrumbItem className={hide}>\n                      {last ? (\n                        <BreadcrumbPage>{node.label}</BreadcrumbPage>\n                      ) : (\n                        node.label\n                      )}\n                    </BreadcrumbItem>\n                  </React.Fragment>\n                )\n              })}\n            </BreadcrumbList>\n          </Breadcrumb>\n        </header>\n        <GridContainer className=\"min-h-[calc(100svh-3.5rem)] [--grid-width:60rem]\">\n          <GridSection className=\"px-4 py-6 sm:px-6\">\n            <h1 className=\"text-xl font-semibold tracking-tight\">\n              {current?.label ?? currentModule?.label}\n            </h1>\n            <p className=\"mt-1 text-sm leading-7 text-muted-foreground\">\n              这是{team?.name}的工作区，下面是一些占位内容。\n            </p>\n          </GridSection>\n          <GridSection>\n            <dl className=\"grid divide-y divide-dashed divide-edge sm:grid-cols-3 sm:divide-x sm:divide-y-0\">\n              {SUMMARY.map((stat) => (\n                <div key={stat.label} className=\"px-4 py-5 sm:px-6\">\n                  <dt className=\"text-xs text-muted-foreground\">\n                    {stat.label}\n                  </dt>\n                  <dd className=\"mt-1 font-mono text-2xl tabular-nums\">\n                    {stat.value}\n                  </dd>\n                </div>\n              ))}\n            </dl>\n          </GridSection>\n          <GridSeparator />\n          <GridSection>\n            <ul className=\"divide-y divide-dashed divide-edge\">\n              {RECENT.map((entry) => (\n                <li key={entry} className=\"px-4 py-3 text-sm leading-7 sm:px-6\">\n                  {entry}\n                </li>\n              ))}\n            </ul>\n          </GridSection>\n        </GridContainer>\n      </SidebarInset>\n    </SidebarProvider>\n  )\n}\n",
      "type": "registry:page",
      "target": "app/sidebar-03/page.tsx"
    },
    {
      "path": "src/registry/blocks/sidebar-03/types.ts",
      "content": "import type * as React from \"react\"\nimport type { LucideIcon } from \"lucide-react\"\n\ntype Sidebar03TreeNode = {\n  id: string\n  label: string\n  href?: string\n  icon?: LucideIcon\n  status?: \"active\" | \"paused\" | \"archived\"\n  badge?: string | number\n  children?: Sidebar03TreeNode[]\n}\ntype Sidebar03Module = {\n  id: string\n  label: string\n  icon: LucideIcon\n  tree: Sidebar03TreeNode[]\n  actions?: { id: string; label: string; onSelect: () => void }[]\n}\ntype Sidebar03Usage = {\n  label: string\n  used: number\n  total: number\n  unit: string\n  href?: string\n}\ntype Sidebar03Navigation = {\n  intercept?: boolean\n  onNavigate?: (payload: { href: string; nodeId?: string }) => void\n}\ntype Sidebar03Link = React.ElementType\nexport type {\n  Sidebar03TreeNode,\n  Sidebar03Module,\n  Sidebar03Usage,\n  Sidebar03Navigation,\n  Sidebar03Link,\n}\n",
      "type": "registry:component",
      "target": "@components/sidebar-03/types.ts"
    },
    {
      "path": "src/registry/blocks/sidebar-03/config.ts",
      "content": "const DEFAULT_LABELS = {\n  brand: \"协作空间\",\n  search: \"筛选当前工作区…\",\n  empty: \"没有匹配的节点，请尝试其他关键词。\",\n  create: \"新建\",\n  more: \"更多\",\n  help: \"帮助\",\n  settings: \"设置\",\n  signOut: \"退出\",\n  upgrade: \"升级\",\n  used: \"已用\",\n  active: \"进行中\",\n  paused: \"已暂停\",\n  archived: \"已归档\",\n  modules: \"切换模块\",\n  tree: \"工作区树\",\n}\ntype Sidebar03Labels = typeof DEFAULT_LABELS\nexport { DEFAULT_LABELS }\nexport type { Sidebar03Labels }\n",
      "type": "registry:component",
      "target": "@components/sidebar-03/config.ts"
    },
    {
      "path": "src/registry/blocks/sidebar-03/sidebar-03.tsx",
      "content": "\"use client\"\nimport * as React from \"react\"\nimport {\n  LayersIcon,\n  PlusIcon,\n  EllipsisIcon,\n  CircleHelpIcon,\n  SettingsIcon,\n  LogOutIcon,\n} from \"lucide-react\"\nimport { cn } from \"@/lib/utils\"\nimport { Button } from \"@/components/ui/button\"\nimport {\n  Sidebar,\n  SidebarContent,\n  SidebarInput,\n  useSidebar,\n} from \"@/components/ui/sidebar\"\nimport {\n  Tooltip,\n  TooltipContent,\n  TooltipProvider,\n  TooltipTrigger,\n} from \"@/components/ui/tooltip\"\nimport {\n  DropdownMenu,\n  DropdownMenuTrigger,\n  DropdownMenuContent,\n  DropdownMenuItem,\n} from \"@/components/ui/dropdown-menu\"\nimport { useControllableState } from \"@/hooks/use-controllable-state\"\nimport { DEFAULT_LABELS, type Sidebar03Labels } from \"./config\"\nimport { DEFAULT_MODULES, DEFAULT_USAGE } from \"./nav-data\"\nimport { Sidebar03Tree, findPath } from \"./tree\"\nimport type {\n  Sidebar03Module,\n  Sidebar03TreeNode,\n  Sidebar03Usage,\n  Sidebar03Navigation,\n  Sidebar03Link,\n} from \"./types\"\n\ntype Sidebar03Props = Omit<\n  React.ComponentProps<typeof Sidebar>,\n  \"children\" | \"collapsible\"\n> & {\n  /** 模块与树数据；默认中文示例。 */\n  modules?: Sidebar03Module[]\n  /** 受控模块 id。 */\n  moduleId?: string\n  /** 初始模块；默认第一个。 */\n  defaultModuleId?: string\n  onModuleChange?: (id: string) => void\n  /** 当前页面节点。 */\n  activeNodeId?: string\n  /** 初始展开节点；默认包含当前节点的祖先。 */\n  defaultExpandedIds?: string[]\n  /** 受控展开节点，跨模块 id 必须唯一。 */\n  expandedIds?: string[]\n  onExpandedChange?: (ids: string[]) => void\n  /** 底部用量；默认 9.2 GB / 10 GB。 */\n  usage?: Sidebar03Usage\n  /** 链接组件；默认 a。 */\n  linkComponent?: Sidebar03Link\n  navigation?: Sidebar03Navigation\n  labels?: Partial<Sidebar03Labels>\n  onCreate?: (payload: { moduleId: string }) => void\n  onUtilityAction?: (payload: {\n    action: \"help\" | \"settings\" | \"signOut\"\n  }) => void\n}\nfunction Sidebar03({\n  modules = DEFAULT_MODULES,\n  moduleId,\n  defaultModuleId,\n  onModuleChange,\n  activeNodeId,\n  expandedIds,\n  defaultExpandedIds = [],\n  onExpandedChange,\n  usage = DEFAULT_USAGE,\n  linkComponent: Link = \"a\",\n  navigation,\n  labels: labelsProp,\n  onCreate,\n  onUtilityAction,\n  className,\n  style,\n  ...props\n}: Sidebar03Props) {\n  const labels = { ...DEFAULT_LABELS, ...labelsProp }\n  const { isMobile, state, setOpen, setOpenMobile } = useSidebar()\n  const [currentId, setCurrentId] = useControllableState({\n    prop: moduleId,\n    defaultProp: defaultModuleId ?? modules[0]?.id ?? \"\",\n    onChange: onModuleChange,\n  })\n  const current =\n    modules.find((module) => module.id === currentId) ?? modules[0]\n  const [expanded, setExpanded] = useControllableState({\n    prop: expandedIds,\n    defaultProp: [\n      ...new Set([\n        ...defaultExpandedIds,\n        ...modules.flatMap((module) =>\n          findPath(module.tree, activeNodeId)\n            .slice(0, -1)\n            .map((node) => node.id),\n        ),\n      ]),\n    ],\n    onChange: onExpandedChange,\n  })\n  const [query, setQuery] = React.useState(\"\")\n  function navigate(\n    event: React.MouseEvent<HTMLAnchorElement>,\n    href: string,\n    nodeId?: string,\n  ) {\n    if (\n      event.button !== 0 ||\n      event.metaKey ||\n      event.ctrlKey ||\n      event.shiftKey ||\n      event.altKey\n    )\n      return\n    if (navigation?.intercept) event.preventDefault()\n    navigation?.onNavigate?.({ href, nodeId })\n    if (isMobile) setOpenMobile(false)\n  }\n  function renderLink(node: Sidebar03TreeNode, content: React.ReactNode) {\n    return (\n      <Link\n        href={node.href}\n        tabIndex={-1}\n        aria-current={node.id === activeNodeId ? \"page\" : undefined}\n        onClick={(event: React.MouseEvent<HTMLAnchorElement>) =>\n          navigate(event, node.href!, node.id)\n        }\n        {...(navigation?.intercept && Link !== \"a\" ? { prefetch: false } : {})}\n        className=\"flex min-w-0 flex-1 items-center gap-2 pr-2\"\n      >\n        {content}\n      </Link>\n    )\n  }\n  const percent =\n    usage.total > 0\n      ? Math.max(0, Math.min(100, (usage.used / usage.total) * 100))\n      : 0\n  return (\n    <div\n      data-slot=\"sidebar-03-shell\"\n      className=\"contents\"\n      style={\n        {\n          \"--sidebar-width\": \"19rem\",\n          \"--sidebar-width-icon\": \"3rem\",\n        } as React.CSSProperties\n      }\n    >\n      <Sidebar\n        data-slot=\"sidebar-03\"\n        collapsible=\"icon\"\n        className={cn(\"overflow-hidden\", className)}\n        style={\n          {\n            \"--sidebar-width\": \"19rem\",\n            \"--sidebar-width-icon\": \"3rem\",\n            ...style,\n          } as React.CSSProperties\n        }\n        {...props}\n      >\n        <TooltipProvider>\n          <div className=\"flex h-full min-h-0\">\n            <Sidebar\n              collapsible=\"none\"\n              className=\"w-12 shrink-0 border-r border-sidebar-border\"\n            >\n              <div\n                data-slot=\"sidebar-03-brand\"\n                className=\"flex h-14 shrink-0 items-center justify-center border-b border-sidebar-border\"\n              >\n                <Button\n                  variant=\"ghost\"\n                  size=\"icon-sm\"\n                  aria-label={labels.brand}\n                  onClick={() => setOpen(true)}\n                >\n                  <LayersIcon aria-hidden />\n                </Button>\n              </div>\n              <nav\n                aria-label={labels.modules}\n                className=\"flex flex-1 flex-col items-center gap-2 py-3\"\n              >\n                {modules.map((module) => (\n                  <Tooltip key={module.id}>\n                    <TooltipTrigger\n                      render={\n                        <Button\n                          variant=\"ghost\"\n                          size=\"icon\"\n                          aria-label={module.label}\n                          aria-pressed={module.id === current?.id}\n                          className=\"aria-pressed:bg-sidebar-accent aria-pressed:text-sidebar-accent-foreground\"\n                          onClick={() => {\n                            setCurrentId(module.id)\n                            setQuery(\"\")\n                            if (!isMobile) setOpen(true)\n                          }}\n                        >\n                          <module.icon aria-hidden />\n                        </Button>\n                      }\n                    />\n                    <TooltipContent side=\"right\">{module.label}</TooltipContent>\n                  </Tooltip>\n                ))}\n              </nav>\n              <div className=\"flex flex-col items-center gap-2 border-t border-sidebar-border py-3\">\n                {(\n                  [\n                    { key: \"help\", icon: CircleHelpIcon },\n                    { key: \"settings\", icon: SettingsIcon },\n                    { key: \"signOut\", icon: LogOutIcon },\n                  ] as const\n                ).map(({ key, icon: Icon }) => (\n                  <Tooltip key={key}>\n                    <TooltipTrigger\n                      render={\n                        <Button\n                          variant=\"ghost\"\n                          size=\"icon\"\n                          aria-label={labels[key]}\n                          onClick={() => onUtilityAction?.({ action: key })}\n                        >\n                          <Icon aria-hidden />\n                        </Button>\n                      }\n                    />\n                    <TooltipContent side=\"right\">{labels[key]}</TooltipContent>\n                  </Tooltip>\n                ))}\n              </div>\n            </Sidebar>\n            {(isMobile || state === \"expanded\") && (\n              <Sidebar collapsible=\"none\" className=\"min-w-0 flex-1\">\n                <div\n                  data-slot=\"sidebar-03-panel-header\"\n                  className=\"flex h-14 shrink-0 items-center gap-1 border-b border-sidebar-border px-3\"\n                >\n                  <span className=\"min-w-0 flex-1 truncate text-sm font-semibold\">\n                    {current?.label}\n                  </span>\n                  <Button\n                    variant=\"ghost\"\n                    size=\"icon-sm\"\n                    aria-label={labels.create}\n                    onClick={() =>\n                      current && onCreate?.({ moduleId: current.id })\n                    }\n                  >\n                    <PlusIcon aria-hidden />\n                  </Button>\n                  <DropdownMenu>\n                    <DropdownMenuTrigger\n                      render={\n                        <Button\n                          variant=\"ghost\"\n                          size=\"icon-sm\"\n                          aria-label={labels.more}\n                        >\n                          <EllipsisIcon aria-hidden />\n                        </Button>\n                      }\n                    />\n                    <DropdownMenuContent align=\"start\">\n                      {current?.actions?.length ? (\n                        current.actions.map((action) => (\n                          <DropdownMenuItem\n                            key={action.id}\n                            onClick={action.onSelect}\n                          >\n                            {action.label}\n                          </DropdownMenuItem>\n                        ))\n                      ) : (\n                        <DropdownMenuItem\n                          onClick={() =>\n                            onUtilityAction?.({ action: \"settings\" })\n                          }\n                        >\n                          {labels.settings}\n                        </DropdownMenuItem>\n                      )}\n                    </DropdownMenuContent>\n                  </DropdownMenu>\n                </div>\n                <div className=\"border-b border-sidebar-border p-3\">\n                  <SidebarInput\n                    aria-label={labels.search}\n                    placeholder={labels.search}\n                    value={query}\n                    onChange={(event) => setQuery(event.target.value)}\n                    className=\"text-base focus-visible:border-sidebar-ring focus-visible:ring-0 md:text-sm\"\n                  />\n                </div>\n                <SidebarContent>\n                  {current && (\n                    <Sidebar03Tree\n                      key={current.id}\n                      nodes={current.tree}\n                      expanded={expanded}\n                      onExpandedChange={setExpanded}\n                      activeId={activeNodeId}\n                      query={query}\n                      labels={labels}\n                      renderLink={renderLink}\n                    />\n                  )}\n                </SidebarContent>\n                <div className=\"space-y-3 border-t border-sidebar-border p-4 text-xs\">\n                  <div className=\"flex justify-between gap-2\">\n                    <span>{usage.label}</span>\n                    {usage.href && (\n                      <Link\n                        href={usage.href}\n                        className=\"underline underline-offset-4\"\n                        onClick={(event: React.MouseEvent<HTMLAnchorElement>) =>\n                          navigate(event, usage.href!)\n                        }\n                      >\n                        {labels.upgrade}\n                      </Link>\n                    )}\n                  </div>\n                  <div\n                    role=\"progressbar\"\n                    aria-label={usage.label}\n                    aria-valuemin={0}\n                    aria-valuemax={100}\n                    aria-valuenow={percent}\n                    className=\"h-1.5 overflow-hidden rounded-full bg-sidebar-accent\"\n                  >\n                    <div\n                      className=\"h-full bg-sidebar-primary\"\n                      style={{ width: `${percent}%` }}\n                    />\n                  </div>\n                  <p className=\"text-sidebar-foreground/60 tabular-nums\">\n                    {labels.used} {usage.used} {usage.unit} / {usage.total}{\" \"}\n                    {usage.unit}\n                  </p>\n                </div>\n              </Sidebar>\n            )}\n          </div>\n        </TooltipProvider>\n      </Sidebar>\n    </div>\n  )\n}\nexport { Sidebar03 }\nexport type { Sidebar03Props }\n",
      "type": "registry:component",
      "target": "@components/sidebar-03/sidebar-03.tsx"
    },
    {
      "path": "src/registry/blocks/sidebar-03/tree.tsx",
      "content": "\"use client\"\nimport * as React from \"react\"\nimport { ChevronRightIcon, FolderIcon } from \"lucide-react\"\nimport { cn } from \"@/lib/utils\"\nimport type { Sidebar03Labels } from \"./config\"\nimport type { Sidebar03TreeNode } from \"./types\"\n\nfunction findPath(\n  nodes: Sidebar03TreeNode[],\n  id?: string,\n): Sidebar03TreeNode[] {\n  for (const node of nodes) {\n    if (node.id === id) return [node]\n    const path = findPath(node.children ?? [], id)\n    if (path.length) return [node, ...path]\n  }\n  return []\n}\nfunction filterTree(\n  nodes: Sidebar03TreeNode[],\n  query: string,\n): Sidebar03TreeNode[] {\n  if (!query) return nodes\n  return nodes.flatMap((node) => {\n    const children = filterTree(node.children ?? [], query)\n    return node.label.toLocaleLowerCase().includes(query) || children.length\n      ? [{ ...node, children }]\n      : []\n  })\n}\ntype TreeProps = {\n  nodes: Sidebar03TreeNode[]\n  expanded: string[]\n  onExpandedChange: (ids: string[]) => void\n  activeId?: string\n  query: string\n  labels: Sidebar03Labels\n  renderLink: (\n    node: Sidebar03TreeNode,\n    content: React.ReactNode,\n  ) => React.ReactNode\n}\nfunction Sidebar03Tree({\n  nodes,\n  expanded,\n  onExpandedChange,\n  activeId,\n  query,\n  labels,\n  renderLink,\n}: TreeProps) {\n  const root = React.useRef<HTMLUListElement>(null)\n  const [focused, setFocused] = React.useState(activeId)\n  const filtered = filterTree(nodes, query.trim().toLocaleLowerCase())\n  const visible: { node: Sidebar03TreeNode; parent?: string }[] = []\n  function collect(items: Sidebar03TreeNode[], parent?: string) {\n    items.forEach((node) => {\n      visible.push({ node, parent })\n      if (query || expanded.includes(node.id))\n        collect(node.children ?? [], node.id)\n    })\n  }\n  collect(filtered)\n  const focusId = visible.some(({ node }) => node.id === focused)\n    ? focused\n    : visible[0]?.node.id\n  function focus(id?: string) {\n    if (!id) return\n    setFocused(id)\n    const target = Array.from(\n      root.current?.querySelectorAll<HTMLElement>('[role=\"treeitem\"]') ?? [],\n    ).find((el) => el.dataset.nodeId === id)\n    target?.focus()\n  }\n  function toggle(id: string) {\n    onExpandedChange(\n      expanded.includes(id)\n        ? expanded.filter((value) => value !== id)\n        : [...expanded, id],\n    )\n  }\n  function keydown(event: React.KeyboardEvent, node: Sidebar03TreeNode) {\n    if (event.target !== event.currentTarget) return\n    const index = visible.findIndex((item) => item.node.id === node.id)\n    const open = Boolean(query) || expanded.includes(node.id)\n    switch (event.key) {\n      case \"ArrowDown\":\n        focus(visible[Math.min(index + 1, visible.length - 1)]?.node.id)\n        break\n      case \"ArrowUp\":\n        focus(visible[Math.max(0, index - 1)]?.node.id)\n        break\n      case \"Home\":\n        focus(visible[0]?.node.id)\n        break\n      case \"End\":\n        focus(visible.at(-1)?.node.id)\n        break\n      case \"ArrowRight\":\n        if (node.children?.length) {\n          if (!open) toggle(node.id)\n          else focus(node.children[0]?.id)\n        }\n        break\n      case \"ArrowLeft\":\n        if (node.children?.length && open && !query) toggle(node.id)\n        else focus(visible[index]?.parent)\n        break\n      case \"Enter\":\n        if (node.href)\n          event.currentTarget.querySelector<HTMLAnchorElement>(\"a\")?.click()\n        else if (node.children?.length) toggle(node.id)\n        break\n      default:\n        return\n    }\n    event.preventDefault()\n    event.stopPropagation()\n  }\n  function renderNodes(\n    items: Sidebar03TreeNode[],\n    level: number,\n  ): React.ReactNode {\n    return items.map((node, index) => {\n      const branch = Boolean(node.children?.length)\n      const open = Boolean(query) || expanded.includes(node.id)\n      const Icon = node.icon ?? FolderIcon\n      const content = (\n        <>\n          <Icon aria-hidden className=\"size-4 shrink-0\" />\n          <span className=\"truncate\">{node.label}</span>\n          {node.status && (\n            <>\n              <span\n                aria-hidden\n                className={cn(\n                  \"ml-auto size-1.5 shrink-0 rounded-full\",\n                  node.status === \"active\"\n                    ? \"bg-chart-2\"\n                    : node.status === \"paused\"\n                      ? \"bg-chart-4\"\n                      : \"bg-sidebar-foreground/40\",\n                )}\n              />\n              <span className=\"sr-only\">{labels[node.status]}</span>\n            </>\n          )}\n          {node.badge !== undefined && (\n            <span className=\"ml-auto text-xs text-sidebar-foreground/60 tabular-nums\">\n              {node.badge}\n            </span>\n          )}\n        </>\n      )\n      return (\n        <li\n          key={node.id}\n          data-node-id={node.id}\n          role=\"treeitem\"\n          aria-selected={node.id === activeId}\n          aria-label={node.label}\n          aria-level={level}\n          aria-posinset={index + 1}\n          aria-setsize={items.length}\n          aria-expanded={branch ? open : undefined}\n          aria-current={node.id === activeId ? \"page\" : undefined}\n          tabIndex={focusId === node.id ? 0 : -1}\n          onFocus={(event) => {\n            if (event.target === event.currentTarget) setFocused(node.id)\n          }}\n          onKeyDown={(event) => keydown(event, node)}\n          className=\"rounded-md outline-hidden [&:focus-visible>div]:ring-2 [&:focus-visible>div]:ring-sidebar-ring [&:focus-visible>div]:ring-inset\"\n        >\n          <div\n            onMouseDown={(event) => {\n              event.preventDefault()\n              setFocused(node.id)\n              event.currentTarget.parentElement?.focus({ preventScroll: true })\n            }}\n            className={cn(\n              \"flex h-8 items-center rounded-md text-sm hover:bg-sidebar-accent pointer-coarse:h-10\",\n              node.id === activeId &&\n                \"bg-sidebar-accent font-medium text-sidebar-accent-foreground\",\n            )}\n          >\n            {branch ? (\n              <span\n                aria-hidden\n                onClick={() => toggle(node.id)}\n                className=\"flex size-6 shrink-0 cursor-pointer items-center justify-center\"\n              >\n                <ChevronRightIcon\n                  className={cn(\"size-3\", open && \"rotate-90\")}\n                />\n              </span>\n            ) : (\n              <span className=\"w-6 shrink-0\" />\n            )}\n            {node.href ? (\n              renderLink(node, content)\n            ) : (\n              <span\n                onClick={() => branch && toggle(node.id)}\n                className=\"flex min-w-0 flex-1 cursor-pointer items-center gap-2 pr-2\"\n              >\n                {content}\n              </span>\n            )}\n          </div>\n          {branch && open && (\n            <ul\n              role=\"group\"\n              className=\"ml-3 border-l border-sidebar-border pl-2\"\n            >\n              {renderNodes(node.children!, level + 1)}\n            </ul>\n          )}\n        </li>\n      )\n    })\n  }\n  return (\n    <div data-slot=\"sidebar-03-tree\" className=\"p-2\">\n      {visible.length ? (\n        <ul ref={root} role=\"tree\" aria-label={labels.tree}>\n          {renderNodes(filtered, 1)}\n        </ul>\n      ) : (\n        <p\n          role=\"status\"\n          className=\"px-3 py-6 text-sm leading-6 text-sidebar-foreground/60\"\n        >\n          {labels.empty}\n        </p>\n      )}\n    </div>\n  )\n}\nexport { Sidebar03Tree, findPath }\n",
      "type": "registry:component",
      "target": "@components/sidebar-03/tree.tsx"
    },
    {
      "path": "src/registry/hooks/use-controllable-state.ts",
      "content": "\"use client\"\n\nimport * as React from \"react\"\n\ntype UseControllableStateParams<T> = {\n  /** 受控值；传入后组件不再维护内部状态 */\n  prop?: T\n  /** 非受控时的初始值 */\n  defaultProp: T\n  /** 值变化时回调（受控与非受控都会触发） */\n  onChange?: (value: T) => void\n}\n\n/**\n * 同时支持受控与非受控的状态 hook。\n * 约定见 component-conventions 技能第 4 节：open/defaultOpen/onOpenChange 等成对 props 都用它实现。\n */\nfunction useControllableState<T>({\n  prop,\n  defaultProp,\n  onChange,\n}: UseControllableStateParams<T>) {\n  const [uncontrolled, setUncontrolled] = React.useState(defaultProp)\n  const isControlled = prop !== undefined\n  const value = isControlled ? prop : uncontrolled\n\n  // 用 ref 保存最新的回调和值，保证 setValue 引用稳定\n  const onChangeRef = React.useRef(onChange)\n  const valueRef = React.useRef(value)\n  React.useEffect(() => {\n    onChangeRef.current = onChange\n    valueRef.current = value\n  })\n\n  const setValue = React.useCallback(\n    (next: React.SetStateAction<T>) => {\n      const resolved =\n        typeof next === \"function\"\n          ? (next as (prev: T) => T)(valueRef.current)\n          : next\n      if (Object.is(resolved, valueRef.current)) return\n      valueRef.current = resolved\n      if (!isControlled) setUncontrolled(resolved)\n      onChangeRef.current?.(resolved)\n    },\n    [isControlled],\n  )\n\n  return [value, setValue] as const\n}\n\nexport { useControllableState }\n",
      "type": "registry:hook",
      "target": "hooks/use-controllable-state.ts"
    }
  ],
  "cssVars": {
    "theme": {
      "color-edge": "var(--edge)"
    },
    "light": {
      "edge": "color-mix(in oklch, var(--foreground) 12%, transparent)"
    },
    "dark": {
      "edge": "color-mix(in oklch, var(--foreground) 18%, transparent)"
    }
  },
  "type": "registry:block"
}
