{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "app-shell-sidebar",
  "type": "registry:block",
  "title": "App, sidebar navigation",
  "description": "The sidebar of an app: grouped links with icons and an optional count, groups that open and close, the current page marked with aria-current, and a button that folds it into an icon rail whose names appear in tooltips (on hover and keyboard focus).",
  "categories": [
    "app"
  ],
  "dependencies": [
    "lucide-react@^1.49.0",
    "zod@^4.6.5"
  ],
  "registryDependencies": [
    "https://ui.klarhimmel.com/r/block-kit.json",
    "https://ui.klarhimmel.com/r/button.json",
    "https://ui.klarhimmel.com/r/editing.json",
    "https://ui.klarhimmel.com/r/kit-app.json",
    "https://ui.klarhimmel.com/r/sidebar.json",
    "https://ui.klarhimmel.com/r/tooltip.json",
    "https://ui.klarhimmel.com/r/utils.json"
  ],
  "files": [
    {
      "path": "src/blocks/app-shell-sidebar/spec.ts",
      "type": "registry:file",
      "target": "components/klarhimmel/blocks/app-shell-sidebar/spec.ts",
      "content": "import { z } from 'zod';\nimport { defineSpec, icon, t, req } from '../_shared/schema';\n\nconst item = z.object({ label: t(30), icon, href: t(300), badge: t(6).optional() });\nconst group = z.object({\n  /** The group's heading; with `collapsible` it is a button that opens and closes the group. */\n  label: t(30),\n  collapsible: z.boolean(),\n  /** Whether the group starts open. */\n  open: z.boolean(),\n  items: z.array(item).min(1).max(6),\n});\n\nconst schema = z.object({\n  brand: t(30),\n  /** Names the navigation landmark. Not shown. */\n  navLabel: t(40),\n  groups: z.array(group).min(1).max(4),\n  /** The label of the page the person is on (matches one item). */\n  active: t(30),\n  /** collapsed: a narrow rail of icons whose names show in tooltips. The toggle switches it in place. */\n  collapsed: z.boolean(),\n  toggle: z.object({ collapse: req(30), expand: t(30) }),\n});\n\nexport const spec = defineSpec({\n  type: 'app-shell-sidebar',\n  aliases: ['app/shell-sidebar'],\n  name: 'App, sidebar navigation',\n  category: 'app',\n  role: 'body',\n  description: 'The sidebar of an app: grouped links with icons and an optional count, groups that open and close, the current page marked with aria-current, and a button that folds it into an icon rail whose names appear in tooltips (on hover and keyboard focus).',\n  schema,\n  defaults: {\n    \"brand\": \"Name the product\",\n    \"navLabel\": \"Main navigation\",\n    \"groups\": [\n      {\n        \"label\": \"Workspace\",\n        \"collapsible\": false,\n        \"open\": true,\n        \"items\": [\n          {\n            \"label\": \"First page\",\n            \"icon\": \"gauge\",\n            \"href\": \"#overview\"\n          },\n          {\n            \"label\": \"Second page\",\n            \"icon\": \"book\",\n            \"href\": \"#bookings\",\n            \"badge\": \"00\"\n          },\n          {\n            \"label\": \"Page three\",\n            \"icon\": \"box\",\n            \"href\": \"#rooms\"\n          },\n          {\n            \"label\": \"Fourth page\",\n            \"icon\": \"users\",\n            \"href\": \"#guests\"\n          }\n        ]\n      },\n      {\n        \"label\": \"Manage\",\n        \"collapsible\": true,\n        \"open\": true,\n        \"items\": [\n          {\n            \"label\": \"Page five\",\n            \"icon\": \"heart\",\n            \"href\": \"#team\"\n          },\n          {\n            \"label\": \"Page six\",\n            \"icon\": \"chart\",\n            \"href\": \"#reports\"\n          },\n          {\n            \"label\": \"Page seven\",\n            \"icon\": \"settings\",\n            \"href\": \"#settings\"\n          }\n        ]\n      }\n    ],\n    \"active\": \"Second page\",\n    \"collapsed\": false,\n    \"toggle\": {\n      \"collapse\": \"Collapse sidebar\",\n      \"expand\": \"Expand sidebar\"\n    }\n  },\n});\n"
    },
    {
      "path": "src/blocks/app-shell-sidebar/index.tsx",
      "type": "registry:file",
      "target": "components/klarhimmel/blocks/app-shell-sidebar/index.tsx",
      "content": "import { useId } from 'react';\nimport { PanelLeftClose, PanelLeftOpen } from 'lucide-react';\nimport { Text, withHeadingLevel } from '../../editing';\nimport { cn } from '../../lib/utils';\nimport { safeHref } from '../../ui/button';\nimport { TooltipProvider } from '../../ui/tooltip';\nimport { Sidebar, SidebarGroup, SidebarHeader, SidebarItem, SidebarNav } from '../../ui/sidebar';\nimport { Icon, Container, Section, useEditing, Named } from '../_shared/kit';\nimport { StateSlot, useSynced } from '../_shared/app-kit';\nimport { spec } from './spec';\nimport type { BlockProps } from '../types';\nimport type { z } from 'zod';\n\nexport { spec };\ntype Props = z.infer<typeof spec.schema>;\n\n// The demo frame around the Sidebar primitive (src/ui/sidebar.tsx): a fixed-height card, the rail toggle and group state in React.\nfunction AppShellSidebar({ props }: BlockProps<Props>) {\n  const id = useId();\n  const editing = useEditing();\n  const [rail, setRail] = useSynced(props.collapsed);\n  const [open, setOpen] = useSynced(props.groups.map((g) => g.open));\n  const focus = 'focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-(--kh-focus)';\n  return (\n    <Section className=\"py-8\">\n      <Container>\n        <TooltipProvider>\n          <Sidebar\n            rail={rail}\n            className={cn('h-[34rem] rounded-kh-xl border border-kh-line shadow-kh-1', rail ? 'w-16' : 'w-64 max-w-full')}\n            header={\n              <SidebarHeader\n                action={\n                  <Named as=\"button\"\n                    type=\"button\"\n                    onClick={() => setRail((r) => !r)}\n                    aria-pressed={rail}\n                    className={cn('inline-flex size-11 shrink-0 items-center justify-center rounded-kh text-kh-ink-2 hover:bg-kh-surface-2 hover:text-kh-ink', focus)}\n                  >\n                    {rail ? <PanelLeftOpen aria-hidden className=\"size-5\" /> : <PanelLeftClose aria-hidden className=\"size-5\" />}\n                    <span className=\"sr-only\">\n                      <Text path={['toggle', rail ? 'expand' : 'collapse']} value={rail ? props.toggle.expand : props.toggle.collapse} as=\"span\" />\n                    </span>\n                  </Named>\n                }\n              >\n                <Text path={['brand']} value={props.brand} as=\"span\" className=\"truncate font-semibold\" />\n              </SidebarHeader>\n            }\n          >\n            <StateSlot show={false}>\n              <Text path={['toggle', rail ? 'collapse' : 'expand']} value={rail ? props.toggle.collapse : props.toggle.expand} as=\"p\" />\n            </StateSlot>\n            <span id={`${id}-n`} className=\"sr-only\">\n              <Text path={['navLabel']} value={props.navLabel} as=\"span\" />\n            </span>\n            <SidebarNav aria-labelledby={`${id}-n`} className=\"gap-0\">\n              {props.groups.map((g, gi) => (\n                <SidebarGroup\n                  key={gi}\n                  className=\"mb-3\"\n                  label={<Text path={['groups', gi, 'label']} value={g.label} as=\"span\" />}\n                  collapsible={g.collapsible}\n                  open={open[gi]}\n                  onOpenChange={(v) => setOpen((o) => o.map((x, k) => (k === gi ? v : x)))}\n                >\n                  {g.items.map((it, ii) => {\n                    if (!it.label && !editing) return null; // an empty label means the link is not drawn\n                    return (\n                      <SidebarItem\n                        key={ii}\n                        href={safeHref(it.href)}\n                        current={it.label === props.active}\n                        tooltip={it.label}\n                        icon={<Icon name={it.icon} className=\"size-5 shrink-0\" />}\n                        badge={(it.badge || editing) ? <Text path={['groups', gi, 'items', ii, 'badge']} value={it.badge ?? ''} as=\"span\" /> : undefined}\n                      >\n                        <Text path={['groups', gi, 'items', ii, 'label']} value={it.label} as=\"span\" />\n                      </SidebarItem>\n                    );\n                  })}\n                </SidebarGroup>\n              ))}\n            </SidebarNav>\n          </Sidebar>\n        </TooltipProvider>\n      </Container>\n    </Section>\n  );\n}\n\nexport default withHeadingLevel(AppShellSidebar);\n"
    }
  ]
}
