@nucleux/mcp 0.2.0 → 0.4.0

package/dist/index.js

@@ -8,7 +8,7 @@ import { z } from "zod";
 // src/catalog.json
 var catalog_default = {
   library: "@nucleux/react",
-  version: "0.2.0",
+  version: "0.4.0",
   generatedFrom: "packages/* (do not edit \u2014 run scripts/gen-mcp-catalog.mjs)",
   setup: {
     installFull: "pnpm add @nucleux/react @nucleux/tokens",
@@ -21,8 +21,8 @@ var catalog_default = {
     note: "Every component is also re-exported from the @nucleux/react umbrella."
   },
   counts: {
-    components: 99,
-    packages: 103,
+    components: 128,
+    packages: 132,
     examples: 6
   },
   packages: [
@@ -2095,6 +2095,1159 @@ Source: Figma "Recovery / Error & Empty States".`,
         "react-dom": ">=18"
       }
     },
+    {
+      name: "md3-badge",
+      package: "@nucleux/md3-badge",
+      kind: "component",
+      description: "A Material Design 3 badge \u2014 a small dot or a large numbered label.",
+      summary: "Material 3 badge \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-badge"
+      ],
+      exports: [
+        "Md3Badge",
+        "Md3BadgeProps"
+      ],
+      components: [
+        "Md3Badge"
+      ],
+      import: 'import { Md3Badge } from "@nucleux/md3-badge";',
+      installSingle: "pnpm add @nucleux/md3-badge @nucleux/tokens",
+      props: [
+        {
+          name: "Md3BadgeProps",
+          source: 'export interface Md3BadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "content"> {\n  /** Numeric/text count. Omit for a small dot badge. */\n  content?: React.ReactNode;\n  /** Clamp numeric content, e.g. max=99 renders "99+". */\n  max?: number;\n  /** The element the badge is attached to (badge floats at its top-right). */\n  children?: React.ReactNode;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-badge\n\nMaterial 3 badge \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-badge @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Badge } from "@nucleux/md3-badge";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-banner",
+      package: "@nucleux/md3-banner",
+      kind: "component",
+      description: "A Material Design 3 banner \u2014 a prominent, dismissible message with actions.",
+      summary: "Material 3 banner \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-banner"
+      ],
+      exports: [
+        "Md3Banner",
+        "Md3BannerProps"
+      ],
+      components: [
+        "Md3Banner"
+      ],
+      import: 'import { Md3Banner } from "@nucleux/md3-banner";',
+      installSingle: "pnpm add @nucleux/md3-banner @nucleux/tokens",
+      props: [
+        {
+          name: "Md3BannerProps",
+          source: "export interface Md3BannerProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** Leading icon. */\n  icon?: React.ReactNode;\n  /** Trailing action buttons (typically text buttons). */\n  actions?: React.ReactNode;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-banner\n\nMaterial 3 banner \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-banner @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Banner } from "@nucleux/md3-banner";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-bottom-sheet",
+      package: "@nucleux/md3-bottom-sheet",
+      kind: "component",
+      description: "A Material Design 3 modal bottom sheet with a scrim and drag handle.",
+      summary: "Material 3 modal bottom sheet \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-bottom-sheet"
+      ],
+      exports: [
+        "Md3BottomSheet",
+        "Md3BottomSheetProps"
+      ],
+      components: [
+        "Md3BottomSheet"
+      ],
+      import: 'import { Md3BottomSheet } from "@nucleux/md3-bottom-sheet";',
+      installSingle: "pnpm add @nucleux/md3-bottom-sheet @nucleux/tokens",
+      props: [
+        {
+          name: "Md3BottomSheetProps",
+          source: "export interface Md3BottomSheetProps extends React.HTMLAttributes<HTMLDivElement> {\n  open: boolean;\n  onOpenChange: (open: boolean) => void;\n  /** Show the drag handle at the top (default true). */\n  showHandle?: boolean;\n  dismissible?: boolean;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-bottom-sheet\n\nMaterial 3 modal bottom sheet \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-bottom-sheet @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3BottomSheet } from "@nucleux/md3-bottom-sheet";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-button",
+      package: "@nucleux/md3-button",
+      kind: "component",
+      description: "A Material Design 3 button. Five variants (filled, tonal, elevated, outlined,\ntext) with an on-color state layer for hover/focus/press.",
+      summary: "Material 3 button (filled, tonal, outlined, text, elevated) \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-button"
+      ],
+      exports: [
+        "Md3Button",
+        "Md3ButtonVariant",
+        "Md3ButtonProps"
+      ],
+      components: [
+        "Md3Button"
+      ],
+      import: 'import { Md3Button } from "@nucleux/md3-button";',
+      installSingle: "pnpm add @nucleux/md3-button @nucleux/tokens",
+      props: [
+        {
+          name: "Md3ButtonProps",
+          source: "export interface Md3ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  variant?: Md3ButtonVariant;\n  /** Leading icon element. */\n  icon?: React.ReactNode;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-button\n\nMaterial 3 button (filled, tonal, outlined, text, elevated) \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-button @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Button } from "@nucleux/md3-button";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-card",
+      package: "@nucleux/md3-card",
+      kind: "component",
+      description: "A Material Design 3 card surface (elevated, filled, outlined).",
+      summary: "Material 3 card (elevated, filled, outlined) \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-card"
+      ],
+      exports: [
+        "Md3Card",
+        "Md3CardVariant",
+        "Md3CardProps"
+      ],
+      components: [
+        "Md3Card"
+      ],
+      import: 'import { Md3Card } from "@nucleux/md3-card";',
+      installSingle: "pnpm add @nucleux/md3-card @nucleux/tokens",
+      props: [
+        {
+          name: "Md3CardProps",
+          source: "export interface Md3CardProps extends React.HTMLAttributes<HTMLDivElement> {\n  variant?: Md3CardVariant;\n  /** Add hover/press state layer + pointer cursor (for actionable cards). */\n  interactive?: boolean;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-card\n\nMaterial 3 card (elevated, filled, outlined) \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-card @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Card } from "@nucleux/md3-card";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-checkbox",
+      package: "@nucleux/md3-checkbox",
+      kind: "component",
+      description: "A Material Design 3 checkbox with a circular state layer and error-free tokens.",
+      summary: "Material 3 checkbox \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-checkbox"
+      ],
+      exports: [
+        "Md3Checkbox",
+        "Md3CheckboxProps"
+      ],
+      components: [
+        "Md3Checkbox"
+      ],
+      import: 'import { Md3Checkbox } from "@nucleux/md3-checkbox";',
+      installSingle: "pnpm add @nucleux/md3-checkbox @nucleux/tokens",
+      props: [
+        {
+          name: "Md3CheckboxProps",
+          source: 'export interface Md3CheckboxProps\n  extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onChange" | "type"> {\n  checked?: boolean;\n  defaultChecked?: boolean;\n  indeterminate?: boolean;\n  onCheckedChange?: (checked: boolean) => void;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-checkbox\n\nMaterial 3 checkbox \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-checkbox @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Checkbox } from "@nucleux/md3-checkbox";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-chip",
+      package: "@nucleux/md3-chip",
+      kind: "component",
+      description: "A Material Design 3 chip (assist, filter, input, suggestion). Filter chips\ntoggle a selected state; input chips render a trailing remove affordance.",
+      summary: "Material 3 chip (assist, filter, input, suggestion) \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-chip"
+      ],
+      exports: [
+        "Md3Chip",
+        "Md3ChipVariant",
+        "Md3ChipProps"
+      ],
+      components: [
+        "Md3Chip"
+      ],
+      import: 'import { Md3Chip } from "@nucleux/md3-chip";',
+      installSingle: "pnpm add @nucleux/md3-chip @nucleux/tokens",
+      props: [
+        {
+          name: "Md3ChipProps",
+          source: 'export interface Md3ChipProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onSelect"> {\n  variant?: Md3ChipVariant;\n  /** Filter chips: selected state (shows a leading check). */\n  selected?: boolean;\n  /** Leading icon (assist/input/suggestion). */\n  icon?: React.ReactNode;\n  /** Input chips: renders a trailing remove button and fires this on click. */\n  onRemove?: () => void;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-chip\n\nMaterial 3 chip (assist, filter, input, suggestion) \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-chip @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Chip } from "@nucleux/md3-chip";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-date-picker",
+      package: "@nucleux/md3-date-picker",
+      kind: "component",
+      description: "A Material Design 3 date picker: an outlined field that opens a calendar.",
+      summary: "Material 3 date picker \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-date-picker"
+      ],
+      exports: [
+        "Md3DatePicker",
+        "Md3DatePickerProps"
+      ],
+      components: [
+        "Md3DatePicker"
+      ],
+      import: 'import { Md3DatePicker } from "@nucleux/md3-date-picker";',
+      installSingle: "pnpm add @nucleux/md3-date-picker @nucleux/tokens",
+      props: [
+        {
+          name: "Md3DatePickerProps",
+          source: 'export interface Md3DatePickerProps {\n  value?: Date;\n  defaultValue?: Date;\n  onValueChange?: (date: Date | undefined) => void;\n  label?: string;\n  disabled?: boolean;\n  className?: string;\n  "aria-label"?: string;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-date-picker\n\nMaterial 3 date picker \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-date-picker @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3DatePicker } from "@nucleux/md3-date-picker";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-dialog",
+      package: "@nucleux/md3-dialog",
+      kind: "component",
+      description: "A Material Design 3 basic dialog with scrim, headline, body, and actions.",
+      summary: "Material 3 dialog \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-dialog"
+      ],
+      exports: [
+        "Md3Dialog",
+        "Md3DialogProps"
+      ],
+      components: [
+        "Md3Dialog"
+      ],
+      import: 'import { Md3Dialog } from "@nucleux/md3-dialog";',
+      installSingle: "pnpm add @nucleux/md3-dialog @nucleux/tokens",
+      props: [
+        {
+          name: "Md3DialogProps",
+          source: "export interface Md3DialogProps {\n  open: boolean;\n  onOpenChange: (open: boolean) => void;\n  headline: React.ReactNode;\n  /** Optional hero icon, centered above the headline. */\n  icon?: React.ReactNode;\n  /** Supporting body content. */\n  children?: React.ReactNode;\n  /** Action buttons (typically text buttons), right-aligned. */\n  actions?: React.ReactNode;\n  /** Close on scrim click / Escape (default true). */\n  dismissible?: boolean;\n  className?: string;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-dialog\n\nMaterial 3 dialog \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-dialog @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Dialog } from "@nucleux/md3-dialog";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-divider",
+      package: "@nucleux/md3-divider",
+      kind: "component",
+      description: "A Material Design 3 divider (thin outline-variant line).",
+      summary: "Material 3 divider \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-divider"
+      ],
+      exports: [
+        "Md3Divider",
+        "Md3DividerProps"
+      ],
+      components: [
+        "Md3Divider"
+      ],
+      import: 'import { Md3Divider } from "@nucleux/md3-divider";',
+      installSingle: "pnpm add @nucleux/md3-divider @nucleux/tokens",
+      props: [
+        {
+          name: "Md3DividerProps",
+          source: 'export interface Md3DividerProps extends React.HTMLAttributes<HTMLDivElement> {\n  orientation?: "horizontal" | "vertical";\n  /** Inset the divider (e.g. to align with list text). */\n  inset?: boolean;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-divider\n\nMaterial 3 divider \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-divider @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Divider } from "@nucleux/md3-divider";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-fab",
+      package: "@nucleux/md3-fab",
+      kind: "component",
+      description: "A Material Design 3 floating action button. Sizes small/regular/large plus an\nextended variant with a label; four container colors. Elevated with a state layer.",
+      summary: "Material 3 floating action button \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-fab"
+      ],
+      exports: [
+        "Md3Fab",
+        "Md3FabSize",
+        "Md3FabColor",
+        "Md3FabProps"
+      ],
+      components: [
+        "Md3Fab",
+        "Md3FabSize",
+        "Md3FabColor"
+      ],
+      import: 'import { Md3Fab, Md3FabSize, Md3FabColor } from "@nucleux/md3-fab";',
+      installSingle: "pnpm add @nucleux/md3-fab @nucleux/tokens",
+      props: [
+        {
+          name: "Md3FabProps",
+          source: "export interface Md3FabProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  size?: Md3FabSize;\n  color?: Md3FabColor;\n  icon: React.ReactNode;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-fab\n\nMaterial 3 floating action button \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-fab @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Fab } from "@nucleux/md3-fab";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-icon-button",
+      package: "@nucleux/md3-icon-button",
+      kind: "component",
+      description: "A Material Design 3 icon button (standard, filled, tonal, outlined).",
+      summary: "Material 3 icon button \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-icon-button"
+      ],
+      exports: [
+        "Md3IconButton",
+        "Md3IconButtonVariant",
+        "Md3IconButtonProps"
+      ],
+      components: [
+        "Md3IconButton"
+      ],
+      import: 'import { Md3IconButton } from "@nucleux/md3-icon-button";',
+      installSingle: "pnpm add @nucleux/md3-icon-button @nucleux/tokens",
+      props: [
+        {
+          name: "Md3IconButtonProps",
+          source: 'export interface Md3IconButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  variant?: Md3IconButtonVariant;\n  /** Toggle-selected state (affects filled/tonal background). */\n  selected?: boolean;\n  /** Required for icon-only buttons. */\n  "aria-label": string;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-icon-button\n\nMaterial 3 icon button \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-icon-button @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3IconButton } from "@nucleux/md3-icon-button";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-list",
+      package: "@nucleux/md3-list",
+      kind: "component",
+      description: "A Material Design 3 list container. Compose with Md3ListItem.",
+      summary: "Material 3 list \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-list"
+      ],
+      exports: [
+        "Md3List",
+        "Md3ListItem",
+        "Md3ListItemProps"
+      ],
+      components: [
+        "Md3List",
+        "Md3ListItem"
+      ],
+      import: 'import { Md3List, Md3ListItem } from "@nucleux/md3-list";',
+      installSingle: "pnpm add @nucleux/md3-list @nucleux/tokens",
+      props: [
+        {
+          name: "Md3ListItemProps",
+          source: 'export interface Md3ListItemProps extends React.HTMLAttributes<HTMLDivElement> {\n  headline: React.ReactNode;\n  supportingText?: React.ReactNode;\n  leading?: React.ReactNode;\n  trailing?: React.ReactNode;\n  /** Add a hover/press state layer + role="button" for actionable rows. */\n  interactive?: boolean;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-list\n\nMaterial 3 list \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-list @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3List } from "@nucleux/md3-list";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-menu",
+      package: "@nucleux/md3-menu",
+      kind: "component",
+      description: "A Material Design 3 menu surface (presentational \u2014 pair with your own trigger\nand positioning). Compose with Md3MenuItem and Md3MenuDivider.",
+      summary: "Material 3 menu surface \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-menu"
+      ],
+      exports: [
+        "Md3Menu",
+        "Md3MenuItem",
+        "Md3MenuDivider",
+        "Md3MenuItemProps"
+      ],
+      components: [
+        "Md3Menu",
+        "Md3MenuItem",
+        "Md3MenuDivider"
+      ],
+      import: 'import { Md3Menu, Md3MenuItem, Md3MenuDivider } from "@nucleux/md3-menu";',
+      installSingle: "pnpm add @nucleux/md3-menu @nucleux/tokens",
+      props: [
+        {
+          name: "Md3MenuItemProps",
+          source: "export interface Md3MenuItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  icon?: React.ReactNode;\n  /** Trailing content \u2014 a shortcut hint or submenu marker. */\n  trailing?: React.ReactNode;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-menu\n\nMaterial 3 menu surface \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-menu @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Menu } from "@nucleux/md3-menu";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-navigation-bar",
+      package: "@nucleux/md3-navigation-bar",
+      kind: "component",
+      description: "A Material Design 3 bottom navigation bar. Compose with Md3NavigationBarItem.",
+      summary: "Material 3 bottom navigation bar \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-navigation-bar"
+      ],
+      exports: [
+        "Md3NavigationBar",
+        "Md3NavigationBarItem",
+        "Md3NavigationBarProps",
+        "Md3NavigationBarItemProps"
+      ],
+      components: [
+        "Md3NavigationBar",
+        "Md3NavigationBarItem"
+      ],
+      import: 'import { Md3NavigationBar, Md3NavigationBarItem } from "@nucleux/md3-navigation-bar";',
+      installSingle: "pnpm add @nucleux/md3-navigation-bar @nucleux/tokens",
+      props: [
+        {
+          name: "Md3NavigationBarProps",
+          source: 'export interface Md3NavigationBarProps\n  extends Omit<React.HTMLAttributes<HTMLElement>, "defaultValue"> {\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n}'
+        },
+        {
+          name: "Md3NavigationBarItemProps",
+          source: "export interface Md3NavigationBarItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  value: string;\n  icon: React.ReactNode;\n  label: React.ReactNode;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-navigation-bar\n\nMaterial 3 bottom navigation bar \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-navigation-bar @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3NavigationBar } from "@nucleux/md3-navigation-bar";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-navigation-drawer",
+      package: "@nucleux/md3-navigation-drawer",
+      kind: "component",
+      description: "A Material Design 3 navigation drawer (standard or modal).",
+      summary: "Material 3 navigation drawer \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-navigation-drawer"
+      ],
+      exports: [
+        "Md3NavigationDrawer",
+        "Md3NavigationDrawerItem",
+        "Md3NavigationDrawerSection",
+        "Md3NavigationDrawerProps",
+        "Md3NavigationDrawerItemProps"
+      ],
+      components: [
+        "Md3NavigationDrawer",
+        "Md3NavigationDrawerItem",
+        "Md3NavigationDrawerSection"
+      ],
+      import: 'import { Md3NavigationDrawer, Md3NavigationDrawerItem, Md3NavigationDrawerSection } from "@nucleux/md3-navigation-drawer";',
+      installSingle: "pnpm add @nucleux/md3-navigation-drawer @nucleux/tokens",
+      props: [
+        {
+          name: "Md3NavigationDrawerProps",
+          source: 'export interface Md3NavigationDrawerProps\n  extends Omit<React.HTMLAttributes<HTMLElement>, "defaultValue"> {\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n  /** Render as a modal drawer with a scrim (controlled via open/onOpenChange). */\n  modal?: boolean;\n  open?: boolean;\n  onOpenChange?: (open: boolean) => void;\n}'
+        },
+        {
+          name: "Md3NavigationDrawerItemProps",
+          source: "export interface Md3NavigationDrawerItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  value: string;\n  icon?: React.ReactNode;\n  /** Trailing content (e.g. a count). */\n  trailing?: React.ReactNode;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-navigation-drawer\n\nMaterial 3 navigation drawer \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-navigation-drawer @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3NavigationDrawer } from "@nucleux/md3-navigation-drawer";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-navigation-rail",
+      package: "@nucleux/md3-navigation-rail",
+      kind: "component",
+      description: "A Material Design 3 navigation rail. Compose with Md3NavigationRailItem.",
+      summary: "Material 3 navigation rail \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-navigation-rail"
+      ],
+      exports: [
+        "Md3NavigationRail",
+        "Md3NavigationRailItem",
+        "Md3NavigationRailProps",
+        "Md3NavigationRailItemProps"
+      ],
+      components: [
+        "Md3NavigationRail",
+        "Md3NavigationRailItem"
+      ],
+      import: 'import { Md3NavigationRail, Md3NavigationRailItem } from "@nucleux/md3-navigation-rail";',
+      installSingle: "pnpm add @nucleux/md3-navigation-rail @nucleux/tokens",
+      props: [
+        {
+          name: "Md3NavigationRailProps",
+          source: 'export interface Md3NavigationRailProps\n  extends Omit<React.HTMLAttributes<HTMLElement>, "defaultValue"> {\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n  /** Optional header content (e.g. a menu button or FAB), shown at the top. */\n  header?: React.ReactNode;\n}'
+        },
+        {
+          name: "Md3NavigationRailItemProps",
+          source: "export interface Md3NavigationRailItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  value: string;\n  icon: React.ReactNode;\n  label: React.ReactNode;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-navigation-rail\n\nMaterial 3 navigation rail \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-navigation-rail @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3NavigationRail } from "@nucleux/md3-navigation-rail";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-progress",
+      package: "@nucleux/md3-progress",
+      kind: "component",
+      description: "A Material Design 3 linear progress indicator (determinate or indeterminate).",
+      summary: "Material 3 progress indicators (linear, circular) \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-progress"
+      ],
+      exports: [
+        "Md3LinearProgress",
+        "Md3CircularProgress",
+        "Md3LinearProgressProps",
+        "Md3CircularProgressProps"
+      ],
+      components: [
+        "Md3LinearProgress",
+        "Md3CircularProgress"
+      ],
+      import: 'import { Md3LinearProgress, Md3CircularProgress } from "@nucleux/md3-progress";',
+      installSingle: "pnpm add @nucleux/md3-progress @nucleux/tokens",
+      props: [
+        {
+          name: "Md3LinearProgressProps",
+          source: 'export interface Md3LinearProgressProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** 0\u2013100. Omit for an indeterminate indicator. */\n  value?: number;\n  "aria-label"?: string;\n}'
+        },
+        {
+          name: "Md3CircularProgressProps",
+          source: 'export interface Md3CircularProgressProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** 0\u2013100. Omit for an indeterminate spinner. */\n  value?: number;\n  /** Diameter in px. */\n  size?: number;\n  strokeWidth?: number;\n  "aria-label"?: string;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-progress\n\nMaterial 3 progress indicators (linear, circular) \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-progress @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Progress } from "@nucleux/md3-progress";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-radio",
+      package: "@nucleux/md3-radio",
+      kind: "component",
+      description: "A Material Design 3 radio group. Compose with {@link Md3Radio}.",
+      summary: "Material 3 radio group \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-radio"
+      ],
+      exports: [
+        "Md3RadioGroup",
+        "Md3Radio",
+        "Md3RadioGroupProps",
+        "Md3RadioProps"
+      ],
+      components: [
+        "Md3RadioGroup",
+        "Md3Radio"
+      ],
+      import: 'import { Md3RadioGroup, Md3Radio } from "@nucleux/md3-radio";',
+      installSingle: "pnpm add @nucleux/md3-radio @nucleux/tokens",
+      props: [
+        {
+          name: "Md3RadioGroupProps",
+          source: 'export interface Md3RadioGroupProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n  /** Accessible label for the group. */\n  label?: string;\n}'
+        },
+        {
+          name: "Md3RadioProps",
+          source: 'export interface Md3RadioProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "value"> {\n  value: string;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-radio\n\nMaterial 3 radio group \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-radio @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Radio } from "@nucleux/md3-radio";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-search",
+      package: "@nucleux/md3-search",
+      kind: "component",
+      description: "A Material Design 3 search bar (full-width pill on a surface container).",
+      summary: "Material 3 search bar \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-search"
+      ],
+      exports: [
+        "Md3Search",
+        "Md3SearchProps"
+      ],
+      components: [
+        "Md3Search"
+      ],
+      import: 'import { Md3Search } from "@nucleux/md3-search";',
+      installSingle: "pnpm add @nucleux/md3-search @nucleux/tokens",
+      props: [
+        {
+          name: "Md3SearchProps",
+          source: 'export interface Md3SearchProps\n  extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "value" | "onChange"> {\n  value?: string;\n  onValueChange?: (value: string) => void;\n  /** Leading element (defaults to a search icon). */\n  leading?: React.ReactNode;\n  /** Trailing element (e.g. an avatar or icon button). */\n  trailing?: React.ReactNode;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-search\n\nMaterial 3 search bar \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-search @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Search } from "@nucleux/md3-search";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-segmented-button",
+      package: "@nucleux/md3-segmented-button",
+      kind: "component",
+      description: "A Material Design 3 segmented button group. Compose with Md3SegmentedButtonItem.",
+      summary: "Material 3 segmented button \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-segmented-button"
+      ],
+      exports: [
+        "Md3SegmentedButton",
+        "Md3SegmentedButtonItem",
+        "Md3SegmentedButtonProps",
+        "Md3SegmentedButtonItemProps"
+      ],
+      components: [
+        "Md3SegmentedButton",
+        "Md3SegmentedButtonItem"
+      ],
+      import: 'import { Md3SegmentedButton, Md3SegmentedButtonItem } from "@nucleux/md3-segmented-button";',
+      installSingle: "pnpm add @nucleux/md3-segmented-button @nucleux/tokens",
+      props: [
+        {
+          name: "Md3SegmentedButtonProps",
+          source: 'export interface Md3SegmentedButtonProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {\n  type?: "single" | "multiple";\n  value?: string | string[];\n  defaultValue?: string | string[];\n  onValueChange?: (value: string | string[]) => void;\n}'
+        },
+        {
+          name: "Md3SegmentedButtonItemProps",
+          source: "export interface Md3SegmentedButtonItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  value: string;\n  icon?: React.ReactNode;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-segmented-button\n\nMaterial 3 segmented button \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-segmented-button @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3SegmentedButton } from "@nucleux/md3-segmented-button";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-slider",
+      package: "@nucleux/md3-slider",
+      kind: "component",
+      description: "A Material Design 3 slider (single value) with pointer + keyboard control.",
+      summary: "Material 3 slider \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-slider"
+      ],
+      exports: [
+        "Md3Slider",
+        "Md3SliderProps"
+      ],
+      components: [
+        "Md3Slider"
+      ],
+      import: 'import { Md3Slider } from "@nucleux/md3-slider";',
+      installSingle: "pnpm add @nucleux/md3-slider @nucleux/tokens",
+      props: [
+        {
+          name: "Md3SliderProps",
+          source: 'export interface Md3SliderProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {\n  value?: number;\n  defaultValue?: number;\n  min?: number;\n  max?: number;\n  step?: number;\n  disabled?: boolean;\n  onValueChange?: (value: number) => void;\n  "aria-label"?: string;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-slider\n\nMaterial 3 slider \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-slider @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Slider } from "@nucleux/md3-slider";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-snackbar",
+      package: "@nucleux/md3-snackbar",
+      kind: "component",
+      description: "A Material Design 3 snackbar. Presentational + controlled via `open`; position\nit with `className` (e.g. fixed bottom-4). Uses the inverse surface roles.",
+      summary: "Material 3 snackbar \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-snackbar"
+      ],
+      exports: [
+        "Md3Snackbar",
+        "Md3SnackbarProps"
+      ],
+      components: [
+        "Md3Snackbar"
+      ],
+      import: 'import { Md3Snackbar } from "@nucleux/md3-snackbar";',
+      installSingle: "pnpm add @nucleux/md3-snackbar @nucleux/tokens",
+      props: [
+        {
+          name: "Md3SnackbarProps",
+          source: "export interface Md3SnackbarProps extends React.HTMLAttributes<HTMLDivElement> {\n  open: boolean;\n  message: React.ReactNode;\n  /** Optional trailing action label (rendered as a text button). */\n  action?: string;\n  onAction?: () => void;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-snackbar\n\nMaterial 3 snackbar \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-snackbar @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Snackbar } from "@nucleux/md3-snackbar";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-switch",
+      package: "@nucleux/md3-switch",
+      kind: "component",
+      description: "A Material Design 3 switch with a growing handle and optional check icon.",
+      summary: "Material 3 switch \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-switch"
+      ],
+      exports: [
+        "Md3Switch",
+        "Md3SwitchProps"
+      ],
+      components: [
+        "Md3Switch"
+      ],
+      import: 'import { Md3Switch } from "@nucleux/md3-switch";',
+      installSingle: "pnpm add @nucleux/md3-switch @nucleux/tokens",
+      props: [
+        {
+          name: "Md3SwitchProps",
+          source: 'export interface Md3SwitchProps\n  extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onChange"> {\n  checked?: boolean;\n  defaultChecked?: boolean;\n  onCheckedChange?: (checked: boolean) => void;\n  /** Show a check icon in the handle when on (Material 3 default behaviour). */\n  showIcon?: boolean;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-switch\n\nMaterial 3 switch \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-switch @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Switch } from "@nucleux/md3-switch";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-tabs",
+      package: "@nucleux/md3-tabs",
+      kind: "component",
+      description: "Material Design 3 primary tabs. Compose Md3TabsList, Md3Tab, Md3TabPanel.",
+      summary: "Material 3 primary tabs \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-tabs"
+      ],
+      exports: [
+        "Md3Tabs",
+        "Md3TabsList",
+        "Md3Tab",
+        "Md3TabPanel",
+        "Md3TabsProps",
+        "Md3TabProps",
+        "Md3TabPanelProps"
+      ],
+      components: [
+        "Md3Tabs",
+        "Md3TabsList",
+        "Md3Tab",
+        "Md3TabPanel"
+      ],
+      import: 'import { Md3Tabs, Md3TabsList, Md3Tab, Md3TabPanel } from "@nucleux/md3-tabs";',
+      installSingle: "pnpm add @nucleux/md3-tabs @nucleux/tokens",
+      props: [
+        {
+          name: "Md3TabsProps",
+          source: 'export interface Md3TabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue"> {\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n}'
+        },
+        {
+          name: "Md3TabProps",
+          source: "export interface Md3TabProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  value: string;\n  icon?: React.ReactNode;\n}"
+        },
+        {
+          name: "Md3TabPanelProps",
+          source: "export interface Md3TabPanelProps extends React.HTMLAttributes<HTMLDivElement> {\n  value: string;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-tabs\n\nMaterial 3 primary tabs \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-tabs @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Tabs } from "@nucleux/md3-tabs";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-text-field",
+      package: "@nucleux/md3-text-field",
+      kind: "component",
+      description: "A Material Design 3 text field (filled or outlined) with a floating label,\noptional leading/trailing icons, supporting text, and an error state.",
+      summary: "Material 3 text field (filled, outlined) \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-text-field"
+      ],
+      exports: [
+        "Md3TextField",
+        "Md3TextFieldVariant",
+        "Md3TextFieldProps"
+      ],
+      components: [
+        "Md3TextField"
+      ],
+      import: 'import { Md3TextField } from "@nucleux/md3-text-field";',
+      installSingle: "pnpm add @nucleux/md3-text-field @nucleux/tokens",
+      props: [
+        {
+          name: "Md3TextFieldProps",
+          source: 'export interface Md3TextFieldProps\n  extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "placeholder"> {\n  label: string;\n  variant?: Md3TextFieldVariant;\n  supportingText?: React.ReactNode;\n  error?: boolean;\n  leadingIcon?: React.ReactNode;\n  trailingIcon?: React.ReactNode;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-text-field\n\nMaterial 3 text field (filled, outlined) \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-text-field @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3TextField } from "@nucleux/md3-text-field";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-time-picker",
+      package: "@nucleux/md3-time-picker",
+      kind: "component",
+      description: "A Material Design 3 time picker (input variant): hour, minute, and AM/PM.",
+      summary: "Material 3 time picker (input) \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-time-picker"
+      ],
+      exports: [
+        "Md3TimePicker",
+        "Md3TimePeriod",
+        "Md3TimeValue",
+        "Md3TimePickerProps"
+      ],
+      components: [
+        "Md3TimePicker",
+        "Md3TimePeriod",
+        "Md3TimeValue"
+      ],
+      import: 'import { Md3TimePicker, Md3TimePeriod, Md3TimeValue } from "@nucleux/md3-time-picker";',
+      installSingle: "pnpm add @nucleux/md3-time-picker @nucleux/tokens",
+      props: [
+        {
+          name: "Md3TimePickerProps",
+          source: "export interface Md3TimePickerProps {\n  value?: Md3TimeValue;\n  defaultValue?: Md3TimeValue;\n  onValueChange?: (value: Md3TimeValue) => void;\n  className?: string;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-time-picker\n\nMaterial 3 time picker (input) \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-time-picker @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3TimePicker } from "@nucleux/md3-time-picker";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-tooltip",
+      package: "@nucleux/md3-tooltip",
+      kind: "component",
+      description: "A Material Design 3 tooltip (plain or rich) shown on hover/focus.",
+      summary: "Material 3 tooltip (plain, rich) \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-tooltip"
+      ],
+      exports: [
+        "Md3Tooltip",
+        "Md3TooltipProps"
+      ],
+      components: [
+        "Md3Tooltip"
+      ],
+      import: 'import { Md3Tooltip } from "@nucleux/md3-tooltip";',
+      installSingle: "pnpm add @nucleux/md3-tooltip @nucleux/tokens",
+      props: [
+        {
+          name: "Md3TooltipProps",
+          source: 'export interface Md3TooltipProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "content" | "title"> {\n  /** Plain tooltip text, or the body for a rich tooltip. */\n  content: React.ReactNode;\n  variant?: "plain" | "rich";\n  /** Rich tooltip subhead. */\n  title?: React.ReactNode;\n  /** Rich tooltip actions (text buttons). */\n  actions?: React.ReactNode;\n  side?: "top" | "bottom";\n  /** The trigger element. */\n  children: React.ReactNode;\n}'
+        }
+      ],
+      readme: '# @nucleux/md3-tooltip\n\nMaterial 3 tooltip (plain, rich) \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-tooltip @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3Tooltip } from "@nucleux/md3-tooltip";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
+    {
+      name: "md3-top-app-bar",
+      package: "@nucleux/md3-top-app-bar",
+      kind: "component",
+      description: "A Material Design 3 top app bar (small, center-aligned, medium, or large).",
+      summary: "Material 3 top app bar \u2014 Nucleux agentic UI for React.",
+      keywords: [
+        "nucleux",
+        "react",
+        "ui",
+        "components",
+        "agentic",
+        "ai",
+        "tailwind",
+        "md3-top-app-bar"
+      ],
+      exports: [
+        "Md3TopAppBar",
+        "Md3TopAppBarVariant",
+        "Md3TopAppBarProps"
+      ],
+      components: [
+        "Md3TopAppBar"
+      ],
+      import: 'import { Md3TopAppBar } from "@nucleux/md3-top-app-bar";',
+      installSingle: "pnpm add @nucleux/md3-top-app-bar @nucleux/tokens",
+      props: [
+        {
+          name: "Md3TopAppBarProps",
+          source: "export interface Md3TopAppBarProps extends React.HTMLAttributes<HTMLElement> {\n  variant?: Md3TopAppBarVariant;\n  /** Leading element (usually a navigation icon button). */\n  leading?: React.ReactNode;\n  /** Trailing action elements. */\n  trailing?: React.ReactNode;\n  /** The title text. */\n  headline: React.ReactNode;\n}"
+        }
+      ],
+      readme: '# @nucleux/md3-top-app-bar\n\nMaterial 3 top app bar \u2014 Nucleux agentic UI for React.\n\nPart of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** \u2014 agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).\n\n## Install\n\n```bash\npnpm add @nucleux/md3-top-app-bar @nucleux/tokens\n```\n\n`react` / `react-dom` are peer dependencies.\n\n## Usage\n\n```tsx\nimport { Md3TopAppBar } from "@nucleux/md3-top-app-bar";\n```\n\nRequires the theme once in your app: `import "@nucleux/tokens/styles.css";`\nand the Tailwind preset from `@nucleux/tokens/preset`.\n\n## License\n\nMIT \xA9 Nucleux',
+      peerDependencies: {
+        react: ">=18",
+        "react-dom": ">=18"
+      }
+    },
     {
       name: "media-card",
       package: "@nucleux/media-card",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nucleux/mcp",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "Model Context Protocol server for the Nucleux agentic UI component library — lets AI coding agents discover, search, and correctly use @nucleux components.",
   "bin": {