{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "steps-numbered",
  "type": "registry:block",
  "title": "Steps, numbered",
  "description": "Numbered steps as cards in a row or as a list. A step may carry a copyable code block or a reference chip.",
  "categories": [
    "steps"
  ],
  "dependencies": [
    "zod@^4.6.5"
  ],
  "registryDependencies": [
    "https://ui.klarhimmel.com/r/block-kit.json",
    "https://ui.klarhimmel.com/r/editing.json",
    "https://ui.klarhimmel.com/r/kit-b-directory.json",
    "https://ui.klarhimmel.com/r/utils.json"
  ],
  "files": [
    {
      "path": "src/blocks/steps-numbered/spec.ts",
      "type": "registry:file",
      "target": "components/klarhimmel/blocks/steps-numbered/spec.ts",
      "content": "import { z } from 'zod';\nimport { defineSpec, t } from '../_shared/schema';\n\nconst schema = z.object({\n  eyebrow: t(60),\n  title: t(120),\n  description: t(300),\n  layout: z.enum(['cards', 'list']),\n  items: z\n    .array(z.object({ title: t(80), description: t(240), meta: t(60), code: t(400) }))\n    .min(1)\n    .max(10),\n});\n\nexport const spec = defineSpec({\n  type: 'steps-numbered',\n  aliases: ['steps/numbered'],\n  name: 'Steps, numbered',\n  category: 'steps',\n  role: 'body',\n  description: 'Numbered steps as cards in a row or as a list. A step may carry a copyable code block or a reference chip.',\n  schema,\n  defaults: {\n    eyebrow: 'Name the section',\n    title: 'Say what the reader has after how many steps',\n    description: '',\n    layout: 'list',\n    items: [\n      { title: 'Name the first step', description: 'Say when the reader can skip the first step.', meta: '', code: 'npx your-app init' },\n      { title: 'Name the second step', description: 'Say what the second step adds and who owns it.', meta: 'Name', code: 'npx your-app add first-part' },\n      { title: 'Name the third step', description: 'Say how to use it and what the reader can change.', meta: '', code: \"import { FirstPart } from '@/components/first-part';\" },\n    ],\n  },\n});\n"
    },
    {
      "path": "src/blocks/steps-numbered/index.tsx",
      "type": "registry:file",
      "target": "components/klarhimmel/blocks/steps-numbered/index.tsx",
      "content": "import { useId } from 'react';\nimport { Text, withHeadingLevel } from '../../editing';\nimport { cn } from '../../lib/utils';\nimport { Container, Opt, Section, SectionHeader, useEditing } from '../_shared/kit';\nimport { CodeSnippet, useHeaderEmpty } from '../_shared/b-directory-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 StepsNumbered({ props }: BlockProps<Props>) {\n  const id = useId();\n  const editing = useEditing();\n  const noHeader = useHeaderEmpty(props.eyebrow, props.title, props.description);\n  const cards = props.layout === 'cards';\n  // with no section heading the steps own the h2 level\n  const Step = noHeader ? 'h2' : 'h3';\n  return (\n    <Section labelledBy={noHeader ? undefined : id} className={cn(noHeader && 'py-10 @3xl:py-14')}>\n      <Container>\n        {!noHeader && <SectionHeader id={id} eyebrow={props.eyebrow} title={props.title} description={props.description} />}\n        {/* Cards: four or eight steps go four to a row, so a row of three never leaves one card alone; other counts keep rows of three. */}\n        <ol className={cn(!noHeader && 'mt-12', cards ? cn('grid gap-5 @2xl:grid-cols-2', props.items.length % 4 === 0 ? '@4xl:grid-cols-4' : '@4xl:grid-cols-3') : 'flex max-w-kh-prose flex-col')}>\n          {props.items.map((item, i) => (\n            <li key={i} className={cn('min-w-0', cards ? 'flex flex-col rounded-kh-lg border border-kh-line bg-kh-surface p-6' : 'relative flex gap-5 pb-10 last:pb-0')}>\n              {!cards && i < props.items.length - 1 && <span aria-hidden className=\"absolute bottom-0 left-[1.1875rem] top-11 w-px bg-kh-line\" />}\n              <span aria-hidden className=\"relative z-[1] inline-flex size-10 shrink-0 items-center justify-center rounded-kh-pill border border-kh-line-strong bg-kh-canvas text-kh-small font-semibold tabular-nums text-kh-ink\">\n                {i + 1}\n              </span>\n              <div className={cn('min-w-0 flex-1', cards ? 'mt-5' : 'pt-1.5')}>\n                <div className=\"flex flex-wrap items-center gap-x-3 gap-y-1\">\n                  <Text path={['items', i, 'title']} value={item.title} as={Step} className=\"text-kh-heading font-semibold\" />\n                  <Opt path={['items', i, 'meta']} value={item.meta} as=\"span\" className=\"inline-flex items-center rounded-kh-sm border border-kh-line-strong px-2 py-0.5 font-kh-mono text-kh-caption text-kh-ink-2\" placeholder=\"Reference\" />\n                </div>\n                <Opt path={['items', i, 'description']} value={item.description} className=\"mt-2 text-kh-body text-kh-muted\" placeholder=\"Description\" />\n                {(item.code || editing) && <CodeSnippet path={['items', i, 'code']} value={item.code} className=\"mt-4\" />}\n              </div>\n            </li>\n          ))}\n        </ol>\n      </Container>\n    </Section>\n  );\n}\n\nexport default withHeadingLevel(StepsNumbered);\n"
    }
  ]
}
