@krizaka/ui 2.0.0-beta.4 → 2.0.0-beta.6

package/registry/toast.json

@@ -1,12 +1,199 @@
 {
   "name": "toast",
   "type": "primitive",
-  "description": "`Toaster` (sonner, styled by roles), `toast`. Client (\"use client\").",
+  "title": "Toast",
+  "summary": "A short message that comes and goes: `toast()` from anywhere, one `Toaster` per app.",
+  "description": "A short message that comes and goes: `toast()` from anywhere, one `Toaster` per app.",
+  "status": "stable",
+  "category": "feedback",
+  "platforms": "both",
+  "whenToUse": [
+    "To confirm the result of an action: saved, sent, payment received.",
+    "For an event the user did not trigger but should know: a new follower, a live auction.",
+    "With an action (“Retry”, “Undo”) when there is one obvious next step."
+  ],
+  "whenNotToUse": [
+    {
+      "when": "For a message that must stay until the situation changes.",
+      "use": "alert"
+    },
+    {
+      "when": "When the user must answer.",
+      "use": "dialog"
+    },
+    {
+      "when": "To report a form's errors: show them next to the fields.",
+      "use": "field"
+    }
+  ],
+  "bestPractices": [
+    "Mount one `Toaster` in the root layout, with its `label` and `closeLabel` translated.",
+    "A title in a few words, a description only if it adds something.",
+    "Never put the only way to do something in a toast: it goes away."
+  ],
+  "accessibility": {
+    "keyboard": [
+      {
+        "keys": "F8",
+        "action": "Moves the focus to the toasts region (sonner's hotkey)."
+      },
+      {
+        "keys": "Tab / Enter",
+        "action": "Reach and press a toast's action or close button."
+      }
+    ],
+    "notes": [
+      "The region is a landmark named by `label`; toasts are announced politely.",
+      "Toasts pause while hovered or focused."
+    ]
+  },
+  "related": [
+    "alert",
+    "dialog",
+    "confirm-button"
+  ],
+  "web": {
+    "entry": "@krizaka/ui/toast",
+    "import": "import { toast, Toaster } from \"@krizaka/ui/toast\";",
+    "props": [
+      {
+        "component": "Toaster",
+        "description": "Mount once, in the root layout. Then call `toast()`, `toast.success/warning/error/info`, `toast.custom(…)`.",
+        "props": [
+          {
+            "name": "closeLabel",
+            "type": "string",
+            "default": null,
+            "description": "The accessible name of each toast's close button — passed translated.",
+            "required": true
+          },
+          {
+            "name": "label",
+            "type": "string",
+            "default": null,
+            "description": "The accessible name of the notifications region (sonner's `containerAriaLabel`) — passed translated.",
+            "required": true
+          },
+          {
+            "name": "toastOptions",
+            "type": "Omit<ToastOptions, \"unstyled\" | \"closeButtonAriaLabel\">",
+            "default": null,
+            "description": "Extra options for every toast (duration, a className); the class names are merged with the platform's.",
+            "required": false
+          }
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "name": "tones",
+        "title": "Tones",
+        "description": "Default, success, warning and error with an action.",
+        "path": "examples/toast/tones.tsx",
+        "module": "@krizaka/ui/registry/examples/toast/tones",
+        "code": "\"use client\";\n\nimport { Button } from \"@krizaka/ui/button\";\nimport { toast, Toaster } from \"@krizaka/ui/toast\";\nimport { useEffect } from \"react\";\n\n// Each toaster has its own `id`: the toasts of this demo stay in this demo's toaster.\nconst toasterId = \"tones\";\nconst show = () => {\n  toast(\"Draft saved\", { toasterId, description: \"Autosaved a moment ago.\" });\n  toast.success(\"Payment received\", { toasterId, description: \"€12.00 from @maya.\" });\n  toast.warning(\"Your balance is low\", { toasterId, description: \"Two tips left before a top-up.\" });\n  toast.error(\"Upload failed\", { toasterId, description: \"The connection dropped at 64 %.\", action: { label: \"Retry\", onClick: () => {} } });\n};\n\n/** `defaultOpen`: the toasts show at once and stay (the screenshot); otherwise the button shows them. */\nexport default function ToastTones({ defaultOpen = false }: { defaultOpen?: boolean }) {\n  useEffect(() => {\n    if (!defaultOpen) return;\n    toast.dismiss();\n    show();\n  }, [defaultOpen]);\n  return (\n    <>\n      <Toaster id={toasterId} label=\"Notifications\" closeLabel=\"Dismiss\" position=\"bottom-right\" expand visibleToasts={4} duration={defaultOpen ? Number.POSITIVE_INFINITY : undefined} />\n      <Button variant=\"outline\" onClick={show}>\n        Show again\n      </Button>\n    </>\n  );\n}\n"
+      },
+      {
+        "name": "custom",
+        "title": "Custom",
+        "description": "`toast.custom`: your JSX in the platform's shell.",
+        "path": "examples/toast/custom.tsx",
+        "module": "@krizaka/ui/registry/examples/toast/custom",
+        "code": "\"use client\";\n\nimport { Avatar } from \"@krizaka/ui/avatar\";\nimport { Button } from \"@krizaka/ui/button\";\nimport { toast, Toaster } from \"@krizaka/ui/toast\";\nimport { useEffect } from \"react\";\n\n// `toast.custom`: your JSX in the platform's shell — a live notification. One `Toaster` per app, in the root layout.\nconst show = () =>\n  toast.custom(\n    () => (\n      <div className=\"flex items-center gap-3\">\n        <Avatar fallback=\"MA\" size=\"sm\" />\n        <div className=\"flex flex-col\">\n          <span className=\"text-sm font-semibold text-fg\">Maya started following you</span>\n          <span className=\"text-xs font-normal text-fg-secondary\">Just now</span>\n        </div>\n      </div>\n    ),\n    { toasterId: \"custom\" },\n  );\n\nexport default function ToastCustom({ defaultOpen = false }: { defaultOpen?: boolean }) {\n  useEffect(() => {\n    if (defaultOpen) show();\n  }, [defaultOpen]);\n  return (\n    <>\n      <Toaster id=\"custom\" label=\"Notifications\" closeLabel=\"Dismiss\" position=\"bottom-right\" duration={defaultOpen ? Number.POSITIVE_INFINITY : undefined} />\n      <Button variant=\"outline\" onClick={show}>\n        Show a notification\n      </Button>\n    </>\n  );\n}\n"
+      }
+    ]
+  },
+  "native": {
+    "entry": "@krizaka/ui/native",
+    "import": "import { toast, Toaster } from \"@krizaka/ui/native\";",
+    "differences": [
+      "`Toaster` takes `offset` (the safe-area inset) instead of a position; mount it inside `ThemeProvider`.",
+      "Actions take `onPress`; a toast takes `onPress` to open what it is about.",
+      "No `toast.custom`: an `icon` before the text instead."
+    ],
+    "props": [
+      {
+        "component": "Toaster",
+        "description": "Mount once, at the root (inside `ThemeProvider`). Then call `toast()` from anywhere.",
+        "props": [
+          {
+            "name": "closeLabel",
+            "type": "string",
+            "default": null,
+            "description": "The accessible name of each toast's close button — passed translated.",
+            "required": true
+          },
+          {
+            "name": "duration",
+            "type": "number",
+            "default": "6000",
+            "description": "Default milliseconds on screen.",
+            "required": false
+          },
+          {
+            "name": "max",
+            "type": "number",
+            "default": "3",
+            "description": "At most this many on screen; the oldest leave first.",
+            "required": false
+          },
+          {
+            "name": "offset",
+            "type": "number",
+            "default": "12",
+            "description": "Distance from the edge, e.g. the safe-area inset + a margin (no safe-area dependency here).",
+            "required": false
+          },
+          {
+            "name": "position",
+            "type": "\"top\" | \"bottom\"",
+            "default": "top",
+            "description": "Where the toasts stack: `top` (default) or `bottom`.",
+            "required": false
+          }
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "name": "tones",
+        "title": "Tones",
+        "description": "Default, success, and error with an action.",
+        "path": "examples/toast/native/tones.tsx",
+        "module": "@krizaka/ui/registry/examples/toast/native/tones",
+        "code": "import { Button, toast, Toaster } from \"@krizaka/ui/native\";\nimport { useEffect } from \"react\";\nimport { View } from \"react-native\";\n\nconst show = () => {\n  toast(\"Draft saved\", { description: \"Autosaved a moment ago.\" });\n  toast.success(\"Payment received\", { description: \"€12.00 from @maya.\" });\n  toast.error(\"Upload failed\", { description: \"The connection dropped at 64 %.\", action: { label: \"Retry\", onPress: () => {} } });\n};\n\n// One `Toaster` at the root of the app (`offset` = the safe-area inset); `toast()` from anywhere.\nexport default function NativeToastTones({ defaultOpen = false }: { defaultOpen?: boolean }) {\n  useEffect(() => {\n    if (!defaultOpen) return;\n    toast.dismiss();\n    show();\n    return () => toast.dismiss();\n  }, [defaultOpen]);\n  return (\n    <View style={{ width: 360, height: 260, justifyContent: \"flex-end\" }}>\n      <Button variant=\"outline\" label=\"Show the toasts\" onPress={show} />\n      <Toaster closeLabel=\"Dismiss\" duration={defaultOpen ? Number.POSITIVE_INFINITY : undefined} />\n    </View>\n  );\n}\n",
+        "screenshots": {
+          "dark": "examples/toast/native/tones.dark.png",
+          "light": "examples/toast/native/tones.light.png"
+        }
+      },
+      {
+        "name": "notification",
+        "title": "Notification",
+        "description": "An icon, tap to open it; `id` shows it once.",
+        "path": "examples/toast/native/notification.tsx",
+        "module": "@krizaka/ui/registry/examples/toast/native/notification",
+        "code": "import { Button, toast, Toaster, useTheme } from \"@krizaka/ui/native\";\nimport { useEffect } from \"react\";\nimport { View } from \"react-native\";\nimport Svg, { Path } from \"react-native-svg\";\n\nfunction BellIcon({ color }: { color: string }) {\n  return (\n    <Svg width={16} height={16} viewBox=\"0 0 24 24\" fill=\"none\" stroke={color} strokeWidth={2} strokeLinecap=\"round\" strokeLinejoin=\"round\">\n      <Path d=\"M6 8a6 6 0 0 1 12 0c0 7 3 9 3 9H3s3-2 3-9M10.3 21a1.94 1.94 0 0 0 3.4 0\" />\n    </Svg>\n  );\n}\n\n// `id` replaces a toast already shown (a notification shown once); `onPress` opens what it is about.\nexport default function NativeToastNotification({ defaultOpen = false }: { defaultOpen?: boolean }) {\n  const { theme } = useTheme();\n  const show = () => toast(\"@maya started a live auction\", { id: \"n-42\", icon: <BellIcon color={theme.textPrimary} />, onPress: () => {} });\n  useEffect(() => {\n    if (!defaultOpen) return;\n    toast.dismiss();\n    show();\n    return () => toast.dismiss();\n  }, [defaultOpen]); // eslint-disable-line react-hooks/exhaustive-deps -- shown once, at load\n  return (\n    <View style={{ width: 360, height: 260, justifyContent: \"flex-end\" }}>\n      <Button variant=\"outline\" label=\"Show a notification\" onPress={show} />\n      <Toaster closeLabel=\"Dismiss\" duration={defaultOpen ? Number.POSITIVE_INFINITY : undefined} />\n    </View>\n  );\n}\n",
+        "screenshots": {
+          "dark": "examples/toast/native/notification.dark.png",
+          "light": "examples/toast/native/notification.light.png"
+        }
+      }
+    ]
+  },
   "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": "toast/index.ts",
       "content": "/** @krizaka/ui/toast — `Toaster` (sonner, styled by roles), `toast`. Client (\"use client\"). */\nexport { type ExternalToast, toast, toastClassNames, Toaster, type ToasterProps } from \"./toast\";\n"
     },
+    {
+      "path": "toast/meta.ts",
+      "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n  title: \"Toast\",\n  summary: \"A short message that comes and goes: `toast()` from anywhere, one `Toaster` per app.\",\n  status: \"stable\",\n  category: \"feedback\",\n  platforms: \"both\",\n  whenToUse: [\n    \"To confirm the result of an action: saved, sent, payment received.\",\n    \"For an event the user did not trigger but should know: a new follower, a live auction.\",\n    \"With an action (“Retry”, “Undo”) when there is one obvious next step.\",\n  ],\n  whenNotToUse: [\n    { when: \"For a message that must stay until the situation changes.\", use: \"alert\" },\n    { when: \"When the user must answer.\", use: \"dialog\" },\n    { when: \"To report a form's errors: show them next to the fields.\", use: \"field\" },\n  ],\n  bestPractices: [\n    \"Mount one `Toaster` in the root layout, with its `label` and `closeLabel` translated.\",\n    \"A title in a few words, a description only if it adds something.\",\n    \"Never put the only way to do something in a toast: it goes away.\",\n  ],\n  accessibility: {\n    keyboard: [\n      { keys: \"F8\", action: \"Moves the focus to the toasts region (sonner's hotkey).\" },\n      { keys: \"Tab / Enter\", action: \"Reach and press a toast's action or close button.\" },\n    ],\n    notes: [\"The region is a landmark named by `label`; toasts are announced politely.\", \"Toasts pause while hovered or focused.\"],\n  },\n  related: [\"alert\", \"dialog\", \"confirm-button\"],\n  web: {\n    imports: [\"toast\", \"Toaster\"],\n    examples: [\n      { name: \"tones\", title: \"Tones\", description: \"Default, success, warning and error with an action.\" },\n      { name: \"custom\", title: \"Custom\", description: \"`toast.custom`: your JSX in the platform's shell.\" },\n    ],\n  },\n  native: {\n    imports: [\"toast\", \"Toaster\"],\n    differences: [\n      \"`Toaster` takes `offset` (the safe-area inset) instead of a position; mount it inside `ThemeProvider`.\",\n      \"Actions take `onPress`; a toast takes `onPress` to open what it is about.\",\n      \"No `toast.custom`: an `icon` before the text instead.\",\n    ],\n    examples: [\n      { name: \"tones\", title: \"Tones\", description: \"Default, success, and error with an action.\" },\n      { name: \"notification\", title: \"Notification\", description: \"An icon, tap to open it; `id` shows it once.\" },\n    ],\n  },\n} satisfies ComponentMeta;\n"
+    },
     {
       "path": "toast/toast.tsx",
       "content": "// Client. sonner does the queue, the stacking, the swipe, the timers, the live region and the hotkey; the look is\n// ours: sonner's own styling is off (`unstyled`) and every part reads a role. The status tones are soft (a tinted\n// border and a coloured icon, the text stays `text-fg`): the invariant status tokens are too light for small text.\nimport { Toaster as Sonner, type ToasterProps as SonnerProps } from \"sonner\";\n\nimport { cn } from \"../cn\";\n\nexport type { ExternalToast } from \"sonner\";\nexport { toast } from \"sonner\";\n\nconst tone = (color: string) => cn(\"border-l-4\", color);\n\nexport const toastClassNames = {\n  toast:\n    \"group pointer-events-auto relative flex w-full items-start gap-3 rounded-xl border border-border-default bg-surface-2 p-4 pr-10 \" +\n    \"text-sm text-fg shadow-lg\",\n  default: \"\",\n  title: \"font-semibold text-fg\",\n  description: \"mt-0.5 text-xs text-fg-secondary\",\n  content: \"flex min-w-0 flex-1 flex-col\",\n  icon: \"mt-0.5 flex h-4 w-4 shrink-0 items-center justify-center [&>svg]:h-4 [&>svg]:w-4\",\n  success: tone(\"border-l-success [&_[data-icon]]:text-success\"),\n  warning: tone(\"border-l-warning [&_[data-icon]]:text-warning\"),\n  error: tone(\"border-l-danger [&_[data-icon]]:text-danger\"),\n  info: tone(\"border-l-info [&_[data-icon]]:text-info\"),\n  loading: \"\",\n  actionButton:\n    \"ml-auto shrink-0 self-center rounded-lg bg-accent px-3 py-1.5 text-xs font-semibold text-on-accent hover:bg-accent-hover \" +\n    \"focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring\",\n  cancelButton:\n    \"shrink-0 self-center rounded-lg px-3 py-1.5 text-xs font-semibold text-fg-secondary hover:bg-surface-3 hover:text-fg \" +\n    \"focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring\",\n  closeButton:\n    \"absolute right-2 top-2 flex h-7 w-7 items-center justify-center rounded-full text-fg-secondary hover:bg-surface-3 hover:text-fg \" +\n    \"focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring [&>svg]:h-3.5 [&>svg]:w-3.5\",\n} satisfies NonNullable<NonNullable<SonnerProps[\"toastOptions\"]>[\"classNames\"]>;\n\nexport type ToasterProps = Omit<SonnerProps, \"richColors\" | \"theme\" | \"containerAriaLabel\" | \"toastOptions\"> & {\n  /** The accessible name of the notifications region (sonner's `containerAriaLabel`) — passed translated. */\n  label: string;\n  /** The accessible name of each toast's close button — passed translated. */\n  closeLabel: string;\n  /** Extra options for every toast (duration, a className); the class names are merged with the platform's. */\n  toastOptions?: Omit<NonNullable<SonnerProps[\"toastOptions\"]>, \"unstyled\" | \"closeButtonAriaLabel\">;\n};\n\n/** Mount once, in the root layout. Then call `toast()`, `toast.success/warning/error/info`, `toast.custom(…)`. */\nexport function Toaster({ label, closeLabel, position = \"bottom-right\", closeButton = true, toastOptions, ...props }: ToasterProps) {\n  const extra = toastOptions?.classNames ?? {};\n  const classNames = Object.fromEntries(\n    Object.entries(toastClassNames).map(([key, value]) => [key, cn(value, extra[key as keyof typeof extra])]),\n  ) as typeof toastClassNames;\n  return (\n    <Sonner\n      position={position}\n      closeButton={closeButton}\n      containerAriaLabel={label}\n      richColors={false}\n      toastOptions={{ ...toastOptions, unstyled: true, closeButtonAriaLabel: closeLabel, classNames }}\n      {...props}\n    />\n  );\n}\n"
@@ -19,8 +206,8 @@
     "cn"
   ],
   "demo": {
-    "path": "demos/toast.tsx",
-    "content": "\"use client\";\n\nimport { Button } from \"@krizaka/ui/button\";\nimport { toast, Toaster } from \"@krizaka/ui/toast\";\nimport { useEffect } from \"react\";\n\n// Each toaster has its own `id`: the toasts of this demo stay in this demo's toaster.\nconst toasterId = \"tones\";\nconst show = () => {\n  toast(\"Draft saved\", { toasterId, description: \"Autosaved a moment ago.\" });\n  toast.success(\"Payment received\", { toasterId, description: \"€12.00 from @maya.\" });\n  toast.warning(\"Your balance is low\", { toasterId, description: \"Two tips left before a top-up.\" });\n  toast.error(\"Upload failed\", { toasterId, description: \"The connection dropped at 64 %.\", action: { label: \"Retry\", onClick: () => {} } });\n};\n\n/** `defaultOpen`: the toasts show at once and stay (the screenshot); otherwise the button shows them. */\nexport default function ToastDemo({ defaultOpen = false }: { defaultOpen?: boolean }) {\n  useEffect(() => {\n    if (!defaultOpen) return;\n    toast.dismiss();\n    show();\n  }, [defaultOpen]);\n  return (\n    <>\n      <Toaster id={toasterId} label=\"Notifications\" closeLabel=\"Dismiss\" position=\"bottom-right\" expand visibleToasts={4} duration={defaultOpen ? Number.POSITIVE_INFINITY : undefined} />\n      <Button variant=\"outline\" onClick={show}>\n        Show again\n      </Button>\n    </>\n  );\n}\n"
+    "path": "examples/toast/tones.tsx",
+    "content": "\"use client\";\n\nimport { Button } from \"@krizaka/ui/button\";\nimport { toast, Toaster } from \"@krizaka/ui/toast\";\nimport { useEffect } from \"react\";\n\n// Each toaster has its own `id`: the toasts of this demo stay in this demo's toaster.\nconst toasterId = \"tones\";\nconst show = () => {\n  toast(\"Draft saved\", { toasterId, description: \"Autosaved a moment ago.\" });\n  toast.success(\"Payment received\", { toasterId, description: \"€12.00 from @maya.\" });\n  toast.warning(\"Your balance is low\", { toasterId, description: \"Two tips left before a top-up.\" });\n  toast.error(\"Upload failed\", { toasterId, description: \"The connection dropped at 64 %.\", action: { label: \"Retry\", onClick: () => {} } });\n};\n\n/** `defaultOpen`: the toasts show at once and stay (the screenshot); otherwise the button shows them. */\nexport default function ToastTones({ defaultOpen = false }: { defaultOpen?: boolean }) {\n  useEffect(() => {\n    if (!defaultOpen) return;\n    toast.dismiss();\n    show();\n  }, [defaultOpen]);\n  return (\n    <>\n      <Toaster id={toasterId} label=\"Notifications\" closeLabel=\"Dismiss\" position=\"bottom-right\" expand visibleToasts={4} duration={defaultOpen ? Number.POSITIVE_INFINITY : undefined} />\n      <Button variant=\"outline\" onClick={show}>\n        Show again\n      </Button>\n    </>\n  );\n}\n"
   },
   "props": [
     {

package/registry/tooltip.json

@@ -1,16 +1,156 @@
 {
   "name": "tooltip",
   "type": "primitive",
-  "description": "`Tooltip`, `TooltipProvider`. Client (\"use client\").",
+  "title": "Tooltip",
+  "summary": "A short label shown on hover and on keyboard focus, next to its trigger.",
+  "description": "A short label shown on hover and on keyboard focus, next to its trigger.",
+  "status": "stable",
+  "category": "overlays",
+  "platforms": "web",
+  "whenToUse": [
+    "To name an icon button for sighted mouse users: copy, share, more.",
+    "To show a shortcut next to an action."
+  ],
+  "whenNotToUse": [
+    {
+      "when": "For information people need to complete a task: put it in the page.",
+      "use": "field"
+    },
+    {
+      "when": "For interactive content (links, buttons).",
+      "use": "popover"
+    },
+    {
+      "when": "On touch screens as the only label: there is no hover."
+    }
+  ],
+  "bestPractices": [
+    "A few words, no punctuation: “Copy the link”.",
+    "The trigger keeps its own accessible name (an `IconButton` `label`); the tooltip repeats it for the eye."
+  ],
+  "accessibility": {
+    "keyboard": [
+      {
+        "keys": "Tab",
+        "action": "Focusing the trigger shows the tooltip at once."
+      },
+      {
+        "keys": "Esc",
+        "action": "Hides it."
+      }
+    ],
+    "notes": [
+      "Radix Tooltip: `role=\"tooltip\"`, linked to the trigger by `aria-describedby`.",
+      "It opens on hover after `delayDuration` (300 ms) and never holds focus."
+    ]
+  },
+  "related": [
+    "button",
+    "popover",
+    "kbd"
+  ],
+  "web": {
+    "entry": "@krizaka/ui/tooltip",
+    "import": "import { Tooltip } from \"@krizaka/ui/tooltip\";",
+    "props": [
+      {
+        "component": "Tooltip",
+        "description": "",
+        "props": [
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "default": null,
+            "description": "The trigger, rendered as is (`asChild`): a focusable element.",
+            "required": true
+          },
+          {
+            "name": "content",
+            "type": "ReactNode",
+            "default": null,
+            "description": "What the tooltip says — passed translated.",
+            "required": true
+          },
+          {
+            "name": "container",
+            "type": "HTMLElement | null",
+            "default": null,
+            "description": "The element the portal renders into (default: document.body).",
+            "required": false
+          },
+          {
+            "name": "defaultOpen",
+            "type": "boolean",
+            "default": null,
+            "description": "Open at first, uncontrolled.",
+            "required": false
+          },
+          {
+            "name": "delayDuration",
+            "type": "number",
+            "default": "300",
+            "description": "Hover delay in ms before it opens (300 by default).",
+            "required": false
+          },
+          {
+            "name": "onOpenChange",
+            "type": "((open: boolean) => void)",
+            "default": null,
+            "description": "Called when it opens or closes.",
+            "required": false
+          },
+          {
+            "name": "open",
+            "type": "boolean",
+            "default": null,
+            "description": "Open or closed (controlled), with `onOpenChange`.",
+            "required": false
+          }
+        ]
+      },
+      {
+        "component": "TooltipProvider",
+        "description": "Optional, once near the root: shares `delayDuration` and the skip delay between tooltips.",
+        "props": []
+      }
+    ],
+    "examples": [
+      {
+        "name": "top",
+        "title": "Top",
+        "description": "Above its trigger (the default).",
+        "path": "examples/tooltip/top.tsx",
+        "module": "@krizaka/ui/registry/examples/tooltip/top",
+        "code": "import { IconButton } from \"@krizaka/ui/button\";\nimport { Tooltip } from \"@krizaka/ui/tooltip\";\n\nexport default function TooltipTop({ defaultOpen = false }: { defaultOpen?: boolean }) {\n  return (\n    <Tooltip content=\"Copy the link\" defaultOpen={defaultOpen}>\n      <IconButton label=\"Copy\" variant=\"outline\">\n        <svg viewBox=\"0 0 24 24\" className=\"h-4 w-4\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" aria-hidden>\n          <rect x=\"9\" y=\"9\" width=\"12\" height=\"12\" rx=\"2\" />\n          <path d=\"M5 15V5a2 2 0 0 1 2-2h10\" />\n        </svg>\n      </IconButton>\n    </Tooltip>\n  );\n}\n"
+      },
+      {
+        "name": "right",
+        "title": "Right",
+        "description": "`side=\"right\"`.",
+        "path": "examples/tooltip/right.tsx",
+        "module": "@krizaka/ui/registry/examples/tooltip/right",
+        "code": "import { IconButton } from \"@krizaka/ui/button\";\nimport { Tooltip } from \"@krizaka/ui/tooltip\";\n\nexport default function TooltipRight({ defaultOpen = false }: { defaultOpen?: boolean }) {\n  return (\n    <Tooltip content=\"Copy the link\" side=\"right\" defaultOpen={defaultOpen}>\n      <IconButton label=\"Copy\" variant=\"outline\">\n        <svg viewBox=\"0 0 24 24\" className=\"h-4 w-4\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" aria-hidden>\n          <rect x=\"9\" y=\"9\" width=\"12\" height=\"12\" rx=\"2\" />\n          <path d=\"M5 15V5a2 2 0 0 1 2-2h10\" />\n        </svg>\n      </IconButton>\n    </Tooltip>\n  );\n}\n"
+      }
+    ]
+  },
+  "native": null,
   "files": [
     {
       "path": "floating.ts",
       "content": "// The one surface of everything that floats next to its trigger (popover, menu, tooltip): a raised surface, a border,\n// the large shadow and the `kz-pop` entrance from the side Radix measured (`--radix-*-transform-origin`).\nexport const floating =\n  \"kz-pop z-50 rounded-lg border border-border-default bg-surface-2 text-fg shadow-lg outline-hidden\";\n"
     },
+    {
+      "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": "tooltip/index.ts",
       "content": "/** @krizaka/ui/tooltip — `Tooltip`, `TooltipProvider`. Client (\"use client\"). */\nexport { Tooltip, type TooltipProps, TooltipProvider } from \"./tooltip\";\n"
     },
+    {
+      "path": "tooltip/meta.ts",
+      "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n  title: \"Tooltip\",\n  summary: \"A short label shown on hover and on keyboard focus, next to its trigger.\",\n  status: \"stable\",\n  category: \"overlays\",\n  platforms: \"web\",\n  whenToUse: [\"To name an icon button for sighted mouse users: copy, share, more.\", \"To show a shortcut next to an action.\"],\n  whenNotToUse: [\n    { when: \"For information people need to complete a task: put it in the page.\", use: \"field\" },\n    { when: \"For interactive content (links, buttons).\", use: \"popover\" },\n    { when: \"On touch screens as the only label: there is no hover.\" },\n  ],\n  bestPractices: [\n    \"A few words, no punctuation: “Copy the link”.\",\n    \"The trigger keeps its own accessible name (an `IconButton` `label`); the tooltip repeats it for the eye.\",\n  ],\n  accessibility: {\n    keyboard: [\n      { keys: \"Tab\", action: \"Focusing the trigger shows the tooltip at once.\" },\n      { keys: \"Esc\", action: \"Hides it.\" },\n    ],\n    notes: [\"Radix Tooltip: `role=\\\"tooltip\\\"`, linked to the trigger by `aria-describedby`.\", \"It opens on hover after `delayDuration` (300 ms) and never holds focus.\"],\n  },\n  related: [\"button\", \"popover\", \"kbd\"],\n  web: {\n    imports: [\"Tooltip\"],\n    examples: [\n      { name: \"top\", title: \"Top\", description: \"Above its trigger (the default).\" },\n      { name: \"right\", title: \"Right\", description: \"`side=\\\"right\\\"`.\" },\n    ],\n  },\n} satisfies ComponentMeta;\n"
+    },
     {
       "path": "tooltip/tooltip.tsx",
       "content": "// Client (a portal). A short label for a control, on hover after `delayDuration` and on keyboard focus at once;\n// Escape dismisses it. It names nothing: the control keeps its own accessible name (an IconButton's `label`).\nimport { Tooltip as TooltipPrimitive } from \"radix-ui\";\nimport type * as React from \"react\";\n\nimport { cn } from \"../cn\";\nimport { floating } from \"../floating\";\n\n/** Optional, once near the root: shares `delayDuration` and the skip delay between tooltips. */\nexport const TooltipProvider = TooltipPrimitive.Provider;\n\nexport type TooltipProps = Omit<React.ComponentProps<typeof TooltipPrimitive.Content>, \"content\" | \"children\"> & {\n  /** What the tooltip says — passed translated. */\n  content: React.ReactNode;\n  /** The trigger, rendered as is (`asChild`): a focusable element. */\n  children: React.ReactNode;\n  /** Open or closed (controlled), with `onOpenChange`. */\n  open?: boolean;\n  /** Open at first, uncontrolled. */\n  defaultOpen?: boolean;\n  /** Called when it opens or closes. */\n  onOpenChange?: (open: boolean) => void;\n  /** Hover delay in ms before it opens (300 by default). */\n  delayDuration?: number;\n  /** The element the portal renders into (default: document.body). */\n  container?: HTMLElement | null;\n};\n\nexport function Tooltip({\n  content,\n  children,\n  open,\n  defaultOpen,\n  onOpenChange,\n  delayDuration = 300,\n  container,\n  sideOffset = 6,\n  collisionPadding = 8,\n  className,\n  ...props\n}: TooltipProps) {\n  return (\n    <TooltipPrimitive.Provider delayDuration={delayDuration}>\n      <TooltipPrimitive.Root open={open} defaultOpen={defaultOpen} onOpenChange={onOpenChange}>\n        <TooltipPrimitive.Trigger asChild>{children}</TooltipPrimitive.Trigger>\n        <TooltipPrimitive.Portal container={container}>\n          <TooltipPrimitive.Content\n            sideOffset={sideOffset}\n            collisionPadding={collisionPadding}\n            className={cn(floating, \"max-w-xs px-2.5 py-1.5 text-xs font-medium origin-(--radix-tooltip-content-transform-origin)\", className)}\n            {...props}\n          >\n            {content}\n          </TooltipPrimitive.Content>\n        </TooltipPrimitive.Portal>\n      </TooltipPrimitive.Root>\n    </TooltipPrimitive.Provider>\n  );\n}\n"
@@ -23,8 +163,8 @@
     "cn"
   ],
   "demo": {
-    "path": "demos/tooltip.tsx",
-    "content": "import { IconButton } from \"@krizaka/ui/button\";\nimport { Tooltip } from \"@krizaka/ui/tooltip\";\n\nexport default function TooltipDemo({ defaultOpen = false }: { defaultOpen?: boolean }) {\n  return (\n    <Tooltip content=\"Copy the link\" defaultOpen={defaultOpen}>\n      <IconButton label=\"Copy\" variant=\"outline\">\n        <svg viewBox=\"0 0 24 24\" className=\"h-4 w-4\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" aria-hidden>\n          <rect x=\"9\" y=\"9\" width=\"12\" height=\"12\" rx=\"2\" />\n          <path d=\"M5 15V5a2 2 0 0 1 2-2h10\" />\n        </svg>\n      </IconButton>\n    </Tooltip>\n  );\n}\n"
+    "path": "examples/tooltip/top.tsx",
+    "content": "import { IconButton } from \"@krizaka/ui/button\";\nimport { Tooltip } from \"@krizaka/ui/tooltip\";\n\nexport default function TooltipTop({ defaultOpen = false }: { defaultOpen?: boolean }) {\n  return (\n    <Tooltip content=\"Copy the link\" defaultOpen={defaultOpen}>\n      <IconButton label=\"Copy\" variant=\"outline\">\n        <svg viewBox=\"0 0 24 24\" className=\"h-4 w-4\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" aria-hidden>\n          <rect x=\"9\" y=\"9\" width=\"12\" height=\"12\" rx=\"2\" />\n          <path d=\"M5 15V5a2 2 0 0 1 2-2h10\" />\n        </svg>\n      </IconButton>\n    </Tooltip>\n  );\n}\n"
   },
   "props": [
     {

package/registry/txt.json

@@ -0,0 +1,97 @@
+{
+  "name": "txt",
+  "type": "native",
+  "title": "Txt",
+  "summary": "Text in the platform's type scale, coloured by a role of the current theme.",
+  "description": "Text in the platform's type scale, coloured by a role of the current theme.",
+  "status": "beta",
+  "category": "foundations",
+  "platforms": "native",
+  "whenToUse": [
+    "For every text of a React Native screen: titles, body, captions, labels, figures (`mono`)."
+  ],
+  "whenNotToUse": [
+    {
+      "when": "On the web: use the preset's text utilities (`text-fg`, `font-display`).",
+      "use": "theme"
+    },
+    {
+      "when": "For a status label.",
+      "use": "badge"
+    }
+  ],
+  "bestPractices": [
+    "Pick a `variant` from the scale and a `tone` from the roles: never a font size or a colour by hand.",
+    "`muted` only for large text or what is off: it reaches AA only as large text."
+  ],
+  "accessibility": {
+    "keyboard": [],
+    "notes": [
+      "`title` and `display` are headers for screen readers.",
+      "It follows the system's font scaling."
+    ]
+  },
+  "related": [
+    "theme",
+    "badge"
+  ],
+  "web": null,
+  "native": {
+    "entry": "@krizaka/ui/native",
+    "import": "import { Txt } from \"@krizaka/ui/native\";",
+    "differences": [],
+    "props": [
+      {
+        "component": "Txt",
+        "description": "Text in the platform's scale, coloured by a role of the current theme. `title` and `display` are headers for screen readers.",
+        "props": [
+          {
+            "name": "tone",
+            "type": "TxtTone",
+            "default": "text",
+            "description": "A text role of the theme (default `text`).",
+            "required": false
+          },
+          {
+            "name": "variant",
+            "type": "TxtVariant",
+            "default": "body",
+            "description": "The type scale: display · title · body (default) · caption · label · mono (tabular figures).",
+            "required": false
+          }
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "name": "variants",
+        "title": "Variants",
+        "description": "`display`, `title`, `body`, `caption`, `label`, `mono`.",
+        "path": "examples/txt/native/variants.tsx",
+        "module": "@krizaka/ui/registry/examples/txt/native/variants",
+        "code": "import { Txt } from \"@krizaka/ui/native\";\n\n// The platform's type scale: display · title · body · caption · label · mono.\nexport default function NativeTxtVariants() {\n  return (\n    <>\n      <Txt variant=\"display\">Every night, a new set.</Txt>\n      <Txt variant=\"title\">Every night, a new set.</Txt>\n      <Txt variant=\"body\">Every night, a new set.</Txt>\n      <Txt variant=\"caption\">Every night, a new set.</Txt>\n      <Txt variant=\"label\">Every night, a new set.</Txt>\n      <Txt variant=\"mono\">01:24:09</Txt>\n    </>\n  );\n}\n",
+        "screenshots": {
+          "dark": "examples/txt/native/variants.dark.png",
+          "light": "examples/txt/native/variants.light.png"
+        }
+      },
+      {
+        "name": "tones",
+        "title": "Tones",
+        "description": "`text`, `secondary`, `muted`, `accent`.",
+        "path": "examples/txt/native/tones.tsx",
+        "module": "@krizaka/ui/registry/examples/txt/native/tones",
+        "code": "import { Txt } from \"@krizaka/ui/native\";\n\n// The text roles; `muted` reaches AA only as large text, like the status roles.\nexport default function NativeTxtTones() {\n  return (\n    <>\n      <Txt tone=\"text\">Every night, a new set.</Txt>\n      <Txt tone=\"secondary\">Every night, a new set.</Txt>\n      <Txt tone=\"muted\" variant=\"display\">\n        Every night, a new set.\n      </Txt>\n      <Txt tone=\"accent\" variant=\"title\">\n        Every night, a new set.\n      </Txt>\n    </>\n  );\n}\n",
+        "screenshots": {
+          "dark": "examples/txt/native/tones.dark.png",
+          "light": "examples/txt/native/tones.light.png"
+        }
+      }
+    ]
+  },
+  "files": [],
+  "dependencies": [],
+  "registryDependencies": [],
+  "demo": null,
+  "props": []
+}

package/dist/chunk-ZUD4U22H.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/button/button.tsx"],"sourcesContent":["// Server-safe: no hook, no context. `buttonVariants` styles a <Link> or a Server Component without the component.\nimport { Slot } from \"radix-ui\";\nimport type * as React from \"react\";\nimport { tv, type VariantProps } from \"tailwind-variants\";\n\nexport const buttonVariants = tv({\n  base:\n    \"inline-flex shrink-0 select-none items-center justify-center gap-2 whitespace-nowrap font-semibold transition-all \" +\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:pointer-events-none disabled:opacity-40 data-loading:cursor-progress active:scale-[0.98]\",\n  variants: {\n    variant: {\n      primary: \"bg-accent text-on-accent shadow-sm hover:bg-accent-hover\",\n      secondary: \"border border-border-default bg-surface-2 text-fg hover:border-border-strong hover:bg-surface-3\",\n      outline: \"border border-border-default bg-transparent text-fg hover:border-accent hover:text-accent\",\n      ghost: \"text-fg-secondary hover:bg-surface-2 hover:text-fg\",\n      // The danger token is invariant and too light for small text on a light surface (3.6:1): the label stays a\n      // text role, the border and the tint carry the danger.\n      danger: \"border border-danger/50 bg-danger/10 text-fg hover:border-danger hover:bg-danger/20\",\n    },\n    size: { sm: \"h-8 px-3 text-xs\", md: \"h-10 px-4 text-sm\", lg: \"h-12 px-6 text-sm\", icon: \"h-10 w-10\" },\n    shape: { rounded: \"rounded-lg\", pill: \"rounded-full\" },\n  },\n  defaultVariants: { variant: \"secondary\", size: \"md\", shape: \"rounded\" },\n});\n\nexport type ButtonVariants = VariantProps<typeof buttonVariants>;\n\nexport type ButtonProps = React.ComponentProps<\"button\"> &\n  ButtonVariants & {\n    /**\n     * The look: `primary` (the accent), `secondary` (a raised surface), `outline`, `ghost`, `danger`.\n     * @default \"secondary\"\n     */\n    variant?: ButtonVariants[\"variant\"];\n    /**\n     * sm · md · lg, or `icon` (a square).\n     * @default \"md\"\n     */\n    size?: ButtonVariants[\"size\"];\n    /**\n     * rounded · pill.\n     * @default \"rounded\"\n     */\n    shape?: ButtonVariants[\"shape\"];\n    /** Renders the child (e.g. a <Link>) instead of the <button>, with props, classes and ref merged. */\n    asChild?: boolean;\n    /** Disables and signals the wait (aria-busy, data-loading) — the product adds a spinner if it wants one. */\n    loading?: boolean;\n  };\n\nexport function Button({ asChild, loading, variant, size, shape, className, disabled, ...props }: ButtonProps) {\n  const Comp = asChild ? Slot.Root : \"button\";\n  return (\n    <Comp\n      type={asChild ? undefined : \"button\"}\n      aria-busy={loading || undefined}\n      data-loading={loading ? \"\" : undefined}\n      data-variant={variant ?? \"secondary\"}\n      disabled={asChild ? undefined : disabled || loading}\n      aria-disabled={asChild && (disabled || loading) ? true : undefined}\n      className={buttonVariants({ variant, size, shape, className })}\n      {...props}\n    />\n  );\n}\n\nexport type IconButtonProps = Omit<ButtonProps, \"size\"> & {\n  /** The accessible name (and tooltip) of the button — required, passed translated. */\n  label: string;\n  /**\n   * sm · md · lg, or `icon` (a square).\n   * @default \"icon\"\n   */\n  size?: ButtonProps[\"size\"];\n};\n\n/** An icon-only button: `label` is required, it is its accessible name. */\nexport function IconButton({ label, size = \"icon\", ...props }: IconButtonProps) {\n  return <Button aria-label={label} title={label} size={size} {...props} />;\n}\n"],"mappings":";;;AACA,SAAS,YAAY;AAErB,SAAS,UAA6B;AAmDlC;AAjDG,IAAM,iBAAiB,GAAG;AAAA,EAC/B,MACE;AAAA,EAGF,UAAU;AAAA,IACR,SAAS;AAAA,MACP,SAAS;AAAA,MACT,WAAW;AAAA,MACX,SAAS;AAAA,MACT,OAAO;AAAA;AAAA;AAAA,MAGP,QAAQ;AAAA,IACV;AAAA,IACA,MAAM,EAAE,IAAI,oBAAoB,IAAI,qBAAqB,IAAI,qBAAqB,MAAM,YAAY;AAAA,IACpG,OAAO,EAAE,SAAS,cAAc,MAAM,eAAe;AAAA,EACvD;AAAA,EACA,iBAAiB,EAAE,SAAS,aAAa,MAAM,MAAM,OAAO,UAAU;AACxE,CAAC;AA2BM,SAAS,OAAO,EAAE,SAAS,SAAS,SAAS,MAAM,OAAO,WAAW,UAAU,GAAG,MAAM,GAAgB;AAC7G,QAAM,OAAO,UAAU,KAAK,OAAO;AACnC,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAM,UAAU,SAAY;AAAA,MAC5B,aAAW,WAAW;AAAA,MACtB,gBAAc,UAAU,KAAK;AAAA,MAC7B,gBAAc,WAAW;AAAA,MACzB,UAAU,UAAU,SAAY,YAAY;AAAA,MAC5C,iBAAe,YAAY,YAAY,WAAW,OAAO;AAAA,MACzD,WAAW,eAAe,EAAE,SAAS,MAAM,OAAO,UAAU,CAAC;AAAA,MAC5D,GAAG;AAAA;AAAA,EACN;AAEJ;AAaO,SAAS,WAAW,EAAE,OAAO,OAAO,QAAQ,GAAG,MAAM,GAAoB;AAC9E,SAAO,oBAAC,UAAO,cAAY,OAAO,OAAO,OAAO,MAAa,GAAG,OAAO;AACzE;","names":[]}

package/registry/demos/alert.d.ts

@@ -1,5 +0,0 @@
-import * as react from 'react';
-
-declare function AlertDemo(): react.JSX.Element;
-
-export { AlertDemo as default };

package/registry/demos/avatar.d.ts

@@ -1,5 +0,0 @@
-import * as react from 'react';
-
-declare function AvatarDemo(): react.JSX.Element;
-
-export { AvatarDemo as default };

package/registry/demos/badge.d.ts

@@ -1,5 +0,0 @@
-import * as react from 'react';
-
-declare function BadgeDemo(): react.JSX.Element;
-
-export { BadgeDemo as default };

package/registry/demos/button.d.ts

@@ -1,5 +0,0 @@
-import * as react from 'react';
-
-declare function ButtonDemo(): react.JSX.Element;
-
-export { ButtonDemo as default };

package/registry/demos/card.d.ts

@@ -1,5 +0,0 @@
-import * as react from 'react';
-
-declare function CardDemo(): react.JSX.Element;
-
-export { CardDemo as default };

package/registry/demos/checkbox.d.ts

@@ -1,5 +0,0 @@
-import * as react from 'react';
-
-declare function CheckboxDemo(): react.JSX.Element;
-
-export { CheckboxDemo as default };

package/registry/demos/chip.d.ts

@@ -1,5 +0,0 @@
-import * as react from 'react';
-
-declare function ChipDemo(): react.JSX.Element;
-
-export { ChipDemo as default };

package/registry/demos/cn.d.ts

@@ -1,7 +0,0 @@
-import * as react from 'react';
-
-declare function CnDemo({ selected }: {
-    selected?: boolean;
-}): react.JSX.Element;
-
-export { CnDemo as default };

package/registry/demos/command.d.ts

@@ -1,5 +0,0 @@
-import * as react from 'react';
-
-declare function CommandDemo(): react.JSX.Element;
-
-export { CommandDemo as default };

package/registry/demos/confirm-button.d.ts

@@ -1,5 +0,0 @@
-import * as react from 'react';
-
-declare function ConfirmButtonDemo(): react.JSX.Element;
-
-export { ConfirmButtonDemo as default };

package/registry/demos/countdown.d.ts

@@ -1,5 +0,0 @@
-import * as react from 'react';
-
-declare function CountdownDemo(): react.JSX.Element;
-
-export { CountdownDemo as default };

package/registry/demos/dialog.d.ts

@@ -1,7 +0,0 @@
-import * as react from 'react';
-
-declare function DialogDemo({ defaultOpen }: {
-    defaultOpen?: boolean;
-}): react.JSX.Element;
-
-export { DialogDemo as default };