{
  "name": "KeyValueRepeater",
  "package": "@magicblocksai/ui",
  "file": "packages/ui/src/components/KeyValueRepeater.tsx",
  "chapterTag": "04 Forms & Inputs",
  "chapter": "05-forms-and-inputs.html",
  "sectionId": "kv-repeater",
  "elName": "KeyValueRepeater",
  "demoUrl": "https://brand.magicblocks.ai/components/05-forms-and-inputs#kv-repeater",
  "hasLiveDemo": false,
  "description": "List of key/value pairs with add + remove affordances — the canonical\nshape for MCP auth headers, Webhook headers, HTTP function parameters.",
  "useClient": true,
  "interactivity": "interactive",
  "namedExports": [
    {
      "name": "KeyValueRepeater",
      "isPrincipal": true,
      "isType": false
    },
    {
      "name": "KeyValueRepeaterProps",
      "isPrincipal": false,
      "isType": true
    },
    {
      "name": "KeyValueRow",
      "isPrincipal": false,
      "isType": false
    }
  ],
  "importStatement": "import { KeyValueRepeater } from \"@magicblocksai/ui\";",
  "props": [
    {
      "name": "value",
      "optional": true,
      "type": "KeyValueRow[]",
      "doc": "Controlled rows."
    },
    {
      "name": "defaultValue",
      "optional": true,
      "type": "KeyValueRow[]",
      "doc": "Uncontrolled initial rows."
    },
    {
      "name": "onValueChange",
      "optional": true,
      "type": "(rows: KeyValueRow[]) => void",
      "doc": "Fires when the row set changes."
    },
    {
      "name": "label",
      "optional": true,
      "type": "ReactNode",
      "doc": "Optional table caption / label."
    },
    {
      "name": "keyPlaceholder",
      "optional": true,
      "type": "string",
      "doc": "Key column placeholder. Default `\"Header\"`."
    },
    {
      "name": "valuePlaceholder",
      "optional": true,
      "type": "string",
      "doc": "Value column placeholder. Default `\"Value\"`."
    },
    {
      "name": "addLabel",
      "optional": true,
      "type": "ReactNode",
      "doc": "Add button label. Default `\"+ Add header\"`."
    },
    {
      "name": "readOnly",
      "optional": true,
      "type": "boolean",
      "doc": "Hide the trash button (display-only)."
    }
  ],
  "classesUsed": [
    "kv-repeater",
    "kv-repeater-add",
    "kv-repeater-key",
    "kv-repeater-label",
    "kv-repeater-remove",
    "kv-repeater-row",
    "kv-repeater-rows",
    "kv-repeater-value"
  ],
  "examples": {
    "react": null,
    "html": "<div class=\"kv-repeater\">\n  <div class=\"kv-repeater-label\">Auth headers</div>\n  <div class=\"kv-repeater-rows\">\n    <div class=\"kv-repeater-row\">\n      <input class=\"kv-repeater-key\" placeholder=\"Header\" value=\"Authorization\">\n      <input class=\"kv-repeater-value\" placeholder=\"Value\" value=\"Bearer …\">\n      <button type=\"button\" class=\"kv-repeater-remove\" aria-label=\"Remove row\">×</button>\n    </div>\n  </div>\n  <button type=\"button\" class=\"kv-repeater-add\">+ Add header</button>\n</div>",
    "css": ".kv-repeater { display: flex; flex-direction: column; gap: var(--s-2); }\n\n.kv-repeater-add {\n  align-self: flex-start;\n  appearance: none;\n  background: transparent;\n  border: 1px dashed var(--hair);\n  border-radius: var(--r-sm);\n  padding: 6px 10px;\n  font: 500 12.5px/1 var(--f-body);\n  color: var(--accent);\n  cursor: pointer;\n  transition: background var(--dur-2) var(--ease);\n}\n\n.kv-repeater-key {\n  height: 32px;\n  padding: 0 var(--s-3);\n  border: 1px solid var(--hair);\n  border-radius: var(--r-sm);\n  background: var(--bg-paper);\n  color: var(--fg);\n  font: 400 13px/1 var(--f-body);\n}\n\n.kv-repeater-label { font: 500 13px/1.3 var(--f-body); color: var(--fg); }\n\n.kv-repeater-remove {\n  appearance: none;\n  background: transparent;\n  border: 0;\n  width: 32px;\n  height: 32px;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  color: var(--fg-faint);\n  cursor: pointer;\n  border-radius: var(--r-xs);\n  transition: color var(--dur-2) var(--ease), background var(--dur-2) var(--ease);\n}\n\n.kv-repeater-row {\n  display: grid;\n  grid-template-columns: 1fr 1fr 32px;\n  gap: 6px;\n}\n\n.kv-repeater-rows { display: flex; flex-direction: column; gap: 6px; }\n\n.kv-repeater-value {\n  height: 32px;\n  padding: 0 var(--s-3);\n  border: 1px solid var(--hair);\n  border-radius: var(--r-sm);\n  background: var(--bg-paper);\n  color: var(--fg);\n  font: 400 13px/1 var(--f-body);\n}"
  }
}