{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "description-list",
  "title": "Description List",
  "author": "Ballmac <https://ui.ballmac.com>",
  "description": "A semantic key-value surface with responsive split and stacked layouts.",
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/ballmac/components/description-list.tsx",
      "content": "// Ballmac UI: Description List. https://ui.ballmac.com/components/description-list\nimport * as React from \"react\"\nimport { cn } from \"@/lib/utils\"\n\ntype DescriptionListProps = React.ComponentProps<\"dl\"> & {\n  /** Align terms and details in two columns on larger screens. */\n  layout?: \"stacked\" | \"split\"\n}\ntype DescriptionItemProps = React.ComponentProps<\"div\"> & {\n  /** Field label. */\n  label: string\n  /** Field value. */\n  value: React.ReactNode\n}\nfunction DescriptionList({\n  className,\n  layout = \"split\",\n  ...props\n}: DescriptionListProps) {\n  return (\n    <dl\n      data-slot=\"description-list\"\n      data-layout={layout}\n      className={cn(\n        \"group/description-list bg-card min-w-0 divide-y divide-border rounded-xl border border-border\",\n        className,\n      )}\n      {...props}\n    />\n  )\n}\nfunction DescriptionItem({\n  className,\n  label,\n  value,\n  ...props\n}: DescriptionItemProps) {\n  return (\n    <div\n      data-slot=\"description-item\"\n      className={cn(\n        \"group-data-[layout=split]/description-list:sm:grid group-data-[layout=split]/description-list:sm:grid-cols-[minmax(0,10rem)_minmax(0,1fr)] group-data-[layout=split]/description-list:sm:gap-4 px-4 py-3 first:rounded-t-xl last:rounded-b-xl\",\n        className,\n      )}\n      {...props}\n    >\n      <dt className=\"text-muted-foreground text-sm font-medium\">{label}</dt>\n      <dd className=\"mt-1 min-w-0 break-words text-sm sm:mt-0\">{value}</dd>\n    </div>\n  )\n}\nexport {\n  DescriptionList,\n  DescriptionItem,\n  type DescriptionListProps,\n  type DescriptionItemProps,\n}\n",
      "type": "registry:ui",
      "target": "@components/ballmac/description-list.tsx"
    }
  ],
  "meta": {
    "schema": 1,
    "tier": "free",
    "tags": [
      "details",
      "key-value",
      "metadata"
    ],
    "version": "1.0.0",
    "updated": "2026-09-30",
    "ai": {
      "summary": "A semantic key-value surface with responsive split and stacked layouts.",
      "whenToUse": [
        "Display read-only properties for an object"
      ],
      "whenNotToUse": [
        "Use a form for editable fields"
      ],
      "composesWith": [
        "card"
      ],
      "a11y": [
        {
          "keys": "None",
          "action": "Static content is announced with semantic structure"
        }
      ],
      "customization": [
        "Content, layout, and token-based className styling"
      ]
    },
    "examples": [
      "description-list-demo",
      "description-list-states"
    ],
    "url": "https://ui.ballmac.com/components/description-list"
  },
  "categories": [
    "data-display"
  ],
  "type": "registry:ui"
}