{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "docs-install",
  "type": "registry:block",
  "title": "Docs, install panel",
  "description": "An install panel: tabs of copyable code (CLI, Manual, Download), an optional \"Uses\" chip row, short labelled facts and actions. A tab with no code is left out.",
  "categories": [
    "docs"
  ],
  "dependencies": [
    "zod@^4.6.5"
  ],
  "registryDependencies": [
    "https://ui.klarhimmel.com/r/badge.json",
    "https://ui.klarhimmel.com/r/block-kit.json",
    "https://ui.klarhimmel.com/r/editing.json",
    "https://ui.klarhimmel.com/r/kit-a-docs.json",
    "https://ui.klarhimmel.com/r/kit-d-chrome.json",
    "https://ui.klarhimmel.com/r/tabs.json"
  ],
  "files": [
    {
      "path": "src/blocks/docs-install/spec.ts",
      "type": "registry:file",
      "target": "components/klarhimmel/blocks/docs-install/spec.ts",
      "content": "import { z } from 'zod';\nimport { defineSpec, link, t } from '../_shared/schema';\n\nconst schema = z.object({\n  title: t(60),\n  tabs: z.array(z.object({ label: t(20), code: t(400) })).min(1).max(4),\n  usesLabel: t(20),\n  uses: z.array(t(40)).max(8),\n  facts: z.array(z.object({ label: t(30), text: t(240) })).max(3),\n  actions: z.array(link).max(3),\n});\n\nexport const spec = defineSpec({\n  type: 'docs-install',\n  aliases: ['docs/install'],\n  name: 'Docs, install panel',\n  category: 'docs',\n  role: 'body',\n  description: 'An install panel: tabs of copyable code (CLI, Manual, Download), an optional \"Uses\" chip row, short labelled facts and actions. A tab with no code is left out.',\n  schema,\n  defaults: {\n    title: 'Name the step',\n    tabs: [\n      { label: 'First tab', code: 'npm create your-app@latest' },\n      { label: 'Second tab', code: 'pnpm create your-app@latest' },\n      { label: 'Third tab', code: 'curl -O https://your-site.example/file.json' },\n    ],\n    usesLabel: 'Uses',\n    uses: ['Part one', 'Part two', 'Part three'],\n    facts: [\n      { label: 'First fact', text: 'Say what the reader gets or needs, in one or two sentences.' },\n      { label: 'Second fact', text: 'Say what the reader gets or needs, in one or two sentences.' },\n    ],\n    actions: [{ label: 'Main action', href: '#copy' }],\n  },\n});\n"
    },
    {
      "path": "src/blocks/docs-install/index.tsx",
      "type": "registry:file",
      "target": "components/klarhimmel/blocks/docs-install/index.tsx",
      "content": "import { useId } from 'react';\nimport { Text, withHeadingLevel } from '../../editing';\nimport { Badge } from '../../ui/badge';\nimport { Tabs, TabsContent, TabsList, TabsTrigger } from '../../ui/tabs';\nimport { ActionLink, Container, Opt, Section, useEditing } from '../_shared/kit';\nimport { CodePanel } from '../_shared/a-docs-kit';\nimport { useInteractive } from '../_shared/d-chrome-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\nfunction DocsInstall({ props }: BlockProps<Props>) {\n  const id = useId();\n  const editing = useEditing();\n  const interactive = useInteractive(); // without JavaScript the tabs cannot switch: every panel is shown, labelled, and there are no tab buttons\n  // A tab without code is left out of the published block; while editing every tab is shown so it can be filled in.\n  const shown = props.tabs.map((tab, i) => ({ tab, i })).filter(({ tab }) => editing || tab.code);\n  const list = shown.length ? shown : props.tabs.slice(0, 1).map((tab, i) => ({ tab, i }));\n  const hasFooter = props.uses.length > 0 || props.facts.length > 0 || props.actions.length > 0;\n  return (\n    <Section labelledBy={id} className=\"py-10 @3xl:py-14\">\n      <Container>\n        <div className=\"overflow-hidden rounded-kh-xl border border-kh-line bg-kh-surface\">\n          {editing || !interactive ? (\n            <>\n              <div className=\"border-b border-kh-line bg-kh-surface-2 px-5 py-3.5\">\n                <div id={id}><Text path={['title']} value={props.title} as=\"h2\" className=\"text-kh-heading font-semibold\" /></div>\n              </div>\n              {list.map(({ tab, i }) => (\n                <div key={i} className=\"border-b border-kh-line\">\n                  <p className=\"px-5 pt-3 text-kh-caption font-medium text-kh-muted\">\n                    <Text path={['tabs', i, 'label']} value={tab.label} as=\"span\" placeholder=\"Tab label\" />\n                  </p>\n                  <CodePanel path={['tabs', i, 'code']} code={tab.code} command={!tab.code.startsWith('import ')} flush />\n                </div>\n              ))}\n            </>\n          ) : (\n            <Tabs defaultValue={String(list[0]?.i ?? 0)}>\n              <div className=\"flex flex-wrap items-center justify-between gap-x-4 gap-y-2 border-b border-kh-line bg-kh-surface-2 px-5 py-2.5\">\n                <div id={id}><Text path={['title']} value={props.title} as=\"h2\" className=\"text-kh-heading font-semibold\" /></div>\n                {list.length > 1 && (\n                  <TabsList label={props.title} className=\"max-w-full overflow-x-auto bg-kh-surface-3\">\n                    {list.map(({ tab, i }) => (\n                      <TabsTrigger key={i} value={String(i)} className=\"whitespace-nowrap\">{tab.label}</TabsTrigger>\n                    ))}\n                  </TabsList>\n                )}\n              </div>\n              {list.map(({ tab, i }) => (\n                <TabsContent key={i} value={String(i)}>\n                  <CodePanel path={['tabs', i, 'code']} code={tab.code} command={!tab.code.startsWith('import ')} flush />\n                </TabsContent>\n              ))}\n            </Tabs>\n          )}\n          {hasFooter && (\n            <div className=\"space-y-5 border-t border-kh-line px-5 py-5\">\n              {(props.uses.length > 0 || editing) && (\n                <div className=\"flex flex-wrap items-center gap-x-4 gap-y-2\">\n                  <Opt path={['usesLabel']} value={props.usesLabel} as=\"span\" className=\"text-kh-small font-medium\" placeholder=\"Label\" />\n                  <ul className=\"flex flex-wrap gap-2\">\n                    {props.uses.map((u, i) => (\n                      <li key={i}><Badge tone=\"neutral\"><Text path={['uses', i]} value={u} as=\"span\" /></Badge></li>\n                    ))}\n                  </ul>\n                </div>\n              )}\n              {props.facts.length > 0 && (\n                <dl className=\"grid gap-x-6 gap-y-3 @md:grid-cols-[auto_1fr]\">\n                  {props.facts.map((f, i) => (\n                    <div key={i} className=\"grid gap-x-6 gap-y-0.5 @md:col-span-2 @md:grid-cols-subgrid\">\n                      <dt className=\"text-kh-small font-medium\"><Text path={['facts', i, 'label']} value={f.label} as=\"span\" /></dt>\n                      <dd className=\"text-kh-small text-kh-muted\"><Text path={['facts', i, 'text']} value={f.text} as=\"span\" multiline /></dd>\n                    </div>\n                  ))}\n                </dl>\n              )}\n              {props.actions.length > 0 && (\n                <div className=\"flex flex-wrap gap-3\">\n                  {props.actions.map((a, i) => (\n                    <ActionLink key={i} path={['actions', i]} value={a} variant=\"secondary\" size=\"md\" />\n                  ))}\n                </div>\n              )}\n            </div>\n          )}\n        </div>\n      </Container>\n    </Section>\n  );\n}\n\nexport default withHeadingLevel(DocsInstall);\n"
    }
  ]
}
