@krizaka/ui 2.0.0-beta.5 → 2.0.0

package/registry/stat.json

@@ -1,12 +1,149 @@
 {
   "name": "stat",
   "type": "primitive",
-  "description": "`Stat`, `stat` (the slots). Server-safe.",
+  "title": "Stat",
+  "summary": "A key figure: a label, a value in tabular digits, a hint and a trend said in words.",
+  "description": "A key figure: a label, a value in tabular digits, a hint and a trend said in words.",
+  "status": "stable",
+  "category": "data-display",
+  "platforms": "web",
+  "whenToUse": [
+    "On a dashboard: revenue, views, supporters.",
+    "In a row of a few figures that compare over the same period."
+  ],
+  "whenNotToUse": [
+    {
+      "when": "For figures inside an item's card.",
+      "use": "card"
+    },
+    {
+      "when": "For progress towards a goal.",
+      "use": "progress"
+    },
+    {
+      "when": "For a status.",
+      "use": "badge"
+    }
+  ],
+  "bestPractices": [
+    "Format the value in the app (currency, compact numbers) with `@krizaka/intl`.",
+    "Say the change in `trendLabel` (“+12 %”) and the period in `hint`: the arrow alone says nothing."
+  ],
+  "accessibility": {
+    "keyboard": [],
+    "notes": [
+      "The arrow is decorative; `trendLabel` is read and shown.",
+      "Colour is never the only signal of the trend."
+    ]
+  },
+  "related": [
+    "card",
+    "badge",
+    "progress"
+  ],
+  "web": {
+    "entry": "@krizaka/ui/stat",
+    "import": "import { Stat } from \"@krizaka/ui/stat\";",
+    "props": [
+      {
+        "component": "Stat",
+        "description": "",
+        "props": [
+          {
+            "name": "label",
+            "type": "ReactNode",
+            "default": null,
+            "description": "What the figure is (\"Revenue\"), above it.",
+            "required": true
+          },
+          {
+            "name": "value",
+            "type": "ReactNode",
+            "default": null,
+            "description": "The figure, formatted by the app, in tabular digits.",
+            "required": true
+          },
+          {
+            "name": "hint",
+            "type": "ReactNode",
+            "default": null,
+            "description": "A line under the value: the period, the comparison.",
+            "required": false
+          },
+          {
+            "name": "trend",
+            "type": "StatTrend",
+            "default": null,
+            "description": "The direction of the change; its arrow is decorative.",
+            "required": false
+          },
+          {
+            "name": "trendLabel",
+            "type": "ReactNode",
+            "default": null,
+            "description": "The change, in words, as read and shown (e.g. \"+12 % vs last week\") — the arrow alone says nothing.",
+            "required": false
+          }
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "name": "up",
+        "title": "Up",
+        "description": "A rise, with its period.",
+        "path": "examples/stat/up.tsx",
+        "module": "@krizaka/ui/registry/examples/stat/up",
+        "code": "import { Stat } from \"@krizaka/ui/stat\";\n\nexport default function StatUp() {\n  return <Stat label=\"Revenue\" value=\"€4,812\" hint=\"vs last month\" trend=\"up\" trendLabel=\"+12 %\" />;\n}\n"
+      },
+      {
+        "name": "down",
+        "title": "Down",
+        "description": "A fall, said in words next to the arrow.",
+        "path": "examples/stat/down.tsx",
+        "module": "@krizaka/ui/registry/examples/stat/down",
+        "code": "import { Stat } from \"@krizaka/ui/stat\";\n\nexport default function StatDown() {\n  return <Stat label=\"Revenue\" value=\"€4,812\" hint=\"vs last month\" trend=\"down\" trendLabel=\"−4 %\" />;\n}\n"
+      },
+      {
+        "name": "flat",
+        "title": "Flat",
+        "description": "No change.",
+        "path": "examples/stat/flat.tsx",
+        "module": "@krizaka/ui/registry/examples/stat/flat",
+        "code": "import { Stat } from \"@krizaka/ui/stat\";\n\nexport default function StatFlat() {\n  return <Stat label=\"Revenue\" value=\"€4,812\" hint=\"vs last month\" trend=\"flat\" trendLabel=\"0 %\" />;\n}\n"
+      },
+      {
+        "name": "plain",
+        "title": "Plain",
+        "description": "Label and value only.",
+        "path": "examples/stat/plain.tsx",
+        "module": "@krizaka/ui/registry/examples/stat/plain",
+        "code": "import { Stat } from \"@krizaka/ui/stat\";\n\nexport default function StatPlain() {\n  return <Stat label=\"Revenue\" value=\"€4,812\" />;\n}\n"
+      },
+      {
+        "name": "row",
+        "title": "Row",
+        "description": "A row of stats, as a dashboard shows them.",
+        "path": "examples/stat/row.tsx",
+        "module": "@krizaka/ui/registry/examples/stat/row",
+        "code": "import { Stat } from \"@krizaka/ui/stat\";\n\n// A row of stats, as a dashboard shows them.\nexport default function StatRow() {\n  return (\n    <div className=\"grid grid-cols-3 gap-8 rounded-xl border border-border-default bg-surface-1 p-6\">\n      <Stat label=\"Views\" value=\"12.4k\" trend=\"up\" trendLabel=\"+8 %\" hint=\"7 days\" />\n      <Stat label=\"Supporters\" value=\"318\" trend=\"up\" trendLabel=\"+21\" hint=\"7 days\" />\n      <Stat label=\"Payouts\" value=\"€902\" trend=\"down\" trendLabel=\"−3 %\" hint=\"7 days\" />\n    </div>\n  );\n}\n"
+      }
+    ]
+  },
+  "native": null,
   "files": [
+    {
+      "path": "meta.ts",
+      "content": "// The documentation of a component, carried by its code: each primitive has a `meta.ts` beside its source\n// (`src/<name>/meta.ts`; a component that exists only in React Native: `src/native/meta/<name>.ts`). Never built into\n// the package: `scripts/build-registry.mjs` reads them into `registry/<name>.json`, which krizaka.com renders as\n// /docs/ui/<name>, and `scripts/registry.test.mjs` fails when one is missing or incomplete.\n//\n// Why a typed module and not JSDoc tags: the fields are lists and links (`related`, `whenNotToUse[].use`, examples),\n// which a type checks and a comment does not; the file is plain data (erasable TypeScript), so Node reads it without a\n// compiler, and an editor completes it.\n\n/** Every documented component: the web primitives (one entry of the package each) and the native-only ones. */\nexport type ComponentName =\n  | \"alert\"\n  | \"avatar\"\n  | \"badge\"\n  | \"button\"\n  | \"card\"\n  | \"checkbox\"\n  | \"chip\"\n  | \"cn\"\n  | \"command\"\n  | \"confirm-button\"\n  | \"countdown\"\n  | \"dialog\"\n  | \"dropdown-menu\"\n  | \"empty-state\"\n  | \"field\"\n  | \"kbd\"\n  | \"page-header\"\n  | \"popover\"\n  | \"progress\"\n  | \"radio-group\"\n  | \"section-backdrop\"\n  | \"segmented\"\n  | \"separator\"\n  | \"skeleton\"\n  | \"slider\"\n  | \"slot\"\n  | \"spinner\"\n  | \"stat\"\n  | \"switch\"\n  | \"tabs\"\n  | \"theme\"\n  | \"toast\"\n  | \"tooltip\"\n  | \"txt\";\n\n/** Where a component exists: `@krizaka/ui/<name>` (web), `@krizaka/ui/native` (React Native), or both. */\nexport type Platform = \"web\" | \"native\" | \"both\";\n\n/** `stable`: its API only changes in a major. `beta`: it may still change in a minor. */\nexport type Status = \"stable\" | \"beta\";\n\n/** The group of the catalogue. */\nexport type Category = \"actions\" | \"forms\" | \"navigation\" | \"overlays\" | \"feedback\" | \"data-display\" | \"layout\" | \"foundations\";\n\n/**\n * A named example: the file `registry/examples/<component>/<name>.tsx` (web) or\n * `registry/examples/<component>/native/<name>.tsx` (React Native) — at most 40 lines, imported by the stories and\n * shown (live, with its code) by the documentation.\n */\nexport interface Example {\n  /** The file name, kebab-case (`primary`, `icon-button`). */\n  readonly name: string;\n  /** A short title (`Primary`, `Icon button`). */\n  readonly title: string;\n  /** One or two sentences: when this variant is the right one. */\n  readonly description: string;\n}\n\n/** One platform's side of a component. */\nexport interface PlatformDocs {\n  /** The names to import (`[\"Button\", \"IconButton\"]`): from `@krizaka/ui/<name>` on the web, `@krizaka/ui/native` in React Native. */\n  readonly imports: readonly string[];\n  /** The examples, in reading order; the first one is the component's preview. */\n  readonly examples: readonly Example[];\n}\n\n/** The React Native side: the same concept, and what differs from the web API. */\nexport interface NativeDocs extends PlatformDocs {\n  /** What differs from the web API (`label` instead of children…); empty for a native-only component. */\n  readonly differences: readonly string[];\n}\n\nexport interface KeyboardInteraction {\n  /** The keys, as written on a keyboard: `Space`, `Enter`, `Arrow keys`, `Esc`, `Tab`. */\n  readonly keys: string;\n  /** What they do. */\n  readonly action: string;\n}\n\nexport interface ComponentMeta {\n  /** The display name: `Button`, `Dropdown menu`. */\n  readonly title: string;\n  /** One sentence: what it is. */\n  readonly summary: string;\n  readonly status: Status;\n  readonly category: Category;\n  /** Must match the sides below: `both` ⇔ `web` and `native`. */\n  readonly platforms: Platform;\n  /** When to reach for it: concrete situations, one per item. */\n  readonly whenToUse: readonly string[];\n  /** When not to — and what to use instead (`use`), when another component is the answer. */\n  readonly whenNotToUse: readonly { readonly when: string; readonly use?: ComponentName }[];\n  /** How to use it well: wording, placement, composition. */\n  readonly bestPractices: readonly string[];\n  readonly accessibility: {\n    /** The keyboard, when it does more than Tab and Enter. */\n    readonly keyboard: readonly KeyboardInteraction[];\n    /** Roles, names and announcements: what the component does, what the app must provide. */\n    readonly notes: readonly string[];\n  };\n  /** The components a reader of this page should know about. */\n  readonly related: readonly ComponentName[];\n  readonly web?: PlatformDocs;\n  readonly native?: NativeDocs;\n}\n"
+    },
     {
       "path": "stat/index.ts",
       "content": "/** @krizaka/ui/stat — `Stat`, `stat` (the slots). Server-safe. */\nexport { Stat, stat, type StatProps, type StatTrend } from \"./stat\";\n"
     },
+    {
+      "path": "stat/meta.ts",
+      "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n  title: \"Stat\",\n  summary: \"A key figure: a label, a value in tabular digits, a hint and a trend said in words.\",\n  status: \"stable\",\n  category: \"data-display\",\n  platforms: \"web\",\n  whenToUse: [\"On a dashboard: revenue, views, supporters.\", \"In a row of a few figures that compare over the same period.\"],\n  whenNotToUse: [\n    { when: \"For figures inside an item's card.\", use: \"card\" },\n    { when: \"For progress towards a goal.\", use: \"progress\" },\n    { when: \"For a status.\", use: \"badge\" },\n  ],\n  bestPractices: [\n    \"Format the value in the app (currency, compact numbers) with `@krizaka/intl`.\",\n    \"Say the change in `trendLabel` (“+12 %”) and the period in `hint`: the arrow alone says nothing.\",\n  ],\n  accessibility: {\n    keyboard: [],\n    notes: [\"The arrow is decorative; `trendLabel` is read and shown.\", \"Colour is never the only signal of the trend.\"],\n  },\n  related: [\"card\", \"badge\", \"progress\"],\n  web: {\n    imports: [\"Stat\"],\n    examples: [\n      { name: \"up\", title: \"Up\", description: \"A rise, with its period.\" },\n      { name: \"down\", title: \"Down\", description: \"A fall, said in words next to the arrow.\" },\n      { name: \"flat\", title: \"Flat\", description: \"No change.\" },\n      { name: \"plain\", title: \"Plain\", description: \"Label and value only.\" },\n      { name: \"row\", title: \"Row\", description: \"A row of stats, as a dashboard shows them.\" },\n    ],\n  },\n} satisfies ComponentMeta;\n"
+    },
     {
       "path": "stat/stat.tsx",
       "content": "// Server-safe. A key figure: a label, the value in tabular digits, a hint, a trend. Every word is a prop.\nimport type * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nexport const stat = tv({\n  slots: {\n    root: \"flex min-w-0 flex-col gap-1\",\n    label: \"text-xs font-semibold uppercase tracking-wider text-fg-secondary\",\n    value: \"font-display text-2xl font-black tabular-nums text-fg\",\n    meta: \"flex flex-wrap items-center gap-x-2 gap-y-1 text-xs\",\n    // The status tokens are too light for small text on a light surface: the words stay a text role, the arrow carries\n    // the direction's colour.\n    trend: \"inline-flex items-center gap-1 font-semibold text-fg [&>svg]:h-3.5 [&>svg]:w-3.5 [&>svg]:shrink-0\",\n    hint: \"text-fg-secondary\",\n  },\n  variants: {\n    trend: {\n      up: { trend: \"[&>svg]:text-success\" },\n      down: { trend: \"[&>svg]:text-danger\" },\n      flat: { trend: \"[&>svg]:text-fg-secondary\" },\n    },\n  },\n});\n\nexport type StatTrend = \"up\" | \"down\" | \"flat\";\n\nconst ARROW: Record<StatTrend, string> = { up: \"M7 17 17 7M8 7h9v9\", down: \"M7 7l10 10M17 8v9H8\", flat: \"M5 12h14M13 6l6 6-6 6\" };\n\nexport type StatProps = Omit<React.ComponentProps<\"div\">, \"children\"> & {\n  /** What the figure is (\"Revenue\"), above it. */\n  label: React.ReactNode;\n  /** The figure, formatted by the app, in tabular digits. */\n  value: React.ReactNode;\n  /** A line under the value: the period, the comparison. */\n  hint?: React.ReactNode;\n  /** The direction of the change; its arrow is decorative. */\n  trend?: StatTrend;\n  /** The change, in words, as read and shown (e.g. \"+12 % vs last week\") — the arrow alone says nothing. */\n  trendLabel?: React.ReactNode;\n};\n\nexport function Stat({ label, value, hint, trend, trendLabel, className, ...props }: StatProps) {\n  const s = stat({ trend });\n  return (\n    <div data-trend={trend} className={s.root({ className })} {...props}>\n      <p className={s.label()}>{label}</p>\n      <p className={s.value()}>{value}</p>\n      {(trendLabel || hint) && (\n        <p className={s.meta()}>\n          {trend && trendLabel && (\n            <span className={s.trend()}>\n              <svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2.5\" strokeLinecap=\"round\" strokeLinejoin=\"round\" aria-hidden>\n                <path d={ARROW[trend]} />\n              </svg>\n              {trendLabel}\n            </span>\n          )}\n          {hint && <span className={s.hint()}>{hint}</span>}\n        </p>\n      )}\n    </div>\n  );\n}\n"
@@ -17,8 +154,8 @@
   ],
   "registryDependencies": [],
   "demo": {
-    "path": "demos/stat.tsx",
-    "content": "import { Stat } from \"@krizaka/ui/stat\";\n\nexport default function StatDemo() {\n  return <Stat label=\"Revenue\" value=\"€4,812\" hint=\"vs last month\" trend=\"up\" trendLabel=\"+12 %\" />;\n}\n"
+    "path": "examples/stat/up.tsx",
+    "content": "import { Stat } from \"@krizaka/ui/stat\";\n\nexport default function StatUp() {\n  return <Stat label=\"Revenue\" value=\"€4,812\" hint=\"vs last month\" trend=\"up\" trendLabel=\"+12 %\" />;\n}\n"
   },
   "props": [
     {

package/registry/switch.json

@@ -1,12 +1,139 @@
 {
   "name": "switch",
   "type": "primitive",
-  "description": "`Switch`, `switchVariants`. Client (\"use client\").",
+  "title": "Switch",
+  "summary": "An on/off setting that applies at once.",
+  "description": "An on/off setting that applies at once.",
+  "status": "beta",
+  "category": "forms",
+  "platforms": "web",
+  "whenToUse": [
+    "For a setting that takes effect immediately: autoplay, notifications, a weekly digest."
+  ],
+  "whenNotToUse": [
+    {
+      "when": "For a choice submitted with a form, or an agreement.",
+      "use": "checkbox"
+    },
+    {
+      "when": "For more than two states.",
+      "use": "radio-group"
+    },
+    {
+      "when": "To run an action.",
+      "use": "button"
+    }
+  ],
+  "bestPractices": [
+    "Name the setting, not the state: “Autoplay”, not “Turn autoplay on”.",
+    "Put the label first and the switch at the end of the line (`Field.Label htmlFor`), with a hint when it helps."
+  ],
+  "accessibility": {
+    "keyboard": [
+      {
+        "keys": "Space",
+        "action": "Toggles the switch."
+      }
+    ],
+    "notes": [
+      "Radix Switch: `role=\"switch\"` with `aria-checked`.",
+      "`label` names it when no visible label does; otherwise use `Field.Label htmlFor` and `aria-describedby` for the hint."
+    ]
+  },
+  "related": [
+    "checkbox",
+    "field",
+    "radio-group"
+  ],
+  "web": {
+    "entry": "@krizaka/ui/switch",
+    "import": "import { Switch } from \"@krizaka/ui/switch\";",
+    "props": [
+      {
+        "component": "Switch",
+        "description": "An on/off switch: `checked`/`defaultChecked` + `onCheckedChange`.",
+        "props": [
+          {
+            "name": "invalid",
+            "type": "boolean",
+            "default": null,
+            "description": "Marks it invalid: aria-invalid and data-invalid.",
+            "required": false
+          },
+          {
+            "name": "label",
+            "type": "string",
+            "default": null,
+            "description": "The accessible name — required when no visible label names it, passed translated.",
+            "required": false
+          },
+          {
+            "name": "size",
+            "type": "\"sm\" | \"md\"",
+            "default": "md",
+            "description": "sm · md.",
+            "required": false
+          }
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "name": "off",
+        "title": "Off",
+        "description": "Named by `label`.",
+        "path": "examples/switch/off.tsx",
+        "module": "@krizaka/ui/registry/examples/switch/off",
+        "code": "import { Switch } from \"@krizaka/ui/switch\";\n\nexport default function SwitchOff() {\n  return <Switch label=\"Autoplay\" />;\n}\n"
+      },
+      {
+        "name": "on",
+        "title": "On",
+        "description": "`defaultChecked` (or `checked` + `onCheckedChange`).",
+        "path": "examples/switch/on.tsx",
+        "module": "@krizaka/ui/registry/examples/switch/on",
+        "code": "import { Switch } from \"@krizaka/ui/switch\";\n\nexport default function SwitchOn() {\n  return <Switch label=\"Autoplay\" defaultChecked />;\n}\n"
+      },
+      {
+        "name": "disabled",
+        "title": "Disabled",
+        "description": "Off and on.",
+        "path": "examples/switch/disabled.tsx",
+        "module": "@krizaka/ui/registry/examples/switch/disabled",
+        "code": "import { Switch } from \"@krizaka/ui/switch\";\n\nexport default function SwitchDisabled() {\n  return (\n    <div className=\"flex gap-4\">\n      <Switch label=\"Autoplay\" disabled />\n      <Switch label=\"Loop\" disabled defaultChecked />\n    </div>\n  );\n}\n"
+      },
+      {
+        "name": "small",
+        "title": "Small",
+        "description": "`size=\"sm\"`.",
+        "path": "examples/switch/small.tsx",
+        "module": "@krizaka/ui/registry/examples/switch/small",
+        "code": "import { Switch } from \"@krizaka/ui/switch\";\n\nexport default function SwitchSmall() {\n  return <Switch label=\"Autoplay\" size=\"sm\" defaultChecked />;\n}\n"
+      },
+      {
+        "name": "with-label",
+        "title": "With a visible label",
+        "description": "A label and a hint on the same line.",
+        "path": "examples/switch/with-label.tsx",
+        "module": "@krizaka/ui/registry/examples/switch/with-label",
+        "code": "import { Field } from \"@krizaka/ui/field\";\nimport { Switch } from \"@krizaka/ui/switch\";\n\n// Named by a visible label (`Field.Label htmlFor`), with a hint.\nexport default function SwitchWithLabel() {\n  return (\n    <Field.Root className=\"w-80\">\n      <div className=\"flex items-center justify-between gap-4\">\n        <Field.Label htmlFor=\"digest\" className=\"text-sm text-fg\">\n          Weekly digest\n        </Field.Label>\n        <Switch id=\"digest\" defaultChecked aria-describedby=\"digest-hint\" />\n      </div>\n      <Field.Hint id=\"digest-hint\">One email on Monday with what you missed.</Field.Hint>\n    </Field.Root>\n  );\n}\n"
+      }
+    ]
+  },
+  "native": null,
   "files": [
+    {
+      "path": "meta.ts",
+      "content": "// The documentation of a component, carried by its code: each primitive has a `meta.ts` beside its source\n// (`src/<name>/meta.ts`; a component that exists only in React Native: `src/native/meta/<name>.ts`). Never built into\n// the package: `scripts/build-registry.mjs` reads them into `registry/<name>.json`, which krizaka.com renders as\n// /docs/ui/<name>, and `scripts/registry.test.mjs` fails when one is missing or incomplete.\n//\n// Why a typed module and not JSDoc tags: the fields are lists and links (`related`, `whenNotToUse[].use`, examples),\n// which a type checks and a comment does not; the file is plain data (erasable TypeScript), so Node reads it without a\n// compiler, and an editor completes it.\n\n/** Every documented component: the web primitives (one entry of the package each) and the native-only ones. */\nexport type ComponentName =\n  | \"alert\"\n  | \"avatar\"\n  | \"badge\"\n  | \"button\"\n  | \"card\"\n  | \"checkbox\"\n  | \"chip\"\n  | \"cn\"\n  | \"command\"\n  | \"confirm-button\"\n  | \"countdown\"\n  | \"dialog\"\n  | \"dropdown-menu\"\n  | \"empty-state\"\n  | \"field\"\n  | \"kbd\"\n  | \"page-header\"\n  | \"popover\"\n  | \"progress\"\n  | \"radio-group\"\n  | \"section-backdrop\"\n  | \"segmented\"\n  | \"separator\"\n  | \"skeleton\"\n  | \"slider\"\n  | \"slot\"\n  | \"spinner\"\n  | \"stat\"\n  | \"switch\"\n  | \"tabs\"\n  | \"theme\"\n  | \"toast\"\n  | \"tooltip\"\n  | \"txt\";\n\n/** Where a component exists: `@krizaka/ui/<name>` (web), `@krizaka/ui/native` (React Native), or both. */\nexport type Platform = \"web\" | \"native\" | \"both\";\n\n/** `stable`: its API only changes in a major. `beta`: it may still change in a minor. */\nexport type Status = \"stable\" | \"beta\";\n\n/** The group of the catalogue. */\nexport type Category = \"actions\" | \"forms\" | \"navigation\" | \"overlays\" | \"feedback\" | \"data-display\" | \"layout\" | \"foundations\";\n\n/**\n * A named example: the file `registry/examples/<component>/<name>.tsx` (web) or\n * `registry/examples/<component>/native/<name>.tsx` (React Native) — at most 40 lines, imported by the stories and\n * shown (live, with its code) by the documentation.\n */\nexport interface Example {\n  /** The file name, kebab-case (`primary`, `icon-button`). */\n  readonly name: string;\n  /** A short title (`Primary`, `Icon button`). */\n  readonly title: string;\n  /** One or two sentences: when this variant is the right one. */\n  readonly description: string;\n}\n\n/** One platform's side of a component. */\nexport interface PlatformDocs {\n  /** The names to import (`[\"Button\", \"IconButton\"]`): from `@krizaka/ui/<name>` on the web, `@krizaka/ui/native` in React Native. */\n  readonly imports: readonly string[];\n  /** The examples, in reading order; the first one is the component's preview. */\n  readonly examples: readonly Example[];\n}\n\n/** The React Native side: the same concept, and what differs from the web API. */\nexport interface NativeDocs extends PlatformDocs {\n  /** What differs from the web API (`label` instead of children…); empty for a native-only component. */\n  readonly differences: readonly string[];\n}\n\nexport interface KeyboardInteraction {\n  /** The keys, as written on a keyboard: `Space`, `Enter`, `Arrow keys`, `Esc`, `Tab`. */\n  readonly keys: string;\n  /** What they do. */\n  readonly action: string;\n}\n\nexport interface ComponentMeta {\n  /** The display name: `Button`, `Dropdown menu`. */\n  readonly title: string;\n  /** One sentence: what it is. */\n  readonly summary: string;\n  readonly status: Status;\n  readonly category: Category;\n  /** Must match the sides below: `both` ⇔ `web` and `native`. */\n  readonly platforms: Platform;\n  /** When to reach for it: concrete situations, one per item. */\n  readonly whenToUse: readonly string[];\n  /** When not to — and what to use instead (`use`), when another component is the answer. */\n  readonly whenNotToUse: readonly { readonly when: string; readonly use?: ComponentName }[];\n  /** How to use it well: wording, placement, composition. */\n  readonly bestPractices: readonly string[];\n  readonly accessibility: {\n    /** The keyboard, when it does more than Tab and Enter. */\n    readonly keyboard: readonly KeyboardInteraction[];\n    /** Roles, names and announcements: what the component does, what the app must provide. */\n    readonly notes: readonly string[];\n  };\n  /** The components a reader of this page should know about. */\n  readonly related: readonly ComponentName[];\n  readonly web?: PlatformDocs;\n  readonly native?: NativeDocs;\n}\n"
+    },
     {
       "path": "switch/index.ts",
       "content": "/** @krizaka/ui/switch — `Switch`, `switchVariants`. Client (\"use client\"). */\nexport { Switch, type SwitchProps, type SwitchVariants,switchVariants } from \"./switch\";\n"
     },
+    {
+      "path": "switch/meta.ts",
+      "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n  title: \"Switch\",\n  summary: \"An on/off setting that applies at once.\",\n  status: \"beta\",\n  category: \"forms\",\n  platforms: \"web\",\n  whenToUse: [\"For a setting that takes effect immediately: autoplay, notifications, a weekly digest.\"],\n  whenNotToUse: [\n    { when: \"For a choice submitted with a form, or an agreement.\", use: \"checkbox\" },\n    { when: \"For more than two states.\", use: \"radio-group\" },\n    { when: \"To run an action.\", use: \"button\" },\n  ],\n  bestPractices: [\n    \"Name the setting, not the state: “Autoplay”, not “Turn autoplay on”.\",\n    \"Put the label first and the switch at the end of the line (`Field.Label htmlFor`), with a hint when it helps.\",\n  ],\n  accessibility: {\n    keyboard: [{ keys: \"Space\", action: \"Toggles the switch.\" }],\n    notes: [\n      \"Radix Switch: `role=\\\"switch\\\"` with `aria-checked`.\",\n      \"`label` names it when no visible label does; otherwise use `Field.Label htmlFor` and `aria-describedby` for the hint.\",\n    ],\n  },\n  related: [\"checkbox\", \"field\", \"radio-group\"],\n  web: {\n    imports: [\"Switch\"],\n    examples: [\n      { name: \"off\", title: \"Off\", description: \"Named by `label`.\" },\n      { name: \"on\", title: \"On\", description: \"`defaultChecked` (or `checked` + `onCheckedChange`).\" },\n      { name: \"disabled\", title: \"Disabled\", description: \"Off and on.\" },\n      { name: \"small\", title: \"Small\", description: \"`size=\\\"sm\\\"`.\" },\n      { name: \"with-label\", title: \"With a visible label\", description: \"A label and a hint on the same line.\" },\n    ],\n  },\n} satisfies ComponentMeta;\n"
+    },
     {
       "path": "switch/switch.tsx",
       "content": "// Client. Radix Switch: role=\"switch\", aria-checked, Space and Enter toggle, a hidden input inside a form.\nimport { Switch as SwitchPrimitive } from \"radix-ui\";\nimport type * as React from \"react\";\nimport { tv, type VariantProps } from \"tailwind-variants\";\n\nexport const switchVariants = tv({\n  slots: {\n    root:\n      \"peer relative inline-flex shrink-0 cursor-pointer items-center rounded-full border border-transparent bg-fg-muted transition-colors \" +\n      \"focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-surface-0 \" +\n      \"disabled:cursor-not-allowed disabled:opacity-40 data-[state=checked]:bg-accent aria-invalid:border-danger\",\n    thumb:\n      \"pointer-events-none block rounded-full bg-fg-on-media shadow-sm transition-transform data-[state=unchecked]:translate-x-0.5 motion-reduce:transition-none\",\n  },\n  variants: {\n    size: {\n      sm: { root: \"h-5 w-9\", thumb: \"h-4 w-4 data-[state=checked]:translate-x-[1.125rem]\" },\n      md: { root: \"h-6 w-11\", thumb: \"h-5 w-5 data-[state=checked]:translate-x-[1.375rem]\" },\n    },\n  },\n  defaultVariants: { size: \"md\" },\n});\n\nexport type SwitchVariants = VariantProps<typeof switchVariants>;\n\ntype Named =\n  | {\n      /** The accessible name — required when no visible label names it, passed translated. */\n      label: string;\n    }\n  /** Named by a visible `<label htmlFor={id}>` (e.g. `Field.Label`). */\n  | { label?: undefined; id: string }\n  /** Named by another element. */\n  | { label?: undefined; \"aria-labelledby\": string };\n\nexport type SwitchProps = Omit<React.ComponentProps<typeof SwitchPrimitive.Root>, \"children\"> &\n  SwitchVariants &\n  Named & {\n    /**\n     * sm · md.\n     * @default \"md\"\n     */\n    size?: SwitchVariants[\"size\"];\n    /** Marks it invalid: aria-invalid and data-invalid. */\n    invalid?: boolean;\n  };\n\n/** An on/off switch: `checked`/`defaultChecked` + `onCheckedChange`. */\nexport function Switch({ label, size, invalid, className, ...props }: SwitchProps) {\n  const s = switchVariants({ size });\n  return (\n    <SwitchPrimitive.Root\n      aria-label={label}\n      aria-invalid={invalid || undefined}\n      data-invalid={invalid ? \"\" : undefined}\n      className={s.root({ className })}\n      {...props}\n    >\n      <SwitchPrimitive.Thumb className={s.thumb()} />\n    </SwitchPrimitive.Root>\n  );\n}\n"
@@ -18,8 +145,8 @@
   ],
   "registryDependencies": [],
   "demo": {
-    "path": "demos/switch.tsx",
-    "content": "import { Switch } from \"@krizaka/ui/switch\";\n\nexport default function SwitchDemo() {\n  return <Switch label=\"Autoplay\" />;\n}\n"
+    "path": "examples/switch/off.tsx",
+    "content": "import { Switch } from \"@krizaka/ui/switch\";\n\nexport default function SwitchOff() {\n  return <Switch label=\"Autoplay\" />;\n}\n"
   },
   "props": [
     {

package/registry/tabs.json

@@ -1,12 +1,126 @@
 {
   "name": "tabs",
   "type": "primitive",
-  "description": "`Tabs.Root/List/Trigger/Content` (variant underline · segmented · pills), `tabs` (the slots). Client (\"use client\").",
+  "title": "Tabs",
+  "summary": "Views of the same page, one at a time: underlined sections, a segmented switch or pills.",
+  "description": "Views of the same page, one at a time: underlined sections, a segmented switch or pills.",
+  "status": "beta",
+  "category": "navigation",
+  "platforms": "web",
+  "whenToUse": [
+    "To split a page into sections the user switches between without leaving it: videos, stories, about.",
+    "`variant=\"segmented\"` for a view switch (grid, list); `pills` for a feed's sections."
+  ],
+  "whenNotToUse": [
+    {
+      "when": "For a filter that narrows a list.",
+      "use": "chip"
+    },
+    {
+      "when": "To go to other pages: use links in the navigation."
+    },
+    {
+      "when": "For a choice in a form.",
+      "use": "radio-group"
+    }
+  ],
+  "bestPractices": [
+    "Short labels of one or two words; the active one should be clear without colour.",
+    "Keep the URL in sync with the active tab when a tab is worth sharing."
+  ],
+  "accessibility": {
+    "keyboard": [
+      {
+        "keys": "Tab",
+        "action": "Moves to the active tab, then into its panel."
+      },
+      {
+        "keys": "Arrow keys / Home / End",
+        "action": "Move between tabs and activate them."
+      }
+    ],
+    "notes": [
+      "Radix Tabs: `tablist`, `tab` with `aria-selected` and `aria-controls`, `tabpanel`; name the list with `aria-label`.",
+      "A disabled tab is skipped."
+    ]
+  },
+  "related": [
+    "chip",
+    "segmented",
+    "radio-group"
+  ],
+  "web": {
+    "entry": "@krizaka/ui/tabs",
+    "import": "import { Tabs } from \"@krizaka/ui/tabs\";",
+    "props": [
+      {
+        "component": "TabsRoot",
+        "description": "`value`/`defaultValue` + `onValueChange`, `orientation` (horizontal by default), `variant` for the list.",
+        "props": [
+          {
+            "name": "variant",
+            "type": "\"underline\" | \"segmented\" | \"pills\"",
+            "default": "underline",
+            "description": "underline (the sections of a page) · segmented (a view switch) · pills (a feed's sections).",
+            "required": false
+          }
+        ]
+      },
+      {
+        "component": "TabsList",
+        "description": "The tabs. Name it (`aria-label`) when no heading says what it switches.",
+        "props": []
+      }
+    ],
+    "examples": [
+      {
+        "name": "underline",
+        "title": "Underline",
+        "description": "The sections of a page; a disabled tab is skipped.",
+        "path": "examples/tabs/underline.tsx",
+        "module": "@krizaka/ui/registry/examples/tabs/underline",
+        "code": "import { Tabs } from \"@krizaka/ui/tabs\";\n\nexport default function TabsUnderline() {\n  return (\n    <Tabs.Root defaultValue=\"videos\">\n      <Tabs.List aria-label=\"Profile\">\n        <Tabs.Trigger value=\"videos\">Videos</Tabs.Trigger>\n        <Tabs.Trigger value=\"stories\">Stories</Tabs.Trigger>\n        <Tabs.Trigger value=\"collections\">Collections</Tabs.Trigger>\n        <Tabs.Trigger value=\"about\" disabled>\n          About\n        </Tabs.Trigger>\n      </Tabs.List>\n      <Tabs.Content value=\"videos\" className=\"text-sm text-fg-secondary\">\n        Twelve videos, newest first.\n      </Tabs.Content>\n      <Tabs.Content value=\"stories\" className=\"text-sm text-fg-secondary\">\n        Stories of the last 24 hours.\n      </Tabs.Content>\n      <Tabs.Content value=\"collections\" className=\"text-sm text-fg-secondary\">\n        Three public collections.\n      </Tabs.Content>\n      <Tabs.Content value=\"about\" className=\"text-sm text-fg-secondary\">\n        About this channel.\n      </Tabs.Content>\n    </Tabs.Root>\n  );\n}\n"
+      },
+      {
+        "name": "segmented",
+        "title": "Segmented",
+        "description": "A view switch: equal segments in a track.",
+        "path": "examples/tabs/segmented.tsx",
+        "module": "@krizaka/ui/registry/examples/tabs/segmented",
+        "code": "import { Tabs } from \"@krizaka/ui/tabs\";\n\n// A view switch: equal segments in a track, the active one filled.\nexport default function TabsSegmented() {\n  return (\n    <Tabs.Root variant=\"segmented\" defaultValue=\"grid\">\n      <Tabs.List aria-label=\"View\">\n        <Tabs.Trigger value=\"grid\">Grid</Tabs.Trigger>\n        <Tabs.Trigger value=\"list\">List</Tabs.Trigger>\n        <Tabs.Trigger value=\"cinema\">Cinema</Tabs.Trigger>\n      </Tabs.List>\n      <Tabs.Content value=\"grid\" className=\"text-sm text-fg-secondary\">\n        Four columns of cards.\n      </Tabs.Content>\n      <Tabs.Content value=\"list\" className=\"text-sm text-fg-secondary\">\n        One line per video.\n      </Tabs.Content>\n      <Tabs.Content value=\"cinema\" className=\"text-sm text-fg-secondary\">\n        One large player per video.\n      </Tabs.Content>\n    </Tabs.Root>\n  );\n}\n"
+      },
+      {
+        "name": "pills",
+        "title": "Pills",
+        "description": "A feed's sections, scrolling sideways on a phone.",
+        "path": "examples/tabs/pills.tsx",
+        "module": "@krizaka/ui/registry/examples/tabs/pills",
+        "code": "import { Tabs } from \"@krizaka/ui/tabs\";\n\n// A feed's sections: pills that scroll sideways on a phone.\nexport default function TabsPills() {\n  return (\n    <Tabs.Root variant=\"pills\" defaultValue=\"videos\">\n      <Tabs.List aria-label=\"Profile\">\n        <Tabs.Trigger value=\"videos\">Videos</Tabs.Trigger>\n        <Tabs.Trigger value=\"stories\">Stories</Tabs.Trigger>\n        <Tabs.Trigger value=\"collections\">Collections</Tabs.Trigger>\n      </Tabs.List>\n      <Tabs.Content value=\"videos\" className=\"text-sm text-fg-secondary\">\n        Twelve videos, newest first.\n      </Tabs.Content>\n      <Tabs.Content value=\"stories\" className=\"text-sm text-fg-secondary\">\n        Stories of the last 24 hours.\n      </Tabs.Content>\n      <Tabs.Content value=\"collections\" className=\"text-sm text-fg-secondary\">\n        Three public collections.\n      </Tabs.Content>\n    </Tabs.Root>\n  );\n}\n"
+      },
+      {
+        "name": "vertical",
+        "title": "Vertical",
+        "description": "`orientation=\"vertical\"`: the list on the side.",
+        "path": "examples/tabs/vertical.tsx",
+        "module": "@krizaka/ui/registry/examples/tabs/vertical",
+        "code": "import { Tabs } from \"@krizaka/ui/tabs\";\n\n// `orientation=\"vertical\"`: up and down arrows, the list on the side.\nexport default function TabsVertical() {\n  return (\n    <Tabs.Root orientation=\"vertical\" defaultValue=\"videos\">\n      <Tabs.List aria-label=\"Profile\">\n        <Tabs.Trigger value=\"videos\">Videos</Tabs.Trigger>\n        <Tabs.Trigger value=\"stories\">Stories</Tabs.Trigger>\n        <Tabs.Trigger value=\"collections\">Collections</Tabs.Trigger>\n      </Tabs.List>\n      <Tabs.Content value=\"videos\" className=\"text-sm text-fg-secondary\">\n        Twelve videos, newest first.\n      </Tabs.Content>\n      <Tabs.Content value=\"stories\" className=\"text-sm text-fg-secondary\">\n        Stories of the last 24 hours.\n      </Tabs.Content>\n      <Tabs.Content value=\"collections\" className=\"text-sm text-fg-secondary\">\n        Three public collections.\n      </Tabs.Content>\n    </Tabs.Root>\n  );\n}\n"
+      }
+    ]
+  },
+  "native": null,
   "files": [
+    {
+      "path": "meta.ts",
+      "content": "// The documentation of a component, carried by its code: each primitive has a `meta.ts` beside its source\n// (`src/<name>/meta.ts`; a component that exists only in React Native: `src/native/meta/<name>.ts`). Never built into\n// the package: `scripts/build-registry.mjs` reads them into `registry/<name>.json`, which krizaka.com renders as\n// /docs/ui/<name>, and `scripts/registry.test.mjs` fails when one is missing or incomplete.\n//\n// Why a typed module and not JSDoc tags: the fields are lists and links (`related`, `whenNotToUse[].use`, examples),\n// which a type checks and a comment does not; the file is plain data (erasable TypeScript), so Node reads it without a\n// compiler, and an editor completes it.\n\n/** Every documented component: the web primitives (one entry of the package each) and the native-only ones. */\nexport type ComponentName =\n  | \"alert\"\n  | \"avatar\"\n  | \"badge\"\n  | \"button\"\n  | \"card\"\n  | \"checkbox\"\n  | \"chip\"\n  | \"cn\"\n  | \"command\"\n  | \"confirm-button\"\n  | \"countdown\"\n  | \"dialog\"\n  | \"dropdown-menu\"\n  | \"empty-state\"\n  | \"field\"\n  | \"kbd\"\n  | \"page-header\"\n  | \"popover\"\n  | \"progress\"\n  | \"radio-group\"\n  | \"section-backdrop\"\n  | \"segmented\"\n  | \"separator\"\n  | \"skeleton\"\n  | \"slider\"\n  | \"slot\"\n  | \"spinner\"\n  | \"stat\"\n  | \"switch\"\n  | \"tabs\"\n  | \"theme\"\n  | \"toast\"\n  | \"tooltip\"\n  | \"txt\";\n\n/** Where a component exists: `@krizaka/ui/<name>` (web), `@krizaka/ui/native` (React Native), or both. */\nexport type Platform = \"web\" | \"native\" | \"both\";\n\n/** `stable`: its API only changes in a major. `beta`: it may still change in a minor. */\nexport type Status = \"stable\" | \"beta\";\n\n/** The group of the catalogue. */\nexport type Category = \"actions\" | \"forms\" | \"navigation\" | \"overlays\" | \"feedback\" | \"data-display\" | \"layout\" | \"foundations\";\n\n/**\n * A named example: the file `registry/examples/<component>/<name>.tsx` (web) or\n * `registry/examples/<component>/native/<name>.tsx` (React Native) — at most 40 lines, imported by the stories and\n * shown (live, with its code) by the documentation.\n */\nexport interface Example {\n  /** The file name, kebab-case (`primary`, `icon-button`). */\n  readonly name: string;\n  /** A short title (`Primary`, `Icon button`). */\n  readonly title: string;\n  /** One or two sentences: when this variant is the right one. */\n  readonly description: string;\n}\n\n/** One platform's side of a component. */\nexport interface PlatformDocs {\n  /** The names to import (`[\"Button\", \"IconButton\"]`): from `@krizaka/ui/<name>` on the web, `@krizaka/ui/native` in React Native. */\n  readonly imports: readonly string[];\n  /** The examples, in reading order; the first one is the component's preview. */\n  readonly examples: readonly Example[];\n}\n\n/** The React Native side: the same concept, and what differs from the web API. */\nexport interface NativeDocs extends PlatformDocs {\n  /** What differs from the web API (`label` instead of children…); empty for a native-only component. */\n  readonly differences: readonly string[];\n}\n\nexport interface KeyboardInteraction {\n  /** The keys, as written on a keyboard: `Space`, `Enter`, `Arrow keys`, `Esc`, `Tab`. */\n  readonly keys: string;\n  /** What they do. */\n  readonly action: string;\n}\n\nexport interface ComponentMeta {\n  /** The display name: `Button`, `Dropdown menu`. */\n  readonly title: string;\n  /** One sentence: what it is. */\n  readonly summary: string;\n  readonly status: Status;\n  readonly category: Category;\n  /** Must match the sides below: `both` ⇔ `web` and `native`. */\n  readonly platforms: Platform;\n  /** When to reach for it: concrete situations, one per item. */\n  readonly whenToUse: readonly string[];\n  /** When not to — and what to use instead (`use`), when another component is the answer. */\n  readonly whenNotToUse: readonly { readonly when: string; readonly use?: ComponentName }[];\n  /** How to use it well: wording, placement, composition. */\n  readonly bestPractices: readonly string[];\n  readonly accessibility: {\n    /** The keyboard, when it does more than Tab and Enter. */\n    readonly keyboard: readonly KeyboardInteraction[];\n    /** Roles, names and announcements: what the component does, what the app must provide. */\n    readonly notes: readonly string[];\n  };\n  /** The components a reader of this page should know about. */\n  readonly related: readonly ComponentName[];\n  readonly web?: PlatformDocs;\n  readonly native?: NativeDocs;\n}\n"
+    },
     {
       "path": "tabs/index.ts",
       "content": "/** @krizaka/ui/tabs — `Tabs.Root/List/Trigger/Content` (variant underline · segmented · pills), `tabs` (the slots). Client (\"use client\"). */\nexport { Tabs, tabs, TabsContent, TabsList, TabsRoot, type TabsRootProps, TabsTrigger, type TabsVariants } from \"./tabs\";\n"
     },
+    {
+      "path": "tabs/meta.ts",
+      "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n  title: \"Tabs\",\n  summary: \"Views of the same page, one at a time: underlined sections, a segmented switch or pills.\",\n  status: \"beta\",\n  category: \"navigation\",\n  platforms: \"web\",\n  whenToUse: [\n    \"To split a page into sections the user switches between without leaving it: videos, stories, about.\",\n    \"`variant=\\\"segmented\\\"` for a view switch (grid, list); `pills` for a feed's sections.\",\n  ],\n  whenNotToUse: [\n    { when: \"For a filter that narrows a list.\", use: \"chip\" },\n    { when: \"To go to other pages: use links in the navigation.\" },\n    { when: \"For a choice in a form.\", use: \"radio-group\" },\n  ],\n  bestPractices: [\n    \"Short labels of one or two words; the active one should be clear without colour.\",\n    \"Keep the URL in sync with the active tab when a tab is worth sharing.\",\n  ],\n  accessibility: {\n    keyboard: [\n      { keys: \"Tab\", action: \"Moves to the active tab, then into its panel.\" },\n      { keys: \"Arrow keys / Home / End\", action: \"Move between tabs and activate them.\" },\n    ],\n    notes: [\n      \"Radix Tabs: `tablist`, `tab` with `aria-selected` and `aria-controls`, `tabpanel`; name the list with `aria-label`.\",\n      \"A disabled tab is skipped.\",\n    ],\n  },\n  related: [\"chip\", \"segmented\", \"radio-group\"],\n  web: {\n    imports: [\"Tabs\"],\n    examples: [\n      { name: \"underline\", title: \"Underline\", description: \"The sections of a page; a disabled tab is skipped.\" },\n      { name: \"segmented\", title: \"Segmented\", description: \"A view switch: equal segments in a track.\" },\n      { name: \"pills\", title: \"Pills\", description: \"A feed's sections, scrolling sideways on a phone.\" },\n      { name: \"vertical\", title: \"Vertical\", description: \"`orientation=\\\"vertical\\\"`: the list on the side.\" },\n    ],\n  },\n} satisfies ComponentMeta;\n"
+    },
     {
       "path": "tabs/tabs.tsx",
       "content": "// Client (a context). Radix Tabs does the roles (tablist, tab, tabpanel), the aria-selected / aria-controls wiring,\n// the roving focus (arrows, Home, End) and automatic activation: this file only holds the three looks.\nimport { Tabs as TabsPrimitive } from \"radix-ui\";\nimport * as React from \"react\";\nimport { tv, type VariantProps } from \"tailwind-variants\";\n\nexport const tabs = tv({\n  slots: {\n    root: \"flex gap-4 data-[orientation=horizontal]:flex-col data-[orientation=vertical]:flex-row\",\n    list: \"flex shrink-0 data-[orientation=vertical]:flex-col\",\n    trigger:\n      \"inline-flex shrink-0 select-none items-center justify-center gap-2 whitespace-nowrap font-semibold transition-colors \" +\n      \"focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-40\",\n    content: \"kz-fade min-w-0 flex-1 rounded-lg focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring\",\n  },\n  variants: {\n    variant: {\n      /* The section of a page: a line under the list, the active tab underlined in the accent. */\n      underline: {\n        list: \"gap-1 border-border-default data-[orientation=horizontal]:border-b data-[orientation=vertical]:border-r\",\n        trigger:\n          \"relative rounded-md px-3 py-2.5 text-sm text-fg-secondary hover:text-fg data-[state=active]:text-fg \" +\n          \"after:absolute after:rounded-full after:bg-transparent data-[state=active]:after:bg-accent \" +\n          \"data-[orientation=horizontal]:after:inset-x-2 data-[orientation=horizontal]:after:-bottom-px data-[orientation=horizontal]:after:h-0.5 \" +\n          \"data-[orientation=vertical]:justify-start data-[orientation=vertical]:after:inset-y-1.5 data-[orientation=vertical]:after:-right-px data-[orientation=vertical]:after:w-0.5\",\n      },\n      /* A view switch: equal segments in a track, the active one filled. */\n      segmented: {\n        list: \"inline-grid auto-cols-fr grid-flow-col gap-1 self-start rounded-xl border border-border-default bg-surface-1 p-1 data-[orientation=vertical]:grid-flow-row\",\n        trigger:\n          \"min-h-8 rounded-lg px-3 py-1.5 text-xs text-fg-secondary hover:bg-surface-2 hover:text-fg \" +\n          \"data-[state=active]:bg-accent data-[state=active]:text-on-accent data-[state=active]:shadow-sm data-[state=active]:hover:bg-accent\",\n      },\n      /* Pills that scroll sideways on a phone: a feed's sections. */\n      pills: {\n        list: \"gap-1.5 overflow-x-auto overscroll-x-contain [scrollbar-width:none] data-[orientation=horizontal]:pb-1\",\n        trigger:\n          \"h-9 rounded-full border border-border-default bg-surface-1 px-4 text-xs text-fg-secondary hover:border-border-strong hover:text-fg \" +\n          \"data-[state=active]:border-accent data-[state=active]:bg-accent-soft data-[state=active]:text-fg\",\n      },\n    },\n  },\n  defaultVariants: { variant: \"underline\" },\n});\n\nexport type TabsVariants = VariantProps<typeof tabs>;\ntype Variant = NonNullable<TabsVariants[\"variant\"]>;\n\nconst VariantContext = React.createContext<Variant>(\"underline\");\n\nexport type TabsRootProps = React.ComponentProps<typeof TabsPrimitive.Root> & {\n  /** underline (the sections of a page) · segmented (a view switch) · pills (a feed's sections). */\n  variant?: TabsVariants[\"variant\"];\n};\n\n/** `value`/`defaultValue` + `onValueChange`, `orientation` (horizontal by default), `variant` for the list. */\nexport function TabsRoot({ variant = \"underline\", className, ...props }: TabsRootProps) {\n  return (\n    <VariantContext.Provider value={variant}>\n      <TabsPrimitive.Root data-variant={variant} className={tabs({ variant }).root({ className })} {...props} />\n    </VariantContext.Provider>\n  );\n}\n\n/** The tabs. Name it (`aria-label`) when no heading says what it switches. */\nexport function TabsList({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.List>) {\n  const variant = React.useContext(VariantContext);\n  return <TabsPrimitive.List data-variant={variant} className={tabs({ variant }).list({ className })} {...props} />;\n}\n\nexport function TabsTrigger({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Trigger>) {\n  const variant = React.useContext(VariantContext);\n  return <TabsPrimitive.Trigger className={tabs({ variant }).trigger({ className })} {...props} />;\n}\n\nexport function TabsContent({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Content>) {\n  return <TabsPrimitive.Content className={tabs().content({ className })} {...props} />;\n}\n\n/** `Tabs.Root/List/Trigger/Content` — `variant` underline · segmented · pills on the root. */\nexport const Tabs = { Root: TabsRoot, List: TabsList, Trigger: TabsTrigger, Content: TabsContent };\n"
@@ -18,8 +132,8 @@
   ],
   "registryDependencies": [],
   "demo": {
-    "path": "demos/tabs.tsx",
-    "content": "import { Tabs } from \"@krizaka/ui/tabs\";\n\nexport default function TabsDemo() {\n  return (\n    <Tabs.Root defaultValue=\"videos\">\n      <Tabs.List aria-label=\"Profile\">\n        <Tabs.Trigger value=\"videos\">Videos</Tabs.Trigger>\n        <Tabs.Trigger value=\"stories\">Stories</Tabs.Trigger>\n        <Tabs.Trigger value=\"collections\">Collections</Tabs.Trigger>\n        <Tabs.Trigger value=\"about\" disabled>\n          About\n        </Tabs.Trigger>\n      </Tabs.List>\n      <Tabs.Content value=\"videos\" className=\"text-sm text-fg-secondary\">\n        Twelve videos, newest first.\n      </Tabs.Content>\n      <Tabs.Content value=\"stories\" className=\"text-sm text-fg-secondary\">\n        Stories of the last 24 hours.\n      </Tabs.Content>\n      <Tabs.Content value=\"collections\" className=\"text-sm text-fg-secondary\">\n        Three public collections.\n      </Tabs.Content>\n      <Tabs.Content value=\"about\" className=\"text-sm text-fg-secondary\">\n        About this channel.\n      </Tabs.Content>\n    </Tabs.Root>\n  );\n}\n"
+    "path": "examples/tabs/underline.tsx",
+    "content": "import { Tabs } from \"@krizaka/ui/tabs\";\n\nexport default function TabsUnderline() {\n  return (\n    <Tabs.Root defaultValue=\"videos\">\n      <Tabs.List aria-label=\"Profile\">\n        <Tabs.Trigger value=\"videos\">Videos</Tabs.Trigger>\n        <Tabs.Trigger value=\"stories\">Stories</Tabs.Trigger>\n        <Tabs.Trigger value=\"collections\">Collections</Tabs.Trigger>\n        <Tabs.Trigger value=\"about\" disabled>\n          About\n        </Tabs.Trigger>\n      </Tabs.List>\n      <Tabs.Content value=\"videos\" className=\"text-sm text-fg-secondary\">\n        Twelve videos, newest first.\n      </Tabs.Content>\n      <Tabs.Content value=\"stories\" className=\"text-sm text-fg-secondary\">\n        Stories of the last 24 hours.\n      </Tabs.Content>\n      <Tabs.Content value=\"collections\" className=\"text-sm text-fg-secondary\">\n        Three public collections.\n      </Tabs.Content>\n      <Tabs.Content value=\"about\" className=\"text-sm text-fg-secondary\">\n        About this channel.\n      </Tabs.Content>\n    </Tabs.Root>\n  );\n}\n"
   },
   "props": [
     {